Misurazione oraria con AWS Marketplace Metering Service

Se il tuo prodotto in container utilizza prezzi orari per attività o per pod anziché dimensioni di prezzo personalizzate basate su misuratori, non devi definire dimensioni di misurazione personalizzate.

Il funzionamento dell'RegisterUsageAPI misura l'utilizzo del software per attività Amazon Elastic Container Service (Amazon ECS) o per pod Amazon Elastic Kubernetes Service (Amazon EKS), all'ora, con un utilizzo proporzionale al secondo. Un minimo di 1 minuto di utilizzo si applica alle attività o ai pod di breve durata. La misurazione continua dell'uso del software viene gestita automaticamente da. Marketplace AWS Metering Control Plane Il software non è tenuto a eseguire alcuna azione specifica di misurazione, ad eccezione di RegisterUsage una chiamata una sola volta per iniziare la misurazione dell'utilizzo del software.

RegisterUsagedeve essere chiamato immediatamente al momento del lancio di un container. Se non registri il container nelle prime 6 ore dal lancio del container, AWS Marketplace Metering Service non fornisce alcuna garanzia di misurazione per i mesi precedenti. Tuttavia, la misurazione continuerà per il mese in corso fino alla scadenza del container.

Marketplace AWS Metering Control PlaneContinua a fatturare ai clienti l'esecuzione delle attività di Amazon ECS e dei pod Amazon EKS, indipendentemente dallo stato dell'abbonamento del cliente. In questo modo non è più necessario che il software esegua controlli di autorizzazione dopo l'avvio iniziale con successo dell'operazione o del pod.

Prerequisiti per la misurazione oraria

Prima di pubblicare il prodotto, devi fare quanto segue:

1. Crea un nuovo prodotto contenitore in e prendi nota del relativo codice prodotto. Portale di gestione Marketplace AWS

   Per ulteriori informazioni, consulta Creazione di un prodotto contenitore.

2. Compila il modulo di caricamento del prodotto (PLF) con le informazioni necessarie sul prezzo orario e restituiscilo a noi per l'elaborazione.

   Per ulteriori informazioni, consulta Creazione o aggiornamento dei dettagli dei prezzi per i prodotti container (legacy).

3. Utilizza un ruolo AWS Identity and Access Management (IAM) per l'attività o il pod che esegue l'applicazione con le autorizzazioni IAM necessarie per effettuare la chiamata. RegisterUsage La policy gestita da IAM AWSMarketplaceMeteringRegisterUsage dispone di queste autorizzazioni.

4. (Facoltativo) Se desideri visualizzare la registrazione, ti consigliamo di abilitare la AWS CloudTrail registrazione nella definizione dell'attività o del pod.

5. Effettua una chiamata di prova all'operazione RegisterUsage API con un record per tutte le dimensioni di prezzo che definisci.

Modulo di caricamento del prodotto per la misurazione oraria

Quando compili il modulo di caricamento del prodotto per la misurazione oraria, compila i seguenti campi per il tuo prodotto, oltre agli altri campi obbligatori e facoltativi che definiscono il prodotto:

• Prezzo orario: il prezzo del prodotto, all'ora.

• Dimension Long Term Rate: il prezzo totale del software rispetto a un contratto a lungo termine, quando gli acquirenti pagano in anticipo.

• Durata a lungo termine (giorni): la durata, in giorni, del contratto a lungo termine.

Test dell'integrazione e della modalità di anteprima per RegisterUsage

Utilizza l'operazione RegisterUsage API per testare l'integrazione prima di inviare l'immagine Marketplace AWS per la pubblicazione.

La modalità di anteprima funziona in modo identico alla modalità di produzione, tranne per il fatto che la modalità di anteprima non verifica il diritto all'uso del prodotto. Per chiamare RegisterUsage in modalità anteprima, chiama RegisterUsage dall'immagine del contenitore eseguendo il prodotto su Amazon ECS o Amazon EKS. Usa quello Account AWS che stai utilizzando per mettere in vendita il Marketplace AWS prodotto. La tua integrazione di misurazione deve impostare dinamicamente il Regione AWS, anziché codificarlo. 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 questo modo, il team Marketplace AWS operativo può verificare il tuo lavoro con i log di quella regione.

Nota

Se il tuo prodotto supporta sia Amazon ECS che Amazon EKS, devi solo avviarlo in Amazon EKS per consentirci di convalidare la tua integrazione.

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

Gestione degli errori per RegisterUsage

Se l'immagine del contenitore si integra con AWS Marketplace Metering Service 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 all'operazione API. RegisterUsage 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 viene comunque addebitato il costo per l'utilizzo dei container dopo l'annullamento dell'iscrizione e il loro utilizzo viene monitorato.

La tabella seguente descrive gli errori che l'operazione RegisterUsage API potrebbe generare. 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.

Errore	Descrizione
InternalServiceErrorException	RegisterUsagenon è disponibile.
CustomerNotEntitiledException	Il cliente non dispone di un abbonamento valido per il prodotto.
InvalidProductCodeException	Il ProductCode valore passato come parte della richiesta non esiste.
InvalidPublicKeyException	Il PublicKeyVersion valore passato come parte della richiesta non esiste.
PlatformNotSupportedException	Marketplace AWS non supporta la misurazione dell'utilizzo dalla piattaforma sottostante. Sono supportati solo Amazon ECS, Amazon EKS e AWS Fargate .
ThrottlingException	Le chiamate a RegisterUsage sono limitate.
InvalidRegionException	RegisterUsagedeve essere chiamato nello stesso modo in Regione AWS cui è stato lanciato il task Amazon ECS o il pod Amazon EKS. Ciò impedisce a un contenitore di scegliere una regione (ad esempiowithRegion(“us-east-1”)) durante la chiamataRegisterUsage.