

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

# Prodotti a base di AMI in Marketplace AWS
<a name="ami-products"></a>

In qualità di Marketplace AWS venditore, puoi consegnare i tuoi prodotti agli acquirenti con [Amazon Machine Images (AMIs)](https://docs.aws.amazon.com/glossary/latest/reference/glos-chap.html#AmazonMachineImage). Un'AMI fornisce le informazioni necessarie per avviare un'istanza Amazon Elastic Compute Cloud (Amazon EC2). Crei un'AMI personalizzata per il tuo prodotto e gli acquirenti possono utilizzarla per creare EC2 istanze con il prodotto già installato e pronto per l'uso. Questo argomento fornisce informazioni sull'utilizzo AMIs per la consegna Marketplace AWS del prodotto.

Quando gli acquirenti utilizzano l'AMI che fornisci, ricevono una fattura per le istanze che creano, in base alle opzioni di prezzo e misurazione che crei per il tuo prodotto. Gli acquirenti possono utilizzare l'AMI del prodotto nello stesso modo AMIs in cui utilizzano gli altri AWS, inclusa la creazione di nuove versioni personalizzate dell'AMI. EC2 le istanze create dall'AMI vengono comunque fatturate come prodotto, in base al codice prodotto AMI.

## Metodi di consegna dei prodotti basati su AMI
<a name="ami-product-delivery-methods"></a>

Puoi fornire prodotti basati su AMI in uno dei seguenti modi:
+ **AMI singola**: gli acquirenti selezionano e utilizzano l'AMI come modello per un' EC2 istanza. Gli acquirenti possono trovare questi prodotti utilizzando il filtro del metodo di consegna di **Amazon Machine Image**. Per ulteriori informazioni, consulta [Creazione di prodotti basati su AMI](ami-single-ami-products.md).
+ **AWS CloudFormation modelli**: crei modelli che consentono agli acquirenti di installare un sistema composto da più istanze con ruoli diversi come singola unità. Gli acquirenti possono trovare questi prodotti utilizzando il filtro relativo al metodo **CloudFormation**di spedizione. Per ulteriori informazioni, consulta [Aggiungi CloudFormation modelli al tuo prodotto](cloudformation.md).

## Altre risorse
<a name="ami-delivery-methods-additional-resources"></a>

Per ulteriori informazioni sui prodotti AMI, consulta i seguenti argomenti.

**Marketplace AWS**
+ [Prezzi dei prodotti per Marketplace AWS](pricing.md)
+ [Configurazione della misurazione personalizzata per i prodotti AMI con AWS Marketplace Metering Service](custom-metering-with-mp-metering-service.md)

**Prodotti basati su AMI**
+ [Comprendere i prodotti basati su AMI in Marketplace AWS](ami-getting-started.md)
+ [Creazione di prodotti basati su AMI](ami-single-ami-products.md)
+ [Gestione dei prodotti basati su AMI in qualità di venditore Marketplace AWS](concept-chapter-servicename.md)
+ [Aggiungi CloudFormation modelli al tuo prodotto](cloudformation.md)
+ [Procedure consigliate per AMIs la costruzione da utilizzare con Marketplace AWS](best-practices-for-building-your-amis.md)
+ [Prezzi dei prodotti AMI per Marketplace AWS](pricing-ami-products.md)
+ [Ricezione di notifiche Amazon SNS per prodotti AMI su Marketplace AWS](ami-notification.md)
+ [Lista di controllo dei prodotti AMI per Marketplace AWS](aws-marketplace-listing-checklist.md)
+ [Requisiti di prodotto basati su AMI per Marketplace AWS](product-and-ami-policies.md)

# Comprendere i prodotti basati su AMI in Marketplace AWS
<a name="ami-getting-started"></a>

In qualità di Marketplace AWS venditore, puoi consegnare i tuoi prodotti agli acquirenti con [Amazon Machine Images (AMIs)](https://docs.aws.amazon.com/glossary/latest/reference/glos-chap.html#AmazonMachineImage). Un'AMI fornisce le informazioni necessarie per avviare un'istanza Amazon Elastic Compute Cloud (Amazon EC2). La sezione seguente illustra i concetti chiave per l'utilizzo di prodotti basati su AMI.

**Nota**  
È possibile utilizzare solo un'AMI in un prodotto AMI, ma è possibile aggiungere versioni di tale AMI al prodotto.

**Topics**
+ [Ciclo di vita del prodotto](#ami-product-lifecycle)
+ [Codici prodotto AMI](#ami-product-codes)
+ [Richieste di modifica](#ami-change-requests)
+ [Moduli di caricamento dei prodotti](#ami-product-load-forms)
+ [Modifiche all'accordo annuale](#annual-agreement-amendments)
+ [Prodotti FPGA](#ami-fpga-products)

## Ciclo di vita del prodotto
<a name="ami-product-lifecycle"></a>

I prodotti basati su AMI includono una o più versioni del software, oltre ai metadati relativi al prodotto nel suo complesso. Quando crei il prodotto, ne configuri le proprietà Marketplace AWS includendo il nome, la descrizione e il prezzo del prodotto. Inoltre, stabilisci le categorie appropriate per il tuo prodotto e aggiungi parole chiave in modo che il prodotto venga visualizzato nelle ricerche pertinenti.

Inoltre, crei la prima versione del software. Può trattarsi solo dell'AMI oppure puoi includere AWS CloudFormation modelli o pacchetti software che gli acquirenti possono utilizzare per crearne di propri AMIs. Per ulteriori informazioni, consulta [Metodi di consegna dei prodotti basati su AMI](ami-products.md#ami-product-delivery-methods).

Per i prodotti a pagamento, agli acquirenti viene fatturato il numero di istanze installate. Per misurare una dimensione diversa monitorata dal software, ad esempio il numero di utenti del prodotto, integra il prodotto con il servizio di Marketplace AWS misurazione. Per ulteriori informazioni, consulta [Configurazione della misurazione personalizzata per i prodotti AMI con AWS Marketplace Metering Service](custom-metering-with-mp-metering-service.md).

Quando crei il prodotto e la prima versione del software, questa viene inizialmente pubblicata in un ambito limitato, in modo che solo il tuo account possa accedervi. Quando sei pronto, puoi pubblicarlo nel Marketplace AWS catalogo per consentire agli acquirenti di abbonarsi e acquistare il tuo prodotto.

Utilizza la pagina [del prodotto Server](https://aws.amazon.com/marketplace/management/products/server) per visualizzare l'elenco dei tuoi prodotti. I prodotti avranno uno dei seguenti stati:
+ **Staging**: prodotto incompleto per il quale stai ancora aggiungendo informazioni. Al primo **salvataggio e uscita** dall'esperienza self-service di creazione, la richiesta di modifica completata con successo crea un prodotto non pubblicato con le informazioni relative alle fasi complete inviate. Da questo stato, puoi continuare ad aggiungere informazioni al prodotto o modificare i dettagli già inviati tramite le richieste di modifica.
+ **Limitato**: un prodotto è completo dopo essere stato inviato al sistema e dopo aver superato tutte le convalide previste dal sistema. Quindi il prodotto viene rilasciato in uno stato **limitato**. A questo punto, il prodotto ha una pagina prodotto accessibile solo al tuo account e a chi hai consentito di inserire nell'elenco. Puoi testare il prodotto tramite la pagina dei dettagli. Se necessario, per ulteriori informazioni e assistenza, contatta il [https://aws.amazon.com/marketplace/management/contact-us/?#](https://aws.amazon.com/marketplace/management/contact-us/?#).
+ **Pubblico**: quando sei pronto a pubblicare il prodotto in modo che gli acquirenti possano visualizzarlo e abbonarsi al prodotto, utilizzi la richiesta di modifica della **visibilità dell'aggiornamento**. Ciò avvia un flusso di lavoro per il team Operativo del Marketplace AWS venditore per esaminare e verificare il prodotto rispetto alle nostre [politiche](https://docs.aws.amazon.com/marketplace/latest/userguide/product-and-ami-policies.html). Una volta che il prodotto è stato approvato e la richiesta di modifica è stata elaborata, il prodotto viene spostato dallo stato **Limitato** a **Pubblico**.
+ **Limitato**: se desideri impedire ai nuovi utenti di abbonarsi al tuo prodotto, puoi limitare il prodotto utilizzando la richiesta di modifica della **visibilità dell'aggiornamento**. Lo stato **con restrizioni** significa che gli utenti esistenti possono continuare a utilizzare il prodotto. Tuttavia, il prodotto non sarà più visibile al pubblico né sarà disponibile per i nuovi utenti.

Il ciclo di vita di un prodotto basato su AMI Marketplace AWS non termina dopo la pubblicazione della prima versione. È necessario mantenere il prodotto aggiornato con le nuove versioni del software e con le patch di sicurezza per il sistema operativo di base.

Come esempio di ciclo di vita completo di un prodotto basato su AMI, immagina che un venditore voglia vendere il proprio prodotto basato su AMI. Marketplace AWS Di seguito è riportato il modo in cui il venditore crea e mantiene il prodotto nel tempo:

1. **Crea un prodotto**: il venditore crea il prodotto e pubblica la versione da 1.0.0 a. Marketplace AWS Gli acquirenti possono creare istanze della versione 1.0.0 e utilizzarla.

1. **Aggiungi una nuova versione**: successivamente, il venditore aggiunge una nuova funzionalità al prodotto e aggiunge una nuova versione, 1.1.0, che include la funzionalità. Gli acquirenti possono comunque utilizzare la versione originale, 1.0.0, oppure scegliere la nuova versione, 1.1.0.
**Nota**  
A differenza dei nuovi prodotti, le nuove versioni vengono pubblicate per la piena disponibilità pubblica. Puoi testarli Marketplace AWS senza che i clienti li vedano solo se il prodotto nel suo insieme è in versione limitata.

1. **Aggiornamento delle informazioni sul prodotto**: con la versione 1.1.0 disponibile, il venditore informa gli acquirenti della nuova funzionalità aggiornando le informazioni sul prodotto con un nuovo testo evidenziato che descrive la funzionalità.

1. **Aggiungi una versione secondaria**: quando il venditore corregge un bug nella versione 1.1.0, lo rilascia aggiungendo una nuova versione 1.1.1. Gli acquirenti ora possono scegliere di utilizzare la versione 1.0.0, 1.1.0 o 1.1.1.

1. **Limita una versione**: il venditore decide che il bug è abbastanza grave da non voler consentire agli acquirenti di utilizzare la versione 1.1.0, quindi limita tale versione. Nessun nuovo cliente può quindi acquistare la 1.1.0 (possono scegliere solo la 1.0.0 o la 1.1.1), sebbene gli acquirenti esistenti possano ancora accedervi.

1. **Aggiorna le informazioni sulla versione**: per aiutare gli acquirenti esistenti, il venditore aggiorna le informazioni sulla versione 1.1.0 suggerendo di passare alla versione 1.1.1.

1. **Monitora l'utilizzo**: man mano che gli acquirenti acquistano e utilizzano il prodotto, il venditore monitora le vendite, l'utilizzo e altre metriche utilizzando il. Marketplace AWS [Report, feed di dati e dashboard per i venditori in Marketplace AWS](reports-and-data-feed.md)

1. **Rimuovi il prodotto**: quando il prodotto non è più necessario, il venditore lo rimuove da. Marketplace AWS

In questo esempio, il venditore ha creato tre diverse versioni dell'AMI nel prodotto, ma solo due erano disponibili per i nuovi acquirenti (prima della rimozione del prodotto).

Per apportare modifiche alle versioni o alle informazioni sul prodotto, crei [richieste di modifica](single-ami-create-change-request.md) in. Portale di gestione Marketplace AWS

Per istruzioni dettagliate sui passaggi per creare e gestire il prodotto basato su AMI, consulta. [Creazione di prodotti basati su AMI](ami-single-ami-products.md)

## Codici prodotto AMI
<a name="ami-product-codes"></a>

Al momento della creazione, al prodotto viene assegnato un codice prodotto univoco Marketplace AWS. Tale codice prodotto è associato all'AMI del prodotto e viene utilizzato per tracciare l'utilizzo del prodotto. I codici prodotto vengono propagati automaticamente man mano che gli acquirenti utilizzano il software. Ad esempio, un cliente sottoscrive e avvia un'AMI, la configura e produce una nuova AMI. La nuova AMI contiene ancora il codice prodotto originale, quindi il monitoraggio dell'utilizzo e le autorizzazioni corretti rimangono validi.

**Nota**  
Il *codice* prodotto è diverso dall'*ID* del prodotto. A ogni prodotto in Marketplace AWS ingresso viene assegnato un ID prodotto univoco. L'ID del prodotto viene utilizzato per identificare il prodotto nel Marketplace AWS catalogo, nella fatturazione ai clienti e nei rapporti sul venditore. Il codice prodotto è allegato alle istanze create dall'AMI come metadati dell'istanza. Quando un AMI con quel codice prodotto viene utilizzato per creare un'istanza, il cliente riceverà una fattura con l'ID del prodotto associato. Dopo aver creato il prodotto, trova il codice e l'ID del prodotto nella Portale di gestione Marketplace AWS pagina del prodotto.

In qualità di venditore, il tuo software può ottenere il codice prodotto per l'istanza Amazon Elastic Compute Cloud (Amazon EC2) in esecuzione in fase di esecuzione dai metadati dell'istanza. Puoi utilizzare il codice del prodotto per una maggiore sicurezza, ad esempio per convalidarlo all'avvio del prodotto. Non è possibile effettuare chiamate API al codice prodotto di un AMI finché il prodotto non è stato pubblicato in uno stato limitato a scopo di test. Per ulteriori informazioni sulla verifica del codice del prodotto, consulta[Verifica che il software sia in esecuzione sull'AMI Marketplace AWS](best-practices-for-building-your-amis.md#verifying-ami-runtime).

## Richieste di modifica
<a name="ami-change-requests"></a>

Per apportare modifiche a un prodotto o a una versione in Marketplace AWS, invii una **richiesta di modifica** tramite Portale di gestione Marketplace AWS. Le richieste di modifica vengono aggiunte a una coda e possono richiedere da minuti a giorni per essere risolte, a seconda del tipo di richiesta. È possibile visualizzare lo stato delle richieste in. Portale di gestione Marketplace AWS

**Nota**  
Oltre a Portale di gestione Marketplace AWS, puoi anche creare richieste di modifica utilizzando l'[API Marketplace AWS Catalog](https://docs.aws.amazon.com/marketplace-catalog/latest/api-reference/seller-products.html).

I tipi di modifiche che puoi richiedere per i prodotti basati su AMI includono:
+ Aggiorna le informazioni sul prodotto mostrate agli acquirenti.
+ Aggiorna le informazioni sulla versione mostrate agli acquirenti.
+ Aggiungi una nuova versione del prodotto.
+ Limita una versione in modo che i nuovi acquirenti non possano più accedervi.
+ Aggiorna la versione in Regioni AWS cui un prodotto è disponibile.
+ Aggiorna i prezzi e i tipi di istanza di un prodotto.
+ Rimuovi un prodotto da Marketplace AWS.

**Nota**  
Alcune richieste di modifica richiedono l'utilizzo di moduli di caricamento del prodotto per creare la richiesta. Per ulteriori informazioni, consulta [Moduli di caricamento dei prodotti](#ami-product-load-forms).

### Aggiornare una richiesta di modifica
<a name="update-change-request"></a>

Le richieste di modifica che iniziano con un aggiornamento caricheranno i dettagli correnti. Quindi apporti degli aggiornamenti, che sovrascrivono i dettagli esistenti.

### Aggiungi o limita la richiesta di modifica
<a name="add-restrict-requests"></a>

Le coppie di richieste di aggiunta e limitazione riguardano specificamente le fasi e gli aggiornamenti che vengono forniti dopo l'esito positivo di ogni richiesta. Una richiesta ha esito positivo dopo aver selezionato le azioni **Salva ed esci** e **Invia** nell'esperienza self-service.

Ad esempio, se la risorsa AMI viene fornita alle istanze e alle regioni una volta aggiunte, queste possono essere limitate anziché rimosse completamente. Ciò significa che gli abbonati e gli utenti esistenti possono continuare a utilizzare il prodotto fino alla scadenza dell'abbonamento o del contratto. Tuttavia, non è possibile aggiungere nuovi abbonati a un prodotto con stato con **restrizioni**.

## Moduli di caricamento dei prodotti
<a name="ami-product-load-forms"></a>

In genere, vengono utilizzati [Portale di gestione Marketplace AWS](https://aws.amazon.com/marketplace/management)per creare o modificare il prodotto. Tuttavia, alcune operazioni richiedono l'utilizzo di un *Product Load Form* (PLF). 

Un PLF è un foglio di calcolo che contiene tutte le informazioni su un prodotto. Per ottenere un PLF, puoi:
+ Scarica il PLF per un prodotto esistente dalla pagina dei dettagli del prodotto nel. Portale di gestione Marketplace AWS
+ Seleziona una voce di menu per un'azione che richiede un PLF. Ad esempio, se si crea un nuovo prodotto server con fatturazione mensile, il sistema richiede di scaricare il PLF appropriato. 

  Se l'azione è una modifica a un prodotto esistente, il PLF è precompilato con le informazioni relative a quel prodotto, quindi è sufficiente modificare i dettagli che si desidera aggiornare.
+ [Se hai bisogno di un nuovo PLF vuoto, vai alla pagina di caricamento del Portale di gestione Marketplace AWS file.](https://aws.amazon.com/marketplace/management/product-load) La pagina contiene collegamenti al PLFs tipo di prodotto che desideri creare.

 Dopo aver completato il PLF, caricalo nella pagina di [caricamento del Portale di gestione Marketplace AWS file](https://aws.amazon.com/marketplace/management/product-load). Lo stesso PLF contiene istruzioni più dettagliate nella scheda **Istruzioni**. 

## Modifiche all'accordo annuale
<a name="annual-agreement-amendments"></a>

Le modifiche orarie annuali (annuali) ai piani consentono a te e ai tuoi acquirenti di apportare le seguenti modifiche ai piani esistenti:
+ Passa da una famiglia di tipi di EC2 istanze Amazon all'altra
+ Passa da una dimensione del tipo di EC2 istanza Amazon all'altra
+ Aggiungi un nuovo tipo di istanza
+ Aumenta la quantità di un tipo di istanza esistente nell'accordo

Gli acquirenti possono apportare una modifica purché il costo proporzionale della modifica sia superiore a zero (non possono ridurre il valore dell'abbonamento). Il costo ripartito proporzionalmente delle nuove EC2 istanze Amazon aggiunte si basa sul costo annuo del tipo di istanza rettificato per la durata residua del contratto. Quando si cambia tipo di istanza, il costo ripartito proporzionalmente del tipo di EC2 istanza Amazon rimosso viene detratto dal costo proporzionale del tipo di istanza Amazon appena aggiunto. EC2 

Non è necessaria alcuna azione aggiuntiva per consentire modifiche ai prodotti annuali AMI. Le modifiche sono supportate su tutti gli accordi conclusi sulla base di offerte pubbliche e sugli accordi derivanti da offerte private che non utilizzano piani rateali.

Puoi visualizzare le modifiche apportate dai tuoi acquirenti nelle seguenti dashboard:
+ [Pannello di controllo degli accordi e dei rinnovi](https://docs.aws.amazon.com/marketplace/latest/userguide/agreements-renewals-dashboard.html): elenco degli accordi modificati.
+ [Dashboard dei ricavi fatturati](https://docs.aws.amazon.com/marketplace/latest/userguide/billed-revenue-dashboard.html): addebiti al cliente.
+ [Dashboard di riscossioni ed esborsi](https://docs.aws.amazon.com/marketplace/latest/userguide/collections-disbursement-dashboard.html): l'esborso.

## Prodotti FPGA
<a name="ami-fpga-products"></a>

I prodotti FPGA (Field Programmable Gate Array) sono prodotti AMI specializzati che supportano tipi di istanze F2 con configurazioni Amazon FPGA Image (AFI). A differenza degli standard AMIs, i prodotti FPGA includono AFI IDs che vengono caricate dinamicamente dall'AMI per l'accelerazione hardware sui tipi di istanze supportati.

**Caratteristiche principali:**
+ I prodotti FPGA supportano i tipi di istanze F2 esclusivamente per l'accelerazione FPGA.
+ Ogni versione del prodotto può includere una o più AFI IDs, con un massimo di 15 AFI per versione. IDs 
+ AFIs vengono caricati on-the-fly anziché avviati allo stesso modo AMIs, fornendo funzionalità di accelerazione hardware dinamica.
+ Quando si aggiungono nuove regioni al prodotto FPGA, viene eseguita la clonazione AFI regionale automatica Marketplace AWS per garantire la disponibilità del prodotto in tutte le regioni supportate. AWS 
+ Sebbene i prodotti FPGA possano essere offerti su altri tipi di istanze, verranno caricati e AFIs forniranno l'accelerazione hardware solo sui tipi di istanze F2. Su altri tipi di istanze, l'AMI funziona senza le funzionalità di accelerazione FPGA.

I prodotti FPGA sono ideali per carichi di lavoro ad alta intensità di calcolo che richiedono accelerazioni hardware specializzate come la ricerca genomica, l'analisi finanziaria, l'elaborazione video in tempo reale, l'analisi dei big data e l'inferenza dell'apprendimento automatico. Il caricamento dinamico di AFIs consente agli acquirenti di sfruttare l'accelerazione FPGA senza gestire l'infrastruttura FPGA sottostante.

# Creazione di prodotti basati su AMI
<a name="ami-single-ami-products"></a>

L'esperienza self-service di Amazon Machine Image (AMI) ti guida nella creazione della tua offerta di prodotti e nella richiesta di modifica. Utilizzando l'esperienza self-service, puoi aggiornare direttamente l'elenco dei prodotti con meno tempo necessario per l'elaborazione da parte del team Operativo del Marketplace AWS venditore. Molte fasi dell'esperienza self-service sono in linea con il sistema di catalogo Marketplace AWS, che facilita la convalida diretta anziché attendere l'elaborazione e la convalida da parte del team Operativo del venditore. Marketplace AWS Questo argomento spiega come utilizzare l'esperienza self-service AMI per creare un elenco di prodotti per una singola AMI. I clienti utilizzano le AMI per creare istanze Amazon EC2 con il prodotto già installato e configurato. 

**Topics**
+ [Prerequisiti](#single-ami-prerequisites)
+ [Comprendi l'esperienza self-service](#understand-ami-self-service-exp)
+ [Crea l'inserzione](#ami-create-product)
+ [Risorse aggiuntive](#ami-single-create-resources)

## Prerequisiti
<a name="single-ami-prerequisites"></a>

Prima di creare un elenco di prodotti AMI, è necessario completare i seguenti prerequisiti:

1. Avere accesso a. Portale di gestione Marketplace AWS Questo è lo strumento che utilizzi per registrarti come venditore e gestire i prodotti su cui vendi Marketplace AWS. Per ulteriori informazioni su come accedere a Portale di gestione Marketplace AWS, consulta[Politiche e autorizzazioni per i venditori Marketplace AWS](detailed-management-portal-permissions.md).

1. Registrati come venditore e, se desideri addebitare i tuoi prodotti, invia i tuoi dati fiscali e bancari. Per maggiori informazioni su come diventare un venditore, consulta[Iniziare come Marketplace AWS venditore](user-guide-for-sellers.md).

1. Hai un prodotto che desideri vendere. Per i prodotti basati su AMI, ciò significa in genere che hai creato o modificato il software del server e creato un'AMI utilizzabile dai tuoi clienti. Per ulteriori informazioni sulla preparazione di un'AMI da utilizzare in Marketplace AWS, consulta[Procedure consigliate per AMIs la costruzione da utilizzare con Marketplace AWS](best-practices-for-building-your-amis.md). 

## Comprendi l'esperienza self-service
<a name="understand-ami-self-service-exp"></a>

L'esperienza self-service ti guida nella creazione del tuo prodotto su. Marketplace AWS Man mano che procedi con i passaggi, specifichi le informazioni sul prodotto e le impostazioni di distribuzione AMI Regione AWS, come i tipi di istanza e i dettagli AMI. È inoltre possibile configurare i dettagli della transazione, tra cui prezzi, disponibilità nel paese, EULA e politica di rimborso. Come opzione, puoi specificare un elenco di opzioni consentite Account AWS IDs per accedere e testare il prodotto mentre è nello stato **Limitato**. 

Prima di iniziare, esamina i seguenti aspetti chiave dell'esperienza self-service: 
+ Puoi passare al passaggio successivo solo dopo aver completato i campi obbligatori nel passaggio corrente. Questo requisito è dovuto al fatto che alla fine di ogni passaggio è prevista una convalida a livello di pagina. Non puoi salvare o inviare un passaggio incompleto.
+ Se devi terminare la sessione prima di completare tutti i passaggi del processo, puoi scegliere **Salva ed esci** per inviare i passaggi completati all'area di gestione temporanea.
+ Un passaggio incompleto e che non supera la convalida non viene inviato al sistema. Un passaggio parzialmente completato non è valido e non può essere salvato.
+ Quando scegliete **Salva ed esci**, la finestra di dialogo **Salva ed esci** mostra i passaggi che hanno superato i controlli di convalida. Puoi rivedere e scegliere di salvare fino agli ultimi passaggi completati e convalidati. Se c'è un errore di convalida o mancano dei dettagli, puoi scegliere **Correggi** per tornare a quel passaggio.
+ Dopo aver **salvato e chiuso**, la richiesta è in fase di revisione durante l'elaborazione. Il completamento dell'elaborazione potrebbe richiedere alcuni minuti o ore. Non puoi continuare i passaggi o apportare modifiche finché la richiesta non ha avuto esito positivo. Per il primo **salvataggio e uscita**, la richiesta consiste nella creazione del prodotto in parallelo ai passaggi che hai completato. 
  + **Una volta completata la richiesta, hai completato il salvataggio.** Per riprendere le modifiche nella pagina di **panoramica del prodotto**, scegli **Riprendi la creazione del prodotto** o utilizza **Richiedi modifiche** per aggiornare i dettagli che hai inviato in precedenza nell'ultima sessione. **Quando riprendi, nota che i passaggi che hai completato sono contrassegnati da un'etichetta verde Operata con successo.** Per aggiornare un passaggio inviato in precedenza, utilizza **Richiedi** modifiche. La precedente richiesta **di salvataggio e uscita** deve essere completata prima di poter continuare questo passaggio.
+ Dopo aver completato tutti i passaggi, puoi scegliere **Avanti** per vedere una recensione. Scegli **Invia** per richiedere che il sistema esegua una convalida finale. Dopo aver ricevuto una risposta **completata**, il prodotto passa allo stato **Limitato**. Nella pagina prodotto puoi vedere che il prodotto è ora disponibile per tutti gli utenti inclusi nella lista consentita. Se la richiesta non va a buon fine, il prodotto rimane nello stato In **corso** e richiede all'utente di apportare correzioni prima di inviarlo nuovamente.

## Crea l'inserzione
<a name="ami-create-product"></a>

I passaggi di questa sezione spiegano come creare un'offerta per un prodotto con AMI singola.

**Nota**  
È possibile passare al passaggio successivo solo dopo aver completato i campi obbligatori nel passaggio corrente. Non puoi salvare o inviare un passaggio incompleto. Se devi terminare la sessione prima di completare tutti i passaggi del processo, scegli **Salva ed esci** per inviare i passaggi completati all'area di gestione temporanea. Per ulteriori informazioni, consulta [Comprendi l'esperienza self-service](#understand-ami-self-service-exp).

**Per creare un prodotto Single-AMI**

1. Apri l' Portale di gestione Marketplace AWS indirizzo[https://aws.amazon.com/marketplace/management/tour/](https://aws.amazon.com/marketplace/management/tour/), quindi accedi al tuo Account venditore.

1. Dal menu **Prodotti**, scegli **Server**. In alternativa, puoi andare direttamente alla pagina [https://aws.amazon.com/marketplace/management/products/server](https://aws.amazon.com/marketplace/management/products/server).

1. Dalla scheda **Prodotti server**, seleziona **Crea prodotto server**, seleziona **Amazon Machine Image (AMI)**, quindi seleziona uno dei tipi di licenza per i prodotti con AMI singola:
   + **Bring your own license (BYOL)**: un prodotto per il quale l'utente ottiene una licenza da te al di fuori dell'azienda. Marketplace AWS Può essere una licenza a pagamento o gratuita.
   + **Gratuito**: un prodotto gratuito per i tuoi abbonati. (Pagheranno comunque i costi per qualsiasi istanza Amazon Elastic Compute Cloud (Amazon EC2) associata o altre risorse.) AWS 
   + **Pagato ogni ora o ogni ora: prodotto che l'acquirente paga su base oraria o su base oraria con un contratto annuale**. AWS esegue la misurazione in base al codice prodotto sull'AMI.
   + **Pagato mensilmente**: prodotto tramite il quale l'acquirente riceve una fattura mensile. AWS
   + **Utilizzo a pagamento**: il software viene addebitato direttamente in base al valore fornito dall'utente, oltre a una delle quattro categorie di utilizzo: utenti, dati, larghezza di banda o host. È possibile definire fino a 24 dimensioni per il prodotto. Tutte le spese sono comunque a carico del cliente.
   + **AMI con prezzi contrattuali**: un prodotto con AMI singola o AMI singola con uno CloudFormation stack per il quale l'acquirente paga una commissione anticipata.

1. L'esperienza self-service ti guida attraverso i passaggi per creare un'inserzione. Marketplace AWS È necessario inserire le informazioni sul prodotto (metadati), i dettagli sulla distribuzione del prodotto (Regione AWS istanze e dettagli AMI) e i dettagli dell'offerta pubblica (prezzo, EULA, disponibilità per paese, EULA, rimborso). Come opzione, puoi aggiungere account alla lista consentita per testare il prodotto. Completa ogni passaggio per passare alla fase successiva del processo.
**Nota**  
Se devi terminare la sessione prima di completare tutti i passaggi del processo, puoi utilizzare la funzione **Salva ed esci** per inviare i passaggi completati all'area di gestione temporanea. Questo crea una richiesta di convalida delle informazioni fornite. Durante l'elaborazione della richiesta, non puoi modificare il prodotto. Una volta completata la richiesta, puoi continuare a creare il prodotto scegliendo **Riprendi la creazione del prodotto**.   
Una richiesta non riuscita significa che non è stato effettuato alcun aggiornamento al prodotto a causa di un errore di convalida. Questo sarà visibile nel registro delle richieste del prodotto. Puoi selezionare la richiesta per visualizzare l'errore, **utilizzare Copia su nuovo** in **Azioni** per correggere l'errore e inviare nuovamente la richiesta. Quando riprendi i passaggi, puoi continuare dal passaggio successivo a quello salvato nell'ultima sessione. Per aggiornare i passaggi precedenti, vai alla pagina di panoramica del prodotto e invia una richiesta di modifica per aggiornare i passaggi che hai inviato in precedenza.

1. Dopo aver inserito le informazioni richieste per tutti i passaggi della richiesta di modifica, scegli **Invia**. Questo invio crea una richiesta al sistema di Marketplace AWS catalogo per convalidare le informazioni e rilasciare il prodotto allo stato **Limitato**, se la convalida ha esito positivo. Durante l'elaborazione della richiesta, non puoi continuare a modificare il prodotto. Una volta completata la richiesta, il prodotto viene spostato in uno stato **Limitato**. 
   + Quando il prodotto viene pubblicato inizialmente, è accessibile solo al tuo account di prova Account AWS (quello che hai usato per creare il prodotto) e al team di Marketplace AWS Seller Operations. Se visualizzi il prodotto dalla pagina **dei prodotti del Server**, puoi scegliere **Visualizza attiva Marketplace AWS** per visualizzare i dettagli del prodotto così come appariranno Marketplace AWS agli acquirenti. Questo elenco dettagliato non è visibile agli altri Marketplace AWS utenti.
   + Questa funzionalità consente di testare il prodotto (e persino di pubblicare più versioni da testare) prima di rilasciarlo pubblicamente.

1. Testa il tuo prodotto nello stato **Limitato** e assicurati che rispetti i [requisiti di prodotto Marketplace AWS basati su AMI](https://docs.aws.amazon.com/marketplace/latest/userguide/product-and-ami-policies.html) e la lista di controllo del [prodotto](https://docs.aws.amazon.com/marketplace/latest/userguide/aws-marketplace-listing-checklist.html). **Quindi, per richiedere che il prodotto venga pubblicato su **Public**, scegli Aggiorna visibilità.** Il team Marketplace AWS Seller Operations deve esaminare il prodotto prima di approvarne la **pubblicazione**.
**Nota**  
La verifica e la pubblicazione del prodotto sono un processo manuale, gestito dal team Marketplace AWS Seller Operations. La pubblicazione della versione iniziale del prodotto può richiedere 7-10 giorni lavorativi, se non ci sono errori. Per maggiori dettagli sulle tempistiche, consulta [Tempi](https://docs.aws.amazon.com/marketplace/latest/userguide/product-submission.html#timing-and-expectations) e aspettative.

Per ulteriori informazioni sulla preparazione e l'invio sia del prodotto a singola AMI che delle informazioni sul prodotto, vedere. [Risorse aggiuntive](#ami-single-create-resources)

## Risorse aggiuntive
<a name="ami-single-create-resources"></a>

Per ulteriori informazioni sulla preparazione delle informazioni sul prodotto e sull'invio delle stesse per la pubblicazione, consulta le seguenti risorse:
+ [Preparazione del prodotto per Marketplace AWS](product-preparation.md)
+ [Invio del prodotto per la pubblicazione su Marketplace AWS](product-submission.md)

Per ulteriori informazioni sulla preparazione del prodotto Single AMI da inviare a Marketplace AWS, consulta le seguenti risorse:
+ [Procedure consigliate per AMIs la costruzione da utilizzare con Marketplace AWS](best-practices-for-building-your-amis.md)
+ [Lista di controllo dei prodotti AMI per Marketplace AWS](aws-marketplace-listing-checklist.md)
+ [Requisiti di prodotto basati su AMI per Marketplace AWS](product-and-ami-policies.md)

# Aggiungi CloudFormation modelli al tuo prodotto
<a name="cloudformation"></a>

Marketplace AWS i venditori possono pubblicare offerte di prodotti basati sull'AMI che vengono consegnati agli Marketplace AWS acquirenti utilizzando modelli. AWS CloudFormation L'aggiunta di un CloudFormation modello al prodotto basato su AMI consente agli acquirenti di implementare la soluzione senza dover configurare manualmente le risorse e le dipendenze. È possibile utilizzare i modelli per definire un cluster o un'architettura distribuita per i prodotti o per selezionare diverse combinazioni AMI o configurazioni di prodotto. Le soluzioni AMI singole possono contenere un massimo di tre CloudFormation modelli.

I CloudFormation modelli possono essere configurati per fornire una singola Amazon Machine Image (AMI) con file di configurazione e funzioni Lambda associati. Inoltre, è necessario includere un diagramma architettonico per ogni modello.

**Topics**
+ [Preparazione del modello CloudFormation](#aws-cloudformation-template-preparation)
+ [Diagramma architettonico](#topology-diagram)
+ [Converti modelli di prodotti esistenti CloudFormation](#convert-cloudformation-templates)
+ [Aggiungere componenti applicativi serverless](cloudformation-serverless-application.md)

## Preparazione del modello CloudFormation
<a name="aws-cloudformation-template-preparation"></a>

Per creare i CloudFormation modelli, è necessario soddisfare i prerequisiti del modello e fornire i parametri di input e sicurezza richiesti. Quando invii il CloudFormation modello, utilizza le linee guida nelle sezioni seguenti.

### Prerequisiti del modello
<a name="template-prerequisites"></a>
+ Verifica che il modello venga avviato correttamente tramite la CloudFormation console **in tutte le versioni Regioni AWS abilitate per il prodotto**. Puoi utilizzare lo [TaskCat strumento](https://github.com/aws-quickstart/taskcat) per testare i tuoi modelli.
+ AMIs nel CloudFormation modello deve essere inclusa l'AMI del prodotto che stai pubblicando o un'AMI gestita da AWS come la versione più recente di Amazon Linux 2. Non includere AMI della community o AMI posseduti e condivisi da te o da altre terze parti. Per utilizzare un'AMI gestita da AWS, utilizza [i parametri pubblici in AWS Systems Manager Parameter Store](https://docs.aws.amazon.com/systems-manager/latest/userguide/parameter-store-public-parameters.html) anziché l'AMI hardcoding. IDs Ad esempio, all'interno del CloudFormation modello in cui si specifica l'ID AMI, si utilizza un riferimento dinamico`ImageId: '{{resolve:ssm:/aws/service/ecs/optimized-ami/amazon-linux-2/recommended/image_id}}'`.
+ Crea modelli in modo che non dipendano dall'uso in una particolare zona di disponibilità (AZ). Non tutti i clienti hanno accesso a tutti AZs e AZs vengono mappati in modo diverso per account diversi.
+ Se stai creando una soluzione in cluster utilizzando un gruppo Auto Scaling, ti consigliamo di tenere conto di un evento di scaling. Il nuovo nodo dovrebbe unirsi automaticamente al cluster in esecuzione.
+ Anche per i prodotti a nodo singolo, consigliamo di utilizzare un gruppo [Auto Scaling](https://docs.aws.amazon.com/autoscaling/latest/userguide/create-asg-from-instance.html).
+ Se la tua soluzione prevede un cluster di più istanze, prendi in considerazione l'utilizzo di gruppi di collocamento se desideri una bassa latenza di rete, un throughput di rete elevato o entrambi tra le istanze.
+ Per facilitare la revisione da parte del Marketplace AWS team e garantire trasparenza nei confronti del cliente, ti consigliamo di aggiungere commenti nella tua sezione. **UserData**

### Requisiti per i dettagli dell'AMI
<a name="ami-requirements-sse"></a>

**Nota**  
Se crei un'**Amazon Machine Image (AMI) o AMI** nella pagina dei [prodotti server](https://aws.amazon.com//marketplace/management/products/server) del portale del venditore e ti viene richiesto di scaricare il [modulo di caricamento del prodotto](https://docs.aws.amazon.com//marketplace/latest/userguide/product-submission.html#aws-cloudformation-launched-product-free-or-paid-or-usage-based-paid-ami-product), consulta [Requisiti per i dettagli sulle AMI utilizzando il modulo di caricamento del prodotto](#ami-requirements-product-load-form) invece. CloudFormation

[Quando specifichi la `ImageId` proprietà delle risorse che distribuiscono l'AMI su istanze EC2 come [AWS::EC2::Instance](https://docs.aws.amazon.com//AWSCloudFormation/latest/UserGuide/aws-resource-ec2-instance.html), e [AWS::EC2::LaunchTemplate](https://docs.aws.amazon.com//AWSCloudFormation/latest/UserGuide/aws-resource-ec2-launchtemplate.html)resources [AWS::AutoScaling::LaunchConfiguration](https://docs.aws.amazon.com//AWSCloudFormation/latest/UserGuide/aws-resource-autoscaling-launchconfiguration.html), devi fare riferimento a un parametro del modello.](https://docs.aws.amazon.com//AWSCloudFormation/latest/UserGuide/parameters-section-structure.html) Il tipo di parametro deve essere un`AWS::EC2::Image::Id`, o. `AWS::SSM::Parameter::Value<AWS::EC2::Image::Id>` `String`

È possibile assegnare a questo parametro del modello qualsiasi nome di parametro valido. Marketplace AWS [copia il modello nei propri bucket Amazon S3 e sostituisce il parametro specificato con un AWS Systems Manager parametro Parameter Store.](https://docs.aws.amazon.com//systems-manager/latest/userguide/systems-manager-parameter-store.html) Marketplace AWS aggiorna anche la descrizione e il testo dei vincoli per rendere chiaro il valore corretto agli acquirenti che stanno implementando il modello. Quando gli acquirenti implementano il tuo modello, quel parametro viene risolto nell'ID Regione AWS AMI specifico del prodotto pubblicato.

[I seguenti esempi di modello illustrano la `ImageId` proprietà che fa riferimento ai parametri del modello utilizzando la funzione intrinseca Ref.](https://docs.aws.amazon.com//AWSCloudFormation/latest/UserGuide/intrinsic-function-reference-ref.html)

Esempio YAML:

```
Parameters:
  ImageId:
    Type: AWS::EC2::Image::Id
    Default: ami-example1234567890
Resources:
  MyInstance:
    Type: AWS::EC2::Instance
    Properties:
      ImageId: !Ref ImageId
```

Esempio JSON:

```
{
  "Parameters": {
    "ImageId": {
      "Type": "AWS::EC2::Image::Id",
      "Default": "ami-example1234567890"
    }
  },
  "Resources": {
    "MyInstance": {
      "Type": "AWS::EC2::Instance",
      "Properties": {
        "ImageId": {
          "Ref": "ImageId"
        }
      }
    }
  }
}
```

Se stai distribuendo istanze EC2 all'interno di uno stack [annidato anziché dello stack](https://docs.aws.amazon.com//AWSCloudFormation/latest/UserGuide/using-cfn-nested-stacks.html) root, l'ID AMI deve ereditare dinamicamente il suo valore dallo stack root. Modifica gli stack root e nidificati in modo che nello stack principale, l'impostazione del valore del parametro del modello abbia la precedenza sull'ID AMI utilizzato in questo stack nidificato.

### Requisiti per i dettagli sulle AMI utilizzando il modulo di caricamento del prodotto
<a name="ami-requirements-product-load-form"></a>

**Nota**  
Quando crei un'**Amazon Machine Image (AMI) o AMI CloudFormation** sulla pagina dei [prodotti server](https://aws.amazon.com//marketplace/management/products/server) del portale del venditore e non ti viene richiesto immediatamente di scaricare il [modulo di caricamento del prodotto](https://docs.aws.amazon.com//marketplace/latest/userguide/product-submission.html#aws-cloudformation-launched-product-free-or-paid-or-usage-based-paid-ami-product), vedi [Requisiti per i dettagli dell'AMI](#ami-requirements-sse) invece.

AMIs deve trovarsi in una tabella di mappatura per ogni regione. Il Marketplace AWS team aggiorna gli AMI IDs dopo la clonazione. L'AMI di origine deve trovarsi nella `us-east-1` regione. Le altre regioni possono utilizzare i segnaposti.

Esempio YAML:

```
Mappings: 
  RegionMap: 
      us-east-1: 
          ImageId: ami-0123456789abcdef0
      us-west-1: 
          ImageId: ami-xxxxxxxxxxxxxxxxx
      eu-west-1: 
          ImageId: ami-xxxxxxxxxxxxxxxxx
      ap-southeast-1: 
          ImageId: ami-xxxxxxxxxxxxxxxxx
Resources:
  EC2Instance:
    Type: AWS::EC2::Instance
    Properties:
      ImageId: !FindInMap 
        - RegionMap
        - !Ref AWS::Region
        - ImageId
```

### Requisiti per i modelli di stack annidati
<a name="nested-stack-template-requirements"></a>

**Nota**  
Questa sezione si applica solo ai modelli di prezzo che non utilizzano il modulo di [caricamento del prodotto](https://docs.aws.amazon.com//marketplace/latest/userguide/product-submission.html#aws-cloudformation-launched-product-free-or-paid-or-usage-based-paid-ami-product). Per i modelli di prezzo che *utilizzano* il modulo di caricamento del prodotto, è consentita solo una stringa fissa per la proprietà nested stack`TemplateURL`.

Se il modello include stack [nidificati, la `TemplateURL` proprietà delle risorse dello stack](https://docs.aws.amazon.com//AWSCloudFormation/latest/UserGuide/using-cfn-nested-stacks.html) nidificato deve fare riferimento ai parametri del modello per il nome del bucket Amazon S3, la regione del bucket e il prefisso della chiave dell'oggetto Amazon S3. I nomi dei parametri per il nome del bucket devono essere`MPS3BucketName`, il bucket Region deve essere `MPS3BucketRegion` e per il prefix della chiave dell'oggetto deve essere. `MPS3KeyPrefix`

Imposta i valori predefiniti per questi parametri in modo che corrispondano al tuo bucket Amazon S3 in cui sono archiviati i modelli nidificati. Tutti i modelli nidificati devono essere accessibili pubblicamente. Quando invii il modello per la pubblicazione, lo Marketplace AWS copia nei relativi bucket Amazon S3 e modifica le proprietà di questi tre parametri in modo che il valore predefinito e il valore consentito siano impostati in modo che corrispondano a dove sono archiviate le copie. Marketplace AWS aggiorna inoltre la descrizione e il testo dei vincoli per rendere chiari i valori corretti agli acquirenti che utilizzano il modello.

Se disponi di più livelli di stack nidificati, tutti gli stack nidificati che creano stack nidificati aggiuntivi devono essere configurati in modo che la `TemplateURL` proprietà erediti dinamicamente i valori del nome del bucket Amazon S3, della regione del bucket Amazon S3 e della chiave dell'oggetto Amazon S3 dallo stack principale. Modifica gli stack root e nidificati in modo che nella pila principale, imposti il valore del parametro `MPS3BucketName` template e `MPS3KeyPrefix` sovrascriva i rispettivi valori nell'URL utilizzato in questo stack nidificato per creare ulteriori stack nidificati. `MPS3BucketRegion`

[I seguenti esempi di modello illustrano la `TemplateURL` proprietà che fa riferimento ai parametri del modello utilizzando la funzione intrinseca Fn: :Sub.](https://docs.aws.amazon.com//AWSCloudFormation/latest/UserGuide/intrinsic-function-reference-sub.html)

Esempio YAML:

```
AWSTemplateFormatVersion: '2010-09-09'
Metadata:
  AWS::CloudFormation::Interface:
    ParameterGroups:
      - Label:
          default: Marketplace AWS Parameters
        Parameters:
          - ImageId
          - MPS3BucketName
          - MPS3BucketRegion
          - MPS3KeyPrefix
Parameters:
  ImageId:
    Type: AWS::EC2::Image::Id
    Default: ami-example1234567890
    Description: The AMI that will be used to launch EC2 resources.
  MPS3BucketName:
    Type: String
    Default: sellerbucket
    Description: Name of the S3 bucket for your copy of the nested templates.
  MPS3BucketRegion:
    Type: String
    Default: us-east-1
    Description: AWS Region where the S3 bucket for your copy of the nested templates is hosted.
  MPS3KeyPrefix:
    Type: String
    Default: sellerproductfolder/
    Description: S3 key prefix that is used to simulate a folder for your copy of the nested templates.
Resources:
  EC2Instance:
    Type: AWS::EC2::Instance
    Properties:
      ImageId: !Ref ImageId
  NestedStack:
    Type: AWS::CloudFormation::Stack
    Properties:
      TemplateURL: !Sub https://${MPS3BucketName}.s3.${MPS3BucketRegion}.${AWS::URLSuffix}/${MPS3KeyPrefix}nested-template.yaml
```

Esempio JSON:

```
{
    "AWSTemplateFormatVersion": "2010-09-09",
    "Metadata": {
        "AWS::CloudFormation::Interface": {
            "ParameterGroups": [
                {
                    "Label": {
                        "default": "Marketplace AWS Parameters"
                    },
                    "Parameters": [
                        "ImageId",
                        "MPS3BucketName",
                        "MPS3BucketRegion",
                        "MPS3KeyPrefix"
                    ]
                }
            ]
        }
    },
    "Parameters": {
        "ImageId": {
            "Type": "AWS::EC2::Image::Id",
            "Default": "ami-example1234567890",
            "Description": "The AMI that will be used to launch EC2 resources."
        },
        "MPS3BucketName": {
            "Type": "String",
            "Default": "sellerbucket",
            "Description": "Name of the S3 bucket for your copy of the nested templates."
        },
        "MPS3BucketRegion": {
            "Type": "String",
            "Default": "us-east-1",
            "Description": "AWS Region where the S3 bucket for your copy of the nested templates is hosted."
        },
        "MPS3KeyPrefix": {
            "Type": "String",
            "Default": "sellerproductfolder/",
            "Description": "S3 key prefix that is used to simulate a folder for your copy of the nested templates."
        }
    },
    "Resources": {
        "EC2Instance": {
            "Type": "AWS::EC2::Instance",
            "Properties": {
                "ImageId": {
                    "Ref": "ImageId"
                }
            }
        },
        "NestedStack": {
            "Type": "AWS::CloudFormation::Stack",
            "Properties": {
                "TemplateURL": {
                    "Fn::Sub": "https://${MPS3BucketName}.s3.${MPS3BucketRegion}.${AWS::URLSuffix}/${MPS3KeyPrefix}nested-template.yaml"
                }
            }
        }
    }
}
```

**Nota**  
[AWS::CloudFormation::Interface](https://docs.aws.amazon.com//AWSCloudFormation/latest/UserGuide/aws-resource-cloudformation-interface.html)viene utilizzato per definire il modo in cui i parametri vengono raggruppati e ordinati nella AWS CloudFormation console quando gli acquirenti implementano il modello.

### Parametri di input del modello
<a name="template-input-parameters"></a>
+ I parametri di input del modello non devono includere le AWS credenziali del Marketplace AWS cliente (come password, chiavi pubbliche, chiavi private o certificati).
+ Per i parametri di input sensibili come le password, scegli la `NoEcho` proprietà e abilita un'espressione regolare più forte. Per altri parametri di input, impostate gli input più comuni insieme al testo di supporto appropriato.
+ Utilizzate i tipi di CloudFormation parametri per gli input, se disponibili.
+ `AWS::CloudFormation::Interface`Da utilizzare per raggruppare e ordinare i parametri di input.
+ Non impostate alcun valore predefinito per i seguenti parametri di input:
**Nota**  
I clienti devono fornirli come parametri di input.
  + Intervalli CIDR predefiniti che consentono l'accesso alle porte di accesso remoto dalla rete Internet pubblica
  + Intervalli CIDR predefiniti che consentono l'accesso alle porte di connessione del database dalla rete Internet pubblica
  + Password predefinite per utenti o database

### Parametri di rete e sicurezza
<a name="networksecurity-parameters"></a>
+ Assicurati che la porta SSH (22) o la porta RDP (3389) predefinita non sia aperta a 0.0.0.0.
+ Invece di utilizzare il cloud privato virtuale (VPC) predefinito, ti consigliamo di creare un VPC con elenchi di controllo degli accessi (ACLs) e gruppi di sicurezza appropriati. 
+ Il modello non può richiedere chiavi di accesso a lungo termine agli utenti o crearle per accedere AWS alle risorse. Se la tua applicazione AMI richiede l'accesso ai AWS servizi nell'account dell'acquirente, deve utilizzare [i ruoli IAM per Amazon EC2](/AWSEC2/latest/UserGuide/iam-roles-for-amazon-ec2.html).
+ Imposta i ruoli e le policy IAM per [concedere il minimo privilegio](https://docs.aws.amazon.com/IAM/latest/UserGuide/best-practices.html#grant-least-privilege) e abilitare l'accesso in scrittura solo quando assolutamente necessario. Ad esempio, se la tua applicazione richiede solo `DELETE` le operazioni e `S3:GET``PUT`, specifica solo quelle azioni. In questo caso si sconsiglia l'uso di`S3:*`. 

Dopo aver ricevuto il modello, Marketplace AWS convalida la configurazione e le informazioni del prodotto e fornisce feedback per eventuali revisioni richieste.

## Diagramma architettonico
<a name="topology-diagram"></a>

È necessario fornire un diagramma architettonico per ogni modello. Per ulteriori informazioni sulla creazione di diagrammi, vedi [Cos'è](https://aws.amazon.com/what-is/architecture-diagramming/) la creazione di diagrammi di architettura?

Il diagramma deve soddisfare i seguenti criteri:
+ Illustra una distribuzione standard su. AWS
+ Descrivi in modo logico dove vengono distribuite le risorse. Ad esempio, risorse come le istanze Amazon EC2 si trovano nella sottorete corretta.
+ Usa le icone di prodotto più recenti per ogni AWS prodotto Servizio AWS distribuito tramite il modello. CloudFormation Per scaricare l'attuale set di icone di architettura, vedi [AWS Architecture Icons](https://aws.amazon.com/architecture/icons/).
+ Includi i metadati per tutti i servizi distribuiti dal CloudFormation modello.
+ Include tutte le reti e VPCs le sottoreti distribuite dal modello. CloudFormation 
+ Mostra i punti di integrazione, inclusi gli asset di terze parti APIs e gli asset ibridi locali.
+ I diagrammi devono avere una dimensione di 1100 x 700 pixel. Mantieni le proporzioni originali del diagramma senza allungarle o ritagliarle.

## Converti modelli di prodotti esistenti CloudFormation
<a name="convert-cloudformation-templates"></a>

**Nota**  
Questa sezione è dedicata ai venditori con un'AMI esistente con CloudFormation prodotto che hanno utilizzato il [modulo di caricamento del prodotto](https://docs.aws.amazon.com/marketplace/latest/userguide/product-submission.html#aws-cloudformation-launched-product-free-or-paid-or-usage-based-paid-ami-product) per pubblicare i propri modelli e ora desiderano aggiornare tale modello senza utilizzare il modulo di caricamento del prodotto. Se stai pubblicando un nuovo prodotto, consulta [Preparazione dei CloudFormation modelli](https://docs.aws.amazon.com/marketplace/latest/userguide/cloudformation.html#aws-cloudformation-template-preparation).  
Se crei un'**Amazon Machine Image (AMI) o AMI** nella pagina dei [prodotti server](https://aws.amazon.com//marketplace/management/products/server) del portale del venditore e ti viene richiesto di scaricare il [modulo di caricamento del prodotto](https://docs.aws.amazon.com//marketplace/latest/userguide/product-submission.html#aws-cloudformation-launched-product-free-or-paid-or-usage-based-paid-ami-product), consulta[Requisiti per i dettagli sulle AMI utilizzando il modulo di caricamento del prodotto](#ami-requirements-product-load-form). CloudFormation

Se desideri utilizzare l'esperienza self-service per aggiornare un prodotto esistente che in precedenza utilizzava il [modulo di caricamento del prodotto](https://docs.aws.amazon.com/marketplace/latest/userguide/product-submission.html#aws-cloudformation-launched-product-free-or-paid-or-usage-based-paid-ami-product) per la pubblicazione, devi apportare modifiche al modello esistente CloudFormation.

La tabella seguente descrive la differenza tra l'utilizzo del modulo di caricamento del prodotto e l'esperienza self-service:


****  

|  | Modulo di caricamento del prodotto | Esperienza self-service | 
| --- | --- | --- | 
| Valore della ImageId proprietà per le risorse EC2 | Fa riferimento a una tabella di mappatura per il tuo ID AMI. Per ulteriori informazioni, consulta [Requisiti per i dettagli sulle AMI utilizzando il modulo di caricamento del prodotto](#ami-requirements-product-load-form).  | Fa riferimento a un parametro modello per il tuo ID AMI. Per ulteriori informazioni, consulta [Requisiti per i dettagli dell'AMI](#ami-requirements-sse).  | 
| Valore della TemplateURL proprietà per gli stack annidati | Deve essere una stringa fissa e non può utilizzare funzioni intrinseche. | Può essere dinamico utilizzando funzioni intrinseche. Deve fare riferimento a un set di parametri del modello. Per ulteriori informazioni, consulta [Requisiti per i modelli di stack annidati](#nested-stack-template-requirements) | 

I modelli di esempio seguenti illustrano un esempio di un prodotto esistente che ha utilizzato il modulo di caricamento del prodotto per pubblicare il modello. In questo esempio, l'ID AMI è `ami-example123456` e un modello annidato si trova nel bucket S3 del venditore presso la sede. `https://sellerbucket.s3.us-east-1.amazonaws.com/sellerproductfolder/nested-template.yaml`

Esempio YAML pubblicato con il modulo di caricamento del prodotto:

```
AWSTemplateFormatVersion: '2010-09-09'
Mappings:
  RegionMap:
    us-east-1:
      AMI: ami-example123456
Resources:
  EC2Instance:
    Type: AWS::EC2::Instance
    Properties:
      ImageId: !FindInMap 
        - RegionMap
        - !Ref AWS::Region
        - AMI
  NestedStack:
    Type: AWS::CloudFormation::Stack
    Properties:
      TemplateURL: https://sellerbucket.s3.us-east-1.amazonaws.com/sellerproductfolder/nested-template.yaml
```

Esempio JSON pubblicato con il modulo di caricamento del prodotto:

```
{
    "AWSTemplateFormatVersion": "2010-09-09",
    "Mappings": {
        "RegionMap": {
            "us-east-1": {
                "AMI": "ami-example123456"
            }
        }
    },
    "Resources": {
        "EC2Instance": {
            "Type": "AWS::EC2::Instance",
            "Properties": {
                "ImageId": {
                    "Fn::FindInMap": [
                        "RegionMap",
                        {
                            "Ref": "AWS::Region"
                        },
                        "AMI"
                    ]
                }
            }
        },
        "NestedStack": {
            "Type": "AWS::CloudFormation::Stack",
            "Properties": {
                "TemplateURL": "https://sellerbucket.s3.us-east-1.amazonaws.com/sellerproductfolder/nested-template.yaml"
            }
        }
    }
}
```

I seguenti esempi di modelli illustrano le modifiche necessarie per utilizzare l'esperienza self-service per aggiornare il prodotto.

Esempio YAML pubblicato con l'esperienza self-service:

```
AWSTemplateFormatVersion: '2010-09-09'
Metadata:
  AWS::CloudFormation::Interface:
    ParameterGroups:
      - Label:
          default: Marketplace AWS Parameters
        Parameters:
          - ImageId
          - MPS3BucketName
          - MPS3BucketRegion
          - MPS3KeyPrefix
Parameters:
  ImageId:
    Type: AWS::EC2::Image::Id
    Default: ami-example123456
    Description: The AMI that will be used to launch EC2 resources.
  MPS3BucketName:
    Type: String
    Default: sellerbucket
    Description: Name of the S3 bucket for your copy of the nested templates.
  MPS3BucketRegion:
    Type: String
    Default: us-east-1
    Description: AWS Region where the S3 bucket for your copy of the nested templates is hosted.
  MPS3KeyPrefix:
    Type: String
    Default: sellerproductfolder/
    Description: S3 key prefix that is used to simulate a folder for your copy of the nested templates.
Resources:
  EC2Instance:
    Type: AWS::EC2::Instance
    Properties:
      ImageId: !Ref ImageId
  NestedStack:
    Type: AWS::CloudFormation::Stack
    Properties:
      TemplateURL: !Sub https://${MPS3BucketName}.s3.${MPS3BucketRegion}.${AWS::URLSuffix}/${MPS3KeyPrefix}nested-template.yaml
```

Esempio JSON pubblicato con l'esperienza self-service:

```
{
    "AWSTemplateFormatVersion": "2010-09-09",
    "Metadata": {
        "AWS::CloudFormation::Interface": {
            "ParameterGroups": [
                {
                    "Label": {
                        "default": "Marketplace AWS Parameters"
                    },
                    "Parameters": [
                        "ImageId",
                        "MPS3BucketName",
                        "MPS3BucketRegion",
                        "MPS3KeyPrefix"
                    ]
                }
            ]
        }
    },
    "Parameters": {
        "ImageId": {
            "Type": "AWS::EC2::Image::Id",
            "Default": "ami-example123456",
            "Description": "The AMI that will be used to launch EC2 resources."
        },
        "MPS3BucketName": {
            "Type": "String",
            "Default": "sellerbucket",
            "Description": "Name of the S3 bucket for your copy of the nested templates."
        },
        "MPS3BucketRegion": {
            "Type": "String",
            "Default": "us-east-1",
            "Description": "AWS Region where the S3 bucket for your copy of the nested templates is hosted."
        },
        "MPS3KeyPrefix": {
            "Type": "String",
            "Default": "sellerproductfolder/",
            "Description": "S3 key prefix that is used to simulate a folder for your copy of the nested templates."
        }
    },
    "Resources": {
        "EC2Instance": {
            "Type": "AWS::EC2::Instance",
            "Properties": {
                "ImageId": {
                    "Ref": "ImageId"
                }
            }
        },
        "NestedStack": {
            "Type": "AWS::CloudFormation::Stack",
            "Properties": {
                "TemplateURL": {
                    "Fn::Sub": "https://${MPS3BucketName}.s3.${MPS3BucketRegion}.${AWS::URLSuffix}/${MPS3KeyPrefix}nested-template.yaml"
                }
            }
        }
    }
}
```

# Aggiungere componenti applicativi serverless
<a name="cloudformation-serverless-application"></a>

**Importante**  
Marketplace AWS non supporta più la pubblicazione di nuovi prodotti con CloudFormation modelli che distribuiscono risorse da. AWS Serverless Application Repository I venditori possono continuare a pubblicare prodotti esistenti con CloudFormation modelli che utilizzano risorse AWS Serverless Application Repository fino a una data futura che verrà annunciata.

Puoi creare un prodotto che includa un'Amazon Machine Image (AMI), fornita utilizzando un AWS CloudFormation modello, con componenti serverless incorporati nel prodotto. Ad esempio, puoi creare un prodotto con un AMI configurato come server di controllo e distribuirlo come CloudFormation stack. Il CloudFormation modello utilizzato per creare lo stack può includere la definizione per impostare una AWS Lambda funzione attivata da un evento nel server. Quando utilizzi questo approccio per progettare il tuo prodotto, puoi semplificare l'architettura e facilitarne il lancio per gli acquirenti. Questo approccio può anche semplificare l'aggiornamento del prodotto. Le seguenti sezioni mostrano come creare e offrire questo tipo di prodotto.

Per informazioni sulla creazione di un AMI per il tuo prodotto, consulta[Prodotti a base di AMI in Marketplace AWS](ami-products.md). Per informazioni sulla compilazione AWS CloudFormation dei modelli per il prodotto, consulta[Aggiungi CloudFormation modelli al tuo prodotto](cloudformation.md). 

Quando definisci un'applicazione serverless, utilizzi un modello AWS Serverless Application Model (AWS SAM) archiviato in. AWS Serverless Application Repository AWS SAM è un framework open source per la creazione di applicazioni serverless. Durante la distribuzione, AWS SAM trasforma ed espande la sintassi in sintassi. AWS Serverless Application Model CloudFormation AWS Serverless Application Repository È un repository gestito per applicazioni serverless. Consente di archiviare e condividere applicazioni riutilizzabili in modo che gli acquirenti possano assemblare e implementare architetture serverless. 

**Nota**  
Marketplace AWS esamina e convalida il prodotto prima della creazione dell'inserzione. Se ci sono problemi che devi risolvere prima che l'offerta venga pubblicata, ti invieremo un messaggio e-mail.
Come parte dell'adempimento di un abbonamento, copiamo le AMIs applicazioni e i CloudFormation modelli serverless in un archivio di Marketplace AWS proprietà di ciascuno di essi. Regione AWS Quando un acquirente si abbona al tuo prodotto, gli concediamo l'accesso e lo informiamo anche quando aggiorni il software.

**Topics**
+ [Fase 1: Crea un'applicazione serverless](#cloudformation-serverless-application-procedure-step-1)
+ [Fase 2: Pubblica l'applicazione nel repository](#cloudformation-serverless-application-procedure-step-2)
+ [Fase 3: Creare il modello CloudFormation](#cloudformation-serverless-application-procedure-step-3)
+ [Fase 4: Inviare il CloudFormation modello e i file di configurazione](#cloudformation-serverless-application-procedure-step-4)
+ [Passaggio 5: aggiorna le autorizzazioni dell'applicazione AWS Serverless Application Repository](#cloudformation-serverless-application-procedure-step-5)
+ [Passaggio 6: condividi la tua AMI](#cloudformation-serverless-application-procedure-step-6)
+ [Passaggio 7: invia il CloudFormation prodotto con AMI e un'applicazione serverless](#cloudformation-serverless-application-procedure-step-7)

## Fase 1: Crea un'applicazione serverless
<a name="cloudformation-serverless-application-procedure-step-1"></a>

Il primo passaggio consiste nel creare un pacchetto delle AWS Lambda funzioni utilizzate per creare un'applicazione serverless. L'applicazione è una combinazione di funzioni Lambda, sorgenti di eventi e altre risorse che collaborano per eseguire attività. Un'applicazione serverless può essere semplice come una sola funzione Lambda oppure può contenere più funzioni con altre risorse, APIs come database e mappature delle sorgenti degli eventi.

Usa il AWS SAM per definire un modello per la tua applicazione serverless. Per le descrizioni dei nomi e dei tipi di proprietà, vedi [AWS::Serverless::Application](https://github.com/awslabs/serverless-application-model/blob/master/versions/2016-10-31.md#awsserverlessapplication)in AWS Labs on. GitHub Di seguito è riportato un esempio di AWS SAM modello con una sola funzione Lambda e un ruolo AWS Identity and Access Management (IAM).

```
AWSTemplateFormatVersion: '2010-09-09'
Transform: AWS::Serverless-2016-10-31
Description: An example of SAM template with Lambda function and IAM role

Resources:
  SampleFunction:
    Type: AWS::Serverless::Function
    Properties:
      Handler: 'com.sampleproject.SampleHandler::handleRequest'
      Runtime: java8
      CodeUri: 's3://amzn-s3-demo-bucket/2EXAMPLE-1234-4b12-ac37-515EXAMPLEe5-lambda.zip'
      Description: Sample Lambda function
      Timeout: 120
      MemorySize: 1024
      Role:
        Fn::GetAtt: [SampleFunctionRole, Arn]

  # Role to execute the Lambda function
  SampleFunctionRole:
    Type: "AWS::IAM::Role"
    Properties:
      AssumeRolePolicyDocument:
        Statement:
          - Effect: "Allow"
            Principal:
              Service:
                - "lambda.amazonaws.com"
            Action: "sts:AssumeRole"
      ManagedPolicyArns:
        - "arn:aws:iam::aws:policy/service-role/AWSLambdaBasicExecutionRole"
      Policies:
        - PolicyName: SFNXDeployWorkflowDefinitionPolicy
          PolicyDocument:
            Statement:
              - Effect: "Allow"
                Action:
                  - "s3:Get*"
                Resource: "*"
      RoleName: "SampleFunctionRole"
```

## Fase 2: Pubblica l'applicazione nel repository
<a name="cloudformation-serverless-application-procedure-step-2"></a>

Per pubblicare un'applicazione, caricare innanzi tutto il suo codice. Archivia i tuoi artefatti di codice (ad esempio funzioni Lambda, script, file di configurazione) in un bucket Amazon S3 di proprietà del tuo account. Quando carichi l'applicazione, questa è inizialmente impostata come privata, il che significa che è disponibile solo per chi l'ha creata. Account AWS Devi creare una policy IAM che conceda AWS Serverless Application Repository le autorizzazioni per accedere agli artefatti che hai caricato.

**Per pubblicare la tua applicazione serverless nel repository di applicazioni serverless**

1. Apri la console Amazon S3 all'indirizzo. [https://console.aws.amazon.com/s3/](https://console.aws.amazon.com/s3/)

1. Scegli il bucket Amazon S3 che hai usato per impacchettare la tua applicazione.

1. Scegli la scheda **Autorizzazioni**.

1. Scegli **Bucket Policy** (Policy del bucket).

1. Copia e incolla il seguente esempio di dichiarazione politica. 
**Nota**  
L'istruzione politica di esempio produrrà un errore fino a quando i valori di `aws:SourceAccount` e `Resource` non verranno aggiornati nei passaggi seguenti.

------
#### [ JSON ]

****  

   ```
   {
       "Version":"2012-10-17",		 	 	 
       "Statement": [
           {
               "Effect": "Allow",
               "Principal": {
                   "Service":  "serverlessrepo.amazonaws.com"
               },
               "Action": "s3:GetObject",
               "Resource": "arn:aws:s3:::amzn-s3-demo-bucket/*",
               "Condition" : {
                   "StringEquals": {
                       "aws:SourceAccount": "123456789012"
                   }
               }
           }
       ]
   }
   ```

------

   1. Sostituisci amzn-s3-demo-bucket nel valore della `Resource` proprietà con il nome del bucket. 

   1. Sostituisci *123456789012* l'elemento Account AWS con `Condition` il tuo ID. L'`Condition`elemento garantisce che AWS Serverless Application Repository solo l'utente disponga del permesso di accedere alle applicazioni specificate Account AWS.

1. Scegli **Save** (Salva).

1. Apri la AWS Serverless Application Repository console all'indirizzo[https://console.aws.amazon.com/serverlessrepo](https://console.aws.amazon.com/serverlessrepo).

1. Nella pagina Le **mie applicazioni**, scegli **Pubblica applicazione**.

1. Compila i campi obbligatori e tutti i campi facoltativi, a seconda dei casi. I campi obbligatori sono:
   +  **Application name (Nome applicazione)** 
   +  **Autore** 
   +  **Descrizione** 
   +  **URL del codice sorgente** 
   +  **Modello SAM** 

1. Scegli **Pubblica applicazione**. 

**Per pubblicare le versioni successive dell'applicazione**

1. Apri la AWS Serverless Application Repository console all'indirizzo[https://console.aws.amazon.com/serverlessrepo](https://console.aws.amazon.com/serverlessrepo).

1. Nel riquadro di navigazione, da **Le mie applicazioni**, scegli l'applicazione.

1. Selezionare **Publish new version** (Pubblica nuova versione).

Per ulteriori informazioni, consulta [Pubblicazione di applicazioni serverless tramite la AWS SAM CLI](https://docs.aws.amazon.com/serverless-application-model/latest/developerguide/serverless-sam-template-publishing-applications.html).

## Fase 3: Creare il modello CloudFormation
<a name="cloudformation-serverless-application-procedure-step-3"></a>

Per creare i CloudFormation modelli, è necessario soddisfare i prerequisiti del modello e fornire i parametri di input e sicurezza richiesti. Per ulteriori informazioni, consulta [Anatomia del modello](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/template-anatomy.html) nella Guida per l'*AWS CloudFormation utente*.

Nel tuo CloudFormation modello, puoi fare riferimento alla tua applicazione serverless e alla tua AMI. È inoltre possibile utilizzare CloudFormation modelli nidificati e fare riferimento ad applicazioni serverless sia nel modello radice che nei modelli nidificati. Per fare riferimento all'applicazione serverless, si utilizza il modello. AWS SAM È possibile generare automaticamente il AWS SAM modello per l'applicazione da. AWS Serverless Application Repository Di seguito è riportato un modello di esempio.

```
AWSTemplateFormatVersion: '2010-09-09'
Transform: AWS::Serverless-2016-10-31
Description: An example root template for a SAR application

Resources:
  SampleSARApplication:
    Type: AWS::Serverless::Application
    Properties:
      Location:
         ApplicationId: arn:aws:serverlessrepo:us-east-1:1234567890:applications/TestApplication
         SemanticVersion: 1.0.0
  SampleEC2Instance:
    Type: AWS::EC2::Instance
      Properties: 
        ImageId: "ami-79fd7eee"
        KeyName: "testkey"
        BlockDeviceMappings: 
          - DeviceName: "/dev/sdm"
            Ebs: 
              VolumeType: "io1"
              Iops: "200"
              DeleteOnTermination: "false"
              VolumeSize: "20"
          - DeviceName: "/dev/sdk"
            NoDevice: {}
```

Il AWS SAM modello contiene i seguenti elementi:
+  `ApplicationID`— Amazon Resource Name (ARN) dell'applicazione. Queste informazioni si trovano nella sezione Le **mie applicazioni** di AWS Serverless Application Repository.
+  `SemanticVersion`— La versione della tua applicazione serverless. Puoi trovarla nella sezione Le **mie applicazioni** di AWS Serverless Application Repository.
+  `Parameter`(opzionale) — Parametri dell'applicazione.

**Nota**  
Per `ApplicationID` e`SemanticVersion`, le [funzioni intrinseche](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/intrinsic-function-reference.html) non sono supportate. È necessario codificare tali stringhe. `ApplicationID`Viene aggiornato quando viene clonato da. Marketplace AWS

Se hai intenzione di fare riferimento ai file di configurazione e di script nel tuo CloudFormation modello, usa il seguente formato. Per i modelli annidati (`AWS::Cloudformation::Stack`), sono supportate solo le funzioni intrinseche `TemplateURLs` senza. Annota il `Parameters` contenuto del modello.

```
AWSTemplateFormatVersion: '2010-09-09'
Metadata:
  Name: Seller test product
Parameters:
  CFTRefFilesBucket:
    Type: String
    Default: "seller-bucket"
  CFTRefFilesBucketKeyPrefix:
    Type: String
    Default: "cftsolutionFolder/additionCFfiles"
Resources:
  TestEc2:
    Type: AWS::EC2::Instance
    Metadata:
      AWS::CloudFormation::Init:
        addCloudAccount:
          files:
            /etc/cfn/set-aia-settings.sh:
              source:
                Fn::Sub:
                - https://${CFTRefFilesBucket}.${S3Region}amazonaws.com/${CFTRefFilesBucketKeyPrefix}/sampleScript.sh
                - S3Region:
                    !If
                    - GovCloudCondition
                    - s3-us-gov-west-1
                    - s3
              owner: root
              mode: '000700'
              authentication: Amazon S3AccessCreds
    ..
    ..
    ..
  SampleNestedStack:
    Type: AWS::CloudFormation::Stack
    Properties:
      TemplateURL: 'https://sellerbucket.s3.amazon.com/sellerproductfolder/nestedCft.template'
      Parameters:
        SampleParameter: 'test'
Transform: AWS::Serverless-2016-10-31
```

## Fase 4: Inviare il CloudFormation modello e i file di configurazione
<a name="cloudformation-serverless-application-procedure-step-4"></a>

Per inviare il CloudFormation modello e i file di configurazione e script, concedi Marketplace AWS le autorizzazioni per leggere il bucket Amazon S3 in cui sono archiviati questi file. A tale scopo, aggiorna la tua policy sui bucket per includere le seguenti autorizzazioni.

------
#### [ JSON ]

****  

```
{
    "Version":"2012-10-17",		 	 	 
    "Statement": [
        {
            "Effect": "Allow",
            "Principal": {
                "Service":  "assets.marketplace.amazonaws.com"
            },
            "Action": ["s3:GetObject", "s3:ListBucket"],
            "Resource": ["arn:aws:s3:::amzn-s3-demo-bucket",
                         "arn:aws:s3:::amzn-s3-demo-bucket/*"]
        }
    ]
}
```

------

## Passaggio 5: aggiorna le autorizzazioni dell'applicazione AWS Serverless Application Repository
<a name="cloudformation-serverless-application-procedure-step-5"></a>

Per inviare la AWS Serverless Application Repository domanda a Marketplace AWS, è necessario concedere Marketplace AWS le autorizzazioni per leggere la domanda. A tale scopo, aggiungi le autorizzazioni a una politica associata all'applicazione serverless. Esistono due modi per aggiornare la politica dell'applicazione:
+ Vai all'[AWS Serverless Application Repository](https://console.aws.amazon.com/serverlessrepo/home). Scegli la tua applicazione serverless dall'elenco. Seleziona la scheda **Condivisione** e scegli **Crea dichiarazione**. Nella pagina di **configurazione dell'estratto** conto, inserisci il seguente responsabile del servizio nel campo **Account Ids**. **assets.marketplace.amazonaws.com** Quindi scegli **Save** (Salva).
+ Utilizzate il AWS CLI comando seguente per aggiornare la politica dell'applicazione.

  ```
  aws serverlessrepo put-application-policy \
  --region region \
  --application-id application-arn \
  --statements Principals=assets.marketplace.amazonaws.com,Actions=Deploy
  ```

## Passaggio 6: condividi la tua AMI
<a name="cloudformation-serverless-application-procedure-step-6"></a>

Tutti i prodotti AMIs creati e inviati Marketplace AWS devono rispettare tutte le politiche di prodotto. La scansione AMI self-service è disponibile in. Portale di gestione Marketplace AWS Con questa funzione, puoi avviare le scansioni dei tuoi. AMIs I risultati della scansione vengono ricevuti rapidamente (in genere, in meno di un'ora) con un feedback chiaro in un'unica posizione. Dopo che la scansione dell'AMI è stata completata correttamente, invia l'AMI per l'elaborazione da parte del team Operazioni del Marketplace AWS venditore caricando il modulo di caricamento del prodotto. 

## Passaggio 7: invia il CloudFormation prodotto con AMI e un'applicazione serverless
<a name="cloudformation-serverless-application-procedure-step-7"></a>

Tieni presente quanto segue prima di inviare il prodotto:
+ È necessario fornire un diagramma architettonico per ogni modello. Il diagramma deve utilizzare le icone dei AWS prodotti per ogni AWS servizio distribuito tramite il modello. CloudFormation Inoltre, il diagramma deve includere i metadati per i servizi. Per scaricare le nostre icone di AWS architettura ufficiali, consulta [AWS Architecture](https://aws.amazon.com/architecture/icons) Icons.
+ La stima dei costi di infrastruttura per ogni modello mostrato agli acquirenti si basa su una stima fornita utilizzando il [Calcolatore AWS dei prezzi](https://calculator.s3.amazonaws.com/index.html). Nella stima, includi l'elenco dei servizi da distribuire come parte del modello, insieme ai valori predefiniti per una distribuzione tipica.
+ Completa il modulo di caricamento del prodotto. È possibile trovare il modulo di caricamento del prodotto su Portale di gestione Marketplace AWS. È necessario un modulo di caricamento del prodotto diverso per singoli prodotti AMI e più prodotti AMI. Nel modulo di caricamento del prodotto, fornirai un URL pubblico al tuo CloudFormation modello. CloudFormation i modelli devono essere inviati sotto forma di URL pubblico.
+ Usa il Portale di gestione Marketplace AWS per inviare la tua inserzione. Da **Risorse**, scegli **Caricamento file**, allega il file, quindi scegli **Carica**. Dopo aver ricevuto il modello e i metadati, AWS inizia a elaborare la richiesta.

Dopo aver inviato l'offerta, Marketplace AWS esamina e convalida il modulo di caricamento del prodotto. Inoltre, Marketplace AWS regionalizza le applicazioni serverless AMIs e aggiorna la mappatura regionale del modello per tuo CloudFormation conto. In caso di problemi, il team operativo del Marketplace AWS venditore ti contatterà tramite e-mail. 

# Gestione dei prodotti basati su AMI in qualità di venditore Marketplace AWS
<a name="concept-chapter-servicename"></a>

In qualità di Marketplace AWS venditore, puoi gestire e aggiornare i tuoi singoli prodotti [Amazon Machine Images (AMIs)](https://docs.aws.amazon.com/glossary/latest/reference/glos-chap.html#AmazonMachineImage). I prodotti basati su AMI includono un set di una o più versioni del software e metadati relativi al prodotto nel suo complesso. Quando crei il prodotto, ne configuri le proprietà in Marketplace AWS, incluso il nome del prodotto, la descrizione e il prezzo. Inoltre, stabilisci le categorie appropriate per il prodotto e aggiungi parole chiave in modo che il prodotto venga visualizzato nelle ricerche pertinenti. Dopo aver creato il prodotto Single-AMI, puoi inviare richieste di modifica per apportare modifiche al prodotto o alla versione. 

I tipi di modifiche che puoi richiedere per i prodotti basati su AMI includono:
+ Aggiorna le informazioni sul prodotto mostrate agli acquirenti.
+ Aggiorna le informazioni sulla versione mostrate agli acquirenti.
+ Aggiungi una nuova versione del prodotto.
+ Limita una versione in modo che i nuovi acquirenti non possano più accedervi.
+ Aggiorna la versione in Regioni AWS cui un prodotto è disponibile.
+ Aggiorna i prezzi e i tipi di istanza di un prodotto.
+ Rimuovi un prodotto da Marketplace AWS.

I seguenti argomenti mostrano come gestire e aggiornare un singolo prodotto AMI.

**Topics**
+ [Creazione di una richiesta di modifica per un prodotto basato su AMI in Marketplace AWS](single-ami-create-change-request.md)
+ [Aggiornamento della visibilità dei prodotti basati su AMI](ami-update-visibility.md)
+ [Aggiungere e limitare le istanze AMI per Marketplace AWS](single-ami-instance-types.md)
+ [Gestione delle versioni per i prodotti basati su AMI su Marketplace AWS](single-ami-versions.md)
+ [Aggiornamento delle informazioni sui prodotti basati su AMI su Marketplace AWS](single-ami-updating-product.md)
+ [Gestione della disponibilità dei prodotti basati sull'AMI per paese Regione AWS](single-ami-regions.md)
+ [Aggiornamento del contratto di licenza con l'utente finale (EULA) per il prodotto basato su AMI Marketplace AWS](single-ami-update-eula.md)
+ [Aggiornamento della politica di rimborso per il prodotto basato su AMI su Marketplace AWS](single-ami-update-refund-policy.md)
+ [Dare Marketplace AWS accesso al tuo AMI](single-ami-marketplace-ami-access.md)
+ [Rimuovere un prodotto da Marketplace AWS](removing-products-from-aws-marketplace.md)
+ [Risoluzione dei problemi più comuni relativi alle richieste di modifica su Marketplace AWS](request-errors-and-issues.md)

# Creazione di una richiesta di modifica per un prodotto basato su AMI in Marketplace AWS
<a name="single-ami-create-change-request"></a>

Per apportare modifiche a un prodotto o a una versione in Marketplace AWS, invii una **richiesta di modifica** tramite Portale di gestione Marketplace AWS. Le richieste di modifica vengono aggiunte a una coda e possono richiedere da minuti a giorni per essere risolte, a seconda del tipo di richiesta. È possibile visualizzare lo stato delle richieste in. Portale di gestione Marketplace AWS Questo argomento fornisce le procedure che è possibile utilizzare per creare una richiesta di modifica per un prodotto AMI singolo in Marketplace AWS, inclusa l'opzione per utilizzare l'esperienza self-service.

È possibile creare una richiesta di modifica per le seguenti situazioni:
+ Hai salvato i passaggi in corso, ma non hai completato l'intero processo, utilizzando l'esperienza self-service per creare un elenco di prodotti con AMI singola. Per completare i passaggi rimanenti, crei una richiesta di modifica.
+ Desideri apportare modifiche alle informazioni sul prodotto per il tuo prodotto che si trova in uno stato **Limitato** o **Pubblico**. Per aggiornare le informazioni, crei una richiesta di modifica. Per ulteriori informazioni sui tipi di modifiche che puoi richiedere per i prodotti basati su AMI, consulta. [Crea una richiesta di modifica](#single-ami-creating-change-request)

**Nota**  
Oltre a Portale di gestione Marketplace AWS, puoi anche creare richieste di modifica utilizzando l'API [Marketplace AWS Catalog](https://docs.aws.amazon.com/marketplace-catalog/latest/api-reference/seller-products.html).

**Topics**
+ [Crea una richiesta di modifica utilizzando il self-service](#ami-self-service-change-req)
+ [Crea una richiesta di modifica](#single-ami-creating-change-request)
+ [Ottieni lo stato di una richiesta di modifica](#single-ami-getting-change-request-status)
+ [Risorse aggiuntive](#ami-single-change-req-resources)

## Crea una richiesta di modifica utilizzando il self-service
<a name="ami-self-service-change-req"></a>

Per apportare modifiche alle versioni o alle informazioni sul prodotto, crei una *richiesta di modifica* in. Portale di gestione Marketplace AWS Le richieste di modifica sono gli elementi costitutivi di un'offerta self-service che puoi utilizzare per apportare modifiche al tuo prodotto. Ogni volta che selezioni **Salva e esci** dai passaggi o selezioni **Invia** per un aggiornamento, stai effettuando una richiesta di modifica. Puoi trovare le tue richieste nella scheda Portale di gestione Marketplace AWS [Richiesta](https://aws.amazon.com/marketplace/management/requests). 

**Per creare una richiesta di modifica utilizzando il self-service**

1. Apri l' Portale di gestione Marketplace AWS indirizzo [https://aws.amazon.com/marketplace/management/tour/](https://aws.amazon.com/marketplace/management/tour/) e accedi al tuo Account venditore, quindi vai alla pagina [https://aws.amazon.com/marketplace/management/products/server](https://aws.amazon.com/marketplace/management/products/server).

1. Nella scheda **Prodotti server**, seleziona il prodotto che desideri modificare.

1. Scegli un'opzione dal menu a discesa **Richiedi modifiche**.

1. Dopo aver effettuato una richiesta di modifica, è previsto un periodo di attesa prima che il sistema elabori la richiesta, indicato **in In fase di revisione**. **Una volta completata, la richiesta risulterà completata o non **riuscita**.**
   + **Dopo l'invio, la richiesta inizia l'elaborazione in base ai seguenti stati: **In corso di revisione**, **Preparazione delle modifiche e Applicazione delle modifiche**.**
   + L'**esito positivo** indica che la modifica richiesta è stata elaborata e le modifiche si riflettono nel sistema.
   + **Non riuscito** significa che qualcosa è andato storto con la richiesta, quindi le modifiche non sono state elaborate. Se lo stato è **Non riuscito**, puoi selezionare la richiesta per trovare i codici di errore che forniscono consigli su come correggere l'errore. A questo punto, puoi risolvere gli errori e creare una nuova richiesta di modifica. Per velocizzare il processo, puoi scegliere **Copia su nuova richiesta** per copiare i dettagli della richiesta non riuscita. Quindi, puoi apportare la modifica e inviare nuovamente la richiesta.

## Crea una richiesta di modifica
<a name="single-ami-creating-change-request"></a>

**Importante**  
Il 15 giugno 2023, Marketplace AWS interromperà la seguente procedura. Dopo il 15 giugno 2023, utilizzare la [Crea una richiesta di modifica utilizzando il self-service](#ami-self-service-change-req) procedura.

Per apportare modifiche alle versioni o alle informazioni sul prodotto, crei una *richiesta di modifica* in. Portale di gestione Marketplace AWS

**Per creare una richiesta di modifica**

1. Apri l' Portale di gestione Marketplace AWS indirizzo [https://aws.amazon.com/marketplace/management/tour/](https://aws.amazon.com/marketplace/management/tour/) e accedi al tuo Account venditore, quindi vai alla pagina [https://aws.amazon.com/marketplace/management/products/server](https://aws.amazon.com/marketplace/management/products/server).

1. Nella scheda **Prodotti server**, seleziona il prodotto che desideri modificare.

1. Scegli un'opzione dall'elenco a discesa **Richiedi modifiche**.

   Per la maggior parte delle richieste di modifica, è sufficiente compilare il modulo nell'interfaccia utente e inviarlo. Tuttavia, per alcune modifiche, è necessario scaricare, completare e quindi caricare un Product Load Form (PLF). Si tratta di un foglio di calcolo che contiene un modulo da compilare con le informazioni richieste. Quando scegliete una di queste richieste di modifica, vi viene richiesto di scaricare il PLF corretto per la richiesta che state tentando di creare. Il PLF è precompilato con informazioni tratte dai dettagli del prodotto esistente. [Puoi caricare il PLF completato nella pagina di caricamento del Portale di gestione Marketplace AWS file.](https://aws.amazon.com/marketplace/management/product-load)
**Nota**  
Ti consigliamo vivamente di scaricare e utilizzare il PLF più recente. Il modulo viene aggiornato regolarmente con nuove informazioni, compresi i tipi di istanze e non Regioni AWS appena diventano disponibili. Puoi trovare il PLF più recente per un prodotto nella pagina **dei prodotti Server**, selezionando il prodotto e quindi scegliendo **Scarica il modulo di caricamento del prodotto**.

Per ulteriori informazioni sullo stato di una richiesta di modifica, consulta[Ottieni lo stato di una richiesta di modifica](#single-ami-getting-change-request-status). Per informazioni sui potenziali problemi relativi alle richieste di modifica, consulta[Risoluzione dei problemi più comuni relativi alle richieste di modifica su Marketplace AWS](request-errors-and-issues.md).

## Ottieni lo stato di una richiesta di modifica
<a name="single-ami-getting-change-request-status"></a>

**Importante**  
Il 15 giugno 2023, Marketplace AWS interromperà la seguente procedura. Questa procedura non è più necessaria per l'esperienza self-service.

Dopo aver inviato una richiesta di modifica, puoi visualizzare lo stato della richiesta dalla scheda **Richieste** della pagina dei [https://aws.amazon.com/marketplace/management/products/server](https://aws.amazon.com/marketplace/management/products/server) di. Lo stato potrebbe essere uno dei seguenti:
+ **In fase di revisione** significa che la tua richiesta è in fase di revisione. Alcune richieste richiedono una revisione manuale da parte del Marketplace AWS team, ma la maggior parte viene esaminata automaticamente nel sistema.
+ L'**esito positivo** indica che la richiesta è completa. Il prodotto o la versione sono stati aggiornati come richiesto.
+ **Azione richiesta** significa che devi aggiornare la richiesta per risolvere un problema o rispondere a una domanda sulla richiesta. Seleziona la richiesta per visualizzare i dettagli, inclusi eventuali problemi.
+ **Non riuscito** significa che qualcosa è andato storto con la richiesta e dovresti creare una nuova richiesta di modifica, con gli stessi dati.

## Risorse aggiuntive
<a name="ami-single-change-req-resources"></a>

Per maggiori dettagli sulle richieste di modifica per tipi specifici di aggiornamenti, consulta le seguenti risorse:
+ [Aggiornamento delle informazioni sui prodotti basati su AMI su Marketplace AWS](single-ami-updating-product.md)
+ [Aggiorna le informazioni sulla versione](single-ami-versions.md#single-ami-updating-version)
+ [Aggiungi una nuova versione](single-ami-versions.md#single-ami-adding-version)
+ [Limita una versione](single-ami-versions.md#single-ami-restricting-version)

# Aggiornamento della visibilità dei prodotti basati su AMI
<a name="ami-update-visibility"></a>

In qualità di Marketplace AWS venditore, puoi aggiornare la visibilità del prodotto per modificare gli acquirenti che possono visualizzare il tuo singolo prodotto AMI Marketplace AWS. Se lo stato di visibilità è impostato su **Pubblico**, il prodotto è visibile a tutti Marketplace AWS gli acquirenti. Se la visibilità del prodotto è impostata su **Limitata**, il prodotto è visibile solo agli utenti Account AWS IDs consentiti. Puoi anche gestire e aggiornare questa lista consentita, in modo Account AWS IDs che tu possa vedere il tuo prodotto. Le sezioni seguenti mostrano come aggiornare la visibilità del prodotto e la lista dei diritti consentiti per la visibilità **limitata**.

**Topics**
+ [Aggiorna la visibilità del prodotto](#ami-update-self-service-visibility)
+ [Aggiorna la lista consentita (anteprima degli account)](#single-ami-updating-allowlist)

## Aggiorna la visibilità del prodotto
<a name="ami-update-self-service-visibility"></a>

Per modificare gli acquirenti in cui possono visualizzare il tuo prodotto Marketplace AWS, puoi utilizzare **Aggiorna visibilità**. 

**Per aggiornare la visibilità**

1. Apri l' Portale di gestione Marketplace AWS indirizzo[https://aws.amazon.com/marketplace/management/tour/](https://aws.amazon.com/marketplace/management/tour/), quindi accedi al tuo Account venditore.

1. Vai alla pagina [https://aws.amazon.com/marketplace/management/products/server](https://aws.amazon.com/marketplace/management/products/server), nella scheda **Prodotto server corrente**, seleziona il prodotto che desideri modificare.

1. Dal menu a discesa **Richiedi modifiche**, scegli **Aggiorna visibilità**.
**Nota**  
Puoi richiedere che il prodotto venga spostato dallo stato **Limitato** allo stato **Pubblico** utilizzando questa richiesta di modifica. Tuttavia, la richiesta di modifica deve essere sottoposta a una procedura di approvazione del team Operations del Marketplace AWS venditore per essere spostata in **Pubblica**.

1. Scegli **Invia richiesta di modifica** per inviare la richiesta di revisione.

1. Verifica che la scheda **Richieste** mostri lo **stato della richiesta** come **In corso di revisione**. Quando la richiesta viene completata, lo stato diventa **Riuscito**.

## Aggiorna la lista consentita (anteprima degli account)
<a name="single-ami-updating-allowlist"></a>

Per modificare l'elenco degli Account AWS IDs utenti autorizzati a visualizzare il prodotto in uno stato **limitato**, utilizza **Aggiorna lista consentita**.

**Per aggiornare la lista consentita**

1. Apri l' Portale di gestione Marketplace AWS indirizzo[https://aws.amazon.com/marketplace/management/tour/](https://aws.amazon.com/marketplace/management/tour/), quindi accedi al tuo Account venditore.

1. Vai alla pagina [https://aws.amazon.com/marketplace/management/products/server](https://aws.amazon.com/marketplace/management/products/server) e, nella scheda **Prodotto server corrente**, seleziona il prodotto che desideri modificare.

1. Dal menu a discesa **Richiedi modifiche**, scegli **Aggiorna elenco consentito**. L'elenco corrente viene fornito con l'elenco degli account attualmente consentiti.

1. Aggiungi Account AWS IDs quelli preferiti per la visibilità e separali IDs con virgole.

1. Scegli **Invia richiesta di modifica** per inviare la richiesta per la revisione.

1. Verifica che la scheda **Richieste** mostri lo **stato della richiesta** come **In corso di revisione**. Quando la richiesta viene completata, lo stato diventa **Riuscito**.

# Aggiungere e limitare le istanze AMI per Marketplace AWS
<a name="single-ami-instance-types"></a>

In qualità di Marketplace AWS venditore, puoi gestire le istanze che gli acquirenti possono utilizzare per il tuo singolo prodotto Amazon Machine Imagine (AMI). Puoi aggiungere una nuova istanza per il tuo singolo prodotto AMI utilizzabile dagli acquirenti. Allo stesso modo, se desideri impedire ai nuovi acquirenti di utilizzare il tuo singolo prodotto AMI da un'istanza specifica, puoi limitare l'istanza. 

Per ulteriori informazioni sui tipi di istanze Amazon EC2, consulta la sezione Tipi di [istanze disponibili](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/instance-types.html#AvailableInstanceTypes) nella *Amazon EC2* User Guide.

Le seguenti sezioni spiegano come aggiungere e limitare le istanze.

**Topics**
+ [Aggiungere un'istanza](#single-ami-adding-instance-types)
+ [Limitazione di un'istanza](#single-ami-restricting-instance-types)

## Aggiungere un'istanza
<a name="single-ami-adding-instance-types"></a>

Puoi aggiungere una nuova istanza che gli acquirenti possono utilizzare come singola AMI.

**Per aggiungere un'istanza**

1. Apri l' Portale di gestione Marketplace AWS indirizzo[https://aws.amazon.com/marketplace/management/tour/](https://aws.amazon.com/marketplace/management/tour/), quindi accedi al tuo Account venditore.

1. Vai alla pagina [https://aws.amazon.com/marketplace/management/products/server](https://aws.amazon.com/marketplace/management/products/server) e, nella scheda **Prodotto server corrente**, seleziona il prodotto che desideri modificare.

1. Dal menu a discesa **Richiedi modifiche**, scegli **Aggiungi istanza**.

1. Seleziona un'architettura di istanza.

1. Seleziona i tipi di istanze che desideri aggiungere dall'elenco delle istanze disponibili.

1. Scegli **Invia richiesta** per inviare la richiesta per la revisione.

1. Verifica che la scheda **Richieste** mostri lo **stato della richiesta** come **In corso di revisione**. Quando la richiesta viene completata, lo stato diventa **Riuscito**.
**Nota**  
Se il tuo attuale modello di prezzo non è gratuito o utilizza un modello Bring Your Own License (BYOL), devi aggiungere anche i prezzi. 
 Se hai creato un'**istanza Add** con un prezzo per la nuova istanza o **Aggiorna i prezzi** per aumentare un prezzo, non puoi utilizzare il self-service per **aggiungere un'istanza** nei 90 giorni a partire dal giorno in cui hai apportato la modifica. Per apportare queste modifiche, contatta il [team Marketplace AWS Operativo del venditore](https://aws.amazon.com/marketplace/management/contact-us/).
Quando aggiungi il supporto per un nuovo tipo di istanza, i clienti già abbonati alle offerte private per il tuo prodotto non saranno in grado di avviare automaticamente l'istanza appena aggiunta. Devi creare un'altra offerta privata con l'istanza a cui desideri che i clienti accedano. Dopo aver accettato la nuova offerta, i clienti possono avviare l'istanza appena aggiunta. Anche i clienti che si abbonano al tuo prodotto in date future possono avviare l'istanza, purché l'istanza sia inclusa nell'offerta privata. Per ulteriori informazioni su come creare una nuova offerta privata, consulta [Accordi di modifica in Marketplace AWS](private-offers-upgrades-and-renewals.md) più avanti in questa guida.

**Nota**  
**Supporto per tipi di istanze FPGA**  
I prodotti con AFI IDs supportano solo i tipi di istanze F2. Puoi offrire la tua AMI su altri tipi di istanze, tuttavia, non AFIs verranno caricate su altri tipi di istanze. Quando gli acquirenti lanciano il prodotto su istanze non F2, l'AMI funzionerà senza le funzionalità di accelerazione FPGA fornite dall'AFI. IDs

## Limitazione di un'istanza
<a name="single-ami-restricting-instance-types"></a>

Per impedire ai nuovi acquirenti di utilizzare un'istanza di un prodotto AMI, puoi limitare l'istanza. Puoi aggiungere nuovamente l'istanza in un secondo momento, se necessario. Gli utenti esistenti della singola AMI sull'istanza con restrizioni possono continuare a utilizzare il prodotto della regione per la durata dei loro abbonamenti.

**Per limitare un'istanza**

1. Apri l' Portale di gestione Marketplace AWS indirizzo[https://aws.amazon.com/marketplace/management/tour/](https://aws.amazon.com/marketplace/management/tour/), quindi accedi al tuo Account venditore.

1. Vai alla pagina [https://aws.amazon.com/marketplace/management/products/server](https://aws.amazon.com/marketplace/management/products/server) e, nella scheda **Prodotto server corrente**, seleziona il prodotto che desideri modificare.

1. Dal menu a discesa **Richiedi modifiche**, scegli **Limita istanza**.

1. **Seleziona le istanze che desideri limitare e scegli Limita.**

1. Scegli **Invia richiesta di modifica** per inviare la richiesta per la revisione.

1. Verifica che la scheda **Richieste** mostri lo **stato della richiesta** come **In corso di revisione**. Quando la richiesta viene completata, lo stato diventa **Riuscito**.
**Nota**  
Se la casella di controllo è ombreggiata, significa che l'istanza è associata a una o più versioni come tipo di istanza consigliato. Per limitare tali istanze, utilizzate **Update versions** per scegliere un diverso tipo di istanza consigliato. Dopo che le richieste di modifica sono state completate e l'istanza che desideri limitare non è più un tipo di istanza consigliato, puoi tornare a **Restrict instance** per limitare l'istanza scelta.

# Gestione delle versioni per i prodotti basati su AMI su Marketplace AWS
<a name="single-ami-versions"></a>

Quando crei un prodotto basato su Amazon Machine Image (AMI) su Marketplace AWS, includi una versione specifica del tuo software. Il ciclo di vita di un prodotto basato su AMI Marketplace AWS non termina dopo la pubblicazione della prima versione. È necessario mantenere il prodotto up-to-date con le nuove versioni del software. Le seguenti sezioni mostrano come gestire le versioni, tra cui l'aggiornamento delle informazioni sulla versione (come descrizioni e date), l'aggiunta di nuove versioni e la limitazione dell'accesso alle versioni precedenti.

**Topics**
+ [Aggiorna le informazioni sulla versione](#single-ami-updating-version)
+ [Aggiungi una nuova versione](#single-ami-adding-version)
+ [Limita una versione](#single-ami-restricting-version)

## Aggiorna le informazioni sulla versione
<a name="single-ami-updating-version"></a>

Dopo aver creato una versione, può essere utile fornire informazioni aggiornate agli acquirenti modificando le informazioni associate alla versione. Ad esempio, se prevedi di limitare la versione 1.0 dopo il rilascio della versione 1.1, puoi aggiornare la descrizione della versione 1.0 per indirizzare gli acquirenti alla versione 1.1, indicando la data in cui la versione sarà soggetta a restrizioni. Aggiorna le informazioni sulla versione da Portale di gestione Marketplace AWS.

**Per aggiornare le informazioni sulla versione**

1. Apri l' Portale di gestione Marketplace AWS indirizzo[https://aws.amazon.com/marketplace/management/tour/](https://aws.amazon.com/marketplace/management/tour/), quindi accedi al tuo Account venditore.

1. Vai alla pagina [https://aws.amazon.com/marketplace/management/products/server](https://aws.amazon.com/marketplace/management/products/server), nella scheda **Prodotti server**, quindi seleziona il prodotto che desideri modificare.

1. Dal menu a discesa **Richiedi modifiche**, scegli **Aggiorna le informazioni sulla versione**.

1. Nella pagina **Aggiorna versione**, seleziona la versione che desideri aggiornare.

1. Aggiorna le seguenti informazioni che devi modificare:
   + **Note di rilascio**
   + **Istruzioni per l'uso**
   + **Amazon Machine Image (AMI) a 64 bit (x86)**: dettagli sull'utilizzo e sul gruppo di sicurezza

1. Selezionare **Invia**.

1. Verifica che la richiesta appaia nella scheda **Richieste** con lo stato **In corso di revisione**.

**Nota**  
Non puoi utilizzare questa procedura per aggiornare il titolo della versione o l'AMI associata alla versione. [Create invece una nuova versione](#single-ami-adding-version) e [limitate la versione precedente](#single-ami-restricting-version).

Puoi controllare lo stato della tua richiesta in qualsiasi momento dalla scheda **Richieste** della pagina [Prodotti server](https://aws.amazon.com/marketplace/management/products/server). Per ulteriori informazioni, consulta [Ottieni lo stato di una richiesta di modifica](single-ami-create-change-request.md#single-ami-getting-change-request-status).

## Aggiungi una nuova versione
<a name="single-ami-adding-version"></a>

Puoi aggiungere una nuova versione del prodotto quando apporti modifiche al prodotto, all'immagine di base o in qualsiasi altro momento in cui devi modificare l'AMI del prodotto. Aggiungi una nuova versione del prodotto da Portale di gestione Marketplace AWS. 

**Nota**  
Per informazioni sulla creazione di un'AMI per Marketplace AWS, vedere[Procedure consigliate per AMIs la costruzione da utilizzare con Marketplace AWS](best-practices-for-building-your-amis.md).

**Per aggiungere una nuova versione**

1. Apri l' Portale di gestione Marketplace AWS indirizzo[https://aws.amazon.com/marketplace/management/tour/](https://aws.amazon.com/marketplace/management/tour/), quindi accedi al tuo Account venditore.

1. Vai alla pagina [https://aws.amazon.com/marketplace/management/products/server](https://aws.amazon.com/marketplace/management/products/server), nella scheda **Prodotto server corrente**, quindi seleziona il prodotto che desideri modificare. 

1. Dal menu a discesa **Richiedi modifiche**, scegli **Aggiungi nuova versione**. Viene visualizzato il modulo **Aggiungi una nuova versione**, compilato con le informazioni della versione più recente.
**Nota**  
Puoi anche scegliere **Prova «Aggiungi versione» per scansionare** l'AMI e i CloudFormation modelli senza aggiungere una nuova versione. Per ulteriori informazioni, consulta [Scansione dell'AMI per i requisiti di pubblicazione](https://docs.aws.amazon.com/marketplace/latest/userguide/best-practices-for-building-your-amis.html#self-service-scanning).

1. Nella sezione **Informazioni sulla versione**, fornisci le seguenti informazioni:
   + **Titolo della versione**: immettete una stringa valida (ad esempio *1.1* o*Version 2.0*). Deve essere unico per tutto il prodotto.
   + **Note sulla versione**: inserisci il testo per descrivere i dettagli di questa versione.

1. Nella sezione **Opzioni di consegna**, seleziona in che modo l'acquirente può implementare la soluzione, AMI (standalone) CloudFormation, AMI con o entrambe. Puoi scegliere fino a tre AMI con opzioni CloudFormation di consegna.
**Nota**  
Non è possibile aggiungere nuove opzioni di consegna a una versione esistente. Tutte le opzioni di consegna per una singola versione devono essere inviate nella stessa richiesta.

1. Nella sezione **Amazon Machine Image (AMI)**, fornisci le seguenti informazioni:
   + **Amazon Machine Image ID**: inserisci l'ID AMI per l'AMI che desideri utilizzare per questa versione. Puoi trovare l'ID AMI dall'[elenco AMIs della console](https://console.aws.amazon.com/ec2/v2/home?region=us-east-1#Images:sort=name). L'AMI deve esistere nella regione Stati Uniti orientali (Virginia settentrionale) e nel tuo Account Marketplace AWS venditore. L'istantanea associata a questa AMI non può essere crittografata.
   + **ARN del ruolo di accesso IAM**: inserisci Amazon Resource Name (ARN) per un ruolo AWS Identity and Access Management (IAM) che consente di accedere Marketplace AWS alla tua AMI. Per istruzioni su come creare il ruolo IAM, consulta. [Dare Marketplace AWS accesso al tuo AMI](single-ami-marketplace-ami-access.md) Utilizza il formato standard per un ARN IAM, ad esempio:. *arn:aws:iam::123456789012:role/RoleName* L'ARN deve essere presente nel tuo account Marketplace AWS venditore.
   + **Sistema operativo (OS)**: inserisci il sistema operativo di base per la tua AMI.
   + **Versione del sistema operativo**: inserisci la versione del sistema operativo utilizzata dall'AMI.
   + **Nome utente del sistema operativo**: per Linux based AMIs, inserisci il nome di un utente che può essere utilizzato per accedere all'istanza. Ti consigliamo di usare *ec2-user*.
   + **Porta di scansione**: inserisci il numero di porta che può essere utilizzato per accedere al sistema operativo: la porta SSH per un Linux AMI o la porta RDP per un AMIWindows.
   + **Amazon FPGA Image (AFI) IDs ** (opzionale): inserisci l'AFI IDs da associare alla tua AMI. AFIs supporta solo i tipi di istanze F2. Puoi offrire la tua AMI su altri tipi di istanze, tuttavia in questi casi non AFIs verranno caricate. Puoi aggiungere fino a 15 AFI IDs utilizzando il pulsante **Aggiungi ID AFI.** Questa opzione non è disponibile quando si utilizzano CloudFormation modelli. [Tutte le AFI IDs fornite devono provenire dalla regione Stati Uniti orientali (Virginia settentrionale), risiedere all'interno del tuo account venditore AWS Marketplace e il ruolo di accesso IAM fornito deve avere le autorizzazioni per condividere questa AFI con AWS Marketplace. Per ulteriori dettagli sulle autorizzazioni richieste, consulta Concedere ad AWS Marketplace l'accesso alle tue immagini FPGA.](https://docs.aws.amazon.com/marketplace/latest/userguide/single-ami-marketplace-ami-access.html#single-ami-marketplace-afi-access)

1. Fornisci le seguenti configurazioni per la sezione delle **opzioni di consegna AMI**, se applicabile:
   + **Tipo di istanza consigliato**: scegli il tipo di istanza che gli acquirenti ricevono di default.
   + **Istruzioni per l'uso**: inserisci le istruzioni per l'uso dell'AMI o un link a ulteriori informazioni sull'utilizzo dell'AMI. Ad esempio: *To get started with the product, navigate to https://example.com/usage.htm.*
   + **URL dell'endpoint**: fornisci informazioni su come l'acquirente può accedere al software dopo aver creato un'istanza. Inserisci il **protocollo** (*https* o *http*), l'**URL relativo** (ad esempio*/index.html*) e la **porta** (ad esempio*443*) che gli acquirenti possono utilizzare per accedere al tuo prodotto. (Il nome host dipende dall'istanza EC2, quindi devi solo fornire il percorso relativo).
   + **Raccomandazioni sui gruppi di sicurezza**: inserisci le informazioni per uno o più consigli, tra cui il protocollo (*TCP o *UDP**), l'intervallo di porte da consentire e l'elenco di IPv4 CIDR IPs (nel formato *xxx.xxx.xxx.xxx/nn*, ad esempio). *192.0.2.0/24*

1. Fornisci le seguenti impostazioni di configurazione per l'**AMI con opzione CloudFormation di consegna**, se applicabile:
   + **Titolo dell'opzione di consegna**: si tratta di un nome univoco per identificare l'opzione di consegna CloudFormation del modello AMI singolo.
   + **Breve descrizione**: una breve descrizione del CloudFormation modello.
   + **Descrizione estesa**: una descrizione dettagliata del CloudFormation modello.
   + **Tipo di istanza consigliato**: il tipo di istanza che gli acquirenti ricevono per impostazione predefinita.
   + **Istruzioni per l'uso**: istruzioni per l'uso della soluzione o un collegamento a ulteriori informazioni sull'utilizzo della soluzione.
   + **CloudFormation link al modello**: l'URL della posizione del CloudFormation modello in Amazon S3. Per pile o modelli annidati, fornisci il punto di ingresso o il modello principale. Il bucket Amazon S3 in cui risiede il file deve essere accessibile al pubblico. Per ulteriori informazioni, consulta [Aggiungere CloudFormation modelli al prodotto](https://docs.aws.amazon.com//marketplace/latest/userguide/cloudformation.html).
   + **Nome del parametro AMI**: aggiungi il nome del parametro nel CloudFormation modello a cui fanno riferimento le risorse dell'istanza EC2 nel modello per il valore della loro `ImageId` proprietà. Marketplace AWS sostituisce il parametro specificato con un parametro [AWS Systems Manager Parameter Store](https://docs.aws.amazon.com//systems-manager/latest/userguide/systems-manager-parameter-store.html). Quando gli acquirenti implementano il tuo modello, quel parametro viene risolto nell'ID AWS AMI specifico della regione del prodotto pubblicato. Per ulteriori informazioni, consulta [Requisiti per i dettagli sulle AMI](https://docs.aws.amazon.com//marketplace/latest/userguide/cloudformation.html#ami-requirements-sse).
   + **Link al diagramma di architettura**: l'URL alla posizione del diagramma architettonico in Amazon S3. La dimensione massima del file di immagine deve essere di 1560x878 o 1560x3120 pixel con un rapporto 16:9 o 1:2. Il bucket Amazon S3 che contiene il file di immagine deve essere accessibile al pubblico. [Per i requisiti del diagramma, consulta Diagramma architettonico.](https://docs.aws.amazon.com//marketplace/latest/userguide/cloudformation.html#topology-diagram)

1. Seleziona **Invia** per inviare la richiesta di aggiunta della nuova versione.
**Nota**  
L'aggiunta di una nuova versione comporta una scansione dell'AMI. Per ulteriori informazioni, consulta [Scansione dell'AMI per i requisiti di pubblicazione](https://docs.aws.amazon.com/marketplace/latest/userguide/best-practices-for-building-your-amis.html#self-service-scanning).
**Nota**  
**Supporto AFI ID nelle nuove versioni**  
Quando si aggiungono nuove versioni AMI, AFI IDs può essere configurato se si seleziona il metodo di consegna AMI (autonomo). Le stesse regole di convalida che si applicano durante la creazione del prodotto si applicano anche all'aggiunta di nuove versioni, tra cui restrizioni sui caratteri, requisiti di unicità, vincoli regionali e verifica della proprietà dell'account. Una volta creata una versione con AFI IDs, tali AFI IDs diventano immutabili e non possono essere modificate in seguito. Se è necessario modificare AFI IDs, è necessario creare una nuova versione con la configurazione aggiornata. Le nuove versioni con AFI IDs possono coesistere con le versioni esistenti che dispongono anche di AFI IDs, consentendoti di mantenere più configurazioni FPGA tra diverse versioni del prodotto. Durante la preparazione della versione, Marketplace AWS crea cloni AFI regionali per garantire che il prodotto sia disponibile in tutte le AWS regioni supportate, semplificando il processo di distribuzione per gli acquirenti. Questo processo è gestito dal team Seller Operations di AWS Marketplace e può richiedere più tempo rispetto ad altre richieste AMI Add Version. Durante questo periodo, la richiesta sarà «In fase di revisione». 

1. Verifica che la richiesta appaia nella scheda **Richieste** con lo stato **In corso di revisione**. Se ci sono errori da correggere, la pagina visualizza gli errori in una tabella nella parte superiore della pagina e i campi specifici che devono essere aggiornati vengono visualizzati in rosso.

Puoi controllare lo stato della tua richiesta in qualsiasi momento dalla scheda **Richieste** della pagina dei [https://aws.amazon.com/marketplace/management/products/server](https://aws.amazon.com/marketplace/management/products/server). La nuova versione verrà esaminata e, in caso di successo, pubblicata come nuova versione pubblica del prodotto. In caso di problemi, lo stato potrebbe essere **Azione richiesta**. Seleziona la richiesta per visualizzare i dettagli, inclusi eventuali problemi.

Se la richiesta ha esito positivo, gli utenti esistenti ricevono il seguente messaggio di posta elettronica. Il messaggio li avvisa della disponibilità della nuova versione, rimanda alle note di rilascio della versione e suggerisce loro di effettuare l'aggiornamento alla versione più recente. In qualità di utente Account AWS root, riceverai anche una copia del messaggio e-mail nell'account di posta elettronica associato al tuo Account AWS.

```
Greetings from AWS Marketplace,

Thank you for subscribing to <product-title>

We are writing to inform you that <seller-name> has added a new version to <product-title> on Marketplace AWS. 
As an existing customer, your subscription to the product, any running instances and access to previous versions 
are unaffected. However, <seller-name> does recommend you to update to the latest version, <product-title>/<version-title> 
by visiting <product-detail-page-of-new-listing>.

For additional questions or upgrade information, please contact <seller-name> directly. Click here <link of seller page on MP> 
to visit the seller’s profile page on Marketplace AWS.

Release notes for <product-title>/<version-title>:

<release-notes>

Thank you,
The Marketplace AWS Team
https://aws.amazon.com/marketplace
AWS, Inc. is a subsidiary of Amazon.com, Inc. Amazon.com is a registered trademark of Amazon.com, Inc. 
This message was produced and distributed by AWS Inc., 410 Terry Ave. North, Seattle, WA 98109-5210
```

## Limita una versione
<a name="single-ami-restricting-version"></a>

Se desideri impedire agli acquirenti di accedere a una versione specifica del tuo prodotto pubblico, puoi limitare tale versione.

**Nota**  
Tutti gli abbonati possono utilizzare la versione corrente indipendentemente dallo stato della restrizione. Marketplace AWS le linee guida richiedono che tu continui a offrire assistenza agli acquirenti esistenti per 90 giorni dopo aver limitato la versione. L'AMI verrà contrassegnata come obsoleta dopo che la versione sarà limitata. Per ulteriori informazioni, consulta [Deprecare un'AMI](https://docs.aws.amazon.com/AWSEC2/latest/WindowsGuide/ami-deprecate.html) nella *Amazon Elastic Compute Cloud User Guide* for Instances. Windows 

**Per limitare una versione**

1. Apri l' Portale di gestione Marketplace AWS indirizzo[https://aws.amazon.com/marketplace/management/tour/](https://aws.amazon.com/marketplace/management/tour/), quindi accedi al tuo Account venditore.

1. Vai alla pagina [https://aws.amazon.com/marketplace/management/products/server](https://aws.amazon.com/marketplace/management/products/server), nella scheda **Prodotto server corrente**, quindi seleziona il prodotto che desideri modificare.

1. Dal menu a discesa **Richiedi modifiche**, scegli **Limita la versione**.

1. Nella pagina **Limita versione**, seleziona la versione (o le versioni) che desideri limitare.

1. Seleziona **Invia** per inviare la richiesta di revisione.

1. Verifica che la scheda **Richieste** mostri lo **stato della richiesta** come **In corso di revisione**. Quando la richiesta viene completata, lo stato è **Riuscito**.

**Nota**  
Non puoi limitare tutte le versioni di un prodotto. Se tenti di limitare l'ultima versione pubblica rimasta di un prodotto, riceverai un errore. Per rimuovere completamente un prodotto, consulta[Rimuovere un prodotto da Marketplace AWS](removing-products-from-aws-marketplace.md).

Puoi controllare lo stato della tua richiesta in qualsiasi momento dalla scheda **Richieste** della pagina dei [https://aws.amazon.com/marketplace/management/products/server](https://aws.amazon.com/marketplace/management/products/server). Per ulteriori informazioni, consulta [Ottieni lo stato di una richiesta di modifica](single-ami-create-change-request.md#single-ami-getting-change-request-status).

**Nota**  
Il completamento della limitazione di una versione può richiedere fino a 3 giorni.

Se la richiesta ha esito positivo, gli utenti esistenti ricevono il seguente messaggio di posta elettronica che li avvisa della limitazione della versione e suggerisce loro di utilizzare la versione più recente disponibile. In qualità di utente Account AWS root, riceverai anche una copia del messaggio e-mail nell'account di posta elettronica associato al tuo. Account AWS

```
Greetings from AWS Marketplace,

Thank you for subscribing to <product-title>.

We are writing to inform you that, as of <Version-Restriction-Date>, <Seller Name> will no longer offer version(s) "<version-title>" to new subscribers. Your use and subscription is unaffected for this version(s), however it is recommended that users upgrade to the latest version on Marketplace AWS.

For additional questions or upgrade information, please contact <seller-name> directly. Click here<link of seller page on MP> to visit the seller’s profile page on Marketplace AWS.

Thank you,
The Marketplace AWS Team
https://aws.amazon.com/marketplace
AWS, Inc. is a subsidiary of Amazon.com, Inc. Amazon.com is a registered trademark of Amazon.com, Inc. This message was produced and distributed by AWS Inc., 410 Terry Ave. North, Seattle, WA 98109-5210
```

# Aggiornamento delle informazioni sui prodotti basati su AMI su Marketplace AWS
<a name="single-ami-updating-product"></a>

Dopo aver creato un singolo prodotto Amazon Machine Image (AMI), puoi modificare alcune delle informazioni ad esso associate in Marketplace AWS. Ad esempio, se una nuova versione modifica la descrizione o i punti salienti del prodotto, puoi modificare le informazioni sul prodotto con i nuovi dati. Puoi anche aggiornare altre informazioni sul prodotto, tra cui il titolo del prodotto, la descrizione dello SKU, le categorie, le parole chiave e altro. Per ulteriori informazioni, consulta la procedura seguente.

**Per aggiornare le informazioni sul prodotto**

1. Apri l' Portale di gestione Marketplace AWS indirizzo[https://aws.amazon.com/marketplace/management/tour/](https://aws.amazon.com/marketplace/management/tour/), quindi accedi al tuo Account venditore.

1. Vai alla pagina [https://aws.amazon.com/marketplace/management/products/server](https://aws.amazon.com/marketplace/management/products/server) e, nella scheda **Prodotti server**, seleziona il prodotto che desideri modificare.

1. Dal menu a discesa **Richiedi modifiche**, scegli **Aggiorna le informazioni sul prodotto**.

1. Aggiorna uno dei seguenti campi che devi modificare:
   + **Titolo del prodotto**
   + **SKU**
   + **Breve descrizione**
   + **Descrizione lunga**
   + **URL dell'immagine del logo del prodotto**
   + **Caratteristiche salienti**
   + **Categorie di prodotti**
   + **Parole chiave**
   + **URL del video del prodotto**
   + **Risorse**
   + **Informazioni di supporto**
**Nota**  
Per informazioni dettagliate sul formato del logo, vedere[Requisiti relativi al logo dell'azienda e del prodotto](product-submission.md#seller-and-product-logos).

1. Selezionare **Invia**.

1. Verifica che la richiesta venga visualizzata nella scheda **Richieste** con lo stato **In corso di revisione**. Potrebbe essere necessario aggiornare la pagina per visualizzare la richiesta nell'elenco.

Puoi controllare lo stato della tua richiesta in qualsiasi momento dalla scheda **Richieste** della pagina [Prodotti server](https://aws.amazon.com/marketplace/management/products/server). Per ulteriori informazioni, consulta [Ottieni lo stato di una richiesta di modifica](single-ami-create-change-request.md#single-ami-getting-change-request-status).

# Gestione della disponibilità dei prodotti basati sull'AMI per paese Regione AWS
<a name="single-ami-regions"></a>

Quando crei un prodotto in Marketplace AWS, scegli le AWS regioni in cui è disponibile. Puoi anche scegliere i paesi da cui gli acquirenti possono acquistare il prodotto. Queste due proprietà sono simili, ma non sono uguali. Ad esempio, un acquirente potrebbe risiedere negli Stati Uniti d'America e acquistare da essi, ma potrebbe avere intenzione di installare il prodotto nella regione Europa (Francoforte). Affinché questo acquirente possa acquistare il tuo prodotto, devi includere sia gli Stati Uniti d'America nell'elenco dei paesi che la regione Europa (Francoforte) nell'elenco delle regioni. Puoi utilizzare le seguenti sezioni per aggiornare la disponibilità dei prodotti per regione e paese.

**Topics**
+ [Aggiungi un Regione AWS](#single-ami-adding-regions)
+ [Limita un Regione AWS](#single-ami-restricting-regions)
+ [Supporto per gli aggiornamenti futuri Regioni AWS](#single-ami-updating-future-region-support)
+ [Aggiorna la disponibilità per paese](#single-ami-update-availability-by-country)

## Aggiungi un Regione AWS
<a name="single-ami-adding-regions"></a>

Puoi aggiungere una regione in cui gli acquirenti possono utilizzare il tuo prodotto.

**Per aggiungere una regione**

1. Apri l' Portale di gestione Marketplace AWS indirizzo[https://aws.amazon.com/marketplace/management/tour/](https://aws.amazon.com/marketplace/management/tour/), quindi accedi al tuo Account venditore.

1. Vai alla pagina [https://aws.amazon.com/marketplace/management/products/server](https://aws.amazon.com/marketplace/management/products/server) e, nella scheda **Prodotto server corrente**, seleziona il prodotto che desideri modificare.

1. Dal menu a discesa **Richiedi modifiche**, scegli **Aggiungi regione.**

1. Seleziona la regione che desideri aggiungere dall'elenco delle regioni disponibili. 

1. Scegli **Invia richiesta** per inviare la richiesta di revisione.

1. Verifica che la scheda **Richieste** mostri lo **stato della richiesta** come **In corso di revisione**. Quando la richiesta viene completata, lo stato diventa **Riuscito**.

**Nota**  
Quando aggiungi il supporto per una nuova regione Regione AWS, i clienti già abbonati alle offerte private per il tuo prodotto non potranno accedere automaticamente alla nuova regione aggiunta. Devi creare un'altra offerta privata con la regione a cui desideri che i clienti abbiano accesso. Dopo aver accettato la nuova offerta, i clienti possono accedere alla regione appena aggiunta. I clienti che si abbonano al tuo prodotto in date future possono accedere anche alla Regione, purché la Regione sia inclusa nell'offerta privata. Per ulteriori informazioni su come creare una nuova offerta privata, consulta [Aggiornamenti, rinnovi e modifiche dell'offerta privata](https://docs.aws.amazon.com/marketplace/latest/userguide/private-offers-upgrades-and-renewals.html).

**Nota**  
**Requisiti regionali FPGA**  
Quando si aggiungono regioni ai prodotti FPGA, i cloni AFI regionali vengono creati automaticamente Marketplace AWS per garantire la disponibilità del prodotto in tutte le regioni supportate. AWS Questo processo garantisce che gli acquirenti possano implementare il prodotto con accelerazione FPGA nella loro regione preferita senza richiedere la replica AFI manuale. Il processo di clonazione automatico mantiene la coerenza in tutte le regioni in cui il prodotto è disponibile.

## Limita un Regione AWS
<a name="single-ami-restricting-regions"></a>

Per impedire ai nuovi acquirenti di utilizzare il tuo prodotto in una regione specifica Regione AWS, puoi limitare la regione. Puoi aggiungere nuovamente la regione in un secondo momento. Gli abbonati esistenti al prodotto nella regione possono continuare a utilizzare il prodotto della regione purché siano abbonati.

**Per limitare una regione**

1. Apri l' Portale di gestione Marketplace AWS indirizzo[https://aws.amazon.com/marketplace/management/tour/](https://aws.amazon.com/marketplace/management/tour/), quindi accedi al tuo Account venditore.

1. Vai alla pagina [https://aws.amazon.com/marketplace/management/products/server](https://aws.amazon.com/marketplace/management/products/server) e, nella scheda **Prodotto server corrente**, seleziona il prodotto che desideri modificare.

1. Dal menu a discesa **Richiedi modifiche**, scegli **Limita regione.**

1. Seleziona il menu a discesa per visualizzare l'elenco delle regioni in cui il prodotto è attualmente disponibile. 

1. Seleziona le regioni che desideri limitare.

1. Le regioni che hai selezionato vengono visualizzate come token. Controlla l'elenco delle regioni a cui stai applicando restrizioni e inserisci X per le regioni che non desideri limitare.

1. Scegli **Invia richiesta di modifica** per inviare la richiesta di revisione.

1. Verifica che la scheda **Richieste** mostri lo **stato della richiesta** come **In corso di revisione**. Quando la richiesta viene completata, lo stato diventa **Riuscito**. 

Se la richiesta ha esito positivo, gli utenti esistenti ricevono il seguente messaggio di posta elettronica che li informa della regione da limitare. Possono continuare a utilizzare il tuo prodotto finché rimangono abbonati, ma non possono abbonarsi nuovamente se annullano l'abbonamento.

```
Greetings from AWS Marketplace,

This message is a notification detailing a recent change for <ProductName>.
{{{sellerName}}} has opted to restrict the <ProductType> product in <Restricted Region(s)> beginning <DateOfChange>.

This impacts you in the following ways:

1. As long as you're subscribed to the product, you can continue using the software product in the restricted Region.
2. You can't begin new instances of the software product in the restricted Region.
3. You can continue using the software product in all available AWS Regions.

Regards,
The Marketplace AWS Team
AWS, Inc. is a subsidiary of Amazon.com, Inc. Amazon.com (http://amazon.com/) is a registered
trademark of Amazon.com, Inc. This message was produced and distributed by Amazon Web
Services Inc., 410 Terry Ave. North, Seattle, WA 98109-5210.
```

## Supporto per gli aggiornamenti futuri Regioni AWS
<a name="single-ami-updating-future-region-support"></a>

Se desideri che il tuo prodotto venga aggiornato alla versione appena lanciata Regioni AWS, puoi utilizzare il supporto Update **future Region**.

**Per aggiornare il supporto per le future regioni**

1. Apri l' Portale di gestione Marketplace AWS indirizzo[https://aws.amazon.com/marketplace/management/tour/](https://aws.amazon.com/marketplace/management/tour/), quindi accedi al tuo Account venditore.

1. Vai alla pagina [https://aws.amazon.com/marketplace/management/products/server](https://aws.amazon.com/marketplace/management/products/server) e, nella scheda **Prodotto server corrente**, seleziona il prodotto che desideri modificare.

1. Dal menu a discesa **Richiedi modifiche**, scegli **Aggiorna il supporto per le regioni future**.

1. Puoi scegliere di attivare il supporto per le future regioni Marketplace AWS per consentire l'onboarding del tuo prodotto per il nuovo lancio per tuo Regioni AWS conto.

1. Dopo aver attivato la funzione, puoi scegliere tra tutte le regioni future o limitarti solo alle regioni degli Stati Uniti.

1. Scegli **Invia richiesta di modifica** per inviare la richiesta di revisione.

1. Verifica che la scheda **Richieste** mostri lo **stato della richiesta** come **In corso di revisione**. Quando la richiesta viene completata, lo stato diventa **Riuscito**.

## Aggiorna la disponibilità per paese
<a name="single-ami-update-availability-by-country"></a>

Se desideri modificare i paesi in cui è possibile abbonarsi e offrire il prodotto, puoi utilizzare **Update availability**. 

**Per aggiornare la disponibilità in base al paese**

1. Apri l' Portale di gestione Marketplace AWS indirizzo[https://aws.amazon.com/marketplace/management/tour/](https://aws.amazon.com/marketplace/management/tour/), quindi accedi al tuo Account venditore.

1. Vai alla pagina [https://aws.amazon.com/marketplace/management/products/server](https://aws.amazon.com/marketplace/management/products/server), nella scheda **Prodotto server corrente**, quindi seleziona il prodotto che desideri modificare.

1. Dal menu a discesa **Richiedi modifiche**, scegli **Aggiorna disponibilità**.

1. Scegli una delle seguenti opzioni:

   1. **Tutti i paesi**: disponibile in tutti i paesi supportati.

   1. **Tutti i paesi con esclusioni**: disponibile in tutti i paesi supportati tranne in alcuni paesi.

   1. **Elenco personalizzato: elenco** specifico dei paesi in cui il prodotto è disponibile.

1. Scegli **Invia richiesta di modifica** per inviare la richiesta di revisione.

1. Verifica che la scheda **Richieste** mostri lo **stato della richiesta** come **In corso di revisione**. Quando la richiesta viene completata, lo stato diventa **Riuscito**.

# Aggiornamento del contratto di licenza con l'utente finale (EULA) per il prodotto basato su AMI Marketplace AWS
<a name="single-ami-update-eula"></a>

In qualità di Marketplace AWS venditore, puoi aggiornare il contratto di licenza con l'utente finale (EULA) che regolerà l'uso del tuo singolo prodotto Amazon Machine Image (AMI). Il tuo EULA si trova nella pagina di elenco dei prodotti relativa agli elenchi di software pubblici su. Marketplace AWS Puoi applicare il tuo EULA o utilizzare [lo Standard Contract for Marketplace AWS (SCMP](standardized-license-terms.md)). La procedura seguente mostra come aggiornare l'EULA per il prodotto con AMI singola.

Per ulteriori informazioni sull'EULA, vedere. [Utilizzo di contratti standardizzati in Marketplace AWS](standardized-license-terms.md)

**Per aggiornare un EULA**

1. Apri l' Portale di gestione Marketplace AWS indirizzo[https://aws.amazon.com/marketplace/management/tour/](https://aws.amazon.com/marketplace/management/tour/), quindi accedi al tuo Account venditore.

1. Scegli la scheda [https://aws.amazon.com/marketplace/management/products/server](https://aws.amazon.com/marketplace/management/products/server), nella scheda **Prodotto server corrente**, seleziona il prodotto che desideri modificare.

1. Dal menu a discesa **Richiedi modifiche**, scegli **Aggiorna il contratto di licenza per l'utente finale**.

1. Puoi selezionare il [contratto standard per Marketplace AWS (SCMP)](https://docs.aws.amazon.com/marketplace/latest/userguide/standardized-license-terms.html) o inviare il tuo EULA personalizzato. Per un EULA personalizzato, devi fornire l'URL del tuo contratto personalizzato da un bucket Amazon S3.
**Nota**  
L'accessibilità pubblica deve essere abilitata sul tuo bucket Amazon S3.

1. Scegli **Invia richiesta di modifica per inviare la richiesta** per la revisione.

1. Verifica che la scheda **Richieste** mostri lo **stato della richiesta** come **In corso di revisione**. Quando la richiesta viene completata, lo stato diventa **Riuscito**.

# Aggiornamento della politica di rimborso per il prodotto basato su AMI su Marketplace AWS
<a name="single-ami-update-refund-policy"></a>

In qualità di Marketplace AWS venditore, puoi impostare la politica di rimborso per il tuo singolo prodotto Amazon Machine Image (AMI). Se desideri modificare la politica di rimborso del tuo prodotto, puoi utilizzare **Aggiorna la politica di rimborso**. La procedura seguente mostra come aggiornare la politica di rimborso.

**Per aggiornare la politica di rimborso**

1. Apri l' Portale di gestione Marketplace AWS indirizzo[https://aws.amazon.com/marketplace/management/tour/](https://aws.amazon.com/marketplace/management/tour/), quindi accedi al tuo Account venditore.

1. Vai alla pagina [https://aws.amazon.com/marketplace/management/products/server](https://aws.amazon.com/marketplace/management/products/server), nella scheda **Prodotto server corrente**, quindi seleziona il prodotto che desideri modificare.

1. Dal menu a discesa **Richiedi modifiche**, scegli **Aggiorna politica di rimborso**.

1. I dettagli della politica di rimborso corrente sono forniti nella casella di testo che puoi modificare. L'invio della richiesta sovrascrive l'attuale politica di rimborso.

1. Scegli **Invia richiesta di modifica** per inviare la richiesta di revisione.

1. Verifica che la scheda **Richieste** mostri lo **stato della richiesta** come **In corso di revisione**. Quando la richiesta viene completata, lo stato diventa **Riuscito**.

# Dare Marketplace AWS accesso al tuo AMI
<a name="single-ami-marketplace-ami-access"></a>

Quando crei una richiesta che include l'aggiunta di una nuova Amazon Machine Image (AMI) Marketplace AWS, l'AMI deve essere copiato nel Marketplace AWS sistema e quindi analizzato per individuare eventuali problemi di sicurezza. È necessario concedere Marketplace AWS l'accesso all'AMI creando un ruolo AWS Identity and Access Management (IAM) con autorizzazioni per eseguire azioni sull'AMI e una politica di fiducia che Marketplace AWS consenta di assumere il ruolo. È sufficiente creare il ruolo IAM una sola volta. La procedura seguente mostra come creare un ruolo per l' Marketplace AWS acquisizione di risorse che dia Marketplace AWS accesso all'AMI.

**Per creare un ruolo per l' Marketplace AWS acquisizione di risorse AMI**

1. Accedi a Console di gestione AWS, apri la console IAM e vai alla pagina [Ruoli](https://console.aws.amazon.com/iam/home?region=us-east-1#/roles).

1. Seleziona **Create role** (Crea ruolo).

1. Nella pagina **Crea ruolo**, effettua le seguenti selezioni:
   + **Seleziona il tipo di entità affidabile**: scegli **AWS Servizio**.
   + **Scegli un caso d'uso**: scegli **Marketplace AWS**.
   + **Seleziona il tuo caso d'uso**: scegli **Marketplace — AMI Assets Ingestion**. 
   + Per passare alla pagina successiva, seleziona Avanti**: Autorizzazioni**.

1. Seleziona la **AWSMarketplaceAmiIngestion**politica. Aggiungi un limite di autorizzazioni, se necessario, quindi seleziona **Avanti: tag** per continuare.
**Nota**  
Puoi utilizzare i limiti delle autorizzazioni per limitare l'accesso che concedi Marketplace AWS con questo ruolo. Per ulteriori informazioni, consulta [Limiti delle autorizzazioni per le entità IAM nella Guida](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies_boundaries.html) per l'*AWS Identity and Access Management utente*.

1. Per continuare, seleziona **Avanti: revisione**.

1. Fornisci un nome per il ruolo e seleziona **Crea ruolo**.

1. Dovresti vedere «Il ruolo *rolename* è stato creato» nella parte superiore della pagina e il ruolo dovrebbe apparire nell'elenco dei ruoli.

In questa pagina, quando selezioni il ruolo che hai appena creato, puoi vederne l'ARN nel formato *arn:aws:iam: :123456789012:role/exampleRole*. Utilizza l'ARN per l'**ARN del ruolo di accesso IAM** quando crei richieste di modifica, ad esempio quando [aggiungi una nuova versione](single-ami-versions.md#single-ami-adding-version) al tuo prodotto.

## Dare Marketplace AWS accesso alle immagini FPGA
<a name="single-ami-marketplace-afi-access"></a>

Se l'AMI include immagini FPGA (AFIs), devi anche concedere autorizzazioni Marketplace AWS aggiuntive per accedere e gestire queste immagini FPGA. Oltre alla **AWSMarketplaceAmiIngestion**policy, è necessario creare una policy in linea che Marketplace AWS consenta di eseguire azioni sulle immagini FPGA.

**Per aggiungere le autorizzazioni relative alle immagini FPGA al ruolo di inserimento delle risorse Marketplace AWS AMI**

1. [Accedi a Console di gestione AWS, apri la console IAM e vai alla pagina Ruoli.](https://console.aws.amazon.com/iam/home?region=us-east-1#/roles)

1. Seleziona il ruolo che hai creato per l' Marketplace AWS inserimento di risorse AMI.

1. Nella pagina dei dettagli del ruolo, seleziona la scheda **Autorizzazioni**, quindi seleziona **Aggiungi** politica in linea.

1. Seleziona la scheda **JSON** e inserisci la seguente politica:

------
#### [ JSON ]

****  

   ```
   {
      "Version":"2012-10-17",		 	 	 
      "Statement":[
         {
            "Effect":"Allow",
            "Action":[
               "ec2:DescribeFpgaImages",
               "ec2:DescribeFpgaImageAttribute",
               "ec2:CopyFpgaImage",
               "ec2:ModifyFpgaImageAttribute"
            ],
            "Resource":"*"
         }
      ]
   }
   ```

------

1. Seleziona **Review policy (Esamina policy)**.

1. Fornisci un nome per la politica, ad esempio **AWSMarketplaceAfiIngestion**, quindi seleziona **Crea politica**.

Dopo aver aggiunto questa politica in linea, Marketplace AWS disporrete delle autorizzazioni necessarie per accedere e gestire le immagini FPGA durante il processo di acquisizione e scansione.

# Rimuovere un prodotto da Marketplace AWS
<a name="removing-products-from-aws-marketplace"></a>

Dopo aver pubblicato il prodotto, puoi rimuoverlo da Marketplace AWS. Questo fenomeno viene anche chiamato *tramonto*. Per rimuovere un prodotto, identificalo e invia una richiesta di rimozione, indicando il motivo della rimozione e un indirizzo email di contatto. Puoi anche fornire un identificativo del prodotto sostitutivo se stai sostituendo il prodotto attuale con uno nuovo.

Dopo aver richiesto la rimozione del prodotto, i nuovi clienti non possono abbonarsi al prodotto. Devi supportare tutti i clienti esistenti per un minimo di 90 giorni.

**Nota**  
Non puoi eliminare prodotti soggetti a restrizioni dal portale Marketplace AWS di gestione. Il portale li conserva come parte della cronologia delle pubblicazioni dell'account.

Elaboriamo le richieste di rimozione del prodotto da Marketplace AWS alle seguenti condizioni: 
+ Il prodotto viene rimosso dalla Marketplace AWS ricerca, dalla navigazione e da altri strumenti di individuazione. Qualsiasi pulsante o funzionalità di **iscrizione** è disabilitato e i messaggi sulla pagina indicano chiaramente che il prodotto non è più disponibile. La pagina dei dettagli del prodotto è ancora accessibile tramite l'URL e potrebbe essere indicizzata nei motori di ricerca pubblici. 
+ È necessario specificare un motivo per la rimozione (ad esempio, fine del supporto, fine degli aggiornamenti del prodotto o prodotto sostitutivo). Per i requisiti per continuare a fornire assistenza per i prodotti rimossi, consulta i [Termini e condizioni per Marketplace AWS i venditori.](https://aws.amazon.com/marketplace/management/terms) 
+ Marketplace AWS contatta gli attuali acquirenti tramite un messaggio e-mail per informarli della rimozione del prodotto, dei motivi della rimozione e per fornire le informazioni di contatto del venditore. 
+ Gli attuali acquirenti *mantengono* l'accesso al software fino all'annullamento dell'abbonamento. Non sono interessati in alcun modo dalla rimozione del prodotto. 

**Per rimuovere un prodotto creato utilizzando il Portale di gestione Marketplace AWS**

1. Apri l' Portale di gestione Marketplace AWS indirizzo[https://aws.amazon.com/marketplace/management/tour/](https://aws.amazon.com/marketplace/management/tour/), quindi accedi al tuo Account venditore.

1. Scegli la scheda **Prodotti**, quindi scegli **Server**. 

1. Nella pagina del prodotto, in **Prodotti server**, individua il prodotto che desideri rimuovere. Dall'elenco a discesa **Richiedi modifiche**, scegli **Aggiorna visibilità del prodotto**.

1. Nella pagina **Aggiorna la visibilità del prodotto**, seleziona **Limitato**. 

1. (Facoltativo) Fornisci un **ID prodotto sostitutivo**, se c'è un altro prodotto che sostituirà il prodotto che stai rimuovendo.

1. Verifica la correttezza delle informazioni, quindi scegli **Invia**. 

Dopo aver inviato la richiesta **di rimozione del prodotto, viene visualizzata una pagina informativa sulla prossima** pagina. The Marketplace AWS Seller Operations esamina ed elabora la tua richiesta. Controlla lo stato della tua richiesta visualizzando **le Richieste**. 

Dopo la rimozione del prodotto, il prodotto viene visualizzato nell'elenco **Prodotti correnti** di Portale di gestione Marketplace AWS. In **Current Products**, l'unica azione che puoi eseguire è scaricare il foglio di calcolo relativo al prodotto. Non puoi modificare o inviare un'altra richiesta Sunset. 

Se hai domande sulla rimozione dei prodotti, contatta il team [Operativo del Marketplace AWS venditore](https://aws.amazon.com/marketplace/management/contact-us/).

# Risoluzione dei problemi più comuni relativi alle richieste di modifica su Marketplace AWS
<a name="request-errors-and-issues"></a>

Quando apporti modifiche alle informazioni del prodotto su Marketplace AWS, potresti riscontrare degli errori. Questo argomento spiega alcuni errori comuni e fornisce suggerimenti su come correggerli.
+ **Scansione dell'AMI — Durante la** scansione dell'AMI potrebbero verificarsi diversi problemi:
  + Non hai concesso Marketplace AWS le autorizzazioni per scansionare il tuo AMI. Concedi Marketplace AWS le autorizzazioni per accedervi. Oppure hai concesso le autorizzazioni, ma il limite delle autorizzazioni è troppo restrittivo. Per ulteriori informazioni, consulta [Dare Marketplace AWS accesso al tuo AMI](single-ami-marketplace-ami-access.md).
  + Se la scansione rileva problemi di sicurezza o vulnerabilità ed esposizioni comuni (CVEs) nella tua AMI, assicurati di utilizzare le patch più recenti per il sistema operativo nell'immagine. Per ulteriori informazioni, consulta [Requisiti di prodotto basati su AMI per Marketplace AWS](product-and-ami-policies.md).

  Per linee guida generali sulla creazione di un'AMI, consulta[Procedure consigliate per AMIs la costruzione da utilizzare con Marketplace AWS](best-practices-for-building-your-amis.md).
+ **Portale di gestione Marketplace AWS campi** — Alcuni campi Portale di gestione Marketplace AWS richiedono informazioni molto specifiche:
  + Se non sei sicuro di ciò che il campo richiede, prova a controllare i dettagli nella console. La maggior parte dei campi presenta descrizioni testuali sopra il campo e requisiti di formattazione sotto il campo.
  + Se si tenta di inviare un modulo con uno o più campi non validi, viene visualizzato un elenco di problemi. Viene fornita un'azione consigliata per aiutarti a risolvere il problema.
  +  Se ti viene chiesto di fornire un ARN, in genere lo troverai altrove nella console. Ad esempio, l'ARN per il ruolo IAM che hai creato per Marketplace AWS consentire l'accesso alla tua AMI si trova nella [pagina Ruoli della console](https://console.aws.amazon.com/iam/home?region=us-east-1#/roles) IAM. ARNs hanno tutti un formato simile. Ad esempio, l'ARN di un ruolo IAM ha il formato *arn:aws:iam: :123456789012:role/exampleRole*. 
  + I tuoi loghi e i tuoi video devono essere forniti come URL direttamente al contenuto. Per ulteriori informazioni sui formati dei loghi, consulta[Requisiti relativi al logo dell'azienda e del prodotto](product-submission.md#seller-and-product-logos).

  Per ulteriori informazioni sull'invio di prodotti e richieste di modifica della versione, consulta[Invio del prodotto per la pubblicazione su Marketplace AWS](product-submission.md). 
+ **Problemi relativi al Product Load Form (PLF)**: PLFs contengono istruzioni incluse nel foglio di calcolo. Le istruzioni generali sono fornite nella tabella Istruzioni. Ogni campo contiene istruzioni su come compilarlo: seleziona il campo per visualizzare le istruzioni.
+ **Richiesta in corso**: alcune richieste non possono essere eseguite in parallelo. Puoi avere una sola richiesta di aggiornamento di informazioni specifiche in corso per un prodotto alla volta. Puoi vedere tutte le tue richieste ancora in fase di revisione nella scheda **Richieste** della pagina dei **prodotti Server** in Portale di gestione Marketplace AWS. Se hai una richiesta in sospeso che non intendevi, puoi annullarla e quindi inviare una nuova richiesta con la modifica che desideri apportare.
  + Non puoi aggiornare le informazioni sulla versione quando è in corso un aggiornamento (per aggiungere o limitare) una versione.
  + Se c'è una richiesta in sospeso da Marketplace AWS parte del team Operativo del venditore, non puoi inviare nuove modifiche.
+ **Errore inspiegabile**: se l'invio fallisce senza alcuna spiegazione, riprova. A volte, il carico del server causa un errore di invio.

Se continui a riscontrare problemi con una richiesta di modifica, contatta il team [Marketplace AWS Operativo del venditore](https://aws.amazon.com/marketplace/management/contact-us/).

# Procedure consigliate per AMIs la costruzione da utilizzare con Marketplace AWS
<a name="best-practices-for-building-your-amis"></a>

Questo argomento fornisce best practice e riferimenti per aiutarti a creare Amazon Machine Images (AMIs) da utilizzare con Marketplace AWS. AMIs creato e inviato a Marketplace AWS deve rispettare tutte le politiche di Marketplace AWS prodotto. Per ulteriori informazioni, consultare le sezioni indicate di seguito.

**Topics**
+ [Garantire i diritti di rivendita](#rights)
+ [Creazione di un AMI](#building-an-ami)
+ [Preparazione e protezione dell'AMI per Marketplace AWS](#securing-an-ami)
+ [Scansione dell'AMI per i requisiti di pubblicazione](#self-service-scanning)
+ [Verifica che il software sia in esecuzione sull'AMI Marketplace AWS](#verifying-ami-runtime)

## Garantire i diritti di rivendita
<a name="rights"></a>

Per le distribuzioni Linux non libere, sei responsabile di garantirne i diritti di rivendita, ad eccezione di AWS Amazon Linux, RHEL e SUSE fornite. Non è necessario garantire i diritti di rivendita per Windows. AMIs

## Creazione di un AMI
<a name="building-an-ami"></a>

Utilizza le seguenti linee guida per la costruzione AMIs:
+ Assicurati che il tuo AMI soddisfi tutte [Marketplace AWS le policy](https://docs.aws.amazon.com/marketplace/latest/userguide/product-and-ami-policies.html).
+ Crea il tuo AMI nella regione Stati Uniti orientali (Virginia settentrionale). 
+ Crea prodotti a partire da prodotti esistenti e ben gestiti AMIs supportati da Amazon Elastic Block Store (Amazon EBS) con un ciclo di vita chiaramente definito fornito da fonti affidabili e affidabili come. Marketplace AWS
+ Crea AMIs utilizzando la maggior parte dei sistemi up-to-date operativi, pacchetti e software. 
+  Assicurati che la tua AMI sia basata su un'AMI Amazon EC2 pubblica, che utilizza la virtualizzazione della macchina virtuale hardware (HVM) e l'architettura a 64 bit.
+ Sviluppa un processo ripetibile per la creazione, l'aggiornamento e la ripubblicazione. AMIs 
+ Utilizza un nome utente del sistema operativo (OS) coerente per tutte le versioni e i prodotti. I nomi utente predefiniti consigliati sono `ec2-user` per Linux e altri sistemi simili a UNIX e `Administrator` per Windows.
+ Prima di inviare un'AMI finale alla Marketplace AWS pubblicazione, avvia e testa un'istanza dell'AMI per verificare l'esperienza desiderata per l'utente finale. Verifica tutti i metodi di installazione, le funzionalità e le prestazioni su questa istanza.
+ Controlla le impostazioni delle porte come segue:
  + Come [configurazione di sicurezza ottimale](https://aws.amazon.com/blogs/security/defense-in-depth-open-firewalls-reverse-proxies-ssrf-vulnerabilities-ec2-instance-metadata-service/) contro firewall aperti, proxy inversi e vulnerabilità SSRF, l'opzione di **supporto IMDS** deve essere impostata su only. **IMDSv2** La seguente CLI può essere utilizzata per registrare una nuova AMI nella fase di compilazione finale: 
    + `aws ec2 register-image --name my-image --root-device-name /dev/xvda --block-device-mappings DeviceName=/dev/xvda,Ebs={SnapshotId=snap-0123456789example} --architecture x86_64 --imds-support v2.0`

Per ulteriori informazioni sulla creazione di un'AMI, consulta le seguenti risorse:
+  [Crea un'AMI supportata da Amazon EBS](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/creating-an-ami-ebs.html) *nella Guida per l'utente di Amazon EC2*
+  [Crea un'AMI Amazon EC2 utilizzando Windows Sysprep](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/ami-create-win-sysprep.html) *nella Guida per l'utente di Amazon EC2* 
+  [Come posso creare un'Amazon Machine Image (AMI) da un'istanza supportata da EBS?](https://aws.amazon.com/premiumsupport/knowledge-center/create-ami-ebs-backed/) 
+  [AMI Amazon Linux](https://aws.amazon.com/amazon-linux-ami/) 
+  [Tipi di istanze e [tipi di istanze Amazon EC2](https://aws.amazon.com/ec2/instance-types/)](http://docs.amazonwebservices.com/AWSEC2/latest/UserGuide/instance-types.html?r=2153) 
+  [Configurazione predefinita di un AMI per l'utilizzo di IMDS V2](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/configuring-IMDS-new-instances.html#configure-IMDS-new-instances-ami-configuration) 

## Preparazione e protezione dell'AMI per Marketplace AWS
<a name="securing-an-ami"></a>

Consigliamo le seguenti linee guida per la creazione di sistemi sicuri AMIs:
+ Utilizza le [linee guida per Shared Linux AMIs](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/building-shared-amis.html) nella Guida per l'utente di *Amazon EC2*
+ Progetta il tuo AMI in modo da utilizzarlo come installazione minima per ridurre la superficie di attacco. Disattiva o rimuovi servizi e programmi non necessari. 
+ Quando possibile, utilizza end-to-end la crittografia per il traffico di rete. Ad esempio, utilizza Secure Sockets Layer (SSL) per proteggere le sessioni HTTP tra te e i tuoi acquirenti. Assicurati che il tuo servizio utilizzi solo certificati e up-to-date validi. 
+ Quando documenti il tuo prodotto AMI, fornisci consigli sui gruppi di sicurezza agli acquirenti per controllare l'accesso del traffico in entrata alle loro istanze. I tuoi consigli dovrebbero specificare quanto segue:
  + Il set minimo di porte richiesto per il funzionamento dei servizi.
  + Le porte e gli intervalli di indirizzi IP di origine consigliati per l'accesso amministrativo.

  Questi consigli sui gruppi di sicurezza aiutano gli acquirenti a implementare controlli di accesso adeguati. Per ulteriori informazioni su come aggiungere una nuova versione al prodotto AMI, consulta[Aggiungi una nuova versione](single-ami-versions.md#single-ami-adding-version).
+ Valuta la possibilità di eseguire un test di penetrazione sull'ambiente AWS informatico a intervalli regolari oppure di affidare tali test a una terza parte per eseguire tali test per tuo conto. [Per ulteriori informazioni, incluso un modulo di richiesta per i test di penetrazione, consulta Penetration Testing.AWS](https://aws.amazon.com/security/penetration-testing/) 
+ Sii consapevole delle 10 principali vulnerabilità delle applicazioni web e crea le tue applicazioni di conseguenza. Per ulteriori informazioni, consulta [Open Web Application Security Project (OWASP) - I 10 principali rischi per la sicurezza delle applicazioni Web](https://owasp.org/www-project-top-ten/). Quando vengono scoperte nuove vulnerabilità di Internet, aggiorna immediatamente tutte le applicazioni Web incluse nella tua AMI. Esempi di risorse che includono queste informazioni sono il [NIST](http://nvd.nist.gov/) National [SecurityFocus](http://www.securityfocus.com/vulnerabilities)Vulnerability Database.

Per ulteriori informazioni relative alla sicurezza, consulta le seguenti risorse:
+  [Sicurezza nel cloud AWS](https://aws.amazon.com/security/) 
+  [Il Center for Internet Security (CIS): benchmark di sicurezza](http://benchmarks.cisecurity.org/downloads/benchmarks/) 
+  [L'Open Web Application Security Project (OWASP): pratiche di codifica sicure - Guida rapida di riferimento](https://owasp.org/www-project-secure-coding-practices-quick-reference-guide/) 
+  [OWASP: I 10 principali rischi per la sicurezza delle applicazioni Web](https://owasp.org/www-project-top-ten/) 
+  [SANS (SysAdmin, Audit, Networking, and Security) Common Weakness Enumeration (CWE) I 25 errori software più pericolosi](http://www.sans.org/top25-software-errors/) 
+  [Focus sulla sicurezza](http://www.securityfocus.com/vulnerabilities) 
+  [Database nazionale delle vulnerabilità del NIST](http://nvd.nist.gov/) 

## Scansione dell'AMI per i requisiti di pubblicazione
<a name="self-service-scanning"></a>

Per pubblicare l'AMI sul Marketplace AWS catalogo, è necessario completare la scansione AMI. La scansione AMI verifica la presenza di vulnerabilità ed esposizioni comuni prive di patch (CVEs) e verifica che l'AMI segua le migliori pratiche di sicurezza. Per ulteriori informazioni, consulta [Preparazione e protezione dell'AMI per Marketplace AWS](https://docs.aws.amazon.com/marketplace/latest/userguide/best-practices-for-building-your-amis.html#securing-an-ami)

 Per eseguire la scansione AMI, scegli una delle seguenti opzioni: 

**Opzione 1: menu Assets**

Questo metodo consente la scansione AMIs al di fuori del flusso di creazione del prodotto. È utile anche per i venditori SaaS che utilizzano SAAS Quick Launch che devono scansionare le risorse senza creare un prodotto AMI.

1. Da [Portale di gestione Marketplace AWS](https://aws.amazon.com/marketplace/management/homepage), vai al menu **Assets** e scegli **Amazon Machine Image**. 

1. Per avviare il processo di scansione, scegli **Aggiungi AMI**. 

1. È possibile visualizzare lo stato della AMIs scansione tornando a questa pagina. 

**Opzione 2: richiedi modifiche al menu**

Questa opzione è disponibile per i venditori che hanno già creato un prodotto AMI. Ulteriori informazioni sono disponibili in [Creazione di prodotti basati su AMI](ami-single-ami-products.md). 

1. Da [Portale di gestione Marketplace AWS](https://aws.amazon.com/marketplace/management/homepage), accedi al menu **Prodotti** e scegli **Server**. 

1. Seleziona il tuo prodotto tra **i prodotti Server**. Deve essere un prodotto basato su AMI. Il prodotto può trovarsi in qualsiasi stato e non è necessario che sia nello stato di pubblicazione **pubblica** per le fasi successive.

1. Vai al menu **Richiedi modifiche** e seleziona **Aggiorna versioni**. 

1. Seleziona **Test «Aggiungi versione**». Segui le istruzioni per inviare una richiesta con i tuoi dati AMI. Se la richiesta ha esito positivo, ciò indica che l'AMI ha superato la scansione con successo. A differenza dell'opzione **Aggiungi nuova versione**, **Test 'aggiungi versione'** non aggiunge una nuova versione al prodotto basato su AMI se la scansione ha esito positivo.

**Nota**  
Per maggiori informazioni su come concedere Marketplace AWS l'accesso alla tua AMI, consulta[Dare Marketplace AWS accesso al tuo AMI](single-ami-marketplace-ami-access.md).

## Verifica che il software sia in esecuzione sull'AMI Marketplace AWS
<a name="verifying-ami-runtime"></a>

Consigliamo vivamente che il software verifichi in fase di esecuzione che sia in esecuzione su un'istanza Amazon EC2 creata dal tuo prodotto AMI.

Per verificare che l'istanza Amazon EC2 sia stata creata dal tuo prodotto AMI, utilizza il servizio di metadati dell'istanza integrato in Amazon EC2. I seguenti passaggi ti guidano attraverso questa convalida. Per ulteriori informazioni sull'utilizzo del servizio di metadati, consulta [Metadati dell'istanza e dati utente](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/ec2-instance-metadata.html) nella *Amazon Elastic Compute Cloud User* Guide.

1. *Ottieni il documento di identità dell'istanza*

   Ogni istanza in esecuzione dispone di un documento di identità accessibile dall'istanza che fornisce dati sull'istanza stessa. L'esempio seguente mostra l'utilizzo di curl dall'istanza per recuperare il documento di identità dell'istanza.

   IMDSv2: (Consigliato)

   ```
   TOKEN=`curl -X PUT "http://169.254.169.254/latest/api/token" -H "X-aws-ec2-metadata-token-ttl-seconds: 21600"` \
   && curl -H "X-aws-ec2-metadata-token: $TOKEN" http://169.254.169.254/latest/dynamic/instance-identity/document
    {
      "accountId" : "0123456789",
      "architecture" : "x86_64",
      "availabilityZone" : "us-east-1e",
      "billingProducts" : null,
      "devpayProductCodes" : null,
      "marketplaceProductCodes" : [ "0vg0000000000000000000000" ],
      "imageId" : "ami-0123456789abcdef1",
      "instanceId" : "i-0123456789abcdef0",
      "instanceType" : "t2.medium",
      "kernelId" : null,
      "pendingTime" : "2020-02-25T20:23:14Z",
      "privateIp" : "10.0.0.2",
      "ramdiskId" : null,
      "region" : "us-east-1",
      "version" : "2017-09-30"
   }
   ```

   IMDSv1:

   ```
   curl http://169.254.169.254/latest/dynamic/instance-identity/document{
      "accountId" : "0123456789",
      "architecture" : "x86_64",
      "availabilityZone" : "us-east-1e",
      "billingProducts" : null,
      "devpayProductCodes" : null,
      "marketplaceProductCodes" : [ "0vg0000000000000000000000" ],
      "imageId" : "ami-0123456789abcdef1",
      "instanceId" : "i-0123456789abcdef0",
      "instanceType" : "t2.medium",
      "kernelId" : null,
      "pendingTime" : "2020-02-25T20:23:14Z",
      "privateIp" : "10.0.0.2",
      "ramdiskId" : null,
      "region" : "us-east-1",
      "version" : "2017-09-30"
   }
   ```

1. *Verifica il documento di identità dell'istanza*

   È possibile verificare che l'identità dell'istanza sia corretta utilizzando la firma. Per dettagli su questo processo, consulta [Documenti di identità dell'istanza](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/instance-identity-documents.html) nella *guida per l'utente di Amazon Elastic Compute Cloud*.

1. *Verifica il codice del prodotto*

   Quando invii inizialmente il tuo prodotto AMI per la pubblicazione, al prodotto viene assegnato un [codice prodotto](https://docs.aws.amazon.com/marketplace/latest/userguide/ami-getting-started.html#ami-product-codes) da Marketplace AWS. Puoi verificare il codice del prodotto controllando il `marketplaceProductCodes` campo nel documento di identità dell'istanza oppure puoi ottenerlo direttamente dal servizio di metadati:

   IMDSv2:

   ```
   TOKEN=`curl -X PUT "http://169.254.169.254/latest/api/token" -H "X-aws-ec2-metadata-token-ttl-seconds: 21600"` \
    && curl -H "X-aws-ec2-metadata-token: $TOKEN" http://169.254.169.254/latest/meta-data/product-codes
   ```

   Se il codice prodotto corrisponde a quello del tuo prodotto AMI, l'istanza è stata creata dal tuo prodotto.

# Prezzi dei prodotti AMI per Marketplace AWS
<a name="pricing-ami-products"></a>

Marketplace AWS offre diversi modelli di prezzo per i prodotti Amazon Machine Image (AMI). Con le offerte private per i venditori, sono disponibili opzioni per contratti pluriennali e di durata personalizzata. Per ulteriori informazioni sui contratti pluriennali e personalizzati, consulta [Preparazione di un'offerta privata per il tuo Marketplace AWS prodotto](private-offers-overview.md) e. [Piani di rateizzazione dell'offerta privata](installment-plans.md) Le seguenti sezioni forniscono informazioni sui modelli di prezzo per i prodotti basati su AMI.

**Nota**  
Devi essere in grado di fornire un modulo fiscale W-9 (per le entità con sede negli Stati Uniti) o un modulo W-8 (per le entità con sede nell'UE) come descritto in. [Registrazione come venditore su Marketplace AWS](seller-account-registering.md)

**Topics**
+ [Modelli di prezzo AMI](#pricing-models-for-ami-products)
+ [AWS costi e costi del software](#aws-charges-vs-software-charges)
+ [Prezzi di misurazione personalizzati per i prodotti AMI con AWS Marketplace Metering Service](custom-metering-pricing-ami-products.md)
+ [Prezzi contrattuali per i prodotti AMI su Marketplace AWS](ami-contracts.md)
+ [Associazione di licenze a prodotti basati su AMI utilizzando AWS License Manager](ami-license-manager-integration.md)

## Modelli di prezzo AMI
<a name="pricing-models-for-ami-products"></a>

La tabella seguente fornisce informazioni generali sui modelli di prezzo per i prodotti basati su AMI.


|  Modello tariffario  |  Descrizione  | 
| --- | --- | 
|  Gratuito  | I clienti possono eseguire tutte le istanze supportate da Amazon Elastic Compute Cloud EC2 (Amazon) senza costi software aggiuntivi.  La prova gratuita e i prezzi annuali non possono essere combinati con i prezzi mensili.  | 
| Bring-Your-Own-License (uso di licenze proprie)  | Marketplace AWS non addebita ai clienti l'utilizzo del software, ma i clienti devono fornire una chiave di licenza per attivare il prodotto. Questa chiave viene acquistata al di fuori di Marketplace AWS. L'applicazione dei diritti e delle licenze, oltre a tutti i prezzi e la fatturazione, sono a carico dell'utente.  | 
| Pagato ogni ora o ogni ora |  **Ogni ora: il** software viene addebitato su base oraria. Ogni tipo di istanza può avere un prezzo diverso (ma non è obbligatorio) e l'utilizzo viene arrotondato all'ora intera più vicina.  **Ogni ora con prova gratuita**: i clienti sono limitati a eseguire esattamente un'istanza del software senza incorrere in costi aggiuntivi. La durata è definita dall'utente, tra 5 e 30 giorni. La versione di prova gratuita si applica al tipo di istanza più costoso in esecuzione e qualsiasi utilizzo simultaneo diverso da 1 istanza viene fatturato alla tariffa oraria. NOTA: si tratta di un modello diverso dal piano AWS gratuito per l' EC2 utilizzo di Amazon, in base al quale i clienti ricevono 750 ore di utilizzo gratuito ogni mese.  **Oraria e mensile**: le tariffe orarie e mensili vengono applicate indipendentemente. La tariffa mensile viene addebitata ogni mese indipendentemente dall'utilizzo e la tariffa oraria viene applicata solo in base all'utilizzo orario.  **Ogni ora con abbonamento annuale**: i clienti hanno la possibilità di acquistare in anticipo un anno di utilizzo per un' EC2 istanza Amazon di un tipo di istanza. Tu stabilisci il prezzo per ogni tipo di istanza e puoi offrire risparmi netti rispetto al prezzo orario. Qualsiasi utilizzo da parte del cliente superiore al numero di abbonamenti annuali acquistati viene fatturato alla tariffa oraria impostata per quel tipo di istanza.  **Oraria con durata pluriennale e personalizzata**: questo tipo di offerta è disponibile solo tramite le offerte private del venditore. Utilizzando le offerte private per i venditori, specifichi una durata del contratto personalizzata, fino a 3 anni. Puoi specificare il pagamento anticipato o includere un piano di pagamento flessibile. Sei tu a impostare il prezzo per ogni tipo di istanza. Se l'offerta prevede un piano di pagamento flessibile, imposti anche le date della fattura, gli importi dei pagamenti e il numero di istanze per ogni tipo di istanza incluso nell'offerta. Per un'offerta privata attiva con un programma di pagamento flessibile, dopo che il cliente ha lanciato il numero specificato di istanze, tutte le istanze aggiuntive avviate vengono addebitate alla tariffa oraria specificata nell'offerta privata del venditore. Per ulteriori informazioni sui contratti pluriennali e con durata personalizzata, consulta e. [Preparazione di un'offerta privata per il tuo Marketplace AWS prodotto](private-offers-overview.md) [Piani di rateizzazione dell'offerta privata](installment-plans.md)  **Orario con periodo di prova annuale (include la prova gratuita)**: è identico al modello Hourly con opzione Annuale, tranne per il fatto che include una prova gratuita che consente a un cliente di eseguire gratuitamente un'istanza di qualsiasi tipo di istanza per un determinato numero di giorni da voi stabilito. Gli abbonamenti annuali possono essere acquistati in qualsiasi momento e sono combinati con l'abbonamento di prova gratuita.  **Annuale con tariffa oraria**: uguale al modello di tariffazione oraria con tariffa annuale. I clienti hanno la possibilità di acquistare in anticipo un anno di utilizzo per un' EC2 istanza Amazon di un tipo di istanza. Puoi impostare il prezzo per ogni tipo di istanza e puoi offrire risparmi netti rispetto al prezzo orario, ma offrire risparmi non è obbligatorio. Qualsiasi utilizzo da parte del cliente superiore al numero di abbonamenti annuali acquistati viene fatturato alla tariffa oraria impostata per quel tipo di istanza.  **Durata pluriennale e personalizzata con frequenza oraria: disponibile solo** tramite. [Preparazione di un'offerta privata per il tuo Marketplace AWS prodotto](private-offers-overview.md) Utilizzando le offerte private del venditore, puoi specificare un contratto di durata personalizzata fino a tre anni. Puoi richiedere un pagamento anticipato oppure offrire al cliente un programma di pagamento flessibile. Puoi impostare il prezzo per ogni tipo di istanza per la durata del contratto e il prezzo orario per le istanze aggiuntive lanciate. Se offri un piano di pagamento flessibile, imposti anche le date della fattura, gli importi dei pagamenti e il numero di istanze per ogni tipo di istanza incluso nell'offerta. Per un'offerta privata attiva con un programma di pagamento flessibile, dopo il lancio del numero specificato di istanze, tutte le istanze aggiuntive avviate dal cliente vengono addebitate alla tariffa oraria specificata nell'offerta privata. Per ulteriori informazioni sui contratti pluriennali e personalizzati, consulta e. [Preparazione di un'offerta privata per il tuo Marketplace AWS prodotto](private-offers-overview.md) [Piani di rateizzazione dell'offerta privata](installment-plans.md)   La prova gratuita e i prezzi annuali non possono essere combinati con i prezzi mensili.   | 
| Pagato mensilmente  |  **Mensile**: il pagamento del software viene effettuato su base mensile fissa, indipendentemente dal numero di istanze eseguite dal cliente. Gli addebiti mensili vengono ripartiti proporzionalmente al momento dell'iscrizione e alla cancellazione. Esempio: a un cliente che sottoscrive un abbonamento per 1 giorno del mese verrà addebitato il costo di 1/30 del mese.  **Mensile con tariffa oraria**: le tariffe orarie e mensili vengono applicate indipendentemente. La tariffa mensile viene addebitata ogni mese indipendentemente dall'utilizzo e la tariffa oraria viene applicata solo in base all'utilizzo orario.   La prova gratuita e i prezzi annuali non possono essere combinati con i prezzi mensili.   | 
| Prezzi di utilizzo a pagamento |  Il software viene addebitato direttamente in base al valore fornito dall'utente insieme a una delle quattro categorie di utilizzo: utenti, dati, larghezza di banda o host. È possibile definire fino a 24 dimensioni per il prodotto. Tutti gli addebiti sono comunque sostenuti ogni ora dal cliente.  Tutto l'utilizzo viene calcolato mensilmente e fatturato mensilmente utilizzando lo stesso meccanismo del software esistente. Marketplace AWS I prezzi di utilizzo sono anche denominati AWS Marketplace Metering Service.   | 
|  Modello di determinazione dei prezzi contrattuali  |  **AMI con prezzi contrattuali**: un prodotto con AMI singola o AMI singola con AWS CloudFormation stack per il quale l'acquirente paga una commissione anticipata.  | 

## AWS costi e costi del software
<a name="aws-charges-vs-software-charges"></a>

I costi dei prodotti basati su Amazon Machine Image (AMI) si dividono in due categorie:
+ **Dettagli sui prezzi dell'infrastruttura**: tutti i prodotti basati su AMI sono soggetti a costi di AWS infrastruttura associati a seconda dei servizi e dell'infrastruttura utilizzati. Queste tariffe e commissioni sono definite e controllate da e possono AWS variare tra. Regioni AWS Per ulteriori informazioni, consulta [Prezzi di Amazon EC2](https://aws.amazon.com/ec2/pricing/).
+ **Dettagli sui prezzi del software**: per i prodotti a pagamento, il venditore definisce i costi per l'utilizzo del software. 

Queste due categorie di costi dei prodotti vengono visualizzate separatamente nelle pagine dei Marketplace AWS dettagli per aiutare gli acquirenti a comprendere il costo potenziale di utilizzo dei prodotti. 

### Versione di prova gratuita per i prodotti orari AMI
<a name="free-trial"></a>

I prodotti orari AMI sono idonei per il programma di prova gratuito opzionale. In una prova gratuita, un cliente può abbonarsi al prodotto e utilizzare una singola istanza per un massimo di 31 giorni senza pagare i costi del software sul prodotto. Si applicano ancora gli oneri AWS infrastrutturali applicabili. Le prove gratuite verranno convertite automaticamente in un abbonamento a pagamento alla scadenza. Ai clienti verrà addebitato un costo per un utilizzo aggiuntivo rispetto alle unità gratuite fornite. Per offrire una prova gratuita del prodotto ogni ora, definisci la durata del periodo di prova e informa il team [operativo del Marketplace AWS venditore](https://aws.amazon.com/marketplace/management/contact-us/). Il periodo di prova può essere compreso tra 5 e 31 giorni.

Quando i clienti si abbonano a un prodotto in prova gratuita, ricevono un messaggio e-mail di benvenuto che include la durata della prova gratuita, una data di scadenza calcolata e dettagli sull'annullamento dell'iscrizione. Un messaggio e-mail di promemoria viene inviato tre giorni prima della data di scadenza.

Se offri un prodotto di prova gratuito in Marketplace AWS, accetti le politiche di rimborso specifiche descritte nella sezione **Politica di rimborso**.

### Risorse aggiuntive
<a name="ami-products-pricing-resources"></a>

Per ulteriori informazioni sui prezzi dei prodotti AMI, consulta i seguenti argomenti:
+ [Prezzi di misurazione personalizzati per i prodotti AMI con AWS Marketplace Metering Service](custom-metering-pricing-ami-products.md)
+ [Prezzi contrattuali per i prodotti AMI su Marketplace AWS](ami-contracts.md)

Per ulteriori informazioni sulle integrazioni di fatturazione, misurazione e licenza per i prodotti basati su AMI, consulta i seguenti argomenti:

sui prezzi dei prodotti AMI, consulta i seguenti argomenti:
+ [Configurazione della misurazione personalizzata per i prodotti AMI con AWS Marketplace Metering Service](custom-metering-with-mp-metering-service.md)
+ [Associazione di licenze a prodotti basati su AMI utilizzando AWS License Manager](ami-license-manager-integration.md)

# Prezzi di misurazione personalizzati per i prodotti AMI con AWS Marketplace Metering Service
<a name="custom-metering-pricing-ami-products"></a>

Con AWS Marketplace Metering Service, puoi modificare il tuo software per inviare i record di misurazione a un endpoint per acquisire l'utilizzo. Puoi selezionare una categoria di utilizzo e definire fino a 24 dimensioni per quella categoria. Queste dimensioni vengono misurate una volta all'ora, aggregate e addebitate in base a un piano tariffario definito dall'utente. In qualità di venditore, devi determinare quale dimensione desideri utilizzare. Dopo la pubblicazione dell'AMI, non sarà possibile modificarla. Le seguenti sezioni forniscono informazioni su AWS Marketplace Metering Service.

**Topics**
+ [Concetti relativi ai servizi di misurazione](#metering-service-concepts)
+ [Definizione dei prezzi del software](#pricing-your-software)
+ [Aggiungere il prodotto a Marketplace AWS](#listing-your-product-on-aws-marketplace)
+ [Modifica del software per utilizzare il servizio di misurazione](#modifying-your-software-to-use-the-metering-service)
+ [Etichettatura in base al fornitore (opzionale)](#ami-vendor-metered-tagging)
+ [Configurazione della misurazione personalizzata](#configure-custom-metering)
+ [Configurazione della misurazione personalizzata per i prodotti AMI con AWS Marketplace Metering Service](custom-metering-with-mp-metering-service.md)

## Concetti relativi ai servizi di misurazione
<a name="metering-service-concepts"></a>

Prima di utilizzare AWS Marketplace Metering Service, prendi nota dei seguenti importanti concetti di servizio:
+  **Categoria di utilizzo**: qualsiasi prodotto software il cui prezzo è basato sull'uso del servizio di misurazione è classificato in base a una categoria di utilizzo, che determina il modo appropriato di addebitare i costi ai clienti. Le categorie di utilizzo includono, a titolo esemplificativo ma non esaustivo: 
  + **Utenti**: un insieme definito di autorizzazioni associate a un singolo identificatore. Questa categoria è appropriata per il software in cui gli utenti di un cliente si connettono direttamente al software (ad esempio, per la gestione delle relazioni con i clienti o la creazione di report di business intelligence). 
  + **Host**: qualsiasi server, nodo, istanza, endpoint o altra parte di un sistema informatico. Questa categoria è appropriata per il software che monitora o analizza molte istanze di proprietà del cliente (ad esempio, monitoraggio delle prestazioni o della sicurezza). 
  + **Dati**: archiviazione o informazioni, misurati in MB, GB o TB. Questa categoria è appropriata per il software che gestisce i dati archiviati o elabora i dati in batch. 
  + **Larghezza di banda:** misurata in Mbps o Gbps. Questa categoria è appropriata per i software che consentono ai clienti di specificare la quantità di larghezza di banda da fornire.
  + **Unità**: unità di misura; vedere gli esempi descritti di seguito.
+  **Unità di utilizzo: l'unità** di utilizzo specifica di un prodotto software corrisponde alla categoria di utilizzo selezionata. Questa unità di utilizzo descrive l'unità su cui verrà caricato il software. Gli esempi includono: 
  + **NodesHrs**(corrispondente alla categoria Host)
  + **UserHrs**(corrispondente alla categoria Utente)
  + **GBStored**(corrispondente alla categoria di dati)
+  **Consumo**: i prodotti software calcolati in base all'uso del servizio di misurazione addebitano il consumo in uno dei tre modi seguenti: 
  + Fornito: il software consente ai clienti di configurare una quantità specifica di risorse da utilizzare (ad esempio, numero di utenti o una quantità fissa di larghezza di banda). Ogni ora, i clienti pagano per ciò che hanno fornito. 
  + Simultanea: il software consente a un numero qualsiasi di host o utenti distinti di connettersi al software. Ogni ora, i clienti pagano in base al numero di host o utenti che hanno avuto accesso al software. 
  + Accumulato: il software consente ai clienti di utilizzare qualsiasi quantità di dati, elaborati o archiviati. Ogni ora, i clienti pagano l'importo aggregato. 
+  **Prezzi**: i prodotti software calcolati tramite l'utilizzo del servizio di misurazione devono specificare un prezzo unico o definire fino a 24 dimensioni, ciascuna con il proprio prezzo. I dettagli sulle opzioni di prezzo includono:
  + Dimensione singola: questa è l'opzione di prezzo più semplice. I clienti pagano un unico prezzo per unità di risorsa all'ora, indipendentemente dalle dimensioni o dal volume (ad esempio, 0,014 USD per utente all'ora o 0,070 USD per host all'ora). 
  + Dimensioni multiple: questa opzione di prezzo è appropriata quando la categoria di utilizzo selezionata varia lungo più assi. Ad esempio, per il monitoraggio dell'host, è possibile impostare un prezzo diverso a seconda delle dimensioni dell'host. Oppure, per i prezzi basati sull'utente, è possibile impostare un prezzo diverso in base al tipo di utente (ad esempio, admin, power user e utente di sola lettura). 
+  **Misurazione**: tutto l'utilizzo viene registrato come evento di misurazione, una volta all'ora. Il software deve essere configurato per inviare la dimensione e la quantità di utilizzo appropriate all'AWS Marketplace Metering Service. 
  + Allocazioni: facoltativamente, puoi distribuire l'utilizzo in allocazioni in base alle proprietà da monitorare. Queste allocazioni vengono rappresentate come tag per l'acquirente. I tag consentono all'acquirente di visualizzare i costi suddivisi in base all'utilizzo per tag. Ad esempio, se addebiti in base all'utente e gli utenti hanno la proprietà «Dipartimento», puoi creare allocazioni di utilizzo con tag con la chiave «Dipartimento» e un'allocazione per valore. Questo approccio non modifica il prezzo, le dimensioni o l'utilizzo totale riportato. Tuttavia, consente ai clienti di visualizzare i costi per categorie appropriate al prodotto.

## Definizione dei prezzi del software
<a name="pricing-your-software"></a>

Quando stabilisci il prezzo del tuo software con AWS Marketplace Metering Service, devi prima decidere una categoria di utilizzo e come verrà utilizzato. Il servizio supporta sei diversi scenari di prezzo. È necessario selezionare solo uno di questi per il prodotto: 
+ Utente assegnato (all'ora) 
+ Utente simultaneo (all'ora) 
+ Host assegnato (all'ora) 
+ Host simultaneo (all'ora) 
+ Larghezza di banda fornita (all'ora) 
+ Dati accumulati (all'ora) 

Successivamente, devi decidere come determinare il prezzo della categoria di utilizzo selezionata: 
+ Prezzo unico 
+ Dimensioni multiple (fino a 24) 

[Aggiungere il prodotto a Marketplace AWS](#listing-your-product-on-aws-marketplace)descrive come fornire una descrizione intuitiva delle dimensioni e dei prezzi. 

### Esempio: larghezza di banda fornita con prezzi non lineari
<a name="example-provisioned-bandwidth-with-non-linear-pricing"></a>

Immagina di offrire software per dispositivi di rete. Puoi scegliere di fatturare in base alla larghezza di banda fornita. **Per la tua categoria di utilizzo, seleziona Larghezza di banda.** Oltre all'addebito in base alla larghezza di banda, desideri addebitare un prezzo diverso man mano che gli acquirenti aumentano. Puoi definire più dimensioni all'interno della categoria della larghezza di banda. È possibile definire un prezzo distinto per 25 Mbps, 100 Mbps e 1 Gbps. 

### Esempio: host simultanei con più dimensioni
<a name="example-concurrent-hosts-with-multiple-dimensions"></a>

Immagina di offrire un software che monitora altre istanze Amazon EC2. Scegli di fatturare in base al numero di host che vengono monitorati. Per la tua categoria di utilizzo, seleziona **Host**. Oltre all'addebito per host, desideri addebitare il valore aggiuntivo derivante dal monitoraggio di host di grandi dimensioni. Puoi utilizzare più dimensioni all'interno della categoria host. Puoi definire un prezzo distinto per le istanze micro, piccole, medie, grandi, x-large, 2XL, 4XL e 8XL. Il software è responsabile della mappatura di ogni host specifico su una delle dimensioni definite dall'utente. Il software è responsabile dell'invio di un record di misurazione separato per ogni dimensione della categoria di utilizzo, se applicabile. 

## Aggiungere il prodotto a Marketplace AWS
<a name="listing-your-product-on-aws-marketplace"></a>

Per usufruire del servizio di misurazione, è necessario creare un nuovo prodotto Marketplace AWS da mettere in vendita. Se il tuo prodotto è già disponibile su Marketplace AWS, dovrai decidere se il nuovo prodotto AWS Marketplace Metering Service sarà reso disponibile in aggiunta al prodotto attuale o se sostituirà il prodotto attuale come unica versione disponibile per i nuovi utenti. Se scegli la sostituzione, il prodotto esistente verrà rimosso Marketplace AWS in modo che non sia più disponibile per i nuovi acquirenti. I clienti esistenti continueranno ad avere accesso al vecchio prodotto e alle istanze, ma potranno migrare al nuovo prodotto quando lo desiderano. Il nuovo prodotto deve misurare l'utilizzo dell'AWS Marketplace Metering Service, come descritto in[Modifica del software per utilizzare il servizio di misurazione](#modifying-your-software-to-use-the-metering-service).

Dopo aver installato l'AMI, segui la procedura standard per condividerla e scansionarla utilizzando lo strumento self-service. Oltre a utilizzare il modello disponibile sul portale di gestione, compila il modulo di caricamento del prodotto e caricalo per avviare il processo di inserimento. 

Utilizza le seguenti definizioni per completare i campi del Product Load Form per l'AWS Marketplace Metering Service. Nel modulo di caricamento del prodotto, questi campi sono etichettati come **Flexible Consumption Pricing (FCP)** per distinguerli dai prodotti a prezzo orario e mensile. 
+  **Titolo**: se hai già un prodotto Marketplace AWS e stai aggiungendo lo stesso prodotto con il AWS Marketplace Metering Service, includi la categoria e la dimensione FCP tra parentesi per differenziarle (ad esempio, «TITOLO DEL PRODOTTO (dati)»). 
+  **Modello di prezzo****: dall'elenco a discesa, scegli Utilizzo.** 
+  Categoria **FCP: la categoria** in cui ai clienti vengono addebitati i prodotti a pagamento con una componente relativa ai prezzi di **utilizzo**. **Dall'elenco a discesa, scegli **Utenti**, **Host**, **Dati** o Larghezza di banda.** 
+  **Unità **FCP: l'unità** di misura in base alla quale ai clienti vengono addebitati i prodotti a pagamento con una componente relativa ai prezzi di utilizzo.** Le opzioni verranno visualizzate nell'elenco a discesa in base alla categoria FCP selezionata. La tabella seguente elenca le unità valide per ogni categoria.     
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/marketplace/latest/userguide/custom-metering-pricing-ami-products.html)
+  **Nome dimensione FCP: il nome** utilizzato per inviare i record di misurazione richiamando l'operazione. `MeterUsage` È visibile nei report di fatturazione. Tuttavia, poiché non è rivolto verso l'esterno, non è necessario che il nome sia intuitivo. Il nome non può contenere più di 15 caratteri e può includere solo caratteri alfanumerici e caratteri di sottolineatura. Dopo aver impostato il nome e reso pubblico il prodotto, non puoi modificarlo. La modifica del nome richiede una nuova AMI. 
+  **Descrizione della dimensione FCP**: la dichiarazione rivolta al cliente che descrive la dimensione del prodotto. La descrizione (non può superare i 70 caratteri) e deve essere facile da usare. Esempi di descrizioni includono: Amministratori per ora e per Mbps di larghezza di banda fornita. Dopo la pubblicazione del prodotto, non puoi modificare questa descrizione. 
+  Tariffa **FCP: la tariffa** software per unità per questo prodotto. Questo campo supporta otto cifre decimali. 

**Note:**  
Non è necessario compilare i campi relativi ai prezzi orari e annuali. 
La prova gratuita e i prezzi annuali non sono compatibili. 
I prodotti che utilizzano un'AMI e la funzionalità Clusters and AWS Resources non possono utilizzare AWS Marketplace Metering Service. 
Il prezzo, il tipo di istanza o la Regione AWS modifica seguiranno la stessa procedura degli altri Marketplace AWS prodotti.
I prodotti con AWS Marketplace Metering Service non possono essere convertiti in altri modelli di prezzo come quelli orari, mensili o Bring Your Own License (BYOL). 
Marketplace AWS consiglia di aggiungere informazioni sulla policy IAM nelle istruzioni o nel documento di utilizzo. 
Puoi includere fino a 24 dimensioni FCP in totale. Una volta create e pubblicate, non è possibile modificare le dimensioni esistenti, ma è possibile aggiungerne di nuove (fino al limite di 24).

In caso di domande, contatta il team [Marketplace AWS Operativo del venditore](https://aws.amazon.com/marketplace/management/contact-us/). 

## Modifica del software per utilizzare il servizio di misurazione
<a name="modifying-your-software-to-use-the-metering-service"></a>

Sarà necessario modificare il software per registrare l'utilizzo da parte dei clienti, inviare report orari sull'utilizzo al servizio di misurazione e gestire nuove modalità di errore. Il software funziona indipendentemente dai prezzi, ma dovrà conoscere la categoria di utilizzo, il modo in cui viene utilizzato e le eventuali dimensioni. 

### Misurazione del consumo
<a name="measuring-consumption"></a>

Il software deve determinare la parte della categoria di utilizzo selezionata e le dimensioni utilizzate dal cliente. Questo valore verrà inviato, una volta ogni ora, al servizio di misurazione. In tutti i casi, si presume che il software sia in grado di misurare, registrare e leggere il consumo di risorse allo scopo di inviarlo su base oraria al Servizio di misurazione. 

Per quanto riguarda il consumo previsto, questo viene in genere letto dalla configurazione del software come valore campionato, ma potrebbe anche essere un valore massimo configurato, registrato ogni ora. Per il consumo concomitante, potrebbe trattarsi di un campione periodico o di un valore massimo registrato ogni ora. Per il consumo accumulato, questo sarà un valore accumulato ogni ora. 

Per stabilire i prezzi su più dimensioni, è necessario misurare più valori e inviarli al servizio di misurazione, uno per dimensione. Ciò richiede che il software sia programmato o configurato con il set di dimensioni noto al momento della fornitura dell'AMI. Il set di dimensioni non può cambiare dopo la creazione di un prodotto.

Per ogni scenario di prezzo, la tabella seguente descrive i metodi consigliati per misurare il consumo ogni ora. 


|  **Scenario**  |  **Come misurare**  | 
| --- | --- | 
|  Utente assegnato   |  Numero attuale di utenti assegnati (inclusi nel campione).  -O-  Numero massimo di utenti assegnati (visto in quell'ora).   | 
|  Utente simultaneo   |  Numero attuale di utenti simultanei (campionati).  -O-  Numero massimo di utenti simultanei (visto in quell'ora).  -O-  Numero totale di utenti distinti (visto in quell'ora).   | 
|  Host fornito   |  Numero attuale di host assegnati (a campione).  -O-  Numero massimo di host assegnati (visto in quell'ora).   | 
|  Host simultaneo   |  Numero attuale di host simultanei (campionati).  -O-  Numero massimo di host simultanei (visto in quell'ora).  -O-  Numero totale di host distinti (visto in quell'ora).   | 
|  Larghezza di banda fornita   |  Impostazione della larghezza di banda attualmente fornita (campionata).  -O-  Larghezza di banda massima fornita (vista in quell'ora).   | 
|  Dati accumulati   |  GB attuali di dati archiviati (campionati).  -O-  Massimo GB di dati archiviati (visto in quell'ora).  -O-  GB totali di dati aggiunti o elaborati in quell'ora.  -O-  GB totali di dati elaborati in quell'ora.   | 

## Etichettatura in base al fornitore (opzionale)
<a name="ami-vendor-metered-tagging"></a>

L'etichettatura basata sul fornitore aiuta i fornitori di software indipendenti (ISVs) a fornire all'acquirente informazioni più dettagliate sull'utilizzo del software e può aiutarlo a eseguire l'allocazione dei costi.

Per contrassegnare l'utilizzo del software da parte di un acquirente, è necessario determinare la modalità di allocazione dei costi. Per prima cosa chiedi agli acquirenti cosa vogliono vedere nella loro allocazione dei costi. Quindi puoi suddividere l'utilizzo tra le proprietà monitorate per l'account dell'acquirente. Esempi di proprietà includono `Account ID` `Business Unit``Cost Centers`, e altri metadati pertinenti per il tuo prodotto. Queste proprietà vengono esposte all'acquirente come tag. Utilizzando i tag, gli acquirenti possono visualizzare i costi suddivisi in base all'utilizzo in base ai valori dei tag nella loro AWS Billing Console ([https://console.aws.amazon.com/costmanagement/](https://console.aws.amazon.com/costmanagement/)). I tag misurati in base al fornitore non modificano il prezzo, le dimensioni o l'utilizzo totale segnalato. Consente ai clienti di visualizzare i costi per categorie appropriate al prodotto.

In un caso d'uso comune, un acquirente sottoscrive un abbonamento al tuo prodotto utilizzando un Account AWS prodotto. L'acquirente ha inoltre numerosi utenti associati allo stesso abbonamento al prodotto. È possibile creare allocazioni di utilizzo con tag con una chiave di e `Account ID` quindi allocare l'utilizzo a ciascun utente. In questo caso, gli acquirenti possono attivare il `Account ID` tag nella console di Billing and Cost Management e analizzare l'utilizzo da parte dei singoli utenti.

### Esperienza del venditore
<a name="ami-vendor-metered-tag-seller"></a>

I venditori possono aggregare i record di misurazione delle risorse con lo stesso set di tag anziché aggregare l'utilizzo di tutte le risorse. Ad esempio, i venditori possono creare il record di misurazione che include diversi periodi di. `UsageAllocations` Ogni bucket rappresenta un set di tag, ad `UsageQuantity` esempio e. `AccountId` `BusinessUnit` 

Nel diagramma seguente, **Resource 1** ha un set unico di `BusinessUnit` tag `AccountId` e viene visualizzata nel **Metering Record** come una voce singola. 

La **risorsa 2** e la **risorsa 3** hanno entrambe lo stesso `AccountId` tag e lo stesso `BusinessUnit` tag. `2222` `Operations` Di conseguenza, vengono combinati in un'unica `UsageAllocations` voce nel **Metering Record**.

![\[Diagramma che mostra come i tag di misurazione dei fornitori combinano i dati di utilizzo. Tre risorse (Risorsa 1, 2 e 3) con dati diversi AccountIds BusinessUnits vengono consolidate in un unico record di misurazione, UsageAllocations raggruppate per AccountId e BusinessUnit prima di essere inviate al AWS Marketplace Metering Service.\]](http://docs.aws.amazon.com/it_it/marketplace/latest/userguide/images/seller-vendor-meter-tag.png)


I venditori possono anche combinare le risorse senza tag in un'unica risorsa `UsageAllocation` con la quantità di utilizzo assegnata e inviarla come una delle voci inserite. `UsageAllocations`

I limiti includono:
+ Numero di tag: 5
+ Dimensione di `UsageAllocations` (cardinalità): 2.500

Le convalide includono:
+ Caratteri consentiti per la chiave e il valore del tag: a-zA-Z 0-9\$1 -= . \$1:\$1 /@
+ Numero massimo di tag nell'`UsageAllocation`elenco: 5
+ Due non `UsageAllocations` possono avere gli stessi tag (ovvero la stessa combinazione di chiavi e valori dei tag). In tal caso, devono usare lo stesso`UsageAllocation`.
+ La somma `AllocatedUsageQuantity` di `UsageAllocation` deve essere uguale a`UsageQuantity`, che è l'utilizzo aggregato.

### Esperienza dell'acquirente
<a name="ami-vendor-metered-tag-buyer"></a>

La tabella seguente mostra un esempio dell'esperienza dell'acquirente dopo che un acquirente ha attivato i tag `AccountId` e `BusinessUnit` fornitore. 

In questo esempio, l'acquirente può visualizzare l'utilizzo allocato nel proprio rapporto **sui costi** di utilizzo. I tag misurati dal fornitore utilizzano il prefisso. `“aws:marketplace:isv”` Gli acquirenti possono attivarli in Billing and Cost Management, **in Tag di allocazione dei costi AWS, tag di allocazione** **dei costi generati**.

La prima e l'ultima riga del **report sull'utilizzo dei costi** sono pertinenti a ciò che il venditore invia al servizio di misurazione (come mostrato nell'esempio). [Esperienza del venditore](container-metering-meterusage.md#container-vendor-metered-tag-seller)


**Report sull'utilizzo dei costi (semplificato)**  

| ProductCode  | Acquirente | UsageDimension | UsageQuantity | `aws:marketplace:isv:AccountId ` | `aws:marketplace:isv:BusinessUnit` | 
| --- | --- | --- | --- | --- | --- | 
| xyz | 111122223333 | Rete: per (GB) ispezionata  | 70 | 2222 | Operazioni | 
| xyz | 111122223333 | Rete: per (GB) ispezionata  | 30 | 3333 | Ambito finanziario | 
| xyz | 111122223333 | Rete: per (GB) ispezionata  | 20 | 4444 | IT | 
| xyz | 111122223333 | Rete: per (GB) ispezionata  | 20 | 5555 | Marketing | 
| xyz | 111122223333 | Rete: per (GB) ispezionata  | 30 | 1111 | Marketing | 

Per un esempio di codice, vedi [`MeterUsage`con etichettatura per l'allocazione dell'utilizzo (opzionale)](custom-metering-with-mp-metering-service.md#ami-meterusage-code-example)

## Configurazione della misurazione personalizzata
<a name="configure-custom-metering"></a>

Per ulteriori informazioni sull'utilizzo di AWS Marketplace Metering Service, consulta[Configurazione della misurazione personalizzata per i prodotti AMI con AWS Marketplace Metering Service](custom-metering-with-mp-metering-service.md). 

# Configurazione della misurazione personalizzata per i prodotti AMI con AWS Marketplace Metering Service
<a name="custom-metering-with-mp-metering-service"></a>

**Nota**  
Per i prodotti basati su AMI con prezzi di misurazione personalizzati, il software deve chiamare l'[MeterUsage API](https://docs.aws.amazon.com/marketplace/latest/APIReference/API_marketplace-metering_MeterUsage.html) utilizzando AWS le credenziali temporanee del ruolo IAM per Amazon Elastic Compute Cloud collegato all'istanza Amazon EC2. L'utilizzo di chiavi di accesso a lungo termine non è supportato.

L'AWS Marketplace Metering Service è una funzionalità di determinazione dei prezzi e misurazione che puoi utilizzare per addebitare direttamente il tuo software in base alla categoria di utilizzo. Esistono cinque categorie di utilizzo: utenti, dati, larghezza di banda, host o unità. Puoi utilizzare il servizio di misurazione con prodotti basati su Amazon Machine Image (AMI), basati su container e basati su Software as a Service (SaaS). Le seguenti sezioni forniscono ulteriori informazioni su come configurare la misurazione personalizzata con AWS Marketplace Metering Service. 

L'AWS Marketplace Metering Service consente diversi nuovi scenari. Ad esempio, se il tuo software monitora gli host, puoi addebitare un costo per ogni host monitorato. È possibile avere prezzi diversi in base alle dimensioni dell'host e addebitare il numero di host simultanei monitorati ogni ora. Analogamente, se il software consente l'accesso a più utenti di un'organizzazione, è possibile addebitare i costi in base al numero di utenti. Ogni ora, al cliente viene addebitato il numero totale di utenti assegnati. 

Per ulteriori informazioni, consulta la pagina relativa alla [documentazione di riferimento dell'API *Marketplace AWS Metering Service*](https://docs.aws.amazon.com/marketplacemetering/latest/APIReference/Welcome.html).

*Per ulteriori informazioni sull'integrazione dell' AWS Marketplace Metering Service API per i prodotti basati su AMI con prezzi di misurazione personalizzati, consulta il laboratorio Elenco dei [prodotti AMI per unità personalizzate](https://catalog.workshops.aws/mpseller/en-US/ami/list-ami-custom-units) del laboratorio del venditore.Marketplace AWS *

**Topics**
+ [Requisiti](#metering-service-requirements)
+ [Chiama AWS Marketplace Metering Service](#call-aws-marketplace-metering-service)
+ [Gestione degli errori](#important-information-about-failure-handling)
+ [Limitazioni](#limitations)
+ [Esempio di codice](#ami-metering-code-example)

## Requisiti
<a name="metering-service-requirements"></a>

Tutto il software basato su AMI che utilizza il servizio di misurazione deve soddisfare i seguenti requisiti: 
+ Il software deve essere avviato Marketplace AWS tramite Amazon Machine Image (AMI). 
+ Se disponi di un prodotto esistente Marketplace AWS, devi inviare una nuova AMI e creare un nuovo prodotto per abilitare questa funzionalità. 
+ A tutto il software deve essere assegnato un ruolo AWS Identity and Access Management (IAM). Il cliente finale deve aggiungere un ruolo IAM all'istanza Amazon Elastic Compute Cloud (Amazon EC2) a cui l'utente fornisce il software. L'uso di un ruolo IAM è facoltativo quando si distribuisce il software tramite. Marketplace AWSÈ necessario quando si distribuisce il software AWS Marketplace Metering Service. 
+ Il tuo software deve essere in grado di determinare il consumo in qualche modo. 

## Chiama AWS Marketplace Metering Service
<a name="call-aws-marketplace-metering-service"></a>

 Il tuo software deve chiamare il servizio di misurazione ogni ora e registrare il valore di consumo per quell'ora. 

 All'avvio, il software dovrebbe registrare il minute-of-the-hour momento in cui è stato avviato. Questo valore è denominato *minuto di avvio*. Ogni ora del primo minuto, il software deve determinare il valore di consumo per quell'ora e chiamare il servizio di misurazione. Per informazioni su come ottenere questo valore, vedere [Modifica del software per utilizzare il servizio di misurazione](https://docs.aws.amazon.com/marketplace/latest/userguide/custom-metering-pricing-ami-products.html#modifying-your-software-to-use-the-metering-service).

 Per svegliarsi ogni ora all'inizio, il software deve utilizzare uno dei seguenti approcci: 
+  Un thread all'interno del software. 
+  Un processo demone che si avvia con l'istanza o il software. 
+  Un cron job configurato durante l'avvio dell'applicazione. 
**Nota**  
 Il tuo software deve chiamare AWS Marketplace Metering Service utilizzando il ruolo IAM configurato sull'istanza del cliente e specificare la dimensione e la quantità di consumo. 

Il tuo software può utilizzare l' AWS SDK per chiamare AWS Marketplace Metering Service, in modo simile all'implementazione di esempio seguente: 

1. Usa il profilo dell'istanza per creare un client di servizio. Ciò richiede il ruolo configurato per l'istanza EC2. Le credenziali del ruolo vengono aggiornate automaticamente dall'SDK.

1. Ogni ora, leggi la configurazione e lo stato del software per determinare i valori di consumo per quell'ora. Ciò potrebbe includere la raccolta di un value-per-dimension. 

1. Chiama il `meterUsage` metodo sul client SDK con i seguenti parametri (chiama in aggiunta per ogni dimensione che viene utilizzata): 
   + `timestamp`— Timestamp dell'ora da registrare (in UTC). 
   + `productCode`— Codice prodotto assegnato al software. 
   + `dimension`— Dimensione (o dimensioni) assegnate al software. 
   + `quantity`— Valore del consumo per ora. 
   + `allocations`— (Facoltativo) È possibile fornire allocazioni per l'utilizzo tra le proprietà monitorate. Queste allocazioni devono sommarsi al consumo totale indicato nel record. Per l'acquirente, queste vengono visualizzate come potenziali tag di allocazione dei costi nei propri strumenti di fatturazione (come la Gestione dei costi e fatturazione AWS console). L'acquirente deve attivare i tag nel proprio account per monitorare i costi utilizzando questi tag.

Inoltre, il software deve chiamare un endpoint AWS Marketplace Metering Service locale. Il prodotto deve avere una corretta configurazione regionale degli endpoint, quindi `us-east-1` invia i record a un `us-east-1` endpoint e `us-west-2` invia i record a un endpoint. `us-west-2` Effettuare chiamate all'interno della regione offre agli acquirenti un'esperienza più stabile e previene situazioni in cui la disponibilità di una regione non correlata potrebbe influire sul software in esecuzione in un'altra regione. 

Quando invii i record di misurazione al servizio, devi connetterti all'AWS Marketplace Metering Service nella tua regione. Utilizza il metodo `getCurrentRegion()` helper per determinare la regione in cui è in esecuzione l'istanza EC2, quindi trasmetti queste informazioni sulla regione al costruttore. `MeteringServiceClient` Se non specifichi un Regione AWS nel costruttore SDK, viene utilizzata la regione predefinita. `us-east-1` Se l'applicazione tenta di effettuare chiamate interregionali al servizio, le chiamate vengono rifiutate. Per ulteriori informazioni, vedere [Determinazione della regione corrente di un'applicazione](https://java.awsblog.com/post/Tx3GBOIEN1JJMQ5/Determining-an-Application-s-Current-Region) e [getCurrentRegion().](https://docs.aws.amazon.com/AWSJavaSDK/latest/javadoc/com/amazonaws/regions/Regions.html#getCurrentRegion()) 

## Gestione degli errori
<a name="important-information-about-failure-handling"></a>

Il prodotto deve inviare i dati di misurazione al servizio, un endpoint Internet pubblico, in modo che l'utilizzo possa essere registrato e fatturato. Poiché un cliente può modificare le impostazioni di rete in modo da impedire la trasmissione dei dati di misurazione, il prodotto dovrebbe tenerne conto scegliendo una modalità di errore. 

**Nota**  
Alcuni errori di misurazione possono essere problemi transitori di connessione a. AWS Marketplace Metering Service Marketplace AWS consiglia vivamente di implementare nuovi tentativi per un massimo di 30 minuti, con interruzione esponenziale, per evitare interruzioni a breve termine o problemi di rete.

In genere, il software può fallire nell'apertura (fornisce un messaggio di avviso ma mantiene la piena funzionalità) o nella chiusura (disattiva tutte le funzionalità dell'applicazione fino a quando non viene ristabilita una connessione). È possibile scegliere di fallire l'apertura, la chiusura o qualcosa di specifico dell'applicazione. Si consiglia vivamente di evitare la chiusura in caso di guasto della misurazione per meno di due ore. 

Ad esempio, in caso di mancata apertura parziale, puoi continuare a consentire l'accesso al software ma non consentire all'acquirente di modificare le impostazioni del software. In alternativa, un acquirente potrebbe comunque accedere al software ma non sarebbe in grado di creare utenti aggiuntivi. Il software è responsabile della definizione e dell'applicazione di questa modalità di errore. La modalità di errore del software deve essere inclusa al momento dell'invio dell'AMI e non può essere modificata in seguito. 

## Limitazioni
<a name="limitations"></a>

 Tieni a mente queste limitazioni quando progetti e invii il tuo software compatibile con il servizio di misurazione: 
+ **Requisiti del ruolo IAM e del gateway Internet per i vostri clienti**: i vostri clienti devono disporre di un gateway Internet e devono avviare il software con un ruolo IAM con autorizzazioni specifiche. Per ulteriori informazioni, consulta [Marketplace AWS autorizzazioni API di misurazione e autorizzazione](iam-user-policy-for-aws-marketplace-actions.md). Il software non può connettersi al servizio di misurazione se queste due condizioni non sono soddisfatte. 
+  **Impossibilità di aggiungere un prodotto nuovo o modificare la categoria di utilizzo del prodotto Metering Service esistente**: quando i clienti si abbonano al tuo prodotto software, accettano i termini e le condizioni. La modifica delle categorie di utilizzo nei prodotti con il servizio di misurazione richiede un nuovo prodotto e un nuovo abbonamento. 
+ **Impossibilità di modificare le dimensioni del prodotto Metering Service esistente**: quando i clienti si abbonano al tuo prodotto software, accettano i termini e le condizioni. La modifica delle dimensioni dei prodotti con il servizio di misurazione richiede un nuovo prodotto e un nuovo abbonamento. *Puoi* aggiungere nuove dimensioni ai prodotti esistenti, fino al limite di 24.
+  **Mancanza di versioni di prova gratuite e abbonamenti annuali**: i prodotti Metering Service non supportano le prove gratuite e gli abbonamenti annuali al momento del lancio. 
+  **Considerazioni sulla distribuzione multiistanza o basata su cluster: alcuni software vengono distribuiti** come parte di una distribuzione multiistanza. Quando progetti il software, considera come e dove viene misurato il consumo e dove vengono emessi i record di misurazione. 

## Esempio di codice
<a name="ami-metering-code-example"></a>

Il seguente esempio di codice viene fornito per aiutarti a integrare il tuo prodotto AMI con quanto Marketplace AWS APIs necessario per la pubblicazione e la manutenzione del prodotto.

### `MeterUsage`con etichettatura per l'allocazione dell'utilizzo (opzionale)
<a name="ami-meterusage-code-example"></a>

Il seguente esempio di codice è rilevante per i prodotti AMI con modelli di determinazione dei prezzi al consumo. L'esempio di Python invia un record di misurazione con i tag di allocazione dell'uso appropriati per addebitare le Marketplace AWS commissioni ai clienti. pay-as-you-go

```
# NOTE: Your application will need to aggregate usage for the 
#       customer for the hour and set the quantity as seen below. 
# Marketplace AWS can only accept records for up to an hour in the past. 
#
# productCode is supplied after the Marketplace AWS Ops team has 
# published the product to limited

# Import AWS Python SDK
import boto3
import time

usageRecord = [
    { 
        "AllocatedUsageQuantity": 2, 
        "Tags": 
            [ 
                { "Key": "BusinessUnit", "Value": "IT" },
                { "Key": "AccountId", "Value": "123456789" },
            ]

    },
    { 
        "AllocatedUsageQuantity": 1, 
        "Tags": 
            [ 
                { "Key": "BusinessUnit", "Value": "Finance" },
                { "Key": "AccountId", "Value": "987654321" },
            ]

    }
]

marketplaceClient = boto3.client("meteringmarketplace")

response = marketplaceClient.meter_usage(
    ProductCode="testProduct",
    Timestamp=int(time.time()),
    UsageDimension="Dimension1",
    UsageQuantity=3,
    DryRun=False,
    UsageAllocations=usageRecord 
)
```

Per ulteriori informazioni [MeterUsage](https://docs.aws.amazon.com/marketplacemetering/latest/APIReference/API_MeterUsage.html)in merito`MeterUsage`, consulta la sezione *Marketplace AWS Metering* Service API Reference.

### Esempio di risposta
<a name="ami-meterusage-code-response"></a>

```
{ "MeteringRecordId": "string" }
```

# Prezzi contrattuali per i prodotti AMI su Marketplace AWS
<a name="ami-contracts"></a>

I prezzi contrattuali per i prodotti basati su Amazon Machine Image (AMI) indicano che l'acquirente paga una commissione anticipata per un singolo prodotto AMI o una singola AMI con AWS CloudFormation stack. Per i prodotti basati su AMI con prezzi contrattuali, Marketplace AWS fattura i clienti in anticipo o in base al piano di pagamento da te definito, in base al contratto tra te e il cliente. Dopo quel punto, hanno il diritto di utilizzare tali risorse. Questo argomento fornisce ulteriori informazioni sui prezzi contrattuali.

Per impostare i prezzi, scegli una o più durate contrattuali che offri ai clienti. Puoi inserire prezzi diversi per ogni durata del contratto. Le opzioni disponibili sono durate di 1 mese, 12 mesi, 24 mesi e 36 mesi. Per le offerte private, puoi specificare una durata personalizzata in mesi (fino a 60 mesi). 

**Nota**  
Le prove gratuite non sono disponibili per i prodotti AMI con prezzi contrattuali.

Scegli la categoria che meglio descrive il prezzo del tuo prodotto. La categoria di prezzo viene visualizzata dai clienti sul Marketplace AWS sito web. **Puoi scegliere tra **larghezza di banda** (GB/s, MB/s), **dati** (GB, MB, TB), **host**, **richieste**, **livelli** o utenti.** **Se nessuna delle categorie predefinite soddisfa le tue esigenze, puoi scegliere la categoria più generica di Unità.** 

L'offerta consente di aggiungere fino a 24 dimensioni. Ogni dimensione richiede i seguenti dati:
+ **Categoria di contratti**: per i prodotti contrattuali senza prezzi basati sul consumo, puoi scegliere una categoria che si avvicina di più alla categoria di dimensione del contratto o scegliere **Unità se nessun valore assomiglia alle unità** per la dimensione del contratto
+ **Unità Contratti**: scegli uno dei valori disponibili per le unità che più si avvicina alle tue dimensioni in base alla categoria selezionata.
+ **Dimensione Contratti: consente acquisti multipli**: questo campo viene utilizzato per indicare se un'offerta è un'offerta con prezzi a più livelli o un'offerta non a più livelli: 

  Offerta a più livelli: consente all'acquirente di abbonarsi solo a una delle dimensioni disponibili nell'offerta. Le dimensioni in un'offerta a più livelli non hanno il concetto di quantità. La firma di un contratto con una dimensione specifica indica essenzialmente che l'acquirente ha scelto la caratteristica specifica indicata da quella dimensione.

  Offerta non differenziata: consente al cliente di acquistare più di una dimensione come parte del contratto e di acquistare più unità per ciascuna di tali dimensioni.

  L'impostazione di un valore *true* per questo campo indica che l'offerta non è suddivisa in più livelli. L'impostazione di un valore *false* per questo campo indica che l'offerta è un'offerta a più livelli.

Quando utilizzi il Product Load Form (PLF) per creare i contratti per il tuo prodotto AMI, devi definire i seguenti campi per le dimensioni dei prezzi:
+  **Nome API DimensionX di Contracts**: il nome che deve apparire nella licenza generata nell'account dell' AWS License Manager acquirente. Questo nome viene utilizzato anche come valore di `Name` in `Entitlement` nella chiamata `Checkoutlicense` API.
+  **Contracts DimensionX Display Name**: il nome della dimensione rivolto ai clienti che verrà visualizzato nelle pagine di dettaglio del prodotto e di approvvigionamento del sito Web. Marketplace AWS Crea un nome che sia facile da usare. La lunghezza massima del nome è di 24 caratteri. Dopo che l'elenco è pubblico, il valore di non `Name` può essere modificato.
+  **Descrizione DimensionX dei contratti**: la descrizione rivolta al cliente di una dimensione che fornisce informazioni aggiuntive sulla dimensione del prodotto, ad esempio le funzionalità offerte dalla dimensione specifica. La lunghezza massima per la descrizione è di 70 caratteri.
+  **Contratti DimensionX Quantity**: viene utilizzato per calcolare la ripartizione in caso di modifiche dell'accordo a un prodotto. Questo valore di questo campo deve essere impostato su 1 per tutte le offerte contrattuali. Non deve essere modificato. 
+  **Dimensione dei contratti X **Tariffa mensile: la tariffa**** contrattuale da addebitare per un mese di diritti relativi a questa dimensione. Per le offerte non differenziate, questa tariffa viene addebitata per ogni unità della dimensione acquistata. Questo campo supporta tre cifre decimali.
+  **Dimensione dei contratti X Tariffa a **12 mesi: la tariffa**** contrattuale da addebitare per 12 mesi di diritti relativi alla dimensione. Per le offerte non differenziate, questa tariffa viene addebitata per ogni unità della dimensione acquistata. Questo campo supporta tre cifre decimali. 
+  Tariffa **contrattuale DimensionX a **24 mesi: la tariffa**** contrattuale da addebitare per 24 mesi di diritti relativi alla dimensione. Per le offerte non differenziate, questa tariffa viene addebitata per ogni unità della dimensione acquistata. Questo campo supporta tre cifre decimali.
+  Tariffa **contrattuale DimensionX **a 36 mesi: la tariffa**** contrattuale da addebitare per 36 mesi di diritti relativi alla dimensione. Per le offerte non differenziate, questa tariffa viene addebitata per ogni unità della dimensione acquistata. Questo campo supporta tre cifre decimali.


**Esempio: applicazione di archiviazione dati**  

|   | Prezzo per 1 mese | Prezzo per 12 mesi  | Prezzo per 24 mesi  | Prezzo per 36 mesi  | 
| --- | --- | --- | --- | --- | 
| Dati non crittografati (GB)  |  1,50 USD/GB  |  \$116,00/GB  |  \$130,00/GB  |  \$160,00/GB  | 
| Dati crittografati (GB)  |  1,55 USD/GB  |  \$116,60/GB  |  \$131,20/GB  |  \$161,20/GB  | 


**Esempio: prodotto per il monitoraggio dei log**  

|   | Prezzo per 1 mese | Prezzo per 12 mesi  | Prezzo per 24 mesi | Prezzo per 36 mesi | 
| --- | --- | --- | --- | --- | 
| Base (10 host monitorati, 5 container monitorati)  |  \$1100  |  \$11000  | 2000 dollari  | 4000 dollari | 
| Standard (20 host monitorati, 10 container monitorati)  |  \$1200  |  2000\$1  | 4000 dollari  | 8000 dollari | 
| Pro (40 host monitorati, 20 container monitorati)  |  400 dollari  |  4000 dollari  | 8000 dollari  | 16.000\$1 | 
| Host aggiuntivi monitorati ogni ora  | \$110  | \$1100  |  \$1200 | 400 dollari | 
| Contenitori aggiuntivi monitorati ogni ora  | \$110  | \$1100  |  \$1200 | 400 dollari | 

**Nota**  
I prezzi possono essere per le seguenti durate: 1 mese, 12 mesi, 24 mesi o 36 mesi. Puoi scegliere di offrire una o più di queste opzioni per il tuo prodotto. Le durate devono essere le stesse in ogni dimensione.   

**Example**  
Ad esempio, nel caso in cui tu abbia `ReadOnlyUsers` delle `AdminUsers` dimensioni, se offri un prezzo annuale per ReadOnlyUsers, devi offrire anche un prezzo annuale per`AdminUsers`.

## Rinnovi automatici
<a name="ami-contracts-automatic-renewals"></a>

 Quando i clienti acquistano il tuo prodotto Marketplace AWS tramite contratti AMI, possono accettare di rinnovare automaticamente i termini del contratto. I clienti continuano a pagare i diritti ogni mese o per 1, 2 o 3 anni. 

I clienti possono modificare le impostazioni di rinnovo in qualsiasi momento. Per ulteriori informazioni, consulta [Modifica di un contratto esistente](https://docs.aws.amazon.com/marketplace/latest/buyerguide/buyer-ami-contracts.html#modify-existing-contract) nella *Guida all'Marketplace AWS acquisto*.

# Associazione di licenze a prodotti basati su AMI utilizzando AWS License Manager
<a name="ami-license-manager-integration"></a>

Per i prodotti basati su Amazon Machine Image (AMI) con prezzi contrattuali, puoi utilizzare AWS License Manager per associare le licenze al tuo prodotto. AWS License Manager è uno strumento di gestione delle licenze che consente all'applicazione di tenere traccia e aggiornare le licenze (note anche come autorizzazioni) acquistate da un cliente. Una volta completata l'integrazione, puoi pubblicare l'elenco dei tuoi prodotti su. Marketplace AWS Le seguenti sezioni forniscono ulteriori informazioni sull'utilizzo AWS License Manager per associare le licenze al prodotto basato su AMI.

*Per ulteriori informazioni in merito AWS License Manager, consulta la [Guida per l'AWS License Manager utente](https://docs.aws.amazon.com/license-manager/latest/userguide/license-manager.html) e la [AWS License Manager](https://docs.aws.amazon.com/cli/latest/reference/license-manager/index.html)sezione Command Reference.AWS CLI *

*Per ulteriori informazioni sull'integrazione AWS License Manager con prodotti basati su AMI con prezzi contrattuali, consulta l'Elenco dei prezzi dei [prodotti AMI secondo il laboratorio di pagamento anticipato](https://catalog.workshops.aws/mpseller/en-US/ami/list-ami-upfront-payment) del Seller Workshop.Marketplace AWS *

**Nota**  
I clienti non possono lanciare nuove istanze dell'AMI dopo il periodo di scadenza del contratto. Tuttavia, durante la durata del contratto, possono avviare un numero qualsiasi di istanze. Queste licenze non sono bloccate su nodi o legate a istanze particolari.
**Creazione di offerte private**: i venditori possono generare offerte private per i prodotti utilizzando lo strumento di creazione di offerte private disponibile in. Portale di gestione Marketplace AWS
**Reporting**: puoi configurare i feed di dati configurando un bucket Amazon S3 nella sezione Report **del**. Portale di gestione Marketplace AWS Per ulteriori informazioni, consulta [Report, feed di dati e dashboard per i venditori in Marketplace AWS](reports-and-data-feed.md).

**Topics**
+ [Modelli di licenza](#license-models)
+ [Workflow di integrazione](#LM-workflow)
+ [Prerequisiti per l'integrazione con License Manager](#LM-prereqs)
+ [Integrazione di un prodotto basato su AMI con AWS License Manager](#integrate-with-LM)
+ [Rinnovi e aggiornamenti delle licenze](#lic-renew-upgrade)

## Modelli di licenza
<a name="license-models"></a>

Marketplace AWS integrazione con AWS License Manager supporta due modelli di licenza:
+ [Modello di licenza configurabile](#config-lic-model)
+ [Modello di licenza a più livelli](#tiered-lic-model)

### Modello di licenza configurabile
<a name="config-lic-model"></a>

Il modello di licenza configurabile (noto anche come modello di licenza quantificabile) dà diritto a un acquirente a una quantità specifica di risorse dopo che l'acquirente si è procurato una licenza. 

Hai impostato una dimensione di prezzo e un prezzo unitario. L'acquirente può quindi scegliere la quantità di risorse che desidera acquistare.

**Example della dimensione dei prezzi e del prezzo unitario**  
Puoi impostare una dimensione di prezzo (come il backup dei dati) e un prezzo unitario (ad esempio 30 USD per unità)  
L'acquirente può scegliere di acquistare 5, 10 o 20 unità.   
Il prodotto monitora e misura l'utilizzo per misurare la quantità di risorse consumate.

Con il modello di configurazione, i diritti vengono conteggiati in due modi:
+ [Licenze Drawdown](#drawndown-lic)
+ [Licenze fluttuanti](#floating-lic) 

#### Licenze Drawdown
<a name="drawndown-lic"></a>

 La licenza viene estratta dal pool di licenze consentite al momento dell'uso. Tale autorizzazione viene verificata in modo permanente e non può essere restituita al pool di licenze.

**Example di elaborare una quantità limitata di dati**  
Un utente ha il diritto di elaborare 500 GB di dati. Man mano che continuano a elaborare i dati, la quantità viene prelevata dal pool di 500 GB fino a esaurire tutte le licenze da 500 GB.

Per le licenze drawdown, è possibile utilizzare l'operazione `CheckoutLicense` API per verificare le unità di licenza utilizzate. 

**Example di backup su Amazon S3 per un certo numero di unità/anno**  
Hai un prodotto di storage che consente il backup su Amazon Simple Storage Service per un massimo di 1024 unità di dati per un anno. L'applicazione può essere avviata utilizzando più istanze Amazon EC2. L'applicazione dispone di un meccanismo per tracciare e aggregare i dati. Il software richiama il funzionamento dell'`CheckoutLicense`API con l'ID del prodotto a ogni backup o a intervalli fissi per aggiornare le quantità consumate.   
In questo esempio, il software chiama `CheckoutLicense` per effettuare il check-out di 10 unità di dati. Quando la capacità totale raggiunge il limite di backup acquistato dal cliente, la chiamata API fallisce.

**Richiesta**

```
linux-machine ~]$ aws license-manager checkout-license\
--product-sku "2205b290-19e6-4c76-9eea-377d6bf7la47" \
--checkout-type "PERPETUAL" \
--key-fingerprint "aws:294406891311:AWS/Marketplace:issuer-fingerprint" \
--entitlements "Name=DataConsumption, Value=l0, Unit=Count" \
--client-token "AKIAIOSFODNN7EXAMPLE"
```

**Risposta**

```
{
  "CheckoutType": "PERPETUAL",
  "EntitlementsAllowed": [
    {      
      "Name": "DataConsumption", 
      "Count": 10,
      "Units": "Count",
      "Value": "Enabled"
    }
},
  "Expiration":    "2021-04-22Tl9:02: 36",
  "IssuedAt": "2021-04-22Tl8:02:36",
  "LicenseArn": "arn:aws:license-manager::294406891311:license:l-16bf01b...",
  "LicenseConsumptionToken":  "AKIAIOSFODNN7EXAMPLE"
}
```

#### Licenze fluttuanti
<a name="floating-lic"></a>

 La licenza viene restituita al pool del numero consentito di licenze dopo l'uso.

**Example del numero di utenti a partire da un limite massimo fisso**  
Un utente ha diritto a 500 utenti simultanei sull'applicazione. Quando gli utenti accedono e si disconnettono, gli utenti vengono estratti e restituiti al pool di 500 utenti. Tuttavia, l'applicazione non può attirare più di 500 utenti dal pool perché 500 utenti simultanei è il limite massimo fisso.

Per le licenze flottanti, è possibile utilizzare l'operazione `CheckInLicense` API per restituire le unità di licenza al pool di autorizzazioni. 

**Example del numero di utenti simultanei per un anno**  
Il prezzo del prodotto è basato sul numero di utenti simultanei. Il cliente acquista una licenza per 10 utenti per un anno. Il cliente avvia il software fornendo le autorizzazioni AWS Identity and Access Management (IAM). Quando un utente effettua l'accesso, l'applicazione richiama l'operazione `CheckoutLicense` API per ridurre la quantità di 1. Quando l'utente si disconnette, l'applicazione restituisce la licenza al pool chiamando l'operazione `CheckInLicense` API. Se non chiami`CheckInLicense`, l'unità di licenza verrà automaticamente registrata dopo 1 ora.

**Nota**  
Nella richiesta seguente, `key-fingerprint` non è un valore segnaposto ma il valore effettivo dell'impronta digitale con cui verranno pubblicate tutte le licenze.

**Richiesta**

```
linux-machine ~]$ aws license-manager checkout-license\
--product-sku "2205b290-19e6-4c76-9eea-377d6bf7la47" \
--checkout-type "PROVISIONAL" \
--key-fingerprint "aws:294406891311:AWS/Marketplace:issuer-fingerprint" \
--entitlements "Name=ReadOnlyUSers, Value=l0, Unit=Count" \
--client-token "AKIAIOSFODNN7EXAMPLE"
```

**Risposta**

```
{
  "CheckoutType": "PROVISIONAL",
  "EntitlementsAllowed": [
    {
      "Name": "ReadOnlyUsers", 
      "Count": 10,
      "Units": "Count",
      "Value": "Enabled"
    }
},
  "Expiration": "2021-04-22Tl9:02: 36",
  "IssuedAt": "2021-04-22Tl8:02:36",
  "LicenseArn": "arn:aws:license-manager::294406891311:license:l-16bf01b...",
  "LicenseConsumptionToken": "AKIAIOSFODNN7EXAMPLE"
}
```

### Modello di licenza a più livelli
<a name="tiered-lic-model"></a>

Il modello di licenza a più livelli dà diritto a un acquirente a un livello o livello specifico di funzionalità dell'applicazione dopo che l'acquirente ha acquistato una licenza. 

Puoi creare livelli per il tuo prodotto, come Basic, Intermediate e Premium. L'acquirente seleziona quindi uno dei livelli predefiniti.

L'applicazione non ha bisogno di tracciare o misurare l'utilizzo dell'applicazione.

Con il modello di licenza a più livelli, i diritti non vengono conteggiati, ma indicano invece un livello di servizio acquistato dal cliente. 

Se desideri offrire insieme funzionalità in bundle, ti consigliamo di utilizzare il modello di licenza a più livelli. 

**Example dei livelli Basic, Intermediate e Premium**  
Un cliente può firmare un contratto per uno dei tre possibili livelli del software: Basic, Intermediate o Premium. Ciascuno di questi livelli ha i propri prezzi. Il software è in grado di identificare il livello a cui il cliente si è registrato richiamando l'operazione `CheckoutLicense` API e specificando tutti i livelli possibili nella richiesta.   
La risposta alla richiesta contiene l'autorizzazione corrispondente al livello acquistato dal cliente. Sulla base di queste informazioni, il software può fornire l'esperienza appropriata al cliente.

#### Richiesta
<a name="tiered-request"></a>

```
linux-machine  ~]$ aws  license-manager   checkout-license\
--product-sku  "2205b290-19e6-4c76-9eea-377d6bf7la47"  \
--checkout-type  "PROVISIONAL"  \
--key-fingerprint  "aws:294406891311:AWS/Marketplace:issuer-fingerprint" \
--entitlements  "Name=BasicTier,  Unit=None"   "Name=IntermediateTier,  Unit=None"	\ "Name=PremiumTier, Unit=None"
```

#### Risposta
<a name="tiered-response"></a>

```
{ 
  "CheckoutType": "PROVISIONAL",
  "EntitlementsAllowed": [
    {
      "Name": "IntermediateTier", 
      "Units": "None"
    }
},
  "Expiration": "2021-04-22Tl9:02:36",
  "IssuedAt": "2021-04-22Tl8:02:36",
  "LicenseArn": "arn:aws:license-manager::294406891311:license:l-16bf01b...",
  "LicenseConsumptionToken": "AKIAIOSFODNN7EXAMPLE"
}
```

## Workflow di integrazione
<a name="LM-workflow"></a>

I passaggi seguenti mostrano il flusso di lavoro per l'integrazione del prodotto AMI con AWS License Manager:

1. Il venditore crea un prodotto con AWS License Manager integrazione.

1. Il venditore mette in vendita il prodotto su Marketplace AWS.

1. L'acquirente trova il prodotto Marketplace AWS e lo acquista.

1. Una licenza viene inviata all'acquirente nel suo Account AWS.

1. L'acquirente utilizza il software avviando l'istanza Amazon Elastic Compute Cloud (Amazon EC2), il task Amazon Elastic Container Service (Amazon ECS) o il software pod Amazon Elastic Kubernetes Service (Amazon EKS). Il cliente esegue la distribuzione utilizzando un ruolo IAM.

1. Il software legge la licenza nell' AWS License Manager account dell'acquirente, scopre i diritti acquistati e fornisce le funzionalità di conseguenza. 
**Nota**  
License Manager non effettua alcun tracciamento o aggiornamento; questo viene fatto dall'applicazione del venditore.

## Prerequisiti per l'integrazione con License Manager
<a name="LM-prereqs"></a>

Prima di pubblicare il prodotto, è necessario effettuare le seguenti operazioni:

1. Crea un nuovo prodotto AMI in e prendi nota del relativo codice prodotto. Portale di gestione Marketplace AWS

1. Compila il Product Load Form (PLF) con le informazioni necessarie sul prezzo e inviacelo per l'elaborazione.

1. Utilizza un ruolo IAM per l'attività o il pod che esegue l'applicazione con le autorizzazioni IAM necessarie per chiamare `CheckoutLicense``ExtendLicenseConsumption`, e. `CheckInLicense`

   Le autorizzazioni IAM richieste sono dettagliate nella seguente politica IAM.

------
#### [ JSON ]

****  

   ```
   {
      "Version":"2012-10-17",		 	 	 
      "Statement":[
         {
            "Sid":"VisualEditorO",
            "Effect":"Allow",
            "Action":[
               "license-manager:CheckoutLicense",
               "license-manager:GetLicense",
               "license-manager:CheckInLicense",
               "license-manager:ExtendLicenseConsumption",
               "license-manager:ListReceivedLicenses"
            ],
            "Resource":"*"
         }
      ]
   }
   ```

------

1. Effettua una chiamata di prova all'operazione `RegisterUsage` API con un record per tutte le dimensioni di prezzo che definisci.

## Integrazione di un prodotto basato su AMI con AWS License Manager
<a name="integrate-with-LM"></a>

Puoi integrare il tuo prodotto basato su AMI con License Manager utilizzando l'[AWS License Manager](https://docs.aws.amazon.com/license-manager/latest/APIReference/Welcome.html)API. Avvia le istanze Amazon EC2 utilizzando Marketplace AWS prodotti basati su AMI. 

**Nota**  
Assicurati di aver completato [Prerequisiti per l'integrazione con License Manager](#LM-prereqs) prima di eseguire la seguente procedura. 

**Per integrare il prodotto basato su AMI con License Manager**

1. Completare la procedura [Creazione di una licenza di prova in License Manager](#creating-test-license). È necessario creare una licenza di prova in License Manager per testare l'integrazione.

1. Esegui l'operazione [GetLicense](https://docs.aws.amazon.com/license-manager/latest/APIReference/API_GetLicense.html)API utilizzando la licenza Amazon Resource Name (ARN) ottenuta nella fase 1. Annota il valore dell'`KeyFingerprint`attributo della `GetLicense` risposta per un uso successivo. 

1. Scarica e includi l' AWS SDK pubblico più recente nella tua applicazione. 

1. Per verificare che l'acquirente sia autorizzato a utilizzare una licenza per la tua applicazione, esegui l'operazione [CheckoutLicense](https://docs.aws.amazon.com/license-manager/latest/APIReference/API_CheckoutLicense.html)API. Utilizza i dettagli relativi ai diritti e l'impronta digitale chiave della licenza di prova che hai ottenuto nella fase 1. 

   Se non vengono trovati diritti per la licenza o se viene superato il numero massimo di autorizzazioni, viene ripristinata l'operazione API. `CheckoutLicense` `NoEntitlementsAllowedException` Se i permessi sono validi o disponibili per l'uso, l'`CheckoutLicense`operazione restituisce una risposta corretta con i permessi richiesti e i relativi valori.

1. (Obbligatorio solo per i permessi fluttuanti) Esegui l'operazione [CheckinLicense](https://docs.aws.amazon.com/license-manager/latest/APIReference/API_CheckInLicense.html)API utilizzando quella ricevuta nella `LicenseConsumptionToken` risposta. `CheckoutLicense` Questa azione rilascia le autorizzazioni precedentemente ritirate nel pool di autorizzazioni disponibili.

1. Dopo aver verificato con successo l'integrazione del License Manager con la licenza di prova creata nel passaggio 1, aggiorna l'impronta digitale della chiave nel codice a`aws:294406891311:AWS/Marketplace:issuer-fingerprint`. Ora sei pronto per lavorare con le licenze rilasciate da. Marketplace AWS

Segui la procedura di rilascio per creare l'applicazione su un prodotto AMI, quindi invia il prodotto a Marketplace AWS seguire la procedura di pubblicazione del prodotto.

### Creazione di una licenza di prova in License Manager
<a name="creating-test-license"></a>

Si utilizza la versione 2 di AWS Command Line Interface (AWS CLI) per creare una licenza di prova in AWS License Manager. Questa licenza di prova viene utilizzata solo per verificare e testare l' AWS License Manager integrazione. Una volta completato il test, puoi eliminare la licenza di prova. La licenza effettiva viene generata Marketplace AWS con un'impronta digitale della chiave diversa.

Marketplace AWS supporta due tipi di diritti in. AWS License Manager Tuttavia, è possibile abilitare solo un tipo per prodotto. Quando si crea una licenza, inclusa una licenza di prova, è necessario specificare uno dei seguenti tipi di diritti: 

**Autorizzazioni a più livelli**: il modello di licenza a più livelli dà diritto al cliente a determinate funzionalità dell'applicazione. I clienti non possono definire la quantità di unità che desiderano acquistare. Tuttavia, possono selezionare un singolo pacchetto o livello predefinito. I clienti possono modificare il contratto in un secondo momento per abbonarsi a un altro livello.

**Autorizzazioni configurabili**: il modello di licenza configurabile concede i diritti a una determinata quantità di risorse quando il cliente acquista una licenza. Il cliente sceglie la quantità di unità che desidera acquistare durante il processo di abbonamento e verrà fatturata in base al prezzo unitario. I clienti possono anche abbonarsi a più dimensioni.

I parametri richiesti per l'utilizzo nel funzionamento dell'`CheckoutLicense`API sono i seguenti:
+ `CheckoutType`— I valori validi sono `Perpetual` o`Provisional`:
  + `Perpetual`— Utilizzato quando la quantità di diritti ritirati dal pool sarà esaurita. Esempio: l'acquirente ha il diritto di elaborare 500 GB di dati. Man mano che continuano a elaborare i dati, la quantità viene prelevata ed esaurita dal pool di 500 GB. Visualizza lo stato di una licenza acquistata indicando se la licenza è scaduta o sta per scadere per inviare una notifica al cliente.
  + `Provisional`— Utilizzato per i diritti di licenza fluttuanti, in cui i permessi vengono estratti dal pool e restituiti dopo l'uso. Esempio: l'utente ha diritto a 500 utenti simultanei nell'applicazione. Quando gli utenti accedono e si disconnettono, gli utenti vengono estratti e restituiti al pool di 500 utenti. Per ulteriori informazioni sui diritti di licenza flottanti, consulta Licenze [rilasciate dal venditore in License Manager](https://docs.aws.amazon.com/license-manager/latest/userguide/seller-issued-licenses.html). AWS 
+ `ClientToken`— Identificatore univoco con distinzione tra maiuscole e minuscole per garantire che il risultato esatto sia lo stesso indipendentemente dal numero di tentativi. Si consiglia di utilizzare un identificatore univoco universale (UUID) casuale per ogni richiesta.
+ `Entitlements`— Elenco dei diritti da verificare.
  + Per i diritti a più livelli, fornisci `Name` le seguenti proprietà: `Unit`

    `{`

    `"Name": "<Entitlement_Name>",`

    `"Unit": "None"`

    `}`
  + Per i permessi configurabili, fornisci e proprietà come segue`Name`: `Unit` `Value`

    `{`

    `"Name": "<Entitlement_Name>",`

    `"Unit": "<Entitlement_Unit>",`

    `"Value": <Desired_Count>{`

    \$1
+ `KeyFingerprint`— Utilizza questa impronta digitale chiave per verificare che la licenza sia stata rilasciata da. Marketplace AWS L'impronta digitale chiave per le licenze rilasciate da Marketplace AWS è la seguente:

  `aws:294406891311:AWS/Marketplace:issuer-fingerprint`
+ `Product SKU`— ID del prodotto con un formato GUID (Globally Unique Identifier) associato a un prodotto. Marketplace AWS 

**Example di un'autorizzazione configurabile**  
Di seguito è riportato un esempio di richiesta che utilizza l'operazione `CheckoutLicense` API per estrarre un'autorizzazione configurabile denominata. `PowerUsers`  

```
aws license-manager checkout-license \
   product-sku "2205b290-19e6-4c76-9eea-377d6bf71a47" \
   checkout-type "PROVISIONAL" \
   client-token "79464194dca9429698cc774587a603a1" \"Statement":[
   entitlements "Name=PowerUsers,Value=1,Unit=Count" \ 
   key-fingerprint "aws:294406891311:AWS/Marketplace:issuer-fingerprint"
```

**Example di un'autorizzazione a più livelli**  
Di seguito è riportato un esempio di richiesta che utilizza l'operazione `CheckoutLicense` API per il check-out di un'autorizzazione alla funzionalità denominata. `EnterpriseEdition`  

```
aws license-manager checkout-license \
   --product-sku "2205b290-19e6-4c76-9eea-377d6bf71a47" \
   --checkout-type "PROVISIONAL" \
   --client-token "79464194dca9429698cc774587a603a1" \
   --entitlements "Name=EnterpriseEdition,Unit=None" \
   --key-fingerprint "aws:294406891311:AWS/Marketplace:issuer-fingerprint"
```

**Per creare una licenza di prova per il tuo prodotto basato su AMI**

1. Dall'ambiente locale con la versione AWS CLI 2 installata, esegui lo script seguente. Lo script crea la licenza di prova e configura i dettagli appropriati del prodotto.
**Nota**  
Utilizzate un test Account AWS diverso da quello Account AWS in cui state distribuendo e testando il software. Le licenze non possono essere create, concesse e ritirate nello stesso momento. Account AWS

   ```
   #!/bin/bash
   
   # Replace with intended product ID on Marketplace AWS
   PRODUCT_ID=<REPLACE-WITH-PRODUCT-ID>
   
   # Replace with license recipient's AWS Account ID
   BENEFICIARY_ACCOUNT_ID=<REPLACE-WITH-BENEFICIARY-ACCOUNT-ID>
   
   # Replace with your product's name
   PRODUCT_NAME="Test Product"
   
   # Replace with your seller name on Marketplace AWS
   SELLER_OF_RECORD="Test Seller" 
   
   # Replace with intended license name
   LICENSE_NAME="AWSMP Test License"
   
   # Replace the following with desired contract dimensions
   # More info here: https://docs.aws.amazon.com/license-manager/latest/APIReference/API_Entitlement.html
   # Example "configurable entitlement"
   ENTITLEMENTS='[
     {
       "Name": "ReadOnly",
       "MaxCount": 5,
       "Overage": false,
       "Unit": "Count",
       "AllowCheckIn": true
     }
   ]'
   # Example "tiered entitlement"
   # ENTITLEMENTS='[
   #   {
   #     "Name": "EnterpriseUsage", 
   #     "Value": "Enabled",
   #     "Unit": "None"
   #   }
   # ]'
   
   # Format "yyyy-mm-ddTHH:mm:ss.SSSZ"
   # This creates a validity period of 10 days starting the current day
   # Can be updated to desired dates
   VALIDITY_START=$(date +%Y-%m-%dT%H:%M:%S.%SZ)
   VALIDITY_END=$(date --date="+10 days" +%Y-%m-%dT%H:%M:%S.%SZ)
   
   # Configuration for consumption of the license as set on Marketplace products
   CONSUMPTION_CONFIG='{
    "RenewType": "None",
    "ProvisionalConfiguration": {
      "MaxTimeToLiveInMinutes": 60
    }
   }'
   
   # License's home Region
   HOME_REGION=us-east-1
   
   # License issuer's name
   ISSUER=Self  
   
   # Run AWS CLI command to create a license
   aws license-manager create-license \
     --license-name "${LICENSE_NAME}" \
     --product-name "${PRODUCT_NAME}" \
     --product-sku "${PRODUCT_ID}" \
     --issuer Name="${ISSUER}" \
     --beneficiary "${BENEFICIARY_ACCOUNT_ID}" \
     --validity 'Begin="'"${VALIDITY_START}"'",End="'"${VALIDITY_END}"'"' \
     --entitlements "${ENTITLEMENTS}" \
     --home-region "${HOME_REGION}" \
     --region "${HOME_REGION}" \
     --consumption-configuration "${CONSUMPTION_CONFIG}" \
     --client-token $(uuidgen)
   ```

1. Concedi la licenza utilizzando la AWS License Manager console. Per ulteriori informazioni, consulta [Distribuire un diritto](https://docs.aws.amazon.com/license-manager/latest/userguide/granted-licenses.html#distribute-entitlement.) nella *License Manager User* Guide.

1. Accedi all'account Account AWS che funge da account acquirente dove distribuirai e testerai il tuo software. Deve essere diverso Account AWS da Account AWS quello creato e concesso dalla licenza.

1. Vai alla AWS License Manager console per accettare e attivare le licenze concesse. Per ulteriori informazioni, consulta [la sezione Gestione delle licenze concesse](https://docs.aws.amazon.com/license-manager/latest/userguide/granted-licenses.html#manage-granted-licenses) nella *License Manager User Guide*.

1. Esegui il comando seguente nel tuo ambiente.

   ```
   # The following example uses a key fingerprint that should match the test license you created.
   # When checking out an actual Marketplace AWS created license, use the following fingerprint:
   # aws:294406891311:AWS/Marketplace:issuer-fingerprint
   aws license-manager checkout-license \
     --product-sku <REPLACE-WITH-PRODUCT-ID> \
     --checkout-type PROVISIONAL \
     --key-fingerprint "aws:<ACCOUNT-ID-WHERE-YOU-CREATED-TEST-LICENSE>:Self:issuer-fingerprint" \
     --entitlements "Name=ReadOnly,Value=1,Unit=Count" \
     --client-token $(uuidgen)
   ```

   Il comando precedente utilizza `PROVISIONAL` come valore per il `CheckoutType` parametro. Se l'autorizzazione utilizza una licenza drawdown, utilizzala `PERPETUAL` per il valore.

### Chiamate API License Manager
<a name="LM-API-calls"></a>

Per gestire le licenze archiviate nell'account License Manager del cliente, il software può utilizzare le seguenti chiamate API:
+ `GetLicense`— Indica lo stato di una licenza acquistata indicando se la licenza è scaduta o sta per scadere, per inviare una notifica al cliente.
+ `CheckoutLicense`— Rileva le licenze acquistate dall'utente. È inoltre possibile utilizzarlo per aggiornare la quantità di licenze quando l'utente ha consumato una certa quantità di licenze. Con`CheckoutLicense`, puoi continuare a controllare le quantità di licenze utilizzate dal cliente. Quando il cliente esaurisce tutte le licenze, questa chiamata restituisce un errore. Per informazioni sulla cadenza di esecuzione consigliata, consulta. `CheckoutLicense` [Rinnovi e aggiornamenti delle licenze](#lic-renew-upgrade) 
+ `ExtendLicenseConsumption`— In caso di dimensioni variabili, quando il software estrae una licenza, la restituisce automaticamente al pool dopo 60 minuti. Se si desidera prolungare il periodo di check-out della licenza, il software può chiamare per `ExtendLicenseConsumption` estendere la licenza per altri 60 minuti.
+ `CheckInLicense`— In caso di dimensioni variabili, quando si desidera restituire la licenza al pool di diritti, utilizzare. `CheckInLicense`
+ `ListReceivedLicenses`— Elenca le licenze acquistate dall'acquirente.

## Rinnovi e aggiornamenti delle licenze
<a name="lic-renew-upgrade"></a>

I clienti possono rinnovare o aggiornare le proprie licenze su. Portale di gestione Marketplace AWS Dopo aver effettuato un acquisto aggiuntivo, Marketplace AWS genera una nuova versione della licenza che riflette i nuovi diritti. Il software legge le nuove autorizzazioni utilizzando le stesse chiamate API. Non è necessario fare nulla di diverso in termini di integrazione del License Manager per gestire i rinnovi e gli aggiornamenti.

A causa di rinnovi di licenza, upgrade, annullamenti e così via, consigliamo che il prodotto esegua la chiamata `CheckoutLicense` API a cadenza regolare mentre il prodotto è in uso. Utilizzando il funzionamento dell'`CheckoutLicense`API a cadenza regolare, il prodotto è in grado di rilevare cambiamenti nelle autorizzazioni, ad esempio aggiornamenti e scadenze.

Ti consigliamo di eseguire la chiamata `CheckoutLicense` API ogni 15 minuti. 

# Ricezione di notifiche Amazon SNS per prodotti AMI su Marketplace AWS
<a name="ami-notification"></a>

Per ricevere notifiche sulle modifiche agli abbonamenti dei clienti per i tuoi prodotti, puoi abbonarti agli argomenti di Amazon Simple Notification Service (Amazon SNS) Marketplace AWS forniti durante la creazione del prodotto. Ad esempio, puoi sapere quando i clienti accettano un'offerta privata. [Argomento di Amazon SNS: aws-mp-subscription-notification](#ami-sns-subscription-message-body)è un argomento di Amazon SNS disponibile per i prodotti AMI. Questo argomento ti avvisa quando un acquirente sottoscrive o annulla l'abbonamento a un prodotto. Questa notifica è disponibile per i modelli di tariffazione oraria, inclusi quelli su base oraria e oraria con tariffa annuale. Per ulteriori informazioni, consultare le sezioni indicate di seguito.

**Nota**  
Durante il processo di creazione del prodotto, viene creato un argomento Amazon SNS per il prodotto. Per sottoscrivere le notifiche, è necessario l'Amazon Resource Name (ARN) dell'argomento Amazon SNS (ad esempio,). `arn:aws:sns:us-east-1:123456789012:aws-mp-subscription-notification-PRODUCTCODE` L'ARN non è disponibile nel portale dei venditori per i prodotti server. Contatta il [team Marketplace AWS operativo](https://aws.amazon.com/marketplace/management/contact-us) per richiedere l'ARN.

**Topics**
+ [Argomento di Amazon SNS: aws-mp-subscription-notification](#ami-sns-subscription-message-body)
+ [Sottoscrizione di una coda Amazon SQS all'argomento Amazon SNS](#subscribing-an-sqs-queue-to-an-sns-topic)

## Argomento di Amazon SNS: aws-mp-subscription-notification
<a name="ami-sns-subscription-message-body"></a>

Ogni messaggio nell'`aws-mp-subscription-notification`argomento relativo all'`subscribe-fail`azione `subscribe-success` and ha il seguente formato.

```
{
    "action": "action-name",
    "customer-identifier": " X01EXAMPLEX",
    "product-code": "n0123EXAMPLEXXXXXXXXXXXX",
    "offer-identifier": "offer-abcexample123"
}
```

*<action-name>*Varierà a seconda della notifica. Le azioni possibili sono:
+ `subscribe-success`
+ `subscribe-fail`
+ `unsubscribe-pending`
+ `unsubscribe-success`

`offer-identifier`È incluso nella notifica solo quando l'azione è `subscribe-success` o`subscribe-fail`. Non è incluso nelle notifiche quando l'azione è `unsubscribe-pending` o`unsubscribe-success`. Per le offerte create prima del gennaio 2024, questo identificatore è incluso nella notifica solo per le offerte private. Per le offerte create a gennaio 2024 e versioni successive, questo identificatore è incluso nelle notifiche di tutte le offerte, incluse le offerte private e le offerte pubbliche.

Per informazioni sui tipi di offerta, consulta la risposta dell'[DescribeEntity API](https://docs.aws.amazon.com//marketplace/latest/APIReference/work-with-private-offers.html#describe-entity) o la visibilità dell'offerta di un accordo nella dashboard dei [rinnovi degli accordi](https://docs.aws.amazon.com//marketplace/latest/userguide/agreements-renewals-dashboard.html).

**Nota**  
 Per quanto riguarda l'[DescribeEntity API](https://docs.aws.amazon.com//marketplace/latest/APIReference/work-with-private-offers.html#describe-entity), se trovi un Account AWS aspetto della regola di targeting relativo all'account per quell'offerta, si tratta di un'offerta privata. Se Account AWS nell'account non è presente un aspetto della regola di targeting per quell'offerta, si tratta di un'offerta pubblica.

## Sottoscrizione di una coda Amazon SQS all'argomento Amazon SNS
<a name="subscribing-an-sqs-queue-to-an-sns-topic"></a>

Ti consigliamo di iscriverti a una coda Amazon SQS per gli argomenti SNS forniti. *Per istruzioni dettagliate sulla creazione di una coda SQS e sulla sottoscrizione della coda a un argomento, consulta Sottoscrizione di una coda [Amazon SQS a un argomento Amazon SNS nella Amazon Simple Notification Service Developer Guide](https://docs.aws.amazon.com/sns/latest/dg/subscribe-sqs-queue-to-sns-topic.html).*

**Nota**  
Puoi abbonarti solo agli argomenti Marketplace AWS SNS di chi vende i prodotti. Account AWS Tuttavia, puoi inoltrare i messaggi a un altro account. Per ulteriori informazioni, consulta [Invio di messaggi Amazon SNS a una coda Amazon SQS in un account diverso nella](https://docs.aws.amazon.com/sns/latest/dg/sns-send-message-to-sqs-cross-account.html) Amazon *Simple Notification Service Developer Guide*.

### Sondaggio della coda SQS per le notifiche
<a name="polling-an-sqs-for-notifications"></a>

Dopo aver sottoscritto la coda SQS a un argomento SNS, i messaggi vengono archiviati in SQS. È necessario definire un servizio che effettui continuamente il polling della coda, cerchi i messaggi e li gestisca di conseguenza.

# Lista di controllo dei prodotti AMI per Marketplace AWS
<a name="aws-marketplace-listing-checklist"></a>

Prima di inviare il prodotto Amazon Machine Image (AMI) a AWS, utilizza questa lista di controllo per convalidare l'invio. Il rispetto di questi requisiti contribuirà a garantire un processo di pubblicazione efficiente.

## Utilizzo del prodotto
<a name="product-usage-checklist"></a>
+ AMI è pronto per la produzione.
+ L'utilizzo del prodotto non è limitato dal tempo o da altre misurazioni.
+ L'AMI è compatibile con l'esperienza di adempimento con 1 clic.
+ Tutto ciò che serve per utilizzare il prodotto è contenuto nel software, comprese le applicazioni client. I prodotti che richiedono dipendenze esterne, come pacchetti software o applicazioni client, seguono quelli [Politiche di utilizzo del prodotto](product-and-ami-policies.md#product-usage) che includono una corretta divulgazione.
+ AMI soddisfa i requisiti obbligatori[Requisiti di prodotto basati su AMI per Marketplace AWS](product-and-ami-policies.md). 
+ Non è richiesta alcuna licenza aggiuntiva per utilizzare il prodotto. 
+ L'acquirente non deve fornire informazioni di identificazione personale (ad esempio, il proprio indirizzo e-mail) per utilizzare il prodotto.

## Preparazione AMI
<a name="ami-preparation-checklist"></a>
+ Il nome e la descrizione del prodotto devono corrispondere al campo **Descrizione** del prodotto AMI fornito.
+ Utilizza la virtualizzazione Hardware Virtual Machine (HVM) e l'architettura a 64 bit. 
+ Il prodotto non contiene vulnerabilità, malware o virus noti. 
+ I clienti possono accedere all'istanza tramite la rete e utilizzare l'accesso amministrativo.
+ Sull'AMI non sono presenti segreti codificati. Esempi di segreti codificati includono password predefinite per utenti e servizi di sistema, chiavi private e credenziali.
+ Sull'AMI non sono presenti chiavi pubbliche autorizzate SSH codificate.
+ Il test di convalida del test «Aggiungi versione» viene completato con successo senza problemi.

## Windows AMIs
<a name="windows-amis-checklist"></a>
+ Per i sistemi operativi Windows Server 2012 e versioni successive, l'AMI utilizza la versione più recente di [EC2Launch v2](https://docs.aws.amazon.com/AWSEC2/latest/WindowsGuide/ec2launch-v2-install.html).
+ Se utilizzi EC2 Launch v2, completa quanto segue:
  + Nelle [impostazioni di Amazon EC2 Launch](https://docs.aws.amazon.com/AWSEC2/latest/WindowsGuide/ec2launch-v2-settings.html#ec2launch-v2-ui), scegli **Casuale** in **Imposta account amministratore** per generare una password di amministratore in fase di esecuzione.
  + Nelle [impostazioni di Amazon EC2 Launch](https://docs.aws.amazon.com/AWSEC2/latest/WindowsGuide/ec2launch-v2-settings.html#ec2launch-v2-ui), seleziona **Riattiva e avvia il servizio SSM dopo** Sysprep.
  + [Aggiungi alla configurazione del **UserData**EC2 task v2.](https://docs.aws.amazon.com/AWSEC2/latest/WindowsGuide/ec2launch-v2-settings.html#ec2launch-v2-task-configuration)
+ Per Windows Server 2012 e versioni successive, evita di usare [EC2Config](https://docs.aws.amazon.com/AWSEC2/latest/WindowsGuide/UsingConfig_Install.html). Se EC2 Config è richiesto, assicurati di utilizzare la versione più recente.
+ Se usi EC2 Config, abilita i seguenti parametri nei [file di impostazioni](https://docs.aws.amazon.com/AWSEC2/latest/WindowsGuide/ec2config-service.html#UsingConfigXML_WinAMI) per la tua AMI:
  + `Ec2SetPassword`
  + `Ec2WindowsActivate`
  + `Ec2HandleUserData`
+ Assicurati che non siano presenti account guest o utenti di desktop remoto.

## Linux AMIs
<a name="linux-amis-checklist"></a>
+ L'accesso remoto come superutente è vietato.
+ L'accesso remoto basato su password è vietato.

## Modulo di caricamento del prodotto o scheda Prodotto
<a name="product-load-form-checklist"></a>
+ Tutti i campi obbligatori sono stati compilati. 
+ Tutti i valori rientrano nei limiti di caratteri specificati. 
+ Tutto viene URLs caricato senza errori. 
+ L'immagine del prodotto ha una larghezza di almeno 110 pixel e un rapporto compreso tra 1:1 e 2:1. 
+ Il prezzo è specificato per tutti i tipi di istanze abilitati (per i modelli di prezzi mensili su base oraria, su base oraria e annuali su base oraria). 
+ Viene specificato il prezzo mensile (per i modelli di prezzi mensili e mensili su base oraria). 

# Requisiti di prodotto basati su AMI per Marketplace AWS
<a name="product-and-ami-policies"></a>

Marketplace AWS mantiene le seguenti politiche per tutti i prodotti e le offerte Amazon Machine Image (AMI). Le politiche contenute in questa sezione hanno lo scopo di fornire ai clienti una piattaforma di elaborazione sicura, protetta e affidabile.

Tutti i prodotti e i relativi metadati vengono esaminati una volta inviati per garantire che soddisfino o superino le politiche attuali. Marketplace AWS Queste politiche vengono aggiornate regolarmente per allinearsi alle linee guida sulla sicurezza in evoluzione. Marketplace AWS analizza continuamente i prodotti per verificare che le offerte esistenti continuino a soddisfare eventuali modifiche a questi requisiti. Se un prodotto non è conforme, Marketplace AWS contatterà il venditore per aggiornare il prodotto in modo che soddisfi i nuovi standard. In alcuni casi, i prodotti potrebbero essere temporaneamente resi non disponibili per i nuovi abbonati fino alla risoluzione dei problemi. Questo processo aiuta a mantenere la sicurezza e l'affidabilità della Marketplace AWS piattaforma per tutti gli utenti.

Prima di inviare il prodotto, ti consigliamo vivamente di utilizzare la funzione di [prova «Aggiungi versione»](https://aws.amazon.com/marketplace/management/products/server) per garantire la conformità con Portale di gestione Marketplace AWS le politiche attuali.

**Topics**
+ [Politiche per i venditori di prodotti AMI](#ami-product-seller-policies)
+ [Policy di sicurezza](#ami-security)
+ [Politiche di architettura](#architecture)
+ [Istruzioni per l'uso dei prodotti AMI](#ami-product-usage-instructions)
+ [Politiche sulla versione dei prodotti AMI](#ami-product-version-policies)
+ [Requisiti del prodotto FPGA](#ami-fpga-product-requirements)
+ [Politiche relative alle informazioni ai clienti](#customer-information)
+ [Politiche di utilizzo del prodotto](#product-usage)

## Politiche per i venditori di prodotti AMI
<a name="ami-product-seller-policies"></a>

Tutti AMIs devono rispettare le seguenti politiche di vendita:
+ Per impostazione predefinita, Marketplace AWS i venditori sono limitati a un massimo di 75 offerte pubbliche di prodotti AMI. Tutti i venditori che superano il limite sono soggetti a verifiche periodiche della performance e potrebbe essere richiesto di limitare le offerte con risultati insoddisfacenti. Marketplace AWS può concedere e revocare aumenti di tale limite a sua esclusiva discrezione.

## Policy di sicurezza
<a name="ami-security"></a>

### Politiche generali
<a name="general-policies"></a>

Tutti AMIs devono rispettare le seguenti politiche:
+ AMIs deve superare tutti i controlli di sicurezza eseguiti dallo [strumento di scansione Marketplace AWS AMI](https://aws.amazon.com/marketplace/management/products/server), senza mostrare vulnerabilità o malware noti.
+ AMIs deve utilizzare i sistemi operativi e il software attualmente supportati. I sistemi operativi e il software che hanno raggiunto la fine del loro ciclo di vita non sono consentiti.
+ L'autenticazione basata su password, ad esempio i servizi, è vietata. Ciò si applica anche se la password viene generata, reimpostata o definita dall'utente all'avvio. Le password vuote e nulle non sono consentite.

  Eccezioni:
  + Password di amministratore generate da istanze Windows`EC2Config/EC2Launch`.
  + Accesso non amministrativo ai servizi host (ad esempio, applicazioni Web) in assenza di altri metodi di autenticazione. Se vengono utilizzate password complesse, queste devono essere generate casualmente per ogni istanza, utilizzate una volta dall'amministratore del servizio per l'autenticazione iniziale e modificate immediatamente dopo il primo accesso.
+ L'AMI non deve contenere segreti codificati come password degli utenti e dei servizi di sistema (incluse le password con hash), chiavi private o credenziali.
+ AMIs non deve richiedere credenziali per accedere ai servizi. AWS AWS Se il prodotto richiede l'accesso ai AWS servizi, a un'istanza deve essere assegnato un ruolo con privilegi minimi AWS Identity and Access Management (IAM). Gli utenti possono creare ruoli manualmente o utilizzando un CloudFormation modello. Quando il lancio di un'AMI singola è abilitato per prodotti con un metodo di CloudFormation distribuzione, le istruzioni di utilizzo devono includere indicazioni chiare per la creazione di ruoli IAM con privilegi minimi. Per ulteriori informazioni, consulta [Fornitura di prodotti basati su AMI utilizzando](https://docs.aws.amazon.com/marketplace/latest/userguide/cloudformation.html). AWS CloudFormation
+ Un venditore non deve avere accesso alle istanze gestite da un cliente. Nel caso in cui tale accesso sia necessario per l'assistenza o per altri scopi, è possibile chiedere al cliente di abilitarlo esplicitamente.

### Politiche di accesso SSH (Secure Shell)
<a name="ssh-access"></a>

Oltre alle [politiche generali](#general-policies), la AMIs fornitura dell'accesso SSH (Secure Shell) deve rispettare le seguenti politiche di sicurezza:
+ AMIs non deve consentire l'autenticazione basata su password tramite SSH. Per garantire ciò, nel tuo `sshd_config` file, imposta su. `PasswordAuthentication` `no`
+ AMIs deve disabilitare gli accessi remoti basati su password per gli account superutente. Per ulteriori informazioni, consulta [Disabilitare gli accessi remoti basati su password](https://docs.aws.amazon.com//AWSEC2/latest/UserGuide/building-shared-amis.html#public-amis-disable-password-logins-for-root) per l'utente root.
+ AMIs non deve contenere chiavi pubbliche autorizzate per l'accesso SSH.
+ SSH on AMIs deve essere accessibile alle procedure di controllo Marketplace AWS interne.
  + Il servizio SSH deve ascoltare sulla porta TCP specificata per la scansione AMI. Per ulteriori informazioni, consulta [Aggiungere una nuova versione](https://docs.aws.amazon.com/marketplace/latest/userguide/single-ami-versions.html#single-ami-adding-version).
  + SSH deve essere accessibile dalle sottoreti `10.0.0.0/16` e `10.2.0.0/16` sull'indirizzo IP assegnato da Amazon Elastic Compute Cloud (Amazon EC2) all'avvio dell'istanza.

### Politiche AMIs basate su Linux e altri sistemi operativi simili a Unix
<a name="linux-and-other"></a>

Oltre alle [politiche generali](#general-policies), i sistemi AMIs basati su Linux e altri sistemi operativi simili a UNIX devono rispettare le seguenti politiche di sicurezza:
+ AMIs deve consentire agli utenti di ottenere un accesso con privilegi completi (ad esempio, per consentire `sudo` l'accesso).

### Criteri per sistemi basati su Windows AMIs
<a name="windows-based-amis"></a>

Oltre ai [criteri generali, quelli](#general-policies) basati su Windows AMIs devono rispettare i seguenti criteri di sicurezza:
+ AMIs non deve contenere account ospiti.
+ Solo agli account amministratore può essere concesso l'accesso desktop remoto a un'istanza.
+ Windows AMIs deve generare password di amministratore abilitando queste opzioni in [EC2Launch](https://docs.aws.amazon.com//AWSEC2/latest/UserGuide/ec2launch-v2.html) (o [EC2Config](https://docs.aws.amazon.com//AWSEC2/latest/UserGuide/ec2config-service.html) per Windows 2016 e versioni precedenti):
  + `Ec2SetPassword`
  + `Ec2WindowsActivate`
  + `Ec2HandleUserData`
+ AMIs deve essere disponibile per il controllo automatico. Deve essere implementato almeno uno dei seguenti requisiti:
  + (Opzione consigliata) L'agente SSM è installato e dispone di autorizzazioni amministrative e accesso alla rete in uscita.
  + Il servizio [Windows Remote Management (WinRM)](https://learn.microsoft.com/en-us/windows/win32/winrm/portal) è abilitato, ascolta sulla `5985` porta TCP ed è accessibile dalle `10.0.0.0/16` sottoreti `10.2.0.0/16` e dall'indirizzo IP assegnato da Amazon Elastic Compute Cloud (Amazon) all'avvio dell'istanza. EC2
  + Il [servizio Microsoft Server Message Block (SMB) Protocol e Common Internet File System (CIFS)](https://learn.microsoft.com/en-us/windows/win32/fileio/microsoft-smb-protocol-and-cifs-protocol-overview) è abilitato, ascolta su porte TCP `139` ed è accessibile dalle sottoreti `445` `10.0.0.0/16` e `10.2.0.0/16` dall'indirizzo IP assegnato da Amazon Elastic Compute Cloud (Amazon) all'avvio dell'istanza. EC2

## Politiche di architettura
<a name="architecture"></a>

Tutti AMIs devono rispettare le seguenti politiche di architettura:
+ Il codice sorgente AMIs Marketplace AWS deve essere fornito nella regione Stati Uniti orientali (Virginia settentrionale).
+ AMIs deve utilizzare la virtualizzazione HVM.
+ AMIs deve utilizzare l'architettura ARM x86-64 o 64 bit.
+ AMIs deve essere AMIs supportato da Amazon Elastic Block Store (Amazon EBS). Non AMIs supportiamo il supporto fornito da Amazon Simple Storage Service.
+ AMIs non deve utilizzare snapshot EBS crittografati.
+ AMIs non deve utilizzare file system crittografati.
+ AMIs devono essere costruiti in modo che possano funzionare ovunque Regioni AWS e siano indipendenti dalla regione. AMIs costruiti in modo diverso per regioni diverse non sono consentiti.

## Istruzioni per l'uso dei prodotti AMI
<a name="ami-product-usage-instructions"></a>

Quando crei le istruzioni per l'uso del tuo prodotto AMI, segui i passaggi e le indicazioni che trovi in[Creazione di AMI e istruzioni per l'uso dei prodotti in container per Marketplace AWS](ami-container-product-usage-instructions.md). 

## Politiche sulla versione dei prodotti AMI
<a name="ami-product-version-policies"></a>

Marketplace AWS automatizza l'esperienza di gestione delle versioni per AWS clienti e venditori che utilizzano S-AMI, AMI con CloudFormation modelli e prodotti container. Con l'archiviazione automatica delle versioni, qualsiasi versione del prodotto soggetta a restrizioni da un venditore per più di due anni viene archiviata automaticamente. Le versioni archiviate non sono più disponibili per il lancio Marketplace AWS per i nuovi clienti, tuttavia gli utenti esistenti possono continuare a utilizzare la versione archiviata tramite modelli di avvio e gruppi Amazon Auto EC2 Scaling specificando l'ID AMI. Qualsiasi versione archiviata che non è stata utilizzata per avviare nuove istanze negli ultimi 13 mesi viene eliminata. Una volta eliminata, una versione archiviata non è più disponibile per l'avvio per gli utenti nuovi o esistenti.

## Requisiti del prodotto FPGA
<a name="ami-fpga-product-requirements"></a>

Oltre ai requisiti standard dei prodotti AMI, i prodotti FPGA devono soddisfare i seguenti requisiti:
+ AFI IDs deve essere di proprietà del tuo Marketplace AWS Account venditore.
+ Ogni versione del prodotto supporta un massimo di 15 AFI IDs, che consentono di fornire più configurazioni FPGA mantenendo al contempo una complessità gestibile del prodotto.
+ L'AFI IDs deve essere creato e registrato nella regione Stati Uniti orientali (Virginia settentrionale).
+ La disponibilità regionale è limitata alle regioni in cui sono supportati i tipi di istanze F2.
+ Il ruolo di accesso IAM fornito durante la creazione della versione dispone delle autorizzazioni per condividere il ruolo fornito AFIs con AWS Marketplace. Per ulteriori dettagli sulle autorizzazioni richieste, consulta [Concedere ad AWS Marketplace l'accesso alle tue immagini FPGA](https://docs.aws.amazon.com/marketplace/latest/userguide/single-ami-marketplace-ami-access.html#single-ami-marketplace-afi-access).

## Politiche relative alle informazioni ai clienti
<a name="customer-information"></a>

Tutti AMIs devono rispettare le seguenti politiche di informazione dei clienti:
+ Il software non deve raccogliere o esportare i dati dei clienti a insaputa del cliente e senza il suo consenso espresso, ad eccezione di quanto richiesto da BYOL (Bring Your Own License). Le applicazioni che raccolgono o esportano i dati dei clienti devono seguire queste linee guida: 
  + La raccolta dei dati dei clienti deve essere self-service, automatizzata e sicura. Gli acquirenti non devono attendere che i venditori approvino l'implementazione del software. 
  + La raccolta dei dati dei clienti deve essere conforme ai tuoi accordi con AWS, a titolo esemplificativo ma non esaustivo, i [Termini e condizioni del AWS Marketplace, i Termini](https://aws.amazon.com/legal/seller-terms/) di [AWS servizio](https://aws.amazon.com/service-terms/), l'[Informativa AWS sulla privacy](https://aws.amazon.com/privacy/) e il [Contratto con il AWS cliente](https://aws.amazon.com/agreement/).
  + Le informazioni di pagamento non devono essere raccolte.

## Politiche di utilizzo del prodotto
<a name="product-usage"></a>

Tutti AMIs devono rispettare le seguenti politiche di utilizzo del prodotto:
+ I prodotti non devono limitare l'accesso al prodotto o alle funzionalità del prodotto in base all'ora, al numero di utenti o ad altre restrizioni. I prodotti beta e in versione non definitiva, o i prodotti il cui unico scopo è offrire funzionalità di prova o di valutazione, non sono supportati. Sono supportate le edizioni Developer, Community e BYOL del software commerciale, a condizione che sia disponibile anche una versione equivalente a pagamento in. Marketplace AWS
+ Tutto AMIs deve essere compatibile con l'esperienza Launch from Website o con la distribuzione basata su AMI. AWS CloudFormation Per Launch from Website, l'AMI non può richiedere che i dati del cliente o dell'utente al momento della creazione dell'istanza funzionino correttamente.
+ AMIs e il loro software deve essere implementabile in modalità self-service e non deve richiedere metodi o costi di pagamento aggiuntivi. Le applicazioni che richiedono dipendenze esterne per la distribuzione devono seguire queste linee guida:
  + Il requisito deve essere indicato nella descrizione o nelle istruzioni d'uso dell'elenco. Ad esempio, *questo prodotto richiede una connessione Internet per essere distribuito correttamente. I seguenti pacchetti vengono scaricati durante la distribuzione:.* <list of package> 
  + I venditori sono responsabili dell'uso e della garanzia della disponibilità e della sicurezza di tutte le dipendenze esterne. 
  + Se le dipendenze esterne non sono più disponibili, è necessario rimuovere anche il prodotto da Marketplace AWS . 
  + Le dipendenze esterne non devono richiedere metodi o costi di pagamento aggiuntivi.
+ AMIs che richiedono una connessione continua a risorse esterne non sotto il controllo diretto dell'acquirente, ad esempio esterne APIs o Servizi AWS gestite dal venditore o da terzi, devono seguire queste linee guida:
  + Il requisito deve essere indicato nella descrizione o nelle istruzioni d'uso dell'inserzione. Ad esempio, *questo prodotto richiede una connessione Internet continua. I seguenti servizi esterni continui sono necessari per funzionare correttamente:.* <list of resources> 
  + I venditori sono responsabili dell'uso e della garanzia della disponibilità e della sicurezza di tutte le risorse esterne.
  + Se le risorse esterne non sono più disponibili, è necessario rimuovere anche Marketplace AWS il prodotto.
  + Le risorse esterne non devono richiedere metodi o costi di pagamento aggiuntivi e la configurazione della connessione deve essere automatizzata.
+ Il software e i metadati del prodotto non devono contenere un linguaggio che reindirizza gli utenti ad altre piattaforme cloud, prodotti aggiuntivi o servizi di upselling non disponibili in. Marketplace AWS
+ Se il prodotto è un componente aggiuntivo di un altro prodotto o di un altro prodotto ISV, la descrizione del prodotto deve indicare che estende le funzionalità dell'altro prodotto e che senza di essa l'utilità del prodotto è molto limitata. Ad esempio, *questo prodotto estende le funzionalità di e senza di esso, ha un'utilità molto limitata<product name>. Tieni presente che potrebbe essere necessaria una licenza propria per la piena funzionalità di questo elenco.* <product name>