La référence d'API AWS Marketplace a été restructurée. Pour plus d'informations sur les opérations d'API prises en charge, consultez le manuel [AWS Marketplace API Reference](https://docs.aws.amazon.com/marketplace/latest/APIReference/Welcome.html).
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.
# Mettre à jour les conditions tarifaires
Vous pouvez utiliser l'API Catalog pour mettre à jour le prix de vos produits de machine learning dans AWS Marketplace.
**Note**
Vous devez fixer le prix de tous les types d'instances pris en charge pour vos produits de machine learning. Lorsque vous créez votre première version, `AddDeliveryOptions` modifiez `UpdatePricingTerms` les types avec les prix pour tous les types d'instances pris en charge afin de publier votre produit. Lorsque vous ajoutez une nouvelle version à un produit existant avec de nouveaux types d'instances qui n'étaient pas pris en charge auparavant, vous devez inclure ces types d'instance dans les types `UpdatePricingTerms` et `AddDeliveryOptions` modifier.
Pour mettre à jour les conditions tarifaires, appelez l'`StartChangeSet`opération avec le type de `UpdatePricingTerms` modification.
## Syntaxe de demande
```
POST /StartChangeSet HTTP/1.1
Content-type: application/json
{
"Catalog": "AWSMarketplace",
"ChangeSet": [
{
"ChangeType": "UpdatePricingTerms",
"Entity": {
"Type": "Offer@1.0",
"Identifier": "$CreateOfferChange.Entity.Identifier"
},
"DetailsDocument": {
"PricingModel": "Usage",
"Terms": [
{
"Type": "UsageBasedPricingTerm",
"CurrencyCode": "USD",
"RateCards": [
{
"RateCard": [
{
"DimensionKey": "ml.m4.4xlarge.m.i.b",
"Price": 0.1
},
{
"DimensionKey": "ml.m5.4xlarge.m.i.b",
"Price": 0.1
},
{
"DimensionKey": "ml.m4.16xlarge.m.i.b",
"Price": 0.1
},
{
"DimensionKey": "m.i.c",
"Price": 0.1
},
{
"DimensionKey": "ml.m4.4xlarge.a.t",
"Price": 0.1
},
{
"DimensionKey": "ml.m5.4xlarge.a.t",
"Price": 0.1
},
{
"DimensionKey": "ml.m4.16xlarge.a.t",
"Price": 0.1
}
]
}
]
},
{
"Type": "FreeTrialPricingTerm",
"Duration": "P30D",
"Grants": [
{
"DimensionKey": "ml.m4.4xlarge.m.i.b"
},
{
"DimensionKey": "ml.m5.4xlarge.m.i.b"
},
{
"DimensionKey": "ml.m4.16xlarge.m.i.b"
},
{
"DimensionKey": "m.i.c"
},
{
"DimensionKey": "ml.m4.4xlarge.a.t"
},
{
"DimensionKey": "ml.m5.4xlarge.a.t"
},
{
"DimensionKey": "ml.m4.16xlarge.a.t"
}
]
}
]
}
},
]
}
```
## Champs obligatoires
+ `Entity`(objet) (obligatoire) - Contient des informations sur l'offre de votre produit ML.
+ `Identifier`(string) (obligatoire) — L'identifiant de l'offre pour laquelle vous souhaitez mettre à jour les conditions tarifaires. Pour plus d'informations, consultez la section [Identifiant](https://docs.aws.amazon.com/marketplace/latest/APIReference/catalog-apis.html#identifier).
+ `Type`(string) (obligatoire) — Cela `Type` doit être `Offer@1.0` destiné à mettre à jour les prix.
+ `DetailsDocument`(objet) (obligatoire) — Informations sur les conditions tarifaires de votre produit d'apprentissage automatique.
+ `PricingModel`(string) (obligatoire) - Le modèle de tarification de votre produit. Vous pouvez choisir entre Utilisation, Gratuit et Contrat (pour les offres privées). Pour plus d'informations, consultez la section [Tarification des produits Machine Learning](https://docs.aws.amazon.com/marketplace/latest/userguide/machine-learning-pricing.html).
+ `Terms`(ensemble d'objets) - Ensemble de conditions tarifaires qui définissent collectivement le prix global de votre produit.
+ `Type`(chaîne) (obligatoire) - Type de condition tarifaire. Les options valides sont `UsageBasedPricingTerm` `FreeTrialPricingTerm` ou `FixedUpfrontPricingTerm` (pour les offres privées).
+ `CurrencyCode`(chaîne) (obligatoire pour `UsageBasedPricingTerm` ou `FixedUpfrontPricingTerm` - la devise de la condition tarifaire. Les valeurs valides sont `USD`.
+ `RateCards`(ensemble d'objets) (obligatoire pour`UsageBasedPricingTerm`) - Les fiches tarifaires qui définissent le prix de votre produit d'apprentissage automatique. Vous ne devez en inclure `RateCard` qu'un dans ce tableau.
+ `RateCard`(ensemble d'objets) - La gamme de dimensions et de taux de votre produit d'apprentissage automatique. Tous les types d'instances pris en charge doivent être payants pour pouvoir publier votre produit.
+ `DimensionKey`- La dimension que vous fixez. Les clés de dimension valides sont les suivantes :
+ Type d'instance suivi de l'opération pour les taux horaires :
+ Le type d'instance commence par `ml` suivi du nom et de la taille de l'instance. Par exemple, `ml.m4.xlarge`
+ Les opérations porteront sur `m.i.b` la transformation par lots, sur `m.i.r` l'inférence horaire en temps réel et sur l'entraînement `a.t` des algorithmes.
+ Exemples : `ml.m4.4xlarge.m.i.b` pour la transformation par lots, `ml.m4.xlarge.m.i.r` pour l'inférence en temps réel ou `ml.m4.16xlarge.a.t` pour l'entraînement d'algorithmes
+ `m.i.c`pour une tarification en temps réel par inférence.
+ `Price`- Le taux de la dimension. Le taux est soit horaire, soit par inférence, selon le DimensionKey.
+ `Duration`(string) (obligatoire pour `FreeTrialPricingTerm` ou `FixedUpfrontPricingTerm` - La durée de votre essai gratuit ou de votre contrat. Pour l'essai gratuit, les valeurs valides sont comprises entre X et Y. Pour le contrat, les valeurs valides sont comprises entre X et Y.
+ Subventions (ensemble d'objets) - Informations sur les DimensionKeys éligibles à un essai gratuit. Toutes les DimensionKeys prises en charge doivent être fournies.
+ DimensionKey - La dimension à inclure dans le cadre de l'offre d'essai gratuit.
+ Type d'instance suivi de l'opération pour les taux horaires :
+ Le type d'instance commence par `ml` suivi du nom et de la taille de l'instance, par exemple `ml.m4.xlarge`
+ L'opération est `m.i.b` destinée à la transformation par lots, `m.i.r` à l'inférence horaire en temps réel ou à l'entraînement `a.t` d'algorithmes.
+ Exemples : `ml.m4.4xlarge.m.i.b` pour la transformation par lots, `ml.m4.xlarge.m.i.r` pour l'inférence en temps réel ou `ml.m4.16xlarge.a.t` pour l'entraînement d'algorithmes
+ `m.i.c`pour une tarification en temps réel par inférence.
## Syntaxe de réponse
Une demande réussie renvoie :
```
{
"ChangeSetId": "{{example123456789012abcdef}}",
"ChangeSetArn": "arn:aws:aws-marketplace:{{us-east-1}}:{{123456789012}}:AWSMarketplace/ChangeSet/{{example123456789012abcdef}}"
}
```
## Traitement des ensembles de modifications
La demande de modification entre dans une file de traitement, où elle passe par plusieurs étapes :
1. Validation : le système vérifie que toutes les informations sont conformes aux AWS Marketplace directives.
+ Temps de traitement : quelques minutes à plusieurs heures
+ Pour les erreurs de validation, voir [Modifier le statut et les erreurs du set](https://docs.aws.amazon.com/marketplace/latest/APIReference/work-with-seller-products.html#seller-product-change-set-errors).
1. Surveillance du statut : vous pouvez vérifier le statut de la demande de deux manières.
+ Via le portail AWS Marketplace de gestion
+ Utilisation de l’opération `DescribeChangeSet`
1. Achèvement : une fois approuvées, les conditions tarifaires sont mises à jour.
## Erreurs
**Erreurs asynchrones**
Les erreurs spécifiques relatives aux `UpdatePricingTerms` actions peuvent être récupérées à l'aide de l'`DescribeChangeSet`opération une fois que le traitement de l'ensemble de modifications a commencé. Pour plus de détails sur les erreurs et la résolution des problèmes, voir [Modifier le statut du set et les erreurs](https://docs.aws.amazon.com/marketplace/latest/APIReference/catalog-apis.html#working-with-change-sets).
| Code d’erreur | Message d’erreur |
| --- | --- |
| ÉTAT\_DU PRODUIT INCOMPATIBLE | Utilisez un produit limité ou public existant. |