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.
# Arbeite mit Lösungen
Eine Lösung ist eine Sammlung von Produkten und Dienstleistungen, die zusammenarbeiten, um spezifische Kundenprobleme zu lösen. Die Lösungen können AWS Marketplace Marketplace-Produkte und Produkte anderer Anbieter umfassen. Mithilfe von Lösungen können Sie zeigen, wie sich mehrere Produkte integrieren lassen, um branchenspezifische Anwendungsfälle zu adressieren. Die Lösung beschreibt das Kundenproblem, Anwendungsfälle, Integrationsdetails und verwandte Produkte.
## Lösungen im AWS Marketplace und in AWS Partner Central
Wenn Sie von Partner Central 2.0 zu Partner Central 3.0 migrieren, werden Sie aufgefordert, ein AWS-Konto zu erstellen und sich als AWS Marketplace-Verkäufer zu registrieren. Weitere Informationen finden Sie unter [Registrieren und Ihr Verkäuferprofil erstellen](https://docs.aws.amazon.com/marketplace/latest/userguide/create-public-profile.html). Diese Registrierung ist erforderlich, um:
+ Migrieren Sie Ihre bestehenden Partner Central-Lösungen in den AWS Marketplace Marketplace-Katalog (alle Lösungen werden in den `AWSMarketplace` Katalog migriert)
+ Sorgen Sie dafür, dass Ihre AWS Marketplace Marketplace-Lösungen mit Partner Central-APIs wie [Verkaufs-APIs](https://docs.aws.amazon.com/partner-central/latest/APIReference/working-with-your-opportunities.html) funktionieren.
### Grundlegendes zur Profilverknüpfung und Migration
Es gibt zwei unterschiedliche Szenarien für die Verbindung Ihrer Partner Central- und AWS Marketplace Marketplace-Konten:
**Nur Profilverknüpfung** — Wenn Sie Ihre AWS Partner Central- und AWS-Konten verknüpfen, ohne zu Partner Central 3.0 zu migrieren, bleiben Ihre AWS Marketplace-Lösungen und Partner Central-Lösungen getrennt. Sie verwalten jede Plattform unabhängig voneinander.
**Profilmigration** — Wenn Sie mit verknüpften AWS Marketplace Marketplace-Verkäuferprofilen zu Partner Central 3.0 migrieren:
+ Ihre Partner Central 2.0-Lösungen migrieren auf AWS Marketplace
+ Sie verwalten Lösungen nur über AWS Marketplace
+ Partner Central-APIs können auf migrierte Lösungen zugreifen
**Anmerkung**
Wenn Sie Ihre AWS Partner Central- und AWS-Konten bereits verknüpft haben (siehe [Verknüpfen von AWS Partner Central- und AWS-Konten](https://docs.aws.amazon.com/partner-central/latest/getting-started/account-linking.html)), müssen Sie kein neues AWS-Konto erstellen. Stellen Sie jedoch sicher, dass Ihr vorhandenes AWS-Konto als AWS Marketplace-Verkäufer registriert ist. Um Ihre Lösung auf der AWS Marketplace Marketplace-Käuferwebsite öffentlich verfügbar zu machen, benötigen Sie ein öffentliches Profil als AWS Marketplace Marketplace-Verkäufer. Anweisungen zur Registrierung von Verkäufern im AWS Marketplace finden Sie unter [Registrieren und Ihr Verkäuferprofil erstellen](https://docs.aws.amazon.com/marketplace/latest/userguide/create-public-profile.html).
### Bereitstellung bereits vorhandener AWS Marketplace Marketplace-Lösungen für Partner Central-APIs
AWS Marketplace Marketplace-Lösungen, die Sie vor der Migration des Partner Central 3.0-Profils erstellt haben, werden von den Partner Central-APIs nicht automatisch erkannt. Dies gilt auch, nachdem Sie die Migration abgeschlossen und Ihr AWS-Konto mit einem Partner Central-Konto verknüpft haben.
Um eine bestehende Lösung vor der Migration für Partner Central-APIs sichtbar zu machen, aktualisieren Sie jedes Feld in der Lösung. Sie können dieselben Informationen eingeben, die derzeit dort sind. Wiederholen Sie diesen Vorgang für jede Lösung, die Sie vor der Migration des Partner Central 3.0-Profils erstellt haben.
Verwenden Sie beispielsweise den `UpdateInformation` Änderungstyp, um den Namen einer Lösung mit dem aktuellen Wert zu aktualisieren. Nachdem Sie eine Lösung einmal aktualisiert haben, erkennen die Partner Central-APIs automatisch alle future Updates für diese Lösung.
## Entität der Lösung
Eine Lösung ist ein Marketingdokument, das Käufern hilft, Ihre Angebote zu entdecken und zu verstehen. Lösungen enthalten einen Titel, eine Beschreibung, Anwendungsfälle, AWS Marketplace Marketplace-Produkte und Produkte, die nicht von AWS Marketplace stammen. Die Lösung ist ein von Produkt-, Angebots- und Angebotssets getrennter Entitätstyp. Jede Lösung hat ihre eigene Entdeckungs- und Angebotserfahrung, die Käufer getrennt von den einzelnen Produkten durchsuchen können.
**Schlüsselmerkmale**
+ Gruppieren Sie mehrere Produkte, darunter sowohl AWS Marketplace Marketplace-Produkte als auch Produkte anderer Anbieter.
+ Bieten Sie Käufern ein spezielles Einkaufs- und Angebotserlebnis.
+ Gruppieren Sie Produkte, die Sie besitzen, mit Produkten anderer Verkäufer.
Der Entitätstyp der Lösung ist`Solution@1.0`.
**Entitätskennungen**
Lösungen verwenden das `soln-*` Identifier-Format (z. B.`soln-abc123def456`).
**ARN-Format der Entität**
Die Lösungen folgen dem AWS-ARN-Standardformat:
```
arn:{aws-partition}:aws-marketplace:{region}:{account-id}:{aws-marketplace-catalog}/Solution/{solution-id}
```
Beispiel:
```
arn:aws:aws-marketplace:us-east-1:123456789012:AWSMarketplace/Solution/soln-abc123def456
```
## Erste Schritte mit Lösungen
Dieser Abschnitt enthält detaillierte Informationen zum Erstellen und Verwalten von Lösungen mithilfe von AWS Marketplace [Katalog-API-Änderungstypen](https://docs.aws.amazon.com/marketplace/latest/APIReference/API_Change.html).
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).
## Listen Sie Ihre Lösungen auf
Um alle Lösungen in Ihrem Konto aufzulisten, rufen Sie den `ListEntities` API-Vorgang auf und stellen Sie `EntityType` die Option Lösung ein.
**Anforderung**
```
POST /ListEntities HTTP/1.1
Content-type: application/json
{
"Catalog": "AWSMarketplace",
"EntityType": "Solution"
}
```
**Antwort**
```
{
"EntitySummaryList": [
{
"EntityArn": "arn:aws:aws-marketplace:us-east-1:123456789012:AWSMarketplace/Solution/soln-abc123456",
"EntityId": "soln-abc123456",
"EntityType": "Solution",
"LastModifiedDate": "2024-10-10T19:50:43Z",
"Name": "Test Solution 1",
"Visibility": "Limited"
}
],
"NextToken": null
}
```
### Filtern Sie Lösungen nach Sichtbarkeit
Mithilfe des `FilterList` Parameters können Sie Lösungen nach Sichtbarkeit filtern.
**Anforderung**
```
POST /ListEntities HTTP/1.1
Content-type: application/json
{
"Catalog": "AWSMarketplace",
"EntityType": "Solution",
"FilterList": [
{
"Name": "Visibility",
"ValueList": [
"Public"
]
}
]
}
```
## Details zur Lösung abrufen
Rufen Sie den `DescribeEntity` API-Vorgang auf, um detaillierte Informationen zu einer bestimmten Lösung zu erhalten.
**Anmerkung**
Die DescribeEntity Antwort gibt ein zurück`EntityIdentifier`, das ein `EntityId` mit einem `RevisionId.` For solutions kombiniert, die Lösungs-ID `EntityId` ist und für optimistisches Sperren verwendet werden `RevisionId` kann. Weitere Informationen finden Sie unter [Identifikatoren](https://docs.aws.amazon.com/marketplace/latest/APIReference/catalog-apis.html#identifier).
**Anforderung**
```
GET /DescribeEntity?catalog=AWSMarketplace&entityId=soln-abc123456 HTTP/1.1
```
**Antwort**
```
{
"Details": "{...}",
"DetailsDocument": {
"Lifecycle": {
"Visibility": "Limited"
},
"Identifiers": {
"Id": "soln-abc123456"
},
"Presentation": {
"Title": "My Solution",
"Name": "solution_for_customer_X",
"ShortDescription": "Solution value proposition",
"LongDescription": "Detailed solution description",
"LogoUrl": "https://s3.amazonaws.com/logo.jpg",
"UseCases": [
{
"Group": "advertising_and_marketing",
"SubGroup": "ad_intelligence_and_measurement",
"Item": "amazon_ads_insights",
"Description": "Use case description"
}
]
},
"RelatedProducts": {
"AwsMarketplaceProducts": [
{
"ProductId": "prod-123"
}
],
"IntegrationDescription": "How products work together",
"NonAwsMarketplaceProducts": [
{
"Type": "Hardware",
"Title": "A hardware product",
"Url": "https://example.com",
"Description": "My hardware product description"
}
]
},
"BuyerEngagement": [
{
"EngagementOption": "RequestPrivateOffer"
}
]
},
"EntityArn": "arn:aws:aws-marketplace:us-east-1:123456789012:AWSMarketplace/Solution/soln-abc123456",
"EntityIdentifier": "soln-abc123456@12",
"EntityType": "Solution@1.0",
"LastModifiedDate": "2025-04-22T01:02:48Z"
}
```
## Listet den Änderungsverlauf für eine Lösung auf
Um den Änderungsverlauf für eine bestimmte Lösung anzuzeigen, rufen Sie den `ListChangeSets` API-Vorgang mit einem Entitätsfilter auf.
**Anforderungssyntax**
```
POST /ListChangeSets HTTP/1.1
Content-type: application/json
{
"Catalog": "AWSMarketplace",
"FilterList": [
{
"Name": "EntityId",
"ValueList": [
"soln-abc123456"
]
}
]
}
```
## Taggen Sie Lösungen und Änderungssätze
Sie können Lösungen während der Erstellung Tags hinzufügen und Sets ändern oder sie später aktualisieren.
**Kennzeichnen Sie während der Erstellung**
Sie können Änderungen `EntityTags` nur zum `CreateSolution` Änderungstyp hinzufügen, nicht zu anderen Lösungsänderungstypen. Sie können `ChangeSetTags` zu jeder `StartChangeSet` Payload etwas hinzufügen.
```
POST /StartChangeSet HTTP/1.1
Content-type: application/json
{
"Catalog": "AWSMarketplace",
"ChangeSet": [
{
"ChangeType": "CreateSolution",
"Entity": {
"Type": "Solution@1.0"
},
"DetailsDocument": {
"Name": "Test solution resource name"
},
"EntityTags": [
{
"Key": "Team",
"Value": "Solutions"
}
]
}
],
"ChangeSetTags": [
{
"Key": "Environment",
"Value": "Production"
}
]
}
```
**Verwalte Tags auf vorhandenen Ressourcen**
Verwenden Sie die `TagResource` und `UntagResource` API-Operationen, um Tags in vorhandenen Lösungen und Änderungssätzen zu verwalten. Wird verwendet`ListTagsForResource`, um aktuelle Tags anzuzeigen.
Weitere Informationen finden Sie unter [Verwaltung von Tags auf Ressourcen](https://docs.aws.amazon.com/marketplace/latest/APIReference/catalog-api-access-control.html#managing-tags-on-resources) und [Hinzufügen von Tags zu einer Entität und einem Änderungssatz während der Erstellung](https://docs.aws.amazon.com/marketplace/latest/APIReference/catalog-api-access-control.html#example-adding-tags-entity-creation).
## Erstellen Sie eine Lösung
Sie können den `CreateSolution` Änderungstyp verwenden, um ein neues Lösungsdokument zu erstellen, das nur eine Lösungs-ID und einen Namen enthält. Andere Werte sind noch nicht ausgefüllt.
Wenn Ihre Anfrage erfolgreich bearbeitet wurde, erstellt AWS Marketplace eine Lösung im `Draft` Status für Sie. Diese unvollständige Lösung ist für Käufer auf dem AWS Marketplace nicht sichtbar.
Anschließend verwenden Sie andere Änderungstypen, um die Lösung abzuschließen: `UpdateInformation``UpdateRelatedProducts`,, `UpdateBuyerEngagementOptions` (optional für die Erstellung einer `Limited` Lösung) und`ReleaseSolution`. Der `ReleaseSolution` Änderungstyp überprüft, ob alle für eine `Limited` Lösung erforderlichen Felder in der Lösung vorhanden sind, und verschiebt sie dann in den Bereich `Limited` Sichtbarkeit.
**Anmerkung**
Um eine Lösung in den Status Öffentlich zu versetzen oder den Status einer Lösung zu ändern, verwenden Sie den `UpdateVisibility` Änderungstyp, nachdem Sie die erforderlichen Werte angegeben haben.
**Anforderungssyntax**
```
POST /StartChangeSet HTTP/1.1
Content-type: application/json
{
"Catalog": "AWSMarketplace",
"ChangeSet": [
{
"ChangeType": "CreateSolution",
"Entity": {
"Type": "Solution@1.0"
},
"ChangeName": "CreateSolutionChange",
"DetailsDocument": {
"Name": "solution_for_customerX_en",
"Title": "New Partner Solution"
}
}
]
}
```
Geben Sie Informationen für die Felder an, um den `CreateSolution` Änderungstyp hinzuzufügen:
+ `Entity`(Objekt) (erforderlich) — Der benannte Typ der Lösungsentität, die erstellt wird.
+ `Type`(string) (erforderlich) — Das `Type` muss sein`Solution@1.0`.
+ `DetailsDocument`(object) (erforderlich) — Die Details der Anfrage.
+ `Name`(string) (erforderlich) — AWS-Ressourcenname nur als Referenz für den Verkäufer (für Käufer nicht sichtbar). Max. Länge: 100 Zeichen. Darf keine führenden oder abschließenden Leerzeichen, Zeilenumbrüche oder Steuerzeichen enthalten. Sie können die Lösungskachel auch über den Änderungstyp aktualisieren. `UpdateInformation`
+ `Title`(string) (optional) — Der Titel für Ihre Lösung. Max. Länge: 255 Zeichen. Darf keine führenden oder abschließenden Leerzeichen, Zeilenumbrüche oder Steuerzeichen enthalten. Sie können den Lösungstitel auch über den Änderungstyp festlegen oder aktualisieren. `UpdateInformation`
**Syntax der Antwort**
Für Ihre Anfrage wird ein Änderungssatz erstellt. Die Antwort gibt Ihnen das `ChangeSetId` und`ChangeSetArn`:
```
{
"ChangeSetId": "example123456789012abcdef",
"ChangeSetArn": "arn:aws:aws-marketplace:us-east-1:123456789012:AWSMarketplace/ChangeSet/example123456789012abcdef"
}
```
Die Änderungsanforderung wird einer Warteschlange hinzugefügt und verarbeitet. Sie können den Status über das AWS Marketplace Management Portal oder den `DescribeChangeSet` API-Vorgang überprüfen.
Wenn die Anfrage erfolgreich abgeschlossen wurde (falls `Status` ja`SUCCEEDED`), wird eine neue Lösungs-ID generiert.
**Asynchrone Fehler**
`CreateSolution`Aktionen geben zusätzlich zu [häufigen asynchronen](#solution-error-codes) Fehlern spezifische Fehler zurück. Diese Fehler treten auf, wenn die Verarbeitung eines Änderungssatzes abgeschlossen ist. `DescribeChangeSet` Informationen zum Abrufen des Status eines Änderungsantrags finden Sie unter [Mit Änderungssätzen arbeiten](https://docs.aws.amazon.com/marketplace/latest/APIReference/catalog-apis.html#working-with-change-sets).
| Fehlercode | Fehlermeldung |
| --- | --- |
| UNGÜLTIGER NAME | Die Länge des Lösungsnamens ist nicht gültig. Geben Sie einen Namen ein, der zwischen 1 und 100 Zeichen lang ist, und versuchen Sie es erneut. |
| FEHLENDER NAME | Ein Name-Wert ist erforderlich. Geben Sie einen Name-Wert an, und versuchen Sie es erneut. |
| UNGÜLTIGER TITEL | Die Länge des Lösungstitels ist nicht gültig. Geben Sie einen Titel ein, der zwischen 1 und 255 Zeichen lang ist, und versuchen Sie es erneut. |
## Aktualisieren Sie die Lösungsinformationen
Wenn Sie bereits über eine Lösung im AWS Marketplace verfügen, können Sie die Katalog-API verwenden, um die Lösungsinformationen zu aktualisieren.
Um die Lösungsinformationen zu aktualisieren, rufen Sie den `StartChangeSet` API-Vorgang mit dem `UpdateInformation` Änderungstyp und Ihren aktualisierten Details auf. Sehen Sie sich das folgende Beispiel an.
**Anmerkung**
Die `UpdateInformation` Änderungstypen verhalten sich wie HTTP-PATCH-Operationen für Attribute der obersten Ebene. So werden Felder aktualisiert:
Wenn ein Attribut der obersten Ebene in vorhanden ist`DetailsDocument`, validiert der Workflow Ihre Eingabe und überschreibt vorhandene Werte.
Wenn in der kein Feld der obersten Ebene vorhanden ist`DetailsDocument`, wird der vorhandene Wert beibehalten.
Um ein optionales Feld zu deaktivieren, senden Sie eine explizite JSON-Datei `null` für dieses Feld.
AWS Marketplace verifiziert Logos und Werbemedien und nimmt sie in einen Marketplace-owned AWS-Standort auf. DescribeEntity gibt eine zugängliche URL für die aufgenommenen Dateien zurück, nicht Ihre ursprüngliche Eingabe von. StartChangeSet Verwenden Sie die DescribeChangeSet API, um Ihre ursprünglich eingereichten URLs zu sehen.
**Anmerkung**
Wenn Sie `PromotionalMedia` Asset-Dateien (durch Angabe neuer URLs) in einer `Public` Lösung ändern, ist eine manuelle Überprüfung durch das AWS Marketplace Seller Operations Team `UpdateInformation` erforderlich. Dies erhöht die Ausführungszeit. Verwenden Sie es in diesem Szenario `UpdateInformation` separat in einem eigenen Änderungssatz.
**Anforderungssyntax**
```
POST /StartChangeSet HTTP/1.1
Content-type: application/json
{
"Catalog": "AWSMarketplace",
"ChangeSet": [
{
"ChangeType": "UpdateInformation",
"Entity": {
"Identifier": "soln-1234abcd",
"Type": "Solution@1.0"
},
"DetailsDocument": {
"Name": "project_cold_harbor",
"Title": "My Awesome Solution",
"ShortDescription": "Solution value proposition",
"LongDescription": "Detailed solution description explaining how this addresses customer needs",
"LogoUrl": "https://s3.amazonaws.com/awsmp-logos/logo.jpg",
"PromotionalMedia": [
{
"Type": "Image",
"Url": "https://s3.amazonaws.com/awsmp-media/image.jpg",
"Title": "Sample image",
"Description": "Sample image description"
},
{
"Type": "Video",
"Url": "https://s3.amazonaws.com/awsmp-media/video.mp4",
"Title": "Sample video",
"PreviewUrl": "https://s3.amazonaws.com/awsmp-media/preview.png",
"Description": "Sample video description"
}
],
"AdditionalResources": [
{
"Text": "Troubleshooting guide",
"Url": "https://example.com/troubleshooting"
}
],
"UseCases": [
{
"Group": "advertising_and_marketing",
"SubGroup": "ad_intelligence_and_measurement",
"Item": "amazon_ads_insights",
"Description": "Highlight description of this use case"
}
]
}
}
]
}
```
Geben Sie Informationen für die Felder an, um den `UpdateInformation` Änderungstyp hinzuzufügen:
+ `Entity`(Objekt) (erforderlich) — Der benannte Typ der Entität, die aktualisiert wird.
+ `Identifier`(string) (erforderlich) — Die Lösungs-ID.
+ `Type`(string) (erforderlich) — Muss sein`Solution@1.0`.
+ `DetailsDocument`(object) (erforderlich) — Die Details der Anfrage, einschließlich der Informationen, die Sie für Ihre Lösung aktualisieren möchten. Jedes Feld ist optional, aber Sie müssen mindestens eine Änderung angeben, um es zu aktualisieren.
+ `Name`(string) — Der Ressourcenname der Lösung, der nur für den Verkäufer über Leseoperationen der Katalog-API sichtbar ist, für Käufer nicht sichtbar. Max. Länge: 100 Zeichen. Darf keine führenden oder abschließenden Leerzeichen, Zeilenumbrüche oder Steuerzeichen enthalten.
+ `Title`(string) — Der Titel der Lösung, der Käufern angezeigt werden soll. Max. Länge: 255 Zeichen. Darf keine führenden oder abschließenden Leerzeichen, Zeilenumbrüche oder Steuerzeichen enthalten.
+ `ShortDescription`(string) — Die Beschreibung des Nutzenversprechens der wichtigsten Aspekte der Lösung, die den Käufern angezeigt werden soll. Das sind in der Regel 2—3 Sätze. Max. Länge: 1000 Zeichen. Darf keine führenden oder nachfolgenden Leerzeichen oder Steuerzeichen enthalten.
+ `LongDescription`(string) — Die längere Beschreibung dieser Lösung, die Käufern angezeigt werden soll. Das sind in der Regel 1—3 Absätze. Max. Länge: 5000 Zeichen. Darf keine führenden oder nachfolgenden Leerzeichen oder Steuerzeichen enthalten.
+ `LogoUrl`(string) — Die URL zu einem Bild in einem öffentlich zugänglichen Amazon S3 S3-Bucket oder eine vorsignierte S3-URL. Muss eine direkte S3-URL sein (nicht hinter CloudFront oder API Gateway). Max. Länge: 2048 Zeichen. Spezifikationen für Logos finden Sie unter [Anforderungen an Unternehmens- und Produktlogos](https://docs.aws.amazon.com/marketplace/latest/userguide/product-submission.html#seller-and-product-logos).
+ `PromotionalMedia`(Reihe von Objekten) — Die Liste der Werbebilder und -videos. Maximal 15 Artikel (5 Videos und 10 Bilder). Spezifikationen für Werbemedien finden Sie unter [Erweitern Sie Ihr AWS Marketplace Marketplace-Produkt mit Werbemedien](https://docs.aws.amazon.com/marketplace/latest/userguide/promotional-media.html).
+ `Type`(Zeichenfolge) (erforderlich) — Entweder `Image` oder`Video`.
+ `Url`(string) (erforderlich) — Die URL zur Mediendatei. Muss eine direkte S3-URL oder eine vorsignierte S3-URL sein. Max. Länge: 2048 Zeichen. Muss eine HTTPS-URL sein.
+ `Title`(string) (erforderlich) — Der Titel des Mediums. Max. Länge: 100 Zeichen. Darf keine führenden oder abschließenden Leerzeichen, Zeilenumbrüche oder Steuerzeichen enthalten.
+ `Description`(string) (erforderlich) — Die Beschreibung des Mediums. Maximale Länge: 200 Zeichen Darf keine führenden oder abschließenden Leerzeichen oder Steuerzeichen enthalten.
+ `PreviewUrl`(string) (optional) — Nur für Videos die URL zu einem Vorschaubild. Max. Länge: 2048 Zeichen. Muss eine HTTPS-URL sein.
+ `AdditionalResources`(Array von Objekten) — Die Liste der Verweise auf zusätzliche Ressourcen. Maximal 8 Artikel.
+ `Text`(string) — Der Name oder Titel der Ressource. Max. Länge: 500 Zeichen. Darf keine führenden oder abschließenden Leerzeichen, Zeilenumbrüche oder Steuerzeichen enthalten.
+ `Url`(string) — Die URL zur Ressource. Maximale Länge: 2048 Zeichen. Muss eine HTTPS-URL sein.
+ `UseCases`(Array von Objekten) — Die Liste der Anwendungsfälle, die mit dieser Lösung behandelt werden. Max. 3 Artikel. Gültige Anwendungsfallkategorien (eine Kombination aus Gruppe SubGroup, und Element) finden Sie in der [Liste der Anwendungsfallkategorien](https://d1z4dgsxp8pfa2.cloudfront.net/awsmp-solutions/use-case-categories-list.json) für aktive akzeptierte Werte und ihre [Einführungsbezeichnungen](https://d1z4dgsxp8pfa2.cloudfront.net/awsmp-solutions/i18n/en.json). Die Kombination aus Gruppe SubGroup, und Element muss ein gültiges Element in der Liste der Anwendungsfallkategorien sein.
+ `Group`(Zeichenfolge) — Branchen- oder Technologiekategorie. Muss einer der Gruppenwerte in der [Liste der Anwendungsfallkategorien](https://d1z4dgsxp8pfa2.cloudfront.net/awsmp-solutions/use-case-categories-list.json) sein.
+ `SubGroup`(string) — Anwendungsfallgruppe innerhalb der Kategorie. Muss einer der SubGroup Werte in der [Liste der Anwendungsfallkategorien](https://d1z4dgsxp8pfa2.cloudfront.net/awsmp-solutions/use-case-categories-list.json) sein.
+ `Item`(string) — Spezifischer Anwendungsfall. Muss einer der Elementwerte in der [Liste der Anwendungsfallkategorien](https://d1z4dgsxp8pfa2.cloudfront.net/awsmp-solutions/use-case-categories-list.json) sein.
+ `Description`(string) — Beschreibung, wie diese Lösung den Anwendungsfall behandelt. Max. Länge: 500 Zeichen. Darf keine führenden oder abschließenden Leerzeichen oder Steuerzeichen enthalten.
Informationen zu vorsignierten URLs finden Sie unter Objekte mit vorsignierten URLs [gemeinsam nutzen](https://docs.aws.amazon.com/AmazonS3/latest/userguide/ShareObjectPreSignedURL.html).
**Anmerkung**
Beim Aufrufen von UpdateInformation ChangeType können Sie jederzeit eine Teilmenge von Feldern angeben, die im Objekt aktualisiert werden sollen. `DetailsDocument` Bevor Sie jedoch eine Lösung von `Draft` nach verschieben`Limited`, müssen die folgenden Felder korrekt festgelegt werden:`Title`, `ShortDescription``LongDescription`, und`LogoUrl`.
Wenn Sie jedoch vorhandene Felder in der Lösung aktualisieren, können Sie nur die Attribute in das `DetailsDocument` Objekt des Änderungstyps aufnehmen, die `UpdateInformation` geändert werden müssen.
**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. Um den Status der Anfrage zu überprüfen, verwenden Sie das AWS Marketplace Management Portal oder rufen Sie die `DescribeChangeSet` API auf.
Nach dem Auslösen dieses Änderungstyps mit `PromotionalMedia` Ressourcen, die für eine `Public` Lösung geändert wurden, kann es bis zu 37 Tage dauern, bis der Vorgang abgeschlossen ist. Dies beinhaltet die Zeit, die das AWS Marketplace Seller Operations Team zur Überprüfung, Prüfung und Genehmigung benötigt.
**Asynchrone Fehler**
Zusätzlich zu den [häufigen asynchronen Fehlern](#solution-error-codes) sind die folgenden Fehler spezifisch für `UpdateInformation` Aktionen in der AWS Marketplace Catalog API. Diese Fehler werden zurückgegeben, wenn Sie aufrufen, `DescribeChangeSet` nachdem ein Änderungssatz verarbeitet wurde. Weitere Informationen zum Abrufen des Status einer Änderungsanforderung finden Sie unter [Mit Änderungssätzen arbeiten](https://docs.aws.amazon.com/marketplace/latest/APIReference/catalog-apis.html#working-with-change-sets). `DescribeChangeSet`
| Fehlercode | Fehlermeldung |
| --- | --- |
| INVALID\_SHORT\_DESCRIPTION | Die ShortDescription Länge der Lösung ist nicht gültig. Geben Sie einen ShortDescription Wert zwischen 1 und 1000 Zeichen ein, und versuchen Sie es erneut. |
| INVALID\_LONG\_DESCRIPTION | Die LongDescription Länge der Lösung ist nicht gültig. Geben Sie ein Zeichen ein LongDescription , das zwischen 1 und 5000 Zeichen lang ist, und versuchen Sie es erneut. |
| UNGÜLTIGER\_NAME | Die Länge des Lösungsnamens ist nicht gültig. Geben Sie einen Namen ein, der zwischen 1 und 100 Zeichen lang ist, und versuchen Sie es erneut. |
| UNGÜLTIGER TITEL | Die Länge des Lösungstitels ist nicht gültig. Geben Sie einen Titel ein, der zwischen 1 und 255 Zeichen lang ist, und versuchen Sie es erneut. |
| INVALID\_ADDITIONAL\_RESOURCES | Die Lösung AdditionalResources [%d] .Die Textlänge ist nicht gültig. Geben Sie einen Text ein, der zwischen 1 und 500 Zeichen lang ist, und versuchen Sie es erneut. |
| INVALID\_ADDITIONAL\_RESOURCES | Auf die folgenden URLs in den bereitgestellten zusätzlichen Ressourcen kann nicht zugegriffen werden: [%s]. Geben Sie gültige und zugängliche URLs an |
| UNGÜLTIGE\_ZUSÄTZLICHE\_RESSOURCEN | Ein URL-Wert ist erforderlich. Geben Sie einen URL-Wert an und versuchen Sie es erneut. |
| UNGÜLTIGE\_ZUSÄTZLICHE\_RESSOURCEN | Text darf nicht fehlen. Geben Sie einen Text ein |
| UNGÜLTIGER\_USE\_CASE | Die Lösung UseCases [%d]. Die Länge der Beschreibung ist nicht gültig. Geben Sie eine Beschreibung ein, die zwischen 1 und 500 Zeichen lang ist, und versuchen Sie es erneut. |
| INVALID\_USE\_CASE | UseCases[%d] .Group: Die angegebene Gruppe (%s) ist ungültig. Geben Sie eine gültige Gruppe an. |
| INVALID\_USE\_CASE | UseCases[%d]. SubGroup: Die angegebene Gruppe (%s) ist ungültig. Geben Sie eine gültige an SubGroup. |
| INVALID\_USE\_CASE | UseCases[%d] .Item: Der angegebene Artikel (%s) ist ungültig. Geben Sie einen gültigen Artikel an. |
| INVALID\_USE\_CASE | UseCases[%d] .Item: Der angegebene Anwendungsfall ist inaktiv. Geben Sie einen aktiven Anwendungsfall an |
| INVALID\_USE\_CASE | UseCases[%d] .Group: Gruppe darf nicht fehlen. Geben Sie eine Gruppe an. |
| INVALID\_USE\_CASE | UseCases[%d]. SubGroup: SubGroup darf nicht fehlen. Geben Sie eine an SubGroup. |
| INVALID\_USE\_CASE | UseCases[%d] .Artikel: darf nicht fehlen. SubGroup Geben Sie einen Artikel an. |
| INVALID\_MEDIA | Die Lösung PromotionalMedia [%d] .Titellänge ist nicht gültig. Geben Sie einen Titel ein, der zwischen 1 und 100 Zeichen lang ist, und versuchen Sie es erneut. |
| INVALID\_MEDIA | Die Lösung PromotionalMedia [%d]. Die Länge der Beschreibung ist nicht gültig. Geben Sie eine Beschreibung ein, die zwischen 1 und 200 Zeichen lang ist, und versuchen Sie es erneut. |
| INVALID\_MEDIA | Ungültige URL: %s Geben Sie eine neue URL für in S3 gespeicherte Medien an. |
| INVALID\_MEDIA | Auf den Medienstandort kann nicht zugegriffen werden: %s Geben Sie eine neue, zugängliche URL für Medien ein, die an einem der folgenden Speicherorte gespeichert sind: [S3]. |
| INVALID\_MEDIA | Die Bildgröße überschreitet %s. Geben Sie ein Bild an, das unter %s liegt. |
| INVALID\_MEDIA | Die Videogröße überschreitet %s. Geben Sie ein Video an, das unter %s liegt. |
| INVALID\_MEDIA | Die Größe des Logos überschreitet %s. Geben Sie ein Logo an, das unter %s liegt. |
| INVALID\_MEDIA | In %s wurde Malware entdeckt. Stellen Sie Medien ohne Malware bereit. |
| INVALID\_MEDIA | Unangemessener Inhalt: %s erkannt. Stellen Sie Medien ohne unangemessenen Inhalt bereit |
| INVALID\_MEDIA | Expliziter Inhalt in %s: '{ExplicitContent}' erkannt. Stellen Sie Medien ohne expliziten Inhalt bereit. |
| INVALID\_MEDIA | PromotionalMedia[%s] .Url: %s hat kein unterstütztes Format (%s). Verwenden Sie ein wohlgeformtes Bild in einem unterstützten Format: [JPEG, PNG]. |
| INVALID\_MEDIA | PromotionalMedia[%s] .Url: %s hat kein unterstütztes Format (%s). Verwenden Sie ein wohlgeformtes Video in einem unterstützten Format: [MP4, MOV]. |
| INVALID\_MEDIA | LogoUrl hat bei %s ein ungültiges Seitenverhältnis. Stellen Sie ein Bild mit einem Seitenverhältnis von 1:1 (quadratisch) oder 2:1 (breit) bereit. |
| INVALID\_MEDIA | Das Logo: %s hat ungültige Abmessungen. Stellen Sie ein Bild zwischen 120x120 und 1080x1080 Pixeln bereit. |
| INVALID\_MEDIA | PromotionalMedia[%d] .Type wird nicht unterstützt. Geben Sie PromotionalMedia einen unterstützten Typ an: %s |
| DUPLICATE\_MEDIA | Doppelte Medien erkannt: [%s] Stellt Medienelemente ohne Duplikate bereit. |
| INVALID\_MEDIA | PromotionalMedia[%d] .Url: In %s wurde Malware entdeckt. Stellen Sie Medien ohne Malware bereit. |
| ZU VIELE\_ARTIKEL | Geben Sie nicht mehr als %d %s an. |
## Aktualisieren Sie verwandte Produkte
Sie können die Catalog API verwenden, um die in Ihrer Lösung enthaltenen Produkte und Services zu aktualisieren, einschließlich AWS Marketplace Marketplace-Produkte und Produkte, die nicht von AWS Marketplace stammen.
Um verwandte Produkte zu aktualisieren, rufen Sie den `StartChangeSet` API-Vorgang mit dem `UpdateRelatedProducts` Änderungstyp auf, wie im folgenden Beispiel gezeigt.
**Anmerkung**
Der `UpdateRelatedProducts` Änderungstyp verhält sich wie ein HTTP-PATCH-Vorgang für Attribute der obersten Ebene. Sie können alle aktuellen AWS Marketplace Marketplace-Produkttypen wie folgt `AwsMarketplaceProducts` bereitstellen`UpdateRelatedProducts`.
**Anforderungssyntax**
```
POST /StartChangeSet HTTP/1.1
Content-type: application/json
{
"Catalog": "AWSMarketplace",
"ChangeSet": [
{
"ChangeType": "UpdateRelatedProducts",
"Entity": {
"Type": "Solution@1.0",
"Identifier": "soln-123456"
},
"DetailsDocument": {
"IntegrationDescription": "How to use the products in this solution (usage guide)",
"AwsMarketplaceProducts": [
{
"ProductId": "prod-123"
},
{
"ProductId": "prod-456"
}
],
"NonAwsMarketplaceProducts": [
{
"Type": "Hardware",
"Title": "Diamond engine",
"Description": "Hardware details",
"Url": "https://example.com/hardware-product-specs.html"
}
]
}
}
]
}
```
Geben Sie Informationen für die Felder an, um den `UpdateRelatedProducts` Änderungstyp hinzuzufügen:
+ `Entity`(Objekt) (erforderlich) — Der benannte Typ der Entität, die aktualisiert wird.
+ `Identifier`(string) (erforderlich) — Die Lösungs-ID.
+ `Type`(string) (erforderlich) — Muss sein`Solution@1.0`.
+ `DetailsDocument`(object) (erforderlich) — Die Details der Anfrage. Jedes Feld ist optional, aber Sie müssen mindestens eine Änderung vornehmen, um es zu aktualisieren.
+ `IntegrationDescription`(string) — Beschreibung, wie die Produkte in dieser Lösung zusammenarbeiten. Max. Länge: 5000 Zeichen. Darf keine führenden oder nachfolgenden Leerzeichen oder Steuerzeichen enthalten.
+ `AwsMarketplaceProducts`(Reihe von Objekten) — AWS Marketplace Marketplace-Produkte, die in dieser Lösung enthalten sind. Max. 5 Artikel
+ `ProductId`(string) — AWS Marketplace Marketplace-Produkt-ID (eine UUID oder eine Zeichenfolge, die mit `prod-` beginnt). Max. Länge: 50 Zeichen.
+ `NonAwsMarketplaceProducts`(Array von Objekten) — Produkte, die nicht auf AWS Marketplace verfügbar sind. Maximal 5 Artikel.
+ `Type`(string) (erforderlich) — Typ des Produkts. Mögliche Werte:`Software`,`Consulting`,`Hardware`,`Communication`,`Professional Service`,`Managed Service`,`Value-Added Resale`, `Training`
+ `Title`(string) (erforderlich) — Titel des Produkts. Max. Länge: 255 Zeichen. Darf keine führenden oder abschließenden Leerzeichen, Zeilenumbrüche oder Steuerzeichen enthalten.
+ `Description`(string) (optional) — Beschreibung des Produkts. Max. Länge: 220 Zeichen. Darf keine führenden oder nachfolgenden Leerzeichen oder Steuerzeichen enthalten.
+ `Url`(string) (optional) — URL zu weiteren Informationen über das Produkt. Max. Länge: 2048 Zeichen. Muss eine HTTPS-URL sein.
**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.
Um den Status der Anfrage zu überprüfen, verwenden Sie das AWS Marketplace Management Portal oder rufen Sie die `DescribeChangeSet` API auf.
**Asynchrone Fehler**
Zusätzlich zu den [häufigen asynchronen Fehlern](#solution-error-codes) sind die folgenden Fehler spezifisch für `UpdateRelatedProducts` Aktionen in der AWS Marketplace Catalog API. Diese Fehler werden zurückgegeben, wenn Sie aufrufen, `DescribeChangeSet` nachdem ein Änderungssatz verarbeitet wurde. Weitere Informationen zum Abrufen des Status einer Änderungsanforderung finden Sie unter [Mit Änderungssätzen arbeiten](https://docs.aws.amazon.com/marketplace/latest/APIReference/catalog-apis.html#working-with-change-sets). `DescribeChangeSet`
| Fehlercode | Fehlermeldung |
| --- | --- |
| INCOMPATIBLE\_OPERATION\_UPDATE\_RELATED\_PRODUCTS\_SOLUTION | Der Vorgang zum Aktualisieren verwandter Produkte wird für öffentliche Lösungen nicht unterstützt. Um diese Änderung vorzunehmen, setzen Sie zunächst die Sichtbarkeit der Lösung auf Eingeschränkt und versuchen Sie es erneut. |
| UNGÜLTIG\_ AWS\_MARKETPLACE\_PRODUCTS | Das AWS Marketplace Marketplace-Produkt '%s' ist für Ihr Konto nicht verfügbar. Wählen Sie ein öffentliches Produkt oder ein limitiertes Produkt, für das Sie Zugriff auf die Zulassungsliste haben, oder wenden Sie sich an den Verkäufer, um Zugriff zu beantragen. |
| UNGÜLTIG\_ AWS\_MARKETPLACE\_PRODUCTS | Der angegebene Produkttyp '%s' wird nicht unterstützt. Geben Sie einen der folgenden gültigen Produkttypen an: [AmiProduct, SaasProduct,,, ContainerProduct MachineLearningProduct ProfessionalServicesProduct, DataProduct] und versuchen Sie es erneut. |
| UNGÜLTIG\_ AWS\_MARKETPLACE\_PRODUCTS | Produkt '%s' wurde nicht gefunden. Geben Sie eine gültige Produkt-ID im selben Katalog ein. |
| UNGÜLTIG\_NON\_ AWS\_MARKETPLACE\_PRODUCTS | Auf die angegebenen Non-AWS Marketplace-Produkt-URLs kann nicht zugegriffen werden: [%s]. Stellen Sie sicher, dass die URLs gültig und öffentlich zugänglich sind, und versuchen Sie es erneut. |
| INVALID\_INTEGRATION\_DESCRIPTION | Geben Sie eine Lösung mit einer Länge IntegrationDescription zwischen 1 und 5000 Zeichen an. |
| UNGÜLTIG\_NON\_ AWS\_MARKETPLACE\_PRODUCTS | Die Lösung NonAwsMarketplaceProduct [%d] .Titellänge ist nicht gültig. Geben Sie eine Beschreibung ein, die zwischen 1 und 255 Zeichen lang ist, und versuchen Sie es erneut. |
| UNGÜLTIG\_NON\_ AWS\_MARKETPLACE\_PRODUCTS | Die Lösung NonAwsMarketplaceProduct [%d]. Die Länge der Beschreibung ist nicht gültig. Geben Sie eine Beschreibung ein, die zwischen 1 und 220 Zeichen lang ist, und versuchen Sie es erneut. |
| UNGÜLTIG\_NON\_ AWS\_MARKETPLACE\_PRODUCTS | Die Lösung NonAwsMarketplaceProduct [%d]. Die Länge des Typs ist nicht gültig. Geben Sie einen Typ ein, der zwischen 1 und 50 Zeichen lang ist, und versuchen Sie es erneut. |
| UNGÜLTIG\_NON\_ AWS\_MARKETPLACE\_PRODUCTS | NonAwsMarketplaceProduct[%d] .Type ist kein gültiger Produkttyp, der nicht von AWS Marketplace stammt. Stellen Sie einen der folgenden Nicht-AWS-Marketplace-Produkttypen bereit: [%s] |
| UNGÜLTIG\_NON\_ AWS\_MARKETPLACE\_PRODUCTS | Ein Wert von NonAwsMarketplaceProduct [%d] .Title ist erforderlich. Geben Sie einen Titelwert an und versuchen Sie es erneut. |
| UNGÜLTIG\_NON\_ AWS\_MARKETPLACE\_PRODUCTS | Ein Wert vom NonAwsMarketplaceProduct Typ [%d] .Type ist erforderlich. Geben Sie einen Type-Wert an und versuchen Sie es erneut. |
| ZU VIELE\_PRODUKTE | Die maximale Anzahl von AWS Marketplace Marketplace-Produkten, die Sie verknüpfen können, ist %d. Entfernen Sie vorhandene verknüpfte Produkte, bevor Sie neue hinzufügen. |
| ZU VIELE\_PRODUKTE | Die maximale Anzahl von Produkten ohne AWS Marketplace, die Sie hinzufügen können, ist %d. Entfernen Sie vorhandene Produkte ohne AWS Marketplace, bevor Sie neue hinzufügen. |
| UNGÜLTIG\_ AWS\_MARKETPLACE\_PRODUCTS | Doppelte AWS Marketplace Marketplace-Produkt-IDs sind nicht zulässig. Jede Produkt-ID muss in Ihrer Lösung einzigartig sein. |
| INVALID\_REMOVE\_OPERATION | Ungültiger Vorgang. Sie können nicht alle Produkte entfernen. |
## Eine Lösung veröffentlichen
Sie können die Catalog API verwenden, um eine `Draft` Lösung `Limited` sichtbar im AWS Marketplace zu veröffentlichen.
Der `ReleaseSolution` Änderungstyp bestätigt, dass alle erforderlichen Felder für eine `Limited` Lösung vorhanden sind. Anschließend wird die Lösung aus dem Bereich `Limited` Sichtbarkeit `Draft` verschoben. Sobald eine Lösung `Limited` sichtbar ist, können Sie sie nicht wieder `Draft` sichtbar machen.
Um eine Lösung freizugeben, rufen Sie den `StartChangeSet` API-Vorgang mit dem `ReleaseSolution` Änderungstyp auf, wie im folgenden Beispiel gezeigt.
**Anforderungssyntax**
```
POST /StartChangeSet HTTP/1.1
Content-type: application/json
{
"Catalog": "AWSMarketplace",
"ChangeSet": [
{
"ChangeType": "ReleaseSolution",
"Entity": {
"Type": "Solution@1.0",
"Identifier": "soln-1234abcd"
},
"DetailsDocument": {}
}
]
}
```
Geben Sie Informationen für die Felder an, um den `ReleaseSolution` Änderungstyp hinzuzufügen:
+ `Entity`(Objekt) (erforderlich) — Der benannte Entitätstyp, der veröffentlicht wird.
+ `Identifier`(string) (erforderlich) — Die Lösungs-ID.
+ `Type`(string) (erforderlich) — Muss sein`Solution@1.0`.
+ `DetailsDocument`(object) (erforderlich) — Muss ein leeres Objekt sein. Der Änderungstyp `ReleaseSolution` akzeptiert keine Details.
**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. 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**
Zusätzlich zu den [häufigen asynchronen Fehlern](#solution-error-codes) sind die folgenden Fehler spezifisch für `ReleaseSolution` Aktionen in der AWS Marketplace Catalog API. Diese Fehler werden zurückgegeben, wenn Sie aufrufen, `DescribeChangeSet` nachdem ein Änderungssatz verarbeitet wurde. Weitere Informationen zum Abrufen des Status einer Änderungsanforderung finden Sie unter [Mit Änderungssätzen arbeiten](https://docs.aws.amazon.com/marketplace/latest/APIReference/catalog-apis.html#working-with-change-sets). `DescribeChangeSet`
| Fehlercode | Fehlermeldung |
| --- | --- |
| MISSING\_REQUIRED\_FIELDS | In der Anfrage fehlen die erforderlichen Parameter: [%s]. Geben Sie Werte für alle erforderlichen Parameter an, und versuchen Sie es erneut. |
| INCOMPATIBLE\_OPERATION\_RELEASE\_SOLUTION | Der Änderungstyp kann nur für Lösungen im Status Entwurf aufgerufen werden. Ändern Sie die Sichtbarkeit der Lösung auf Entwurf und versuchen Sie es erneut. |
## Aktualisieren Sie die Optionen zur Käuferbindung
Sie können die Katalog-API verwenden, um zu konfigurieren, wie Käufer mit Ihnen über Ihre Lösung sprechen.
**Anmerkung**
Um diesen Änderungstyp verwenden zu können, müssen Sie sich aktiv für das [APN Customer Engagements (](https://aws.amazon.com/partners/programs/ace/)ACE) -Programm angemeldet haben. Sie müssen Ihr AWS-Konto auch mit Ihrem AWS Partner Central-Konto verknüpfen, das bei ACE registriert ist. Anweisungen finden Sie unter [Verknüpfen von AWS Partner Central- und AWS-Konten](https://docs.aws.amazon.com/partner-central/latest/getting-started/account-linking.html).
Um die Optionen für die Kundenbindung zu aktualisieren, rufen Sie den `StartChangeSet` API-Vorgang mit dem `UpdateBuyerEngagementOptions` Änderungstyp auf, wie im folgenden Beispiel gezeigt.
**Anforderungssyntax**
```
POST /StartChangeSet HTTP/1.1
Content-type: application/json
{
"Catalog": "AWSMarketplace",
"ChangeSet": [
{
"ChangeType": "UpdateBuyerEngagementOptions",
"Entity": {
"Type": "Solution@1.0",
"Identifier": "soln-1234abcd"
},
"DetailsDocument": [
{
"EngagementOption": "RequestProductDemo"
},
{
"EngagementOption": "RequestPrivateOffer"
}
]
}
]
}
```
Geben Sie Informationen für die Felder an, um den `UpdateBuyerEngagementOptions` Änderungstyp hinzuzufügen:
+ `Entity`(Objekt) (erforderlich) — Der benannte Typ der Entität, die aktualisiert wird.
+ `Identifier`(string) (erforderlich) — Die Lösungs-ID.
+ `Type`(string) (erforderlich) — Muss sein`Solution@1.0`.
+ `DetailsDocument`(Reihe von Objekten) (erforderlich) — Die Optionen zur Kundenbindung, die aktiviert werden sollen.
+ `EngagementOption`(string) (erforderlich) — Die Art der Interaktionsoption. Zulässige Werte: `RequestPrivateOffer`, `RequestProductDemo`.
**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.
Um den Status der Anfrage zu überprüfen, verwenden Sie das AWS Marketplace Management Portal oder rufen Sie die `DescribeChangeSet` API auf.
**Asynchrone Fehler**
Zusätzlich zu den [häufigen asynchronen Fehlern](#solution-error-codes) sind die folgenden Fehler spezifisch für `UpdateBuyerEngagementOptions` Aktionen in der AWS Marketplace Catalog API. Diese Fehler werden zurückgegeben, wenn Sie aufrufen, `DescribeChangeSet` nachdem ein Änderungssatz verarbeitet wurde. Weitere Informationen zum Abrufen des Status einer Änderungsanforderung finden Sie unter [Mit Änderungssätzen arbeiten](https://docs.aws.amazon.com/marketplace/latest/APIReference/catalog-apis.html#working-with-change-sets). `DescribeChangeSet`
| Fehlercode | Fehlermeldung |
| --- | --- |
| INELIGIBLE\_SELLER | Die Überprüfung der ACE-Eignung ist nicht abgeschlossen. Um fortzufahren: 1) Verknüpfen Sie Ihr AWS Marketplace Marketplace-Konto mit Ihrem APN-Konto, 2) Erfüllen Sie die ACE-Zulassungsvoraussetzungen. |
## Aktualisieren Sie die Sichtbarkeit der Lösung
Sie können die Catalog API verwenden, um die Sichtbarkeit einer Lösung im AWS Marketplace zu aktualisieren.
Sie können die Zielsichtbarkeit auf `Limited``Public`, oder `Restricted` festlegen.
+ **`Limited`**— Die Lösung ist abgeschlossen und der `ReleaseSolution` Änderungstyp wurde erfolgreich abgeschlossen. In dieser Ansicht können Sie eine Vorschau der Informationen zur Lösung auf der Website des Käufers anzeigen. Auf der AWS Marketplace-Käuferwebsite ist die Lösung nur für das Eigentümerkonto, die Eigentümer der einzelnen AWS Marketplace Marketplace-Produkte, die in der Lösung enthalten sind, und das AWS Marketplace Seller Operations Team sichtbar.
+ **`Public`**— Die Lösung ist auf dem AWS Marketplace sichtbar. Käufer können sich die Lösung ansehen und mit ihr interagieren.
+ **`Restricted`**— Die Lösung ist auf der Käuferwebsite von AWS Marketplace nicht mehr öffentlich sichtbar.
**Anmerkung**
Um eine Lösung `Public` sichtbar zu machen, müssen Sie die folgenden Anforderungen erfüllen:
Sie müssen über ein öffentliches Profil auf AWS Marketplace verfügen.
Die Lösung darf keine Produkte enthalten, die keine `Public` Produkte sind.
Die Lösung muss mindestens 2 `Public` AWS Marketplace Marketplace-Produkte enthalten.
Die Lösung muss mindestens ein AWS Marketplace Marketplace-Produkt aus demselben AWS-Konto enthalten.
Für die Lösung muss die Option `RequestPrivateOffer` zur Kundenbindung aktiviert sein.
Das AWS Marketplace Seller Operations Team prüft alle Anfragen, um eine Lösung `Public` sichtbar zu machen. Support finden Sie unter [Support für AWS Marketplace erhalten](https://docs.aws.amazon.com/marketplace/latest/buyerguide/getting-support.html).
Wenn Sie `TargetVisibility` diese Option wählen`Public`, muss der `UpdateVisibility` Änderungstyp manuell vom AWS Marketplace Seller Operations Team überprüft werden. Dies erhöht die Ausführungszeit. Wird `UpdateVisibility` separat in einem eigenen Änderungssatz verwendet.
Um die Sichtbarkeit Ihrer Lösung zu aktualisieren, rufen Sie den `StartChangeSet` API-Vorgang mit dem `UpdateVisibility` Änderungstyp auf, wie im folgenden Beispiel gezeigt.
**Anforderungssyntax**
Für wann `TargetVisibility` ist `Public` oder`Limited`.
```
POST /StartChangeSet HTTP/1.1
Content-type: application/json
{
"Catalog": "AWSMarketplace",
"ChangeSet": [
{
"ChangeType": "UpdateVisibility",
"Entity": {
"Type": "Solution@1.0",
"Identifier": "soln-1234abcd"
},
"DetailsDocument": {
"TargetVisibility": "Public"
}
}
]
}
```
Für wann `TargetVisibility` ist`Restricted`.
```
POST /StartChangeSet HTTP/1.1
Content-type: application/json
{
"Catalog": "AWSMarketplace",
"ChangeSet": [
{
"ChangeType": "UpdateVisibility",
"Entity": {
"Type": "Solution@1.0",
"Identifier": "soln-1234abcd"
},
"DetailsDocument": {
"TargetVisibility": "Restricted"
}
}
]
}
```
Geben Sie Informationen für die Felder an, um den `UpdateVisibility` Änderungstyp hinzuzufügen:
+ `Entity`(Objekt) (erforderlich) — Der benannte Typ der Entität, die aktualisiert wird.
+ `Identifier`(string) (erforderlich) — Die Lösungs-ID.
+ `Type`(string) (erforderlich) — Muss sein`Solution@1.0`.
+ `DetailsDocument`(object) (erforderlich) — Die Details, die zur Ausführung des Änderungssatzes erforderlich sind.
+ `TargetVisibility`(string) (erforderlich) — Die beabsichtigte neue Sichtbarkeit der Lösung. Die möglichen Werte lauten: `Public`, `Limited` und `Restricted`.
**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.
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.
Nachdem Sie diesen Änderungstyp mit `TargetVisibility` as ausgelöst haben`Public`, kann es bis zu 37 Tage dauern, bis der Vorgang abgeschlossen ist. Dies beinhaltet die Zeit, die das AWS Marketplace Seller Operations Team zur Überprüfung, Prüfung und Genehmigung benötigt.
**Asynchrone Fehler**
Die folgenden Fehler beziehen sich spezifisch auf `UpdateVisibility` Aktionen in der AWS Marketplace Catalog API. Diese Fehler werden zurückgegeben, wenn Sie aufrufen, `DescribeChangeSet` nachdem ein Änderungssatz verarbeitet wurde. Weitere Informationen zum Abrufen des Status einer Änderungsanforderung finden Sie unter [Mit Änderungssätzen arbeiten](https://docs.aws.amazon.com/marketplace/latest/APIReference/catalog-apis.html#working-with-change-sets). `DescribeChangeSet`
| Fehlercode | Fehlermeldung |
| --- | --- |
| INVALID\_VISIBILITY\_TRANSITION | Die Lösung kann nicht in den Status Entwurf zurückversetzt werden. Nach der Veröffentlichung können Lösungen nur zwischen dem Status „Eingeschränkt“, „Öffentlich“ und „Eingeschränkt“ wechseln. |
| ZU WENIGE ANWENDUNGSFÄLLE | Mindestens ein Anwendungsfall ist erforderlich, um eine Lösung zu veröffentlichen. Fügen Sie einen Anwendungsfall hinzu und versuchen Sie es erneut. |
| ZU WENIGE ÖFFENTLICHE PRODUKTE | Es sind mindestens 2 öffentliche AWS Marketplace Marketplace-Produkte erforderlich, um eine Lösung zu veröffentlichen. Fügen Sie die erforderlichen Produkte hinzu und versuchen Sie es erneut. |
| INKOMPATIBLE\_PRODUCTS | Die Lösung enthält ein oder mehrere nicht öffentliche AWS Marketplace Marketplace-Produkte. Um die Lösung zu veröffentlichen, entfernen Sie alle nicht öffentlichen Produkte und versuchen Sie es erneut. |
| ZU WENIGE PRODUKTE, DIE SICH SELBST GEHÖREN | Für die Lösung ist mindestens ein AWS Marketplace Marketplace-Produkt erforderlich, das dem Eigentümer der Lösung gehört. Fügen Sie ein AWS Marketplace Marketplace-Produkt aus Ihrem Konto hinzu und versuchen Sie es erneut. |
| INCOMPATIBLE\_BUYER\_ENGAGEMENT\_OPTIONS | Die Option zur Kundenbindung muss aktiviert sein, um RequestPrivateOffer diese Lösung öffentlich zugänglich zu machen. Aktivieren Sie RequestPrivateOffer und versuchen Sie es erneut. |
| INCOMPATIBLE\_OPERATION\_UPDATE\_VISIBILITY | UpdateVisibility wird für Lösungen im Status Entwurf nicht unterstützt. Veröffentlichen Sie die Lösung zuerst von „Entwurf“ in „Eingeschränkt“ und verwenden Sie sie dann ReleaseSolution, UpdateVisibility um zu „Öffentlich“ oder „Eingeschränkt“ zu wechseln. |
| LIMIT\_EXCEEDED\_TOO\_MANY\_PUBLIC\_SOLUTIONS | Dieses Konto hat sein Limit von 5 öffentlichen Lösungen erreicht. Aktualisieren Sie eine bestehende öffentliche Lösung auf Eingeschränkte oder Eingeschränkte Sichtbarkeit und versuchen Sie es erneut. |
| FEHLENDE ANGABEN ZUM VERKÄUFERPROFIL | Ein öffentliches Verkäuferprofil ist erforderlich, um Lösungen zu veröffentlichen. Erstellen Sie in Ihrem Verkäuferkonto ein öffentliches Profil und versuchen Sie es erneut. |
## Häufige asynchrone Fehlercodes
Es gibt einige asynchrone Validierungen, die für alle Arten von Lösungsänderungen gelten, z. B. Prüfungen auf URL-Gültigkeit und nicht unterstützte Zeichen. Die zugehörigen Fehlercodes und Fehlermeldungen sind hier aufgeführt.
Jedes bereitgestellte URL-Feld muss das HTTPS-Protokoll verwenden und den Standards RFC2396 oder RFC 2732 entsprechen.
| Fehlercode | Fehlermeldung |
| --- | --- |
| UNGÜLTIGE\_EINGABE | Ungültiges Feld '%s' Nicht unterstützte Zeichen %s entfernen. |
| UNGÜLTIGE\_EINGABE | Unangemessener Inhalt '%s' wurde im Feld %s gefunden. Geben Sie %s ohne unangemessenen Inhalt ein. |
| UNSUPPORTED\_CATALOG | Der angeforderte Katalog %s wird von diesem Änderungstyp nicht unterstützt. |
| INVALID\_REMOVE\_OPERATION | Ungültiger Vorgang, Sie können %s nicht entfernen |
| AUDIT\_ERROR | (variiert je nach Prüfungsergebnis des AWS Marketplace Seller Operations Teams) |
## Lebenszyklus der Lösung
Lösungen werden anhand der folgenden Sichtbarkeitswerte weiterentwickelt:
+ `Draft`- Erste Sichtbarkeit nach der Erstellung. Mithilfe anderer Änderungstypen können Sie schrittweise Informationen hinzufügen.
+ `Limited`- Die Lösung ist vollständig und kann von Ihnen und den Produktbesitzern als Vorschau angesehen werden. Dies erreichen Sie durch die Verwendung von`ReleaseSolution`.
+ `Public`- Die Lösung ist für alle Käufer sichtbar, die die AWS Marketplace Marketplace-Website besuchen. Dies erfordert eine zusätzliche Validierung.
+ `Restricted`- Die Lösung ist für neue Käufer nicht mehr sichtbar.
**Wichtig**
Sobald eine Lösung von `Draft` der `Limited` Sichtbarkeit zurückgegangen ist, können Sie sie nicht wieder in den Bereich „Sichtbarkeit“ verschieben`Draft`. `ReleaseSolution`überprüft vor dem Übergang zur `Limited` Sichtbarkeit, ob alle erforderlichen Felder für eine `Limited` Lösung vorhanden sind.
### Mindestanforderungen für eine Komplettlösung
Um eine vollständige Lösung zu erstellen und sie über den Status Entwurf hinaus zu veröffentlichen, benötigen Sie die folgenden Änderungstypen und Attribute:
+ **`CreateSolution`**: `Name`
+ **`UpdateInformation`**: `Title`, `ShortDescription`, `LongDescription`, `LogoUrl`
+ **`UpdateRelatedProducts`**:`IntegrationDescription`, mindestens ein Element quer durch `AwsMarketplaceProducts` und `NonAwsMarketplaceProducts`
+ **`ReleaseSolution`**
Das folgende Beispiel zeigt Ihnen, wie Sie eine vollständige Lösung mit `Limited` Sichtbarkeit in einem einzigen Änderungssatz erstellen:
```
{
"Catalog": "AWSMarketplace",
"ChangeSet": [
{
"ChangeType": "CreateSolution",
"Entity": {
"Type": "Solution@1.0"
},
"ChangeName": "CreateSolutionChange",
"DetailsDocument": {
"Name": "complete_solution_example",
"Title": "Complete Solution Example"
}
},
{
"ChangeType": "UpdateInformation",
"Entity": {
"Type": "Solution@1.0",
"Identifier": "$CreateSolutionChange.Entity.Identifier"
},
"ChangeName": "UpdateInformationChange",
"DetailsDocument": {
"ShortDescription": "A comprehensive solution for customer needs",
"LongDescription": "This solution combines multiple products to address specific customer requirements in the advertising and marketing space.",
"LogoUrl": "https://s3.amazonaws.com/awsmp-logos/solution-logo.jpg",
"UseCases": [
{
"Group": "advertising_and_marketing",
"SubGroup": "ad_intelligence_and_measurement",
"Item": "amazon_ads_insights",
"Description": "Provides comprehensive advertising insights and measurement capabilities"
}
]
}
},
{
"ChangeType": "UpdateRelatedProducts",
"Entity": {
"Type": "Solution@1.0",
"Identifier": "$CreateSolutionChange.Entity.Identifier"
},
"ChangeName": "UpdateRelatedProductsChange",
"DetailsDocument": {
"AwsMarketplaceProducts": [
{
"ProductId": "prod-123"
}
],
"IntegrationDescription": "These products work together to provide end-to-end advertising analytics and optimization capabilities."
}
},
{
"ChangeType": "UpdateBuyerEngagementOptions",
"Entity": {
"Type": "Solution@1.0",
"Identifier": "$CreateSolutionChange.Entity.Identifier"
},
"ChangeName": "UpdateBuyerEngagementChange",
"DetailsDocument": [
{
"EngagementOption": "RequestPrivateOffer"
}
]
},
{
"ChangeType": "ReleaseSolution",
"Entity": {
"Type": "Solution@1.0",
"Identifier": "$CreateSolutionChange.Entity.Identifier"
},
"ChangeName": "ReleaseSolutionChange",
"DetailsDocument": {}
}
]
}
```
## IAM-Berechtigungen für Lösungen
Die AWS Marketplace Catalog API verwendet Standard-IAM-Berechtigungen. 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 können `AWSMarketplaceSellerProductFullAccess` damit alle Vorgänge ausführen, die für den Zugriff auf die Lösung über die Catalog API und Partner Central 3.0 in der AWS-Managementkonsole erforderlich sind.
### Beispiel für eine IAM-Richtlinie für Lösungen
Die folgende Beispiel-IAM-Richtlinie ermöglicht bestimmte Aktionen (`DescribeEntity``ListEntities`, und`StartChangeSet`) für die Entität. `Solution@1.0` Sie können sie weiter eingrenzen, um den Zugriff eines Prinzipals auf bestimmte Änderungstypen für bestimmte Entitäts-IDs einzuschränken, oder sie erweitern, sodass ein Principal auch mit einem anderen Entitätstyp arbeiten kann, der von der Catalog API unterstützt wird.
```
{
"Statement": [
{
"Effect": "Allow",
"Action": [
"aws-marketplace:StartChangeSet"
],
"Resource": [
"arn:aws:aws-marketplace:us-east-1:123456789012:AWSMarketplace/Solution/*",
"arn:aws:aws-marketplace:us-east-1:123456789012:AWSMarketplace/ChangeSet/*"
],
"Condition": {
"StringEquals": {
"catalog:ChangeType": [
"CreateSolution",
"UpdateInformation",
"UpdateRelatedProducts",
"ReleaseSolution",
"UpdateBuyerEngagementOptions",
"UpdateVisibility"
]
}
}
},
{
"Effect": "Allow",
"Action": [
"aws-marketplace:ListEntities",
"aws-marketplace:DescribeEntity"
],
"Resource": [
"arn:aws:aws-marketplace:us-east-1:123456789012:AWSMarketplace/Solution/*"
]
},
{
"Effect": "Allow",
"Action": [
"aws-marketplace:DescribeChangeSet",
"aws-marketplace:ListChangeSets",
"aws-marketplace:CancelChangeSet"
],
"Resource": [
"arn:aws:aws-marketplace:us-east-1:123456789012:AWSMarketplace/ChangeSet/*"
]
},
{
"Effect": "Allow",
"Action": [
"aws-marketplace:TagResource",
"aws-marketplace:UntagResource",
"aws-marketplace:ListTagsForResource"
],
"Resource": [
"arn:aws:aws-marketplace:us-east-1:123456789012:AWSMarketplace/Solution/*",
"arn:aws:aws-marketplace:us-east-1:123456789012:AWSMarketplace/ChangeSet/*"
]
}
]
}
```
### Beschränken Sie den Zugriff auf bestimmte Lösungen
Sie können den Zugriff auf bestimmte Lösungen einschränken, indem Sie die Lösungs-ID im Ressourcen-ARN verwenden:
```
{
"Statement": [
{
"Effect": "Allow",
"Action": [
"aws-marketplace:DescribeEntity",
"aws-marketplace:StartChangeSet"
],
"Resource": [
"arn:aws:aws-marketplace:us-east-1:123456789012:AWSMarketplace/Solution/soln-specific123"
]
}
]
}
```
### Beschränken Sie den Zugriff auf bestimmte Änderungstypen
Sie können den Zugriff auf bestimmte Änderungstypen mithilfe von Bedingungsschlüsseln einschränken:
```
{
"Statement": [
{
"Effect": "Allow",
"Action": [
"aws-marketplace:StartChangeSet"
],
"Resource": [
"arn:aws:aws-marketplace:us-east-1:123456789012:AWSMarketplace/Solution/*"
],
"Condition": {
"StringEquals": {
"catalog:ChangeType": [
"UpdateInformation",
"UpdateRelatedProducts"
]
}
}
}
]
}
```