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 di contatori personalizzati per prodotti container con AWS Marketplace Metering Service

Marketplace AWS i prodotti container possono avere una misurazione personalizzata per un massimo di 24 diverse dimensioni di prezzo per prodotto. A ogni dimensione può essere associato un prezzo contrattuale a lungo termine. Per abilitare la misurazione personalizzata, integra il tuo prodotto container con AWS Marketplace Metering Service. Puoi definire le tue unità di prezzo e la misurazione personalizzata per tale utilizzo e per la fatturazione utilizzando AWS il funzionamento dell'API. MeterUsage Le seguenti sezioni mostrano come configurare la misurazione personalizzata per il prodotto container.

Le dimensioni del prezzo sono definite in due posizioni, una volta durante la creazione del prodotto nel Portale di gestione Marketplace AWS (portale dei venditori) e una volta nel software per eseguire l'MeterUsageoperazione. Questo metodo a due fattori garantisce che le offerte successive funzionino come previsto prima di essere rese disponibili al pubblico.

Per configurare la misurazione personalizzata, devi scegliere la categoria di utilizzo, il tipo di unità e le dimensioni del prezzo:

Facoltativamente, è possibile distribuire l'utilizzo in allocazioni in base alle proprietà monitorate. Le allocazioni vengono rappresentate come tag per l'acquirente. 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 hanno la proprietà «Dipartimento», puoi creare allocazioni di utilizzo con tag con la chiave «Dipartimento» 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.

Ti consigliamo di inviare un record di misurazione ogni ora. Tuttavia, puoi aggregare l'utilizzo anche su periodi giornalieri o mensili. In caso di interruzione, puoi aggregare l'utilizzo del software da parte degli acquirenti e inviarlo per la misurazione delle ore successive. Non puoi inviare più di un record all'ora.

Per ulteriori informazioni sull'integrazione dell' AWS Marketplace Metering Service API per i prodotti container con prezzi di misurazione personalizzati, consulta il laboratorio Integrazione con misurazione personalizzata del workshop per i Marketplace AWS venditori.

Prerequisiti per la misurazione personalizzata

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

Testare MeterUsage l'integrazione

Utilizza l'MeterUsageoperazione per testare l'integrazione prima di inviare l'immagine Marketplace AWS per la pubblicazione.

MeterUsageEsegui la chiamata dalle immagini del contenitore eseguendo il prodotto su Amazon Elastic Container Service (Amazon ECS) o Amazon Elastic Kubernetes Service (Amazon EKS Account AWS ) con il codice su cui stai pubblicando il prodotto. Marketplace AWS La tua integrazione di misurazione deve impostare dinamicamente il file, anziché codificarlo a livello di Regione AWS codice. Tuttavia, durante il test, avvia almeno un'attività Amazon ECS o un pod Amazon EKS contenente il container a pagamento nella regione Stati Uniti orientali (Virginia settentrionale) in modo che il team Marketplace AWS operativo possa verificare il tuo lavoro con i log di quella regione.

Non puoi testare completamente l'integrazione finché il prodotto non sarà pubblicato con tutti i metadati e le informazioni sui prezzi richiesti. Se richiesto, il team operativo del Marketplace AWS catalogo può verificare la ricezione dei dati di misurazione.

Gestione degli errori per MeterUsage

Se l'immagine del contenitore si integra con l'MeterUsageoperazione e riceve un'eccezione diversa ThrottlingException dall'avvio del contenitore, è necessario terminare il contenitore per impedirne l'uso non autorizzato.

Le eccezioni diverse da ThrottlingException vengono generate solo durante la chiamata iniziale a. MeterUsage Le chiamate successive dalla stessa attività Amazon ECS o dallo stesso pod Amazon EKS non vengono generate CustomerNotSubscribedException anche se il cliente annulla l'iscrizione mentre l'attività o il pod è ancora in esecuzione. A questi clienti vengono comunque addebitati i costi per l'utilizzo dei container anche dopo l'annullamento dell'iscrizione e il monitoraggio del loro utilizzo.

MeterUsageConsulta l'AWS Marketplace Metering Service API Reference per le descrizioni dettagliate degli errori più comuni per. MeterUsage Ogni linguaggio di programmazione AWS SDK dispone di una serie di linee guida per la gestione degli errori a cui puoi fare riferimento per ulteriori informazioni.

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.

Esistono molti modi per contrassegnare l'utilizzo del software da parte di un acquirente. Un modo consiste nel chiedere innanzitutto 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 AccountId Business UnitCost 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/). 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 AccountId quindi allocare l'utilizzo a ciascun utente. In questo caso, gli acquirenti possono attivare il AccountId 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.

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:

Le convalide includono:

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

Per un esempio di codice, consulta MeterUsageesempio di codice con etichettatura per l'allocazione dell'utilizzo (opzionale).

esempio di codice

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

MeterUsageesempio di codice con etichettatura per l'allocazione dell'utilizzo (opzionale)

Il seguente esempio di codice è rilevante per i prodotti container 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. 
#       AWS Marketplace can only accept records for up to an hour in the past. 
#
# productCode is supplied after the AWS Marketplace 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 in meritoMeterUsage, consulta l'API MeterUsageReference.AWS Marketplace Metering Service

Example response

{ "MeteringRecordId": "string" }