View a markdown version of this page

Restreindre une version - AWS Marketplace
Syntaxe de demandeChamps obligatoiresSyntaxe de réponseErreurs

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.

Restreindre une version

Vous pouvez utiliser l'API Catalog pour restreindre une version de votre produit de machine learning dans AWS Marketplace. En cas de restriction, les nouveaux acheteurs ne peuvent pas accéder à cette version. Les abonnés existants conservent l'accès aux versions restreintes. AWS Marketplace les directives exigent une assistance continue pour les acheteurs existants pendant 90 jours après la restriction.

Important

Au moins une version illimitée doit rester disponible. Vous ne pouvez pas restreindre la dernière version accessible au public d'un produit.

Pour restreindre une version, procédez comme suit :

  • Pour restreindre une version, appelez l'StartChangeSetopération avec le type de RestrictDeliveryOptions modification.

Syntaxe de demande

POST /StartChangeSet HTTP/1.1
Content-type: application/json
{
"Catalog": "AWSMarketplace",
  "ChangeSet":
  [
    {
      "ChangeType": "RestrictDeliveryOptions",
      "Entity":
      {
        "Identifier": "example1-abcd-1234-5ef6-7890abcdef12@1",
        "Type": "MachineLearningProduct@1.0"
      },
      "DetailsDocument":
      {
        "DeliveryOptionIds":
        [
          "example1-2222-cccc-2222-cccccccccccc"
        ]
      }
    }
  ]
}

Champs obligatoires

Champs obligatoires

  • Entity(objet) —obligatoire

    Contient des informations sur votre produit ML.

    • Identifier(chaîne) : obligatoire

      L'identifiant de votre produit. Pour plus d'informations, consultez la section Identifiant.

    • Type(chaîne) : obligatoire

      Spécifie le mode de livraison (type de produit). Ça doit l'êtreMachineLearningProduct@1.0.

  • DetailsDocument(objet) —obligatoire

    Contient les informations de version mises à jour.

    • DeliveryOptionIds(ensemble d'objets) —obligatoire

      Liste des DeliveryOption identifiants des versions que vous souhaitez restreindre. Récupérez l'identifiant unique de chacun DeliveryOption en appelant l' DescribeEntity action sur la version que vous limitez.

Syntaxe de réponse

Une demande réussie renvoie :

{
    "ChangeSetId": "example123456789012abcdef",
    "ChangeSetArn": "arn:aws:aws-marketplace:us-east-1:123456789012:AWSMarketplace/ChangeSet/example123456789012abcdef"
}

  1. Validation : le système vérifie si toutes les informations sont conformes aux AWS Marketplace directives.

  2. Surveillance de l'état : 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ée, la nouvelle version est restreinte.

Erreurs

Erreurs asynchrones

Les erreurs suivantes peuvent se produire lors du traitement de l'ensemble de modifications et peuvent être récupérées à l'aide de cette DescribeChangeSet opération :

Code d’erreur Message d’erreur
ÉTAT_DU PRODUIT INCOMPATIBLE Utiliser un produit public ou limité existant
IDENTIFIANT_OPTION_DE_LIVRAISON MANQUANTS Fournissez une option de livraison à partir de la liste d'identifiants existante.
IDENTIFIANT_OPTION_DE_LIVRAISON NON VALIDES Fournissez les identifiants des options de livraison qui se trouvent dans le produit. Identifiants introuvables : [x]
ÉTAT_DE L'OPTION_DE LIVRAISON NON VALIDE Les identifiants de l'option de livraison [invalid_ids] ne sont pas valides. Fournir des options de livraison dans l'État public.
TOUTES LES OPTIONS DE LIVRAISON SONT RESTREINTES Offrez moins d'options de livraison à restreindre, car au moins l'une d'entre elles doit rester dans l'État public.