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.
# Arbeiten Sie mit Verkäuferprodukten
Sie können das verwenden AWS Marketplace Catalog API , um Aufgaben für die Arbeit mit Verkäuferprodukten zu automatisieren. Dazu gehört die Möglichkeit, Produkte zu erstellen, zu aktualisieren, anzuzeigen, aufzulisten und zu sortieren. Auf diese Weise können Sie das Produktmanagement automatisieren. Sie können beispielsweise Self-Service-Veröffentlichungsfunktionen auf dem AWS Marketplace Management Portal bereitstellen.
Ein *Produkt* ist eine Einheit oder Ressource, in der Sie verkaufen möchten. AWS Marketplace Dies wird häufig als Basisprodukt bezeichnet. Käufer können ein Basisprodukt erst nutzen, wenn Sie Produktinformationen, Bereitstellungsmerkmale und Rechnungsinformationen hinzugefügt haben.
Ein *Produkt* beschreibt die Produktinformationen, die Merkmale der Softwarebereitstellung und den Abrechnungsmechanismus des Angebots, das Sie verkaufen möchten. Das *Produkt* muss mit einem *Angebot* kombiniert werden, um zu einer Transaktionseinheit zu werden, die Sie verkaufen und in der Käufer verwenden können. AWS Marketplace
Sie können das auch verwenden, um: AWS Marketplace Catalog API
+ [Arbeiten Sie mit privaten Angeboten mit dem AWS Marketplace APIs](work-with-private-offers.md)
+ [Arbeiten Sie mit Wiederverkaufsberechtigungen unter Verwendung der AWS Marketplace APIs](work-with-resale-authorizations.md)
+ [Arbeiten Sie mit privaten Angeboten von Channel-Partnern zusammen, indem Sie den AWS Marketplace APIs](work-with-cppos.md)
Jeder Produkttyp hat eine andere Produkteinheit. Bei einer *Entität* kann es sich um ein Produkt oder ein Angebot handeln AWS Marketplace. Die folgenden Produkttypen und Entitäten werden unterstützt:
| Produkttyp | Entität |
| --- | --- |
| Produkte von Amazon Machine Image (AMI) | AmiProduct@1.0 |
| Container-Produkte | ContainerProduct@1.0 |
| Software-as-a-Service (SaaS) -Produkte | SaaSProduct@1.0 |
| Produkte für maschinelles Lernen (ML) | MachineLearningProduct@1.0 |
**Anmerkung**
Single-AMI Produkte mit CloudFormation Produkttypen, AWS Data Exchange Datenprodukten und professionellen Dienstleistungen werden nicht unterstützt.
Bei den folgenden Themen wird davon ausgegangen, dass Sie Zugriff auf die API haben und alle Voraussetzungen für Verkäufer erfüllt haben, wie unter beschrieben[Zugriffskontrolle für die AWS Marketplace Catalog-API](catalog-api-access-control.md).
Weitere Informationen finden Sie in den folgenden Ressourcen:
+ Informationen zu den Grundlagen der Verwendung der AWS Marketplace Katalog-API finden Sie unter[Verwendung der AWS Marketplace Catalog-API](catalog-apis.md).
+ Umfassende Übungen mit funktionierenden Codebeispielen finden Sie unter [Produkte mit API verwalten](https://catalog.workshops.aws/mpseller/en-US/manage-products-with-api) im *AWS Marketplace Verkäuferworkshop*.
+ Codebeispiele für API-Anfragen finden Sie unter [Python](https://github.com/aws-samples/aws-marketplace-reference-code/tree/main/python/src/catalog_api/products) - und [Java-Beispiele](https://github.com/aws-samples/aws-marketplace-reference-code/tree/main/java/resources/changeSets/products) unter *AWS Beispiele* am GitHub.
In den folgenden Themen wird beschrieben, wie Sie die Catalog API verwenden, um Aktionen für Ihre Single-AMI-Produkte, containerbasierten Produkte oder SaaS-Produkte durchzuführen.
**Topics**
+ [Erstellen Sie ein Produkt](#create-product)
+ [Produktdetails aktualisieren](#update-information)
+ [Fügen Sie Preisdimensionen hinzu](#add-dimensions)
+ [Preisdimensionen aktualisieren](#update-dimensions)
+ [Beschränken Sie die Preisdimensionen](#restrict-dimensions)
+ [Targeting-Konfiguration aktualisieren](#update-targeting)
+ [Aktualisieren Sie die Sichtbarkeit Ihrer Produkte](#update-visibility)
+ [Veröffentlichen Sie ein Produkt](#release-product)
+ [Finden Sie Ihre Produkt-ID](#seller-product-id)
+ [Status und Fehler des Sets ändern](#seller-product-change-set-errors)
+ [Arbeite mit AMI-based Produkten](work-with-single-ami-products.md)
+ [Arbeiten Sie mit EC2 Image Builder Builder-Komponentenprodukten](work-with-ec2-image-builder-products.md)
+ [Arbeiten Sie mit Produkten auf Containerbasis mit dem AWS Marketplace APIs](work-with-container-products.md)
+ [Arbeiten Sie mit SaaS-Produkten unter Verwendung der AWS Marketplace APIs](work-with-saas-products.md)
+ [Arbeiten Sie mit Produkten für maschinelles Lernen mit AWS Marketplace APIs](work-with-ml-products.md)
## Erstellen Sie ein Produkt
**Anmerkung**
Dieser Änderungstyp ist nur erforderlich, wenn Sie eine brandneue Produktentität im AWS Marketplace Katalog erstellen möchten. Er ist nicht erforderlich, wenn bestehende Produkte aktualisiert werden.
Sie können die Catalog API verwenden, um ein AMI-, Container-, Machine Learning- oder SaaS-Produktdokument mit Identifikatoren (Produktcode und Produkt-ID) zu erstellen. AWS Marketplace
Sie erstellen ein Produkt im `Draft` Status, indem Sie den `StartChangeSet` API-Vorgang mit dem `CreateProduct` Änderungstyp aufrufen.
Wenn Ihre Anfrage erfolgreich bearbeitet wurde, wird ein Produkt im `Draft` Status für Sie AWS Marketplace Catalog API generiert. Dies ist ein unvollständiges Produkt und für Käufer in nicht sichtbar AWS Marketplace.
Anschließend verwenden Sie `Update` Änderungstypen, um den Prozess zur Produkterstellung abzuschließen: [UpdateInformation[UpdateDimensions](#update-dimensions)](#update-information), [UpdateTargeting](#update-targeting), und [UpdateVisibility](#update-visibility).
Nachdem das Produkt fertiggestellt ist, können Sie den [ReleaseProduct](#release-product)Änderungstyp verwenden, um den Produkterstellungsprozess abzuschließen und anschließend das Angebot zu veröffentlichen. Bei diesem Prozess wird das gesamte Produkt validiert und das Produkt in den `Limited` Status versetzt.
**Anmerkung**
Weitere Informationen zur Erstellung eines Produkts mithilfe von finden Sie in den folgenden Themen im *AWS Marketplace Verkäuferleitfaden*: AWS Marketplace Management Portal
[Erstellen Sie Ihr Single-AMI-Produkt](https://docs.aws.amazon.com/marketplace/latest/userguide/ami-single-ami-products.html#ami-create-product)
Sie können das AMI für die Version nicht aktualisieren. Wenn Sie das AMI aktualisieren müssen, erstellen Sie stattdessen eine neue Version.
[Ein Container-Produkt erstellen](https://docs.aws.amazon.com/marketplace/latest/userguide/container-product-getting-started.html#create-container-product)
[Ein SaaS-Produkt erstellen](https://docs.aws.amazon.com/marketplace/latest/userguide/saas-create-product.html)
[Erstellung eines Produkts für maschinelles Lernen](https://docs.aws.amazon.com/marketplace/latest/userguide/ml-creating-your-listing.html)
Wenn Sie das verwenden, AWS Marketplace Management Portal um ein Produkt zu erstellen, befindet sich das Produkt im `Staging` Status.
Um ein Produkt im `Draft` Status zu erstellen, rufen Sie den `StartChangeSet` API-Vorgang mit dem `CreateProduct` Änderungstyp auf, wie im folgenden Beispiel gezeigt.
**Anforderungssyntax**
```
POST /StartChangeSet HTTP/1.1
Content-type: application/json
{
"Catalog": "AWSMarketplace",
"ChangeSet": [
{
"ChangeType":"CreateProduct",
"Entity":{
"Type": "SaaSProduct@1.0" // choose from ["AmiProduct@1.0", "ContainerProduct@1.0", "SaaSProduct@1.0", "MachineLearningProduct@1.0"]
},
"DetailsDocument": {
"ProductTitle": "{{Test product title set in CreateProduct}}"
}
}
]
}
```
Geben Sie Informationen für die Felder an, um den `CreateProduct` Änderungstyp hinzuzufügen. Dieser Änderungstyp kann `ProductTitle` Attribute annehmen, wobei dieselben Einschränkungen gelten wie für den Änderungstyp, der in den `UpdateInformation` Änderungstyp gesendet wurde.
+ `Entity`(object) (erforderlich) — Der benannte Typ des Objekts, das erstellt wird.
+ `Type`(string) (erforderlich) — Das `Type` basiert auf der Versandmethode (Produkttyp), die Ihr Produkt verwenden wird:`AmiProduct@1.0`,`ContainerProduct@1.0`, `MachineLearningProduct@1.0` oder`SaaSProduct@1.0`. Weitere Informationen finden Sie unter [Kennung](catalog-apis.md#identifier).
+ `DetailsDocument`(object) (erforderlich) — Es ist möglicherweise leer.
+ `ProductTitle`(optional) — Der Titel für Ihr Produkt ist maximal 72 Zeichen lang. Beachten Sie, dass Sie den Produkttitel auch später über den `UpdateInformation` Änderungstyp festlegen oder aktualisieren können.
**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 die oder direkt über die AWS Marketplace Management Portal Katalog-API mithilfe des `[DescribeChangeSet](https://docs.aws.amazon.com/marketplace-catalog/latest/api-reference/API_DescribeChangeSet.html)` API-Vorgangs überprüfen.
Wenn die Anfrage abgeschlossen ist (falls `Status` ja`SUCCEEDED`), `ProductId` wird eine neue generiert.
**Synchrone Validierungen**
Die folgenden Schemavalidierungen sind spezifisch für Aktionen in. `CreateProduct` AWS Marketplace Catalog API Diese Validierungen werden durchgeführt, wenn Sie aufrufen. `StartChangeSet` Wenn die Anfrage die folgenden Anforderungen nicht erfüllt, schlägt sie mit einer HTTP-Antwort fehl.
| Eingabefeld | Validierungsregel | HTTP-Code |
| --- | --- | --- |
| ProductTitle (string) | Max. Länge: 72 | 400 |
**Asynchrone Fehler**
Die folgenden Fehler beziehen sich spezifisch auf `CreateProduct` Aktionen in. AWS Marketplace Catalog API Diese Fehler werden zurückgegeben, wenn Sie aufrufen, `DescribeChangeSet` nachdem ein Änderungssatz verarbeitet wurde. Weitere Informationen 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\_INPUT | Unangemessener Inhalt '{InappropriateContent}' wurde im ProductTitle Feld gefunden. Geben Sie ProductTitle keine unangemessenen Inhalte an. |
## Produktdetails aktualisieren
Wenn Sie bereits über ein Produkt verfügen AWS Marketplace, können Sie die Katalog-API verwenden, um die Produktdetails für ein AMI-, Container-, ML- oder SaaS-Produkt zu aktualisieren.
**Anmerkung**
Weitere Informationen zur Aktualisierung der Produktdetails mithilfe von finden Sie in den folgenden Themen im *AWS Marketplace Verkäuferleitfaden*: AWS Marketplace Management Portal
AMI-based Produkt: [Aktualisieren Sie die Produktinformationen](https://docs.aws.amazon.com/marketplace/latest/userguide/ami-single-ami-products.html#single-ami-updating-product)
Container-based Produkt: [Produktinformationen für Ihr Container-Produkt erstellen oder aktualisieren](https://docs.aws.amazon.com/marketplace/latest/userguide/container-product-getting-started.html#container-product-updating-version)
SaaS-based Produkt: [Produktinformationen aktualisieren](https://docs.aws.amazon.com/marketplace/latest/userguide/saas-product-settings.html#update-product-information)
Produkt für maschinelles Lernen: [Aktualisierung der Produktinformationen](https://docs.aws.amazon.com/marketplace/latest/userguide/ml-update-product.html)
Um Produktdetails zu aktualisieren, rufen Sie den `StartChangeSet` API-Vorgang mit dem `UpdateInformation` Änderungstyp und den Details auf, die Sie ändern möchten, wie im folgenden Beispiel gezeigt.
**Anforderungssyntax**
```
POST /StartChangeSet HTTP/1.1
Content-type: application/json
{
"Catalog": "AWSMarketplace",
"ChangeSet":
[
{
"ChangeType": "UpdateInformation",
"Entity":
{
"Identifier": "{{prod-example12345}}",
"Type": "AmiProduct@1.0"
},
"DetailsDocument":
{
"ProductTitle": "{{My Product Title}}",
"ShortDescription": "{{My product short description.}}",
"LongDescription": "{{My product longer description.}}",
"Sku": "{{123example456}}",
"LogoUrl": "https://awsmp-logos.s3.amazonaws.com/{{ca60b754fe05a24257176cdbf31c4e0d}}",
"VideoUrls":
[
"https://{{example.com/my-video}}"
],
"Highlights":
[
"{{123example45}}"
],
"AdditionalResources":
[
{
"Text": "{{123example456}}",
"Url": "https://{{example.com/some-link}}"
}
],
"SupportDescription": "{{Need help? Contact our experts at support@example.com \n\nYour purchase includes 24x7 support.}}",
"Categories":
[
"Operating Systems",
"Network Infrastructure",
"Application Development"
],
"SearchKeywords":
[
"{{123example456}}"
]
}
}
]
}
```
Geben Sie Informationen für die Felder an, um den `UpdateInformation` Änderungstyp hinzuzufügen:
+ `Entity`(Objekt) (erforderlich) — Der benannte Typ der Entität, die erstellt wird.
+ `Identifier`(string) (erforderlich) — Ihre Produkt-ID. Weitere Informationen finden Sie unter [Kennung](catalog-apis.md#identifier).
+ `Type`(string) (erforderlich) — Das `Type` basiert auf der Versandmethode (Produkttyp), die Ihr Produkt verwenden wird: `AmiProduct@1.0``ContainerProduct@1.0`,`MachineLearningProduct@1.0`, oder`SaaSProduct@1.0`.
+ `DetailsDocument`(object) (erforderlich) — Die Details der Anfrage, einschließlich der Informationen, die Sie für Ihr Produkt aktualisieren möchten. Jedes Feld ist optional, aber Sie müssen mindestens eine Änderung angeben, um es zu aktualisieren.
+ `ProductTitle`(Zeichenfolge) — Der Name des Produkts, das Käufern angezeigt werden soll.
+ `ShortDescription`(Zeichenfolge) — Die Beschreibung der wichtigsten Aspekte des Produkts, die den Käufern angezeigt werden sollen. Das sind normalerweise 2—3 Sätze.
+ `LongDescription`(Zeichenfolge) — Die längere Beschreibung Ihres Produkts, die Käufern angezeigt werden soll. Dies sind normalerweise 1—3 Absätze.
+ `Sku`(Zeichenfolge oder Null) — Die formlose Zeichenfolge, die Sie als Referenz für Ihren eigenen Gebrauch definieren. Wird verwendet`null`, um dieses Feld aufzuheben.
+ `LogoUrl`(string) — Die URL zu einem Bild in einem öffentlich zugänglichen Amazon Simple Storage Service (Amazon S3) -Bucket. Weitere Informationen finden Sie unter [Anforderungen an Unternehmens- und Produktlogos](https://docs.aws.amazon.com/marketplace/latest/userguide/product-submission.html#seller-and-product-logos).
+ `VideoUrls`(Zeichenkettenanordnung) — Die Liste der URLs zu öffentlich verfügbaren, extern gehosteten Videos, die als Referenz für Käufer in Ihren Produktinformationen bereitgestellt werden sollen.
**Anmerkung**
AWS Marketplace Unterstützt derzeit eine URL im Array.
+ `Highlights`(Zeichenkettenarray) — Die Liste der Kurzbeschreibungen für die wichtigsten Produktfunktionen.
+ `AdditionalResources`(Anordnung von Strukturen) — Die Liste mit Verweisen auf zusätzliche Ressourcen, um mehr über Ihr Produkt zu erfahren. Jede Referenz besteht aus einem Textnamen und einer URL:
+ `Text`(string) — Der Name oder Titel der Ressource.
+ `Url`(string) — Die URL zu einer Ressource, die für einen Käufer hilfreich sein könnte, um Ihr Produkt zu verstehen.
+ `SupportDescription`(string) — Die Details zu Ihrem Supportangebot für Ihr Produkt.
+ `Categories`(Reihe von Zeichenketten) — Die Liste der AWS Marketplace definierten Produktkategorien, die Ihr Produkt beschreiben. Weitere Informationen finden Sie unter [Produktkategorien](https://docs.aws.amazon.com/marketplace/latest/buyerguide/buyer-product-categories.html) im *AWS Marketplace Einkaufsführer*.
+ `SearchKeywords`(Reihe von Zeichenketten) — Die Liste mit Schlüsselwörtern für Ihr Produkt, um das Sucherlebnis zu verbessern. Verkäufername, Produktname und Produktkategorien sind automatisch in den Suchbegriffen enthalten und müssen hier nicht wiederholt werden.
**Anmerkung**
Wenn Sie zunächst Produktinformationen (Metadaten) für ein `Draft` Produkt eingeben, müssen Sie für den Typ des `DetailsDocument` `UpdateInformation` Änderungsobjekts alle folgenden Angaben angeben:`ProductTitle`,,`ShortDescription`, `LongDescription``LogoUrl`,`Highlights`,`AdditionalResources`, `SupportDescription``Categories`, und`SearchKeywords`.
Das `ProductTitle` kann weggelassen werden, wenn es bereits beim `CreateProduct` Änderungstyp angegeben wurde. Wenn Sie jedoch vorhandene Felder für das Produkt 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 die AWS Marketplace Management Portal oder rufen Sie die `[DescribeChangeSet](https://docs.aws.amazon.com/marketplace-catalog/latest/api-reference/API_DescribeChangeSet.html)` API auf.
**Synchrone Validierungen**
Die folgenden Schemavalidierungen sind spezifisch für Aktionen in. `UpdateInformation` AWS Marketplace Catalog API Diese Validierungen werden durchgeführt, wenn Sie aufrufen. `StartChangeSet` Wenn die Anfrage die folgenden Anforderungen nicht erfüllt, schlägt sie mit einer HTTP-Antwort fehl.
| Eingabefeld | Validierungsregel | HTTP-Code |
| --- | --- | --- |
| Zeichenfolge (allgemein) | Keine Steuerzeichen „\\\\ x00-\\\\ x08\\\\ x0B-\\\\ x1F“ | 400 |
| ProductTitle (string) | Max. Länge: 72 Erforderlich | 400 |
| ShortDescription (string) | Max. Länge: 1000 Erforderlich | 400 |
| LongDescription (string) | Max. Länge: 5000 Erforderlich | 400 |
| Sku (Zeichenfolge) | Max. Länge: 100 Optional | 400 |
| LogoUrl (string) | URL-Muster:
^ https://(www\\.)? [-a-z A-Z0 - 9@.] {1.256}\\. [a-z A-Z0-9 ()] {2,63}\\ b ([-a-ZA- @\+./] \*) Z0-9
Erforderlich | 400 |
| VideoUrls (Reihe von Zeichenketten) | URL-Muster:
https://(www\\\\.)? [-a-z A-Z0 - 9@.\_] {1.256}\\\\. [a-z A-Z0-9 ()] {2,63}\\\\ b ([-a-z @\_ \+.\\/] A-Z0-9
Optional | 400 |
| Highlights (Reihe von Zeichenketten) | Erforderlich: Min. 1 — Max. 3 | 400 |
| AdditionalResources (Reihe von Strukturen) | Max. Länge: 500 Optional | 400 |
| SupportDescription (string) | Max. Länge: 2000Erforderlich | 400 |
| Kategorien (Reihe von Zeichenketten) | Min. 1 — Max. 3 Erforderlich | 400 |
| SearchKeywords (Reihe von Zeichenketten) | Min. 1 — Max. 15 Maximal 50 Zeichen für jeden Artikel
Erforderlich | 400 |
**Asynchrone Fehler**
Die folgenden Fehler beziehen sich spezifisch auf `UpdateInformation` Aktionen in. AWS Marketplace Catalog 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\_DATA | Es wurden keine Daten für die Durchführung eines Updates bereitgestellt. Geben Sie Daten für mindestens ein Feld des Produkts an. |
| UNGÜLTIGE\_EINGABE | Bereitstellen. LogoUrl |
| UNGÜLTIGE\_EINGABE | Bereitstellen. ProductTitle |
| UNGÜLTIGE\_EINGABE | Bereitstellen. ShortDescription |
| UNGÜLTIGE\_EINGABE | Bereitstellen. LongDescription |
| UNGÜLTIGE\_EINGABE | Bereitstellen. SupportDescription |
| UNGÜLTIGE\_EINGABE | Geben Sie mindestens ein Suchwort ein. |
| UNGÜLTIGE\_EINGABE | Geben Sie mindestens ein Highlight an. |
| UNGÜLTIGE\_EINGABE | Geben Sie zwischen 1 und 3 Produktkategorien an. |
| UNGÜLTIGE\_EINGABE | Unangemessener Inhalt '{InappropriateContent}' wurde im ProductTitle Feld gefunden. Geben Sie ProductTitle keine unangemessenen Inhalte an. |
| UNGÜLTIGE\_EINGABE | Unangemessener Inhalt '{InappropriateContent}' wurde im ShortDescription Feld gefunden. Geben Sie ShortDescription keine unangemessenen Inhalte an. |
| UNGÜLTIGE\_EINGABE | Unangemessener Inhalt '{InappropriateContent}' wurde im LongDescription Feld gefunden. Geben Sie LongDescription keine unangemessenen Inhalte an. |
| UNGÜLTIGE\_EINGABE | Unangemessener Inhalt '{InappropriateContent}' wurde im SupportDescription Feld gefunden. Geben Sie SupportDescription keine unangemessenen Inhalte an. |
| UNGÜLTIGE\_EINGABE | Ungültiges Feld ProductTitle . Entfernen Sie Leerzeichen vor dem Markensymbol. |
| UNGÜLTIGE\_EINGABE | Ungültiges Feld ShortDescription . Entfernen Sie Leerzeichen vor dem Markensymbol. |
| UNGÜLTIGE\_EINGABE | Ungültiges Feld LongDescription . Entfernen Sie Leerzeichen vor dem Markensymbol. |
| UNGÜLTIGE\_EINGABE | Ungültiges Feld SupportDescription . Entfernen Sie Leerzeichen vor dem Markensymbol. |
| UNGÜLTIGE\_EINGABE | Ungültiges Feld ProductTitle . Entfernen Sie die nicht unterstützten Zeichen [UnsupportedCharacters]. |
| UNGÜLTIGE\_EINGABE | Ungültiges Feld ShortDescription . Entfernen Sie die nicht unterstützten Zeichen [UnsupportedCharacters]. |
| UNGÜLTIGE\_EINGABE | Ungültiges Feld LongDescription . Entfernen Sie die nicht unterstützten Zeichen [UnsupportedCharacters]. |
| UNGÜLTIGE\_EINGABE | Ungültiges Feld SupportDescription . Entfernen Sie die nicht unterstützten Zeichen [UnsupportedCharacters]. |
| UNGÜLTIGE\_EINGABE | Suchbegriffe dürfen nicht mehr als 250 kombinierte Zeichen enthalten. |
| INVALID\_INPUT | Die Eingabe für diesen Änderungstyp konnte nicht gelesen werden. Reichen Sie eine korrekt formatierte Eingabe ein. |
| INVALID\_ADDITIONAL\_RESOURCES | Ungültige URLs in AdditionalResources: [] InvalidAdditionalResourcesUrls Geben Sie gültige URLs an. |
| INVALID\_CATEGORY\_NAMES | Geben Sie gültige Kategorienamen an, die von unterstützt werden. AWS Marketplace |
| InvalidImageProperties | Es wurden Validierungsfehler gefunden: Die Datei hat keinen Bildtyp. Unterstützte Bildtypen: [png\|jpg\|gif]. |
| EXPLIZITER\_INHALT | Expliziter Inhalt: '{ExplicitContent}' erkannt. Stellen Sie Medien ohne expliziten Inhalt bereit. |
| INVALID\_MEDIA | Ungültige URL: {MediaUrl} Geben Sie eine neue URL für in S3 gespeicherte Medien an. |
| INVALID\_MEDIA | Ungültige URL: {MediaUrl} Geben Sie eine gültige URL an, die 2048 Zeichen nicht überschreitet. |
| INVALID\_MEDIA | Auf den angegebenen Speicherort kann nicht zugegriffen werden: {MediaUrl} Geben Sie eine zugängliche URL für in S3 gespeicherte Medien an. |
| INVALID\_MEDIA | Beim Kopieren der Medien von S3 ist ein Problem aufgetreten. Die Bildgröße überschreitet 5 MB. Stellen Sie ein Bild bereit, das weniger als 5 MB groß ist. |
| INVALID\_MEDIA | In Medien wurde Malware entdeckt. Bitte reichen Sie die Medien erneut ohne Schadsoftware ein. |
| ZU VIELE\_MEDIEN | Stellen Sie nicht mehr als 15 Medienelemente bereit. |
| DUPLICATE\_MEDIA | Doppelte Medien sind für ein Produkt nicht zulässig. Bitte geben Sie Medien ohne Duplikate an. |
## Fügen Sie Preisdimensionen hinzu
Sie können die [AWS Marketplace Catalog Service Actions](https://docs.aws.amazon.com/marketplace/latest/APIReference/API_Operations_AWS_Marketplace_Catalog_Service.html) verwenden, um fakturierbare Preisdimensionen hinzuzufügen, mit denen Sie Benutzern AMI-, Container- oder SaaS-Produkte in Rechnung stellen können.
Eine *Preisdimension* ist eine Maßeinheit, die Verkäufer definieren, um Käufern Gebühren in Rechnung zu stellen. Verkäufer müssen diese Informationen einrichten, um Käufern die Nutzung des Produkts in Rechnung zu stellen, unabhängig davon, ob es sich um ein nutzungsbasiertes oder ein vertragsbasiertes Preismodell handelt. Die Art der Dimension hängt vom Preismodell des Produkts ab.
**Anmerkung**
Für SaaS-Produkte mit kostenlosem Preismodell müssen Sie mindestens eine Dimension mit UsageBasedPricingTerm oder erstellen ConfigurableUpfrontPricingTerm, und alle Dimensionen müssen einen Preis von 0,00 USD haben. Diese Anforderung gilt nur für SaaS-Produkte und gilt nicht für AMI-, Container- oder Machine-Learning-Produkte.
**Anmerkung**
Neue Preisdimensionen haben folgende Auswirkungen auf SaaS-Käufer:
Für Käufer mit Verträgen, die auf der Grundlage von öffentlichen Angeboten geschlossen wurden, können Sie den Verbrauch der neuen Dimensionen melden, auch wenn sie zum Zeitpunkt der Erstellung der Vereinbarung noch nicht im Angebot enthalten waren.
Für Käufer, deren Verträge auf der Grundlage von privaten Angeboten erstellt wurden, können Sie den Verbrauch der neuen Dimensionen nicht melden, da sie zum Zeitpunkt der Erstellung der Vereinbarung im privaten Angebot noch nicht vorhanden waren. Aufrufe der [BatchMeterUsage](https://docs.aws.amazon.com/marketplace/latest/APIReference/API_marketplace-metering_BatchMeterUsage.html)API sind erfolgreich, aber dem Käufer wird nichts in Rechnung gestellt. Sie müssen also nachverfolgen, welchem Käufer neue Dimensionen in Rechnung gestellt werden können und welchem nicht. Sie können die [GetAgreementTerms](https://docs.aws.amazon.com/marketplace/latest/APIReference/API_marketplace-agreements_GetAgreementTerms.html)API auch verwenden, um zu sehen, welche Abmessungen in den einzelnen Käufervereinbarungen enthalten sind.
Um den Verbrauch für eine neue Dimension zu melden und dem Käufer eine Rechnung zu stellen, [müssen Sie ein Ersatzangebot unterbreiten](https://docs.aws.amazon.com/marketplace/latest/userguide/private-offers-upgrades-and-renewals.html#private-offers-upgrades-and-renewals-supported-products), das die Dimension enthält, und der Käufer muss das Angebot annehmen.
Weitere Informationen zur Preisgestaltung von Produkten finden Sie unter den folgenden Themen im *AWS Marketplace Verkäuferleitfaden*:
+ [AMI-Produktpreise](https://docs.aws.amazon.com/marketplace/latest/userguide/pricing-ami-products.html)
+ [Preisgestaltung für Containerprodukte](https://docs.aws.amazon.com/marketplace/latest/userguide/pricing-container-products.html)
+ [Preise für SaaS-Produkte](https://docs.aws.amazon.com/marketplace/latest/userguide/saas-pricing-models.html)
+ [Machine-Learning-Produktpreise](https://docs.aws.amazon.com/marketplace/latest/userguide/machine-learning-pricing.html)
Weitere Informationen zum Hinzufügen von Preisdimensionen mithilfe von finden Sie in den folgenden Themen im *AWS Marketplace Verkäuferleitfaden*: AWS Marketplace Management Portal
+ AMI-based Produkte: [Preise aktualisieren](https://docs.aws.amazon.com/marketplace/latest/userguide/ami-single-ami-products.html#single-ami-update-product-pricing).
+ Container-based Produkte: [Hinzufügen einer Preisdimension](https://docs.aws.amazon.com/marketplace/latest/userguide/container-product-getting-started.html#container-add-pricing-dimensions).
+ SaaS-based Produkte: [Preisdimensionen hinzufügen](https://docs.aws.amazon.com/marketplace/latest/userguide/saas-product-settings.html#saas-add-pricing-dimensions).
+ ML-Produkte: Nicht unterstützt. Produkte für maschinelles Lernen haben feste Preisdimensionen. Sie können die [Preise jedoch aktualisieren](https://docs.aws.amazon.com/marketplace/latest/userguide/ami-single-ami-products.html#single-ami-update-product-pricing).
Um Preisdimensionen hinzuzufügen, rufen Sie die `StartChangeSet` API mit dem `AddDimensions` Änderungstyp auf, wie im folgenden Beispiel gezeigt.
**Anmerkung**
Nachdem Sie den ersten `AddDimensions` Änderungstyp mit den Dimensionen eingereicht haben, die eine Art von Preismodell (Nutzung, Vertrag oder Vertrag mit Verbrauch) angeben, müssen Sie mit dem AWS Marketplace Seller Operations Team zusammenarbeiten. Sie helfen Ihnen dabei, eine Dimension mit Typen hinzuzufügen, die außerhalb des ursprünglichen Preismodells liegen.
**Anforderungssyntax**
```
POST /StartChangeSet HTTP/1.1
Content-type: application/json
{
"Catalog": "AWSMarketplace",
"ChangeSet":
[
{
"ChangeType": "AddDimensions",
"DetailsDocument":
[
{
"Description": "{{Description of the dimension}}",
"Key": "{{UniqueApiKey}}",
"Unit": "HostHrs",
"Name": "{{First Dimension}}",
"Types":
[
"ExternallyMetered"
]
}
],
"Entity":
{
"Identifier": "{{prod-example12345}}",
"Type": "SaaSProduct@1.0"
}
}
]
}
```
Geben Sie die folgenden Felder für den `AddDimensions` Änderungstyp an.
+ `DetailsDocument`(Array von Objekten) (erforderlich) — Details der Anfrage.
+ `Description`(string) (erforderlich) — Vollständige Angaben zu der Dimension, die in der ausführlichen Beschreibung auf der Anzeigeseite des Käufers erscheinen wird.
+ `Key`(string) (erforderlich) — Geben Sie die Facette ein, die für die Definition der Tarife im Angebot verwendet werden soll. Geben Sie außerdem die in der AWS Marketplace Metering Service (MMS) veröffentlichten Dimensionen ein, falls die Dimension nicht extern gemessen werden kann. Nachdem die Dimension erstellt wurde, kann sie nicht mehr geändert werden.
+ `Units`(string) (erforderlich) — Der Einheitentyp für die Dimension. Mögliche Einheiten sind Benutzer, Hosts, GB, MB, TB, Gbit/s, Mbit/s, Anfragen, Einheiten, UserHrs, UnitHrs, Einheiten, HostHrs TierHrs, und TaskHrs.
+ `Name`(string) (erforderlich) — Der Anzeigename für die Dimension auf der Website und in der Kundenrechnung.
+ `Types`(Array of Strings) (erforderlich) (auch bekannt als **Tags**) — Diese geben an, ob die Dimension die Messung, die Nutzung von Rechten oder die Unterstützung für externe Messungen umfasst. Dies kann nach der Erstellung der Dimension nicht geändert werden.
+
+ `Metered`— Gibt an, dass Nutzungstypen für die Commerce-Plattform erstellt werden sollten, damit die Messung für diese Dimension erfolgen kann.
+ `ExternallyMetered`— Weist darauf hin, dass die Dimensionen des AWS Marketplace Messdienstes (MMS) während der Veröffentlichung erstellt werden sollten, damit Verkäufer die Messung über das AWS SDK durchführen können.
+ `Entitled`— Gibt an, dass bei der Veröffentlichung des Produkts oder Angebots Berechtigungen für die Dimension gewährt werden können.
In der folgenden Tabelle sind die unterstützten Kombinationen von Preisdimensionen und Produkten aufgeführt.
[See the AWS documentation website for more details](http://docs.aws.amazon.com/de_de/marketplace/latest/developerguide/work-with-seller-products.html)
+ `Entity`(object) (erforderlich) — Der benannte Entitätstyp, der erstellt wird.
+ `Identifier`(string) (erforderlich) — Ihre Produkt-ID. Weitere Informationen finden Sie unter [Kennung](catalog-apis.md#identifier).
+ `Type`(string) (erforderlich) — Das `Type` basiert auf der Versandmethode (Produkttyp), die Ihr Produkt verwenden wird: `AmiProduct@1.0` oder`SaaSProduct@1.0`.
**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 der Informationen, um sicherzustellen, dass sie den AWS Marketplace Richtlinien entsprechen. Der Validierungsprozess kann zwischen einigen Minuten und einigen Stunden dauern.
Sie können den Status der Anfrage über die oder direkt über die AWS Marketplace Management Portal Catalog API mithilfe des `[DescribeChangeSet](https://docs.aws.amazon.com/marketplace-catalog/latest/api-reference/API_DescribeChangeSet.html)` API-Vorgangs überprüfen.
**Synchrone Validierungen**
Die folgenden Schemavalidierungen sind spezifisch für Aktionen in. `AddDimensions` AWS Marketplace Catalog API Diese Validierungen werden durchgeführt, wenn Sie aufrufen. `StartChangeSet` Wenn die Anfrage die folgenden Anforderungen nicht erfüllt, schlägt sie mit einer HTTP-Antwort fehl.
| Eingabefeld | Validierungsregel | HTTP-Code |
| --- | --- | --- |
| Description | Max. Länge: 1000 Erforderlich | 400 |
| Key (Schlüssel) | Max. Länge: 100 Muster: [A-Za-z0-9\_.-] \+$
Erforderlich | 400 |
| Maßeinheiten | Max. Länge: 20 Erforderlich | 400 |
| Name | Max. Länge: 500 Erforderlich | 400 |
| Typ (Tag) | Erforderlich: Min. 1 — Max. 3
Eingänge: Berechtigt, Gemessen, ExternallyMetered
Erforderlich | 400 |
**Asynchrone Fehler**
Die folgenden Fehler beziehen sich spezifisch auf `AddDimensions` Aktionen in. AWS Marketplace Catalog 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\_DATA | Es wurden keine Daten für die Durchführung eines Updates bereitgestellt. Geben Sie Daten für mindestens eine Dimension an. |
| UNGÜLTIGE\_DIMENSION | Geben Sie nicht mehr als 200 Dimensionen an. |
| UNGÜLTIGE\_DIMENSION | Doppelte Dimensionen können nicht hinzugefügt werden. |
| UNGÜLTIGE\_DIMENSION | Die Dimension kann im aktuellen Status '%s' nicht hinzugefügt werden. Staaten, die Dimensionsaktualisierungen unterstützen, sind %s. |
| UNGÜLTIGE\_DIMENSION | Dimension kann nicht hinzugefügt werden. Das Feld '%s' hat doppelte Werte '%s' in anderen Dimensionen. |
| UNGÜLTIGE\_DIMENSION | Geben Sie für jede Dimension nicht leere Felder (Schlüssel, Einheit, Name, Typen) an. |
| UNGÜLTIGER TYP | Löscht den ungültigen Typ '%s'. Gültige Typen sind ["Metered“, „Entitled“, "ExternallyMetered„]. |
| INVALID\_UNIT | Ungültige Einheit '%s' entfernen. Gültige Einheiten sind ["GB“, „Gbps“, "HostHrs„, „Hosts“, „MB“, „Mbit/s“, „Anfragen“, "TaskHrs„, „TB“, "TierHrs„," „, UnitHrs „Einheiten“, "UserHrs„, „Benutzer"]. |
| INVALID\_INPUT | Unangemessener Inhalt '%s' wurde im Feld %s gefunden. Geben Sie %s ohne unangemessenen Inhalt ein. |
| UNGÜLTIGE\_EINGABE | Ungültiges Feld '%s' Entfernen Sie Leerzeichen vor dem Markensymbol. |
| UNGÜLTIGE\_EINGABE | Ungültiges Feld '%s' Entferne die nicht unterstützten Zeichen %s. |
| UNGÜLTIGE\_DIMENSION | Ungültige Dimensionstypkombination %s entfernen. Zulässige Werte sind %s. |
| UNGÜLTIGE\_DIMENSION | Entfernen Sie den ungültigen Dimensionsschlüssel '%s' für die Dimension Metered. |
| UNGÜLTIGE\_DIMENSION | Die Dimension mit dem Namen '%s' für den productCode '%s' hat die AWS Marketplace Metering Service-Validierung %s nicht bestanden. |
| UNGÜLTIGE\_DIMENSION | Für die Dimension mit dem Namen '%s' für den productCode '%s' ist kein Messdatensatz im Metering Service vorhanden. Das Produkt wurde entweder nie zu Testzwecken auf den Markt gebracht oder es ist falsch konfiguriert und sendet keine entsprechenden Aufrufe an den AWS Marketplace Messdienst. |
## Preisdimensionen aktualisieren
Sie können die Catalog API verwenden, um bestehende Preisdimensionen eines AMI-, Container- oder SaaS-Produkts in zu aktualisieren AWS Marketplace.
Jede Dimension wird anhand des Dimensionsschlüssels und der Dimensionstypen eindeutig identifiziert, um die Aktualisierung durchzuführen. Die Aktualisierung einer Dimension wirkt sich nicht auf aktive Angebote oder Kunden aus, die mit der ursprünglichen Dimension erstellt wurden.
**Anmerkung**
Weitere Informationen zur Aktualisierung von Preisdimensionen mithilfe von finden Sie in den folgenden Themen im *AWS Marketplace Verkäuferleitfaden*: AWS Marketplace Management Portal
AMI-based Produkt: [Preise aktualisieren](https://docs.aws.amazon.com/marketplace/latest/userguide/ami-single-ami-products.html#single-ami-update-product-pricing)
Container-based Produkt: [Aktualisierung der Dimensionsinformationen](https://docs.aws.amazon.com/marketplace/latest/userguide/container-product-getting-started.html#container-update-dimensions-information)
SaaS-based Produkt: [Preisdimensionen aktualisieren](https://docs.aws.amazon.com/marketplace/latest/userguide/saas-product-settings.html#saas-update-dimension)
Produkt für maschinelles Lernen: [Produktpreise aktualisieren](https://docs.aws.amazon.com/marketplace/latest/userguide/ml-update-public-offer.html)
Um Preisdimensionen zu aktualisieren, rufen Sie den `StartChangeSet` API-Vorgang mit dem `UpdateDimensions` Änderungstyp auf, wie im folgenden Beispiel gezeigt.
**Anforderungssyntax**
```
POST /StartChangeSet HTTP/1.1
Content-type: application/json
{
"Catalog": "AWSMarketplace",
"ChangeSet":
[
{
"ChangeType": "UpdateDimensions",
"DetailsDocument":
[
{
"Key": "{{UniqueApiKey}}",
"Types":
[
"{{ExternallyMetered}}"
],
"Name": "{{First Dimension}}",
"Description": "{{Description of the dimension}}"
}
],
"Entity":
{
"Identifier": "{{prod-example12345}}",
"Type": "SaaSProduct@1.0"
}
}
]
}
```
Verwenden Sie die folgenden Felder für den `UpdateDimensions` Änderungstyp:
+ `DetailsDocument`(Array von Objekten) (erforderlich) — Details der Anfrage.
+ `Key`(string) (erforderlich) — Geben Sie den Schlüssel der vorhandenen Dimension des Produkts an, auf dem die Beschreibung und der Name geändert werden sollen. Denn `UpdateDimension` dieses Feld dient nur zur Identifizierung der Dimension, die geändert werden soll.
+ `Types`(Reihe von Zeichenketten) (erforderlich) (auch als **Tags** bezeichnet) — Diese geben an, ob die Dimension die Erfassung, die Nutzung von Rechten oder die Unterstützung für externe Messungen umfasst. Dies kann nach der Erstellung der Dimension nicht geändert werden.
+ `Metered`— Gibt an, dass Nutzungstypen für die Commerce-Plattform erstellt werden sollten, damit die Messung für diese Dimension erfolgen kann.
+ `ExternallyMetered`— Weist darauf hin, dass AWS Marketplace Metering Service (MMS) -Dimensionen während der Veröffentlichung erstellt werden sollten, damit Verkäufer das AWS SDK nutzen können.
+ `Entitled`— Gibt an, dass während product/offer der Veröffentlichung Berechtigungen für die Dimension gewährt werden können.
**Gültige Kombinationen von Preisdimensionstypen**
[See the AWS documentation website for more details](http://docs.aws.amazon.com/de_de/marketplace/latest/developerguide/work-with-seller-products.html)
+ `Description`(string) (optional) — Vollständige Beschreibung der Dimension, die als ausführliche Beschreibung auf der Anzeigeseite des Käufers verwendet wird.
+ `Name`(string) optional — Zeigt den Namen für die Dimension auf der Website und auf der Rechnung des Kunden an.
+ `Entity`(object) (erforderlich) — Der benannte Typ der Entität, die erstellt wird.
+ `Identifier`(string) (erforderlich) — Ihre Produkt-ID. Weitere Informationen finden Sie unter [Kennung](catalog-apis.md#identifier).
+ `Type`(string) (erforderlich) — Das `Type` basiert auf der Versandmethode (Produkttyp), die Ihr Produkt verwenden wird: `AmiProduct@1.0` oder`SaaSProduct@1.0`.
**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. Dies beinhaltete die Überprüfung der Informationen, um sicherzustellen, dass sie den AWS Marketplace Richtlinien entsprechen. Der Validierungsprozess kann zwischen einigen Minuten und einigen Stunden dauern.
Sie können den Status der Anfrage über die oder direkt über die AWS Marketplace Management Portal Catalog API mithilfe des `[DescribeChangeSet](https://docs.aws.amazon.com/marketplace-catalog/latest/api-reference/API_DescribeChangeSet.html)` API-Vorgangs überprüfen.
**Synchrone Validierungen**
Die folgenden Schemavalidierungen sind spezifisch für Aktionen in. `UpdateDimensions` AWS Marketplace Catalog API Diese Validierungen werden durchgeführt, wenn Sie aufrufen. `StartChangeSet` Wenn die Anfrage die folgenden Anforderungen nicht erfüllt, schlägt sie mit einer HTTP-Antwort fehl.
| Eingabefeld | Validierungsregel | HTTP-Code |
| --- | --- | --- |
| Description | Max. Länge: 1000
Erforderlich | 400 |
| Key (Schlüssel) | Max. Länge: 100
Muster: [A-Za-z0-9\_.-] \+$
Erforderlich | 400 |
| Name | Max. Länge: 5
Erforderlich | 400 |
| Typen (Tag) | Erforderlich: Min. 1 — Max. 3
Eingänge:`Entitled`,`Metered`, `ExternallyMetered`
Erforderlich | 422 |
**Asynchrone Fehler**
Die folgenden Fehler beziehen sich spezifisch auf `UpdateDimensions` Aktionen in. AWS Marketplace Catalog 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\_INPUT | Ungültiges Feld '%s' Entfernen Sie Leerzeichen vor dem Markensymbol. |
| UNGÜLTIGE\_EINGABE | Ungültiges Feld '%s' Entferne die nicht unterstützten Zeichen %s. |
| UNGÜLTIGE\_DIMENSION | Geben Sie für jede Dimension nicht leere Felder (Key,Types, Name and/orDescription) an. |
| UNGÜLTIGE\_DIMENSION | Die Dimension kann nicht aktualisiert werden. Das Feld Name hat doppelte Werte '%s' in anderen Dimensionen. |
| UNGÜLTIGE\_DIMENSION | Dieselbe Dimension kann nicht mit dem Schlüssel '%s' aktualisiert und '%s' mehrmals in derselben Anfrage eingegeben werden. |
| UNGÜLTIGE\_DIMENSION | Dimension kann nicht eingeschränkt werden. Der Dimensionsschlüssel '%s' mit dem Typ '%s' ist nicht vorhanden. |
| UNGÜLTIGE\_DIMENSION | Die Dimension kann nicht aktualisiert werden. Der Dimensionsschlüssel '%s' istMetered. |
| UNGÜLTIGE\_DIMENSION | Die Dimension kann für eine bereits eingeschränkte Dimension nicht aktualisiert werden. |
## Beschränken Sie die Preisdimensionen
Sie können die Catalog API verwenden, um bestehende Preisdimensionen eines AMI- oder SaaS-Produkts in einzuschränken AWS Marketplace.
Jede Dimension wird anhand des Dimensionsschlüssels und der Dimensionstypen eindeutig identifiziert, um die Aktualisierung durchzuführen. Die Einschränkung einer Dimension wirkt sich nicht auf aktive Angebote oder Kunden aus, die mit der ursprünglichen Dimension erstellt wurden.
Um die Preisdimensionen einzuschränken, rufen Sie die `StartChangeSet` API mit dem `RestrictDimensions` Änderungstyp auf.
**Anmerkung**
Einschränkungen der Preisdimension sind nur verfügbar, solange sich das Produkt im Entwurfsstatus befindet. Änderungen sind nicht mehr zulässig, sobald das Produkt in den eingeschränkten Zustand oder in den öffentlichen Zustand übergeht.
Das folgende Beispiel zeigt, wie die `Entitled` Dimension für ein SaaS-Produkt eingeschränkt wird.
**Anforderungssyntax**
```
POST /StartChangeSet HTTP/1.1
Content-type: application/json
{
"Catalog": "AWSMarketplace",
"ChangeSet":
[
{
"ChangeType": "RestrictDimensions",
"DetailsDocument":
[
{
"Key": "{{UniqueApiKey}}",
"Types": ["Entitled"]
}
],
"Entity":
{
"Identifier": "{{prod-example12345}}",
"Type": "SaaSProduct@1.0"
}
}
]
}
```
Verwenden Sie die folgenden Felder mit dem `RestrictDimensions` Änderungstyp:
+ `DetailsDocument`(Array von Objekten) (erforderlich) — Details der Anfrage.
+ `Key`(string) (erforderlich) — Geben Sie den Schlüssel der vorhandenen Dimension des Produkts an, auf dem die Beschreibung und der Name geändert werden sollen. Denn `RestrictDimensions` dieses Feld dient nur zur Identifizierung der Dimension, die geändert werden soll.
+ `Types`(Reihe von Zeichenketten) (erforderlich) (auch als **Tags** bezeichnet) — Diese geben an, ob die Dimension die Erfassung, die Nutzung von Rechten oder die Unterstützung für externe Messungen umfasst. Dies kann nach der Erstellung der Dimension nicht geändert werden.
+ `["ExternallyMetered", "Entitled"]`— Sie können diese Typen nur für SaaS-Verträge mit Verbrauchspreisen kombinieren, bei denen Abmessungen im Voraus bezahlt oder gemessen werden können.
+ `["Metered"]`— Für stündliche Preisabmessungen von AMI-Produkten. Gibt an, dass Nutzungstypen für die Commerce-Plattform erstellt werden sollten, damit die Messung für diese Dimension möglich ist.
+ `["ExternallyMetered"]`— Für flexible Preisdimensionen für den Verbrauch (auch bekannt als benutzerdefinierte Messung) von AMI-, Container- und SaaS-Produkten. Weist darauf hin, dass AWS Marketplace Metering Service (MMS) -Dimensionen während der Veröffentlichung erstellt werden sollten, damit Verkäufer das Messen über das AWS SDK durchführen können.
+ `["Entitled"]`— Für Vertragspreisdimensionen von SaaS-Verträgen und professionellen Dienstleistungsprodukten. Dieses Tag gewährt Rechte zur Nutzung einer Software oder eines Dienstes, legt Start- und Enddaten für die Nutzung fest und gewährt Nutzungsrabattrechte für AMI-Jahresprodukte. Jede Berechtigung wird durch einen Dimensionsschlüssel identifiziert, mit dem die Berechtigungen erstellt und aktualisiert werden können. AWS Marketplace Entitlement Service Der Schlüssel gibt an, dass bei der Veröffentlichung von Produkten und Angeboten Berechtigungen für die Dimension gewährt werden können.
+ `Entity`(object) (erforderlich) — Der benannte Typ der Entität, die erstellt wird.
+ `Identifier`(string) (erforderlich) — Ihre Produkt-ID. Weitere Informationen finden Sie unter [Kennung](catalog-apis.md#identifier).
+ `Type`(string) (erforderlich) — Das `Type` basiert auf der Liefermethode (Produkttyp) Ihres Produkts: `AmiProduct@1.0` oder`SaaSProduct@1.0`.
**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. Dies beinhaltete die Überprüfung der Informationen, um sicherzustellen, dass sie den AWS Marketplace Richtlinien entsprechen. Der Validierungsprozess kann zwischen einigen Minuten und einigen Stunden dauern.
Sie können den Status der Anfrage über die AWS Marketplace Management Portal oder durch Aufrufen der `[DescribeChangeSet](https://docs.aws.amazon.com/marketplace-catalog/latest/api-reference/API_DescribeChangeSet.html)` API überprüfen.
**Synchrone Validierungen**
Die folgenden Schemavalidierungen sind spezifisch für Aktionen in. `RestrictDimensions` AWS Marketplace Catalog API Diese Validierungen werden durchgeführt, wenn Sie aufrufen. `StartChangeSet` Wenn die Anfrage die folgenden Anforderungen nicht erfüllt, schlägt sie mit einer HTTP-Antwort fehl.
| Eingabefeld | Validierungsregel | HTTP-Code |
| --- | --- | --- |
| Description | Max. Länge: 1000
Erforderlich | 400 |
| Key (Schlüssel) | Max. Länge: 100
Muster: [A-Za-z0-9\_.-] \+$
Erforderlich | 400 |
| Name | Max. Länge: 5
Erforderlich | 400 |
| Typen (Tag) | Erforderlich: Min. 1 — Max. 3
Eingänge:`Entitled`,`Metered`, `ExternallyMetered`
Erforderlich | 400 |
**Asynchrone Fehler**
Die folgenden Fehler beziehen sich spezifisch auf `RestrictDimensions` Aktionen in. AWS Marketplace Catalog API Diese Fehler werden zurückgegeben, wenn Sie aufrufen, `DescribeChangeSet` während ein Änderungssatz verarbeitet wird. 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\_INPUT | Ungültiges Feld '%s' Entfernen Sie Leerzeichen vor dem Markensymbol. |
| UNGÜLTIGE\_EINGABE | Ungültiges Feld '%s' Entferne die nicht unterstützten Zeichen %s. |
| UNGÜLTIGE\_DIMENSION | Der Dimensionsschlüssel '%s' mit dem Typ '%s' war bereits eingeschränkt |
| UNGÜLTIGE\_DIMENSION | Dimension kann nicht eingeschränkt werden. Der Dimensionsschlüssel '%s' mit dem Typ '%s' ist nicht vorhanden |
| UNGÜLTIGE\_DIMENSION | Doppelte Dimensionen können nicht eingeschränkt werden. |
| UNGÜLTIGE\_DIMENSION | Alle Dimensionen mit dem Titel „Titel“ können nicht eingeschränkt werden. Es muss mindestens eine aktive Dimension mit dem Titel „Berechtigt“ vorhanden sein. |
| UNGÜLTIGE\_DIMENSION | Der Dimensionsschlüssel '%s' mit dem Typ '%s' ist einer anderen Dimension des anderen Typs '%s' zugeordnet. Beide Dimensionen desselben Schlüssels müssen gleichzeitig eingeschränkt werden, um gültig zu sein. |
## Targeting-Konfiguration aktualisieren
Sie können die Catalog API verwenden, um AWS-Konto IDs hinzuzufügen, die das AMI-, Container-, ML- oder SaaS-Produkt anzeigen dürfen, AWS Marketplace bevor es in einen `Public` Status versetzt wird, indem `UpdateTargeting` Sie den Änderungstyp aufrufen.
Konten für verwaltete Katalogoperationen (MCO) werden automatisch zur Liste der zulässigen Konten hinzugefügt, wenn neue Produkte erstellt werden. Diese MCO-Konten sind für Verkäufer im AWS Marketplace Management Portal (AMMP) sichtbar, wenn sie sich die erlaubten Konten ansehen, sowie im `Targeting` Abschnitt der `DescribeEntity` API-Antwort.
**Anmerkung**
Weitere Informationen zum Hinzufügen von AWS-Konto IDs mithilfe von finden Sie in den folgenden Themen im *AWS Marketplace Verkäuferleitfaden*: AWS Marketplace Management Portal
AMI-based Produkt: [Aktualisieren Sie die Zulassungsliste (Vorschaukonten](https://docs.aws.amazon.com/marketplace/latest/userguide/ami-single-ami-products.html#single-ami-updating-allowlist))
Container-based Produkt: [Aktualisierung der Zulassungsliste von AWS-Konto-IDs](https://docs.aws.amazon.com/marketplace/latest/userguide/container-product-getting-started.html#container-update-allowlist)
SaaS-based Produkt: [Aktualisierung der Zulassungsliste von AWS-Konto-IDs](https://docs.aws.amazon.com/marketplace/latest/userguide/saas-product-settings.html#update-allowlist)
Produkt für maschinelles Lernen: [Aktualisierung der Zulassungsliste](https://docs.aws.amazon.com/marketplace/latest/userguide/ml-update-allowlist.html)
Um AWS-Konto IDs hinzuzufügen, die das AMI-, Container-, ML- oder SaaS-Produkt anzeigen dürfen, rufen Sie den `StartChangeSet` API-Vorgang mit dem `UpdateTargeting` Änderungstyp auf, wie im folgenden Beispiel gezeigt.
**Anforderungssyntax**
```
POST /StartChangeSet HTTP/1.1
Content-type: application/json
{
"Catalog": "AWSMarketplace",
"ChangeSet":
[
{
"ChangeType": "UpdateTargeting",
"Entity":
{
"Type": "SaaSProduct@1.0",
"Identifier": "{{prod-example12345}}"
},
"DetailsDocument":
{
"PositiveTargeting":
{
"BuyerAccounts":
[
"{{1112223334444}}"
]
}
}
}
]
}
```
Verwenden Sie die folgenden Felder mit dem `UpdateTargeting` Änderungstyp.
+ `Entity`(Objekt) (erforderlich) — Der benannte Typ der Entität, die erstellt wird.
+ `Identifier`(string) (erforderlich) — Ihre Produkt-ID. Weitere Informationen finden Sie unter [Kennung](catalog-apis.md#identifier).
+ `Type`(string) (erforderlich) — Das `Type` basiert auf der Versandmethode (Produkttyp), die Ihr Produkt verwenden wird:`AmiProduct@1.0`,`MachineLearningProduct@1.0`, oder`SaaSProduct@1.0`.
+ `DetailsDocument`(object) (erforderlich) — Die Details, die zur Ausführung von erforderlich sind ChangeSet.
+ `PositiveTargeting`(Objekt) (optional) — Positives Targeting definiert die Kriterien, die jedes Käuferprofil erfüllen muss, um auf das Angebot zugreifen zu können. Dieses Feld ist optional, aber wenn dieses Feld vorhanden ist, sollte mindestens eine Targeting-Option angegeben werden.
+ `BuyerAccounts`(Zeichenkettenarray) (optional) — Liste als Option, um Targeting auf der Grundlage von AWS-Konten zu ermöglichen (auch bekannt als Privatangebot). Wenn das Angebot nicht auf ein AWS-Konto ausgerichtet werden soll, sollte dieses Feld weggelassen werden.
**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. Dies beinhaltete die Überprüfung der Informationen, um sicherzustellen, dass sie den AWS Marketplace Richtlinien entsprechen. Der Validierungsprozess kann zwischen einigen Minuten und einigen Stunden dauern.
Um den Status der Anfrage zu überprüfen, verwenden Sie die AWS Marketplace Management Portal oder rufen Sie die `[DescribeChangeSet](https://docs.aws.amazon.com/marketplace-catalog/latest/api-reference/API_DescribeChangeSet.html)` API auf.
Wenn die Anfrage abgeschlossen ist (falls `Status` ja`SUCCEEDED`), `ProductId` wird eine neue generiert.
**Synchrone Validierungen**
Die folgenden Schemavalidierungen sind spezifisch für Aktionen in. `UpdateTargeting` AWS Marketplace Catalog API Diese Validierungen werden durchgeführt, wenn Sie aufrufen. `StartChangeSet` Wenn die Anfrage die folgenden Anforderungen nicht erfüllt, schlägt sie mit einer HTTP-Antwort fehl.
| Art des Targetings | Gültige aktuelle Sichtbarkeitsstatus | BuyerAccounts (Eingabe) | Check |
| --- | --- | --- | --- |
| Positiv | Öffentlich,Limited, oder Draft | Array von 12-stelligen AWS-Konto ID-Zeichenketten.
Mindestgröße: 0.
Maximale Größe: 5000. | Die Eingabe muss sich von dem aktuellen Dokument unterscheiden, das auf Konten ausgerichtet ist.Die Eingabe muss gültig sein AWS-Konten. |
**Asynchrone Fehler**
Die folgenden Fehler beziehen sich spezifisch auf `DescribeChangeSet` Aktionen in. AWS Marketplace Catalog 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\_PRODUCT\_VISIBILITY | Verwenden Sie ein vorhandenes Public oder ein vorhandenes Produkt. Limited Draft |
| UNGÜLTIG\_ AWS\_ACCOUNT\_ID S | Geben Sie gültige AWS-Konto IDs an. AWS-Konten nicht gefunden: [x, y, z]. |
| ValidationException | Für Produkte für professionelle Dienstleistungen gibt es keine Zulassungslisten. Im Gegensatz zu anderen Produkttypen können Produkte für professionelle Dienstleistungen, deren Verfügbarkeit eingeschränkt ist, auf jeden Käufer ausgedehnt werden, ohne dass eine Zulassungsliste erforderlich ist. |
## Aktualisieren Sie die Sichtbarkeit Ihrer Produkte
Sie können die Catalog API verwenden, um die Sichtbarkeit (auch als Lebenszyklusstatus bezeichnet) eines AMI-, Container-, ML- oder SaaS-Produkts in zu aktualisieren AWS Marketplace.
**Anmerkung**
Weitere Informationen zur Aktualisierung der AWS Marketplace Management Portal Produktsichtbarkeit mithilfe von finden Sie in den folgenden Themen im *AWS Marketplace Verkäuferleitfaden*:
AMI-based Produkt: [Aktualisieren Sie die Sichtbarkeit des Produkts](https://docs.aws.amazon.com/marketplace/latest/userguide/ami-single-ami-products.html#ami-update-self-service-visibility)
Container-based Produkt: [Aktualisierung der Produktsichtbarkeit](https://docs.aws.amazon.com/marketplace/latest/userguide/container-product-getting-started.html#container-product-visibility)
SaaS-based Produkt: [Aktualisieren Sie die Sichtbarkeit des Produkts](https://docs.aws.amazon.com/marketplace/latest/userguide/saas-product-settings.html#saas-update-visibility)
Produkt für maschinelles Lernen: [Aktualisierung der Produktsichtbarkeit](https://docs.aws.amazon.com/marketplace/latest/userguide/ml-update-visibility.html)
Zulässige `Limited` Ziellebenszyklusstatus sind`Public`,, oder`Restricted`.
`Limited`
Das Produkt ist vollständig und hat den erfolgreich abgeschlossen `ReleaseProduct``ChangeType`. Verkäufer können in diesem Zustand Details zum Produkt einsehen. Das Produkt ist nicht öffentlich. Verkäufer können jedoch bestimmte Käufer ansprechen, um eine Vorschau des Produkts zu erhalten.
`Public`
Das Produkt ist sichtbar in AWS Marketplace. Käufer können das Produkt ansehen und abonnieren.
`Restricted`
Das Produkt ist für die Öffentlichkeit nicht mehr sichtbar und akzeptiert keine neuen Abonnenten. Bestehende Abonnenten können dieses Produkt weiter verwenden, bis ihr Abonnement abläuft.
**Anmerkung**
Der `UpdateVisibility` Änderungstyp erfordert eine manuelle Überprüfung durch das AWS Marketplace Seller Operations Team, was zu einer längeren Ausführungszeit führt. `UpdateVisibility`Separat in einem eigenen Änderungssatz verwenden.
Um die Sichtbarkeit Ihres Produkts 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": "SaaSProduct@1.0",
"Identifier": "{{prod-example12345}}"
},
"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": "SaaSProduct@1.0",
"Identifier": "{{prod-example12345}}"
},
"DetailsDocument":
{
"TargetVisibility": "Restricted",
"ReplacementProductId": "{{prod-example54321}}"
}
}
]
}
```
Geben Sie Informationen für die Felder an, um den `UpdateVisibility` Änderungstyp hinzuzufügen.
+ `Entity`(Objekt) (erforderlich) — Der benannte Typ der Entität, die erstellt wird.
+ `Identifier`(string) (erforderlich) — Ihre Produkt-ID. Weitere Informationen finden Sie unter [Kennung](catalog-apis.md#identifier).
+ `Type`(string) (erforderlich) — Das `Type` basiert auf der Versandmethode (Produkttyp), die Ihr Produkt verwenden wird:`AmiProduct@1.0`,`SaaSProduct@1.0`,`ContainerProduct@1.0`,`MachineLearningProduct@1.0`. Weitere Informationen finden Sie unter [Kennung](catalog-apis.md#identifier).
+ `DetailsDocument`(object) (erforderlich) — Die Details, die zur Ausführung von erforderlich sind`ChangeSet`.
+
+ `TargetVisibility`— Die beabsichtigte neue Sichtbarkeit des Produkts.
Die möglichen Werte lauten: `Public`, `Limited` und `Restricted`.
+ `ReplacementProductId`(Zeichenfolge) (optional) — Ersatzprodukt-ID für das Produkt, das ersetzt werden soll`Restricted`. Wird verwendet, um aktuelle Abonnenten über die Produkteinschränkung zu informieren.
Akzeptiert nur `Restricted` für`TargetVisibility`.
**Synchrone Validierungen**
Die folgenden Schemavalidierungen sind spezifisch für Aktionen in. `UpdateVisibility` AWS Marketplace Catalog API Diese Validierungen werden durchgeführt, wenn Sie aufrufen. `StartChangeSet` Wenn die Anfrage die folgenden Anforderungen nicht erfüllt, schlägt sie mit einer HTTP-Antwort fehl.
| Art des Targetings | Gültige aktuelle Staaten | ReplacementProductId (Eingabe) | Validierungsprüfungen |
| --- | --- | --- | --- |
| Öffentlich | Limited und Restricted | Nicht zulässig | Gültiger aktueller Status |
| Limited | Öffentlich und Restricted | Nicht zulässig | Gültiger aktueller Status |
| Restricted | Öffentlich und Limited | Zeichenfolge (optional) | ReplacementProductId muss zu einem vorhandenen Limited oder öffentlichen Produkt gehören. |
Nach dem Auslösen dieses Änderungstyps kann es bis zu 37 Tage dauern, bis der Vorgang abgeschlossen ist. Dazu gehört auch die Zeit, die das AWS Marketplace Seller Operations Team zur Prüfung, Prüfung und Genehmigung benötigt. Wenn Sie ein Produkt einschränken, haben Sie 24 Stunden Zeit, Ihre Meinung zu ändern, indem Sie anrufen`CancelChangeSet`, bevor das AWS Marketplace Seller Operations Team mit der Prüfung beginnt. Weitere Informationen finden Sie unter [https://docs.aws.amazon.com/marketplace-catalog/latest/api-reference/API_CancelChangeSet.html](https://docs.aws.amazon.com/marketplace-catalog/latest/api-reference/API_CancelChangeSet.html).
**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. Dies beinhaltete die Überprüfung der Informationen, um sicherzustellen, dass sie den AWS Marketplace Richtlinien entsprechen. Der Validierungsprozess kann zwischen einigen Minuten und einigen Stunden dauern.
Sie können den Status der Anfrage über die oder direkt über die AWS Marketplace Management Portal Catalog API mithilfe des `[DescribeChangeSet](https://docs.aws.amazon.com/marketplace-catalog/latest/api-reference/API_DescribeChangeSet.html)` API-Vorgangs überprüfen.
Wenn die Anfrage abgeschlossen ist (falls `Status` ja`SUCCEEDED`), `ProductId` wird eine neue generiert.
**Asynchrone Fehler**
Die folgenden Fehler beziehen sich spezifisch auf `UpdateVisibility` Aktionen in. AWS Marketplace Catalog 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\_PRODUCT\_STATE | Verwenden Sie ein vorhandenes ProduktPublic, oderLimited. Restricted |
| INVALID\_TARGET\_VISIBILITY | Geben Sie einen gültigen Status für die Zielsichtbarkeit an:Public, oder. Limited Restricted |
| EMPTY\_TARGET\_VISIBILITY | Geben Sie einen gültigen Status für die Zielsichtbarkeit an:, oder. Public Limited Restricted |
| INVALID\_REPLACEMENT\_PRODUCT\_ID | Verwenden Sie ein vorhandenes Produkt oder ein Produkt als Ersatz. Public Limited |
| INVALID\_REPLACEMENT\_PRODUCT\_ID | Die Ersatzprodukt-ID ist nur gültig, wenn ein Produkt eingeschränkt wird. |
| AUDIT\_ERROR | Variiert je nach manueller Überprüfung durch MCO. |
| FEHLENDE ANGABEN ZUM VERKÄUFERPROFIL | Bevor Sie Ihr Produkt auf Öffentlich ändern können, müssen Sie Ihrem Verkäuferkonto ein öffentliches Profil hinzufügen. |
## Veröffentlichen Sie ein Produkt
Sie können die Catalog API verwenden, um ein `Draft` AMI-, Container-, ML- oder SaaS-Produkt in `Limited` State in zu veröffentlichen AWS Marketplace.
**Anmerkung**
Für `AmiProduct@1.0` und `SaaSProduct@1.0` muss der `ReleaseProduct` Änderungstyp vom `ReleaseOffer` Änderungstyp auf dem entsprechenden Entwurf einer öffentlichen `Offer@1.0` Entität begleitet werden, der für dieses Produkt erstellt wurde.
Um ein Produkt zu veröffentlichen, rufen Sie den `StartChangeSet` API-Vorgang mit dem `ReleaseProduct` Änderungstyp auf, wie im folgenden Beispiel gezeigt.
**Anforderungssyntax**
```
POST /StartChangeSet HTTP/1.1
Content-type: application/json
{
"Catalog": "AWSMarketplace",
"ChangeSet":
[
{
"ChangeType": "ReleaseProduct",
"Entity":
{
"Type": "SaaSProduct@1.0",
"Identifier": "{{prod-example12345}}"
},
"DetailsDocument": {}
}
]
}
```
Geben Sie Informationen für die Felder an, die dem `ReleaseProduct` Änderungstyp hinzugefügt werden sollen. Dieser Änderungstyp benötigt keine Parameter-Nutzlast.
+ `Entity`(object) (erforderlich) — Der benannte Typ der Entität, die erstellt wird.
+ `Identifier`(string) (erforderlich) — Ihre Produkt-ID. Weitere Informationen finden Sie unter [Kennung](catalog-apis.md#identifier).
+ `Type`(string) (erforderlich) — Das `Type` basiert auf der Versandmethode (Produkttyp), die Ihr Produkt verwenden wird:`AmiProduct@1.0`,`SaaSProduct@1.0`,`ContainerProduct@1.0`,`MachineLearningProduct@1.0`. Weitere Informationen finden Sie unter [Kennung](catalog-apis.md#identifier).
+ `DetailsDocument`(object) (erforderlich) — Muss ein leeres Objekt sein. Der Änderungstyp `ReleaseProduct` 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. Dies beinhaltete die Überprüfung der Informationen, um sicherzustellen, dass sie den AWS Marketplace Richtlinien entsprechen. Der Validierungsprozess kann zwischen einigen Minuten und einigen Stunden dauern.
Sie können den Status der Anfrage über die oder direkt über die AWS Marketplace Management Portal Catalog API mithilfe des `[DescribeChangeSet](https://docs.aws.amazon.com/marketplace-catalog/latest/api-reference/API_DescribeChangeSet.html)` API-Vorgangs überprüfen.
Wenn die Anfrage abgeschlossen ist (falls `Status` ja`SUCCEEDED`), `ProductId` wird eine neue generiert.
**Asynchrone Fehler**
Die folgenden Fehler beziehen sich spezifisch auf `ReleaseProduct` Aktionen in. AWS Marketplace Catalog 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 |
| --- | --- |
| VALIDATION\_FAILED | Geben Sie Informationen zur Beschreibung ein. |
| VALIDATION\_FEHLGESCHLAGEN | Geben Sie Versionsinformationen an. |
| VALIDATION\_FEHLGESCHLAGEN | Geben Sie Informationen zu den Abmessungen an. |
| VALIDATION\_FEHLGESCHLAGEN | Geben Sie eine Beschreibung an \| \| Informationen. PromotionalResources SupportInformation |
## Finden Sie Ihre Produkt-ID
Sie müssen die Produkt-ID für Ihr Produkt erhalten, bevor Sie es mit der AWS Marketplace Catalog API ändern können. Es gibt zwei Möglichkeiten, die Produkt-ID für Serverprodukte zu finden:
+ Öffnen Sie das AWS Marketplace Management Portal und melden Sie sich mit Ihrem Verkäuferkonto an. Wählen Sie im Menü **Produkte** die Option **Serverprodukte** und dann das Produkt aus, an dem Sie interessiert sind. Die Produkt-ID ist im Abschnitt **Produktübersicht** aufgeführt.
+ Verwenden Sie die [https://docs.aws.amazon.com/marketplace-catalog/latest/api-reference/API_ListEntities.html](https://docs.aws.amazon.com/marketplace-catalog/latest/api-reference/API_ListEntities.html)Aktion mit `EntityType` **AmiProduct** oder**ContainerProduct**,, **SaaSProduct****MachineLearningProduct**, oder, **DataProduct** um über die Katalog-API eine Liste der Produkte, einschließlich ihrer Produkt-IDs, abzurufen. `ListEntities`erfordert, dass Sie die Version des Entitätstyps nicht angeben (z. B.`AmiProduct@1.0`).
**Anmerkung**
Die Produkt-ID ist erst verfügbar, nachdem Ihr Produkt veröffentlicht wurde, und ist zumindest für Sie sichtbar AWS Marketplace. Wenn Sie Ihr Produkt zum ersten Mal erstellen, kann es mehrere Tage dauern, bis es überprüft und vollständig erstellt ist. Während dieser Zeit ist keine Produkt-ID verfügbar.
In den folgenden Themen wird erklärt, wie Sie ein Produkt finden, indem Sie nach der Entitäts-ID, dem Produkttitel, dem Datum der letzten Änderung oder der Sichtbarkeit filtern.
**Topics**
+ [Finden Sie ein Produkt anhand des Produkttitels](#find-product-using-title)
+ [Finden Sie ein Produkt anhand des Datums der letzten Änderung](#find-product-using-last-mod-date)
+ [Finden Sie ein Produkt auf der Grundlage der Produktsichtbarkeit](#find-product-using-visibility)
+ [Finden Sie ein Produkt anhand des Produkttitels, des Datums der letzten Änderung und der Sichtbarkeit des Produkts](#find-product-using-all)
+ [Holen Sie sich zusätzliche Informationen zu einem Produkt](#get-additional-details)
### Finden Sie ein Produkt anhand des Produkttitels
**Anforderung**
```
POST /ListEntities HTTP/1.1
Content-Type: application/json
{
"Catalog": "AWSMarketplace",
"EntityType": "AmiProduct",
"MaxResults": 10,
"EntityTypeFilters": {
"AmiProductFilters": {
"ProductTitle": {
"WildCardValue": "{{XYZ}}"
}
}
}
}
```
**Antwort**
```
HTTP/1.1 200
Content-type: application/json
{
"EntitySummaryList": [
{
"EntityArn": "arn:aws:aws-marketplace:{{us-east-1}}:{{123456789012}}:AWSMarketplace/AmiProduct/example-abcd-1234",
"EntityId": "example1-abcd-1234-5ef6-7890abcdef12@1",
"EntityType": "AmiProduct",
"LastModifiedDate": "2018-02-27T13:45:22Z",
"AmiProductSummary": {
"ProductTitle": "{{ABC-XYZ-123}}",
"Visibility": "Public"
}
}
],
"NextToken": ""
}
```
### Finden Sie ein Produkt anhand des Datums der letzten Änderung
**Anforderung**
```
POST /ListEntities HTTP/1.1
Content-Type: application/json
{
"Catalog": "AWSMarketplace",
"EntityType": "AmiProduct",
"MaxResults": 10,
"EntityTypeFilters": {
"AmiProductFilters": {
"LastModifiedDate": {
"DateRange": {
"BeforeValue": "{{2018-03-27T13:45:22Z}}",
"AfterValue": "{{2018-01-27T13:45:22Z}}"
}
}
}
}
}
```
**Antwort**
```
HTTP/1.1 200
Content-type: application/json
{
"EntitySummaryList": [
{
"EntityArn": "arn:aws:aws-marketplace:{{us-east-1}}:{{123456789012}}:AWSMarketplace/AmiProduct/example-abcd-1234",
"EntityId": "{{example1-abcd-1234-5ef6-7890abcdef12@1}}",
"EntityType": "AmiProduct",
"LastModifiedDate": "{{2018-02-27T13:45:22Z}}",
"AmiProductSummary": {
"ProductTitle": "{{ABC-XYZ-123}}",
"Visibility": "Public"
}
}
],
"NextToken": ""
}
```
### Finden Sie ein Produkt auf der Grundlage der Produktsichtbarkeit
**Anforderung**
```
POST /ListEntities HTTP/1.1
Content-Type: application/json
{
"Catalog": "AWSMarketplace",
"EntityType": "AmiProduct",
"MaxResults": 10,
"EntityTypeFilters": {
"AmiProductFilters": {
"Visibility": {
"ValueList": [
"Public"
]
}
}
}
}
```
**Antwort**
```
HTTP/1.1 200
Content-type: application/json
{
"EntitySummaryList": [
{
"EntityArn": "arn:aws:aws-marketplace:{{us-east-1}}:{{123456789012}}:AWSMarketplace/AmiProduct/example-abcd-1234",
"EntityId": "{{example1-abcd-1234-5ef6-7890abcdef12@1}}",
"EntityType": "AmiProduct",
"LastModifiedDate": "{{2018-02-27T13:45:22Z}}",
"AmiProductSummary": {
"ProductTitle": "{{ABC-XYZ-123}}",
"Visibility": "Public"
}
}
],
"NextToken": ""
}
```
### Finden Sie ein Produkt anhand des Produkttitels, des Datums der letzten Änderung und der Sichtbarkeit des Produkts
**Anforderung**
```
POST /ListEntities HTTP/1.1
Content-Type: application/json
{
"Catalog": "AWSMarketplace",
"EntityType": "AmiProduct",
"MaxResults": 10,
"EntityTypeFilters": {
"AmiProductFilters": {
"LastModifiedDate": {
"DateRange": {
"BeforeValue": "{{2018-03-27T13:45:22Z}}",
"AfterValue": "{{2018-01-27T13:45:22Z}}"
}
},
"Visibility": {
"ValueList": [
"Public"
]
},
"ProductTitle": {
"ValueList": [
"{{ABC-XYZ-123}}"
]
}
}
}
}
```
**Antwort**
```
HTTP/1.1 200
Content-type: application/json
{
"EntitySummaryList": [
{
"EntityArn": "arn:aws:aws-marketplace:{{us-east-1}}:{{123456789012}}:AWSMarketplace/AmiProduct/example-abcd-1234",
"EntityId": "example1-abcd-1234-5ef6-7890abcdef12@1",
"EntityType": "AmiProduct",
"LastModifiedDate": "{{2018-02-27T13:45:22Z}}",
"AmiProductSummary": {
"ProductTitle": "{{ABC-XYZ-123}}",
"Visibility": "Public"
}
}
],
"NextToken": ""
}
```
### Holen Sie sich zusätzliche Informationen zu einem Produkt
Sie können zusätzliche Informationen über das Produkt erhalten, indem Sie die Entitäts-ID mit der `DescribeEntity` Aktion verwenden.
**Anforderung**
```
GET /DescribeEntity?catalog=AWSMarketplace&entityId={{example-abcd-1234}} HTTP/1.1
```
**Antwort**
```
HTTP/1.1 200
Content-type: application/json
{
"DetailsDocument": {
"ProductTitle": "{{ABC-XYZ-123}}",
"ShortDescription": "{{My product short description.}}",
"LongDescription": "{{My product longer description.}}",
"Sku": "123example456",
"SupportDescription": "{{Need help? Contact our experts at support@example.com \n\nYour purchase includes 24x7 support.}}",
"Categories": [
"Operating Systems",
"Network Infrastructure",
"Application Development"
]
}
"EntityArn": "arn:aws:aws-marketplace:{{us-east-1}}:{{123456789012}}:AWSMarketplace/AmiProduct/{{example-abcd-1234}}",
"EntityId": "{{example1-abcd-1234-5ef6-7890abcdef12@1}}",
"EntityType": "AmiProduct",
"LastModifiedDate": "{{2018-02-27T13:45:22Z}}",
}
```
## Status und Fehler des Sets ändern
Um Änderungen an Verkäuferprodukten in der AWS Marketplace Katalog-API vorzunehmen, müssen Sie Änderungssätze erstellen, die die Änderungen beschreiben, die Sie vornehmen möchten, und dann die `StartChangeSet` Aktion verwenden, um die Änderungen zu starten. Je nach Anfrage kann es Minuten bis Stunden oder länger dauern, bis die Änderungen an der Anfrage abgeschlossen sind. Die Antwort auf diese Anfrage sieht wie folgt aus.
```
{
"ChangeSetId": "{{example123456789012abcdef}}",
"ChangeSetArn": "arn:aws:aws-marketplace:{{us-east-1}}:{{123456789012}}:AWSMarketplace/ChangeSet/{{example123456789012abcdef}}"
}
```
Die Änderungsanfrage wird einer Warteschlange hinzugefügt und bearbeitet. Dazu gehört auch das Scannen der Dateien und Informationen, um sicherzustellen, dass sie den AWS Marketplace Produktrichtlinien entspricht. Je nach Änderungsanforderung kann dieser Vorgang einige Minuten bis Tage dauern. Sie können den Status der Anfrage über die AWS Marketplace Management Portal oder in der Katalog-API mit der `DescribeChangeSet` Aktion überprüfen. Weitere Informationen über Änderungssätze finden Sie unter [Mit Änderungssätzen arbeiten](catalog-apis.md#working-with-change-sets).
Verwenden Sie die `DescribeChangeSet` Aktion, um den Status Ihrer Anfrage zu überprüfen.
```
POST /DescribeChangeSet HTTP/1.1
Content-type: application/json
{
"Catalog": "AWSMarketplace",
"ChangeSetID": "{{{{example123456789012abcdef}}}}"
}
```
Das Ergebnis dieses Aufrufs sieht wie folgt aus (in diesem Fall für das Hinzufügen einer neuen Version zu einem Containerprodukt).
```
{
"ChangeSetId": "{{example123456789012abcdef}}",
"ChangeSetArn": "arn:aws:aws-marketplace:{{us-east-1}}:{{123456789012}}:AWSMarketplace/ChangeSet/{{example123456789012abcdef}}",
"ChangeSetName": "Submitted by {{123456789012}}",
"StartTime": "{{2020-10-27T22:21:26Z}}",
"EndTime": "{{2020-10-27T22:32:19Z}}",
"Status": "SUCCEEDED",
"ChangeSet":
[
{
"ChangeType": "AddDeliveryOptions",
"Entity":
{
"Type": "ContainerProduct@1.0",
"Identifier": "{{example-1234-abcd-56ef-abcdef12345678@4}}"
},
"Details": "{\"Version\": {\"VersionTitle\": \"1.1\",\"ReleaseNotes\": \"Minor bug fix\"},\"DeliveryOptions\": [{\"DeliveryOptionTitle\": \"EKSDelivery\",\"Details\": {\"EcrDeliveryOptionDetails\" : {\"ContainerImages\": [\"{{111122223333}}.dkr.ecr.us-east-1.amazonaws.com/sellername/reponame1:1.1\"],\"DeploymentResources\": [{\"Name\": \"HelmDeploymentTemplate\",\"Url\": \"{{111122223333}}.dkr.ecr.us-east-1.amazonaws.com/sellername/reponame2:mychart1.1\"}],\"CompatibleServices\": [\"EKS\"],\"Description\": \"Sample Description\",\"UsageInstructions\":\"helm pull {{111122223333}}.dkr.ecr.us-east-1.amazonaws.com/sellername/reponame2:mychart1.1\"}}},{\"DeliveryOptionTitle\": \"HelmChartDeliveryOption\",\"Details\": {\"HelmDeliveryOptionDetails\": {\"CompatibleServices\": [\"EKS\", \"EKS-Anywhere\"],\"ContainerImages\": [\"{{111122223333}}.dkr.ecr.us-east-1.amazonaws.com/sellername/reponame1:1.1\"],\"HelmChartUri\": \"{{111122223333}}.dkr.ecr.us-east-1.amazonaws.com/sellername/reponame1:helmchart1.1\",\"Description\": \"Helm chart description\",\"UsageInstructions\": \"Usage instructions\",\"MarketplaceServiceAccountName\": \"Service account name\",\"ReleaseName\": \"Optional release name\",\"Namespace\": \"Optional Kubernetes namespace\",\"OverrideParameters\": [{\"Key\": \"HelmKeyName1\",\"DefaultValue\": \"${AWSMP_LICENSE_SECRET}\"},{\"Key\": \"HelmKeyName2\",\"DefaultValue\": \"${AWSMP_SERVICE_ACCOUNT}\"}]}}}]}",
"DetailsDocument":
{
"Version":
{
"VersionTitle": "1.1",
"ReleaseNotes": "Minor bug fix"
},
"DeliveryOptions":
[
{
"DeliveryOptionTitle": "EKSDelivery",
"Details":
{
"EcrDeliveryOptionDetails":
{
"ContainerImages":
[
"{{111122223333}}.dkr.ecr.us-east-1.amazonaws.com/sellername/reponame1:1.1"
],
"DeploymentResources":
[
{
"Name": "HelmDeploymentTemplate",
"Url": "{{111122223333}}.dkr.ecr.us-east-1.amazonaws.com/sellername/reponame2:mychart1.1"
}
],
"CompatibleServices":
[
"EKS"
],
"Description": "Sample Description",
"UsageInstructions": "helm pull {{111122223333}}.dkr.ecr.us-east-1.amazonaws.com/sellername/reponame2:mychart1.1"
}
}
},
{
"DeliveryOptionTitle": "HelmChartDeliveryOption",
"Details":
{
"HelmDeliveryOptionDetails":
{
"CompatibleServices":
[
"EKS",
"EKS-Anywhere"
],
"ContainerImages":
[
"{{111122223333}}.dkr.ecr.us-east-1.amazonaws.com/sellername/reponame1:1.1"
],
"HelmChartUri": "{{111122223333}}.dkr.ecr.us-east-1.amazonaws.com/sellername/reponame1:helmchart1.1",
"Description": "Helm chart description",
"UsageInstructions": "Usage instructions",
"MarketplaceServiceAccountName": "Service account name",
"ReleaseName": "Optional release name",
"Namespace": "Optional Kubernetes namespace",
"OverrideParameters":
[
{
"Key": "HelmKeyName1",
"DefaultValue": "${AWSMP_LICENSE_SECRET}"
},
{
"Key": "HelmKeyName2",
"DefaultValue": "${AWSMP_SERVICE_ACCOUNT}"
}
]
}
}
}
]
},
"ErrorDetailList":
[]
}
]
}
```
Das `Status` Feld zeigt den aktuellen Status der Anfrage an, in diesem Fall`SUCCEEDED`.
Wenn Fehler auftreten, kann das Ergebnis zwei Arten von Fehlern enthalten. Bei den meisten Fehlern ist die Fehlermeldung direkt enthalten. Fehler, die beim Scannen des Produkts auf Sicherheitslücken gefunden wurden, enthalten jedoch stattdessen eine URL zu einer Datei, in der alle gefundenen Fehler in dem `ErrorMessage` Feld aufgeführt sind. Fehler, die beim Scannen gefunden wurden, haben das `ErrorCode` Zeichen "`SCAN_ERROR`“.
```
{
"ChangeSetId": "{{example123456789012abcdef}}",
"ChangeSetArn": "arn:aws:aws-marketplace:{{us-east-1}}:{{123456789012}}:AWSMarketplace/ChangeSet/{{example123456789012abcdef}}",
"ChangeSetName": "Submitted by {{123456789012}}",
"StartTime": "{{2020-10-27T22:21:26Z}}",
"EndTime": "{{2020-10-27T22:32:19Z}}",
"Status": "FAILED",
"FailureDescription": "Change set preparation has failed. For details see 'ErrorDetailList'.",
"ChangeSet":
[
{
"ChangeType": "AddDeliveryOptions",
"Entity":
{
"Type": "ContainerProduct@1.0",
"Identifier": "{{example-1234-abcd-56ef-abcdef12345678@4}}"
},
"Details": "{\"Version\": {\"VersionTitle\": \"1.1\",\"ReleaseNotes\": \"Minor bug fix\"},\"DeliveryOptions\": [{\"DeliveryOptionTitle\": \"EKSDelivery\",\"Details\": {\"EcrDeliveryOptionDetails\" : {\"ContainerImages\": [\"{{111122223333}}.dkr.ecr.us-east-1.amazonaws.com/sellername/reponame1:1.1\"],\"DeploymentResources\": [{\"Name\": \"HelmDeploymentTemplate\",\"Url\": \"{{111122223333}}.dkr.ecr.us-east-1.amazonaws.com/sellername/reponame2:mychart1.1\"}],\"CompatibleServices\": [\"EKS\"],\"Description\": \"Sample Description\",\"UsageInstructions\":\"helm pull {{111122223333}}.dkr.ecr.us-east-1.amazonaws.com/sellername/reponame2:mychart1.1\"}}},{\"DeliveryOptionTitle\": \"HelmChartDeliveryOption\",\"Details\": {\"HelmDeliveryOptionDetails\": {\"CompatibleServices\": [\"EKS\", \"EKS-Anywhere\"],\"ContainerImages\": [\"{{111122223333}}.dkr.ecr.us-east-1.amazonaws.com/sellername/reponame1:1.1\"],\"HelmChartUri\": \"{{111122223333}}.dkr.ecr.us-east-1.amazonaws.com/sellername/reponame1:helmchart1.1\",\"Description\": \"Helm chart description\",\"UsageInstructions\": \"Usage instructions\",\"MarketplaceServiceAccountName\": \"Service account name\",\"ReleaseName\": \"Optional release name\",\"Namespace\": \"Optional Kubernetes namespace\",\"OverrideParameters\": [{\"Key\": \"HelmKeyName1\",\"DefaultValue\": \"${AWSMP_LICENSE_SECRET}\"},{\"Key\": \"HelmKeyName2\",\"DefaultValue\": \"${AWSMP_SERVICE_ACCOUNT}\"}]}}}]}",
"DetailsDocument":
{
"Version":
{
"VersionTitle": "1.1",
"ReleaseNotes": "Minor bug fix"
},
"DeliveryOptions":
[
{
"DeliveryOptionTitle": "EKSDelivery",
"Details":
{
"EcrDeliveryOptionDetails":
{
"ContainerImages":
[
"{{111122223333}}.dkr.ecr.us-east-1.amazonaws.com/sellername/reponame1:1.1"
],
"DeploymentResources":
[
{
"Name": "HelmDeploymentTemplate",
"Url": "{{111122223333}}.dkr.ecr.us-east-1.amazonaws.com/sellername/reponame2:mychart1.1"
}
],
"CompatibleServices":
[
"EKS"
],
"Description": "Sample Description",
"UsageInstructions": "helm pull {{111122223333}}.dkr.ecr.us-east-1.amazonaws.com/sellername/reponame2:mychart1.1"
}
}
},
{
"DeliveryOptionTitle": "HelmChartDeliveryOption",
"Details":
{
"HelmDeliveryOptionDetails":
{
"CompatibleServices":
[
"EKS",
"EKS-Anywhere"
],
"ContainerImages":
[
"{{111122223333}}.dkr.ecr.us-east-1.amazonaws.com/sellername/reponame1:1.1"
],
"HelmChartUri": "{{111122223333}}.dkr.ecr.us-east-1.amazonaws.com/sellername/reponame1:helmchart1.1",
"Description": "Helm chart description",
"UsageInstructions": "Usage instructions",
"MarketplaceServiceAccountName": "Service account name",
"ReleaseName": "Optional release name",
"Namespace": "Optional Kubernetes namespace",
"OverrideParameters":
[
{
"Key": "HelmKeyName1",
"DefaultValue": "${AWSMP_LICENSE_SECRET}"
},
{
"Key": "HelmKeyName2",
"DefaultValue": "${AWSMP_SERVICE_ACCOUNT}"
}
]
}
}
}
]
},
"ErrorDetailList":
[
{
"ErrorCode": "DUPLICATE_VERSION_TITLE",
"ErrorMessage": "The version title must be different from any other version titles of this product."
},
{
"ErrorCode": "SCAN_ERROR",
"ErrorMessage": "https://123sample456.cloudfront.net/example-1234-abcd-5678-abcdef12345678/1234abcdef567890"
}
]
}
]
}
```
In diesem Beispiel wurde ein Fehler direkt gemeldet (`DUPLICATE_VERSION_TITLE`). Bei dem anderen Fehler handelt es sich um eine Datei mit Fehlermeldungen (bei einem einzelnen Fehler `SCAN_ERROR` können mehrere Fehler in der verknüpften Datei gefunden werden).
**Anmerkung**
Der in der zurückgegebene Link `ErrorMessage` ist 60 Tage gültig.