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 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" }
```