Travaillez avec des solutions

Une solution est un ensemble de produits et de services qui fonctionnent ensemble pour résoudre les problèmes spécifiques des clients. Les solutions peuvent inclure des produits AWS Marketplace et des produits autres qu'AWS Marketplace. Les solutions vous aident à montrer comment plusieurs produits s'intègrent pour répondre à des cas d'utilisation spécifiques au secteur. La solution décrit le problème du client, les cas d'utilisation, les détails de l'intégration et les produits associés.

Solutions sur AWS Marketplace et AWS Partner Central

Lorsque vous migrez de Partner Central 2.0 vers Partner Central 3.0, vous êtes invité à créer un compte AWS et à vous inscrire en tant que vendeur AWS Marketplace. Pour plus d'informations, consultez la section S'inscrire et créer votre profil de vendeur. Cette inscription est obligatoire pour :

• Migrez vos solutions Partner Central existantes vers le catalogue AWS Marketplace (toutes les solutions seront migrées vers le AWSMarketplace catalogue)

• Permettez à vos solutions AWS Marketplace de fonctionner avec les API Partner Central, telles que les API de vente.

Comprendre la liaison et la migration des profils

Il existe deux scénarios distincts pour connecter vos comptes Partner Central et AWS Marketplace :

Liaison de profils uniquement : si vous associez vos comptes AWS Partner Central et AWS sans migrer vers Partner Central 3.0, vos solutions AWS Marketplace et vos solutions Partner Central restent distinctes. Vous gérez chaque plateforme de manière indépendante.

Migration de profils : lorsque vous migrez vers Partner Central 3.0 avec des profils de vendeur AWS Marketplace liés :

• Vos solutions Partner Central 2.0 migrent vers AWS Marketplace

• Vous gérez les solutions uniquement via AWS Marketplace

• Les API Partner Central peuvent accéder aux solutions migrées

Note

Si vous avez déjà associé vos comptes AWS Partner Central et AWS (voir Lier les comptes AWS Partner Central et AWS), vous n'avez pas besoin de créer un nouveau compte AWS. Vérifiez toutefois que votre compte AWS existant est enregistré en tant que vendeur AWS Marketplace. Pour rendre votre solution accessible au public sur le site Web des acheteurs d'AWS Marketplace, vous devez disposer d'un profil public en tant que vendeur AWS Marketplace. Pour obtenir les instructions relatives à l'inscription des vendeurs sur AWS Marketplace, consultez la section Enregistrer et créer votre profil de vendeur.

Mise à disposition des solutions AWS Marketplace préexistantes pour les API Partner Central

Les solutions AWS Marketplace que vous avez créées avant la migration du profil Partner Central 3.0 ne sont pas automatiquement reconnues par les API Partner Central. Cela s'applique même une fois que vous avez terminé la migration et que vous avez lié votre compte AWS à un compte Partner Central.

Pour qu'une solution de pré-migration existante soit visible pour les API Partner Central, mettez à jour n'importe quel champ de la solution. Vous pouvez saisir les mêmes informations que celles qui s'y trouvent actuellement. Répétez ce processus pour chaque solution que vous avez créée avant la migration du profil Partner Central 3.0.

Par exemple, utilisez le type de UpdateInformation modification pour mettre à jour le nom d'une solution avec sa valeur actuelle. Une fois que vous avez mis à jour une solution, les API Partner Central reconnaîtront automatiquement toute future mise à jour de cette solution.

Entité de solution

Une solution est un document marketing qui aide les acheteurs à découvrir et à comprendre vos offres. Les solutions contiennent un titre, une description, des cas d'utilisation, des produits AWS Marketplace et des produits autres qu'AWS Marketplace. La solution est un type d'entité distinct des produits, des offres et des ensembles d'offres. Chaque solution possède sa propre expérience de découverte et de mise en vente, que les acheteurs peuvent parcourir séparément des produits individuels.

Principales caractéristiques

• Regroupez plusieurs produits, y compris les produits AWS Marketplace et les produits non AWS Marketplace.

• Créez une expérience de découverte et de mise en vente dédiée aux acheteurs.

• Regroupez les produits que vous possédez avec les produits d'autres vendeurs.

Le type d'entité de solution estSolution@1.0.

Identifiants d'entité

Les solutions utilisent le format d'soln-*identifiant (par exemple,soln-abc123def456).

Format ARN de l'entité

Les solutions suivent le format ARN AWS standard :

arn:{aws-partition}:aws-marketplace:{region}:{account-id}:{aws-marketplace-catalog}/Solution/{solution-id}

Exemple :

arn:aws:aws-marketplace:us-east-1:123456789012:AWSMarketplace/Solution/soln-abc123def456

Commencer à utiliser des solutions

Cette section fournit des informations détaillées sur la création et la gestion de solutions à l'aide des types de modification de l'API AWS Marketplace Catalog.

Avant de commencer, assurez-vous d'avoir :

• Inscription de vendeur valide sur AWS Marketplace et profil public. Pour plus d'informations, consultez la section S'inscrire et créer votre profil de vendeur.

• Accès à l'API et respect des conditions requises pour les vendeurs. Pour plus d'informations, consultez la section Contrôle d'accès pour l'API AWS Marketplace Catalog.

• J'ai appris les bases de l'utilisation de l'API AWS Marketplace Catalog, voir Utilisation de l'API AWS Marketplace Catalog.

Listez vos solutions

Pour répertorier toutes les solutions de votre compte, appelez l'opération ListEntities API et réglez EntityType sur Solution.

Demande

POST /ListEntities HTTP/1.1
Content-type: application/json

{
  "Catalog": "AWSMarketplace",
  "EntityType": "Solution"
}

Réponse

{
  "EntitySummaryList": [
    {
      "EntityArn": "arn:aws:aws-marketplace:us-east-1:123456789012:AWSMarketplace/Solution/soln-abc123456",
      "EntityId": "soln-abc123456",
      "EntityType": "Solution",
      "LastModifiedDate": "2024-10-10T19:50:43Z",
      "Name": "Test Solution 1",
      "Visibility": "Limited"
    }
  ],
  "NextToken": null
}

Filtrer les solutions en fonction de leur visibilité

Vous pouvez filtrer les solutions en fonction de leur visibilité à l'aide du FilterList paramètre.

Demande

POST /ListEntities HTTP/1.1
Content-type: application/json

{
  "Catalog": "AWSMarketplace",
  "EntityType": "Solution",
  "FilterList": [
    {
      "Name": "Visibility",
      "ValueList": [
        "Public"
      ]
    }
  ]
}

Obtenez les détails de la solution

Pour obtenir des informations détaillées sur une solution spécifique, appelez l'opération DescribeEntity API.

Note

La DescribeEntity réponse renvoie un EntityIdentifier qui combine un EntityId avec un RevisionId. pour les solutions, EntityId est l'identifiant de la solution et RevisionId peut être utilisé pour un verrouillage optimiste. Pour plus d'informations, consultez la section Identifiants.

Demande

GET /DescribeEntity?catalog=AWSMarketplace&entityId=soln-abc123456 HTTP/1.1

Réponse

{
  "Details": "{...}",
  "DetailsDocument": {
    "Lifecycle": {
      "Visibility": "Limited"
    },
    "Identifiers": {
      "Id": "soln-abc123456"
    },
    "Presentation": {
      "Title": "My Solution",
      "Name": "solution_for_customer_X",
      "ShortDescription": "Solution value proposition",
      "LongDescription": "Detailed solution description",
      "LogoUrl": "https://s3.amazonaws.com/logo.jpg",
      "UseCases": [
        {
          "Group": "advertising_and_marketing",
          "SubGroup": "ad_intelligence_and_measurement",
          "Item": "amazon_ads_insights",
          "Description": "Use case description"
        }
      ]
    },
    "RelatedProducts": {
      "AwsMarketplaceProducts": [
        {
          "ProductId": "prod-123"
        }
      ],
      "IntegrationDescription": "How products work together",
      "NonAwsMarketplaceProducts": [
        {
          "Type": "Hardware",
          "Title": "A hardware product",
          "Url": "https://example.com",
          "Description": "My hardware product description"
        }
      ]
    },
    "BuyerEngagement": [
      {
        "EngagementOption": "RequestPrivateOffer"
      }
    ]
  },
  "EntityArn": "arn:aws:aws-marketplace:us-east-1:123456789012:AWSMarketplace/Solution/soln-abc123456",
  "EntityIdentifier": "soln-abc123456@12",
  "EntityType": "Solution@1.0",
  "LastModifiedDate": "2025-04-22T01:02:48Z"
}

Répertorier l'historique des modifications pour une solution

Pour consulter l'historique des modifications d'une solution spécifique, appelez l'opération ListChangeSets API avec un filtre d'entité.

Syntaxe de la demande

POST /ListChangeSets HTTP/1.1
Content-type: application/json

{
  "Catalog": "AWSMarketplace",
  "FilterList": [
    {
      "Name": "EntityId",
      "ValueList": [
        "soln-abc123456"
      ]
    }
  ]
}

Étiquetez les solutions et les ensembles de modifications

Vous pouvez ajouter des balises aux solutions et modifier les ensembles lors de leur création ou les mettre à jour ultérieurement.

Tag lors de la création

Vous ne pouvez ajouter EntityTags qu'au type de CreateSolution modification, pas à d'autres types de modification de solution. Vous pouvez l'ajouter ChangeSetTags à n'importe quelle StartChangeSet charge utile.

POST /StartChangeSet HTTP/1.1
Content-type: application/json

{
  "Catalog": "AWSMarketplace",
  "ChangeSet": [
    {
      "ChangeType": "CreateSolution",
      "Entity": {
        "Type": "Solution@1.0"
      },
      "DetailsDocument": {
        "Name": "Test solution resource name"
      },
      "EntityTags": [
        {
          "Key": "Team",
          "Value": "Solutions"
        }
      ]
    }
  ],
  "ChangeSetTags": [
    {
      "Key": "Environment",
      "Value": "Production"
    }
  ]
}

Gérer les tags sur les ressources existantes

Utilisez les opérations TagResource et UntagResource API pour gérer les balises des solutions existantes et des ensembles de modifications. ListTagsForResourceÀ utiliser pour afficher les balises actuelles.

Pour plus d'informations, consultez les sections Gestion des balises sur les ressources et Ajout de balises à une entité et à un ensemble de modifications lors de la création.

Créez une solution

Vous pouvez utiliser le type de CreateSolution modification pour créer un nouveau document de solution avec uniquement un ID et un nom de solution. Les autres valeurs ne sont pas encore renseignées.

Lorsque votre demande est traitée avec succès, AWS Marketplace crée une solution Draft adaptée à vos besoins. Cette solution incomplète n'est pas visible pour les acheteurs sur AWS Marketplace.

Vous utilisez ensuite d'autres types de modifications pour terminer la solution : UpdateInformationUpdateRelatedProducts,, UpdateBuyerEngagementOptions (facultatif pour créer une Limited solution), etReleaseSolution. Le type de ReleaseSolution modification valide que tous les champs obligatoires nécessaires à une Limited solution sont présents sur la solution, puis la déplace vers la Limited visibilité.

Note

Pour déplacer une solution vers le statut Public ou pour modifier le statut d'une solution, utilisez le type de UpdateVisibility modification après avoir fourni les valeurs requises.

Syntaxe de la demande

POST /StartChangeSet HTTP/1.1
Content-type: application/json

{
  "Catalog": "AWSMarketplace",
  "ChangeSet": [
    {
      "ChangeType": "CreateSolution",
      "Entity": {
        "Type": "Solution@1.0"
      },
      "ChangeName": "CreateSolutionChange",
      "DetailsDocument": {
        "Name": "solution_for_customerX_en",
        "Title": "New Partner Solution"
      }
    }
  ]
}

Fournissez des informations pour les champs permettant d'ajouter le type de CreateSolution modification :

• Entity(object) (obligatoire) — Type nommé de l'entité de solution en cours de création.

  • Type(string) (obligatoire) — Le Type doit êtreSolution@1.0.

• DetailsDocument(objet) (obligatoire) — Les détails de la demande.

  • Name(chaîne) (obligatoire) : nom de la ressource AWS à titre de référence uniquement (non visible pour les acheteurs). Longueur maximale : 100 caractères Ne doit pas contenir d'espaces blancs de début ou de fin, de sauts de ligne ou de caractères de contrôle. Vous pouvez également mettre à jour la vignette de solution via le type de UpdateInformation modification.

  • Title(string) (facultatif) — Le titre de votre solution. Longueur maximale : 255 caractères Ne doit pas contenir d'espaces blancs de début ou de fin, de sauts de ligne ou de caractères de contrôle. Vous pouvez également définir ou mettre à jour le titre de la solution via le type de UpdateInformation modification.

Syntaxe de réponse

Un ensemble de modifications est créé pour votre demande. La réponse vous donne le ChangeSetId et ChangeSetArn :

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

La demande de modification est ajoutée à une file d'attente et traitée. Vous pouvez vérifier le statut à l'aide du portail de gestion AWS Marketplace ou du fonctionnement de l'DescribeChangeSetAPI.

Lorsque la demande est traitée avec succès (si Status c'est le casSUCCEEDED), un nouvel identifiant de solution est généré.

Erreurs asynchrones

CreateSolutionles actions renvoient des erreurs spécifiques, en plus des erreurs asynchrones courantes. Ces erreurs se produisent une DescribeChangeSet fois le traitement d'un ensemble de modifications terminé. Pour savoir comment obtenir le statut d'une demande de modification, consultez la section Utilisation des ensembles de modifications.

Code d’erreur	Message d’erreur
NOM_INVALIDE	La longueur du nom de la solution n'est pas valide. Entrez un nom composé de 1 à 100 caractères et réessayez.
NOM_MANQUANT	Une valeur de nom est requise. Spécifiez une valeur de nom et réessayez.
TITRE_VALIDE	La solution La longueur du titre n'est pas valide. Entrez un titre comportant entre 1 et 255 caractères et réessayez.

Mettre à jour les informations de solution

Si vous disposez déjà d'une solution sur AWS Marketplace, vous pouvez utiliser l'API Catalog pour mettre à jour les informations relatives à la solution.

Pour mettre à jour les informations relatives à la solution, appelez l'opération StartChangeSet API avec le type de UpdateInformation modification et vos informations mises à jour. Consultez l'exemple suivant.

Note

Les types de UpdateInformation modification se comportent comme des opérations HTTP PATCH pour les attributs de niveau supérieur. Comment les champs sont mis à jour :

• Si un attribut de niveau supérieur est présent dans leDetailsDocument, le flux de travail valide votre entrée et remplace les valeurs existantes.

• Si aucun champ de niveau supérieur n'est présent dans leDetailsDocument, la valeur existante est préservée.

• Pour annuler la définition d'un champ facultatif, envoyez un JSON explicite null pour ce champ.

AWS Marketplace vérifie et intègre le logo et les ressources multimédias promotionnelles dans un site AWS Marketplace-owned . DescribeEntity renvoie une URL accessible pour les fichiers ingérés, et non votre source d'entrée d' StartChangeSetorigine. Pour voir les URL que vous avez soumises d'origine, utilisez l' DescribeChangeSet API.

Note

Lorsque vous modifiez des fichiers PromotionalMedia d'actifs (en fournissant de nouvelles URL) sur une Public solution, UpdateInformation cela nécessite un examen manuel par l'équipe des opérations des vendeurs d'AWS Marketplace. Cela augmente le temps d'exécution. Dans ce scénario, utilisez-le UpdateInformation séparément dans son propre ensemble de modifications.

Syntaxe de la demande

POST /StartChangeSet HTTP/1.1
Content-type: application/json

{
  "Catalog": "AWSMarketplace",
  "ChangeSet": [
    {
      "ChangeType": "UpdateInformation",
      "Entity": {
        "Identifier": "soln-1234abcd",
        "Type": "Solution@1.0"
      },
      "DetailsDocument": {
        "Name": "project_cold_harbor",
        "Title": "My Awesome Solution",
        "ShortDescription": "Solution value proposition",
        "LongDescription": "Detailed solution description explaining how this addresses customer needs",
        "LogoUrl": "https://s3.amazonaws.com/awsmp-logos/logo.jpg",
        "PromotionalMedia": [
          {
            "Type": "Image",
            "Url": "https://s3.amazonaws.com/awsmp-media/image.jpg",
            "Title": "Sample image",
            "Description": "Sample image description"
          },
          {
            "Type": "Video",
            "Url": "https://s3.amazonaws.com/awsmp-media/video.mp4",
            "Title": "Sample video",
            "PreviewUrl": "https://s3.amazonaws.com/awsmp-media/preview.png",
            "Description": "Sample video description"
          }
        ],
        "AdditionalResources": [
          {
            "Text": "Troubleshooting guide",
            "Url": "https://example.com/troubleshooting"
          }
        ],
        "UseCases": [
          {
            "Group": "advertising_and_marketing",
            "SubGroup": "ad_intelligence_and_measurement",
            "Item": "amazon_ads_insights",
            "Description": "Highlight description of this use case"
          }
        ]
      }
    }
  ]
}

Fournissez des informations pour les champs permettant d'ajouter le type de UpdateInformation modification :

• Entity(object) (obligatoire) — Type d'entité nommé mis à jour.

  • Identifier(string) (obligatoire) — L'ID de la solution.

  • Type(string) (obligatoire) — Doit êtreSolution@1.0.

• DetailsDocument(objet) (obligatoire) — Les détails de la demande, y compris les informations que vous souhaitez mettre à jour pour votre solution. Chaque champ est facultatif, mais vous devez inclure au moins une modification pour le mettre à jour.

  • Name(chaîne) : nom de ressource de la solution, visible uniquement par le vendeur via les opérations de lecture de l'API du catalogue, invisible pour les acheteurs. Longueur maximale : 100 caractères Ne doit pas contenir d'espaces blancs de début ou de fin, de sauts de ligne ou de caractères de contrôle.

  • Title(string) — Le titre de la solution à afficher aux acheteurs. Longueur maximale : 255 caractères Ne doit pas contenir d'espaces blancs de début ou de fin, de sauts de ligne ou de caractères de contrôle.

  • ShortDescription(chaîne) — La description de la proposition de valeur des principaux aspects de la solution à présenter aux acheteurs. Il s'agit généralement de 2 à 3 phrases. Longueur maximale : 1000 caractères Ne doit pas contenir d'espaces blancs de début ou de fin ni de caractères de contrôle.

  • LongDescription(string) — Description plus longue de cette solution à afficher aux acheteurs. Il s'agit généralement de 1 à 3 paragraphes. Longueur maximale : 5000 caractères. Ne doit pas contenir d'espaces blancs de début ou de fin ni de caractères de contrôle.

  • LogoUrl(chaîne) — L'URL d'une image dans un compartiment Amazon S3 accessible au public ou une URL S3 présignée. Il doit s'agir d'une URL S3 directe (pas derrière CloudFront ou API Gateway). Longueur maximale : 2048 caractères. Pour les spécifications du logo, voir Exigences relatives au logo de l'entreprise et au logo du produit.

  • PromotionalMedia(ensemble d'objets) — Liste des images et vidéos promotionnelles. 15 articles maximum (5 vidéos et 10 images). Pour les spécifications relatives aux supports promotionnels, consultez la section Améliorez votre produit AWS Marketplace avec des supports promotionnels.

    • Type(chaîne) (obligatoire) — L'un Image ou l'autreVideo.

    • Url(string) (obligatoire) — URL du fichier multimédia. Il doit s'agir d'une URL S3 directe ou d'une URL S3 présignée. Longueur maximale : 2048 caractères. Il doit s'agir d'une URL https.

    • Title(string) (obligatoire) — Titre du média. Longueur maximale : 100 caractères Ne doit pas contenir d'espaces blancs de début ou de fin, de sauts de ligne ou de caractères de contrôle.

    • Description(string) (obligatoire) — Description du média. Longueur maximale : 200 caractères. Ne doit pas contenir d'espaces blancs de début ou de fin ni de caractères de contrôle.

    • PreviewUrl(chaîne) (facultatif) — Pour les vidéos uniquement, URL d'une image d'aperçu. Longueur maximale : 2048 caractères. Il doit s'agir d'une URL https.

  • AdditionalResources(tableau d'objets) — Liste des références à des ressources supplémentaires. 8 articles maximum.

    • Text(chaîne) — Le nom ou le titre de la ressource. Longueur maximale : 500 caractères Ne doit pas contenir d'espaces blancs de début ou de fin, de sauts de ligne ou de caractères de contrôle.

    • Url(string) — URL de la ressource. Longueur maximale : 2048 caractères. Il doit s'agir d'une URL https.

  • UseCases(tableau d'objets) — Liste des cas d'utilisation auxquels cette solution répond. 3 articles maximum. Pour les catégories de cas d'utilisation valides (combinaison de Groupe SubGroup, et Article), consultez la liste des catégories de cas d'utilisation pour les valeurs acceptées actives et leurs étiquettes d'introduction. La combinaison de Group SubGroup, et Item doit être un élément valide dans la liste des catégories de cas d'utilisation.

    • Group(string) — Catégorie d'industrie ou de technologie. Il doit s'agir de l'une des valeurs de groupe dans la liste des catégories de cas d'utilisation.

    • SubGroup(string) — Groupe de cas d'utilisation au sein de la catégorie. Doit être l'une des SubGroup valeurs de la liste des catégories de cas d'utilisation.

    • Item(string) — Cas d'utilisation spécifique. Il doit s'agir de l'une des valeurs d'article figurant dans la liste des catégories de cas d'utilisation.

    • Description(string) — Description de la manière dont cette solution répond au cas d'utilisation. Longueur maximale : 500 caractères Ne doit pas contenir d'espaces blancs de début ou de fin ni de caractères de contrôle.

Pour obtenir des informations sur les URL présignées, consultez la section Partage d'objets avec des URL présignées.

Note

Lorsque vous appelez UpdateInformation change type, vous pouvez toujours fournir un sous-ensemble de champs à mettre à jour dans l'DetailsDocumentobjet. Toutefois, avant de déplacer une solution de Draft versLimited, les champs suivants doivent être correctement définis : TitleShortDescription,LongDescription, etLogoUrl.

Toutefois, lorsque vous mettez à jour des champs existants dans la solution, vous ne pouvez inclure que les attributs qui doivent être modifiés dans l'DetailsDocumentobjet du type de UpdateInformation modification.

Syntaxe de réponse

Un ensemble de modifications est créé pour votre demande. La réponse à cette demande vous donne l'ChangeSetIdensemble ChangeSetArn de modifications et ressemble à ce qui suit.

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

La demande de modification est ajoutée à une file d'attente et traitée. Pour vérifier le statut de la demande, utilisez le portail de gestion AWS Marketplace ou appelez l'DescribeChangeSetAPI.

Après avoir déclenché ce type de modification avec PromotionalMedia des actifs modifiés pour une Public solution, son exécution peut prendre jusqu'à 37 jours. Cela inclut le temps dont l'équipe des opérations des vendeurs d'AWS Marketplace a besoin pour examiner, auditer et approuver.

Erreurs asynchrones

Outre les erreurs asynchrones courantes, les erreurs suivantes sont spécifiques aux UpdateInformation actions de l'API AWS Marketplace Catalog. Ces erreurs sont renvoyées lorsque vous appelez DescribeChangeSet après le traitement d'un ensemble de modifications. Pour plus d'informations sur l'utilisation DescribeChangeSet pour obtenir le statut d'une demande de modification, consultez la section Utilisation d'ensembles de modifications.

Code d’erreur	Message d’erreur
DESCRIPTION_COURTE NON VALIDE	La ShortDescription longueur de la solution n'est pas valide. Entrez une ShortDescription valeur comprise entre 1 et 1 000 caractères et réessayez.
DESCRIPTION_LONGUE NON VALIDE	La LongDescription longueur de la solution n'est pas valide. Entrez une LongDescription valeur comprise entre 1 et 5 000 caractères et réessayez.
NOM_INVALIDE	La longueur du nom de la solution n'est pas valide. Entrez un nom composé de 1 à 100 caractères et réessayez.
TITRE_VALIDE	La solution La longueur du titre n'est pas valide. Entrez un titre comportant entre 1 et 255 caractères et réessayez.
RESSOURCES_SUPPLÉMENTAIRES NON VALIDES	La solution AdditionalResources [%d] .La longueur du texte n'est pas valide. Entrez un texte de 1 à 500 caractères et réessayez.
RESSOURCES_SUPPLÉMENTAIRES NON VALIDES	Les URL suivantes figurant dans les ressources supplémentaires fournies ne sont pas accessibles : [%s]. Fournissez des URL valides et accessibles
RESSOURCES_SUPPLÉMENTAIRES NON VALIDES	Une valeur d'URL est requise. Spécifiez une valeur d'URL et réessayez.
RESSOURCES_SUPPLÉMENTAIRES NON VALIDES	Le texte ne peut pas manquer. Fournir un texte
CAS D'UTILISATION NON VALIDE	La solution UseCases [%d] .La longueur de la description n'est pas valide. Entrez une description de 1 à 500 caractères et réessayez.
CAS D'UTILISATION NON VALIDE	UseCases[%d] .Groupe : le groupe fourni (%s) n'est pas valide. Indiquez un groupe valide.
CAS D'UTILISATION NON VALIDE	UseCases[%d]. SubGroup: Le groupe fourni (%s) n'est pas valide. Fournissez un code valide SubGroup.
CAS D'UTILISATION NON VALIDE	UseCases[%d] .Article : L'article fourni (%s) n'est pas valide. Fournissez un article valide.
CAS D'UTILISATION NON VALIDE	UseCases[%d] .Élément : Le cas d'utilisation fourni est inactif. Fournir un cas d'utilisation actif
CAS D'UTILISATION NON VALIDE	UseCases[%d] .Groupe : le groupe ne peut pas être absent. Indiquez un groupe.
CAS D'UTILISATION NON VALIDE	UseCases[%d]. SubGroup: SubGroup ne peut pas manquer. Fournissez un SubGroup.
CAS D'UTILISATION NON VALIDE	UseCases[%d] .Élément : SubGroup ne peut pas être manquant. Fournissez un article.
MÉDIA NON VALIDE	La solution PromotionalMedia [%d] .La longueur du titre n'est pas valide. Entrez un titre comportant entre 1 et 100 caractères et réessayez.
MÉDIA NON VALIDE	La solution PromotionalMedia [%d] .La longueur de la description n'est pas valide. Entrez une description de 1 à 200 caractères et réessayez.
MÉDIA NON VALIDE	URL non valide : %s Fournissez une nouvelle URL pour les médias stockés dans S3.
MÉDIA NON VALIDE	Emplacement du média non accessible : %s Fournissez une nouvelle URL accessible pour le contenu multimédia stocké dans l'un des emplacements suivants : [S3].
MÉDIA NON VALIDE	La taille de l'image est supérieure à %s. Fournissez une image inférieure à %s.
MÉDIA NON VALIDE	La taille de la vidéo dépasse %s. Fournissez une vidéo inférieure à %s.
MÉDIA NON VALIDE	La taille du logo dépasse %s. Fournissez un logo inférieur à %s.
MÉDIA NON VALIDE	Un logiciel malveillant a été détecté dans %s. Fournissez des contenus multimédias exempts de logiciels malveillants.
MÉDIA NON VALIDE	Contenu inapproprié : %s détecté. Fournir des médias sans contenu inapproprié
MÉDIA NON VALIDE	Contenu explicite dans %s : '{ExplicitContent}' détecté. Fournissez des médias sans contenu explicite.
MÉDIA NON VALIDE	PromotionalMedia[%s] .Le format de l'URL : %s n'est pas pris en charge (%s). Utilisez une image bien formée dans un format compatible : [JPEG, PNG].
MÉDIA NON VALIDE	PromotionalMedia[%s] .Le format de l'URL : %s n'est pas pris en charge (%s). Utilisez une vidéo bien formée dans un format compatible : [MP4, MOV].
MÉDIA NON VALIDE	LogoUrl à %s, le rapport hauteur/largeur n'est pas valide. Fournissez une image au format 1:1 (carré) ou 2:1 (large).
MÉDIA NON VALIDE	Les dimensions du logo : %s ne sont pas valides. Fournissez une image comprise entre 120 x 120 et 1080 x 1080 pixels.
MÉDIA NON VALIDE	PromotionalMedia[%d] .Le type n'est pas pris en charge. Fournir PromotionalMedia dans un type pris en charge : %s
DUPLICATE_MEDIA	Supports dupliqués détectés : [%s] Fournissez des éléments multimédias exempts de doublons.
MÉDIA NON VALIDE	PromotionalMedia[%d] .Url : logiciel malveillant détecté dans %s. Fournissez des contenus multimédias exempts de logiciels malveillants.
TROP D'ARTICLES	Ne fournissez pas plus de %d %s.

Mettre à jour les produits connexes

Vous pouvez utiliser l'API Catalog pour mettre à jour les produits et services inclus dans votre solution, y compris les produits AWS Marketplace et les produits non AWS Marketplace.

Pour mettre à jour les produits associés, appelez l'opération StartChangeSet API avec le type de UpdateRelatedProducts modification, comme indiqué dans l'exemple suivant.

Note

Le type de UpdateRelatedProducts modification se comporte comme une opération HTTP PATCH pour les attributs de niveau supérieur. Vous pouvez fournir tous les types de produits AWS Marketplace actuels tels AwsMarketplaceProducts quelsUpdateRelatedProducts.

Syntaxe de la demande

POST /StartChangeSet HTTP/1.1
Content-type: application/json

{
  "Catalog": "AWSMarketplace",
  "ChangeSet": [
    {
      "ChangeType": "UpdateRelatedProducts",
      "Entity": {
        "Type": "Solution@1.0",
        "Identifier": "soln-123456"
      },
      "DetailsDocument": {
        "IntegrationDescription": "How to use the products in this solution (usage guide)",
        "AwsMarketplaceProducts": [
          {
            "ProductId": "prod-123"
          },
          {
            "ProductId": "prod-456"
          }
        ],
        "NonAwsMarketplaceProducts": [
          {
            "Type": "Hardware",
            "Title": "Diamond engine",
            "Description": "Hardware details",
            "Url": "https://example.com/hardware-product-specs.html"
          }
        ]
      }
    }
  ]
}

Fournissez des informations pour les champs permettant d'ajouter le type de UpdateRelatedProducts modification :

• Entity(object) (obligatoire) — Type d'entité nommé mis à jour.

  • Identifier(string) (obligatoire) — L'ID de la solution.

  • Type(string) (obligatoire) — Doit êtreSolution@1.0.

• DetailsDocument(objet) (obligatoire) — Les détails de la demande. Chaque champ est facultatif, mais vous devez inclure au moins une modification pour le mettre à jour.

  • IntegrationDescription(string) — Description de la façon dont les produits fonctionnent ensemble dans cette solution. Longueur maximale : 5000 caractères. Ne doit pas contenir d'espaces blancs de début ou de fin ni de caractères de contrôle.

  • AwsMarketplaceProducts(ensemble d'objets) : produits AWS Marketplace inclus dans cette solution. 5 articles maximum

    • ProductId(string) — ID du produit AWS Marketplace (un UUID ou une chaîne commençant prod- par). Longueur maximale : 50 caractères

  • NonAwsMarketplaceProducts(ensemble d'objets) — Produits non disponibles sur AWS Marketplace. 5 articles maximum.

    • Type(string) (obligatoire) — Type de produit. Valeurs possibles :Software,Consulting,Hardware,Communication,Professional Service,Managed Service,Value-Added Resale, Training

    • Title(string) (obligatoire) — Titre du produit. Longueur maximale : 255 caractères Ne doit pas contenir d'espaces blancs de début ou de fin, de sauts de ligne ou de caractères de contrôle.

    • Description(chaîne) (facultatif) — Description du produit. Longueur maximale : 220 caractères Ne doit pas contenir d'espaces blancs de début ou de fin ni de caractères de contrôle.

    • Url(string) (facultatif) — URL permettant d'obtenir plus d'informations sur le produit. Longueur maximale : 2048 caractères. Il doit s'agir d'une URL https.

Syntaxe de réponse

Un ensemble de modifications est créé pour votre demande. La réponse à cette demande vous donne l'ChangeSetIdensemble ChangeSetArn de modifications et ressemble à ce qui suit.

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

La demande de modification est ajoutée à une file d'attente et traitée.

Pour vérifier le statut de la demande, utilisez le portail de gestion AWS Marketplace ou appelez l'DescribeChangeSetAPI.

Erreurs asynchrones

Outre les erreurs asynchrones courantes, les erreurs suivantes sont spécifiques aux UpdateRelatedProducts actions de l'API AWS Marketplace Catalog. Ces erreurs sont renvoyées lorsque vous appelez DescribeChangeSet après le traitement d'un ensemble de modifications. Pour plus d'informations sur l'utilisation DescribeChangeSet pour obtenir le statut d'une demande de modification, consultez la section Utilisation d'ensembles de modifications.

Code d’erreur	Message d’erreur
SOLUTION_OPÉRATIONNEL_MISE À JOUR INCOMPATIBLE_DE_PRODUITS_CONNEXES	L'opération de mise à jour des produits associés n'est pas prise en charge pour les solutions publiques. Pour effectuer cette modification, définissez d'abord la visibilité de la solution sur Limitée, puis réessayez.
INVALIDE_ AWS_MARKETPLACE_PRODUCTS	Le produit « %s » d'AWS Marketplace n'est pas disponible pour votre compte. Choisissez un produit public ou limité pour lequel vous avez accès à la liste des produits autorisés, ou contactez le vendeur pour demander l'accès.
INVALIDE_ AWS_MARKETPLACE_PRODUCTS	Le type de produit spécifié « %s » n'est pas pris en charge. Indiquez l'un des types de produits valides suivants : [AmiProduct, SaasProduct,, ContainerProduct, MachineLearningProduct ProfessionalServicesProduct, DataProduct] et réessayez.
INVALIDE_ AWS_MARKETPLACE_PRODUCTS	Le produit « %s » est introuvable. Indiquez un identifiant de produit valide dans le même catalogue.
INVALIDE_NON_ AWS_MARKETPLACE_PRODUCTS	Les URL des produits Non-AWS Marketplace spécifiés ne sont pas accessibles : [%s]. Vérifiez que les URL sont valides et accessibles au public, puis réessayez.
DESCRIPTION_D'INTÉGRATION NON VALIDE	Fournissez une solution IntegrationDescription comprise entre 1 et 5 000 caractères.
INVALIDE_NON_ AWS_MARKETPLACE_PRODUCTS	La solution NonAwsMarketplaceProduct [%d] .La longueur du titre n'est pas valide. Entrez une description comprenant entre 1 et 255 caractères et réessayez.
INVALIDE_NON_ AWS_MARKETPLACE_PRODUCTS	La solution NonAwsMarketplaceProduct [%d] .La longueur de la description n'est pas valide. Entrez une description de 1 à 220 caractères et réessayez.
INVALIDE_NON_ AWS_MARKETPLACE_PRODUCTS	La solution NonAwsMarketplaceProduct [%d] .La longueur du type n'est pas valide. Entrez un type comprenant entre 1 et 50 caractères et réessayez.
INVALIDE_NON_ AWS_MARKETPLACE_PRODUCTS	NonAwsMarketplaceProduct[%d] .Type n'est pas un type de produit non AWS Marketplace valide. Fournissez l'un des types de produits autres qu'AWS Marketplace suivants : [%s]
INVALIDE_NON_ AWS_MARKETPLACE_PRODUCTS	Une valeur NonAwsMarketplaceProduct [%d] .Title est requise. Spécifiez une valeur de titre et réessayez.
INVALIDE_NON_ AWS_MARKETPLACE_PRODUCTS	Une valeur NonAwsMarketplaceProduct [%d] .Type est requise. Spécifiez une valeur de type et réessayez.
TROP DE PRODUITS	Le nombre maximum de produits AWS Marketplace que vous pouvez associer est de %d. Supprimez les produits associés existants avant d'en ajouter de nouveaux.
TROP DE PRODUITS	Le nombre maximum de produits AWS Marketplace que vous pouvez ajouter est de %d. Supprimez les produits AWS Marketplace qui n'existent pas avant d'en ajouter de nouveaux.
INVALIDE_ AWS_MARKETPLACE_PRODUCTS	Les identifiants de produit AWS Marketplace dupliqués ne sont pas autorisés. Chaque identifiant de produit doit être unique dans votre solution.
OPÉRATION_DE SUPPRESSION NON VALIDE	Opération non valide, vous ne pouvez pas supprimer tous les produits.

Publier une solution

Vous pouvez utiliser l'API Catalog pour publier une Draft solution Limited visible sur AWS Marketplace.

Le type de ReleaseSolution modification confirme que tous les champs obligatoires pour une Limited solution sont présents. Il fait ensuite passer la solution de la zone de Limited visibilité Draft à la zone de visibilité. Une fois qu'une solution est Limited visible, vous ne pouvez pas la remettre en Draft visibilité.

Pour publier une solution, appelez l'opération StartChangeSet API avec le type de ReleaseSolution modification, comme indiqué dans l'exemple suivant.

Syntaxe de la demande

POST /StartChangeSet HTTP/1.1
Content-type: application/json

{
  "Catalog": "AWSMarketplace",
  "ChangeSet": [
    {
      "ChangeType": "ReleaseSolution",
      "Entity": {
        "Type": "Solution@1.0",
        "Identifier": "soln-1234abcd"
      },
      "DetailsDocument": {}
    }
  ]
}

Fournissez des informations pour les champs permettant d'ajouter le type de ReleaseSolution modification :

• Entity(object) (obligatoire) — Le type d'entité nommé qui est publié.

  • Identifier(string) (obligatoire) — L'ID de la solution.

  • Type(string) (obligatoire) — Doit êtreSolution@1.0.

• DetailsDocument(object) (obligatoire) — Il doit s'agir d'un objet vide. Le type de modification ReleaseSolution n'accepte aucun détail.

Syntaxe de réponse

Un ensemble de modifications est créé pour votre demande. La réponse à cette demande vous donne l'ChangeSetIdensemble ChangeSetArn de modifications et ressemble à ce qui suit.

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

La demande de modification est ajoutée à une file d'attente et traitée. Vous pouvez vérifier le statut de la demande via le portail de gestion AWS Marketplace ou directement via l'API Catalog à l'aide de l'opération DescribeChangeSet API.

Erreurs asynchrones

Outre les erreurs asynchrones courantes, les erreurs suivantes sont spécifiques aux ReleaseSolution actions de l'API AWS Marketplace Catalog. Ces erreurs sont renvoyées lorsque vous appelez DescribeChangeSet après le traitement d'un ensemble de modifications. Pour plus d'informations sur l'utilisation DescribeChangeSet pour obtenir le statut d'une demande de modification, consultez la section Utilisation d'ensembles de modifications.

Code d’erreur	Message d’erreur
CHAMPS OBLIGATOIRES MANQUANTS	La demande ne contient pas les paramètres requis : [%s]. Spécifiez des valeurs pour tous les paramètres requis et réessayez.
SOLUTION_OPÉRATIONNEL_RELEASE_INCOMPATIBLE	Le type de modification ne peut être invoqué que dans le statut Solutions in Draft. Mettez à jour la visibilité de la solution sur Brouillon et réessayez.

Mettre à jour les options d'engagement des acheteurs

Vous pouvez utiliser l'API du catalogue pour configurer la manière dont les acheteurs interagissent avec vous à propos de votre solution.

Note

Pour utiliser ce type de modification, vous devez être inscrit activement au programme APN Customer Engagements (ACE). Vous devez également associer votre compte AWS à votre compte AWS Partner Central inscrit à ACE. Pour obtenir des instructions, consultez Lier les comptes AWS Partner Central et AWS.

Pour mettre à jour les options d'engagement des acheteurs, appelez l'opération StartChangeSet API avec le type de UpdateBuyerEngagementOptions modification, comme indiqué dans l'exemple suivant.

Syntaxe de la demande

POST /StartChangeSet HTTP/1.1
Content-type: application/json

{
  "Catalog": "AWSMarketplace",
  "ChangeSet": [
    {
      "ChangeType": "UpdateBuyerEngagementOptions",
      "Entity": {
        "Type": "Solution@1.0",
        "Identifier": "soln-1234abcd"
      },
      "DetailsDocument": [
        {
          "EngagementOption": "RequestProductDemo"
        },
        {
          "EngagementOption": "RequestPrivateOffer"
        }
      ]
    }
  ]
}

Fournissez des informations pour les champs permettant d'ajouter le type de UpdateBuyerEngagementOptions modification :

• Entity(object) (obligatoire) — Type d'entité nommé mis à jour.

  • Identifier(string) (obligatoire) — L'ID de la solution.

  • Type(string) (obligatoire) — Doit êtreSolution@1.0.

• DetailsDocument(ensemble d'objets) (obligatoire) — Les options d'engagement des acheteurs à activer.

  • EngagementOption(string) (obligatoire) — Type d'option d'engagement. Valeurs valides : RequestPrivateOffer, RequestProductDemo.

Syntaxe de réponse

Un ensemble de modifications est créé pour votre demande. La réponse à cette demande vous donne l'ChangeSetIdensemble ChangeSetArn de modifications et ressemble à ce qui suit.

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

La demande de modification est ajoutée à une file d'attente et traitée.

Pour vérifier le statut de la demande, utilisez le portail de gestion AWS Marketplace ou appelez l'DescribeChangeSetAPI.

Erreurs asynchrones

Outre les erreurs asynchrones courantes, les erreurs suivantes sont spécifiques aux UpdateBuyerEngagementOptions actions de l'API AWS Marketplace Catalog. Ces erreurs sont renvoyées lorsque vous appelez DescribeChangeSet après le traitement d'un ensemble de modifications. Pour plus d'informations sur l'utilisation DescribeChangeSet pour obtenir le statut d'une demande de modification, consultez la section Utilisation d'ensembles de modifications.

Code d’erreur	Message d’erreur
VENDEUR_INÉLIGIBLE	La validation de l'éligibilité à ACE n'est pas terminée. Pour continuer : 1) Associez votre compte AWS Marketplace à votre compte APN, 2) Remplissez les conditions d'éligibilité ACE.

Mettre à jour la visibilité des solutions

Vous pouvez utiliser l'API Catalog pour mettre à jour la visibilité d'une solution sur AWS Marketplace.

Vous pouvez définir des visibilités cibles sur LimitedPublic, ouRestricted.

• Limited— La solution est complète et le type de ReleaseSolution modification a été effectué avec succès. Vous pouvez prévisualiser les détails de la solution sur le site Web de l'acheteur dans cette visibilité. Sur le site Web de l'acheteur d'AWS Marketplace, la solution n'est visible que par le compte propriétaire, les propriétaires de chaque produit AWS Marketplace inclus dans la solution et l'équipe des opérations des vendeurs d'AWS Marketplace.

• Public— La solution est visible sur AWS Marketplace. Les acheteurs peuvent consulter la solution et interagir avec elle.

• Restricted— La solution n'est plus visible par le public sur le site Web des acheteurs d'AWS Marketplace.

Note

Pour passer d'une solution à Public la visibilité, vous devez répondre aux exigences suivantes :

• Vous devez disposer d'un profil public sur AWS Marketplace.

• La solution ne doit contenir aucun Public produit non dérivé.

• La solution doit comporter au moins 2 produits Public AWS Marketplace.

• La solution doit disposer d'au moins un produit AWS Marketplace issu du même compte AWS.

• L'option d'engagement des RequestPrivateOffer acheteurs doit être activée dans la solution.

• L'équipe des opérations des vendeurs d'AWS Marketplace examine toutes les demandes visant à améliorer la Public visibilité d'une solution. Pour obtenir de l'aide, consultez Obtenir de l'aide pour AWS Marketplace.

Lorsque vous définissez TargetVisibility ce paramètre surPublic, le type de UpdateVisibility modification nécessite un examen manuel de la part de l'équipe AWS Marketplace Seller Operations. Cela augmente le temps d'exécution. À utiliser UpdateVisibility séparément dans son propre kit de changement.

Pour mettre à jour la visibilité de votre solution, appelez l'opération StartChangeSet API avec le type de UpdateVisibility modification, comme indiqué dans l'exemple suivant.

Syntaxe de la demande

Pour quand TargetVisibility est-ce Public ouLimited.

POST /StartChangeSet HTTP/1.1
Content-type: application/json

{
  "Catalog": "AWSMarketplace",
  "ChangeSet": [
    {
      "ChangeType": "UpdateVisibility",
      "Entity": {
        "Type": "Solution@1.0",
        "Identifier": "soln-1234abcd"
      },
      "DetailsDocument": {
        "TargetVisibility": "Public"
      }
    }
  ]
}

Pour quand TargetVisibilityRestricted.

POST /StartChangeSet HTTP/1.1
Content-type: application/json

{
  "Catalog": "AWSMarketplace",
  "ChangeSet": [
    {
      "ChangeType": "UpdateVisibility",
      "Entity": {
        "Type": "Solution@1.0",
        "Identifier": "soln-1234abcd"
      },
      "DetailsDocument": {
        "TargetVisibility": "Restricted"
      }
    }
  ]
}

Fournissez des informations pour les champs permettant d'ajouter le type de UpdateVisibility modification :

• Entity(object) (obligatoire) — Type d'entité nommé mis à jour.

  • Identifier(string) (obligatoire) — L'ID de la solution.

  • Type(string) (obligatoire) — Doit êtreSolution@1.0.

• DetailsDocument(object) (obligatoire) — Les informations requises pour exécuter l'ensemble de modifications.

  • TargetVisibility(string) (obligatoire) — La nouvelle visibilité prévue de la solution. Les valeurs possibles sont : Public, Limited et Restricted.

Syntaxe de réponse

Un ensemble de modifications est créé pour votre demande. La réponse à cette demande vous donne l'ChangeSetIdensemble ChangeSetArn de modifications et ressemble à ce qui suit.

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

La demande de modification est ajoutée à une file d'attente et traitée.

Vous pouvez vérifier le statut de la demande via le portail de gestion AWS Marketplace ou directement via l'API Catalog à l'aide de l'opération DescribeChangeSet API.

Après avoir déclenché ce type de modification avec TargetVisibility asPublic, son exécution peut prendre jusqu'à 37 jours. Cela inclut le temps dont l'équipe des opérations des vendeurs d'AWS Marketplace a besoin pour examiner, auditer et approuver.

Erreurs asynchrones

Les erreurs suivantes sont spécifiques aux UpdateVisibility actions effectuées dans l'API AWS Marketplace Catalog. Ces erreurs sont renvoyées lorsque vous appelez DescribeChangeSet après le traitement d'un ensemble de modifications. Pour plus d'informations sur l'utilisation DescribeChangeSet pour obtenir le statut d'une demande de modification, consultez la section Utilisation d'ensembles de modifications.

Code d’erreur	Message d’erreur
TRANSITION DE VISIBILITÉ NON VALIDE	La solution ne peut pas être ramenée à l'état Brouillon. Une fois publiées, les solutions peuvent uniquement passer des états Limité, Public et Restreint.
TROP PEU DE CAS D'UTILISATION	Au moins un cas d'utilisation est requis pour rendre publique une solution. Ajoutez un cas d'utilisation et réessayez.
TROP PEU DE PRODUITS PUBLICS	Un minimum de 2 produits AWS Marketplace publics sont nécessaires pour rendre une solution publique. Ajoutez les produits requis et réessayez.
PRODUITS_INCOMPATIBLES	La solution contient un ou plusieurs produits AWS Marketplace non publics. Pour rendre la solution publique, supprimez tous les produits non publics et réessayez.
TROP PEU DE PRODUITS AUTOPOSSÉDÉS	La solution nécessite au moins un produit AWS Marketplace appartenant au propriétaire de la solution. Ajoutez un produit AWS Marketplace depuis votre compte et réessayez.
OPTIONS D'ENGAGEMENT DE L'ACHETEUR INCOMPATIBLES	L'option d'engagement de RequestPrivateOffer l'acheteur doit être activée pour rendre cette solution publique. Activez RequestPrivateOffer et réessayez.
INCOMPATIBLE_OPERATION_UPDATE_VISIBILITY	UpdateVisibility n'est pas pris en charge pour les solutions à l'état de brouillon. Publiez d'abord la solution de Brouillon à Limité en utilisant ReleaseSolution, puis UpdateVisibility utilisez-la pour passer à Public ou Restreint.
LIMITE DÉPASSÉE PAR TROP DE SOLUTIONS PUBLIQUES	Ce compte a atteint sa limite de 5 solutions publiques. Mettez à jour une solution publique existante vers une visibilité limitée ou restreinte et réessayez.
INFORMATIONS MANQUANTES SUR LE PROFIL_VENDEUR	Un profil de vendeur public est nécessaire pour rendre les solutions publiques. Créez un profil public sur votre compte vendeur et réessayez.

Codes d'erreur asynchrones courants

Certaines validations asynchrones s'appliquent à tous les types de modifications de solutions, telles que les vérifications de la validité des URL et des caractères non pris en charge, et leurs codes d'erreur et messages d'erreur sont répertoriés ici.

Chaque champ d'URL fourni doit utiliser le protocole HTTPS et être conforme aux normes RFC2396 ou RFC 2732.

Code d’erreur	Message d’erreur
ENTRÉE_VALIDE	Champ « %s » non valide. Supprimez les caractères non pris en charge %s.
ENTRÉE_VALIDE	Du contenu inapproprié « %s » a été détecté dans le champ %s. Fournissez à %s aucun contenu inapproprié.
CATALOGUE_NON PRIS EN CHARGE	Le catalogue demandé %s n'est pas pris en charge par ce type de modification.
OPÉRATION_DE SUPPRESSION NON VALIDE	Opération non valide, vous ne pouvez pas supprimer %s
ERREUR_AUDIT	(varie en fonction du résultat de l'audit de l'équipe des opérations des vendeurs d'AWS Marketplace)

Cycle de vie des solutions

Les solutions progressent grâce aux valeurs de visibilité suivantes :

• Draft- Visibilité initiale après la création. Vous pouvez ajouter progressivement des informations à l'aide d'autres types de modifications.

• Limited- La solution est complète et visible pour vous et les propriétaires du produit pour un aperçu. Vous y parvenez en utilisantReleaseSolution.

• Public- La solution est visible par tous les acheteurs qui naviguent sur le site Web AWS Marketplace. Cela nécessite une validation supplémentaire.

• Restricted- La solution n'est plus visible pour les nouveaux acheteurs.

Important

Une fois qu'une solution est passée Draft de la Limited catégorie « visibilité », vous ne pouvez pas la déplacer à nouveauDraft. ReleaseSolutionvérifie que tous les champs obligatoires pour une Limited solution sont présents avant le passage à la Limited visibilité.

Exigences minimales pour une solution complète

Pour créer une solution complète et la publier au-delà du statut de brouillon, vous avez besoin des types de modifications et des attributs suivants :

• CreateSolution: Name

• UpdateInformation: Title, ShortDescription, LongDescription, LogoUrl

• UpdateRelatedProducts:IntegrationDescription, au moins un élément en travers AwsMarketplaceProducts et NonAwsMarketplaceProducts

• ReleaseSolution

L'exemple suivant vous montre comment créer une solution complète avec Limited visibilité dans un ensemble de modifications unique :

{
  "Catalog": "AWSMarketplace",
  "ChangeSet": [
    {
      "ChangeType": "CreateSolution",
      "Entity": {
        "Type": "Solution@1.0"
      },
      "ChangeName": "CreateSolutionChange",
      "DetailsDocument": {
        "Name": "complete_solution_example",
        "Title": "Complete Solution Example"
      }
    },
    {
      "ChangeType": "UpdateInformation",
      "Entity": {
        "Type": "Solution@1.0",
        "Identifier": "$CreateSolutionChange.Entity.Identifier"
      },
      "ChangeName": "UpdateInformationChange",
      "DetailsDocument": {
        "ShortDescription": "A comprehensive solution for customer needs",
        "LongDescription": "This solution combines multiple products to address specific customer requirements in the advertising and marketing space.",
        "LogoUrl": "https://s3.amazonaws.com/awsmp-logos/solution-logo.jpg",
        "UseCases": [
          {
            "Group": "advertising_and_marketing",
            "SubGroup": "ad_intelligence_and_measurement",
            "Item": "amazon_ads_insights",
            "Description": "Provides comprehensive advertising insights and measurement capabilities"
          }
        ]
      }
    },
    {
      "ChangeType": "UpdateRelatedProducts",
      "Entity": {
        "Type": "Solution@1.0",
        "Identifier": "$CreateSolutionChange.Entity.Identifier"
      },
      "ChangeName": "UpdateRelatedProductsChange",
      "DetailsDocument": {
        "AwsMarketplaceProducts": [
          {
            "ProductId": "prod-123"
          }
        ],
        "IntegrationDescription": "These products work together to provide end-to-end advertising analytics and optimization capabilities."
      }
    },
    {
      "ChangeType": "UpdateBuyerEngagementOptions",
      "Entity": {
        "Type": "Solution@1.0",
        "Identifier": "$CreateSolutionChange.Entity.Identifier"
      },
      "ChangeName": "UpdateBuyerEngagementChange",
      "DetailsDocument": [
        {
          "EngagementOption": "RequestPrivateOffer"
        }
      ]
    },
    {
      "ChangeType": "ReleaseSolution",
      "Entity": {
        "Type": "Solution@1.0",
        "Identifier": "$CreateSolutionChange.Entity.Identifier"
      },
      "ChangeName": "ReleaseSolutionChange",
      "DetailsDocument": {}
    }
  ]
}

Autorisations IAM pour les solutions

L'API AWS Marketplace Catalog utilise les autorisations IAM standard. Consultez la section Contrôle d'accès pour l'API AWS Marketplace Catalog pour plus de détails.

Vous pouvez l'utiliser AWSMarketplaceSellerProductFullAccess pour effectuer toutes les opérations nécessaires pour accéder à la solution via l'API Catalog et Partner Central 3.0 dans AWS Management Console.

Exemple de politique IAM pour les solutions

L'exemple de politique IAM suivant autorise des actions spécifiques (DescribeEntity,ListEntities, etStartChangeSet) sur Solution@1.0 l'entité. Vous pouvez l'affiner davantage pour restreindre l'accès d'un principal à certains types de modifications sur certains identifiants d'entité, ou l'élargir pour permettre à un principal d'opérer également sur un autre type d'entité pris en charge par l'API Catalog.

{
  "Statement": [
    {
      "Effect": "Allow",
      "Action": [
        "aws-marketplace:StartChangeSet"
      ],
      "Resource": [
        "arn:aws:aws-marketplace:us-east-1:123456789012:AWSMarketplace/Solution/*",
        "arn:aws:aws-marketplace:us-east-1:123456789012:AWSMarketplace/ChangeSet/*"
      ],
      "Condition": {
        "StringEquals": {
          "catalog:ChangeType": [
            "CreateSolution",
            "UpdateInformation",
            "UpdateRelatedProducts",
            "ReleaseSolution",
            "UpdateBuyerEngagementOptions",
            "UpdateVisibility"
          ]
        }
      }
    },
    {
      "Effect": "Allow",
      "Action": [
        "aws-marketplace:ListEntities",
        "aws-marketplace:DescribeEntity"
      ],
      "Resource": [
        "arn:aws:aws-marketplace:us-east-1:123456789012:AWSMarketplace/Solution/*"
      ]
    },
    {
      "Effect": "Allow",
      "Action": [
        "aws-marketplace:DescribeChangeSet",
        "aws-marketplace:ListChangeSets",
        "aws-marketplace:CancelChangeSet"
      ],
      "Resource": [
        "arn:aws:aws-marketplace:us-east-1:123456789012:AWSMarketplace/ChangeSet/*"
      ]
    },
    {
      "Effect": "Allow",
      "Action": [
        "aws-marketplace:TagResource",
        "aws-marketplace:UntagResource",
        "aws-marketplace:ListTagsForResource"
      ],
      "Resource": [
        "arn:aws:aws-marketplace:us-east-1:123456789012:AWSMarketplace/Solution/*",
        "arn:aws:aws-marketplace:us-east-1:123456789012:AWSMarketplace/ChangeSet/*"
      ]
    }
  ]
}

Restreindre l'accès à des solutions spécifiques

Vous pouvez restreindre l'accès à des solutions spécifiques en utilisant l'ID de solution dans l'ARN de la ressource :

{
  "Statement": [
    {
      "Effect": "Allow",
      "Action": [
        "aws-marketplace:DescribeEntity",
        "aws-marketplace:StartChangeSet"
      ],
      "Resource": [
        "arn:aws:aws-marketplace:us-east-1:123456789012:AWSMarketplace/Solution/soln-specific123"
      ]
    }
  ]
}

Restreindre l'accès à des types de modifications spécifiques

Vous pouvez restreindre l'accès à des types de modifications spécifiques à l'aide de clés de condition :

{
  "Statement": [
    {
      "Effect": "Allow",
      "Action": [
        "aws-marketplace:StartChangeSet"
      ],
      "Resource": [
        "arn:aws:aws-marketplace:us-east-1:123456789012:AWSMarketplace/Solution/*"
      ],
      "Condition": {
        "StringEquals": {
          "catalog:ChangeType": [
            "UpdateInformation",
            "UpdateRelatedProducts"
          ]
        }
      }
    }
  ]
}