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](https://docs.aws.amazon.com/marketplace/latest/APIReference/Welcome.html). 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 ist`OfferSet@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](https://docs.aws.amazon.com/marketplace/latest/APIReference/API_Change.html) 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](https://docs.aws.amazon.com/marketplace/latest/userguide/create-public-profile.html). + 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](https://docs.aws.amazon.com/marketplace/latest/APIReference/catalog-api-access-control.html). + Sie haben sich mit den Grundlagen der Verwendung der AWS Marketplace Catalog API vertraut gemacht, siehe [Verwenden der AWS Marketplace Catalog API](https://docs.aws.amazon.com/marketplace/latest/APIReference/catalog-apis.html). ## Angebotssets auflisten Um alle Angebotsgruppen in Ihrem Konto aufzulisten, rufen Sie den `ListEntities` API-Vorgang mit `EntityType` set to auf auf auf auf`OfferSet`. **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 sein`OfferSet@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](https://docs.aws.amazon.com/marketplace-catalog/latest/api-reference/API_DescribeChangeSet.html)` 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](catalog-apis.md#identifier). + `Type`(string) (erforderlich) — Muss sein`OfferSet@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](https://docs.aws.amazon.com/marketplace-catalog/latest/api-reference/API_DescribeChangeSet.html)` 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 zuordnen`AssociateOffers`, 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 ist`OfferSetId`, müssen Sie ein neues Angebot erstellen, bei dem das richtige Angebot `OfferSetId` angegeben ist. Informationen zu den erforderlichen IAM-Berechtigungen finden Sie unter[IAM-Berechtigungen für Angebotssets](#iam-permissions-offer-sets). **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](catalog-apis.md#identifier). + `Type`(string) (erforderlich) — Muss sein`OfferSet@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](https://docs.aws.amazon.com/marketplace-catalog/latest/api-reference/API_DescribeChangeSet.html)` 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 unter[Mit Änderungssätzen arbeiten](catalog-apis.md#working-with-change-sets). | 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](catalog-apis.md#identifier). + `Type`(string) (erforderlich) — Muss sein`OfferSet@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](https://docs.aws.amazon.com/marketplace-catalog/latest/api-reference/API_DescribeChangeSet.html)` 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 unter[Mit Änderungssätzen arbeiten](catalog-apis.md#working-with-change-sets). | 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 unter[IAM-Berechtigungen für Angebotssets](#iam-permissions-offer-sets). **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](catalog-apis.md#identifier). + `Type`(string) (erforderlich) — Muss sein`OfferSet@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](https://docs.aws.amazon.com/marketplace-catalog/latest/api-reference/API_DescribeChangeSet.html)` 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 unter[Mit Änderungssätzen arbeiten](catalog-apis.md#working-with-change-sets). | 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](catalog-apis.md#identifier). + `Type`(string) (erforderlich) — Muss sein`OfferSet@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](https://docs.aws.amazon.com/marketplace-catalog/latest/api-reference/API_DescribeChangeSet.html)` 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 unter[Mit Änderungssätzen arbeiten](catalog-apis.md#working-with-change-sets). | 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](https://docs.aws.amazon.com/marketplace/latest/userguide/email-notifications.html) und [ EventBridge Amazon-Ereignisse](https://docs.aws.amazon.com/marketplace/latest/userguide/notifications-eventbridge.html)). 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](catalog-apis.md#identifier). + `Type`(string) (erforderlich) — Muss sein`OfferSet@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](https://docs.aws.amazon.com/marketplace-catalog/latest/api-reference/API_DescribeChangeSet.html)` 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 unter[Mit Änderungssätzen arbeiten](catalog-apis.md#working-with-change-sets). | 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 `OfferSetId` bei der Angebotserstellung an + Ordnen Sie Angebote dem Angebotssatz zu, indem Sie `AssociateOffers` + Ordnen Sie optional eine Lösung zu, `AssociateSolution` die 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 zuordnen`AssociateOffers`, 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 ist`OfferSetId`, 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: 1. Erstellen Sie eine neue Entität für das Angebotsset 1. Für Angebote, für die keine Änderungen erforderlich sind, klonen Sie bestehende Angebote über das AWS Marketplace Verwaltungsportal 1. Für Angebote, die geändert werden müssen, erstellen Sie neue Angebote mit den angeforderten Änderungen und geben Sie die neuen an `OfferSetId` 1. Ordnen Sie alle Angebote (geklont und neu) dem neuen Angebotssatz zu, indem Sie `AssociateOffers` 1. Veröffentlichen Sie das neue Angebotsset mit `ReleaseOfferSet` 1. Das 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 Freigeben + `aws-marketplace:DescribeChangeSet`— Erforderlich, um den Status und die Ergebnisse der Ausführung von Änderungssätzen zu überprüfen + `aws-marketplace:ListEntities`— Erforderlich, um Angebotssets in Ihrem Konto aufzulisten + `aws-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:StartChangeSet`Erlaubnis für die Entität des Angebotssatzes + `aws-marketplace:StartChangeSet`Berechtigung mit `AssociateWithOfferSet` Änderungstyp für jede einzelne zugeordnete Angebotseinheit **AssociateSolution** + `aws-marketplace:StartChangeSet`Erlaubnis für die Entität des Angebotssatzes + `aws-marketplace:StartChangeSet`Berechtigung mit dem `AssociateWithOfferSet` Ä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.