Comptage horaire avec AWS Marketplace Metering Service

Si votre produit en conteneur utilise une tarification par heure, par tâche ou par dosette au lieu de mesures personnalisées, vous n'avez pas besoin de définir des dimensions de mesure personnalisées.

Le fonctionnement de l'RegisterUsageAPI mesure l'utilisation du logiciel par tâche Amazon Elastic Container Service (Amazon ECS) ou par pod Amazon Elastic Kubernetes Service (Amazon EKS), par heure, l'utilisation étant calculée au prorata de la seconde. Un minimum d'une minute d'utilisation s'applique aux tâches de courte durée. La mesure continue pour l'utilisation du logiciel est automatiquement gérée par le AWS Marketplace Metering Control Plane. Votre logiciel n'est pas obligé d'effectuer des actions spécifiques de mesure, sauf d'en appeler RegisterUsage une seule fois pour que le mesurage de l'utilisation du logiciel commence.

RegisterUsagedoit être appelé immédiatement au moment du lancement d'un conteneur. Si vous n'enregistrez pas le conteneur dans les 6 premières heures suivant son lancement, AWS Marketplace Metering Service ne fournit aucune garantie de comptage pour les mois précédents. Cependant, le comptage se poursuivra pour le mois en cours jusqu'à la fin du conteneur.

Les clients AWS Marketplace Metering Control Plane continuent d'être facturés pour l'exécution de tâches Amazon ECS et de pods Amazon EKS, quel que soit l'état de leur abonnement. Votre logiciel n'a donc plus besoin de vérifier les droits après le lancement initial réussi de la tâche ou du module.

Prérequis pour la mesure horaire

Avant de publier le produit, vous devez effectuer les opérations suivantes :

1. Créez un nouveau produit conteneur dans Portail de gestion AWS Marketplace le et notez son code produit.

   Pour plus d’informations, consultez Création d'un produit de conteneur.

2. Remplissez le formulaire de chargement du produit (PLF) avec les informations de prix horaires nécessaires et retournez-le pour traitement.

   Pour plus d’informations, consultez Création ou mise à jour des informations de tarification pour les produits en conteneur (ancienne version).

3. Utilisez un rôle AWS Identity and Access Management (IAM) pour la tâche ou le module exécutant votre application avec les autorisations IAM nécessaires pour appeler. RegisterUsage La politique gérée par IAM AWSMarketplaceMeteringRegisterUsage dispose de ces autorisations.

4. (Facultatif) Si vous souhaitez voir la journalisation, nous vous recommandons d'activer la AWS CloudTrail journalisation dans la définition de la tâche ou du module.

5. Effectuez un appel test à l'opération d'RegisterUsageAPI avec un enregistrement de toutes les dimensions de tarification que vous définissez.

Formulaire de chargement de produit pour la mesure horaire

Lorsque vous remplissez le formulaire de charge du produit pour le comptage horaire, remplissez les champs suivants pour votre produit, en plus des autres champs obligatoires et facultatifs qui définissent votre produit :

• Prix horaire — Le prix de votre produit, par heure.

• Dimension : tarif à long terme : prix total du logiciel sur un contrat à long terme, lorsque les acheteurs paient d'avance.

• Durée à long terme (jours) — Durée, en jours, du contrat à long terme.

Tester l'intégration et le mode de prévisualisation pour RegisterUsage

Utilisez l'opération RegisterUsage API pour tester votre intégration avant de soumettre votre image à des AWS Marketplace fins de publication.

Le mode d'aperçu fonctionne de la même manière que le mode de production, sauf que le mode d'aperçu ne vérifie pas le droit d'utiliser votre produit. Pour appeler RegisterUsage en mode aperçu, appelez RegisterUsage depuis l'image du conteneur en exécutant votre produit sur Amazon ECS ou Amazon EKS. Utilisez celui Compte AWS que vous utilisez pour mettre le produit en vente AWS Marketplace. Votre intégration de mesure doit définir le de manière dynamique Région AWS, plutôt que de le coder en dur. Toutefois, lors du test, lancez au moins une tâche Amazon ECS ou un pod Amazon EKS contenant votre conteneur payant dans la région USA Est (Virginie du Nord). Ce faisant, l'équipe AWS Marketplace des opérations peut vérifier votre travail à l'aide des journaux de cette région.

Note

Si votre produit prend en charge à la fois Amazon ECS et Amazon EKS, il vous suffit de le lancer dans Amazon EKS pour que nous puissions valider votre intégration.

Vous ne pouvez pas tester totalement l'intégration tant que votre produit n’a pas été publié avec toutes les métadonnées requises et les informations de tarification. Sur demande, l'équipe chargée des opérations du AWS Marketplace catalogue peut vérifier la réception de vos relevés de mesure en mode aperçu.

Gestion des erreurs pour RegisterUsage

Si l'image de votre conteneur s'intègre à AWS Marketplace Metering Service et reçoit une exception autre qu'ThrottlingExceptionau démarrage du conteneur, vous devez mettre fin au conteneur pour empêcher toute utilisation non autorisée.

Les exceptions autres que ne ThrottlingException sont émises que lors de l'appel initial à l'opération RegisterUsage d'API. Les appels suivants provenant de la même tâche Amazon ECS ou du même pod Amazon EKS ne sont pas lancés, CustomerNotSubscribedException même si le client se désabonne alors que la tâche ou le module est toujours en cours d'exécution. Ces clients sont toujours facturés pour la gestion des conteneurs après leur désinscription, et leur utilisation est suivie.

Le tableau suivant décrit les erreurs que l'opération RegisterUsage d'API peut générer. Chaque langage de programmation du AWS SDK possède un ensemble de directives de gestion des erreurs auxquelles vous pouvez vous référer pour plus d'informations.

Error (Erreur)	Description
InternalServiceErrorException	RegisterUsage n'est pas disponible.
CustomerNotEntitiledException	Le client ne dispose pas d'un abonnement valable pour le produit.
InvalidProductCodeException	La valeur ProductCode transmise dans le cadre de la requête n'existe pas.
InvalidPublicKeyException	La valeur PublicKeyVersion transmise dans le cadre de la requête n'existe pas.
PlatformNotSupportedException	AWS Marketplace ne prend pas en charge la mesure de l'utilisation à partir de la plateforme sous-jacente. Seuls Amazon ECS, Amazon EKS et Amazon AWS Fargate sont pris en charge.
ThrottlingException	Les appels vers RegisterUsage sont limités.
InvalidRegionException	RegisterUsagedoit être appelée de la même manière Région AWS que la tâche Amazon ECS ou le pod Amazon EKS a été lancé. Cela empêche un conteneur de choisir une région (par exemple, withRegion(“us-east-1”)) lorsqu’il appelle RegisterUsage.