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.
# 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](https://docs.aws.amazon.com/marketplace/latest/userguide/create-public-profile.html). 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](https://docs.aws.amazon.com/partner-central/latest/APIReference/working-with-your-opportunities.html).
### 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](https://docs.aws.amazon.com/partner-central/latest/getting-started/account-linking.html)), 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](https://docs.aws.amazon.com/marketplace/latest/userguide/create-public-profile.html).
### 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 est`Solution@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](https://docs.aws.amazon.com/marketplace/latest/APIReference/API_Change.html) 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](https://docs.aws.amazon.com/marketplace/latest/userguide/create-public-profile.html).
+ 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](https://docs.aws.amazon.com/marketplace/latest/APIReference/catalog-api-access-control.html).
+ J'ai appris les bases de l'utilisation de l'API AWS Marketplace Catalog, voir [Utilisation de l'API AWS Marketplace Catalog](https://docs.aws.amazon.com/marketplace/latest/APIReference/catalog-apis.html).
## 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.](https://docs.aws.amazon.com/marketplace/latest/APIReference/catalog-apis.html#identifier)
**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](https://docs.aws.amazon.com/marketplace/latest/APIReference/catalog-api-access-control.html#managing-tags-on-resources) et [Ajout de balises à une entité et à un ensemble de modifications lors de la création](https://docs.aws.amazon.com/marketplace/latest/APIReference/catalog-api-access-control.html#example-adding-tags-entity-creation).
## 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 : `UpdateInformation``UpdateRelatedProducts`,, `UpdateBuyerEngagementOptions` (facultatif pour créer une `Limited` solution), et`ReleaseSolution`. 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 être`Solution@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'`DescribeChangeSet`API.
Lorsque la demande est traitée avec succès (si `Status` c'est le cas`SUCCEEDED`), un nouvel identifiant de solution est généré.
**Erreurs asynchrones**
`CreateSolution`les actions renvoient des erreurs spécifiques, en plus des erreurs [asynchrones courantes](#solution-error-codes). 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](https://docs.aws.amazon.com/marketplace/latest/APIReference/catalog-apis.html#working-with-change-sets).
| 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 le`DetailsDocument`, 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 le`DetailsDocument`, 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 être`Solution@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](https://docs.aws.amazon.com/marketplace/latest/userguide/product-submission.html#seller-and-product-logos).
+ `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](https://docs.aws.amazon.com/marketplace/latest/userguide/promotional-media.html).
+ `Type`(chaîne) (obligatoire) — L'un `Image` ou l'autre`Video`.
+ `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](https://d1z4dgsxp8pfa2.cloudfront.net/awsmp-solutions/use-case-categories-list.json) pour les valeurs acceptées actives et leurs [étiquettes d'introduction](https://d1z4dgsxp8pfa2.cloudfront.net/awsmp-solutions/i18n/en.json). 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](https://d1z4dgsxp8pfa2.cloudfront.net/awsmp-solutions/use-case-categories-list.json).
+ `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](https://d1z4dgsxp8pfa2.cloudfront.net/awsmp-solutions/use-case-categories-list.json).
+ `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](https://d1z4dgsxp8pfa2.cloudfront.net/awsmp-solutions/use-case-categories-list.json).
+ `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](https://docs.aws.amazon.com/AmazonS3/latest/userguide/ShareObjectPreSignedURL.html).
**Note**
Lorsque vous appelez UpdateInformation change type, vous pouvez toujours fournir un sous-ensemble de champs à mettre à jour dans l'`DetailsDocument`objet. Toutefois, avant de déplacer une solution de `Draft` vers`Limited`, les champs suivants doivent être correctement définis : `Title``ShortDescription`,`LongDescription`, et`LogoUrl`.
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'`DetailsDocument`objet 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'`ChangeSetId`ensemble `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'`DescribeChangeSet`API.
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](#solution-error-codes) 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](https://docs.aws.amazon.com/marketplace/latest/APIReference/catalog-apis.html#working-with-change-sets).
| 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` quels`UpdateRelatedProducts`.
**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 être`Solution@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'`ChangeSetId`ensemble `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'`DescribeChangeSet`API.
**Erreurs asynchrones**
Outre les erreurs [asynchrones courantes, les erreurs](#solution-error-codes) 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](https://docs.aws.amazon.com/marketplace/latest/APIReference/catalog-apis.html#working-with-change-sets).
| 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 être`Solution@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'`ChangeSetId`ensemble `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](#solution-error-codes) 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](https://docs.aws.amazon.com/marketplace/latest/APIReference/catalog-apis.html#working-with-change-sets).
| 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)](https://aws.amazon.com/partners/programs/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](https://docs.aws.amazon.com/partner-central/latest/getting-started/account-linking.html).
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 être`Solution@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'`ChangeSetId`ensemble `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'`DescribeChangeSet`API.
**Erreurs asynchrones**
Outre les erreurs [asynchrones courantes, les erreurs](#solution-error-codes) 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](https://docs.aws.amazon.com/marketplace/latest/APIReference/catalog-apis.html#working-with-change-sets).
| 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 `Limited``Public`, ou`Restricted`.
+ **`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](https://docs.aws.amazon.com/marketplace/latest/buyerguide/getting-support.html).
Lorsque vous définissez `TargetVisibility` ce paramètre sur`Public`, 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` ou`Limited`.
```
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 `TargetVisibility``Restricted`.
```
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 être`Solution@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'`ChangeSetId`ensemble `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` as`Public`, 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](https://docs.aws.amazon.com/marketplace/latest/APIReference/catalog-apis.html#working-with-change-sets).
| 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 utilisant`ReleaseSolution`.
+ `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 à nouveau`Draft`. `ReleaseSolution`vé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](https://docs.aws.amazon.com/marketplace/latest/APIReference/catalog-api-access-control.html) 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`, et`StartChangeSet`) 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"
]
}
}
}
]
}
```