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.
# Tarification de mesure personnalisée pour les produits AMI avec AWS Marketplace Metering Service
Avec le service de mesure AWS Marketplace, vous pouvez modifier votre logiciel pour envoyer les enregistrements de mesure à un point de terminaison afin de capturer l'utilisation. Vous pouvez sélectionner une catégorie d'utilisation et définir jusqu'à 24 dimensions pour cette catégorie. Ces dimensions sont mesurées une fois par heure, agrégées et facturées en fonction d'un plan tarifaire que vous définissez. En tant que vendeur, vous devez déterminer la dimension que vous souhaitez utiliser. Une fois l'AMI publiée, vous ne pouvez plus la modifier. Les sections suivantes fournissent des informations sur AWS Marketplace Metering Service.
**Topics**
+ [Concepts de la fonctionnalité Metering Service](#metering-service-concepts)
+ [Tarification de votre logiciel](#pricing-your-software)
+ [Ajouter votre produit à AWS Marketplace](#listing-your-product-on-aws-marketplace)
+ [Modification de votre logiciel pour utiliser le service de mesure](#modifying-your-software-to-use-the-metering-service)
+ [Étiquetage mesuré par le fournisseur (facultatif)](#ami-vendor-metered-tagging)
+ [Configuration du comptage personnalisé](#configure-custom-metering)
+ [Configuration du comptage personnalisé pour les produits AMI avec AWS Marketplace Metering Service](custom-metering-with-mp-metering-service.md)
## Concepts de la fonctionnalité Metering Service
Avant d'utiliser le service AWS Marketplace Metering, notez les concepts de service importants suivants :
+ **Catégorie d'utilisation** — Tout produit logiciel dont le prix est fixé dans le cadre de l'utilisation du service de mesure est classé selon une catégorie d'utilisation, qui détermine le mode de facturation approprié pour les clients. Les catégories d'utilisation incluent, sans toutefois s'y limiter :
+ **Utilisateurs** : ensemble défini d'autorisations associées à un identifiant unique. Cette catégorie convient pour les logiciels dans lesquels les utilisateurs d'un client se connectent au logiciel directement (par exemple, pour les logiciels CRM ou les rapports d'aide à la décision).
+ **Hôtes** - Tout serveur, nœud, instance, point de terminaison ou toute autre partie d'un système informatique. Cette catégorie convient pour les logiciels qui surveillent ou analysent de nombreuses instances détenues par des clients (par exemple, dans le cadre de la surveillance des performances ou de la sécurité).
+ **Données** - Stockage ou information, mesuré en Mo, Go ou To. Cette catégorie convient pour les logiciels qui gèrent les données stockées ou traitent les données par lots.
+ **Bande passante** : mesurée en Mbits/s ou Gbit/s. Cette catégorie convient aux logiciels qui permettent aux clients de spécifier la quantité de bande passante à fournir.
+ **Unité** — Unité de mesure ; voir les exemples décrits ci-dessous.
+ **Unité d'utilisation — L'unité** d'utilisation spécifique d'un produit logiciel correspond à la catégorie d'utilisation sélectionnée. Cette unité d'utilisation décrit l'unité sur laquelle votre logiciel va se charger. En voici quelques exemples :
+ **NodesHrs**(correspondant à la catégorie Hôtes)
+ **UserHrs**(correspondant à la catégorie d'utilisateur)
+ **GBStored**(correspondant à la catégorie de données)
+ **Consommation** — Les produits logiciels dont le prix est établi dans le cadre de l'utilisation du service de mesure facturent leur consommation de l'une des trois manières suivantes :
+ Provisionné — Le logiciel permet aux clients de configurer une quantité spécifique de ressources à utiliser (par exemple, le nombre d'utilisateurs ou une quantité fixe de bande passante). Toutes les heures, les clients paient pour les ressources qu'ils ont mises en service.
+ Simultané — Le logiciel permet à un nombre illimité d'hôtes ou d'utilisateurs distincts de se connecter au logiciel. Toutes les heures, les clients paient selon le nombre d'hôtes ou d'utilisateurs qui ont accédé au logiciel.
+ Accumulé — Le logiciel permet aux clients d'utiliser n'importe quelle quantité de données, traitées ou stockées. Toutes les heures, les clients paient pour la quantité agrégée.
+ **Tarification** — Les produits logiciels dont le prix est établi dans le cadre de l'utilisation du service de mesure doivent spécifier un prix unique ou définir jusqu'à 24 dimensions, chacune ayant son propre prix. Les détails concernant les options de tarification incluent :
+ Dimension unique — Il s'agit de l'option de tarification la plus simple. Les clients paient un tarif unique par unité de ressources par heure, quel que soit le volume ou la taille (par exemple, 0,014 USD par utilisateur et par heure, ou 0,070 USD par hôte et par heure).
+ Dimensions multiples — Cette option de tarification est appropriée lorsque la catégorie d'utilisation sélectionnée varie selon plusieurs axes. Par exemple, pour la surveillance des hôtes, un tarif différent peut être défini en fonction de la taille de l'hôte. Ou, pour la tarification basée sur l'utilisateur, un prix différent peut être défini en fonction du type d'utilisateur (par exemple, administrateur, utilisateur expérimenté et utilisateur en lecture seule).
+ **Comptage** — Toute utilisation est enregistrée sous forme d'événement de mesure, une fois par heure. Votre logiciel doit être configuré pour envoyer la dimension appropriée et la quantité utilisée à la fonctionnalité AWS Marketplace Metering Service.
+ Allocations — Vous pouvez éventuellement répartir l'utilisation en allocations par propriétés que vous suivez. Ces allocations sont représentées sous forme de balises pour l'acheteur. Les balises permettent à l'acheteur de voir ses coûts répartis en fonction de l'utilisation par étiquette. Par exemple, si vous facturez par utilisateur et que les utilisateurs ont une propriété « Service », vous pouvez créer des allocations d'utilisation avec des balises comportant la clé « Département », et une allocation par valeur. Cette approche ne modifie pas le prix, les dimensions ou l'utilisation totale que vous signalez. Toutefois, il permet à votre client de visualiser ses coûts par catégories correspondant à votre produit.
## Tarification de votre logiciel
Lors de la tarification de votre logiciel avec la fonctionnalité AWS Marketplace Metering Service, vous devez d'abord décider d'une catégorie d'utilisation et de la façon dont celle-ci sera consommée. Le service prend en charge six scénarios de tarification distincts. Vous devez en sélectionner un seul pour votre produit :
+ Utilisateur alloué (par heure)
+ Utilisateur simultané (par heure)
+ Hôte alloué (par heure)
+ Hôte simultané (par heure)
+ Bande passante allouée (par heure)
+ Données cumulées (par heure)
Ensuite, vous devez décider de la tarification de la catégorie d'utilisation sélectionnée :
+ Prix unique
+ Plusieurs dimensions (jusqu'à 24)
[Ajouter votre produit à AWS Marketplace](#listing-your-product-on-aws-marketplace) décrit comment fournir une description conviviale de votre dimension et de votre tarification.
### Exemple : bande passante allouée avec tarification non linéaire
Imaginez que vous offrez un logiciel d'appliance réseau. Vous choisissez de facturer par bande passante allouée. Pour votre catégorie d'utilisation, sélectionnez **Bande passante**. Outre la tarification par bande passante, vous souhaitez facturer un autre tarif lorsque les acheteurs augmentent la capacité. Vous pouvez définir plusieurs dimensions au sein de la catégorie de bande passante. Vous pouvez définir un prix distinct pour 25 Mbits/s, 100 Mbits/s et 1 Gbit/s.
### Exemple : hôtes simultanés avec plusieurs dimensions
Imaginez que vous offrez un logiciel qui surveille d'autres instances Amazon EC2. Vous choisissez de facturer par nombre d'hôtes surveillés. Pour votre catégorie d'utilisation, sélectionnez **Hôte**. Outre la tarification par hôte, vous souhaitez facturer la valeur supplémentaire liée à la surveillance des hôtes plus importants. Vous pouvez utiliser plusieurs dimensions au sein de la catégorie d'hôte. Vous pouvez définir un prix distinct pour les instances micro, petites, moyennes, grandes, très grandes, 2XL, 4XL et 8XL. Votre logiciel est responsable du mappage de chaque hôte donné à l'une de vos dimensions définies. Votre logiciel est responsable de l'envoi d'un enregistrement de mesure distinct pour chaque dimension de votre catégorie d'utilisation, le cas échéant.
## Ajouter votre produit à AWS Marketplace
Pour bénéficier du service de mesure, vous devez créer un nouveau produit AWS Marketplace à mettre en vente. Si votre produit est déjà disponible sur le AWS Marketplace, vous devrez décider si le nouveau produit AWS Marketplace Metering Service sera mis à disposition en plus de votre produit actuel ou s'il remplacera votre produit actuel en tant que seule version disponible pour les nouveaux utilisateurs. Si vous choisissez le remplacement, le produit existant sera retiré du site AWS Marketplace afin qu'il ne soit plus disponible pour les nouveaux acheteurs. Les clients existants continueront à avoir accès à leurs anciens produits et anciennes instances, mais ils pourront migrer vers le nouveau produit à leur convenance. Le nouveau produit doit mesurer l'utilisation d’AWS Marketplace Metering Service, comme décrit dans [Modification de votre logiciel pour utiliser le service de mesure](#modifying-your-software-to-use-the-metering-service).
Une fois que vous avez votre AMI, suivez le processus standard pour partager et analyser votre AMI à l'aide de l'outil en libre-service. En plus d'utiliser le modèle disponible sur le portail de gestion, remplissez le formulaire de chargement de produit et chargez-le pour démarrer le processus d'intégration.
Utilisez les définitions suivantes pour remplir les champs du formulaire de chargement de produit pour le service de mesure AWS Marketplace. Sur le formulaire de chargement du produit, ces champs sont étiquetés « **Flexible Consumption Pricing » (FCP)** afin de les différencier des produits à prix horaire et mensuel.
+ **Titre** — Si vous avez déjà un produit AWS Marketplace et que vous ajoutez le même produit avec le AWS Marketplace Metering Service, incluez la catégorie et la dimension FCP entre parenthèses pour les différencier (par exemple, « TITRE DU PRODUIT (données) »).
+ **Modèle de tarification** **: dans la liste déroulante, sélectionnez Utilisation.**
+ Catégorie **FCP : catégorie** dans laquelle les clients sont facturés pour les produits payants avec une composante de tarification **d'utilisation**. Dans la liste déroulante, sélectionnez **Utilisateurs**, **Hôtes**, **Données** ou **Bande passante**.
+ Unité **FCP : unité** de mesure selon laquelle les clients sont facturés pour les produits payants avec une composante de tarification **d'utilisation**. Les options apparaîtront dans la liste déroulante en fonction de la catégorie FCP que vous avez sélectionnée. Le tableau suivant répertorie les unités valides pour chaque catégorie.
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/marketplace/latest/userguide/custom-metering-pricing-ami-products.html)
+ Nom de **la dimension FCP : nom** utilisé lors de l'envoi des enregistrements de mesure en appelant l'`MeterUsage`opération. Il est visible dans les rapports de facturation. Cependant, comme il n'est pas orienté vers l'extérieur, le nom n'a pas besoin d'être convivial. Le nom ne doit pas dépasser 15 caractères et peut contenir uniquement des caractères alphanumériques et des traits de soulignement. Une fois que vous avez défini le nom et rendu le produit public, vous ne pouvez pas le modifier. La modification du nom nécessite une nouvelle AMI.
+ **Description de la dimension FCP** : déclaration destinée au client qui décrit les dimensions du produit. La description (ne peut pas comporter plus de 70 caractères) et doit être conviviale. Voici des exemples de descriptions : Administrateurs par heure et par Mbits/s de bande passante provisionnée. Une fois le produit publié, vous ne pouvez pas modifier cette description.
+ **Taux FCP** : frais logiciels par unité pour ce produit. Ce champ prend en charge huit décimales.
**Remarques :**
Vous n'avez pas besoin de remplir les champs de tarification horaire et annuelle.
L'essai gratuit et le prix annuel ne sont pas compatibles.
Les produits qui utilisent une AMI et la fonctionnalité Clusters et AWS ressources ne peuvent pas utiliser le service de mesure AWS Marketplace.
Le prix, le type d'instance ou le Région AWS changement suivront le même processus que les autres AWS Marketplace produits.
Les produits dotés du service AWS Marketplace Metering ne peuvent pas être convertis vers d'autres modèles de tarification tels que la tarification horaire, mensuelle ou la licence Bring Your Own (BYOL).
AWS Marketplace recommande d'ajouter des informations de politique IAM dans vos instructions d'utilisation ou dans votre document.
Vous pouvez inclure jusqu'à 24 dimensions FCP au total. Une fois créées et publiées, vous ne pouvez pas modifier les dimensions existantes, mais vous pouvez en ajouter de nouvelles (dans la limite de 24).
En cas de question, contactez l'équipe responsable des [AWS Marketplace opérations vendeur ](https://aws.amazon.com/marketplace/management/contact-us/).
## Modification de votre logiciel pour utiliser le service de mesure
Vous devrez modifier votre logiciel pour enregistrer l'utilisation par les clients, envoyer des rapports d'utilisation horaire au service de mesure et gérer de nouveaux modes d'échec. Le logiciel fonctionne indépendamment de la tarification, mais il devra connaître la catégorie d'utilisation, la manière dont il est consommé et les dimensions éventuelles.
### Mesure de la consommation
Votre logiciel doit déterminer la quantité de catégorie d'utilisation sélectionnée et les dimensions consommées par le client. Cette valeur sera envoyée, une fois par heure, à la fonctionnalité Metering Service. Dans tous les cas, il est supposé que votre logiciel est capable de mesurer, d'enregistrer et de lire la consommation de ressources dans le but de l'envoyer toutes les heures au service de comptage.
Pour la consommation allouée, ces informations seront généralement lues à partir de la configuration logicielle en tant que valeur échantillonnée, mais elles peuvent également être une valeur maximale configurée, enregistrée toutes les heures. Pour la consommation simultanée, cela peut être un échantillon périodique ou une valeur maximale enregistrée toutes les heures. Pour la consommation cumulée, ce sera une valeur accumulée toutes les heures.
Pour la tarification sur plusieurs dimensions, plusieurs valeurs doivent être mesurées et envoyées au service de mesure, une par dimension. Pour cela, votre logiciel doit être programmé ou configuré avec l'ensemble de dimensions connu lorsque vous avez fourni l'AMI. L'ensemble de dimensions ne peut pas changer une fois le produit créé.
Pour chaque scénario de tarification, le tableau suivant décrit les méthodes recommandées pour mesurer la consommation par heure.
| **Scénario** | **Comment mesurer** |
| --- | --- |
| Utilisateur alloué | Nombre actuel d'utilisateurs alloués (échantillonnés). -OU- Nombre maximal d'utilisateurs alloués (observés au cours de cette heure). |
| Utilisateur simultané | Nombre actuel d'utilisateurs simultanés (échantillonnés). -OU- Nombre maximal d'utilisateurs simultanés (observés au cours de cette heure). -OU- Nombre total d'utilisateurs distincts (observés au cours de cette heure). |
| Hôte alloué | Nombre actuel d'hôtes alloués (échantillonnés). -OU- Nombre maximal d'hôtes alloués (observés au cours de cette heure). |
| Hôte simultané | Nombre actuel d'hôtes simultanés (échantillonnés). -OU- Nombre maximal d'hôtes simultanés (observés au cours de cette heure). -OU- Nombre total d'hôtes distincts (observés au cours de cette heure). |
| Bande passante allouée | Paramètre de bande passante allouée actuelle (échantillonnée). -OU- Bande passante maximum allouée (observée au cours de cette heure). |
| Données accumulées | Go actuels de données stockées (échantillonnées). -OU- Go maximum de données stockées (observés au cours de cette heure). -OU- Total de Go des données ajoutées ou traitées au cours de cette heure. -OU- Total de Go de données traitées au cours de cette heure. |
## Étiquetage mesuré par le fournisseur (facultatif)
Le balisage mesuré par le fournisseur aide les fournisseurs de logiciels indépendants (ISVs) à donner à l'acheteur un aperçu plus précis de l'utilisation de ses logiciels et peut l'aider à répartir les coûts.
Pour étiqueter l'utilisation du logiciel par un acheteur, vous devez déterminer comment les coûts sont répartis. Demandez d'abord à vos acheteurs ce qu'ils souhaitent voir dans leur répartition des coûts. Vous pouvez ensuite répartir l'utilisation entre les propriétés que vous suivez pour le compte de l'acheteur. Les exemples de propriétés incluent `Account ID``Business Unit`,`Cost Centers`, et d'autres métadonnées pertinentes pour votre produit. Ces propriétés sont présentées à l'acheteur sous forme de balises. À l'aide de balises, les acheteurs peuvent voir leurs coûts répartis en fonction de l'utilisation selon les valeurs des balises dans leur console AWS de facturation ([https://console.aws.amazon.com/costmanagement/](https://console.aws.amazon.com/costmanagement/)). Le balisage mesuré par le fournisseur ne modifie pas le prix, les dimensions ou l'utilisation totale que vous signalez. Il permet à votre client de consulter ses coûts par catégories correspondant à votre produit.
Dans un cas d'utilisation courant, un acheteur s'abonne à votre produit avec un Compte AWS abonnement. L'acheteur possède également de nombreux utilisateurs associés au même abonnement au produit. Vous pouvez créer des allocations d'utilisation à l'aide de balises dotées d'une clé de`Account ID`, puis attribuer l'utilisation à chaque utilisateur. Dans ce cas, les acheteurs peuvent activer le `Account ID` tag dans leur console Billing and Cost Management et analyser l'utilisation individuelle des utilisateurs.
### Expérience du vendeur
Les vendeurs peuvent agréger les relevés de mesure des ressources avec le même ensemble de balises au lieu d'agréger l'utilisation de toutes les ressources. Par exemple, les vendeurs peuvent créer le registre des compteurs qui inclut différents compartiments de. `UsageAllocations` Chaque compartiment `UsageQuantity` représente un ensemble de balises, telles que `AccountId` et`BusinessUnit`.
Dans le schéma suivant, la **ressource 1** possède un ensemble unique de `BusinessUnit` balises `AccountId` et apparaît dans l'**enregistrement de mesure sous** la forme d'une entrée unique.
La **ressource 2** et la **ressource 3** ont toutes deux le même `AccountId` tag`2222`, et le même `BusinessUnit` tag,`Operations`. Par conséquent, ils sont combinés en une seule `UsageAllocations` entrée dans le **registre de mesure**.
![\[Schéma montrant comment les étiquettes de mesure des fournisseurs combinent les données d'utilisation. Trois ressources (ressource 1, 2 et 3) différentes AccountIds BusinessUnits sont consolidées dans un seul enregistrement de mesure, UsageAllocations regroupées par AccountId et BusinessUnit avant d'être envoyées au AWS Marketplace Metering Service.\]](http://docs.aws.amazon.com/fr_fr/marketplace/latest/userguide/images/seller-vendor-meter-tag.png)
Les vendeurs peuvent également combiner des ressources sans étiquette en une seule `UsageAllocation` avec la quantité d'utilisation allouée et l'envoyer comme l'une des entrées`UsageAllocations`.
Les limites incluent :
+ Nombre de tags : 5
+ Taille de `UsageAllocations` (cardinalité) — 2 500
Les validations incluent :
+ Caractères autorisés pour la clé et la valeur du tag : a-zA-Z 0-9\$1 -= . \$1 : \$1 /@
+ Nombre maximum de balises dans `UsageAllocation` la liste : 5
+ Deux ne `UsageAllocations` peuvent pas avoir les mêmes balises (c'est-à-dire la même combinaison de clés et de valeurs de balise). Si tel est le cas, ils doivent utiliser le même`UsageAllocation`.
+ La somme `AllocatedUsageQuantity` de `UsageAllocation` doit être égale à`UsageQuantity`, qui est l'utilisation agrégée.
### Expérience d'acheteur
Le tableau suivant montre un exemple de l'expérience de l'acheteur après qu'un acheteur a activé les tags `AccountId` et `BusinessUnit` vendor.
Dans cet exemple, l'acheteur peut voir l'utilisation allouée dans son **rapport d'utilisation des coûts**. Les balises mesurées par le fournisseur utilisent le préfixe. `“aws:marketplace:isv”` Les acheteurs peuvent les activer dans le Billing and Cost Management, sous **Cost Allocation Tags**, sous les **balises de répartition des coûts AWS générées**.
Les première et dernière lignes du **rapport d'utilisation des coûts** concernent ce que le vendeur envoie au service de comptage (comme indiqué dans l'[Expérience du vendeur](container-metering-meterusage.md#container-vendor-metered-tag-seller)exemple).
**Rapport d'utilisation des coûts (simplifié)**
| ProductCode | Acheteur | UsageDimension | UsageQuantity | `aws:marketplace:isv:AccountId ` | `aws:marketplace:isv:BusinessUnit` |
| --- | --- | --- | --- | --- | --- |
| xyz | 111122223333 | Réseau : par (Go) inspecté | 70 | 2222 | Opérations |
| xyz | 111122223333 | Réseau : par (Go) inspecté | 30 | 3333 | Finance |
| xyz | 111122223333 | Réseau : par (Go) inspecté | 20 | 4444 | IT |
| xyz | 111122223333 | Réseau : par (Go) inspecté | 20 | 5555 | Marketing |
| xyz | 111122223333 | Réseau : par (Go) inspecté | 30 | 1111 | Marketing |
Pour un exemple de code, voir [`MeterUsage`avec balisage de répartition de l'utilisation (facultatif)](custom-metering-with-mp-metering-service.md#ami-meterusage-code-example)
## Configuration du comptage personnalisé
Pour plus d'informations sur l'utilisation d'AWS Marketplace Metering Service, consultez[Configuration du comptage personnalisé pour les produits AMI avec AWS Marketplace Metering Service](custom-metering-with-mp-metering-service.md).
# Configuration du comptage personnalisé pour les produits AMI avec AWS Marketplace Metering Service
**Note**
Pour les produits basés sur l'AMI avec des tarifs de mesure personnalisés, votre logiciel doit appeler l'[MeterUsage API](https://docs.aws.amazon.com/marketplace/latest/APIReference/API_marketplace-metering_MeterUsage.html) à l'aide des AWS informations d'identification temporaires du rôle IAM pour Amazon Elastic Compute Cloud connecté à l'instance Amazon EC2. L'utilisation de clés d'accès à long terme n'est pas prise en charge.
Le service AWS Marketplace Metering est une fonctionnalité de tarification et de mesure que vous pouvez utiliser pour facturer directement votre logiciel par catégorie d'utilisation. Il existe cinq catégories d'utilisation : les utilisateurs, les données, la bande passante, les hôtes ou les unités. Vous pouvez utiliser le service de mesure avec des produits basés sur Amazon Machine Image (AMI), des conteneurs et des produits basés sur le logiciel en tant que service (SaaS). Les sections suivantes fournissent plus d'informations sur la façon de configurer le comptage personnalisé avec AWS Marketplace Metering Service.
La fonctionnalité AWS Marketplace Metering Service autorise plusieurs nouveaux scénarios. Par exemple, si votre logiciel surveille les hôtes, vous pouvez facturer pour chaque hôte surveillé. Vous pouvez appliquer différents prix en fonction de la taille de l'hôte et facturer pour le nombre d'hôtes simultanés surveillés toutes les heures. De même, si votre logiciel permet à de nombreux utilisateurs d'une organisation de se connecter, vous pouvez facturer selon le nombre d'utilisateurs. Chaque heure, le client est facturé pour le nombre total d'utilisateurs alloués.
Pour de plus amples informations, veuillez consulter le document [https://docs.aws.amazon.com/marketplacemetering/latest/APIReference/Welcome.html](https://docs.aws.amazon.com/marketplacemetering/latest/APIReference/Welcome.html).
*Pour plus d'informations sur l'intégration de AWS Marketplace Metering Service l'API pour les produits basés sur l'AMI avec des tarifs de mesure personnalisés, consultez le laboratoire Lister les [produits AMI vendus par unités personnalisées](https://catalog.workshops.aws/mpseller/en-US/ami/list-ami-custom-units) de l'AWS Marketplace atelier des vendeurs.*
**Topics**
+ [Exigences](#metering-service-requirements)
+ [Appeler AWS Marketplace Metering Service](#call-aws-marketplace-metering-service)
+ [Gestion des défaillances](#important-information-about-failure-handling)
+ [Limitations](#limitations)
+ [Exemple de code](#ami-metering-code-example)
## Exigences
Tous les logiciels basés sur des AMI qui utilisent cette fonctionnalité doivent répondre aux exigences suivantes :
+ Votre logiciel doit être lancé AWS Marketplace via une Amazon Machine Image (AMI).
+ Si vous avez un produit existant dans AWS Marketplace, vous devez soumettre une nouvelle AMI et créer un nouveau produit pour activer cette fonctionnalité.
+ Tous les logiciels doivent être dotés d'un rôle Gestion des identités et des accès AWS (IAM). Le client final doit ajouter un rôle IAM à l'instance Amazon Elastic Compute Cloud (Amazon EC2) que l'utilisateur met en service avec le logiciel. L'utilisation d'un rôle IAM est facultative lorsque vous déployez un logiciel via AWS Marketplace. Cela est nécessaire lorsque vous déployez le logiciel AWS Marketplace Metering Service.
+ Votre logiciel doit être en mesure de déterminer la consommation d'une manière ou d'une autre.
## Appeler AWS Marketplace Metering Service
Votre logiciel doit appeler le service de mesure toutes les heures et enregistrer la valeur de la consommation pour cette heure.
Lorsque votre logiciel démarre, il doit enregistrer le minute-of-the-hour moment où il a démarré. C'est ce que l'on appelle la *minute de début.* Chaque heure pendant la minute de début, votre logiciel doit déterminer la valeur de consommation pour cette heure et appeler le service de mesure. Pour plus d'informations sur la façon d'obtenir cette valeur, consultez la section [Modification de votre logiciel pour utiliser le service de mesure](https://docs.aws.amazon.com/marketplace/latest/userguide/custom-metering-pricing-ami-products.html#modifying-your-software-to-use-the-metering-service).
Pour se réveiller toutes les heures à la minute de début, votre logiciel doit utiliser l'une des approches suivantes :
+ Un thread au sein de votre logiciel.
+ Un processus démon qui démarre avec l'instance ou le logiciel.
+ Une tâche cron qui est configurée au démarrage de l'application.
**Note**
Votre logiciel doit appeler la fonctionnalité AWS Marketplace Metering Service à l'aide du rôle IAM configuré sur l'instance du client et spécifier la consommation et la quantité.
Votre logiciel peut utiliser le AWS SDK pour appeler le service de mesure AWS Marketplace, comme dans l'exemple d'implémentation suivant :
1. Utilisez le profil d'instance pour créer un client de service. Pour cela, le rôle doit être configuré pour l'instance EC2. Les informations d'identification du rôle sont actualisées automatiquement par le kit de développement logiciel (SDK).
1. Toutes les heures, lisez la configuration et l'état du logiciel afin de déterminer les valeurs de consommation pour cette heure. Cela peut inclure la collecte d'un value-per-dimension.
1. Appelez la méthode `meterUsage` sur le client SDK avec les paramètres suivants (appel supplémentaire pour chaque dimension ayant une utilisation) :
+ `timestamp`— Horodatage de l'heure enregistrée (en UTC).
+ `productCode`— Code produit attribué au logiciel.
+ `dimension`— Dimension (ou dimensions) attribuée au logiciel.
+ `quantity`— Valeur de consommation par heure.
+ `allocations`— (Facultatif) Vous pouvez fournir des allocations pour l'utilisation entre les propriétés que vous suivez. La somme de ces allocations doit correspondre à la consommation totale indiquée dans le registre. Pour l'acheteur, ceux-ci s'affichent sous forme de balises de répartition des coûts potentielles dans ses outils de facturation (tels que la AWS Billing and Cost Management console). L'acheteur doit activer les tags dans son compte afin de suivre ses coûts à l'aide de ces tags.
En outre, votre logiciel doit appeler un point de terminaison AWS Marketplace Metering Service local. Votre produit doit disposer d'un point de terminaison régional correctement configuré. Il `us-east-1` envoie donc des enregistrements à un `us-east-1` point de terminaison et `us-west-2` envoie des enregistrements à un `us-west-2` point de terminaison. Les appels locaux offrent aux acheteurs une expérience plus stable et évitent les situations dans lesquelles la disponibilité d'une région indépendante pourrait avoir un impact sur les logiciels exécutés dans une autre région.
Lorsque vous envoyez des enregistrements de mesure au service, vous devez vous connecter au service de mesure AWS Marketplace de votre région. Utilisez la méthode `getCurrentRegion()` d'assistance pour déterminer la région dans laquelle l'instance EC2 s'exécute, puis transmettez ces informations de région au `MeteringServiceClient` constructeur. Si vous n'en spécifiez pas Région AWS dans le constructeur du SDK, la `us-east-1` région par défaut est utilisée. Si votre application tente de passer des appels interrégionaux vers le service, les appels sont rejetés. Pour plus d'informations, voir [Déterminer la région actuelle d'une application](https://java.awsblog.com/post/Tx3GBOIEN1JJMQ5/Determining-an-Application-s-Current-Region) et [getCurrentRegion()](https://docs.aws.amazon.com/AWSJavaSDK/latest/javadoc/com/amazonaws/regions/Regions.html#getCurrentRegion()).
## Gestion des défaillances
Votre produit doit envoyer des enregistrements de mesure au service, un point de terminaison Internet public, afin que l'utilisation soit collectée et facturée. Étant donné qu'il est possible pour un client de modifier les paramètres réseau de façon à empêcher la livraison de vos enregistrements de mesure, votre produit doit en tenir compte en choisissant un mode d'échec.
**Note**
Certaines défaillances de mesure peuvent être des problèmes transitoires liés à la connexion au. AWS Marketplace Metering Service AWS Marketplace recommande vivement d'implémenter des tentatives d'une durée maximale de 30 minutes, avec des interruptions exponentielles, afin d'éviter les pannes de courte durée ou les problèmes de réseau.
En général, les logiciels peuvent échouer et rester ouverts (fournir un message d'avertissement mais conserver des fonctionnalités complètes) ou échouer et se fermer (désactiver toutes les fonctionnalités de l'application jusqu'à ce qu'une connexion ait été rétablie). Vous pouvez choisir d'échouer et de rester ouvert ou fermé, ou autre chose qui soit propre à votre application. Nous vous recommandons vivement de ne pas choisir l'échec avec fermeture après moins de deux heures d'échecs de mesure.
À titre d'exemple d'échec partiellement ouvert, vous pouvez continuer à autoriser l'accès au logiciel, mais sans autoriser l'acheteur à modifier les paramètres de logiciel. Ou bien, un acheteur pourrait toujours accéder au logiciel mais ne serait pas en mesure de créer des utilisateurs supplémentaires. Votre logiciel est chargé de définir et d'appliquer ce mode d'échec. Le mode d'échec de votre logiciel doit être inclus lorsque votre AMI est envoyée, et il ne peut pas être modifié ultérieurement.
## Limitations
Gardez ces limitations à l'esprit lors de la conception et la présentation de votre logiciel compatible avec Metering Service :
+ **Exigences relatives au rôle IAM et à la passerelle Internet pour vos clients** — Vos clients doivent disposer d'une passerelle Internet et lancer votre logiciel avec un rôle IAM avec des autorisations spécifiques. Pour de plus amples informations, veuillez consulter [AWS Marketplace autorisations de l'API de mesure et d'autorisation](iam-user-policy-for-aws-marketplace-actions.md). Votre logiciel ne peut pas se connecter au service de mesure si ces deux conditions ne sont pas remplies.
+ **Impossibilité d'ajouter une nouvelle catégorie d'utilisation ou de modifier une catégorie d'utilisation à un produit de service de mesure existant** — Lorsque les clients s'abonnent à votre produit logiciel, ils acceptent les termes et conditions. La modification des catégories d'utilisation des produits avec le service de mesure nécessite un nouveau produit et un nouvel abonnement.
+ **Impossibilité de modifier les dimensions d'un produit de service de mesure existant** — Lorsque les clients s'abonnent à votre produit logiciel, ils acceptent les termes et conditions. Le modification des dimensions d'un produit à l'aide du Metering Service exige un nouveau produit et un nouvel abonnement. Vous *pouvez* ajouter de nouvelles dimensions aux produits existants, dans la limite de 24.
+ **Absence d'essai gratuit et d'abonnements annuels** : les produits Metering Service ne prennent pas en charge les essais gratuits ni les abonnements annuels au lancement.
+ **Considérations relatives au déploiement multi-instance ou basé sur des clusters** — Certains logiciels sont déployés dans le cadre d'un déploiement multi-instance. Lorsque vous concevez votre logiciel, voyez comment et où la consommation est mesurée et où les enregistrements de mesure sont émis.
## Exemple de code
L'exemple de code suivant est fourni pour vous aider à intégrer votre produit AMI aux éléments AWS Marketplace APIs nécessaires à la publication et à la maintenance de votre produit.
### `MeterUsage`avec balisage de répartition de l'utilisation (facultatif)
L'exemple de code suivant est pertinent pour les produits AMI dotés de modèles de tarification à la consommation. L'exemple Python envoie un enregistrement de mesure avec les balises d'allocation d'utilisation appropriées AWS Marketplace pour facturer des pay-as-you-go frais à vos clients.
```
# 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
)
```
Pour plus d'informations à ce sujet`MeterUsage`, consultez [MeterUsage](https://docs.aws.amazon.com/marketplacemetering/latest/APIReference/API_MeterUsage.html)la *référence de AWS Marketplace l'API du service de mesure*.
### Exemple de réponse
```
{ "MeteringRecordId": "string" }
```