La référence d'API AWS Marketplace a été restructurée. Pour plus d'informations sur les opérations d'API prises en charge, consultez le manuel AWS Marketplace API Reference.
Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.
Travaillez avec des ensembles d'offres
Les ensembles d'offres AWS Marketplace permettent aux vendeurs de regrouper plusieurs offres privées dans des packages négociables multiproduits unifiés destinés aux acheteurs. Cette fonctionnalité répond à la demande croissante des clients pour des solutions complètes de bout en bout dans des environnements d'entreprise complexes.
Traditionnellement, les acheteurs devaient découvrir et acheter des produits individuels auprès de plusieurs vendeurs, ce qui se traduisait par des expériences fragmentées, des problèmes d'intégration et des cycles d'approvisionnement plus longs. Les ensembles d'offres simplifient cela en permettant aux partenaires AWS Marketplace de combiner plusieurs offres, en rationalisant le processus de transaction grâce à des offres privées coordonnées permettant aux clients de consulter et d'accepter tous les composants avec une approbation unique.
Les ensembles d'offres fonctionnent conjointement avec des solutions pour fournir des offres multiproduits complètes. Les solutions fournissent un contenu marketing riche, notamment des descriptions détaillées, des diagrammes d'architecture et de la documentation sur les cas d'utilisation, tandis que les ensembles d'offres gèrent l'emballage négociable et les conditions commerciales pour un approvisionnement unifié.
Entité de l'ensemble d'offres
Un ensemble d'offres est un conteneur qui regroupe 2 à 7 offres privées dans un seul package négociable. Chaque offre d'un ensemble d'offres possède ses propres prix, conditions de paiement, durée et contrat de licence utilisateur final (EULA) distincts, tandis que l'ensemble d'offres fournit une expérience unifiée de découverte et d'acceptation aux acheteurs.
Caractéristiques principales :
Regroupe plusieurs offres privées (minimum 2, maximum 7)
Permet aux acheteurs d'accepter toutes les offres de manière unifiée en une seule action
Maintient la flexibilité avec des conditions distinctes pour chaque offre
Crée des accords distincts pour chaque produit, permettant une gestion indépendante après l'achat
Peut être éventuellement associé à une solution pour améliorer le contenu marketing
Le type d'entité de l'ensemble d'offres estOfferSet@1.0.
Identifiants d'entité
Les ensembles d'offres utilisent le format d'offerset-*identifiant (par exemple,offerset-abc123def456).
Format ARN de l'entité
Les ensembles d'offres suivent le format ARN AWS standard :
arn:aws:aws-marketplace:{region}:{account-id}:AWSMarketplace/OfferSet/{offerset-id}
Exemple :
arn:aws:aws-marketplace:us-east-1:123456789012:AWSMarketplace/OfferSet/offerset-abc123def456
Commencer à utiliser les ensembles d'offres
Cette section fournit des informations détaillées sur la création et la gestion d'ensembles d'offres à 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.
Liste des ensembles d'offres
Pour répertorier tous les ensembles d'offres de votre compte, appelez l'opération ListEntities API avec EntityType set toOfferSet.
Demande
POST /ListEntities HTTP/1.1 Content-type: application/json { "Catalog": "AWSMarketplace", "EntityType": "OfferSet" }
Réponse
{ "EntitySummaryList": [ { "EntityType": "OfferSet", "EntityId": "offerset-xyz123", "EntityArn": "arn:aws:aws-marketplace:us-east-1:123456789012:AWSMarketplace/OfferSet/offerset-xyz123", "LastModifiedDate": "2025-06-25T23:46:25Z", "OfferSetSummary": { "Name": "Enterprise Security Solution Offer Set", "State": "Released", "ReleaseDate": "2025-06-25T23:46:20Z", "SolutionId": "soln-abc987", "AssociatedOfferIds": [ "offer-abc123", "offer-def456", "offer-ghi789" ] } } ], "NextToken": null }
Filtrer les ensembles d'offres par État
Vous pouvez filtrer les ensembles d'offres par état à l'aide du EntityTypeFilters paramètre.
Demande
POST /ListEntities HTTP/1.1 Content-type: application/json { "Catalog": "AWSMarketplace", "EntityType": "OfferSet", "EntityTypeFilters": { "OfferSetFilters": { "State": { "ValueList": [ "Released" ] } } } }
Filtrer les ensembles d'offres par ID de solution
Vous pouvez filtrer les ensembles d'offres par ID de solution à l'aide du EntityTypeFilters paramètre.
Demande
POST /ListEntities HTTP/1.1 Content-type: application/json { "Catalog": "AWSMarketplace", "EntityType": "OfferSet", "EntityTypeFilters": { "OfferSetFilters": { "SolutionId": { "ValueList": [ "soln-abc987" ] } } } }
Filtrer les ensembles d'offres par date de sortie
Vous pouvez filtrer les ensembles d'offres par date de publication et trier les résultats à l'aide EntityTypeFilters des EntityTypeSort paramètres et.
Demande
POST /ListEntities HTTP/1.1 Content-type: application/json { "Catalog": "AWSMarketplace", "EntityType": "OfferSet", "EntityTypeFilters": { "OfferSetFilters": { "ReleaseDate": { "AfterValue": "2025-11-01" } } }, "EntityTypeSort": { "OfferSetSort": { "SortBy": "ReleaseDate", "SortOrder": "DESCENDING" } } }
Décrire un ensemble d'offres
Pour obtenir des informations détaillées sur un ensemble d'offres spécifique, appelez l'opération DescribeEntity API.
Demande
GET /DescribeEntity?catalog=AWSMarketplace&entityId=offerset-xyz123 HTTP/1.1
Réponse
{ "EntityType": "OfferSet@1.0", "EntityId": "offerset-xyz123", "EntityArn": "arn:aws:aws-marketplace:us-east-1:123456789012:AWSMarketplace/OfferSet/offerset-xyz123", "LastModifiedDate": "2025-06-25T23:46:25Z", "DetailsDocument": { "Id": "offerset-xyz123", "Name": "Enterprise Security Solution Offer Set", "BuyerNotes": "Complete security solution including endpoint protection and network monitoring", "State": "Released", "SolutionId": "soln-abc987", "ReleaseDate": "2025-06-25T23:46:20Z", "AssociatedOffers": [ { "OfferId": "offer-abc123" }, { "OfferId": "offer-def456" }, { "OfferId": "offer-ghi789" } ] } }
Création d'un ensemble d'offres
Utilisez le type de CreateOfferSet modification pour créer une nouvelle entité d'ensemble d'offres à l'état Brouillon. Il s'agit de la première étape du cycle de vie de l'ensemble d'offres, qui consiste à établir l'entité de base qui sera ensuite configurée avec les associations d'offres et les métadonnées avant d'être mise à la disposition des acheteurs.
Syntaxe de la demande
POST /StartChangeSet HTTP/1.1 Content-type: application/json { "Catalog": "AWSMarketplace", "ChangeSet": [ { "ChangeType": "CreateOfferSet", "Entity": { "Type": "OfferSet@1.0" }, "ChangeName": "CreateOfferSetChange", "DetailsDocument": { "Name": "Enterprise Security Solution Offer Set" } } ] }
Fournissez des informations pour les champs permettant d'ajouter le type de CreateOfferSet modification :
Entity(object) (obligatoire) — Type d'entité en cours de création.Type(string) (obligatoire) — Doit êtreOfferSet@1.0.
DetailsDocument(objet) (obligatoire) — Les détails de la demande.Name(chaîne) (obligatoire) — Le nom associé à l'ensemble d'offres pour une meilleure lisibilité pour vous et vos clients. Longueur minimale : 1 caractère Longueur maximale : 150 caractères.
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. Cela inclut la validation des informations pour s'assurer qu'elles sont conformes aux directives d'AWS Marketplace. Le processus de validation peut prendre quelques minutes.
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.
Une fois le traitement réussi, AWS Marketplace génère une offre définie à l'état Brouillon avec un identifiant unique préfixé parofferset-.
Mettre à jour les informations du set d'offres
Utilisez le type de UpdateInformation modification pour modifier les détails d'un ensemble d'offres existant, notamment son nom et les remarques de l'acheteur.
Syntaxe de la demande
POST /StartChangeSet HTTP/1.1 Content-type: application/json { "Catalog": "AWSMarketplace", "ChangeSet": [ { "ChangeType": "UpdateInformation", "Entity": { "Type": "OfferSet@1.0", "Identifier": "offerset-abc123" }, "DetailsDocument": { "Name": "Updated Enterprise Security Offer Set", "BuyerNotes": "Complete security solution including endpoint protection, network monitoring, and professional services implementation" } } ] }
Fournissez des informations pour les champs permettant d'ajouter le type de UpdateInformation modification :
Entity(object) (obligatoire) — Entité en cours de mise à jour.Identifier(string) (obligatoire) — L'identifiant de votre ensemble d'offres. Pour de plus amples informations, veuillez consulter Identifiant.Type(string) (obligatoire) — Doit êtreOfferSet@1.0.
DetailsDocument(objet) (obligatoire) — Au moins un champ doit être fourni.Name(chaîne) (facultatif) — Afficher le nom visible pour les acheteurs. Longueur minimale : 1 caractère Longueur maximale : 150 caractèresBuyerNotes(chaîne) (facultatif) — Informations détaillées sur l'ensemble d'offres qui aident les acheteurs à comprendre son objectif et son contenu. Longueur minimale : 1 caractère Longueur maximale : 1 000 caractères.
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. Cela inclut la validation des informations pour s'assurer qu'elles sont conformes aux directives d'AWS Marketplace. Le processus de validation peut prendre quelques minutes.
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.
Associer des offres à un ensemble d'offres
Utilisez le type de AssociateOffers modification pour associer plusieurs AWS Marketplace offres à un ensemble d'offres. Cela crée la relation entre les offres et l'ensemble d'offres, les offres faisant partie de la configuration négociable de l'ensemble d'offres.
L'opération est idempotente et permet d'associer des offres quel que soit leur état actuel, ce qui permet une configuration complète avant la publication des offres individuelles. Chaque offre ne peut appartenir qu'à un seul ensemble d'offres.
Important
Les OfferSetId offres individuelles sont immuables et ne peuvent être définies que lors de la création de l'offre. Avant d'associer des offres à un ensemble d'offres en utilisantAssociateOffers, vous devez d'abord créer les offres individuelles et les spécifier OfferSetId lors de la création de l'offre. Si vous devez inclure une offre existante dont la valeur n'est pas correcteOfferSetId, vous devez créer une nouvelle offre avec la bonne OfferSetId spécification.
Pour plus d'informations sur les autorisations IAM requises, consultezAutorisations IAM pour les ensembles d'offres.
Syntaxe de la demande
POST /StartChangeSet HTTP/1.1 Content-type: application/json { "Catalog": "AWSMarketplace", "ChangeSet": [ { "ChangeType": "AssociateOffers", "Entity": { "Type": "OfferSet@1.0", "Identifier": "offerset-abc123" }, "DetailsDocument": { "Offers": [ { "OfferId": "offer-xyz789" }, { "OfferId": "offer-def456" }, { "OfferId": "offer-ghi123" } ] } } ] }
Fournissez des informations pour les champs permettant d'ajouter le type de AssociateOffers modification :
Entity(object) (obligatoire) — Entité en cours de mise à jour.Identifier(string) (obligatoire) — L'identifiant de votre ensemble d'offres. Pour de plus amples informations, veuillez consulter Identifiant.Type(string) (obligatoire) — Doit êtreOfferSet@1.0.
DetailsDocument(objet) (obligatoire) — Les détails de la demande.Offers(array) (obligatoire) — Liste des AWS Marketplace offres à associer. Minimum : 1 article Maximum : 7 articles.OfferId(string) (obligatoire) — Identifiant de l' AWS Marketplace offre. Longueur minimale : 1 caractère Longueur maximale : 36 caractères.
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. Cela inclut la validation des informations pour s'assurer qu'elles sont conformes aux directives d'AWS Marketplace. Le processus de validation peut prendre quelques minutes.
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
Les erreurs suivantes sont spécifiques aux AssociateOffers 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, consultezTravailler avec des ensembles de modifications.
| Code d’erreur | Message d’erreur |
|---|---|
TROP D'OFFRES |
Associez jusqu'à 7 offres à l'ensemble d'offres. |
OFFRE_SET_REFERENCE INCOMPATIBLE |
Assurez-vous que toutes les offres ont été créées spécifiquement pour cet ensemble d'offres. |
DEMANDE_MISE À JOUR NON VALIDE |
La modification demandée ne peut pas être effectuée après la publication de l'ensemble d'offres. |
Dissocier les offres d'un ensemble d'offres
Utilisez le type de DisassociateOffers modification pour supprimer plusieurs AWS Marketplace offres d'un ensemble d'offres. Cette opération idempotente supprime la relation d'association tout en préservant l'attribut de l'offre. OfferSetId Les offres dissociées sont masquées aux acheteurs jusqu'à ce qu'elles soient associées à nouveau au même ensemble d'offres. Ils ne peuvent pas être associés à un ensemble d'offres différent.
Syntaxe de la demande
POST /StartChangeSet HTTP/1.1 Content-type: application/json { "Catalog": "AWSMarketplace", "ChangeSet": [ { "ChangeType": "DisassociateOffers", "Entity": { "Type": "OfferSet@1.0", "Identifier": "offerset-abc123" }, "DetailsDocument": { "Offers": [ { "OfferId": "offer-xyz789" } ] } } ] }
Fournissez des informations pour les champs permettant d'ajouter le type de DisassociateOffers modification :
Entity(object) (obligatoire) — Entité en cours de mise à jour.Identifier(string) (obligatoire) — L'identifiant de votre ensemble d'offres. Pour de plus amples informations, veuillez consulter Identifiant.Type(string) (obligatoire) — Doit êtreOfferSet@1.0.
DetailsDocument(objet) (obligatoire) — Les détails de la demande.Offers(array) (obligatoire) — Liste des offres à dissocier. Minimum : 1 article Maximum : 7 articles.OfferId(string) (obligatoire) — L'identifiant de l'offre AWS Marketplace. Longueur minimale : 1 caractère Longueur maximale : 36 caractères.
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. Cela inclut la validation des informations pour s'assurer qu'elles sont conformes aux directives d'AWS Marketplace. Le processus de validation peut prendre quelques minutes.
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
Les erreurs suivantes sont spécifiques aux DisassociateOffers 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, consultezTravailler avec des ensembles de modifications.
| Code d’erreur | Message d’erreur |
|---|---|
DEMANDE_MISE À JOUR NON VALIDE |
La modification demandée ne peut pas être effectuée après la publication de l'ensemble d'offres. |
Associer une solution à un ensemble d'offres
Utilisez le type de AssociateSolution modification pour associer une seule solution AWS Marketplace à un ensemble d'offres. Cela crée une relation qui permet aux acheteurs de découvrir le lien entre l'ensemble d'offres et la solution et d'accéder au riche contenu marketing de la solution, tel que des descriptions détaillées, des diagrammes d'architecture et de la documentation sur les cas d'utilisation.
Note
Il s'agit d'une association faiblement couplée. AWS Marketplace n'assure pas la cohérence entre la solution et l'ensemble d'offres. Les solutions ne peuvent contenir aucun produit AWS Marketplace, des produits différents de ceux inclus dans l'offre ou des produits qui se chevauchent. Vous disposez d'une flexibilité totale pour associer n'importe quelle solution que vous possédez à des fins de marketing et de découverte.
Pour plus d'informations sur les autorisations IAM requises, consultezAutorisations IAM pour les ensembles d'offres.
Syntaxe de la demande
POST /StartChangeSet HTTP/1.1 Content-type: application/json { "Catalog": "AWSMarketplace", "ChangeSet": [ { "ChangeType": "AssociateSolution", "Entity": { "Type": "OfferSet@1.0", "Identifier": "offerset-abc123" }, "DetailsDocument": { "SolutionId": "soln-xyz789" } } ] }
Fournissez des informations pour les champs permettant d'ajouter le type de AssociateSolution modification :
Entity(object) (obligatoire) — Entité en cours de mise à jour.Identifier(string) (obligatoire) — L'identifiant de votre ensemble d'offres. Pour de plus amples informations, veuillez consulter Identifiant.Type(string) (obligatoire) — Doit êtreOfferSet@1.0.
DetailsDocument(objet) (obligatoire) — Les détails de la demande.SolutionId(string) (obligatoire) — Identifiant de la solution AWS Marketplace à associer. Longueur minimale : 1 caractère Longueur maximale : 50 caractères Doit correspondre au modèle^soln-[A-Za-z0-9]+$.
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. Cela inclut la validation des informations pour s'assurer qu'elles sont conformes aux directives d'AWS Marketplace. Le processus de validation peut prendre quelques minutes.
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
Les erreurs suivantes sont spécifiques aux AssociateSolution 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, consultezTravailler avec des ensembles de modifications.
| Code d’erreur | Message d’erreur |
|---|---|
ASSOCIATION_SOLUTION_INCOMPATIBLE |
Dissociez la solution existante avant d'en associer une nouvelle. |
DEMANDE_MISE À JOUR NON VALIDE |
La modification demandée ne peut pas être effectuée après la publication de l'ensemble d'offres. |
Dissocier une solution d'un ensemble d'offres
Utilisez le type de DisassociateSolution modification pour supprimer l'association entre une solution et un ensemble d'offres. Cela supprime le contenu marketing de la solution de l'ensemble d'offres tout en conservant les fonctionnalités transactionnelles de l'ensemble d'offres.
Syntaxe de la demande
POST /StartChangeSet HTTP/1.1 Content-type: application/json { "Catalog": "AWSMarketplace", "ChangeSet": [ { "ChangeType": "DisassociateSolution", "Entity": { "Type": "OfferSet@1.0", "Identifier": "offerset-abc123" }, "DetailsDocument": { "SolutionId": "soln-xyz789" } } ] }
Fournissez des informations pour les champs permettant d'ajouter le type de DisassociateSolution modification :
Entity(object) (obligatoire) — Entité en cours de mise à jour.Identifier(string) (obligatoire) — L'identifiant de votre ensemble d'offres. Pour de plus amples informations, veuillez consulter Identifiant.Type(string) (obligatoire) — Doit êtreOfferSet@1.0.
DetailsDocument(objet) (obligatoire) — Les détails de la demande.SolutionId(string) (obligatoire) — Identifiant de la solution à dissocier. Longueur minimale : 1 caractère Longueur maximale : 50 caractères
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. Cela inclut la validation des informations pour s'assurer qu'elles sont conformes aux directives d'AWS Marketplace. Le processus de validation peut prendre quelques minutes.
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
Les erreurs suivantes sont spécifiques aux DisassociateSolution 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, consultezTravailler avec des ensembles de modifications.
| Code d’erreur | Message d’erreur |
|---|---|
DEMANDE_MISE À JOUR NON VALIDE |
La modification demandée ne peut pas être effectuée après la publication de l'ensemble d'offres. |
Publier un ensemble d'offres
Utilisez le type de ReleaseOfferSet modification pour mettre un ensemble d'offres à la disposition des acheteurs. Une fois publié, l'ensemble d'offres passe de l'état brouillon à l'état publié, devient détectable et les offres associées ne peuvent être trouvées que dans le cadre du package unifié. AWS Marketplace
Les ensembles d'offres publiés génèrent des notifications à deux niveaux : les offres individuelles et l'ensemble d'offres lui-même. Toutes les notifications d'offres individuelles incluent OfferSetId les canaux de notification existants (notifications par e-mail et EventBridge événements Amazon). Des notifications au niveau de l'ensemble d'offres sont envoyées pour des événements clés tels que la publication de l'ensemble d'offres.
Syntaxe de la demande
POST /StartChangeSet HTTP/1.1 Content-type: application/json { "Catalog": "AWSMarketplace", "ChangeSet": [ { "ChangeType": "ReleaseOfferSet", "Entity": { "Type": "OfferSet@1.0", "Identifier": "offerset-abc123" }, "DetailsDocument": {} } ] }
Fournissez des informations pour les champs permettant d'ajouter le type de ReleaseOfferSet modification :
Entity(object) (obligatoire) — Entité en cours de mise à jour.Identifier(string) (obligatoire) — L'identifiant de votre ensemble d'offres. Pour de plus amples informations, veuillez consulter Identifiant.Type(string) (obligatoire) — Doit êtreOfferSet@1.0.
DetailsDocument(object) (obligatoire) — Objet vide pour cette opération.
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. Cela inclut la validation des informations pour s'assurer qu'elles sont conformes aux directives d'AWS Marketplace. Le processus de validation peut prendre quelques minutes.
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
Les erreurs suivantes sont spécifiques aux ReleaseOfferSet 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, consultezTravailler avec des ensembles de modifications.
| Code d’erreur | Message d’erreur |
|---|---|
NOTES_ACHETEUR_MANQUANTES |
Fournissez BuyerNotes avant de publier le coffret d'offres. |
OFFRES_MANQUANTES |
Associez au moins deux offres à l'ensemble d'offres avant de le publier. |
TROP D'OFFRES PAR PRODUIT |
Associez une seule offre par produit à l'ensemble d'offres. |
CODE_DE_CURRENCE_D'OFFRE INCOHÉRENT |
Assurez-vous que toutes les offres associées correspondent CurrencyCode. |
DATE DE FIN DE DISPONIBILITÉ DE L'OFFRE INCOHÉRENTE |
Assurez-vous que toutes les offres associées correspondent AvailabilityEndDate. |
RÈGLE DE CIBLAGE DE L'OFFRE_INCOHÉRENTE |
Assurez-vous que toutes les offres associées correspondent TargetingRule. |
RÈGLE DE CIBLAGE DE L'OFFRE_D'OFFRE INCOMPATIBLE |
Seules les offres ciblées sur les acheteurs peuvent être associées à un ensemble d'offres. |
OFFRES_EXPIRÉES |
Dissociez les offres expirées de l'ensemble d'offres ou prolongez leur. AvailabilityEndDates |
OFFRES_BROUILLONS |
Publiez toutes les offres associées avant de publier l'ensemble d'offres. |
ÉTAT_DE LA SOLUTION INCOMPATIBLE |
Fournir une solution dans un État limité ou public. |
DEMANDE_MISE À JOUR NON VALIDE |
La modification demandée ne peut pas être effectuée après la publication de l'ensemble d'offres. |
Cycle de vie défini de l'offre
Le cycle de vie de l'ensemble d'offres comprend les étapes suivantes :
Phase de création
Créez l'entité d'ensemble d'offres à l'état Brouillon en utilisant le type de CreateOfferSet modification. L'ensemble d'offres reçoit un identifiant unique et commence à l'état Brouillon.
Phase de configuration
Au cours de la configuration, vous pouvez :
Ajouter ou mettre à jour des métadonnées à l'aide de
UpdateInformation(nom, notes de l'acheteur)Créez des offres privées individuelles, en les spécifiant
OfferSetIdlors de la création de l'offreAssociez les offres à l'ensemble d'offres à l'aide de
AssociateOffersAssociez éventuellement une solution
AssociateSolutionpour améliorer le contenu marketing
Important
Les OfferSetId offres individuelles sont immuables et ne peuvent être définies que lors de la création de l'offre. Avant d'associer des offres à un ensemble d'offres en utilisantAssociateOffers, vous devez d'abord créer les offres individuelles et les spécifier OfferSetId lors de la création de l'offre. Si vous devez inclure une offre existante dont la valeur n'est pas correcteOfferSetId, vous devez créer une nouvelle offre avec la bonne OfferSetId spécification.
Phase de validation
Avant de publier un ensemble d'offres, assurez-vous que :
Le set d'offres contient entre 2 et 7 offres
Toutes les offres associées doivent être :
En état de publication
Actif
Utiliser la même devise
Cibler le ou les mêmes identifiants de compte AWS du même acheteur
Avoir des dates d'expiration identiques
Phase de sortie
Lorsque vous êtes prêt, utilisez le type de ReleaseOfferSet modification pour faire passer l'ensemble d'offres de l'état brouillon à l'état publié. Cela permet aux acheteurs de découvrir l'ensemble d'offres par le biais AWS Marketplace de celui-ci.
Post-release gestion
Gestion des délais d'expiration :
L'expiration effective d'un ensemble d'offres est calculée comme étant la date d'expiration la plus proche parmi toutes les offres associées
Vous pouvez modifier les dates d'expiration des offres individuelles à l'aide des fonctionnalités de gestion des offres existantes (type de
UpdateAvailabilitymodification)
Modifications de l'ensemble d'offres :
Lorsque les acheteurs demandent des modifications à un ensemble d'offres publié, utilisez le flux de travail de création :
Création d'une nouvelle entité d'ensemble d'offres
Pour les offres qui ne nécessitent pas de modifications, clonez les offres existantes via le portail AWS Marketplace de gestion
Pour les offres nécessitant des modifications, créez de nouvelles offres avec les modifications demandées, en spécifiant les nouvelles
OfferSetIdAssociez toutes les offres (clonées et nouvelles) au nouvel ensemble d'offres en utilisant
AssociateOffersPubliez le nouvel ensemble d'offres en utilisant
ReleaseOfferSetFaites expirer l'offre initiale définie en définissant la date de fin de disponibilité des offres associées
Autorisations IAM pour les ensembles d'offres
Pour utiliser des ensembles d'offres à l'aide de l'API AWS Marketplace Catalog, vous avez besoin d'autorisations IAM spécifiques. Cette section décrit les autorisations requises pour les opérations relatives aux ensembles d'offres et les exigences d'autorisation entre entités.
Actions IAM requises
Les actions IAM suivantes sont requises pour les opérations d'ensemble d'offres :
aws-marketplace:StartChangeSet— Obligatoire pour tous les types de modification d'ensembles d'offres, y compris les opérations de création, de mise à jour, d'association et de publicationaws-marketplace:DescribeChangeSet— Nécessaire pour vérifier l'état et les résultats des exécutions des ensembles de modificationsaws-marketplace:ListEntities— Obligatoire pour répertorier les ensembles d'offres dans votre compteaws-marketplace:DescribeEntity— Nécessaire pour récupérer des informations détaillées sur un ensemble d'offres
Autorisations d’accès aux ressources
Utilisez les modèles d'ARN suivants pour accorder des autorisations sur des ressources spécifiques :
Coffrets d'offres —
arn:aws:aws-marketplace:us-east-1:123456789012:AWSMarketplace/OfferSet/*Offres individuelles —
arn:aws:aws-marketplace:us-east-1:123456789012:AWSMarketplace/Offer/*Des solutions —
arn:aws:aws-marketplace:us-east-1:123456789012:AWSMarketplace/Solution/*
Pour des autorisations plus restrictives, remplacez le caractère générique (*) par des identifiants d'entité spécifiques.
Cross-entity autorisation
Certaines opérations relatives à un ensemble d'offres nécessitent des autorisations à la fois sur l'ensemble d'offres et sur les entités associées :
AssociateOffers
aws-marketplace:StartChangeSetautorisation sur l'entité de l'ensemble d'offresaws-marketplace:StartChangeSetautorisation avec type deAssociateWithOfferSetmodification sur chaque entité d'offre individuelle associée
AssociateSolution
aws-marketplace:StartChangeSetautorisation sur l'entité de l'ensemble d'offresaws-marketplace:StartChangeSetautorisation avec type deAssociateWithOfferSetmodification sur l'entité de solution associée
Note
Le fait de disposer uniquement d'une autorisation DescribeEntity (en lecture seule) sur les offres ou les solutions n'est pas suffisant pour les opérations d'association. Vous devez être StartChangeSet autorisé à AssociateWithOfferSet modifier le type de modification sur les entités associées à l'ensemble d'offres.
Exemple de politiques IAM
Gestion de base des ensembles d'offres
Cette politique fournit des autorisations pour les opérations de base relatives aux ensembles d'offres sans associations entre entités :
{ "Version": "2012-10-17", "Statement": [ { "Effect": "Allow", "Action": [ "aws-marketplace:StartChangeSet", "aws-marketplace:DescribeChangeSet", "aws-marketplace:ListEntities", "aws-marketplace:DescribeEntity" ], "Resource": [ "arn:aws:aws-marketplace:us-east-1:123456789012:AWSMarketplace/OfferSet/*" ] } ] }
Cross-entity autorisations pour AssociateOffers
Cette politique décrit les autorisations et conditions spécifiques requises pour AssociateOffers :
{ "Version": "2012-10-17", "Statement": [ { "Effect": "Allow", "Action": "aws-marketplace:StartChangeSet", "Resource": "arn:aws:aws-marketplace:us-east-1:123456789012:AWSMarketplace/OfferSet/*", "Condition": { "StringEquals": { "catalog:ChangeType": ["AssociateOffers"] } } }, { "Effect": "Allow", "Action": "aws-marketplace:DescribeEntity", "Resource": "arn:aws:aws-marketplace:us-east-1:123456789012:AWSMarketplace/Offer/*" }, { "Effect": "Allow", "Action": "aws-marketplace:StartChangeSet", "Resource": "arn:aws:aws-marketplace:us-east-1:123456789012:AWSMarketplace/Offer/*", "Condition": { "StringEquals": { "catalog:ChangeType": ["AssociateWithOfferSet"] } } } ] }
Pour des autorisations plus restrictives, remplacez le caractère générique (*) par des identifiants d'entité spécifiques.
Cross-entity autorisations pour AssociateSolution
Cette politique décrit les autorisations et conditions spécifiques requises pour AssociateSolution :
{ "Version": "2012-10-17", "Statement": [ { "Effect": "Allow", "Action": "aws-marketplace:StartChangeSet", "Resource": "arn:aws:aws-marketplace:us-east-1:123456789012:AWSMarketplace/OfferSet/*", "Condition": { "StringEquals": { "catalog:ChangeType": ["AssociateSolution"] } } }, { "Effect": "Allow", "Action": "aws-marketplace:DescribeEntity", "Resource": "arn:aws:aws-marketplace:us-east-1:123456789012:AWSMarketplace/Solution/*" }, { "Effect": "Allow", "Action": "aws-marketplace:StartChangeSet", "Resource": "arn:aws:aws-marketplace:us-east-1:123456789012:AWSMarketplace/Solution/*", "Condition": { "StringEquals": { "catalog:ChangeType": ["AssociateWithOfferSet"] } } } ] }
Pour des autorisations plus restrictives, remplacez le caractère générique (*) par des identifiants d'entité spécifiques.