Configurazione della misurazione oraria con Marketplace Metering Service AWS - Marketplace AWS
Prerequisiti per la misurazione orariaModulo di caricamento del prodotto per la misurazione orariaTest dell'integrazione e della modalità di anteprima per RegisterUsageGestione degli errori per RegisterUsage

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 oraria con Marketplace Metering Service AWS

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. Puoi utilizzare AWS Marketplace Metering Service per la misurazione oraria con prodotti in container all'interno. Marketplace AWS Le seguenti sezioni mostrano come configurare la misurazione oraria con AWS Marketplace Metering Service.

L'RegisterUsageAPIoperazione misura l'utilizzo del software per attività di Amazon Elastic Container Service (AmazonECS) o per pod Amazon Elastic Kubernetes Service (EKSAmazon), 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 dal Marketplace AWS Metering Control Plane. Non è necessario che il software esegua alcuna azione specifica di misurazione, ad eccezione di RegisterUsage una chiamata una 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.

La Marketplace AWS Metering Control Plane continua a fatturare ai clienti l'esecuzione ECS delle attività di Amazon e dei EKS pod Amazon, 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.

Argomenti

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 Panoramica: crea un prodotto contenitore.

  2. Utilizzate un ruolo AWS Identity and Access Management (IAM) per l'attività o il pod che esegue l'applicazione con le IAM autorizzazioni necessarie per effettuare la chiamataRegisterUsage. La politica IAM gestita AWSMarketplaceMeteringRegisterUsage dispone di queste autorizzazioni.

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

  4. Effettua una chiamata di prova all'RegisterUsageAPIoperazione 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

Utilizzate l'RegisterUsageAPIoperazione 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 AmazonEKS. Usa quello Account AWS che stai utilizzando per mettere in vendita il prodotto Marketplace AWS. La tua integrazione di misurazione deve impostare dinamicamente il Regione AWS, anziché codificarlo. Tuttavia, durante il test, avvia almeno un'ECSattività Amazon o un Amazon EKS pod 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 ECS sia Amazon che AmazonEKS, devi solo avviarlo in Amazon EKS per consentirci di convalidare la tua integrazione.

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 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. RegisterUsage API Le chiamate successive dalla stessa ECS attività Amazon o dallo stesso EKS pod Amazon 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'RegisterUsageAPIoperazione potrebbe generare. Ogni linguaggio AWS SDK di programmazione dispone di una serie di linee guida per la gestione degli errori a cui è possibile fare riferimento per ulteriori informazioni.

Errore Descrizione
InternalServiceErrorException RegisterUsagenon è disponibile.
CustomerNotEntitledException 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 ECSEKS, Amazon e AWS Fargate .
ThrottlingException Le chiamate a RegisterUsage sono limitate.
InvalidRegionException RegisterUsagedeve essere chiamato nello stesso modo in Regione AWS cui è stato lanciato il ECS task Amazon o il EKS pod Amazon. Ciò impedisce a un contenitore di scegliere una regione (ad esempiowithRegion(“us-east-1”)) durante la chiamataRegisterUsage.