Die AWS Marketplace API-Referenz wurde neu strukturiert. Weitere Informationen zu den unterstützten API-Vorgängen finden Sie in der AWS Marketplace API-Referenz.
Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.
Mit Angebotssets arbeiten
Mit den Angebotspaketen von AWS Marketplace können Verkäufer mehrere private Angebote in einheitlichen, transaktionsfähigen Paketen für Käufer zusammenfassen. Diese Funktion entspricht der wachsenden Kundennachfrage nach umfassenden Komplettlösungen in komplexen Unternehmensumgebungen.
Traditionell mussten Käufer einzelne Produkte von mehreren Anbietern finden und erwerben, was zu fragmentierten Erfahrungen, Integrationsproblemen und längeren Beschaffungszyklen führte. Angebotspakete vereinfachen dies, indem sie es AWS Marketplace Marketplace-Partnern ermöglichen, mehrere Angebote miteinander zu kombinieren und so den Transaktionsprozess durch koordinierte private Angebote zu optimieren, bei denen Kunden alle Komponenten mit einmaliger Genehmigung überprüfen und akzeptieren können.
Angebotspakete arbeiten mit Lösungen zusammen, um umfassende Angebote für mehrere Produkte bereitzustellen. Die Lösungen bieten umfangreiche Marketinginhalte, darunter detaillierte Beschreibungen, Architekturdiagramme und Dokumentation zu Anwendungsfällen, während die Angebotspakete die abwicklbaren Verpackungs- und Handelsbedingungen für eine einheitliche Beschaffung regeln.
Gesamtheit des Angebotssatzes
Ein Angebotssatz ist ein Container, der 2-7 private Angebote zu einem einzigen transaktionsfähigen Paket zusammenfasst. Jedes Angebot innerhalb eines Angebotspakets behält seine eigenen Preise, Zahlungsbedingungen, Laufzeit und Endbenutzer-Lizenzvereinbarung (EULA) bei, während das Angebotspaket Käufern ein einheitliches Auffinden und Akzeptieren bietet.
Wichtigste Merkmale:
Gruppiert mehrere private Angebote (mindestens 2, maximal 7)
Ermöglicht die einheitliche Annahme aller Angebote durch Käufer mit einer einzigen Aktion
Sorgt für Flexibilität mit unterschiedlichen Konditionen für jedes Angebot
Erstellt separate Vereinbarungen für jedes Produkt und ermöglicht so eine unabhängige Verwaltung nach dem Kauf
Kann optional mit einer Lösung für erweiterte Marketinginhalte verknüpft werden
Der Entitätstyp des Angebotssets istOfferSet@1.0.
Entitätskennungen
Angebotssets verwenden das offerset-* Identifikationsformat (z. B.offerset-abc123def456).
ARN-Format der Entität
Angebotssets folgen dem AWS-ARN-Standardformat:
arn:aws:aws-marketplace:{region}:{account-id}:AWSMarketplace/OfferSet/{offerset-id}
Beispiel:
arn:aws:aws-marketplace:us-east-1:123456789012:AWSMarketplace/OfferSet/offerset-abc123def456
Erste Schritte mit Angebotspaketen
Dieser Abschnitt enthält detaillierte Informationen zum Erstellen und Verwalten von Angebotssets mithilfe von Änderungstypen für die AWS Marketplace Katalog-API.
Bevor Sie beginnen, stellen Sie sicher, dass Sie über Folgendes verfügen:
Gültige AWS Marketplace Marketplace-Verkäuferregistrierung und ein öffentliches Profil. Weitere Informationen finden Sie unter Registrieren und Ihr Verkäuferprofil erstellen.
Zugriff auf die API und Erfüllung der Voraussetzungen für Verkäufer. Weitere Informationen finden Sie unter Zugriffskontrolle für die AWS Marketplace Catalog API.
Sie haben sich mit den Grundlagen der Verwendung der AWS Marketplace Catalog API vertraut gemacht, siehe Verwenden der AWS Marketplace Catalog API.
Angebotssets auflisten
Um alle Angebotsgruppen in Ihrem Konto aufzulisten, rufen Sie den ListEntities API-Vorgang mit EntityType set to auf auf auf aufOfferSet.
Anforderung
POST /ListEntities HTTP/1.1 Content-type: application/json { "Catalog": "AWSMarketplace", "EntityType": "OfferSet" }
Antwort
{ "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 }
Filtern Sie Angebotssätze nach Bundesland
Mithilfe des EntityTypeFilters Parameters können Sie Angebotssets nach Bundesland filtern.
Anforderung
POST /ListEntities HTTP/1.1 Content-type: application/json { "Catalog": "AWSMarketplace", "EntityType": "OfferSet", "EntityTypeFilters": { "OfferSetFilters": { "State": { "ValueList": [ "Released" ] } } } }
Filtern Sie Angebotssets nach Lösungs-ID
Mithilfe des EntityTypeFilters Parameters können Sie Angebotssets nach Lösungs-ID filtern.
Anforderung
POST /ListEntities HTTP/1.1 Content-type: application/json { "Catalog": "AWSMarketplace", "EntityType": "OfferSet", "EntityTypeFilters": { "OfferSetFilters": { "SolutionId": { "ValueList": [ "soln-abc987" ] } } } }
Filtern Sie Angebotssätze nach Veröffentlichungsdatum
Sie können Angebotssets nach dem Veröffentlichungsdatum filtern und die Ergebnisse mithilfe der EntityTypeSort Parameter EntityTypeFilters und sortieren.
Anforderung
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" } } }
Beschreiben Sie ein Angebotssatz
Rufen Sie den DescribeEntity API-Vorgang auf, um detaillierte Informationen zu einem bestimmten Angebotssatz zu erhalten.
Anforderung
GET /DescribeEntity?catalog=AWSMarketplace&entityId=offerset-xyz123 HTTP/1.1
Antwort
{ "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" } ] } }
Erstellen Sie ein Angebotsset
Verwenden Sie den CreateOfferSet Änderungstyp, um eine neue Angebotsset-Entität im Status Entwurf zu erstellen. Dies ist der erste Schritt im Lebenszyklus des Angebotssets, bei dem die grundlegende Einheit eingerichtet wird, die später mit Angebotszuordnungen und Metadaten konfiguriert wird, bevor sie für Käufer freigegeben wird.
Anforderungssyntax
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" } } ] }
Geben Sie Informationen für die Felder ein, um den CreateOfferSet Änderungstyp hinzuzufügen:
Entity(Objekt) (erforderlich) — Der Entitätstyp, der erstellt wird.Type(string) (erforderlich) — Muss seinOfferSet@1.0.
DetailsDocument(object) (erforderlich) — Die Details der Anfrage.Name(string) (erforderlich) — Der Name, der dem Angebotssatz zugeordnet ist, damit er für Sie und Ihre Kunden besser lesbar ist. Mindestlänge: 1 Zeichen. Maximale Länge: 150 Zeichen.
Syntax der Antwort
Für Ihre Anfrage wird ein Änderungssatz erstellt. Die Antwort auf diese Anfrage gibt Ihnen das ChangeSetId und ChangeSetArn für den Änderungssatz und sieht wie folgt aus.
{ "ChangeSetId": "example123456789012abcdef", "ChangeSetArn": "arn:aws:aws-marketplace:us-east-1:123456789012:AWSMarketplace/ChangeSet/example123456789012abcdef" }
Die Änderungsanforderung wird einer Warteschlange hinzugefügt und verarbeitet. Dazu gehört auch die Überprüfung von Informationen, um sicherzustellen, dass sie den AWS Marketplace Marketplace-Richtlinien entsprechen. Der Validierungsprozess kann einige Minuten dauern.
Sie können den Status der Anfrage über das AWS Marketplace Management Portal oder direkt über die Catalog API mithilfe des DescribeChangeSet API-Vorgangs überprüfen.
AWS Marketplace Generiert nach erfolgreicher Bearbeitung ein Angebot, das sich im Status Entwurf befindet und dem eine eindeutige Kennung als Präfix vorangestellt ist. offerset-
Aktualisieren Sie die Informationen zum Angebotssatz
Verwenden Sie den UpdateInformation Änderungstyp, um die Details eines vorhandenen Angebotssets zu ändern, einschließlich des Namens und der Hinweise für Käufer.
Anforderungssyntax
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" } } ] }
Geben Sie Informationen für die Felder an, um den UpdateInformation Änderungstyp hinzuzufügen:
Entity(Objekt) (erforderlich) — Die Entität, die aktualisiert wird.Identifier(string) (erforderlich) — Ihre Angebotsset-ID. Weitere Informationen finden Sie unter Kennung.Type(string) (erforderlich) — Muss seinOfferSet@1.0.
DetailsDocument(object) (erforderlich) — Es muss mindestens ein Feld angegeben werden.Name(string) (optional) — Für Käufer sichtbarer Anzeigename. Mindestlänge: 1 Zeichen. Maximale Länge: 150 Zeichen.BuyerNotes(string) (optional) — Detaillierte Informationen zum Angebotspaket, die Käufern helfen, dessen Zweck und Inhalt zu verstehen. Mindestlänge: 1 Zeichen. Maximale Länge: 1.000 Zeichen.
Syntax der Antwort
Für Ihre Anfrage wird ein Änderungssatz erstellt. Die Antwort auf diese Anfrage gibt Ihnen das ChangeSetId und ChangeSetArn für den Änderungssatz und sieht wie folgt aus.
{ "ChangeSetId": "example123456789012abcdef", "ChangeSetArn": "arn:aws:aws-marketplace:us-east-1:123456789012:AWSMarketplace/ChangeSet/example123456789012abcdef" }
Die Änderungsanforderung wird einer Warteschlange hinzugefügt und verarbeitet. Dazu gehört auch die Überprüfung von Informationen, um sicherzustellen, dass sie den AWS Marketplace Marketplace-Richtlinien entsprechen. Der Validierungsprozess kann einige Minuten dauern.
Sie können den Status der Anfrage über das AWS Marketplace Management Portal oder direkt über die Catalog API mithilfe des DescribeChangeSet API-Vorgangs überprüfen.
Ordnen Sie Angebote einem Angebotssatz zu
Verwenden Sie den AssociateOffers Änderungstyp, um mehrere AWS Marketplace Angebote einem Angebotssatz zuzuordnen. Dadurch wird die Beziehung zwischen Angeboten und dem Angebotsset hergestellt, sodass die Angebote Teil der transaktionsfähigen Konfiguration des Angebotssets werden.
Die Operation ist idempotent und ermöglicht das Zuordnen von Angeboten unabhängig von ihrem aktuellen Status, wodurch eine vollständige Konfiguration ermöglicht wird, bevor einzelne Angebote veröffentlicht werden. Jedes Angebot kann nur zu einem Angebotssatz gehören.
Wichtig
Die Angabe OfferSetId einzelner Angebote ist unveränderlich und kann nur bei der Angebotserstellung festgelegt werden. Bevor Sie Angebote einem Angebotsset zuordnenAssociateOffers, müssen Sie zunächst die einzelnen Angebote erstellen und diese OfferSetId bei der Angebotserstellung angeben. Wenn Sie ein vorhandenes Angebot hinzufügen möchten, für das nicht das richtige Angebot angegeben istOfferSetId, müssen Sie ein neues Angebot erstellen, bei dem das richtige Angebot OfferSetId angegeben ist.
Informationen zu den erforderlichen IAM-Berechtigungen finden Sie unterIAM-Berechtigungen für Angebotssets.
Anforderungssyntax
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" } ] } } ] }
Geben Sie Informationen zu den Feldern an, um den AssociateOffers Änderungstyp hinzuzufügen:
Entity(Objekt) (erforderlich) — Die Entität, die aktualisiert wird.Identifier(string) (erforderlich) — Ihre Angebotsset-ID. Weitere Informationen finden Sie unter Kennung.Type(string) (erforderlich) — Muss seinOfferSet@1.0.
DetailsDocument(object) (erforderlich) — Die Details der Anfrage.Offers(array) (erforderlich) — Liste der AWS Marketplace Angebote, die verknüpft werden sollen. Minimum: 1 Artikel. Maximal: 7 Artikel.OfferId(string) (erforderlich) — Die Kennung des AWS Marketplace Angebots. Mindestlänge: 1 Zeichen. Maximale Länge: 36 Zeichen.
Syntax der Antwort
Für Ihre Anfrage wird ein Änderungssatz erstellt. Die Antwort auf diese Anfrage gibt Ihnen das ChangeSetId und ChangeSetArn für den Änderungssatz und sieht wie folgt aus.
{ "ChangeSetId": "example123456789012abcdef", "ChangeSetArn": "arn:aws:aws-marketplace:us-east-1:123456789012:AWSMarketplace/ChangeSet/example123456789012abcdef" }
Die Änderungsanforderung wird einer Warteschlange hinzugefügt und verarbeitet. Dazu gehört auch die Überprüfung von Informationen, um sicherzustellen, dass sie den AWS Marketplace Marketplace-Richtlinien entsprechen. Der Validierungsprozess kann einige Minuten dauern.
Sie können den Status der Anfrage über das AWS Marketplace Management Portal oder direkt über die Catalog API mithilfe des DescribeChangeSet API-Vorgangs überprüfen.
Asynchrone Fehler
Die folgenden Fehler beziehen sich spezifisch auf AssociateOffers Aktionen in der AWS Marketplace Katalog-API. Diese Fehler werden zurückgegeben, wenn Sie aufrufen, DescribeChangeSet nachdem ein Änderungssatz verarbeitet wurde. Weitere Hinweise zur Verwendung DescribeChangeSet zum Abrufen des Status einer Änderungsanforderung finden Sie unterMit Änderungssätzen arbeiten.
| Fehlercode | Fehlermeldung |
|---|---|
TOO_MANY_OFFERS |
Ordnen Sie dem Angebotssatz bis zu 7 Angebote zu. |
INCOMPATIBLE_OFFER_SET_REFERENCE |
Stellen Sie sicher, dass alle Angebote speziell für dieses Angebotsset erstellt wurden. |
INVALID_UPDATE_REQUEST |
Die angeforderte Änderung kann nach der Veröffentlichung des Angebotssets nicht durchgeführt werden. |
Trennen Sie Angebote von einem Angebotssatz
Verwenden Sie den DisassociateOffers Änderungstyp, um mehrere AWS Marketplace Angebote aus einem Angebotssatz zu entfernen. Diese idempotente Operation entfernt die Assoziationsbeziehung und behält gleichzeitig das Attribut des OfferSetId Angebots bei. Getrennte Angebote werden dem Käufer nicht angezeigt, bis sie wieder derselben Angebotsgruppe zugeordnet werden. Sie können keinem anderen Angebotssatz zugeordnet werden.
Anforderungssyntax
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" } ] } } ] }
Geben Sie Informationen für die Felder an, um den DisassociateOffers Änderungstyp hinzuzufügen:
Entity(Objekt) (erforderlich) — Die Entität, die aktualisiert wird.Identifier(string) (erforderlich) — Ihre Angebotsset-ID. Weitere Informationen finden Sie unter Kennung.Type(string) (erforderlich) — Muss seinOfferSet@1.0.
DetailsDocument(object) (erforderlich) — Die Details der Anfrage.Offers(array) (erforderlich) — Liste der Angebote, deren Zuordnung aufgehoben werden soll. Minimum: 1 Artikel. Maximal: 7 Artikel.OfferId(string) (erforderlich) — Die ID des AWS Marketplace Marketplace-Angebots. Mindestlänge: 1 Zeichen. Maximale Länge: 36 Zeichen.
Syntax der Antwort
Für Ihre Anfrage wird ein Änderungssatz erstellt. Die Antwort auf diese Anfrage gibt Ihnen das ChangeSetId und ChangeSetArn für den Änderungssatz und sieht wie folgt aus.
{ "ChangeSetId": "example123456789012abcdef", "ChangeSetArn": "arn:aws:aws-marketplace:us-east-1:123456789012:AWSMarketplace/ChangeSet/example123456789012abcdef" }
Die Änderungsanforderung wird einer Warteschlange hinzugefügt und verarbeitet. Dazu gehört auch die Überprüfung von Informationen, um sicherzustellen, dass sie den AWS Marketplace Marketplace-Richtlinien entsprechen. Der Validierungsprozess kann einige Minuten dauern.
Sie können den Status der Anfrage über das AWS Marketplace Management Portal oder direkt über die Catalog API mithilfe des DescribeChangeSet API-Vorgangs überprüfen.
Asynchrone Fehler
Die folgenden Fehler beziehen sich spezifisch auf DisassociateOffers Aktionen in der AWS Marketplace Katalog-API. Diese Fehler werden zurückgegeben, wenn Sie aufrufen, DescribeChangeSet nachdem ein Änderungssatz verarbeitet wurde. Weitere Hinweise zur Verwendung DescribeChangeSet zum Abrufen des Status einer Änderungsanforderung finden Sie unterMit Änderungssätzen arbeiten.
| Fehlercode | Fehlermeldung |
|---|---|
INVALID_UPDATE_REQUEST |
Die angeforderte Änderung kann nach der Veröffentlichung des Angebotssets nicht durchgeführt werden. |
Ordnen Sie eine Lösung einem Angebotssatz zu
Verwenden Sie den AssociateSolution Änderungstyp, um eine einzelne AWS Marketplace Marketplace-Lösung einem Angebotssatz zuzuordnen. Dadurch entsteht eine Beziehung, die es Käufern ermöglicht, den Zusammenhang des Angebotspakets mit der Lösung zu ermitteln und auf die umfangreichen Marketinginhalte der Lösung wie detaillierte Beschreibungen, Architekturdiagramme und Anwendungsfalldokumentation zuzugreifen.
Anmerkung
Dies ist eine lose gekoppelte Assoziation. AWS Marketplace erzwingt keine Konsistenz zwischen der Lösung und dem Angebotspaket. Lösungen dürfen keine AWS Marketplace Marketplace-Produkte, andere Produkte als die im Angebotspaket enthaltenen Produkte oder sich überschneidende Produkte enthalten. Sie haben die volle Flexibilität, jede Lösung, die Sie besitzen, für Marketing- und Entdeckungszwecke zu verknüpfen.
Informationen zu den erforderlichen IAM-Berechtigungen finden Sie unterIAM-Berechtigungen für Angebotssets.
Anforderungssyntax
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" } } ] }
Geben Sie Informationen zu den Feldern an, um den AssociateSolution Änderungstyp hinzuzufügen:
Entity(Objekt) (erforderlich) — Die Entität, die aktualisiert wird.Identifier(string) (erforderlich) — Ihre Angebotsset-ID. Weitere Informationen finden Sie unter Kennung.Type(string) (erforderlich) — Muss seinOfferSet@1.0.
DetailsDocument(object) (erforderlich) — Die Details der Anfrage.SolutionId(string) (erforderlich) — Die ID der AWS Marketplace Marketplace-Lösung, die verknüpft werden soll. Mindestlänge: 1 Zeichen. Maximale Länge: 50 Zeichen. Muss mit dem Muster übereinstimmen^soln-[A-Za-z0-9]+$.
Syntax der Antwort
Für Ihre Anfrage wird ein Änderungssatz erstellt. Die Antwort auf diese Anfrage gibt Ihnen das ChangeSetId und ChangeSetArn für den Änderungssatz und sieht wie folgt aus.
{ "ChangeSetId": "example123456789012abcdef", "ChangeSetArn": "arn:aws:aws-marketplace:us-east-1:123456789012:AWSMarketplace/ChangeSet/example123456789012abcdef" }
Die Änderungsanforderung wird einer Warteschlange hinzugefügt und verarbeitet. Dazu gehört auch die Überprüfung von Informationen, um sicherzustellen, dass sie den AWS Marketplace Marketplace-Richtlinien entsprechen. Der Validierungsprozess kann einige Minuten dauern.
Sie können den Status der Anfrage über das AWS Marketplace Management Portal oder direkt über die Catalog API mithilfe des DescribeChangeSet API-Vorgangs überprüfen.
Asynchrone Fehler
Die folgenden Fehler beziehen sich spezifisch auf AssociateSolution Aktionen in der AWS Marketplace Katalog-API. Diese Fehler werden zurückgegeben, wenn Sie aufrufen, DescribeChangeSet nachdem ein Änderungssatz verarbeitet wurde. Weitere Hinweise zur Verwendung DescribeChangeSet zum Abrufen des Status einer Änderungsanforderung finden Sie unterMit Änderungssätzen arbeiten.
| Fehlercode | Fehlermeldung |
|---|---|
INCOMPATIBLE_SOLUTION_ASSOCIATION |
Trennen Sie die Zuordnung der vorhandenen Lösung, bevor Sie eine neue Lösung zuordnen. |
INVALID_UPDATE_REQUEST |
Die angeforderte Änderung kann nach der Veröffentlichung des Angebotssets nicht durchgeführt werden. |
Trennen Sie die Zuordnung einer Lösung zu einem Angebotssatz
Verwenden Sie den DisassociateSolution Änderungstyp, um die Zuordnung zwischen einer Lösung und einem Angebotssatz aufzuheben. Dadurch werden die Marketinginhalte der Lösung aus dem Angebotsset entfernt, wobei die transaktionsfähige Funktionalität des Angebotssets erhalten bleibt.
Anforderungssyntax
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" } } ] }
Geben Sie Informationen für die Felder ein, um den DisassociateSolution Änderungstyp hinzuzufügen:
Entity(Objekt) (erforderlich) — Die Entität, die aktualisiert wird.Identifier(string) (erforderlich) — Ihre Angebotsset-ID. Weitere Informationen finden Sie unter Kennung.Type(string) (erforderlich) — Muss seinOfferSet@1.0.
DetailsDocument(object) (erforderlich) — Die Details der Anfrage.SolutionId(string) (erforderlich) — Der Bezeichner der Lösung, deren Verknüpfung aufgehoben werden soll. Mindestlänge: 1 Zeichen. Maximale Länge: 50 Zeichen.
Syntax der Antwort
Für Ihre Anfrage wird ein Änderungssatz erstellt. Die Antwort auf diese Anfrage gibt Ihnen das ChangeSetId und ChangeSetArn für den Änderungssatz und sieht wie folgt aus.
{ "ChangeSetId": "example123456789012abcdef", "ChangeSetArn": "arn:aws:aws-marketplace:us-east-1:123456789012:AWSMarketplace/ChangeSet/example123456789012abcdef" }
Die Änderungsanforderung wird einer Warteschlange hinzugefügt und verarbeitet. Dazu gehört auch die Überprüfung von Informationen, um sicherzustellen, dass sie den AWS Marketplace Marketplace-Richtlinien entsprechen. Der Validierungsprozess kann einige Minuten dauern.
Sie können den Status der Anfrage über das AWS Marketplace Management Portal oder direkt über die Catalog API mithilfe des DescribeChangeSet API-Vorgangs überprüfen.
Asynchrone Fehler
Die folgenden Fehler beziehen sich spezifisch auf DisassociateSolution Aktionen in der AWS Marketplace Katalog-API. Diese Fehler werden zurückgegeben, wenn Sie aufrufen, DescribeChangeSet nachdem ein Änderungssatz verarbeitet wurde. Weitere Hinweise zur Verwendung DescribeChangeSet zum Abrufen des Status einer Änderungsanforderung finden Sie unterMit Änderungssätzen arbeiten.
| Fehlercode | Fehlermeldung |
|---|---|
INVALID_UPDATE_REQUEST |
Die angeforderte Änderung kann nach der Veröffentlichung des Angebotssets nicht durchgeführt werden. |
Geben Sie ein Angebotspaket frei
Verwenden Sie den ReleaseOfferSet Änderungstyp, um Käufern ein Angebotsset zur Verfügung zu stellen. Nach der Veröffentlichung wechselt der Angebotssatz vom Status „Entwurf“ in den Status „Freigegeben“. Die zugehörigen Angebote sind nur als Teil des einheitlichen Pakets auffindbar. AWS Marketplace
Für freigegebene Angebotssets werden Benachrichtigungen auf zwei Ebenen generiert: für einzelne Angebote und für das Angebotspaket selbst. Alle individuellen Angebotsbenachrichtigungen beinhalten die OfferSetId vorhandenen Benachrichtigungskanäle (E-Mail-Benachrichtigungen und EventBridge Amazon-Ereignisse). Benachrichtigungen auf Angebotsebene werden für wichtige Ereignisse gesendet, z. B. wenn das Angebotspaket veröffentlicht wird.
Anforderungssyntax
POST /StartChangeSet HTTP/1.1 Content-type: application/json { "Catalog": "AWSMarketplace", "ChangeSet": [ { "ChangeType": "ReleaseOfferSet", "Entity": { "Type": "OfferSet@1.0", "Identifier": "offerset-abc123" }, "DetailsDocument": {} } ] }
Geben Sie Informationen für die Felder an, um den ReleaseOfferSet Änderungstyp hinzuzufügen:
Entity(Objekt) (erforderlich) — Die Entität, die aktualisiert wird.Identifier(string) (erforderlich) — Ihre Angebotsset-ID. Weitere Informationen finden Sie unter Kennung.Type(string) (erforderlich) — Muss seinOfferSet@1.0.
DetailsDocument(object) (erforderlich) — Leeres Objekt für diesen Vorgang.
Syntax der Antwort
Für Ihre Anfrage wird ein Änderungssatz erstellt. Die Antwort auf diese Anfrage gibt Ihnen das ChangeSetId und ChangeSetArn für den Änderungssatz und sieht wie folgt aus.
{ "ChangeSetId": "example123456789012abcdef", "ChangeSetArn": "arn:aws:aws-marketplace:us-east-1:123456789012:AWSMarketplace/ChangeSet/example123456789012abcdef" }
Die Änderungsanforderung wird einer Warteschlange hinzugefügt und verarbeitet. Dazu gehört auch die Überprüfung von Informationen, um sicherzustellen, dass sie den AWS Marketplace Marketplace-Richtlinien entsprechen. Der Validierungsprozess kann einige Minuten dauern.
Sie können den Status der Anfrage über das AWS Marketplace Management Portal oder direkt über die Catalog API mithilfe des DescribeChangeSet API-Vorgangs überprüfen.
Asynchrone Fehler
Die folgenden Fehler beziehen sich spezifisch auf ReleaseOfferSet Aktionen in der AWS Marketplace Katalog-API. Diese Fehler werden zurückgegeben, wenn Sie aufrufen, DescribeChangeSet nachdem ein Änderungssatz verarbeitet wurde. Weitere Hinweise zur Verwendung DescribeChangeSet zum Abrufen des Status einer Änderungsanforderung finden Sie unterMit Änderungssätzen arbeiten.
| Fehlercode | Fehlermeldung |
|---|---|
MISSING_BUYER_NOTES |
Geben Sie dies an, bevor Sie BuyerNotes das Angebotspaket veröffentlichen. |
FEHLENDES_ANGEBOTE |
Ordnen Sie dem Angebotspaket mindestens zwei Angebote zu, bevor Sie es veröffentlichen. |
ZU VIELE ANGEBOTE PRO PRODUKT |
Ordnen Sie dem Angebotsset nur ein Angebot pro Produkt zu. |
INSISTENT_OFFER_CURRENCY_CODE |
Stellen Sie sicher, dass alle zugehörigen Angebote übereinstimmend sind. CurrencyCode |
INSISTENT_OFFER_AVAILABILITY_END_DATE |
Stellen Sie sicher, dass alle zugehörigen Angebote übereinstimmend sind. AvailabilityEndDate |
INSISTENT_OFFER_TARGETING_RULE |
Stellen Sie sicher, dass alle zugehörigen Angebote übereinstimmend sind. TargetingRule |
INCOMPATIBLE_OFFER_TARGETING_RULE |
Nur auf Käufer ausgerichtete Angebote können einem Angebotssatz zugeordnet werden. |
ABGELAUFENE ANGEBOTE |
Trennen Sie abgelaufene Angebote vom Angebotspaket oder verlängern Sie sie. AvailabilityEndDates |
ANGEBOTSENTWÜRFE |
Geben Sie alle zugehörigen Angebote frei, bevor Sie das Angebotspaket veröffentlichen. |
INCOMPATIBLE_SOLUTION_STATE |
Stellen Sie eine Lösung in begrenztem oder öffentlichem Zustand bereit. |
INVALID_UPDATE_REQUEST |
Die angeforderte Änderung kann nach der Veröffentlichung des Angebotssets nicht durchgeführt werden. |
Lebenszyklus des Angebotssets
Der Lebenszyklus des Angebotssets besteht aus den folgenden Phasen:
Erstellungsphase
Erstellen Sie die Angebotsset-Entität im Status Entwurf unter Verwendung des CreateOfferSet Änderungstyps. Das Angebotssatz erhält eine eindeutige Kennung und beginnt im Status Entwurf.
Phase der Konfiguration
Während der Konfiguration gehen Sie wie folgt vor:
Fügen Sie Metadaten hinzu oder aktualisieren Sie sie mithilfe von
UpdateInformation(Name, Käufernotizen)Erstellen Sie individuelle private Angebote und geben Sie dies
OfferSetIdbei der Angebotserstellung anOrdnen Sie Angebote dem Angebotssatz zu, indem Sie
AssociateOffersOrdnen Sie optional eine Lösung zu,
AssociateSolutiondie für erweiterte Marketinginhalte verwendet wird
Wichtig
Der Wert OfferSetId für einzelne Angebote ist unveränderlich und kann nur bei der Angebotserstellung festgelegt werden. Bevor Sie Angebote einem Angebotsset zuordnenAssociateOffers, müssen Sie zunächst die einzelnen Angebote erstellen und diese OfferSetId bei der Angebotserstellung angeben. Wenn Sie ein vorhandenes Angebot hinzufügen möchten, für das nicht das richtige Angebot angegeben istOfferSetId, müssen Sie ein neues Angebot erstellen, bei dem das richtige Angebot OfferSetId angegeben ist.
Validierungsphase
Bevor Sie ein Angebotspaket veröffentlichen, stellen Sie Folgendes sicher:
Das Angebotspaket enthält zwischen 2 und 7 Angebote
Alle zugehörigen Angebote müssen:
Im Status „Freigegeben“
Aktiv
Es wird dieselbe Währung verwendet
Ausrichtung auf dieselben AWS-Konto-IDs für Käufer
Mit identischen Ablaufdaten
Veröffentlichungsphase
Wenn Sie bereit sind, verwenden Sie den ReleaseOfferSet Änderungstyp, um den Angebotssatz vom Status Entwurf in den Status Freigegeben zu überführen. Dadurch ist das Angebotsset für Käufer sofort auffindbar. AWS Marketplace
Post-release Verwaltung
Verwaltung des Ablaufs:
Das tatsächliche Ablaufdatum eines Angebotssets wird als das früheste Ablaufdatum aller zugehörigen Angebote berechnet
Sie können die Ablaufdaten einzelner Angebote mithilfe vorhandener Funktionen zur Angebotsverwaltung
UpdateAvailabilityändern (Typ ändern)
Änderungen am Angebotssatz:
Wenn Käufer Änderungen an einem veröffentlichten Angebotssatz anfordern, verwenden Sie den neuen Workflow:
Erstellen Sie eine neue Entität für das Angebotsset
Für Angebote, für die keine Änderungen erforderlich sind, klonen Sie bestehende Angebote über das AWS Marketplace Verwaltungsportal
Für Angebote, die geändert werden müssen, erstellen Sie neue Angebote mit den angeforderten Änderungen und geben Sie die neuen an
OfferSetIdOrdnen Sie alle Angebote (geklont und neu) dem neuen Angebotssatz zu, indem Sie
AssociateOffersVeröffentlichen Sie das neue Angebotsset mit
ReleaseOfferSetDas ursprüngliche Angebotssatz läuft ab, indem Sie das Enddatum der Verfügbarkeit der zugehörigen Angebote festlegen
IAM-Berechtigungen für Angebotssets
Um mithilfe der AWS Marketplace Catalog API mit Angebotssets arbeiten zu können, benötigen Sie spezielle IAM-Berechtigungen. In diesem Abschnitt werden die erforderlichen Berechtigungen für den Betrieb von Angebotsgruppen und die Anforderungen an die entitätsübergreifende Autorisierung beschrieben.
Erforderliche IAM-Aktionen
Die folgenden IAM-Aktionen sind für Offer-Set-Operationen erforderlich:
aws-marketplace:StartChangeSet— Erforderlich für alle Arten von Änderungen an Angebotsgruppen, einschließlich Vorgängen zum Erstellen, Aktualisieren, Zuordnen und Freigebenaws-marketplace:DescribeChangeSet— Erforderlich, um den Status und die Ergebnisse der Ausführung von Änderungssätzen zu überprüfenaws-marketplace:ListEntities— Erforderlich, um Angebotssets in Ihrem Konto aufzulistenaws-marketplace:DescribeEntity— Erforderlich, um detaillierte Informationen zu einem Angebotssatz abzurufen
Berechtigungen für Ressourcen
Verwenden Sie die folgenden ARN-Muster, um Berechtigungen für bestimmte Ressourcen zu erteilen:
Angebotssets —
arn:aws:aws-marketplace:us-east-1:123456789012:AWSMarketplace/OfferSet/*Individuelle Angebote —
arn:aws:aws-marketplace:us-east-1:123456789012:AWSMarketplace/Offer/*Lösungen —
arn:aws:aws-marketplace:us-east-1:123456789012:AWSMarketplace/Solution/*
Für restriktivere Berechtigungen ersetzen Sie den Platzhalter (*) durch spezifische Entitätsbezeichner.
Cross-entity Autorisierung
Für einige Vorgänge im Angebotssatz sind Berechtigungen sowohl für das Angebotsset als auch für die verknüpften Entitäten erforderlich:
AssociateOffers
aws-marketplace:StartChangeSetErlaubnis für die Entität des Angebotssatzesaws-marketplace:StartChangeSetBerechtigung mitAssociateWithOfferSetÄnderungstyp für jede einzelne zugeordnete Angebotseinheit
AssociateSolution
aws-marketplace:StartChangeSetErlaubnis für die Entität des Angebotssatzesaws-marketplace:StartChangeSetBerechtigung mit demAssociateWithOfferSetÄnderungstyp für die zugeordnete Lösungsentität
Anmerkung
Nur DescribeEntity (schreibgeschützte) Berechtigungen für Angebote oder Lösungen zu haben, reicht für Zuordnungsoperationen nicht aus. Sie benötigen für die Entitäten, die mit dem Angebotssatz verknüpft sind, die entsprechenden StartChangeSet Berechtigungen für den AssociateWithOfferSet Änderungstyp.
IAM-Beispielrichtlinien
Grundlegende Verwaltung von Angebotspaketen
Diese Richtlinie gewährt Berechtigungen für grundlegende Operationen mit Angebotsgruppen ohne unternehmensübergreifende Verknüpfungen:
{ "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 Berechtigungen für AssociateOffers
Diese Richtlinie zeigt die spezifischen Berechtigungen und Bedingungen, die erforderlich sind für 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"] } } } ] }
Für restriktivere Berechtigungen ersetzen Sie den Platzhalter (*) durch spezifische Entitätsbezeichner.
Cross-entity Berechtigungen für AssociateSolution
Diese Richtlinie zeigt die spezifischen Berechtigungen und Bedingungen, die erforderlich sind für 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"] } } } ] }
Für restriktivere Berechtigungen ersetzen Sie den Platzhalter (*) durch spezifische Entitätsbezeichner.