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à.
# Configurazione della misurazione per l'utilizzo con gli abbonamenti SaaS
Per gli abbonamenti Software as a Service (SaaS), contabilizzi tutti gli utilizzi e quindi i clienti vengono fatturati in AWS base ai record di misurazione forniti. Per i contratti SaaS, contabilizzate solo l'utilizzo che va oltre i diritti contrattuali del cliente. Le seguenti sezioni forniscono informazioni su come configurare la misurazione per l'utilizzo con i prodotti SaaS.
Quando l'applicazione misura l'utilizzo per un cliente, fornisce AWS una quantità di utilizzo accumulata. L'applicazione misura le dimensioni di prezzo definite al momento della creazione del prodotto, ad esempio i gigabyte trasferiti o gli host scansionati in una determinata ora. Ad esempio, se addebiti in base alla quantità di dati inviati all'applicazione, puoi misurare la quantità di dati e inviare un record di misurazione corrispondente una volta all'ora. AWS calcola la fattura di un cliente utilizzando i dati di misurazione insieme ai prezzi forniti al momento della creazione del prodotto.
Per i prodotti che supportano gli accordi concorrenti, la misurazione avviene a livello di licenza anziché a livello di prodotto. Ogni record di utilizzo deve includere un codice `LicenseArn` per identificare a quale accordo specifico si applica l'utilizzo. `LicenseArn`Viene ottenuto dalla risposta dell'`ResolveCustomer`API durante la registrazione SaaS. Ciò consente agli acquirenti di mantenere più contratti attivi per lo stesso prodotto, con l'utilizzo tracciato e fatturato separatamente per contratto.
**Nota**
Facoltativamente, puoi suddividere l'utilizzo tra le proprietà da monitorare. Queste proprietà vengono esposte all'acquirente come tag. Questi tag consentono all'acquirente di visualizzare i costi suddivisi in base all'utilizzo in base ai valori dei tag. Ad esempio, se addebiti in base all'utente e gli utenti dispongono di una `Department` proprietà, puoi creare un'allocazione di `Department` utilizzo con tag con una chiave e un'allocazione per valore. Ciò non modifica il prezzo, le dimensioni o l'utilizzo totale riportato, ma consente al cliente di visualizzare i costi per categorie appropriate al prodotto. Per ulteriori informazioni, consulta [Vendor-metered etichettatura (opzionale)](#saas-vendor-metered-tagging).
**Topics**
+ [Misuratore su base oraria](#metering-hourly)
+ [Configura il prodotto per misurarne l'utilizzo](#configure-application-for-meter-usage)
+ [Vendor-metered etichettatura (opzionale)](#saas-vendor-metered-tagging)
## Misuratore su base oraria
Ti consigliamo di segnalare l'utilizzo AWS su base oraria per tutti i tuoi clienti in batch fino a 25 alla volta. Ciò offre ai clienti la massima visibilità possibile sul loro utilizzo e sui costi. Se aggregate l'utilizzo in periodi di tempo superiori a un'ora (ad esempio, un giorno), tenete presente le seguenti considerazioni.
+ AWS può fatturare ai clienti l'utilizzo del prodotto solo dopo aver ricevuto da voi i dati di misurazione. È tua responsabilità garantire che i dati di misurazione del tuo prodotto vengano trasmessi e ricevuti correttamente. Puoi utilizzarli AWS CloudTrail per verificare che il record o i record che invii siano accurati. È inoltre possibile utilizzare le informazioni per eseguire verifiche nel tempo. Per ulteriori informazioni, consulta [Registrazione delle chiamate Marketplace AWS API con AWS CloudTrail](cloudtrail-logging.md).
+ Se si tratta di un SaaS con il modello di prezzo «Abbonamento» (non i modelli di prezzo «Contratto» o «Contratto con consumo»), l'acquirente può annullare l'iscrizione in qualsiasi momento. Quando l'acquirente avvia questa azione di annullamento dell'iscrizione, il venditore riceverà una `unsubscribe-pending` [notifica](saas-notification.md#saas-sns-subscription-message-body) e avrà 1 ora di tempo per segnalare tutti gli utilizzi non segnalati prima della notifica finale. `unsubscribe-success` Qualsiasi cosa successiva alla seconda notifica non verrà rispettata. Gli altri due modelli di prezzo hanno una durata prestabilita in base al periodo di sottoscrizione e l'acquirente non può annullare l'iscrizione durante tale periodo. Possono solo disattivare il rinnovo automatico. La stessa notifica viene inviata alla fine di tale periodo se non si effettua il rinnovo automatico.
+ Per i prodotti con accordi concorrenti: la notifica di annullamento dell'iscrizione e la finestra di 1 ora si applicano per ogni singolo contratto, non per prodotto. Se un acquirente annulla uno dei più contratti attivi, puoi continuare a contabilizzare le licenze attive rimanenti. Solo l'utilizzo per il contratto annullato deve essere inviato entro 1 ora dalla ricezione della notifica per quella `unsubscribe-pending` licenza specifica.
+ Se non invii i dati di misurazione ogni ora e si verifica un'interruzione dell'applicazione o della rete, i dati saranno ancora più scaduti. Ciò può comportare un utilizzo non segnalato se l'interruzione dell'applicazione o della rete viene ripristinata dopo la scadenza dell'abbonamento.
+ Anche se non vi è alcun utilizzo da segnalare, è possibile continuare a inviare i record di misurazione ogni ora e registrare una quantità pari a 0 se non vi è alcun utilizzo da segnalare per quell'ora. Tieni presente che dopo aver segnalato l'utilizzo da parte di un acquirente di una dimensione, pari o superiore a 0, non puoi modificare il record. Pertanto è consigliabile segnalare l'utilizzo dell'ora precedente. L'utilizzo riportato è visibile nella console [AWS Billing and Cost Management dell'acquirente durante tutto il ciclo di fatturazione](https://docs.aws.amazon.com/awsaccountbilling/latest/aboutv2/billing-what-is.html). La console mostra ogni dimensione del prodotto in una voce distinta con il numero totale di unità consumate e il costo totale per quella voce consumata per quel ciclo di fatturazione o finora, anche se il prezzo della dimensione è 0 USD per unità. Se abilitato, l'[AWS Cost and Usage Report (CUR)](https://docs.aws.amazon.com/cur/latest/userguide/what-is-data-exports.html) mostra questi dettagli, inclusa la tariffa per unità. Questi report non vengono aggiornati in tempo reale.
+ Durante la pubblicazione, il team Marketplace AWS operativo verificherà che l'applicazione SaaS invii correttamente il record di misurazione prima di consentire la pubblicazione del prodotto. In genere, il team eseguirà una registrazione fittizia del SaaS e confermerà che è stato ricevuto un record di misurazione.
**Nota**
Se il tuo prodotto SaaS è integrato con un altro servizio AWS gestito che gestisce la misurazione in modo diverso (come Amazon SageMaker Ground Truth o AWS WAF), non è necessario integrarsi con il servizio di misurazione AWS Marketplace. La misurazione del prodotto deve avvenire in un solo sistema per evitare una doppia fatturazione al cliente. Tieni presente che al momento Marketplace AWS non vengono pubblicati nuovi AWS WAF prodotti.
## Configura il prodotto per misurarne l'utilizzo
Utilizzi l'`BatchMeterUsage`operazione in AWS Marketplace Metering Service per fornire i record di misurazione a. AWS Ricorda quanto segue:
+ Richiediamo ai venditori di utilizzare il batch utilizzando l'operazione. `BatchMeterUsage`
+ Deduplichiamo le richieste di misurazione ogni ora.
+ Per i prodotti con accordi non concorrenti: le richieste vengono deduplicate per/. product/customer hour/dimension Per i prodotti Concurrent Agreements: le richieste vengono deduplicate per/. license/customer hour/dimension
+ Puoi sempre riprovare qualsiasi richiesta, ma se contabilizzi una quantità diversa, viene fatturata la quantità originale. Per i prodotti Concurrent Agreements: riprovare con gli stessi `LicenseArn` è sicuro e segue le regole di deduplicazione standard. Tuttavia, il passaggio da uno all'altro `ProductCode` e `LicenseArn` per la stessa finestra di utilizzo causerà una fatturazione duplicata.
+ Se invii più richieste per la stessa customer/dimension ora, i record non vengono aggregati.
+ Se il cliente è abbonato al tuo prodotto, i venditori possono inviare record di misurazione con un timestamp valido fino a 24 ore prima che il cliente sia abbonato al tuo prodotto. Se il cliente annulla l'iscrizione, i venditori devono inviare i dati di misurazione entro 1 ora dall'annullamento dell'iscrizione del cliente.
Alla fine di ogni ciclo di fatturazione, hai un periodo di prova di 6 ore per inviare i record di utilizzo per il mese di fatturazione precedente. Invia i record prima delle 06:00 UTC del primo giorno del mese successivo. Dopo questo periodo di grazia, non accettiamo tali documenti.
+ `BatchMeterUsage`i carichi utili non devono superare 1 MB. Scegliete il numero di record di utilizzo da inviare in una `BatchMeterUsage` richiesta in modo da non superare la dimensione del payload.
+ *L'AWS Marketplace Metering Service è disponibile negli [Marketplace AWS endpoint e nelle quote Regioni AWS elencati nella AWS Guida](https://docs.aws.amazon.com/general/latest/gr/aws-marketplace.html) generale.* Per ulteriori informazioni, consulta [BatchMeterUsage](https://docs.aws.amazon.com/marketplacemetering/latest/APIReference/API_BatchMeterUsage.html).
+ Contratti concorrenti: un singolo cliente può avere più contratti attivi per il prodotto. Ogni contratto è univoco `LicenseArn` e l'utilizzo viene monitorato separatamente per ogni licenza. [Consulta la nuova integrazione per gli accordi concorrenti qui.](https://catalog.workshops.aws/mpseller/en-US/saas/integration-for-concurrent-agreements) Per le nuove implementazioni, ognuna `UsageRecord` deve includere un `LicenseArn` campo per identificare a quale accordo si applica l'utilizzo. `LicenseArn`Viene ottenuto dalla risposta dell'`ResolveCustomer`API.
**Nota**
Per le implementazioni esistenti: durante la migrazione dalla misurazione basata sul prodotto alla misurazione basata su licenza, non inviare i record di misurazione con entrambi `LicenseArn` e `ProductCode` per lo stesso cliente entro la stessa ora. Ciò comporterà una fatturazione duplicata. Non includere `ProductCode` a livello di richiesta. Ciascuno `LicenseArn` di essi `UsageRecord` identifica sia il prodotto che l'accordo specifico.
Per alcuni esempi di codice, consultare [Esempi di codice per l'integrazione di prodotti SaaS](saas-code-examples.md).
### Esempio: scansione dell'host
Il prodotto analizza l'hardware informatico alla ricerca di vulnerabilità di sicurezza note. I clienti avviano o pianificano manualmente queste scansioni delle loro istanze Amazon Elastic Compute Cloud (Amazon EC2). Man mano che il prodotto esegue queste scansioni, calcola il numero di host unici scansionati ogni ora. **In questo esempio, il prodotto utilizza la categoria Host.** È possibile dichiarare più dimensioni per i tipi di host analizzati. Ad esempio, puoi applicare prezzi diversi per host di piccole, medie e grandi dimensioni.
### Esempio: analisi dei log
Il tuo prodotto SaaS analizza i log generati dai prodotti dei clienti, segnalando tendenze e anomalie. Man mano che i clienti caricano i log sul tuo prodotto, tu misuri la quantità di dati ricevuti in megabyte, gigabyte o terabyte. Il decimo minuto di ogni ora, un cron job legge questo utilizzo per ogni cliente nell'ora precedente. Il job crea un rapporto batch e utilizza l'`BatchMeterUsage`operazione per inviarlo a. AWS In questo esempio, il prodotto utilizza la categoria **Dati**. Il prodotto può anche misurare la quantità di dati di registro memorizzati per una determinata ora. In questo caso, il prodotto può misurare in base a due dimensioni: i dati ricevuti nell'ora e i dati totali memorizzati nell'ora. Puoi continuare a misurare i dati memorizzati finché il cliente non li elimina o non scadono.
## Vendor-metered etichettatura (opzionale)
Vendor-metered l'etichettatura aiuta i fornitori indipendenti di software (ISV) a fornire all'acquirente informazioni più dettagliate sull'utilizzo del software e può aiutarlo a eseguire l'allocazione dei costi.
Esistono molti modi per etichettare l'utilizzo del software da parte di un acquirente. Un modo è innanzitutto chiedere 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/)). Vendor-metered l'aggiunta di tag non modifica 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 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**.
I venditori possono anche combinare risorse senza tag in un'unica risorsa `UsageAllocation` e inviarla come una delle voci inserite. `UsageAllocations`
I limiti includono:
+ Numero di tag: 5
+ Dimensione di `UsageAllocations` (cardinalità): 2.500
+ Dimensione massima della richiesta: 1 MB
Le convalide includono:
+ Caratteri consentiti per la chiave e il valore del tag: a-z \+ -= A-Z0-9 . \_:\\ /@
+ 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.
+ La dimensione massima del payload non può essere superiore a 1 MB. Ciò include le chiavi degli attributi di input (ad esempio`UsageRecords`,`AllocatedUsageQuantity`, tag).
**Nota**
Per assicurarti di non superare il limite di payload, crea un oggetto di richiesta di esempio con una dimensione massima in base ai requisiti aziendali, converti l'oggetto in una stringa JSON e ottieni la dimensione in byte. Assicurati che una singola chiamata API non superi il limite di 1 MB. Ad esempio, se una richiesta con 1 `UsageRecord` ha una dimensione massima di 200 KB, non inviarne più di 5 `UsageRecords` come parte della richiesta (200 KB \* 5 = 1 MB).
### 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:` seguito dal nome della chiave del tag. Ad esempio, un tag con la chiave appare come. `BusinessUnit` `aws:marketplace:isv:BusinessUnit` Gli acquirenti possono attivare questi tag in Billing and Cost Management, **sotto Cost Allocation Tags 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](#saas-vendor-metered-tag-seller)
**Report sui costi di utilizzo (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 |
La schermata seguente mostra un esempio di AWS Cost Explorer Service visualizzazione dopo che un acquirente ha attivato i tag a misurazione del fornitore e ha raggruppato i costi in base al tag. `user`
**Per attivare i tag impostati dal fornitore nell'account acquirente**
1. [Accedi Console di gestione AWS e apri la console.AWS Billing](https://console.aws.amazon.com/billing/) Quindi scegli **Tag di allocazione dei costi** dal riquadro di navigazione a sinistra.
1. Scegli la scheda dei **AWS tag di allocazione dei costi generati**.
1. Cerca per `aws:marketplace:isv:` trovare i tag per tutti i prodotti che supportano l'etichettatura misurata dal fornitore.
1. **Seleziona le caselle di controllo relative ai tag che desideri attivare, quindi scegli Attiva.**
1. (Facoltativo) Per riempire i tag per i record di misurazione segnalati prima dell'attivazione, scegli Tag **Backfill**. **Seleziona il mese in cui sono stati segnalati i record di misurazione, quindi scegli Conferma.**
**Nota**
Dopo l'attivazione, i tag misurati dal fornitore impiegano fino a 24 ore per essere visualizzati nella console Billing and Cost Management e. AWS Cost Explorer Service Se scegli di riempire i tag, anche il completamento del processo di riempimento richiede circa 24 ore.
Per un esempio di codice, consulta [`BatchMeterUsage`con un esempio di codice di etichettatura per l'allocazione dell'utilizzo (opzionale)](saas-code-examples.md#saas-batchmeterusage-tagging).