View a markdown version of this page

Mettre à jour les conditions tarifaires - AWS Marketplace
Syntaxe de demandeChamps obligatoiresSyntaxe de réponseTraitement des ensembles de modificationsErreurs

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.

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'StartChangeSetopé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.

    • 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.

    • 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 pourUsageBasedPricingTerm) - 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.cpour 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.cpour 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.

  2. 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

  3. 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'DescribeChangeSetopé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.

Code d’erreur Message d’erreur
ÉTAT_DU PRODUIT INCOMPATIBLE Utilisez un produit limité ou public existant.