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 des produits AMI pour AWS Marketplace
AWS Marketplace propose plusieurs modèles de tarification pour les produits Amazon Machine Image (AMI). Avec les offres privées vendeur, il existe des options pour les contrats de durée pluriannuelle et personnalisée. Pour plus d'informations sur les contrats pluriannuels ou à durée personnalisée, consultez [Préparation d'une offre privée pour votre AWS Marketplace produit](private-offers-overview.md) et [Plans de versement d'offres privées](installment-plans.md). Les sections suivantes fournissent des informations sur les modèles de tarification pour les produits basés sur l'AMI.
**Note**
Vous devez être en mesure de fournir un formulaire fiscal W-9 (pour les entités basées aux États-Unis) ou un formulaire W-8 (pour les entités basées dans l'UE) comme décrit dans. [S'inscrire en tant que vendeur sur AWS Marketplace](seller-account-registering.md)
**Topics**
+ [Modèles de tarification AMI](#pricing-models-for-ami-products)
+ [AWS frais et frais logiciels](#aws-charges-vs-software-charges)
+ [Tarification de mesure personnalisée pour les produits AMI avec AWS Marketplace Metering Service](custom-metering-pricing-ami-products.md)
+ [Tarification contractuelle pour les produits AMI sur AWS Marketplace](ami-contracts.md)
+ [Associer des licences à des produits basés sur l'AMI à l'aide de AWS License Manager](ami-license-manager-integration.md)
## Modèles de tarification AMI
Le tableau suivant fournit des informations générales sur les modèles de tarification pour les produits basés sur l'AMI.
| Modèle de tarification | Description |
| --- | --- |
| Free | Les clients peuvent exécuter autant d'instances qu'Amazon Elastic Compute Cloud (Amazon EC2) prend en charge, sans frais logiciels supplémentaires. L'essai gratuit et le prix annuel ne peuvent pas être combinés avec le prix mensuel. |
| Bring Your Own License (BYOL ou Licence à fournir) | AWS Marketplace ne facture pas aux clients l'utilisation du logiciel, mais les clients doivent fournir une clé de licence pour activer le produit. Cette clé est achetée en dehors de AWS Marketplace. Les droits et l'application des licences, en plus de tous les prix et de la facturation, sont gérés par vous. |
| Payé à l'heure ou à l'heure annuelle | **Horaire** — Le logiciel est facturé à l'heure. Chaque type d'instance peut être facturé différemment (mais ce n'est pas obligatoire), et l'utilisation est arrondie à l'heure complète la plus proche. **Toutes les heures avec essai gratuit** — Les clients sont limités à l'exécution d'une seule instance du logiciel sans frais. Vous définissez la durée, entre 5 et 30 jours. L'essai gratuit s'applique au type d'instance le plus cher qui est en cours d'exécution et toute utilisation simultanée en dehors de cette instance est facturée au taux horaire. REMARQUE : Il s'agit d'un modèle différent du niveau AWS gratuit pour l' EC2 utilisation d'Amazon, qui permet aux clients de bénéficier de 750 heures d'utilisation gratuite par mois. **Horaire et mensuel** — Les frais horaires et mensuels sont appliqués indépendamment. Les frais mensuels sont facturés chaque mois, quelle que soit l'utilisation, et les frais horaires sont appliqués en fonction de l'utilisation horaire uniquement. **Horaire ou annuel** : les clients ont la possibilité d'acheter à l'avance l'équivalent d'un an d'utilisation pour une EC2 instance Amazon d'un type d'instance. Vous définissez la tarification de chaque type d'instance et pouvez offrir des économies nettes sur le tarif horaire. Toute utilisation par le client qui dépasse le nombre d'abonnements annuels achetés est facturée au taux horaire défini par vous pour ce type d'instance. **Horaire avec durée pluriannuelle et personnalisée** — Ce type d'offre n'est disponible que par le biais d'offres privées du vendeur. À l'aide des offres privées des vendeurs, vous spécifiez une durée de contrat personnalisée allant jusqu'à 3 ans. Vous pouvez spécifier un paiement initial ou inclure un calendrier de paiement flexible. Vous définissez la tarification pour chaque type d'instance. S'il existe un calendrier de paiement flexible dans l'offre, vous définissez également les dates de facturation, les montants de paiement et le nombre d'instances pour chaque type d'instance inclus dans l'offre. Pour une offre privée de vendeur active avec un calendrier de paiement flexible, une fois que le client a lancé le nombre spécifié d'instances, toutes les instances supplémentaires lancées sont facturées au taux horaire spécifié dans l'offre privée du vendeur. Pour plus d'informations sur les contrats pluriannuels ou à durée personnalisée, consultez [Préparation d'une offre privée pour votre AWS Marketplace produit](private-offers-overview.md) et [Plans de versement d'offres privées](installment-plans.md). **Horaire avec abonnement annuel (essai gratuit inclus)** : ce modèle est identique au modèle horaire avec option annuelle, sauf qu'il inclut un essai gratuit permettant au client d'exécuter gratuitement une instance de n'importe quel type d'instance pendant un nombre de jours défini que vous déterminez. Les abonnements annuels peuvent être achetés à tout moment et ils sont combinés à l'abonnement de type Essai gratuit. **Annuel avec horaire** — Identique au modèle de tarification horaire avec annuel. Les clients ont la possibilité d'acheter à l'avance l'équivalent d'un an d'utilisation pour une EC2 instance Amazon d'un type d'instance. Vous définissez le prix pour chaque type d'instance et pouvez proposer des économies nettes par rapport au prix horaire, mais il n'est pas obligatoire de proposer des économies. Toute utilisation par le client qui dépasse le nombre d'abonnements annuels achetés est facturée au taux horaire défini par vous pour ce type d'instance. **Durée pluriannuelle et personnalisée avec heure** — Ceci n'est disponible que via[Préparation d'une offre privée pour votre AWS Marketplace produit](private-offers-overview.md). En utilisant les offres privées des vendeurs, vous pouvez spécifier un contrat de durée personnalisé de trois ans maximum. Vous pouvez exiger un paiement initial ou proposer un calendrier de paiement flexible au client. Vous définissez la tarification pour chaque type d'instance pendant la durée du contrat et la tarification horaire pour les instances supplémentaires lancées. Si vous proposez un calendrier de paiement flexible, vous définissez également les dates de facturation, les montants de paiement et le nombre d'instances pour chaque type d'instance inclus dans l'offre. Pour une offre privée active avec un calendrier de paiement flexible, une fois que le nombre spécifié d'instances a été lancé, toutes les instances supplémentaires lancées par le client sont facturées au taux horaire spécifié dans l'offre privée. Pour plus d'informations sur les contrats pluriannuels ou à durée personnalisée, consultez [Préparation d'une offre privée pour votre AWS Marketplace produit](private-offers-overview.md) et [Plans de versement d'offres privées](installment-plans.md). L'essai gratuit et le prix annuel ne peuvent pas être combinés avec le prix mensuel. |
| Payé mensuellement | **Mensuel** — Le logiciel est payé sur une base mensuelle fixe, quel que soit le nombre d'instances exécutées par le client. Les frais mensuels sont calculés au prorata à l'inscription et au moment de l'annulation. Exemple : un client qui s'abonne pour 1 jour du mois sera facturé pour un trentième du mois. **Mensuel avec horaire** — Les frais horaires et mensuels sont appliqués indépendamment. Les frais mensuels sont facturés chaque mois, quelle que soit l'utilisation, et les frais horaires sont appliqués en fonction de l'utilisation horaire uniquement. L'essai gratuit et le prix annuel ne peuvent pas être combinés avec le prix mensuel. |
| Tarification d'utilisation payante | Le logiciel est directement facturé en fonction de la valeur que vous fournissez, ainsi que de l'une des quatre catégories d'utilisation suivantes : utilisateurs, données, bande passante ou hôtes. Vous pouvez définir jusqu'à 24 dimensions pour le produit. Tous les frais continuent à être engagés à l'heure par le client. Toute utilisation est calculée mensuellement et facturée mensuellement en utilisant le même mécanisme que les AWS Marketplace logiciels existants. La tarification d'utilisation est également appelée AWS Marketplace Metering Service. |
| Modèle de tarification des contrats | **AMI avec tarification contractuelle** : produit à AMI unique ou AMI unique avec AWS CloudFormation pile pour lequel l'acheteur paie des frais initiaux. |
## AWS frais et frais logiciels
Les frais de produits basés sur Amazon Machine Image (AMI) se répartissent en deux catégories :
+ **Détails de la tarification de l'infrastructure** — Tous les produits basés sur l'AMI entraînent des frais AWS d'infrastructure associés en fonction des services et de l'infrastructure utilisés. Ces taux et frais sont définis et contrôlés par AWS, et peuvent varier entre les deux Régions AWS. Pour en savoir plus, consultez [Tarification Amazon EC2](https://aws.amazon.com/ec2/pricing/).
+ **Détails du prix du logiciel** — Pour les produits payants, le vendeur définit les frais d'utilisation du logiciel.
Ces deux catégories de frais de produit sont affichées séparément sur les pages AWS Marketplace détaillées afin d'aider les acheteurs à comprendre le coût potentiel de l'utilisation des produits.
### Essai gratuit pour les produits horaires AMI
Les produits AMI Hourly sont éligibles au programme d'essai gratuit optionnel. Dans le cadre d'un essai gratuit, un client peut s'abonner au produit et utiliser une seule instance pendant 31 jours au maximum sans payer de frais logiciels sur le produit. Les frais AWS d'infrastructure applicables continuent de s'appliquer. Les essais gratuits seront automatiquement convertis en abonnement payant à leur expiration. Les clients seront facturés pour toute utilisation supplémentaire au-delà des unités gratuites fournies. Pour proposer un essai gratuit d'un produit toutes les heures, définissez la durée de la période d'essai et informez-en l'équipe [des opérations AWS Marketplace vendeurs](https://aws.amazon.com/marketplace/management/contact-us/). La période d'essai peut être de 5 à 31 jours.
Lorsque les clients s'abonnent à un produit d'essai gratuit, ils reçoivent un e-mail de bienvenue indiquant la durée de l'essai gratuit, une date d'expiration calculée et des informations sur le désabonnement. Un e-mail de rappel est envoyé trois jours avant la date d'expiration.
Si vous proposez un produit d'essai gratuit en AWS Marketplace, vous acceptez les politiques de remboursement spécifiques décrites dans la section **Politique de remboursement**.
### Ressources supplémentaires
Pour plus d'informations sur la tarification des produits AMI, consultez les rubriques suivantes :
+ [Tarification de mesure personnalisée pour les produits AMI avec AWS Marketplace Metering Service](custom-metering-pricing-ami-products.md)
+ [Tarification contractuelle pour les produits AMI sur AWS Marketplace](ami-contracts.md)
Pour plus d'informations sur les intégrations de facturation, de mesure et de licence pour les produits basés sur l'AMI, consultez les rubriques suivantes :
à propos de la tarification des produits AMI, consultez les rubriques suivantes :
+ [Configuration du comptage personnalisé pour les produits AMI avec AWS Marketplace Metering Service](custom-metering-with-mp-metering-service.md)
+ [Associer des licences à des produits basés sur l'AMI à l'aide de AWS License Manager](ami-license-manager-integration.md)
# 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" }
```
# Tarification contractuelle pour les produits AMI sur AWS Marketplace
La tarification contractuelle pour les produits basés sur Amazon Machine Image (AMI) signifie que l'acheteur paie des frais initiaux pour un seul produit AMI ou une seule AMI avec AWS CloudFormation stack. Pour les produits basés sur l'AMI dont la tarification est contractuelle, AWS Marketplace facturez vos clients à l'avance ou selon le calendrier de paiement que vous définissez, en fonction du contrat conclu entre vous et votre client. À partir de ce moment, les clients sont autorisés à utiliser ces ressources. Cette rubrique fournit plus d'informations sur la tarification des contrats.
Pour définir vos prix, choisissez une ou plusieurs durées de contrat que vous proposez aux clients. Vous pouvez entrer des prix différents pour chaque durée de contrat. Vos options sont des durées de 1 mois, 12 mois, 24 mois et 36 mois. Pour les offres privées, vous pouvez définir une durée personnalisée en mois (jusqu'à 60 mois).
**Note**
Les essais gratuits ne sont pas disponibles pour les produits AMI dont les prix sont contractuels.
Choisissez la catégorie qui décrit le mieux la tarification de votre produit. La catégorie de prix apparaît aux clients sur le AWS Marketplace site Web. Vous pouvez choisir entre la **bande passante** (GB/s, MB/s), **les données** (Go, Mo, To), les **hôtes**, les **demandes**, les **niveaux** ou **les utilisateurs**. Si aucune des catégories prédéfinies ne correspond à vos besoins, vous pouvez choisir la catégorie **Unités** plus générique.
L'offre permet d'y ajouter jusqu'à 24 dimensions. Chaque dimension nécessite les données suivantes :
+ **Catégorie de contrats** — Pour les produits contractuels dont la tarification n'est pas basée sur la consommation, vous pouvez choisir une catégorie qui ressemble le plus à la catégorie ou à la dimension du contrat ou choisir des **unités** si aucune valeur ne ressemble aux unités de la dimension du contrat.
+ **Unité des contrats** : choisissez l'une des valeurs disponibles pour les unités correspondant le mieux à vos dimensions en fonction de la catégorie sélectionnée.
+ **Dimension des contrats autorisant les achats multiples** — Ce champ est utilisé pour indiquer si une offre est une offre tarifaire échelonnée ou non hiérarchisée :
Offre échelonnée — Permet à l'acheteur de souscrire à une seule des dimensions disponibles dans l'offre. Les dimensions d'une offre à plusieurs niveaux ne sont pas fondées sur le concept de quantité. La signature d'un contrat avec une dimension spécifique indique essentiellement que l'acheteur a choisi la caractéristique spécifique indiquée par cette dimension.
Offre non échelonnée — Permet au client de se procurer plusieurs dimensions dans le cadre du contrat et lui permet de se procurer plusieurs unités de chacune de ces dimensions.
La définition de la valeur *true* pour ce champ indique qu'il s'agit d'une offre non hiérarchisée. La définition de la valeur *false* pour ce champ indique qu'il s'agit d'une offre échelonnée.
Lorsque vous utilisez le formulaire de chargement du produit (PLF) pour créer les contrats de votre produit AMI, vous devez définir les champs suivants pour vos dimensions de tarification :
+ **Nom de l'API DimensionX des contrats** — Le nom qui doit apparaître dans la licence générée sur le AWS License Manager compte de l'acheteur. Ce nom est également utilisé comme valeur pour `Name` in `Entitlement` dans l'appel `Checkoutlicense` d'API.
+ **Nom d'affichage DimensionX des contrats** : nom destiné au client de la dimension qui sera affiché sur les pages détaillées du produit et d'approvisionnement du site Web. AWS Marketplace Créez un nom convivial. La longueur maximale du nom est de 24 caractères. Une fois que l'annonce est publique, la valeur de ne `Name` peut pas être modifiée.
+ **Description des contrats DimensionX** — Description destinée au client d'une dimension qui fournit des informations supplémentaires sur la dimension du produit, telles que les fonctionnalités fournies par cette dimension spécifique. La longueur maximale de la description est de 70 caractères.
+ **DimensionX Quantity des contrats** — Ceci est utilisé pour calculer le prorata en cas de modification d'un accord sur un produit. La valeur de ce champ doit être définie sur 1 pour toutes les offres de contrat. Il ne doit pas être modifié.
+ **Contrats DimensionX **Tarif sur 1 mois**** — Le taux contractuel à facturer pour un mois de droits par rapport à cette dimension. Pour les offres non échelonnées, ce tarif est facturé pour chaque unité de la dimension achetée. Ce champ prend en charge trois décimales.
+ **Contrats DimensionX **Tarif sur 12 mois**** — Le taux contractuel à facturer pour 12 mois de droits par rapport à la dimension. Pour les offres non échelonnées, ce tarif est facturé pour chaque unité de la dimension achetée. Ce champ prend en charge trois décimales.
+ **Contrats DimensionX **Tarif sur 24 mois**** — Le taux contractuel à facturer pour 24 mois de droits par rapport à la dimension. Pour les offres non échelonnées, ce tarif est facturé pour chaque unité de la dimension achetée. Ce champ prend en charge trois décimales.
+ **Contrats DimensionX **Tarif sur 36 mois**** — Le taux contractuel à facturer pour 36 mois de droits par rapport à la dimension. Pour les offres non échelonnées, ce tarif est facturé pour chaque unité de la dimension achetée. Ce champ prend en charge trois décimales.
**Exemple : application de stockage de données**
| | Tarif pour 1 mois | Tarif pour 12 mois | Tarif pour 24 mois | Tarif pour 36 mois |
| --- | --- | --- | --- | --- |
| Données non chiffrées (Go) | 1,50 USD/Go | 16,00 USD/Go | 30,00 USD/Go | 60,00 \$1/GB |
| Données chiffrées (Go) | 1,55 USD/Go | 16,60 USD/Go | 31,20 USD/Go | 61,20 \$1/GO |
**Exemple : produit de surveillance de journaux**
| | Tarif pour 1 mois | Tarif pour 12 mois | Tarif pour 24 mois | Tarif pour 36 mois |
| --- | --- | --- | --- | --- |
| Basique (10 hôtes surveillés, 5 conteneurs surveillés) | 100 USD | 1 000 USD | 2 000 USD | 4 000 USD |
| Standard (20 hôtes surveillés, 10 conteneurs surveillés) | 200 USD | 2 000 USD | 4 000 USD | 8 000\$1 |
| Pro (40 hôtes surveillés, 20 conteneurs surveillés) | 400 USD | 4 000 USD | 8 000\$1 | 16 000\$1 |
| Hôtes supplémentaires surveillés par heure | 10\$1 | 100 USD | \$1200 | 400 USD |
| Conteneurs supplémentaires surveillés par heure | 10\$1 | 100 USD | \$1200 | 400 USD |
**Note**
Les tarifs peuvent s'appliquer aux durées suivantes : 1 mois, 12 mois, 24 mois ou 36 mois. Vous pouvez choisir d'offrir une ou plusieurs de ces options pour votre produit. Les durées doivent être les mêmes dans chaque dimension.
**Example**
Par exemple, dans le cas où vous avez `ReadOnlyUsers` des `AdminUsers` dimensions, si vous proposez un prix annuel pour ReadOnlyUsers, vous devez également proposer un prix annuel pour`AdminUsers`.
## Renouvellements automatiques
Lorsque les clients achètent votre produit par le AWS Marketplace biais de contrats AMI, ils peuvent accepter de renouveler automatiquement les termes du contrat. Les clients continuent de payer leurs droits tous les mois ou pendant 1, 2 ou 3 ans.
Les clients peuvent modifier leurs paramètres de renouvellement à tout moment. Pour plus d'informations, consultez la section [Modification d'un contrat existant](https://docs.aws.amazon.com/marketplace/latest/buyerguide/buyer-ami-contracts.html#modify-existing-contract) dans le *Guide de AWS Marketplace l'acheteur*.
# Associer des licences à des produits basés sur l'AMI à l'aide de AWS License Manager
Pour les produits basés sur Amazon Machine Image (AMI) assortis de tarifs contractuels, vous pouvez utiliser AWS License Manager pour associer des licences à votre produit. AWS License Manager est un outil de gestion des licences qui permet à votre application de suivre et de mettre à jour les licences (également appelées droits) achetées par un client. Une fois l'intégration terminée, vous pouvez publier votre liste de produits sur AWS Marketplace. Les sections suivantes fournissent plus d'informations sur l'utilisation AWS License Manager pour associer des licences à votre produit basé sur l'AMI.
Pour plus d'informations AWS License Manager, consultez le [guide de AWS License Manager l'utilisateur](https://docs.aws.amazon.com/license-manager/latest/userguide/license-manager.html) et la [AWS License Manager](https://docs.aws.amazon.com/cli/latest/reference/license-manager/index.html)section du manuel de *référence des AWS CLI commandes*.
*Pour plus d'informations sur l'intégration AWS License Manager aux produits basés sur l'AMI avec des prix contractuels, consultez la liste des [produits AMI dont le prix est établi par le laboratoire de paiement initial](https://catalog.workshops.aws/mpseller/en-US/ami/list-ami-upfront-payment) de l'AWS Marketplace atelier des vendeurs.*
**Note**
Les clients ne peuvent pas lancer de nouvelles instances de l'AMI après la période d'expiration du contrat. Toutefois, pendant la durée du contrat, ils peuvent lancer autant d'instances que nécessaire. Ces licences ne sont pas bloquées par un nœud ni liées à des instances particulières.
**Création d'offres privées** — Les vendeurs peuvent générer des offres privées pour les produits à l'aide de l'outil de création d'offres privées du Portail de gestion AWS Marketplace.
**Rapports** — Vous pouvez configurer des flux de données en configurant un compartiment Amazon S3 dans la section **Rapport** du Portail de gestion AWS Marketplace. Pour de plus amples informations, veuillez consulter [Rapports sur les vendeurs, flux de données et tableaux de bord dans AWS Marketplace](reports-and-data-feed.md).
**Topics**
+ [Modèles de licence](#license-models)
+ [Flux de travail d'intégration](#LM-workflow)
+ [Conditions préalables à l'intégration de License Manager](#LM-prereqs)
+ [Intégrer un produit basé sur l'AMI avec AWS License Manager](#integrate-with-LM)
+ [Renouvellements et mises à niveau des licences](#lic-renew-upgrade)
## Modèles de licence
AWS Marketplace l'intégration AWS License Manager prend en charge deux modèles de licence :
+ [Modèle de licence configurable](#config-lic-model)
+ [Modèle de licence à plusieurs niveaux](#tiered-lic-model)
### Modèle de licence configurable
Le modèle de licence configurable (également appelé modèle de licence quantifiable) donne droit à un acheteur à une quantité spécifique de ressources une fois qu'il a acheté une licence.
Vous définissez une dimension tarifaire et un prix unitaire. L'acheteur peut ensuite choisir la quantité de ressources qu'il souhaite acheter.
**Example de la dimension tarifaire et du prix unitaire**
Vous pouvez définir une dimension tarifaire (telle que la sauvegarde des données) et un prix unitaire (tel que 30 \$1/unité)
L'acheteur peut choisir d'acheter 5, 10 ou 20 unités.
Votre produit suit et mesure l'utilisation pour mesurer la quantité de ressources consommées.
Avec le modèle de configuration, les droits sont comptés de deux manières :
+ [Licences Drawdown](#drawndown-lic)
+ [Licences flottantes](#floating-lic)
#### Licences Drawdown
La licence est extraite du pool de licences autorisé lors de l'utilisation. Ce droit est définitivement retiré et ne peut pas être restitué au pool de licences.
**Example du traitement d'une quantité limitée de données**
Un utilisateur a le droit de traiter 500 Go de données. Au fur et à mesure qu'ils continuent à traiter les données, la quantité est prélevée dans le pool de 500 Go jusqu'à ce que toutes les licences de 500 Go soient consommées.
Pour les licences de prélèvement, vous pouvez utiliser l'opération `CheckoutLicense` API pour vérifier les unités de licence consommées.
**Example de sauvegarde vers Amazon S3 pour un certain nombre d'unités/an**
Vous disposez d'un produit de stockage qui permet de sauvegarder des données sur Amazon Simple Storage Service pour un maximum de 1024 unités pendant un an. Votre application peut être lancée à l'aide de plusieurs instances Amazon EC2. Votre application dispose d'un mécanisme permettant de suivre et d'agréger les données. Votre logiciel appelle l'opération `CheckoutLicense` API avec l'identifiant du produit à chaque sauvegarde ou à intervalles réguliers pour mettre à jour les quantités consommées.
Dans cet exemple, votre logiciel appelle `CheckoutLicense` pour extraire 10 unités de données. Lorsque la capacité totale atteint la limite de sauvegarde achetée par le client, l'appel d'API échoue.
**Demande**
```
linux-machine ~]$ aws license-manager checkout-license\
--product-sku "2205b290-19e6-4c76-9eea-377d6bf7la47" \
--checkout-type "PERPETUAL" \
--key-fingerprint "aws:294406891311:AWS/Marketplace:issuer-fingerprint" \
--entitlements "Name=DataConsumption, Value=l0, Unit=Count" \
--client-token "AKIAIOSFODNN7EXAMPLE"
```
**Réponse**
```
{
"CheckoutType": "PERPETUAL",
"EntitlementsAllowed": [
{
"Name": "DataConsumption",
"Count": 10,
"Units": "Count",
"Value": "Enabled"
}
},
"Expiration": "2021-04-22Tl9:02: 36",
"IssuedAt": "2021-04-22Tl8:02:36",
"LicenseArn": "arn:aws:license-manager::294406891311:license:l-16bf01b...",
"LicenseConsumptionToken": "AKIAIOSFODNN7EXAMPLE"
}
```
#### Licences flottantes
La licence est renvoyée dans le pool contenant le nombre de licences autorisé après utilisation.
**Example du nombre d'utilisateurs par rapport à une limite supérieure fixe**
Un utilisateur a droit à 500 utilisateurs simultanés sur l'application. Au fur et à mesure que les utilisateurs se connectent et se déconnectent, les utilisateurs sont tirés au sort et renvoyés dans le pool de 500 utilisateurs. Cependant, l'application ne peut pas attirer plus de 500 utilisateurs du pool car 500 utilisateurs simultanés constituent la limite supérieure fixe.
Pour les licences flottantes, vous pouvez utiliser l'opération `CheckInLicense` API pour renvoyer les unités de licence au pool d'autorisations.
**Example du nombre d'utilisateurs simultanés pendant un an**
Le prix de votre produit est basé sur le nombre d'utilisateurs simultanés. Le client achète une licence pour 10 utilisateurs pendant un an. Le client lance le logiciel en fournissant des autorisations Gestion des identités et des accès AWS (IAM). Lorsqu'un utilisateur se connecte, votre application appelle l'opération `CheckoutLicense` API pour réduire la quantité de 1. Lorsque l'utilisateur se déconnecte, l'application renvoie cette licence au pool en appelant l'opération `CheckInLicense` API. Si vous n'appelez pas`CheckInLicense`, l'unité de licence sera automatiquement enregistrée au bout d'une heure.
**Note**
Dans la demande suivante, il ne s'`key-fingerprint`agit pas d'une valeur d'espace réservé mais de la valeur réelle de l'empreinte digitale avec laquelle toutes les licences seront publiées.
**Demande**
```
linux-machine ~]$ aws license-manager checkout-license\
--product-sku "2205b290-19e6-4c76-9eea-377d6bf7la47" \
--checkout-type "PROVISIONAL" \
--key-fingerprint "aws:294406891311:AWS/Marketplace:issuer-fingerprint" \
--entitlements "Name=ReadOnlyUSers, Value=l0, Unit=Count" \
--client-token "AKIAIOSFODNN7EXAMPLE"
```
**Réponse**
```
{
"CheckoutType": "PROVISIONAL",
"EntitlementsAllowed": [
{
"Name": "ReadOnlyUsers",
"Count": 10,
"Units": "Count",
"Value": "Enabled"
}
},
"Expiration": "2021-04-22Tl9:02: 36",
"IssuedAt": "2021-04-22Tl8:02:36",
"LicenseArn": "arn:aws:license-manager::294406891311:license:l-16bf01b...",
"LicenseConsumptionToken": "AKIAIOSFODNN7EXAMPLE"
}
```
### Modèle de licence à plusieurs niveaux
Le modèle de licence hiérarchisée permet à un acheteur d'accéder à un niveau spécifique, ou niveau, de fonctionnalités de l'application une fois qu'il a acheté une licence.
Vous créez des niveaux pour votre produit, tels que Basic, Intermediate et Premium. L'acheteur sélectionne ensuite l'un des niveaux prédéfinis.
L'application n'a pas besoin de suivre ou de mesurer l'utilisation de l'application.
Avec le modèle de licence à plusieurs niveaux, les droits ne sont pas pris en compte mais indiquent un niveau de service acheté par le client.
Si vous souhaitez proposer des fonctionnalités groupées, nous vous recommandons d'utiliser le modèle de licence hiérarchisée.
**Example des niveaux de base, intermédiaire et premium**
Un client peut signer un contrat pour l'un des trois niveaux possibles du logiciel : Basic, Intermediate ou Premium. Chacun de ces niveaux a sa propre tarification. Votre logiciel peut identifier le niveau auquel le client s'est inscrit en invoquant l'opération `CheckoutLicense` API et en spécifiant tous les niveaux possibles dans la demande.
La réponse à la demande contient le droit correspondant au niveau que le client a acheté. Sur la base de ces informations, le logiciel peut fournir une expérience client appropriée.
#### Demande
```
linux-machine ~]$ aws license-manager checkout-license\
--product-sku "2205b290-19e6-4c76-9eea-377d6bf7la47" \
--checkout-type "PROVISIONAL" \
--key-fingerprint "aws:294406891311:AWS/Marketplace:issuer-fingerprint" \
--entitlements "Name=BasicTier, Unit=None" "Name=IntermediateTier, Unit=None" \ "Name=PremiumTier, Unit=None"
```
#### Réponse
```
{
"CheckoutType": "PROVISIONAL",
"EntitlementsAllowed": [
{
"Name": "IntermediateTier",
"Units": "None"
}
},
"Expiration": "2021-04-22Tl9:02:36",
"IssuedAt": "2021-04-22Tl8:02:36",
"LicenseArn": "arn:aws:license-manager::294406891311:license:l-16bf01b...",
"LicenseConsumptionToken": "AKIAIOSFODNN7EXAMPLE"
}
```
## Flux de travail d'intégration
Les étapes suivantes montrent le flux de travail permettant d'intégrer votre produit AMI à AWS License Manager :
1. Le vendeur crée un produit avec AWS License Manager intégration.
1. Le vendeur met en vente le produit sur AWS Marketplace.
1. L'acheteur trouve le produit dessus AWS Marketplace et l'achète.
1. Une licence est envoyée à l'acheteur dans son Compte AWS.
1. L'acheteur utilise le logiciel en lançant l'instance Amazon Elastic Compute Cloud (Amazon EC2), la tâche Amazon Elastic Container Service (Amazon ECS) ou le logiciel du pod Amazon Elastic Kubernetes Service (Amazon EKS). Le client déploie le logiciel en utilisant un rôle IAM.
1. Le logiciel lit la licence enregistrée sur le AWS License Manager compte de l'acheteur, découvre les droits achetés et fournit les fonctionnalités en conséquence.
**Note**
License Manager n'effectue aucun suivi ni aucune mise à jour ; cela est effectué par l'application du vendeur.
## Conditions préalables à l'intégration de License Manager
Avant de publier le produit, vous devez effectuer les opérations suivantes :
1. Créez un nouveau produit AMI dans Portail de gestion AWS Marketplace le et notez son code produit.
1. Remplissez le formulaire de chargement du produit (PLF) avec les informations de prix nécessaires et renvoyez-le pour traitement.
1. Utilisez un rôle IAM pour la tâche ou le module exécutant votre application avec les autorisations IAM nécessaires pour appeler `CheckoutLicense``ExtendLicenseConsumption`, et. `CheckInLicense`
Les autorisations IAM requises sont détaillées dans la politique IAM suivante.
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement":[
{
"Sid":"VisualEditorO",
"Effect":"Allow",
"Action":[
"license-manager:CheckoutLicense",
"license-manager:GetLicense",
"license-manager:CheckInLicense",
"license-manager:ExtendLicenseConsumption",
"license-manager:ListReceivedLicenses"
],
"Resource":"*"
}
]
}
```
------
1. Effectuez un appel test à l'opération `RegisterUsage` API avec un enregistrement de toutes les dimensions de tarification que vous avez définies.
## Intégrer un produit basé sur l'AMI avec AWS License Manager
Vous pouvez intégrer votre produit basé sur l'AMI à License Manager à l'aide de l'[AWS License Manager](https://docs.aws.amazon.com/license-manager/latest/APIReference/Welcome.html)API. Lancez les instances Amazon EC2 à l'aide de produits basés sur l' AWS Marketplace AMI.
**Note**
Assurez-vous d'avoir terminé le [Conditions préalables à l'intégration de License Manager](#LM-prereqs) avant d'exécuter la procédure suivante.
**Pour intégrer votre produit basé sur l'AMI à License Manager**
1. Exécutez la procédure dans [Création d'une licence de test dans License Manager](#creating-test-license). Vous devez créer une licence de test dans License Manager pour tester votre intégration.
1. Exécutez l'opération d'[GetLicense](https://docs.aws.amazon.com/license-manager/latest/APIReference/API_GetLicense.html)API à l'aide de la licence Amazon Resource Name (ARN) que vous avez obtenue à l'étape 1. Notez la valeur de l'`KeyFingerprint`attribut de la `GetLicense` réponse pour une utilisation ultérieure.
1. Téléchargez et incluez le dernier AWS SDK public dans votre application.
1. Pour vérifier que l'acheteur est autorisé à utiliser une licence pour votre application, exécutez l'opération [CheckoutLicense](https://docs.aws.amazon.com/license-manager/latest/APIReference/API_CheckoutLicense.html)API. Utilisez les détails des droits et l'empreinte clé de la licence de test que vous avez obtenue à l'étape 1.
Si aucun droit n'est trouvé pour la licence ou si le nombre maximum d'autorisations est dépassé, l'opération d'`CheckoutLicense`API revient. `NoEntitlementsAllowedException` Si les droits sont valides ou peuvent être utilisés, l'`CheckoutLicense`opération renvoie une réponse réussie avec les droits demandés et leurs valeurs.
1. (Obligatoire pour les droits flottants uniquement) Exécutez l'opération d'[CheckinLicense](https://docs.aws.amazon.com/license-manager/latest/APIReference/API_CheckInLicense.html)API en utilisant celui `LicenseConsumptionToken` qui a été reçu dans la `CheckoutLicense` réponse. Cette action permet de réintégrer les droits précédemment retirés dans le pool des droits disponibles.
1. Après avoir vérifié avec succès l'intégration de License Manager avec la licence de test que vous avez créée à l'étape 1, mettez à jour l'empreinte de clé de votre code sur`aws:294406891311:AWS/Marketplace:issuer-fingerprint`. Vous êtes maintenant prêt à travailler avec les licences émises par AWS Marketplace.
Suivez le processus de publication de l'application pour un produit AMI, puis soumettez le produit au AWS Marketplace processus de publication du produit.
### Création d'une licence de test dans License Manager
Vous utilisez la version 2 de AWS Command Line Interface (AWS CLI) pour créer une licence de test dans AWS License Manager. Cette licence de test est uniquement utilisée pour vérifier et tester l' AWS License Manager intégration. Une fois le test terminé, vous pouvez supprimer la licence de test. La licence réelle est générée à l' AWS Marketplace aide d'une empreinte numérique différente.
AWS Marketplace prend en charge deux types de droits dans. AWS License Manager Toutefois, un seul type peut être activé pour un produit. Lorsque vous créez une licence, y compris une licence de test, vous devez spécifier l'un des types de droits suivants :
**Droits à plusieurs niveaux : le modèle de** licence à plusieurs niveaux permet au client d'accéder à certaines fonctionnalités de l'application. Les clients ne peuvent pas définir la quantité d'unités qu'ils souhaitent acheter. Ils peuvent toutefois sélectionner un seul package ou niveau prédéfini. Les clients peuvent modifier le contrat ultérieurement pour s'abonner à un autre niveau.
**Droits configurables** — Le modèle de licence configurable accorde des droits à une certaine quantité de ressources lorsque le client achète une licence. Le client choisit la quantité d'unités qu'il souhaite acheter pendant le processus d'abonnement et sera facturé en fonction du prix unitaire. Les clients peuvent également s'abonner à plusieurs dimensions.
Les paramètres requis pour une utilisation dans le fonctionnement de l'`CheckoutLicense`API sont les suivants :
+ `CheckoutType`— Les valeurs valides sont `Perpetual` ou `Provisional` :
+ `Perpetual`— Utilisé lorsque le nombre de droits retirés sera épuisé du pool. Exemple : l'acheteur a le droit de traiter 500 Go de données. Au fur et à mesure qu'ils continuent à traiter les données, la quantité est prélevée et épuisée du pool de 500 Go. Obtient le statut d'une licence achetée indiquant si la licence est expirée ou sur le point d'expirer pour envoyer une notification au client.
+ `Provisional`— Utilisé pour les droits de licence flottants où les droits sont retirés du pool et renvoyés après utilisation. Exemple : l'utilisateur a droit à 500 utilisateurs simultanés dans l'application. Au fur et à mesure que les utilisateurs se connectent et se déconnectent, les utilisateurs sont tirés au sort et renvoyés dans le pool de 500 utilisateurs. Pour plus d'informations sur les droits de licence flottants, consultez la section [Licences émises par le vendeur dans AWS License Manager](https://docs.aws.amazon.com/license-manager/latest/userguide/seller-issued-licenses.html).
+ `ClientToken`— Identifiant unique distinguant majuscules et minuscules pour garantir que le résultat exact est le même quel que soit le nombre de tentatives. Nous vous recommandons d'utiliser un identifiant unique universel (UUID) aléatoire pour chaque demande.
+ `Entitlements`— Liste des droits à vérifier.
+ Pour les droits échelonnés, fournissez `Name` et `Unit` propriétés comme suit :
`{`
`"Name": "",`
`"Unit": "None"`
`}`
+ Pour les droits configurables `Name``Unit`, fournissez et `Value` propriétés comme suit :
`{`
`"Name": "",`
`"Unit": "",`
`"Value": {`
\$1
+ `KeyFingerprint`— Utilisez cette empreinte digitale pour vérifier que la licence est délivrée par AWS Marketplace. L'empreinte clé des licences délivrées par AWS Marketplace est la suivante :
`aws:294406891311:AWS/Marketplace:issuer-fingerprint`
+ `Product SKU`— Identifiant de produit au format GUID (Global Unique Identifier) associé à un AWS Marketplace produit.
**Example d'un droit configurable**
Voici un exemple de demande qui utilise l'opération `CheckoutLicense` d'API pour extraire un droit configurable nommé`PowerUsers`.
```
aws license-manager checkout-license \
product-sku "2205b290-19e6-4c76-9eea-377d6bf71a47" \
checkout-type "PROVISIONAL" \
client-token "79464194dca9429698cc774587a603a1" \"Statement":[
entitlements "Name=PowerUsers,Value=1,Unit=Count" \
key-fingerprint "aws:294406891311:AWS/Marketplace:issuer-fingerprint"
```
**Example d'un droit à plusieurs niveaux**
Voici un exemple de demande qui utilise l'opération d'`CheckoutLicense`API pour extraire un droit de fonctionnalité nommé`EnterpriseEdition`.
```
aws license-manager checkout-license \
--product-sku "2205b290-19e6-4c76-9eea-377d6bf71a47" \
--checkout-type "PROVISIONAL" \
--client-token "79464194dca9429698cc774587a603a1" \
--entitlements "Name=EnterpriseEdition,Unit=None" \
--key-fingerprint "aws:294406891311:AWS/Marketplace:issuer-fingerprint"
```
**Pour créer une licence de test pour votre produit basé sur l'AMI**
1. À partir de votre environnement local sur lequel la AWS CLI version v2 est installée, exécutez le script suivant. Le script crée la licence de test et configure les détails appropriés du produit.
**Note**
Utilisez un test Compte AWS différent de celui Compte AWS dans lequel vous déployez et testez votre logiciel. Les licences ne peuvent pas être créées, accordées et retirées de la même manière Compte AWS.
```
#!/bin/bash
# Replace with intended product ID on AWS Marketplace
PRODUCT_ID=
# Replace with license recipient's AWS Account ID
BENEFICIARY_ACCOUNT_ID=
# Replace with your product's name
PRODUCT_NAME="Test Product"
# Replace with your seller name on AWS Marketplace
SELLER_OF_RECORD="Test Seller"
# Replace with intended license name
LICENSE_NAME="AWSMP Test License"
# Replace the following with desired contract dimensions
# More info here: https://docs.aws.amazon.com/license-manager/latest/APIReference/API_Entitlement.html
# Example "configurable entitlement"
ENTITLEMENTS='[
{
"Name": "ReadOnly",
"MaxCount": 5,
"Overage": false,
"Unit": "Count",
"AllowCheckIn": true
}
]'
# Example "tiered entitlement"
# ENTITLEMENTS='[
# {
# "Name": "EnterpriseUsage",
# "Value": "Enabled",
# "Unit": "None"
# }
# ]'
# Format "yyyy-mm-ddTHH:mm:ss.SSSZ"
# This creates a validity period of 10 days starting the current day
# Can be updated to desired dates
VALIDITY_START=$(date +%Y-%m-%dT%H:%M:%S.%SZ)
VALIDITY_END=$(date --date="+10 days" +%Y-%m-%dT%H:%M:%S.%SZ)
# Configuration for consumption of the license as set on Marketplace products
CONSUMPTION_CONFIG='{
"RenewType": "None",
"ProvisionalConfiguration": {
"MaxTimeToLiveInMinutes": 60
}
}'
# License's home Region
HOME_REGION=us-east-1
# License issuer's name
ISSUER=Self
# Run AWS CLI command to create a license
aws license-manager create-license \
--license-name "${LICENSE_NAME}" \
--product-name "${PRODUCT_NAME}" \
--product-sku "${PRODUCT_ID}" \
--issuer Name="${ISSUER}" \
--beneficiary "${BENEFICIARY_ACCOUNT_ID}" \
--validity 'Begin="'"${VALIDITY_START}"'",End="'"${VALIDITY_END}"'"' \
--entitlements "${ENTITLEMENTS}" \
--home-region "${HOME_REGION}" \
--region "${HOME_REGION}" \
--consumption-configuration "${CONSUMPTION_CONFIG}" \
--client-token $(uuidgen)
```
1. Accordez la licence à l'aide de la AWS License Manager console. Pour plus d'informations, consultez la section [distribuer un droit](https://docs.aws.amazon.com/license-manager/latest/userguide/granted-licenses.html#distribute-entitlement.) dans le *Guide de l'utilisateur du License Manager*.
1. Connectez-vous au compte Compte AWS qui fait office de compte acheteur sur lequel vous déploierez et testerez votre logiciel. Il doit être Compte AWS différent de celui Compte AWS qui a créé et accordé la licence.
1. Accédez à la AWS License Manager console pour accepter et activer les licences accordées. Pour plus d'informations, consultez la section [Gérer les licences que vous avez accordées](https://docs.aws.amazon.com/license-manager/latest/userguide/granted-licenses.html#manage-granted-licenses) dans le *Guide de l'utilisateur du License Manager*.
1. Exécutez la commande suivante dans votre environnement.
```
# The following example uses a key fingerprint that should match the test license you created.
# When checking out an actual AWS Marketplace created license, use the following fingerprint:
# aws:294406891311:AWS/Marketplace:issuer-fingerprint
aws license-manager checkout-license \
--product-sku \
--checkout-type PROVISIONAL \
--key-fingerprint "aws::Self:issuer-fingerprint" \
--entitlements "Name=ReadOnly,Value=1,Unit=Count" \
--client-token $(uuidgen)
```
La commande précédente utilise `PROVISIONAL` comme valeur du `CheckoutType` paramètre. Si le droit utilise une licence de prélèvement, utilisez-la `PERPETUAL` pour la valeur.
### Appels d'API License Manager
Pour gérer les licences stockées dans le compte License Manager du client, votre logiciel peut utiliser les appels d'API suivants :
+ `GetLicense`— Obtient le statut d'une licence achetée indiquant si la licence est expirée ou sur le point d'expirer pour envoyer une notification au client.
+ `CheckoutLicense`— Découvre les licences que l'utilisateur a achetées. Vous pouvez également l'utiliser pour mettre à jour la quantité de licences lorsque l'utilisateur a consommé une certaine quantité de licences. Avec`CheckoutLicense`, vous pouvez continuer à vérifier les quantités de licences utilisées par le client. Lorsque le client a épuisé toutes les licences, cet appel renvoie un message d'erreur. Pour plus d'informations sur la cadence de course suggérée`CheckoutLicense`, consultez[Renouvellements et mises à niveau des licences](#lic-renew-upgrade).
+ `ExtendLicenseConsumption`— En cas de dimensions flottantes, lorsque le logiciel extrait une licence, il la renvoie automatiquement au pool au bout de 60 minutes. Si vous souhaitez prolonger la durée d'extraction de la licence, votre logiciel peut vous appeler `ExtendLicenseConsumption` pour prolonger la licence de 60 minutes supplémentaires.
+ `CheckInLicense`— En cas de dimensions flottantes, lorsque vous souhaitez renvoyer la licence au pool de droits, utilisez`CheckInLicense`.
+ `ListReceivedLicenses`— Répertorie les licences achetées par l'acheteur.
## Renouvellements et mises à niveau des licences
Les clients peuvent renouveler ou mettre à niveau leurs licences sur le Portail de gestion AWS Marketplace. Une fois qu'ils ont effectué un achat supplémentaire, ils AWS Marketplace génèrent une nouvelle version de la licence qui reflète les nouveaux droits. Votre logiciel lit les nouveaux droits à l'aide des mêmes appels d'API. Vous n'avez rien à faire de différent en termes d'intégration du License Manager pour gérer les renouvellements et les mises à niveau.
En raison des renouvellements de licence, des mises à niveau, des annulations, etc., nous recommandons que votre produit effectue l'appel d'`CheckoutLicense`API à un rythme régulier pendant son utilisation. En utilisant le fonctionnement de l'`CheckoutLicense`API à une cadence régulière, le produit peut détecter les modifications des droits, telles que les mises à niveau et les expirations.
Nous vous recommandons d'effectuer l'appel `CheckoutLicense` d'API toutes les 15 minutes.