Configuration du comptage horaire avec AWS Marketplace Metering Service - AWS Marketplace
Prérequis pour la mesure horaireFormulaire de chargement de produit pour la mesure horaireTester l'intégration et le mode de prévisualisation pour RegisterUsageGestion des erreurs pour RegisterUsage

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

Configuration du 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. Vous pouvez utiliser le AWS Marketplace Metering Service pour le comptage horaire des produits en conteneur. AWS Marketplace Les sections suivantes expliquent comment configurer le comptage horaire avec AWS Marketplace Metering Service.

L'RegisterUsageAPIopération mesure l'utilisation du logiciel par tâche Amazon Elastic Container Service (AmazonECS) ou par pod Amazon Elastic Kubernetes Service (EKSAmazon), 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.

Le AWS Marketplace Metering Control Plane continue de facturer les clients pour l'exécution de ECS tâches Amazon et de EKS pods Amazon, quel que soit l'état de l'abonnement du client. 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.

Rubriques

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 de produit.

    Pour de plus amples informations, veuillez consulter Vue d'ensemble : Création d'un produit en conteneur.

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

  3. (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.

  4. Passez un appel test à l'RegisterUsageAPIopération 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 cette RegisterUsage API opération 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 lançant votre produit sur Amazon ECS ou AmazonEKS. 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 ECS tâche Amazon ou un EKS module Amazon contenant votre conteneur payant dans la région de l'est des États-Unis (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 est compatible avec Amazon ECS et AmazonEKS, il vous suffit de le lancer sur 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'RegisterUsageAPIopération. Les appels suivants provenant de la même ECS tâche Amazon ou du même EKS module Amazon 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'RegisterUsageAPIopération peut générer. Chaque langage AWS SDK de programmation 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.
CustomerNotEntitledException 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 le mesurage de l'utilisation à partir de la plateforme sous-jacente. Seuls Amazon ECS et Amazon EKS AWS Fargate sont pris en charge.
ThrottlingException Les appels vers RegisterUsage sont limités.
InvalidRegionException RegisterUsagedoit être appelé de la même manière Région AWS que la ECS tâche Amazon ou le EKS pod Amazon a été lancé. Cela empêche un conteneur de choisir une région (par exemple, withRegion(“us-east-1”)) lorsqu’il appelle RegisterUsage.