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à.
# Prezzi dei prodotti AMI per Marketplace AWS
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
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
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
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
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
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
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
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
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
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
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
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
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)
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
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
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
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
**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
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
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
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
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
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)
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
```
{ "MeteringRecordId": "string" }
```
# Prezzi contrattuali per i prodotti AMI su Marketplace AWS
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
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
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
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
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
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
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
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
```
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
```
{
"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
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
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
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
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": "",`
`"Unit": "None"`
`}`
+ Per i permessi configurabili, fornisci e proprietà come segue`Name`: `Unit` `Value`
`{`
`"Name": "",`
`"Unit": "",`
`"Value": {`
\$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 license recipient's AWS Account ID
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 \
--checkout-type PROVISIONAL \
--key-fingerprint "aws::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
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
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.