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à.
# Integrazioni di fatturazione, misurazione e licenza dei prodotti container
Marketplace AWS si integra con altri prodotti Servizi AWS per fornire prezzi basati sulla misurazione e su contratto per il prodotto in container. Per i prodotti basati su container con prezzi di utilizzo, puoi utilizzare il sia per verificare l'autorizzazione all'uso del prodotto sia [AWS Marketplace Metering Service](https://docs.aws.amazon.com/marketplacemetering/latest/APIReference/Welcome.html)per misurare l'utilizzo per la fatturazione. Per i prodotti basati su container con prezzi contrattuali, puoi utilizzarli per associare le licenze al tuo prodotto. AWS License Manager Le sezioni seguenti forniscono ulteriori informazioni sulla misurazione oraria e personalizzata e sui prezzi contrattuali con AWS Marketplace Metering Service . AWS License Manager
**Topics**
+ [Misurazione oraria e personalizzata con AWS Marketplace Metering Service](#entitlement-and-metering-for-paid-products)
+ [Prezzi contrattuali con AWS License Manager](#container-products-contracts-license-manager)
+ [Configurazione della misurazione oraria con AWS Marketplace Metering Service](container-metering-registerusage.md)
+ [Configurazione di contatori personalizzati per prodotti container con AWS Marketplace Metering Service](container-metering-meterusage.md)
+ [Prezzi contrattuali per prodotti in container con AWS License Manager](container-license-manager-integration.md)
## Misurazione oraria e personalizzata con AWS Marketplace Metering Service
[Per verificare il diritto all'uso del prodotto e per misurare l'utilizzo per la fatturazione, utilizza il servizio di misurazione.Marketplace AWS](https://docs.aws.amazon.com/marketplacemetering/latest/APIReference/Welcome.html) Se desideri definire le tue unità di prezzo e contabilizzarci l'utilizzo per la fatturazione, esegui l'integrazione utilizzando l'operazione API. [MeterUsage](https://docs.aws.amazon.com/marketplacemetering/latest/APIReference/API_MeterUsage.html) Se desideri stabilire il prezzo del tuo prodotto in base al numero di attività o di pod utilizzati e calcolare automaticamente AWS tale utilizzo, esegui l'integrazione utilizzando l'operazione [RegisterUsage](https://docs.aws.amazon.com/marketplacemetering/latest/APIReference/API_RegisterUsage.html)API. Per entrambi i tipi di prezzi, puoi aggiungere un prezzo contrattuale a lungo termine senza modificare la AWS Marketplace Metering Service modalità di integrazione con.
Quando crei un nuovo prodotto contenitore in Portale di gestione Marketplace AWS, forniamo una serie di identificatori del prodotto (il codice del prodotto e la chiave pubblica) che vengono utilizzati per integrare il prodotto con. AWS Marketplace Metering Service
### Entitlement
L'integrazione con ti AWS Marketplace Metering Service consente di verificare che il cliente che utilizza il tuo software a pagamento sia abbonato al tuo prodotto Marketplace AWS, proteggendoti dall'uso non autorizzato all'avvio del contenitore. Per verificare l'autorizzazione, utilizza le operazioni [MeterUsage](https://docs.aws.amazon.com/marketplacemetering/latest/APIReference/API_MeterUsage.html)o le [RegisterUsage](https://docs.aws.amazon.com/marketplacemetering/latest/APIReference/API_RegisterUsage.html)API, a seconda del modello di prezzo in uso. Per i modelli di prezzi mensili orari e fissi, utilizza il funzionamento dell'`RegisterUsage`API. Per i modelli di misurazione dei prezzi personalizzati, utilizza l'operazione `MeterUsage` API.
Se un acquirente non ha diritto al tuo prodotto, queste operazioni API restituiscono l'`CustomerNotEntitledException`eccezione.
**Nota**
Se un acquirente annulla l'iscrizione al tuo prodotto mentre lo utilizza, ha il diritto di continuare a utilizzarlo. Tuttavia, non possono avviare contenitori aggiuntivi per il tuo prodotto.
### Linee guida di integrazione
Quando crei e pubblichi i tuoi prodotti container e utilizzi le `MeterUsage` nostre operazioni `RegisterUsage` API per l'autorizzazione e la misurazione, tieni a mente le seguenti linee guida:
+ Non configurare AWS le credenziali all'interno del software o nell'immagine del contenitore Docker. AWS le credenziali per l'acquirente vengono ottenute automaticamente in fase di esecuzione quando l'immagine del contenitore è in esecuzione all'interno di un'attività Amazon ECS o di un pod Amazon EKS.
+ Per chiamare le operazioni `MeterUsage` o `RegisterUsage` API da Amazon EKS, devi [utilizzare un AWS SDK supportato](https://docs.aws.amazon.com/eks/latest/userguide/iam-roles-for-service-accounts-minimum-sdk.html). Per testare `MeterUsage` o `RegisterUsage` integrare Amazon EKS, devi eseguire un cluster Amazon EKS con Kubernetes 1.13.x o versione successiva. Kubernetes 1.13 è richiesto per i ruoli (IAM) per il supporto dei pod. AWS Identity and Access Management I ruoli IAM sono necessari affinché il pod in esecuzione ottenga le AWS credenziali necessarie per richiamare queste azioni su Amazon EKS.
+ Puoi occuparti dello sviluppo locale, ma otterrai un'`PlatformNotSupportedException`eccezione. Questa eccezione non si verifica quando avvii il contenitore su servizi AWS container (Amazon ECS, Amazon EKS e Fargate).
### Supportato Regioni AWS
Per un elenco di tutte le aree Marketplace AWS supportate Regioni AWS, consulta la [Tabella delle regioni](https://aws.amazon.com/about-aws/global-infrastructure/regional-product-services/) sul sito Web di Global Infrastructure.
#### Ottenere la misura Regione AWS per la misurazione
Quando integri il contenitore per la misurazione con il funzionamento `MeterUsage` o l'`RegisterUsage`API, non configurate l' AWS SDK per utilizzarne uno specifico. Regione AWS La regione deve essere ottenuta dinamicamente in fase di esecuzione.
**Example**
Ad esempio, un cliente avvia un'attività Amazon ECS o un pod Amazon EKS. L'operazione `RegisterUsage` API viene chiamata in una regione diversa dalla regione in cui è stato lanciato il task Amazon ECS o il pod Amazon EKS. Pertanto, l'operazione `RegisterUsage` API genera un errore. `InvalidRegionException`
AWS I linguaggi SDK non li determinano `AWS_REGION` in modo coerente. Se il tuo SDK non rileva automaticamente il file`AWS_REGION`, il software deve essere scritto manualmente per determinare il. `AWS_Region` Ad esempio, utilizza AWS SDK per Java automaticamente i [metadati delle istanze Amazon EC2](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/ec2-instance-metadata.html) (in particolare`ec2InstanceMetadata`) per ottenere la regione quando non sono presenti variabili di ambiente o altre configurazioni. In questo caso, chiama solo `ec2InstanceMetadata` se la variabile di `AWS_REGION` ambiente non è presente.
Per informazioni su come ottenere dinamicamente un file Regione AWS in fase di esecuzione, consultate la [AWS SDK Developer Guide](https://aws.amazon.com/tools) per il linguaggio di programmazione in uso.
### Impedire la modifica dei contatori
L'introduzione di modi per consentire agli acquirenti di modificare o annullare le chiamate `RegisterUsage` o `MeterUsage` potrebbe comportare problemi indesiderati di fatturazione e pagamento. Ti consigliamo vivamente di integrare la logica di misurazione e di autorizzazione.
Quando progettate il vostro prodotto per evitare modifiche alla misurazione, tenete presente quanto segue:
+ Se gli acquirenti possono inserire nuovi livelli di immagine che contengono `CMD` o `ENTRYPOINT` istruzioni, `RegisterUsage` integrali direttamente `MeterUsage` nel software che l'acquirente sta eseguendo tramite l'immagine del contenitore. In caso contrario, le chiamate verso `RegisterUsage` `CMD` o `MeterUsage` eseguite tramite o `ENTRYPOINT` dall'immagine di base verranno probabilmente sostituite dall'acquirente.
+ Ti consigliamo di gestire i codici di Marketplace AWS prodotto utilizzati dal software come input `RegisterUsage` o `MeterUsage` in modo che gli acquirenti non possano modificarli. *Tuttavia, se il tuo prodotto gestisce i codici di prodotto in un modo che i clienti possono ignorare AWS CloudFormation, ad esempio Helm chart o Kubernetes manifest, devi mantenere un elenco di codici di prodotto affidabili.* Marketplace AWS Questo serve a garantire che il codice prodotto a cui il software trasmette come input o sia valido. `RegisterUsage` `MeterUsage`
+ Se uno dei tuoi codici prodotto affidabili riguarda prodotti gratuiti, assicurati che non possa essere utilizzato al posto di un codice prodotto a pagamento.
## Prezzi contrattuali con AWS License Manager
Per i prodotti basati su container con prezzi contrattuali, è possibile associare le licenze AWS License Manager al 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. Questa sezione fornisce informazioni su come integrare il prodotto con. AWS License Manager Una volta completata l'integrazione, puoi pubblicare la tua scheda di prodotto su Marketplace AWS.
Per ulteriori informazioni in merito AWS License Manager, consulta la [Guida per AWS License Manager l'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 *AWS CLI Command Reference*.
**Nota**
I clienti non possono lanciare nuove istanze del contenitore dopo il periodo di scadenza del contratto. Tuttavia, durante la durata del contratto, possono avviare un numero qualsiasi di istanze. Queste licenze non sono legate a un nodo o a un'istanza specifici. Qualsiasi software in esecuzione su qualsiasi contenitore su qualsiasi nodo può effettuare il checkout della licenza purché disponga delle credenziali AWS assegnate.
**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).
### Workflow di integrazione
I passaggi seguenti mostrano il flusso di lavoro per l'integrazione del prodotto contenitore 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 EC2, il task Amazon ECS o il software pod 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.