Die AWS Marketplace-API-Referenz wurde umstrukturiert. 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 privaten Angeboten mithilfe der AWS Marketplace APIs
Sie können den verwenden AWS Marketplace Catalog API , um Aufgaben für die Arbeit mit Angeboten zu automatisieren.
Während das * Produkt * beschreibt AWS Marketplace, in welchem Umfang verkauft wird, * beschreibt das * Angebot die Bedingungen und Regeln, wie ein Produkt gekauft und konsumiert wird. AWS Marketplace Für Produkte können mehrere Angebote von verschiedenen Verkäufern angeboten werden. Jedes AWS Marketplace Angebot kann jedoch nur für ein Produkt erstellt werden. Ein * Angebot * enthält eine Sammlung von Vertragsbedingungen zwischen zwei Parteien. Die angenommenen Angebotsbedingungen werden in eine Vereinbarung als Nachweis einer Transaktion übersetzt.
Es gibt zwei Arten von Angeboten:
+ **Bei privaten Angeboten ** können Verkäufer und Käufer die Preise aushandeln. Verkäufer unterzeichnen eine Endbenutzer-Lizenzvereinbarung (EULA) für Softwarekäufe in. AWS Marketplace Ein Angebot ist nur für einen bestimmten Käufer sichtbar. Weitere Informationen finden Sie [ im *AWS Marketplace Verkäuferleitfaden unter *](https://docs.aws.amazon.com/marketplace/latest/userguide/private-offers-overview.html) Private Angebote.
+ **Öffentliche Angebote ** gelten für globale Einkaufsprogramme. Verkäufer identifizieren Kunden anhand verfügbarer Programme und geografischer Standorte, sodass das Angebot nur bestimmten Kunden zugänglich ist.
Weitere Informationen finden Sie in den folgenden Ressourcen:
+ Beispiele für funktionierenden Code finden Sie [ im *AWS Marketplace Verkäufer-Workshop unter Angebote mit API *](https://catalog.workshops.aws/mpseller/en-US/manage-offers-with-api) verwalten.
+ Codebeispiele für API-Anfragen finden Sie unter [ Python ](https://github.com/aws-samples/aws-marketplace-reference-code/tree/main/python/src/catalog_api/offers) - und [https://github.com/aws-samples/aws-marketplace-reference-code/tree/main/java/resources/changeSets/offers](https://github.com/aws-samples/aws-marketplace-reference-code/tree/main/java/resources/changeSets/offers) Java-Beispiele unter *AWS Beispiele * auf GitHub.
+ Ein Video zum Erstellen von privaten Angeboten finden Sie unter [ Erstellen eines privaten Angebots mithilfe der AWS Marketplace Katalog-API ](https://www.youtube.com/watch?v=Gg9JR0tB330) auf YouTube.
+ Ein Video zur Aktualisierung der AMI-Preise finden Sie unter [ Aktualisieren der AMI-Produktpreise mithilfe der AWS Marketplace Catalog API ](https://www.youtube.com/watch?v=AVIRlzHKEJw) auf YouTube.
In den folgenden Themen wird beschrieben, wie Sie die Catalog API verwenden, um Angebote zu erstellen und zu aktualisieren:
**Topics**
+ [Erstellen Sie ein Angebot](#create-offer)
+ [Erstellen Sie ein Ersatzangebot](#create-replacement-offer)
+ [Angebotsinformationen aktualisieren](#update-offer-information)
+ [Targeting-Konfiguration aktualisieren](#update-targeting-offers)
+ [Rückerstattungsrichtlinie aktualisieren](#update-support-terms)
+ [Rechtliche Ressourcen aktualisieren](#update-legal-terms)
+ [Preise aktualisieren](#update-pricing-terms)
+ [Aktualisiere die Auffindbarkeit des Angebots](#update-availability)
+ [Definieren Sie das Ablaufdatum von Verträgen, die mithilfe des Angebots erstellt wurden](#update-validity-terms)
+ [Details zum Zahlungsplan aktualisieren](#update-payment-schedule-terms)
+ [Nettozahlungsbedingungen aktualisieren](#update-net-payment-terms)
+ [Verlängerungsoptionen ändern](#update-renewal-terms)
+ [Veröffentlichen Sie ein Angebot](#release-offer)
+ [Beschreiben Sie die vorhandenen Angebotsdetails](#describe-entity)
## Erstellen Sie ein Angebot
Sie können die Katalog-API verwenden, um ein neues Angebot in zu erstellen AWS Marketplace. Wenn Ihre Anfrage erfolgreich bearbeitet wird, wird ein `Draft` unvollständiges Angebot AWS Marketplace Catalog API erstellt, das für Käufer unsichtbar ist. Verwenden Sie den `Update` Änderungstyp, um ein Angebot abzuschließen. Wenn das Angebot vollständig ist, verwenden Sie den [`ReleaseOffer`](#release-offer) Änderungstyp, um es zu erstellen und zu veröffentlichen. Wenn Sie ein Angebot veröffentlichen, wird es validiert und für Käufer sichtbar in AWS Marketplace.
Um ein neues Angebot zu erstellen, rufen Sie den `StartChangeSet` API-Vorgang mit dem `CreateOffer` Änderungstyp auf, wie im folgenden Beispiel gezeigt.
**Anforderungssyntax**
```
POST /StartChangeSet HTTP/1.1
Content-type: application/json
{
"Catalog": "AWSMarketplace",
"ChangeSet": [
{
"ChangeType": "CreateOffer",
"Entity": {
"Type": "Offer@1.0"
},
"DetailsDocument": {
"ProductId": "prod-ad8EXAMPLE51",
"Name": "Test Offer",
"OfferSetId": "offerset-b3f9EXAMPLE27"
}
}
]
}
```
Geben Sie Informationen für die Felder ein, um den `CreateOffer` Änderungstyp hinzuzufügen:
+ **Entität ** (Objekt) (erforderlich) — Ihr Angebot.
+ **Typ ** (Zeichenfolge) (erforderlich) — Das `Type` ist immer`Offer@1.0`.
+ **DetailsDocument**(Objekt) (erforderlich) — Der JSON-Wert der Einzelheiten der Anfrage.
+ **ProductId**(string) (erforderlich) — Die eindeutige Kennung des angebotenen Produkts.
+ **Name ** (Zeichenfolge) (optional) — Der Name, der dem Angebot zugeordnet ist, um es für Sie und Ihre Kunden besser lesbar zu machen. Er wird auch als Teil der Vertragsinformationen angezeigt.
+ **OfferSetId**(string) (optional) — Die ID des Angebotssets, dem dieses Angebot zugeordnet werden soll. Geben Sie dieses Feld nur an, wenn Sie ein Angebot erstellen, das Teil eines Angebotssets sein wird. Wenn OfferSetId es nicht angegeben wird, wird ein individuelles Angebot erstellt, das eigenständig gekauft werden kann. Beachten Sie, dass die Angabe eines OfferSetId bei der Angebotserstellung nur Ihre Absicht signalisiert, das Angebot diesem Angebotssatz zuzuordnen. Um die Zuordnung abzuschließen, müssen Sie den AssociateOffers Änderungstyp [ verwenden, ](work-with-offer-sets.md#associate-offers) nachdem das Angebot erstellt wurde.
**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 AWS Marketplace Management Portal oder direkt über die Catalog API mithilfe der `[DescribeChangeSet](https://docs.aws.amazon.com/marketplace-catalog/latest/api-reference/API_DescribeChangeSet.html)` API-Operation überprüfen.
Wenn ja`SUCCEEDED`, `Status` wird ein neues `OfferId` generiert.
Die Antwort sieht wie folgt aus.
```
{
"ChangeSetId": "example123456789012abcdef",
"ChangeSetArn": "arn:aws:aws-marketplace:us-east-1:123456789012:AWSMarketplace/ChangeSet/example123456789012abcdef",
"ChangeSetName": "Submitted by 123456789012",
"StartTime": "2021-05-27T22:21:26Z",
"EndTime": "2021-05-27T22:32:19Z",
"Status": "SUCCEEDED",
"ChangeSet": [
{
"ChangeType": "CreateOffer",
"Entity": {
"Type": "Offer@1.0",
"Identifier": "offer-123456789"
},
"DetailsDocument": {
"ProductId": "prod-ad8EXAMPLE51",
"Name": "Test Offer"
},
"ErrorDetailList": []
}
]
}
```
**Synchrone Validierungen **
Die folgenden Schemavalidierungen sind spezifisch für Aktionen in der. `CreateOffer` AWS Marketplace Catalog API Diese Validierungen werden durchgeführt, wenn Sie anrufen. `StartChangeSet` Wenn die Anfrage die folgenden Anforderungen nicht erfüllt, schlägt sie mit einer HTTP-Antwort fehl.
| Eingabefeld | Validierungsregel | HTTP-Code |
| --- | --- | --- |
| ProductId | Erforderlich
Die Länge muss zwischen 1 und 50 Zeichen liegen
Darf keine unzulässigen Zeichen enthalten (\\, <, >) | 422 |
| ProductId | ErforderlichDer Benutzer muss berechtigt sein, ein Angebot für das angegebene Produkt zu erstellen | 403 |
| ProductId | ErforderlichEs muss sich um ein bereits im Katalog vorhandenes Produkt handeln oder es muss im selben Änderungssatz erstellt werden | 404 |
| Name | Optional
Die Länge muss zwischen 1 und 150 Zeichen liegen
Darf keine unzulässigen Zeichen enthalten (\\, <, >) | 422 |
**Asynchrone Fehler **
Die folgenden Fehler beziehen sich spezifisch auf `CreateOffer` Aktionen in der. AWS Marketplace Catalog API Diese Fehler werden zurückgegeben, wenn Sie `DescribeChangeSet` nach der Verarbeitung eines Änderungssatzes aufrufen. Weitere Hinweise zur Verwendung`DescribeChangeSet`, um den Status einer Änderungsanforderung abzurufen, finden Sie unter[Mit Änderungssätzen arbeiten](catalog-apis.md#working-with-change-sets).
| Fehlercode | Fehlermeldung |
| --- | --- |
| INKOMPATIBELES\_PRODUKT | Verwenden Sie ein aktives Produkt in unserem Bundesstaat. Limited Public |
| INKOMPATIBLE\_PRODUKT | Die Verwaltung von Angeboten für den von Ihnen ausgewählten Produkttyp wird derzeit in der nicht unterstützt. AWS Marketplace Catalog API |
| INKOMPATIBLE\_PRODUKT | Die Verwaltung von Angeboten für das Produkt wird derzeit in der nicht unterstützt. AWS Marketplace Catalog API |
| INKOMPATIBLE\_PRODUKT | OfferSetId wird in Angeboten für das Produkt nicht unterstützt. |
| INKOMPATIBLE\_PRODUKT | CreateOffer Der Änderungstyp kann nicht aufgerufen werden, um ein Angebot für das Produkt zu erstellen. Verwenden Sie CreateOfferUsingResaleAuthorization den Änderungstyp. |
## Erstellen Sie ein Ersatzangebot
Sie können die Katalog-API verwenden, um ein Ersatzangebot (auch als vertragsbasiertes Angebot bezeichnet) in zu erstellen. AWS Marketplace
Wenn Ihre Anfrage erfolgreich bearbeitet wurde, AWS Marketplace Catalog API wird für Sie ein unvollständiges Angebot generiert, das für Käufer nicht sichtbar ist. `Draft` AWS Marketplace Sie werden die `Update` Änderungsarten verwenden, um das Angebot abzuschließen. Nachdem das Angebot abgeschlossen ist, verwenden Sie den [`ReleaseOffer`](#release-offer) Änderungstyp, um den Prozess der Angebotserstellung abzuschließen und das Angebot zu veröffentlichen. Dadurch wird das gesamte Angebot validiert und Ihr Angebot wird für Käufer unter angezeigt AWS Marketplace. Von dort aus hat der Käufer die Möglichkeit, das Ersatzangebot anzunehmen oder das Geschäft gemäß der ursprünglichen Vereinbarung fortzusetzen.
Um ein Ersatzangebot zu erstellen, rufen Sie den `StartChangeSet` API-Vorgang mit dem `CreateReplacementOffer` Änderungstyp auf und geben Sie eine bereits bestehende Vertrags-ID an, wie im folgenden Beispiel gezeigt.
**Anforderungssyntax**
```
POST /StartChangeSet HTTP/1.1
Content-type: application/json
{
"Catalog": "AWSMarketplace",
"ChangeSet": [
{
"ChangeType": "CreateReplacementOffer",
"Entity": {
"Type": "Offer@1.0"
},
"DetailsDocument": {
"AgreementId": "agmt-12345",
"Name": "Offer name"
}
}
]
}
```
Geben Sie Informationen für die Felder ein, um den `CreateReplacementOffer` Änderungstyp hinzuzufügen:
+ **Entität ** (Objekt) (erforderlich) — Ihr Angebot.
+ **Typ ** (Zeichenfolge) (erforderlich) — Das `Type` ist immer`Offer@1.0`.
+ **DetailsDocument**(Objekt) (erforderlich) — Der JSON-Wert der Einzelheiten der Anfrage.
+ **AgreementId**(string) (erforderlich) — Die eindeutige Kennung für die aktuelle Vereinbarung, die ersetzt werden soll.
+ **Name ** (Zeichenfolge) (optional) — Der Name, der dem Angebot zugeordnet ist, um es für Sie und Ihre Kunden besser lesbar zu machen. Er wird auch als Teil der Vertragsinformationen angezeigt.
**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 AWS Marketplace Management Portal oder direkt über die Catalog API mithilfe der `[DescribeChangeSet](https://docs.aws.amazon.com/marketplace-catalog/latest/api-reference/API_DescribeChangeSet.html)` API-Operation überprüfen.
**Synchrone Validierungen **
Die folgenden Schemavalidierungen sind spezifisch für Aktionen in der. `CreateReplacementOffer` AWS Marketplace Catalog API Diese Validierungen werden durchgeführt, wenn Sie anrufen. `StartChangeSet` Wenn die Anfrage die folgenden Anforderungen nicht erfüllt, schlägt sie mit einer HTTP-Antwort fehl.
| Eingabefeld | Validierungsregel | HTTP-Code |
| --- | --- | --- |
| AgreementId | ErforderlichDie Länge muss zwischen 1 und 64 Zeichen liegen | 422 |
| AgreementId | ErforderlichDer Benutzer muss berechtigt sein, ein Angebot für die angegebene Vereinbarung zu erstellen | 403 |
| Name | OptionalDie Länge muss zwischen 1 und 150 Zeichen liegen
Darf keine ungültigen Zeichen enthalten (\\, <, >) | 422 |
**Asynchrone Fehler **
Die folgenden Fehler beziehen sich spezifisch auf `CreateReplacementOffer` Aktionen in der. AWS Marketplace Catalog API Diese Fehler werden zurückgegeben, wenn Sie `DescribeChangeSet` nach der Verarbeitung eines Änderungssatzes aufrufen. Weitere Hinweise zur Verwendung`DescribeChangeSet`, um den Status einer Änderungsanforderung abzurufen, finden Sie unter[Mit Änderungssätzen arbeiten](catalog-apis.md#working-with-change-sets).
| Fehlercode | Fehlermeldung |
| --- | --- |
| INKOMPATIBELES\_PRODUKT | Ersatzangebote für das Produkt werden nicht unterstützt. |
| INKOMPATIBELE\_VEREINBARUNG | CreateReplacementOffer Der Änderungstyp kann nicht aufgerufen werden, um ein Ersatzangebot für die Vereinbarung zu erstellen. Verwenden Sie CreateReplacementOfferUsingResaleAuthorization den Änderungstyp. |
## Angebotsinformationen aktualisieren
Sie können die Katalog-API verwenden, um die Angebotsinformationen in zu aktualisieren AWS Marketplace.
Um die Angebotsinformationen zu aktualisieren, rufen Sie den `StartChangeSet` API-Vorgang mit dem `UpdateInformation` Änderungstyp auf, wie im folgenden Beispiel gezeigt. Alle anderen Informationen bleiben unverändert.
**Anforderungssyntax**
```
POST /StartChangeSet HTTP/1.1
Content-type: application/json
{
"Catalog": "AWSMarketplace",
"ChangeSet": [
{
"ChangeType": "UpdateInformation",
"Entity": {
"Type": "Offer@1.0",
"Identifier": "offer-123456789"
},
"DetailsDocument": {
"Name": "New offer name",
"Description": "New offer description",
"PreExistingAgreement": {
"AcquisitionChannel": "External",
"PricingModel": "Contract"
}
}
}
]
}
```
Geben Sie Informationen für die Felder ein, um den `UpdateInformation` Änderungstyp hinzuzufügen:
+ **Entität ** (Objekt) (erforderlich) — Ihr Angebot.
+ **Typ ** (Zeichenfolge) (erforderlich) — Das `Type` ist immer`Offer@1.0`.
+ **Identifier ** (string) (erforderlich) — Ihre Angebots-ID. Weitere Informationen finden Sie unter [Kennung](catalog-apis.md#identifier).
+ **DetailsDocument**(Objekt) (erforderlich) — Der JSON-Wert der Einzelheiten der Anfrage.
+ **Name ** (string) (optional) — Der Name, der dem Angebot zur besseren Lesbarkeit zugeordnet ist. Er wird als Teil der Vertragsinformationen angezeigt.
+ **Beschreibung ** (Zeichenfolge) (optional) — Ein Text in freier Form, der nur von Ihnen verwendet werden soll und für Käufer niemals sichtbar sein wird.
+ **PreExistingAgreement**(Objekt) (optional) — Legt fest, ob es sich bei diesem Angebot um eine Verlängerung einer bestehenden Vereinbarung mit einem bestehenden Kunden für dasselbe Basisprodukt handelt. Die bestehende Vereinbarung kann innerhalb oder außerhalb des Vertrags abgeschlossen werden AWS Marketplace. AWS kann prüfen und verifizieren, dass es sich bei Ihrem Angebot um eine Verlängerung handelt. Wenn AWS Ihr Angebot nicht verifiziert werden kann, AWS kann das Angebot und die damit verbundenen Rechte Ihrem Kunden entzogen werden.
+ **AcquisitionChannel**(string) (erforderlich) — Gibt an, ob die bestehende Vereinbarung außerhalb AWS Marketplace oder innerhalb AWS Marketplace unterzeichnet wurde.
Mögliche Werte: `External`, `AwsMarketplace`
+ **PricingModel**(string) (erforderlich) — Gibt an, welches Preismodell die bestehende Vereinbarung verwendet.
Mögliche Werte: `Contract`, `Usage`, `Byol`, `Free`
**Syntax der Antwort **
Für Ihre Anfrage wird ein Änderungssatz erstellt. Die Antwort auf diese Anfrage gibt Ihnen das `ChangeSetId` und `ChangeSetArn` für den Änderungssatz und sieht wie folgt aus.
```
{
"ChangeSetId": "example123456789012abcdef",
"ChangeSetArn": "arn:aws:aws-marketplace:us-east-1:123456789012:AWSMarketplace/ChangeSet/example123456789012abcdef"
}
```
Die Änderungsanforderung wird einer Warteschlange hinzugefügt und verarbeitet. Dazu gehört auch die Überprüfung von Informationen, um sicherzustellen, dass sie den AWS Marketplace Richtlinien entsprechen. Der Validierungsvorgang kann einige Minuten dauern.
Sie können den Status der Anfrage über die AWS Marketplace Management Portal oder direkt über die Catalog API mithilfe der `[DescribeChangeSet](https://docs.aws.amazon.com/marketplace-catalog/latest/api-reference/API_DescribeChangeSet.html)` API-Operation überprüfen.
**Synchrone Validierungen **
Die folgenden Schemavalidierungen sind spezifisch für Aktionen in der. `UpdateInformation` AWS Marketplace Catalog API Diese Validierungen werden durchgeführt, wenn Sie anrufen. `StartChangeSet` Wenn die Anfrage die folgenden Anforderungen nicht erfüllt, schlägt sie mit einer HTTP-Antwort fehl.
| Eingabefeld | Validierungsregel | HTTP-Code |
| --- | --- | --- |
| Eigenschaften | Mindestens eine der folgenden Eigenschaften muss bereitgestellt werden | 422 |
| Name | Optional
Die Länge muss zwischen 1 und 150 Zeichen liegen
Darf keine unzulässigen Zeichen enthalten (\\, <, >) | 422 |
| Description | Optional
Die Länge muss zwischen 1 und 255 Zeichen liegen | 422 |
| PreExistingAgreement | OptionalKann Null sein, um `PreExistingAgreement` aus dem Angebot entfernt zu werden | 422 |
| PreExistingAgreement.PricingModel | Erforderlich
Kann einer der folgenden Werte sein: [`Byol`,`Free`,`Usage`,`Contract`] | 422 |
| PreExistingAgreement.AcquisitionChannel | Erforderlich
Kann einer der folgenden Werte sein: [`AwsMarketplace`,`External`] | 422 |
**Asynchrone Fehler **
Die folgenden Fehler beziehen sich spezifisch auf `UpdateInformation` Aktionen in der. AWS Marketplace Catalog API Diese Fehler werden zurückgegeben, wenn Sie `DescribeChangeSet` nach der Verarbeitung eines Änderungssatzes aufrufen. Weitere Hinweise zur Verwendung`DescribeChangeSet`, um den Status einer Änderungsanforderung abzurufen, finden Sie unter[Mit Änderungssätzen arbeiten](catalog-apis.md#working-with-change-sets).
| Fehlercode | Fehlermeldung |
| --- | --- |
| INKOMPATIBLE\_PRE\_EXISTING\_AGREEMENT | PreExistingAgreement kann nach der Veröffentlichung des Angebots nicht mehr geändert werden. |
## Targeting-Konfiguration aktualisieren
Sie können die Catalog-API verwenden, um die Targeting-Konfiguration Ihres Angebots in zu aktualisieren AWS Marketplace.
Alle vorhandenen Targeting-Optionen, die nicht in der letzten Anfrage enthalten sind und aus dem Angebot entfernt werden.
**Anmerkung**
Ein Angebot kann optional `PositiveTargeting` oder`NegativeTargeting`, aber nicht beides beinhalten.
**Optionen für positives Targeting: **
**Nur Ländercodes ** — Erstellt ein öffentliches Angebot, das Käufern in den angegebenen Ländern zur Verfügung steht.
**Nur Käuferkonten ** — Erstellt ein privates Angebot, das auf bestimmte AWS-Konten ausgerichtet ist.
**Sowohl Ländercodes als auch Käuferkonten ** — Erstellt ein privates Angebot, bei dem Zielkunden das Angebot nur annehmen können, wenn sie sich in einem der angegebenen Länder befinden.
**Optionen für negatives Targeting: **
**Ländercodes ** — Schließt Käufer aus den angegebenen Ländern aus. Dadurch entsteht ein öffentliches Angebot, das allen Ländern außer den aufgeführten Ländern zur Verfügung steht.
Um die Targeting-Konfiguration Ihres Angebots zu aktualisieren, 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": "Offer@1.0",
"Identifier": "offer-123456789"
},
"DetailsDocument": {
"PositiveTargeting": {
"CountryCodes": [
"US",
"CA"
],
"BuyerAccounts": [
"111122223333"
]
},
"NegativeTargeting": {
"CountryCodes": [
"XX"
]
}
}
}
]
}
```
Geben Sie Informationen für die Felder ein, um den `UpdateTargeting` Änderungstyp hinzuzufügen:
+ **Entität ** (Objekt) (erforderlich) — Ihr Angebot.
+ **Typ ** (Zeichenfolge) (erforderlich) — Das `Type` ist immer`Offer@1.0`.
+ **Identifier ** (string) (erforderlich) — Ihre Angebots-ID. Weitere Informationen finden Sie unter [Kennung](catalog-apis.md#identifier).
+ **DetailsDocument**(Objekt) (erforderlich) — Der JSON-Wert der Einzelheiten der Anfrage.
+ **PositiveTargeting**(Objekt) (optional) — Positives Targeting definiert die Kriterien, die das Profil eines Käufers erfüllen muss, um auf das Angebot zugreifen zu können. Dieses Feld ist optional, aber mindestens eine Targeting-Option sollte angegeben werden, wenn dieses Feld vorhanden ist.
+ **CountryCodes**(Zeichenkettenarray) (optional) — Liste als Option, um eine länderspezifische Ausrichtung zu ermöglichen. Wenn das Angebot nicht auf ein Land ausgerichtet werden soll, sollte dieses Feld weggelassen werden. Wenn es vorhanden ist, muss die Liste mindestens eine Landesvorwahl enthalten. Jedes Element in dieser Liste sollte ein gültiger 2-Buchstaben-Ländercode sein und das folgende Format verwenden: ISO 3166-1 Alpha-2.
+ **BuyerAccounts**(Zeichenkettenarray) (optional) — Liste als Option, auf deren Grundlage Targeting möglich ist AWS-Konten (auch bekannt als Privatangebot). Wenn das Angebot nicht auf eine Person ausgerichtet werden soll AWS-Konto, sollte dieses Feld weggelassen werden.
+ **NegativeTargeting**(Objekt) (optional) — Negatives Targeting definiert die Kriterien, die jedes Kundenprofil erfüllen muss, um den Zugriff auf das Angebot einzuschränken. Obwohl dieses Feld optional ist, sollte mindestens eine Targeting-Option angegeben werden, wenn dieses Feld vorhanden ist.
+ **CountryCodes**(Zeichenkettenarray) (erforderlich) — Liste als Option, um eine länderspezifische Ausrichtung zu ermöglichen. Wenn das Angebot nicht auf ein bestimmtes Land ausgerichtet werden soll, sollte dieses Feld weggelassen werden. Wenn es vorhanden ist, muss die Liste mindestens eine Landesvorwahl enthalten. Jedes Element in dieser Liste sollte ein gültiger 2-Buchstaben-Ländercode in diesem Format sein: ISO 3166-1 Alpha-2.
**Syntax der Antwort **
Für Ihre Anfrage wird ein Änderungssatz erstellt. Die Antwort auf diese Anfrage gibt Ihnen das `ChangeSetId` und `ChangeSetArn` für den Änderungssatz und sieht wie folgt aus.
```
{
"ChangeSetId": "example123456789012abcdef",
"ChangeSetArn": "arn:aws:aws-marketplace:us-east-1:123456789012:AWSMarketplace/ChangeSet/example123456789012abcdef"
}
```
Die Änderungsanforderung wird einer Warteschlange hinzugefügt und verarbeitet. Dazu gehört auch die Überprüfung von Informationen, um sicherzustellen, dass sie den AWS Marketplace Richtlinien entsprechen. Der Validierungsvorgang kann einige Minuten dauern.
Sie können den Status der Anfrage über die AWS Marketplace Management Portal oder direkt über die Catalog API mithilfe der `[DescribeChangeSet](https://docs.aws.amazon.com/marketplace-catalog/latest/api-reference/API_DescribeChangeSet.html)` API-Operation überprüfen.
**Synchrone Validierungen **
Die folgenden Schemavalidierungen sind spezifisch für Aktionen in der. `UpdateTargeting` AWS Marketplace Catalog API Diese Validierungen werden durchgeführt, wenn Sie anrufen. `StartChangeSet` Wenn die Anfrage die folgenden Anforderungen nicht erfüllt, schlägt sie mit einer HTTP-Antwort fehl.
| Eingabefeld | Validierungsregel | HTTP-Code |
| --- | --- | --- |
| NegativeTargeting | Optional
Kann eine der folgenden Optionen haben: [`CountryCodes`] | 422 |
| NegativeTargeting.CountryCodes | Optional
Die Listengröße muss zwischen 1 und 244 liegen
Ländercodes müssen gültig sein (ISO 3166-1 Alpha-2) | 422 |
| PositiveTargeting | Optional
Kann eine der folgenden Optionen haben: [,] `CountryCodes` `BuyerAccounts` | 422 |
| PositiveTargeting.BuyerAccounts | Optional
Die Listengröße muss zwischen 1 und 26 liegen
AWS-Konto Die IDs müssen ein gültiges Format haben (12-stellige Zahl) | 422 |
| PositiveTargeting.CountryCodes | Optional
Die Listengröße muss zwischen 1 und 244 liegen
Die Ländercodes müssen gültig sein (ISO 3166-1 Alpha-2) | 422 |
**Asynchrone Fehler **
Die folgenden Fehler beziehen sich spezifisch auf `UpdateTargeting` Aktionen in der. AWS Marketplace Catalog API Diese Fehler werden zurückgegeben, wenn Sie `DescribeChangeSet` nach der Verarbeitung eines Änderungssatzes aufrufen. Weitere Hinweise zur Verwendung`DescribeChangeSet`, um den Status einer Änderungsanforderung abzurufen, finden Sie unter[Mit Änderungssätzen arbeiten](catalog-apis.md#working-with-change-sets).
| Fehlercode | Fehlermeldung |
| --- | --- |
| UNGÜLTIGE\_KÄUFERKONTEN | Geben Sie gültige Käuferkonten an. Ungültige Konten: [x]. |
| UNGÜLTIGE\_LÄNDERCODES | Geben Sie die unterstützten Ländercodes an. |
| UNGÜLTIGES TARGETING | Verwenden Sie entweder negatives oder positives Targeting für dasselbe Attribut. |
| INKOMPATIBLE\_PRODUKT | Country-based Targeting wird für das Produkt nicht unterstützt. |
| INKOMPATIBLE\_WIEDERVERKAUFSAUTORISIERUNG | Stellen Sie sicher, dass sie mit dem kompatibel sind. BuyerAccounts ResaleAuthorization |
| INKOMPATIBLE\_TARGETING | Die angeforderte Änderung kann nicht mehr durchgeführt werden, nachdem das Angebot veröffentlicht wurde. |
| INKOMPATIBLE\_TARGETING | Die angeforderte Änderung kann nicht mehr durchgeführt werden, nachdem das Angebot abgelaufen ist. |
| INKOMPATIBLE\_TARGETING | Das Targeting kann bei einem Ersatzangebot nicht aktualisiert werden. Wenn der Käufer dem angegebenen Angebot nicht zugeordnet ist AgreementId, erstellen Sie ein neues privates Angebot, indem Sie ein dem Käufer AgreementId zugeordnetes Angebot bereitstellen. |
| ZU\_VIELE\_KÄUFERKONTEN | Geben Sie innerhalb der zulässigen Grenzen an. BuyerAccounts |
| INKOMPATIBLE\_TARGETING | BuyerAccounts kann nicht entfernt werden, nachdem das Angebot veröffentlicht wurde. |
| INKOMPATIBLE\_TARGETING | BuyerAccounts kann nicht hinzugefügt werden, nachdem das Angebot veröffentlicht wurde. |
| FEHLEN\_LÄNDERCODES | Versehen Sie PositiveTargeting mit CountryCodes: [x]. |
| INKOMPATIBLE\_LÄNDERCODES | Stellen Sie sicher, dass sie kompatibel sind. CountryCodes |
| INKOMPATIBLE\_KÄUFERKONTEN | Stellen Sie sicher, dass BuyerAccounts sie mit der Vereinbarung vereinbar sind. |
## Rückerstattungsrichtlinie aktualisieren
Sie können die Katalog-API verwenden, um die Rückerstattungsrichtlinien Ihres Angebots in zu aktualisieren AWS Marketplace.
Diese Änderung wirkt sich nicht auf bestehende Vereinbarungen aus. Die Supportbedingungen, die nicht in der letzten Anfrage enthalten sind, werden aus dem Angebot entfernt.
Um die Rückerstattungsrichtlinie zu aktualisieren, rufen Sie den `StartChangeSet` API-Vorgang mit dem `UpdateSupportTerms` Änderungstyp auf, wie im folgenden Beispiel gezeigt.
**Anforderungssyntax**
```
POST /StartChangeSet HTTP/1.1
Content-type: application/json
{
"Catalog": "AWSMarketplace",
"ChangeSet": [
{
"ChangeType": "UpdateSupportTerms",
"Entity": {
"Type": "Offer@1.0",
"Identifier": "offer-123456789"
},
"DetailsDocument": {
"Terms": [
{
"Type": "SupportTerm",
"RefundPolicy": "Updated refund policy description"
}
]
}
}
]
}
```
Geben Sie Informationen für die Felder ein, um den `UpdateSupportTerms` Änderungstyp hinzuzufügen:
+ **Entität ** (Objekt) (erforderlich) — Ihr Angebot.
+ **Typ ** (Zeichenfolge) (erforderlich) — Das `Type` ist immer`Offer@1.0`.
+ **Identifier ** (string) (erforderlich) — Ihre Angebots-ID. Weitere Informationen finden Sie unter [Kennung](catalog-apis.md#identifier).
+ **DetailsDocument**(Objekt) (erforderlich) — Der JSON-Wert der Einzelheiten der Anfrage.
+ **Begriffe ** (Reihe von Strukturen) (erforderlich) — Liste der Support-Begriffe, die Sie aktualisieren möchten. Folgende Supportbedingungen werden akzeptiert:
+ **SupportTerm**(Objekt) (erforderlich) — Definiert den Kundensupport, der den Akzeptoren beim Kauf der Software zur Verfügung steht.
+ **Type ** (string) (erforderlich) — Typ des Begriffs, der aktualisiert wird. Dies ist der Objektwert:`"SupportTerm"`.
+ **RefundPolicy**(string) (erforderlich) — Free-text Feld mit der Beschreibung der Rückerstattungsrichtlinie, die den Kunden so angezeigt wird, wie sie auf der Website und der Konsole ist.
**Syntax der Antwort **
Für Ihre Anfrage wird ein Änderungssatz erstellt. Die Antwort auf diese Anfrage gibt Ihnen das `ChangeSetId` und `ChangeSetArn` für den Änderungssatz und sieht wie folgt aus.
```
{
"ChangeSetId": "example123456789012abcdef",
"ChangeSetArn": "arn:aws:aws-marketplace:us-east-1:123456789012:AWSMarketplace/ChangeSet/example123456789012abcdef"
}
```
Die Änderungsanforderung wird einer Warteschlange hinzugefügt und verarbeitet. Dazu gehört auch die Überprüfung von Informationen, um sicherzustellen, dass sie den AWS Marketplace Richtlinien entsprechen. Der Validierungsvorgang kann einige Minuten dauern.
Sie können den Status der Anfrage über die AWS Marketplace Management Portal oder direkt über die Catalog API mithilfe der `[DescribeChangeSet](https://docs.aws.amazon.com/marketplace-catalog/latest/api-reference/API_DescribeChangeSet.html)` API-Operation überprüfen.
**Synchrone Validierungen **
Die folgenden Schemavalidierungen sind spezifisch für Aktionen in der. `UpdateSupportTerms` AWS Marketplace Catalog API Diese Validierungen werden durchgeführt, wenn Sie anrufen. `StartChangeSet` Wenn die Anfrage die folgenden Anforderungen nicht erfüllt, schlägt sie mit einer HTTP-Antwort fehl.
| Eingabefeld | Validierungsregel | HTTP-Code |
| --- | --- | --- |
| Bedingungen | Erforderlich | 422 |
| Bedingungen []. RefundPolicy | Erforderlich
Die Länge muss zwischen 1 und 500 liegen
Darf nicht mit Leerzeichen beginnen oder enden | 422 |
| Begriffe [] .Type | ErforderlichKann nur sein `SupportTerm` | 422 |
**Asynchrone Fehler **
Die folgenden Fehler beziehen sich spezifisch auf `UpdateSupportTerms` Aktionen in der. AWS Marketplace Catalog API Diese Fehler werden zurückgegeben, wenn Sie `DescribeChangeSet` nach der Verarbeitung eines Änderungssatzes aufrufen. Weitere Hinweise zur Verwendung`DescribeChangeSet`, um den Status einer Änderungsanforderung abzurufen, finden Sie unter[Mit Änderungssätzen arbeiten](catalog-apis.md#working-with-change-sets).
| Fehlercode | Fehlermeldung |
| --- | --- |
| INKOMPATIBELES\_PRODUKT | SupportTerm wird in privaten Angeboten für das Produkt nicht unterstützt. |
| INKOMPATIBLE\_BEGRIFFE | SupportTerm wird für kostenlose Testangebote nicht unterstützt. |
| INKOMPATIBLE\_BEGRIFFE | Die angeforderte Änderung kann nach der Veröffentlichung des Angebots nicht mehr durchgeführt werden. |
| INKOMPATIBLE\_BEGRIFFE | Die angeforderte Änderung kann nach Ablauf des Angebots nicht mehr durchgeführt werden. |
## Rechtliche Ressourcen aktualisieren
Sie können die Catalog API verwenden, um die vorhandenen rechtlichen Dokumente, wie z. B. eine Endbenutzer-Lizenzvereinbarung (EULA), zu ersetzen. Die rechtlichen Bestimmungen, die nicht in der letzten Anfrage enthalten sind, werden aus dem Angebot entfernt.
Um die rechtlichen Ressourcen Ihres Angebots zu aktualisieren, rufen Sie den `StartChangeSet` API-Vorgang mit dem `UpdateLegalTerms` Änderungstyp auf, wie im folgenden Beispiel gezeigt.
**Anforderungssyntax**
```
POST /StartChangeSet HTTP/1.1
Content-type: application/json
{
"Catalog": "AWSMarketplace",
"ChangeSet": [
{
"ChangeType": "UpdateLegalTerms",
"Entity": {
"Type": "Offer@1.0",
"Identifier": "offer-123456789"
},
"DetailsDocument": {
"Terms": [
{
"Type": "LegalTerm",
"Documents": [
{
"Type": "CustomEula",
"Url": "https://s3.amazonaws.com/EULA/custom-eula-1234.txt"
}
]
}
]
}
}
]
}
```
Geben Sie Informationen für die Felder ein, um den `UpdateLegalTerms` Änderungstyp hinzuzufügen:
+ **Entität ** (Objekt) (erforderlich) — Ihr Angebot.
+ **Typ ** (Zeichenfolge) (erforderlich) — Das `Type` ist immer`Offer@1.0`.
+ **Identifier ** (string) (erforderlich) — Ihre Angebots-ID. Weitere Informationen finden Sie unter [Kennung](catalog-apis.md#identifier).
+ **DetailsDocument**(Objekt) (erforderlich) — Der JSON-Wert der Einzelheiten der Anfrage.
+ **LegalTerm**(Objekt) (erforderlich) — Definiert die Liste der Textvereinbarungen, die den Akzeptoren vorgeschlagen werden sollen. Ein Beispiel für eine solche Vereinbarung ist die Endbenutzer-Lizenzvereinbarung (EULA).
+ **Typ ** (Zeichenfolge) (erforderlich) — Typ des Begriffs, der aktualisiert wird. Dies ist der Objektwert:`"LegalTerm"`.
+ **Dokumente ** (Reihe von Strukturen) (erforderlich) — Liste mit Verweisen auf rechtliche Ressourcen, die den Käufern vorgeschlagen werden sollen. Ein Beispiel für eine solche Ressource ist der Endbenutzer-Lizenzvertrag (EULA). Jede Referenz besteht aus a `Type` und a`URL`:
+ **Type ** (string) (erforderlich) — Art des Dokuments. Verfügbare Dokumenttypen sind:
+ **CustomEula**— Eine benutzerdefinierte EULA, die von Ihnen als Verkäufer bereitgestellt wird. Für diesen Dokumenttyp [ ist entweder eine öffentliche S3-URL oder eine ](https://docs.aws.amazon.com/AmazonS3/latest/userguide/ShareObjectPreSignedURL.html) vorsignierte URL erforderlich.
+ **StandardEula**— Standardvertrag für AWS Marketplace (SCMP). Weitere Informationen zu SCMP finden Sie im AWS Marketplace Verkäuferleitfaden. Sie geben für diesen Typ keine URL an, da er von AWS Marketplace verwaltet wird.
+ **Url ** (string) (bedingt erforderlich) — Eine URL zum rechtlichen Dokument, das Käufer lesen können. Erforderlich, wenn `Type` eine der folgenden Bedingungen zutrifft: [`CustomEula`].
+ **Version ** (Zeichenfolge) (bedingt erforderlich) — Version der Standardverträge, bereitgestellt von AWS Marketplace. Erforderlich, wenn [`StandardEula`] `Type` ist. Verfügbare Version:
+ **14.07.2022 ** — Diese Version des Standardvertrags für AWS Marketplace ist in diesem Amazon S3-Bucket verfügbar: [ https://s3.amazonaws.com/aws-mp-standard-contracts/Standard-Contact-for-AWS-Marketplace-2022-07-14.pdf ](https://s3.amazonaws.com/aws-mp-standard-contracts/Standard-Contact-for-AWS-Marketplace-2022-07-14.pdf)
**Syntax der Antwort **
Für Ihre Anfrage wird ein Änderungssatz erstellt. Die Antwort auf diese Anfrage gibt Ihnen das `ChangeSetId` und `ChangeSetArn` für den Änderungssatz und sieht wie folgt aus.
```
{
"ChangeSetId": "example123456789012abcdef",
"ChangeSetArn": "arn:aws:aws-marketplace:us-east-1:123456789012:AWSMarketplace/ChangeSet/example123456789012abcdef"
}
```
Die Änderungsanforderung wird einer Warteschlange hinzugefügt und verarbeitet. Dazu gehört auch die Überprüfung von Informationen, um sicherzustellen, dass sie den AWS Marketplace Richtlinien entsprechen. Der Validierungsvorgang kann einige Minuten dauern.
Sie können den Status der Anfrage über die AWS Marketplace Management Portal oder direkt über die Catalog API mithilfe der `[DescribeChangeSet](https://docs.aws.amazon.com/marketplace-catalog/latest/api-reference/API_DescribeChangeSet.html)` API-Operation überprüfen.
**Synchrone Validierungen **
Die folgenden Schemavalidierungen sind spezifisch für Aktionen in der. `UpdateLegalTerms` AWS Marketplace Catalog API Diese Validierungen werden durchgeführt, wenn Sie anrufen. `StartChangeSet` Wenn die Anfrage die folgenden Anforderungen nicht erfüllt, schlägt sie mit einer HTTP-Antwort fehl.
| Eingabefeld | Validierungsregel | HTTP-Code |
| --- | --- | --- |
| Bedingungen | Erforderlich
Nur `LegalTerm` ist in der Liste erlaubt
Die Listengröße muss 1 sein | 422 |
| Begriffe [] .Type | ErforderlichKann nur sein `LegalTerm` | 422 |
| Bedingungen []. LegalTerm.Documents | Erforderlich | 422 |
| Bedingungen []. LegalTerm.Documents[] .Typ | Erforderlich
Zulässige Werte:+ `CustomEula`
+ `StandardEula` | 422 |
| Begriffe []. LegalTerm.Documents[] .Url | Erforderlich und muss eine gültige URL sein, wenn Type CustomEula | 422 |
| Bedingungen []. LegalTerm.Documents[] .Version | Erforderlich und muss eine gültige Version sein, wenn TypeStandardEulaGültige `StandardEula` Versionen: ["2019-04-24", „2022-07-14"] | 422 |
**Asynchrone Fehler **
Die folgenden Fehler beziehen sich spezifisch auf `UpdateLegalTerms` Aktionen in der. AWS Marketplace Catalog API Diese Fehler werden zurückgegeben, wenn Sie `DescribeChangeSet` nach der Verarbeitung eines Änderungssatzes aufrufen. Weitere Hinweise zur Verwendung`DescribeChangeSet`, um den Status einer Änderungsanforderung abzurufen, finden Sie unter[Mit Änderungssätzen arbeiten](catalog-apis.md#working-with-change-sets).
| Fehlercode | Fehlermeldung |
| --- | --- |
| INKOMPATIBLE\_BEGRIFFE | Die angeforderte Änderung kann nach der Veröffentlichung des Angebots nicht mehr durchgeführt werden. |
| INKOMPATIBLE\_BEGRIFFE | Die angeforderte Änderung kann nach Ablauf des Angebots nicht mehr durchgeführt werden. |
| UNGÜLTIGE\_LEGALE\_DOKUMENTE | Stellen Sie URLs für Rechtsdokumente bereit, die in zugänglichen S3-Buckets gespeichert sind. |
| UNGÜLTIGE\_LEGALE\_DOKUMENTE | Für neue Angebote wird nur die neueste Version von unterstützt StandardEula . |
| UNGÜLTIGE\_LEGALE\_DOKUMENTE | Stellen Sie juristische Dokumente in den unterstützten Dateiformaten bereit. |
| UNGÜLTIGE\_LEGALE\_DOKUMENTE | Stellen Sie Rechtsdokumente mithilfe der unterstützten Dokumenttypen bereit. |
| BESCHRÄNKTE\_GESETZLICHE\_DOKUMENTGRÖSSE ÜBERSCHRITTEN | Stellen Sie legale Dokumente innerhalb der zulässigen Größenbeschränkungen bereit. |
| UNGÜLTIGE\_LEGALE\_DOKUMENTE | LegalTerm enthält kennwortgeschützte Dokumente. Stellen Sie zugängliche Dokumente bereit LegalTerm. |
| UNGÜLTIGE\_LEGALE\_DOKUMENTE | LegalTerm enthält ungültige PDF-Dokumente. Stellen Sie zugängliche Dokumente bereit LegalTerm. |
## Preise aktualisieren
Sie können die Katalog-API verwenden, um die bestehenden Preisbedingungen vollständig zu ersetzen. Die Preisbedingungen, die nicht in der letzten Anfrage enthalten sind, werden aus dem Angebot entfernt.
Um die Preisbedingungen für Ihr Angebot zu aktualisieren, rufen Sie den `StartChangeSet` API-Vorgang mit dem `UpdatePricingTerms` Änderungstyp auf, wie im folgenden Beispiel gezeigt.
**Anmerkung**
Die folgende Anforderungssyntax kombiniert mehrere Beispiele. Diese Kombination funktioniert nicht als gültige Nutzlast. Ein `Terms` Array kann beispielsweise nicht sowohl den Begriffstyp `FixedUpfrontPricingTerm` als auch den Begriffstyp `ConfigurableUpfrontPricingTerm` enthalten. Beispiele dafür, wie verschiedene Begriffstypen für unterschiedliche Anwendungsfälle bei der Preisgestaltung kombiniert werden, finden Sie [ im *AWS Marketplace Verkäufer-Workshop unter Angebote mit API *](https://catalog.workshops.aws/mpseller/en-US/manage-offers-with-api) verwalten.
**Anmerkung**
Bei SaaS-Produkten mit kostenlosem Preismodell müssen Sie eines `UsageBasedPricingTerm` oder `ConfigurableUpfrontPricingTerm` mindestens eine RateCard (Dimension) angeben, bei der alle Preise auf 0,00$ festgelegt sind. Diese Anforderung gilt nur für SaaS-Produkte.
**Anforderungssyntax**
```
POST /StartChangeSet HTTP/1.1
Content-type: application/json
{
"Catalog": "AWSMarketplace",
"ChangeSet": [
{
"ChangeType": "UpdatePricingTerms",
"Entity": {
"Type": "Offer@1.0",
"Identifier": "offer-123456789"
},
"DetailsDocument": {
"PricingModel": "Usage",
"Terms": [
{
"Type": "UsageBasedPricingTerm",
"CurrencyCode": "USD",
"RateCards": [
{
"RateCard": [
{
"DimensionKey": "m3.large",
"Price": "0.10"
},
{
"DimensionKey": "m4.xlarge",
"Price": "0.20"
}
]
}
]
},
{
"Type": "ConfigurableUpfrontPricingTerm",
"CurrencyCode": "USD",
"RateCards": [
{
"Selector": {
"Type": "Duration",
"Value": "P365D"
},
"RateCard": [
{
"DimensionKey": "m3.large",
"Price": "300"
},
{
"DimensionKey": "m4.xlarge",
"Price": "400"
}
],
"Constraints": {
"MultipleDimensionSelection": "Allowed",
"QuantityConfiguration": "Allowed"
}
}
]
},
{
"Type": "ByolPricingTerm"
},
{
"Type": "RecurringPaymentTerm",
"CurrencyCode": "USD",
"BillingPeriod": "Monthly",
"Price": "100.0"
},
{
"Type": "FixedUpfrontPricingTerm",
"CurrencyCode": "USD",
"Price": "200.00",
"Grants": [
{
"DimensionKey": "Users",
"MaxQuantity": 10
}
]
},
{
"Type": "FreeTrialPricingTerm",
"Duration": "P30D",
"Grants": [
{
"DimensionKey": "m3.xlarge",
"MaxQuantity": 10
},
{
"DimensionKey": "m4.xlarge",
"MaxQuantity": 10
}
]
}
]
}
}
]
}
```
Geben Sie Informationen für die Felder ein, um den `UpdatePricingTerms` Änderungstyp hinzuzufügen:
+ **Entität ** (Objekt) (erforderlich) — Ihr Angebot.
+ **Typ ** (Zeichenfolge) (erforderlich) — Das `Type` ist immer`Offer@1.0`.
+ **Identifier ** (string) (erforderlich) — Ihre Angebots-ID. Weitere Informationen finden Sie unter [Kennung](catalog-apis.md#identifier).
+ **DetailsDocument**(Objekt) (erforderlich) — Der JSON-Wert der Einzelheiten der Anfrage.
+ **PricingModel**(string) (erforderlich) — Preismodell für Ihr Angebot. Mögliche Werte für das Preismodell sind:
+ **Nutzung ** — Usage-based Preismodell, bei dem den Käufern die Nutzung Ihres Produkts in Rechnung gestellt wird.
+ **Vertrag ** — Contract-based Preismodell, bei dem den Käufern entweder die Nutzung Ihres Produkts im Voraus in Rechnung gestellt wird, oder es wird ein flexibler Zahlungsplan angeboten. Käufer können auch für eine zusätzliche Nutzung bezahlen, die über ihren Vertrag hinausgeht.
+ **Kostenlos ** — Kostenloses Preismodell, bei dem Käufern die Nutzung des Produkts nicht in Rechnung gestellt wird. Wenn Sie dieses Preismodell verwenden, können keine Preisbedingungen oder eine Laufzeit des Zahlungsplans Tarife enthalten, die von Null abweichen.
+ **Byol ** — Byol-Preismodell, bei dem Käufer ihre eigene Lizenz für die Nutzung des Produkts mitbringen.
+ **Bedingungen ** (Reihe von Strukturen) (erforderlich) — Liste der Preisbedingungen, die Sie aktualisieren möchten. Folgende Preisbedingungen werden unterstützt:
+ **FreeTrialPricingTerm**(Objekt) — Definiert ein kurzfristiges kostenloses Preismodell, bei dem den Käufern innerhalb eines bestimmten Limits nichts berechnet wird.
+ **Type ** (string) — Typ des Begriffs, der aktualisiert wird. Dies ist der Objektwert:`"FreeTrialPricingTerm"`.
+ **Dauer ** (Zeichenfolge) — Dauer des kostenlosen Testzeitraums.
+ **Zuschüsse ** (verschiedene Strukturen) — Ansprüche, die dem Nutzer einer kostenlosen Testversion im Rahmen der Vertragsdurchführung gewährt werden.
+ **DimensionKey**(string) — Eindeutiger Dimensionsschlüssel, der im Produktdokument definiert ist. Die Abmessungen stellen die Kategorien der Kapazität eines Produkts dar und werden angegeben, wenn das Produkt in der Liste aufgeführt wird AWS Marketplace.
+ **MaxQuantity**(Ganzzahl) (optional) — Die maximale Kapazität, die dem Käufer bei einer bestimmten Produktabmessung zustehen kann. Wenn sie `MaxQuantity` nicht angegeben wird, kann der Käufer eine unbegrenzte Menge der angegebenen Größe nutzen.
+ **UsageBasedPricingTerm**(Objekt) — Definiert ein Pay-as-you-go-Preismodell (PAYG), bei dem den Kunden die Abrechnung auf der Grundlage der Produktnutzung erfolgt.
+ **Type ** (string) (erforderlich) — Kategorie des Begriffs, der aktualisiert wird. Dies ist der Objektwert:`UsageBasedPricingTerm`.
+ **CurrencyCode**(string) — Definiert die Währung für die in diesem Begriff genannten Preise. Derzeit wird nur USD unterstützt.
+ **RateCards**(Reihe von Strukturen) — Liste der Preiskarten.
+ **RateCard**(Anordnung von Strukturen) — Eine Preiskarte definiert die Preise pro Einheit für die Produktabmessungen.
+ **DimensionKey**(string) — Dimension, für die der angegebene Anspruch gilt. Die Abmessungen stellen die Kategorien der Kapazität eines Produkts dar und werden angegeben, wenn das Produkt in angeboten wird. AWS Marketplace
+ **Preis ** (Zeichenfolge) — Per-unit Preis für die Produktdimension, der für die Berechnung des Betrags verwendet wird, der dem Käufer in Rechnung gestellt wird.
+ **ConfigurableUpfrontPricingTerm**(Objekt) — Definiert ein im Voraus bezahltes Zahlungsmodell, das es Käufern ermöglicht, die Ansprüche, die sie kaufen möchten, und die Dauer der Ansprüche zu konfigurieren. Sie können die Liste der Tarife für jede Vertragsdauer und die Ansprüche für jede Dimension aktualisieren.
+ **Typ ** (Zeichenfolge) (erforderlich) — Typ der Bedingung, die aktualisiert wird. Dies ist der Objektwert:`ConfigurableUpfrontPricingTerm`.
+ **CurrencyCode**(string) (erforderlich) — Definiert die Währung für die in diesem Begriff genannten Preise. Für öffentliche Angebote werden nur USD unterstützt. Für private Angebote werden USD, AUD, EUR, GBP und JPY unterstützt.
+ **RateCards**(Reihe von Strukturen) (erforderlich) — Liste der Preiskarten.
+ **Selector ** (Objekt) (erforderlich) — Der Selector wird verwendet, um zwischen den sich gegenseitig ausschließenden Preislisten derselben Preiskategorie zu unterscheiden, die vom Käufer ausgewählt werden müssen.
+ **Typ ** (Zeichenfolge) (erforderlich) — Kategorie des Selektors. Derzeit `Duration` wird nur unterstützt.
+ **Wert ** (Zeichenfolge) (erforderlich) — Vertragsdauer. Dieses Feld unterstützt das ISO 8601-Format.
+ **RateCard**(Anordnung von Strukturen) (erforderlich) — Eine Preiskarte definiert die Preise pro Einheit für die Produktabmessungen.
+ **DimensionKey**(string) (erforderlich) — Eindeutiger Dimensionsschlüssel, der im Produktdokument definiert ist. Die Abmessungen stellen die Kategorien der Kapazität eines Produkts dar und werden angegeben, wenn das Produkt im Angebot aufgeführt wird AWS Marketplace.
+ **Preis ** (Zeichenfolge) (erforderlich) — Per-unit Preis für die Produktabmessung, anhand dessen der Betrag berechnet wird, der dem Käufer in Rechnung gestellt wird.
+ **Einschränkungen ** (Objekt) (erforderlich) — Definiert Einschränkungen, anhand derer der Begriff von den Akzeptoren konfiguriert werden kann.
**Anmerkung**
Derzeit müssen ** MultipleDimensionSelection ** die ** QuantityConfiguration ** Werte identisch sein.
+ **MultipleDimensionSelection**(string) (erforderlich) — Legt fest, ob Käufer in der Preisliste mehrere Dimensionen auswählen dürfen. Mögliche Werte sind `Allowed` und `Disallowed`.
+ **QuantityConfiguration**(string) (erforderlich) — Legt fest, ob Käufer die Menge für jede Dimension in der Preisliste konfigurieren dürfen. Mögliche Werte sind `Allowed` und `Disallowed`.
+ **ByolPricingTerm**(Objekt) — Ermöglicht es Ihnen und Ihren Kunden, Ihre bestehenden Verträge in das Verzeichnis zu AWS Marketplace verschieben. Dem Kunden wird die Nutzung des Produkts im Inland nicht in Rechnung gestellt AWS Marketplace , da er das Produkt bereits außerhalb von bezahlt hat AWS Marketplace.
+ **Type ** (string) (erforderlich) — Typ des Begriffs, der aktualisiert wird. Dies ist der Objektwert:`ByolPricingTerm`.
+ **RecurringPaymentTerm**(Objekt) — Definiert ein Preismodell, bei dem Kunden am Ende jedes Abrechnungszeitraums ein fester wiederkehrender Preis berechnet wird.
+ **Typ ** (Zeichenfolge) (erforderlich) — Typ der Bedingung, die aktualisiert wird. Dies ist der Objektwert:`RecurringPaymentTerm`.
+ **BillingPeriod**(string) (erforderlich) — Definiert die Häufigkeit, bei der Käufern Gebühren berechnet werden. Nur `Monthly` wird heute unterstützt.
+ **Preis ** (Zeichenfolge) (erforderlich) — Betrag, der dem Käufer in jedem Abrechnungszeitraum in Rechnung gestellt wird.
+ **CurrencyCode**(string) (erforderlich) — Definiert die Währung für die in diesem Begriff genannten Preise. Derzeit wird nur `USD` unterstützt.
+ **FixedUpfrontPricingTerm**(object) — Definiert ein Prepaid-Preismodell, bei dem den Kunden ein fester Vorausbetrag in Rechnung gestellt wird.
+ **Type ** (string) (erforderlich) — Typ des Begriffs, der aktualisiert wird. Dies ist der Objektwert:`FixedUpfrontPricingTerm`.
+ **CurrencyCode**(string) (erforderlich) — Definiert die Währung für die in diesem Begriff genannten Preise. Für öffentliche Angebote werden nur USD unterstützt. Für private Angebote werden USD, AUD, EUR, GBP und JPY unterstützt.
+ **Preis ** (Zeichenfolge) (erforderlich) — Fester Betrag, der dem Kunden in Rechnung gestellt wird, wenn diese Bedingung akzeptiert wird.
+ **Zuschüsse ** (verschiedene Strukturen) (erforderlich) — Ansprüche, die dem Antragsteller gewährt werden, oder die im Rahmen der Vertragsausführung im Voraus festgelegt werden.
+ **DimensionKey**(string) (erforderlich) — Eindeutiger Dimensionsschlüssel, der im Produktdokument definiert ist. Die Abmessungen stellen die Kategorien der Kapazität eines Produkts dar und werden angegeben, wenn das Produkt im Angebot aufgeführt wird AWS Marketplace.
+ **MaxQuantity**(Ganzzahl) (erforderlich) — Die maximale Kapazität, die dem Käufer bei einer bestimmten Produktabmessung zustehen kann. Wenn sie `MaxQuantity` nicht angegeben wird, kann der Käufer eine unbegrenzte Menge der angegebenen Größe nutzen.
+ **Dauer ** (Zeichenfolge) (optional) — Definiert die Dauer, für die die Laufzeit aktiv bleibt. Dieses Feld unterstützt das ISO 8601-Format.
**Syntax der Antwort **
Für Ihre Anfrage wird ein Änderungssatz erstellt. Die Antwort auf diese Anfrage gibt Ihnen das `ChangeSetId` und `ChangeSetArn` für den Änderungssatz und sieht wie folgt aus.
```
{
"ChangeSetId": "example123456789012abcdef",
"ChangeSetArn": "arn:aws:aws-marketplace:us-east-1:123456789012:AWSMarketplace/ChangeSet/example123456789012abcdef"
}
```
Die Änderungsanforderung wird einer Warteschlange hinzugefügt und verarbeitet. Dazu gehört auch die Überprüfung von Informationen, um sicherzustellen, dass sie den AWS Marketplace Richtlinien entsprechen. Der Validierungsvorgang kann einige Minuten dauern.
Sie können den Status der Anfrage über die AWS Marketplace Management Portal oder direkt über die Catalog API mithilfe der `[DescribeChangeSet](https://docs.aws.amazon.com/marketplace-catalog/latest/api-reference/API_DescribeChangeSet.html)` API-Operation überprüfen.
**Synchrone Validierungen **
Die folgenden Schemavalidierungen sind spezifisch für Aktionen in der. `UpdatePricingTerms` AWS Marketplace Catalog API Diese Validierungen werden durchgeführt, wenn Sie anrufen. `StartChangeSet` Wenn die Anfrage die folgenden Anforderungen nicht erfüllt, schlägt sie mit einer HTTP-Antwort fehl.
| Eingabefeld | Validierungsregel | HTTP |
| --- | --- | --- |
| PricingModel | ErforderlichZulässige Preismodelle: ["Byol“, „Kostenlos“, „Nutzung“, „Vertrag"] | 422 |
| Bedingungen | ErforderlichZulässige Begriffe: [“ ConfigurableUpfrontPricingTerm „," ByolPricingTerm „," FreeTrialPricingTerm „," UsageBasedPricingTerm „," RecurringPaymentTerm „," FixedUpfrontPricingTerm „] | 422 |
| Bedingungen []. ByolPricingTerm | Erforderlich | 422 |
| Bedingungen []. ByolPricingTerm.Type | ErforderlichKann nur "ByolPricingTerm“ sein | 422 |
| Bedingungen []. ConfigurableUpfrontPricingTerm | Erforderlich | 422 |
| Bedingungen []. ConfigurableUpfrontPricingTerm.Type | ErforderlichKann nur "ConfigurableUpfrontPricingTerm“ sein | 422 |
| Bedingungen []. ConfigurableUpfrontPricingTerm.CurrencyCode | ErforderlichUnterstützte Währungen: ["USD“, „AUD“, „EUR“, „GBP“, „JPN"] | 422 |
| Bedingungen []. ConfigurableUpfrontPricingTerm.RateCards | ErforderlichDie Listengröße muss zwischen 1 und 5 liegen | 422 |
| Begriffe []. ConfigurableUpfrontPricingTerm.RateCards[] .Einschränkungen | Erforderlich | 422 |
| Begriffe []. ConfigurableUpfrontPricingTerm.RateCards[]. Contraints.MultipleDimensionSelection | ErforderlichErlaubte Werte: ["Erlaubt“, „Nicht zulässig"] | 422 |
| Begriffe []. ConfigurableUpfrontPricingTerm.RateCards[]. Contraints.QuantityConfiguration | ErforderlichErlaubte Werte: ["Erlaubt“, „Nicht zulässig"] | 422 |
| Begriffe []. ConfigurableUpfrontPricingTerm.RateCards[]. RateCard | ErforderlichDie Listengröße muss zwischen 1 und 800 liegen | 422 |
| Begriffe []. ConfigurableUpfrontPricingTerm.RateCards[]. RateCard[]. DimensionKey | ErforderlichDie Länge muss zwischen 1 und 100 liegen | 422 |
| Begriffe []. ConfigurableUpfrontPricingTerm.RateCards[]. RateCard[] .Preis | ErforderlichDer Datentyp ist „String“
Non-negativeDezimalzahlen mit bis zu 3 Dezimalstellen werden unterstützt | 422 |
| Begriffe []. ConfigurableUpfrontPricingTerm.RateCards[] .Selector | Erforderlich | 422 |
| Begriffe []. ConfigurableUpfrontPricingTerm.RateCards[]. Selector.Type | ErforderlichErlaubte Werte: ["Duration"] | 422 |
| Begriffe []. ConfigurableUpfrontPricingTerm.RateCards[]. Selector.Value | ErforderlichErwartetes Format pro Selektortyp: Dauer nach ISO 8601 | 422 |
| Begriffe []. FixedUpfrontPricingTerm | Erforderlich | 422 |
| Bedingungen []. FixedUpfrontPricingTerm.Type | ErforderlichKann nur "FixedUpfrontPricingTerm“ sein | 422 |
| Bedingungen []. FixedUpfrontPricingTerm.CurrencyCode | ErforderlichUnterstützte Währungen: ["USD“, „AUD“, „EUR“, „GBP“, „JPN"] | 422 |
| Bedingungen []. FixedUpfrontPricingTerm.Duration | ErforderlichErwartetes Format pro Selektortyp: Dauer nach ISO 8601 | 422 |
| Begriffe []. FixedUpfrontPricingTerm.Grants | ErforderlichDie Listengröße muss zwischen 1 und 200 liegen | 422 |
| Begriffe []. FixedUpfrontPricingTerm.Grants[]. DimensionKey | ErforderlichDie Länge muss zwischen 1 und 100 liegen | 422 |
| Begriffe []. FixedUpfrontPricingTerm.Grants[]. MaxQuantity | RequiredValue muss größer als 0 sein | 422 |
| Begriffe []. FixedUpfrontPricingTerm.Price | ErforderlichDer Datentyp ist „String“
Non-negativeDezimalzahlen mit bis zu 3 Dezimalstellen werden unterstützt | 422 |
| Begriffe []. FreeTrialPricingTerm | Erforderlich | 422 |
| Bedingungen []. FreeTrialPricingTerm.Type | ErforderlichKann nur "FreeTrialPricingTerm“ sein | 422 |
| Bedingungen []. FreeTrialPricingTerm.Duration | ErforderlichErwartetes Format: ISO 8601-Dauer | 422 |
| Begriffe []. FreeTrialPricingTerm.Grants | ErforderlichDie Listengröße muss zwischen 1 und 800 liegen | 422 |
| Begriffe []. FreeTrialPricingTerm.Grants[]. DimensionKey | ErforderlichDie Länge muss zwischen 1 und 100 liegen | 422 |
| Begriffe []. FreeTrialPricingTerm.Grants[]. MaxQuantity | OptionalWert muss größer als 0 sein | 422 |
| Begriffe []. RecurringPaymentTerm | Erforderlich | 422 |
| Bedingungen []. RecurringPaymentTerm.Type | ErforderlichKann nur "RecurringPaymentTerm“ sein | 422 |
| Bedingungen []. RecurringPaymentTerm.BillingPeriod | ErforderlichZulässige Werte: ["Monatlich"] | 422 |
| Bedingungen []. RecurringPaymentTerm.CurrencyCode | ErforderlichUnterstützte Währungen: ["USD"] | 422 |
| Bedingungen []. RecurringPaymentTerm.Price | ErforderlichDer Datentyp ist „String“
Non-negativeDezimalzahlen mit bis zu 3 Dezimalstellen werden unterstützt | 422 |
| Begriffe []. UsageBasedPricingTerm | Erforderlich | 422 |
| Bedingungen []. UsageBasedPricingTerm.Type | ErforderlichKann nur "UsagedBasedPricingTerm“ sein | 422 |
| Bedingungen []. UsageBasedPricingTerm.CurrencyCode | ErforderlichUnterstützte Währungen: ["USD"] | 422 |
| Bedingungen []. UsageBasedPricingTerm.RateCards | ErforderlichMuss die Größe 1 haben | 422 |
| Begriffe []. UsageBasedPricingTerm.RateCards[]. RateCard | ErforderlichDie Listengröße muss zwischen 1 und 800 liegen | 422 |
| Begriffe []. UsageBasedPricingTerm.RateCards[]. RateCard[]. DimensionKey | ErforderlichDie Länge muss zwischen 1 und 100 liegen | 422 |
| Begriffe []. UsageBasedPricingTerm.RateCards[]. RateCard[] .Preis | ErforderlichDer Datentyp ist „String“
Non-negativeDezimalzahlen mit bis zu 8 Dezimalstellen werden unterstützt | 422 |
**Asynchrone Fehler **
Die folgenden Fehler beziehen sich spezifisch auf `UpdatePricingTerms` Aktionen in der. AWS Marketplace Catalog API Diese Fehler werden zurückgegeben, wenn Sie `DescribeChangeSet` nach der Verarbeitung eines Änderungssatzes aufrufen. Weitere Hinweise zur Verwendung`DescribeChangeSet`, um den Status einer Änderungsanforderung abzurufen, finden Sie unter[Mit Änderungssätzen arbeiten](catalog-apis.md#working-with-change-sets).
| Fehlercode | Fehlermeldung |
| --- | --- |
| DUPLIZIERTE\_DIMENSION\_SCHLÜSSEL | Stellen Sie Grants eine eindeutige Liste von Dimensionsschlüsseln in [x] zur Verfügung. |
| DUPLIZIERTE\_DIMENSION\_SCHLÜSSEL | Stellen Sie RateCard eine eindeutige Liste von Dimensionsschlüsseln in [x] bereit. |
| DUPLICATE\_SELECTORS | Stellen Sie eine eindeutige Liste von Selektoren in bereit. ConfigurableUpfrontPricingTerm |
| DUPLIZIERTE\_BEGRIFFSTYPEN | Stellen Sie eine eindeutige Liste von Begriffstypen bereit. |
| INKOMPATIBELE\_VEREINBARUNG | Die folgenden Bedingungen können nicht aus dem Ersatzangebot entfernt werden: [x, y, z]. |
| INKOMPATIBELE\_VEREINBARUNG | Die folgenden Bedingungen können dem Ersatzangebot nicht hinzugefügt werden: [x, y, z]. |
| INKOMPATIBLER\_WÄHRUNGSCODE | CurrencyCode kann nach der Veröffentlichung des Angebots nicht mehr geändert werden. |
| INKOMPATIBELE\_ZAHLUNGSEINSTELLUNGEN | Aktualisieren Sie Ihre Zahlungseinstellungen, um sie mit dem kompatibel zu machen. CurrencyCode |
| INKOMPATIBLE\_PRODUKT | Das Nutzungspreismodell wird für das Produkt nicht unterstützt. |
| INKOMPATIBLE\_PRODUKT | Das Vertragspreismodell wird für das Produkt nicht unterstützt. |
| INKOMPATIBLE\_PRODUKT | Das Byol-Preismodell wird für das Produkt nicht unterstützt. |
| INKOMPATIBLE\_PRODUKT | Das kostenlose Preismodell wird für das Produkt nicht unterstützt. |
| INKOMPATIBLE\_PRODUKT | [x] wird in einem Angebot für das Produkt nicht unterstützt. |
| INKOMPATIBLE\_PRODUKT | Vorausgesetzt, die Zahlungs- und Preisbedingungen sind nicht kompatibel. |
| INKOMPATIBLE\_PRODUKT | Verwenden Sie die vorhandenen, verfügbaren Abmessungen im Produkt in [x]. |
| INKOMPATIBLE\_PRODUKT | FreeTrialPricingTerm da die einzige Preisbedingung des Angebots für das Produkt nicht unterstützt wird. |
| INKOMPATIBLE\_PRODUKT | Die folgenden Begriffe werden für das Produkt nicht unterstützt: [x, y, z]. |
| INKOMPATIBLE\_PRODUKT | Ersatzangebote werden nur für das Vertragspreismodell unterstützt. |
| INKOMPATIBLE\_PRODUKT | Geben Sie Preisbedingungen an, die mit den Produktabmessungen kompatibel sind. Inkompatible Preisbedingungen: [x, y, z]. |
| INKOMPATIBLE\_RATE\_CARD\_CONSTRAINTS | Setzen Sie für das Nutzungspreismodell den Wert MultipleDimensionSelection und auf Erlaubt. QuantityConfiguration ConfigurableUpfrontPricingTerm |
| INKOMPATIBLE\_RATE\_CARD\_CONSTRAINTS | Setzen Sie für das Nutzungspreismodell den Wert MultipleDimensionSelection und auf Unzulässig. QuantityConfiguration ConfigurableUpfrontPricingTerm |
| INKOMPATIBLE\_RATE\_CARD\_CONSTRAINTS | QuantityConfiguration Die PIN ConfigurableUpfrontPricingTerm kann nach der Veröffentlichung des Angebots nicht mehr geändert werden. |
| INKOMPATIBLE\_RATE\_CARD\_CONSTRAINTS | MultipleDimensionSelection Die PIN ConfigurableUpfrontPricingTerm kann nach der Veröffentlichung des Angebots nicht mehr geändert werden. |
| INKOMPATIBLE\_TARIFE | Setzen Sie alle Gebührenbeträge und Preise auf Null (0), wenn Sie das kostenlose Preismodell verwenden. |
| INKOMPATIBLE\_TARIFE | UsageBasedPricingTerm Für ein kostenloses Testangebot für das Produkt sind nur Nullpreise (0) zulässig. |
| INKOMPATIBLE\_WIEDERVERKAUFSAUTORISIERUNG | Geben Sie dasselbe an, was in der angegeben ist. CurrencyCode ResaleAuthorization |
| INKOMPATIBLE\_WIEDERVERKAUFSAUTORISIERUNG | Stellen Sie sicher, dass die Dauer in der der angegeben Dauer entspricht. FixedUpfrontPricingTerm ResaleAuthorization |
| INKOMPATIBLE\_WIEDERVERKAUFSAUTORISIERUNG | Geben Sie Begriffe ein, die mit dem kompatibel sind. ResaleAuthorization Inkompatible Begriffe: [x, y, z]. |
| INKOMPATIBLE\_SELECTOR\_DURATION | Dauern dürfen nach Veröffentlichung des Angebots nicht mehr aus den Preiskarten entfernt werden. ConfigurableUpfrontPricingTerm |
| INKOMPATIBLE\_VERKÄUFERVERIFIZIERUNG | Schließen Sie alle erforderlichen Verfahren zur Verkäuferverifizierung ab. |
| INKOMPATIBLE\_BEGRIFFE | [x] wird zusammen mit den folgenden Begriffen nicht unterstützt: [y, z]. |
| INKOMPATIBLE\_BEGRIFFE | Die folgenden Bedingungen können nach Veröffentlichung des Angebots nicht mehr hinzugefügt werden: [x, y, z]. |
| INKOMPATIBLE\_BEGRIFFE | Die folgenden Bedingungen können nach Veröffentlichung des Angebots nicht mehr entfernt werden: [x, y, z]. |
| INKOMPATIBLE\_BEGRIFFE | [x] wird für private Angebote nicht unterstützt. |
| INKOMPATIBLE\_BEGRIFFE | Die folgenden Begriffe werden nicht unterstützt FreeTrialPricingTerm , wodurch eine unbegrenzte Nutzung gewährt wird: [x, y, z]. |
| INKOMPATIBLE\_BEGRIFFE | Die folgenden Begriffe werden FreeTrialPricingTerm für das Produkt nicht unterstützt: [x, y, z]. |
| INKOMPATIBLE\_BEGRIFFE | Geben Sie einen Preis von Null (0) an, FixedUpfrontPricingTerm wenn das Angebot einen enthält. PaymentScheduleTerm |
| INKOMPATIBLE\_BEGRIFFE | Die folgenden Begriffe sind nicht kompatibel mit PricingModel: [x, y, z]. |
| INKOMPATIBLE\_BEGRIFFE | FixedUpfrontPricingTerm wird nicht unterstützt, wenn der Wert größer als Null (0) MarkupPercentage ist. |
| INKOMPATIBLE\_BEGRIFFE | Die angeforderte Änderung kann nach der Veröffentlichung des Angebots nicht mehr durchgeführt werden. |
| INKOMPATIBLE\_BEGRIFFE | Die angeforderte Änderung kann nach Ablauf des Angebots nicht mehr durchgeführt werden. |
| UNGÜLTIGE\_VEREINBARUNGSDAUER | Geben Sie eine Dauer zwischen [x] und [y] Monaten an. |
| UNGÜLTIGE\_VEREINBARUNGSDAUER | Stellen Sie sicher, dass die Granularität der Dauer für gemessene Dimensionen auf Tagesebene liegt. |
| UNGÜLTIGER\_WÄHRUNGSCODE | Geben Sie einen unterstützten an. CurrencyCode |
| UNGÜLTIGER\_WÄHRUNGSCODE | Geben Sie für alle Preis- und CurrencyCode Zahlungsbedingungen dasselbe an. |
| UNGÜLTIGER\_WÄHRUNGSCODE | Geben Sie einen unterstützten an. CurrencyCode |
| UNGÜLTIGER\_WÄHRUNGSCODE | Geben Sie für alle Preis- und CurrencyCode Zahlungsbedingungen dasselbe an. |
| UNGÜLTIGE\_DAUER | Stellen Sie sicher, dass die Dauer in innerhalb des zulässigen Bereichs FreeTrialPricingTerm liegt. |
| UNGÜLTIGE\_DAUER | Geben Sie eine Dauer an FixedUpfrontPricingTerm , die der Dauer zwischen und AgreementStartDate entspricht. AgreementEndDate |
| UNGÜLTIGE\_DAUER | Geben Sie eine Dauer zwischen [x] und [y] Monaten an. |
| UNGÜLTIGE\_DAUER | Stellen Sie sicher, dass die Granularität der Dauer für gemessene Dimensionen auf Tagesebene liegt. |
| INVALID\_GRANTS | Geben Sie dasselbe MaxQuantity für alle eingegangenen Zuschüsse an. FreeTrialPricingTerm |
| INVALID\_GRANTS | Geben Sie Zuschüsse für alle verfügbaren gemessenen Abmessungen ein. FreeTrialPricingTerm |
| INVALID\_GRANTS | The combination of Dimensions in grants is invalid in FixedUpfrontPricingTerm for the product. |
| UNGÜLTIGE ZUSCHÜSSE | The combination of Dimensions in grants is invalid in FreeTrialPricingTerm for the product. |
| UNGÜLTIGE ZUSCHÜSSE | FixedUpfrontPricingTerm with MaxQuantity is not supported for this product. |
| UNGÜLTIGE\_PREISÄNDERUNG | [x] kann erst [y] aktualisiert werden, da Sie in den letzten 120 Tagen eine Preiserhöhung beantragt haben. Um Ihre vorherige Preiserhöhungsanfrage zu stornieren oder weitere Informationen zu erhalten, wenden Sie sich an das AWS Marketplace Managed Catalog Operations Team. |
| UNGÜLTIGE\_PREISÄNDERUNG | Preiserhöhungen und das Hinzufügen von Dimensionen in [x] werden in derselben Anfrage nicht unterstützt. Fügen Sie zuerst Dimensionen hinzu. |
| UNGÜLTIGE\_PREISÄNDERUNG | Preiserhöhungen und Preissenkungen werden in UsageBasedPricingTerm derselben Anfrage nicht unterstützt. Senken Sie zuerst die Preise. |
| UNGÜLTIGE\_PREISÄNDERUNG | Preiserhöhungen RecurringPaymentTerm und Preissenkungen in werden in UsageBasedPricingTerm derselben Anfrage nicht unterstützt. Senken Sie zuerst die Preise. |
| UNGÜLTIGE\_PREISÄNDERUNG | Preissenkung RecurringPaymentTerm und Preiserhöhung in werden in UsageBasedPricingTerm derselben Anfrage nicht unterstützt. Senken Sie zuerst die Preise. |
| UNGÜLTIGE\_RATE\_CARD | ConfigurableUpfrontPricingTerm fehlt ein oder mehrere Dimensionsschlüssel für die Dauer [x]. Geben Sie Preise für denselben Satz von Dimensionsschlüsseln für alle Zeiträume an. |
| UNGÜLTIGE\_RATE\_CARD | Geben Sie eine Preiskarte an, die nur für gemessene Abmessungen gilt. UsageBasedPricingTerm |
| UNGÜLTIGE\_RATE\_CARD | Tarife können nicht aus [x] entfernt werden. Geben Sie die Preise für alle Abmessungen in der vorhandenen Preisliste an. |
| UNGÜLTIGE\_RATE\_CARD | Geben Sie Dimensionen an, die dieselbe Einheit in [x] haben. |
| UNGÜLTIGE\_RATE\_CARD | Geben Sie entweder alle gemessenen oder alle angegebenen Abmessungen in [x] ein. |
| UNGÜLTIGE\_RATE\_CARD | Geben Sie in [x] nur begründete Dimensionen an. |
| UNGÜLTIGE\_RATE\_CARD | Geben Sie nutzungsbasierte Tarife für alle verfügbaren gemessenen Abmessungen an. UsageBasedPricingTerm |
| UNGÜLTIGE\_RATE\_CARD | Geben Sie nutzungsabhängige Tarife für alle Dimensionen der kostenlosen Testversion an. |
| UNGÜLTIGE\_RATE\_CARD | Geben Sie Preise mit bis zu 8 Dezimalstellen an. UsageBasedPricingTerm |
| UNGÜLTIGE\_RATE\_CARD | The combination of Dimensions in rate card is invalid in UsageBasedPricingTerm for the product. |
| UNGÜLTIGER\_AUSWAHLDAUERWERT | Geben Sie eine Dauer zwischen [x] und [y] Monaten an. |
| UNGÜLTIGER\_AUSWAHLDAUERWERT | Stellen Sie sicher, dass die Granularität der Dauer für gemessene Dimensionen auf Tagesebene liegt. |
| UNGÜLTIGER\_AUSWAHLDAUERWERT | Stellen Sie sicher, dass die Dauer in innerhalb des zulässigen Bereichs liegt. ConfigurableUpfrontPricingTerm |
| UNGÜLTIGER\_AUSWAHLDAUERWERT | Geben Sie eine oder mehrere unterstützte Vertragsdauern an. |
| UNGÜLTIGER\_AUSWAHLDAUERWERT | Geben Sie eine oder mehrere unterstützte Vertragsdauern oder eine einzelne benutzerdefinierte Dauer an. |
| UNGÜLTIGER\_AUSWAHLDAUERWERT | Geben Sie eine Dauer an, die der Dauer zwischen und entspricht. ConfigurableUpfrontPricingTerm AgreementStartDate AgreementEndDate |
| FEHLENDE\_DAUER | Geben Sie die Dauer ein. FixedUpfrontPricingTerm |
| FEHLENDE\_VERBINDLICHE\_BEDINGUNGEN | FixedUpfrontPricingTerm wird nur in Kombination mit oder unterstützt. ByolPricingTerm PaymentScheduleTerm |
| FEHLENDE\_VERBINDLICHE\_BEDINGUNGEN | Geben Sie mindestens eines von [x, y, z] an. |
| FEHLENDE\_VERBINDLICHE\_BEDINGUNGEN | Geben Sie bei Verwendung des Byol-Preismodells ein ByolPricingTerm . |
| ZU\_VIELE\_ZUSCHÜSSE | Stellen Sie in [y] bis zu [x] Zuschüsse bereit. |
| ZU\_VIELE\_RATE\_CARDS | Für das Produkt ist nur ein Ratenzahlungseingang zulässig ConfigurableUpfrontPricingTerm. |
| ZU\_VIELE\_RATE\_CARDS | Für das Produkt sind bis zu [x] Preiskarten zulässig. ConfigurableUpfrontPricingTerm |
| ZU VIELE\_TARIFE | Geben Sie RateCards innerhalb der zulässigen Grenzwerte in an. ConfigurableUpfrontPricingTerm |
| ZU VIELE\_TARIFE | Geben Sie RateCards innerhalb der zulässigen Grenzwerte in an. UsageBasedPricingTerm |
| INKOMPATIBLE\_RATE\_CARD\_CONSTRAINTS | Setzen Sie beide MultipleDimensionSelection und auf den gleichen Wert ( QuantityConfiguration Erlaubt oder Unzulässig) in. ConfigurableUpfrontPricingTerm |
| INKOMPATIBLE\_RATE\_CARD\_CONSTRAINTS | Geben Sie die gleichen Einschränkungen für alle Tarifkarten in an. ConfigurableUpfrontPricingTerm |
| UNGÜLTIGE AKTUALISIERUNGSANFRAGE | [x] kann nicht aktualisiert werden. Um eine Preisänderung anzufordern oder weitere Informationen zu erhalten, wenden Sie sich an das AWS Marketplace Managed Catalog Operations Team. |
| INKOMPATIBLE\_PREISMODELL | PricingModel kann nicht von [x] nach [y] wechseln. |
| INVALID\_GRANTS | MaxQuantity für das FreeTrialPricingTerm ist für das Produkt begrenzt. Geben Sie einen MaxQuantity Wert kleiner als oder gleich [x] ein. Für weitere Informationen wenden Sie sich an das AWS Marketplace Managed Catalog Operations Team. |
| INVALID\_GRANTS | Sorgen Sie MaxQuantity für alle Zuschüsse. FixedUpfrontPricingTerm |
| INVALID\_GRANTS | MaxQuantity wird FixedUpfrontPricingTerm für das Produkt nicht unterstützt. |
| INKOMPATIBLE\_WIEDERVERKAUFSAUTORISIERUNG | Stellen Sie sicher, dass die in der angegebenen Anzahl von Zuschüssen übereinstimmen. FixedUpfrontPricingTerm RateCards ResaleAuthorization |
## Aktualisiere die Auffindbarkeit des Angebots
Sie können die Katalog-API verwenden, um die Auffindbarkeit Ihres Angebots in zu kontrollieren. AWS Marketplace
Sie können entweder ein bestimmtes Datum in der Zukunft festlegen, um die Auffindbarkeit Ihres Angebots einzuschränken, oder in der Vergangenheit, damit Ihr Angebot abläuft. Die Art der `UpdateAvailability` Änderung wirkt sich nicht auf bestehende Vereinbarungen aus.
**Anmerkung**
Sie können den `UpdateAvailability` Änderungstyp für ein privates Angebot verwenden, das bereits [ veröffentlicht wurde ](https://docs.aws.amazon.com/marketplace-catalog/latest/api-reference/offers.html#release-offer) (auch als * veröffentlicht bezeichnet*). Wenn Käufer das private Angebot bereits angenommen haben, sind diese bestehenden Verträge davon nicht betroffen.
Bei der Änderung `AvailabilityEndDate` eines bestehenden privaten Angebots [ müssen die ](https://docs.aws.amazon.com/marketplace-catalog/latest/api-reference/offers.html#update-validity-terms) Einschränkungen der Vertragsdauer eingehalten werden. Ist dies nicht der Fall, fügen Sie diesem `UpdateValidityTerms` Änderungssatz einen zusätzlichen Änderungstyp hinzu, um die Vertragsdauer so zu ändern, dass sie dem neuen Ablauf entspricht. Der `UpdateValidityTerms` Änderungstyp kann für ein privates Angebot verwendet werden, das entweder veröffentlicht wurde oder noch nicht veröffentlicht wurde.
Bei der Änderung `AvailabilityEndDate` eines bestehenden privaten Angebots [ müssen die ](https://docs.aws.amazon.com/marketplace-catalog/latest/api-reference/offers.html#update-payment-schedule-terms) Einschränkungen des Zahlungsplans eingehalten werden. Wenn dies nicht der Fall ist und das private Angebot noch * nicht veröffentlicht wurde*, fügen Sie diesem Änderungssatz eine zusätzliche `UpdatePaymentScheduleTerms` Änderungsart hinzu, um den Zahlungsplan so zu ändern, dass er dem neuen Ablaufdatum entspricht. Wenn das private Angebot * bereits veröffentlicht wurde*, können Sie nur Änderungen daran vornehmen, `AvailabilityEndDate` solange das neue Datum den Einschränkungen des Zahlungsplans entspricht.
Um die Auffindbarkeit Ihres Angebots zu kontrollieren, rufen Sie den `StartChangeSet` API-Vorgang mit dem `UpdateAvailability` Änderungstyp auf, wie im folgenden Beispiel gezeigt.
**Anforderungssyntax**
```
POST /StartChangeSet HTTP/1.1
Content-type: application/json
{
"Catalog": "AWSMarketplace",
"ChangeSet": [
{
"ChangeType": "UpdateAvailability",
"Entity": {
"Type": "Offer@1.0",
"Identifier": "offer-123456789"
},
"DetailsDocument": {
"AvailabilityEndDate": "2024-05-31"
}
}
]
}
```
Geben Sie Informationen für die Felder ein, um den `UpdateAvailability` Änderungstyp hinzuzufügen:
+ **Entität ** (Objekt) (erforderlich) — Ihr Angebot.
+ **Typ ** (Zeichenfolge) (erforderlich) — Das `Type` ist immer`Offer@1.0`.
+ **Identifier ** (string) (erforderlich) — Ihre Angebots-ID. Weitere Informationen finden Sie unter [Kennung](catalog-apis.md#identifier).
+ **DetailsDocument**(Objekt) (erforderlich) — Der JSON-Wert der Einzelheiten der Anfrage.
+ **AvailabilityEndDate**(string) (erforderlich) — Dies ist das Datum, bis zu dem das Angebot auffindbar und käuflich zu erwerben ist. AWS Marketplace Sie können ein bestimmtes Datum in der Zukunft festlegen, um die Verfügbarkeit einzuschränken, oder in der Vergangenheit, um das Angebot ablaufen zu lassen. Daten werden im `YYYY-MM-DD` Format dargestellt.
Für Ihre Anfrage wird ein Änderungssatz erstellt. Die Antwort auf diese Anfrage gibt Ihnen die ID und den ARN für den Änderungssatz und sieht wie folgt aus.
**Syntax der Antwort **
```
{
"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 die Überprüfung von Informationen, um sicherzustellen, dass sie den AWS Marketplace Richtlinien entsprechen. Der Validierungsvorgang kann einige Minuten dauern. Sie können den Status der Anfrage über die AWS Marketplace Management Portal oder in der Catalog API mit der `DescribeChangeSet` Aktion überprüfen.
**Synchrone Validierungen **
Die folgenden Schemavalidierungen sind spezifisch für Aktionen in der. `UpdateAvailability` AWS Marketplace Catalog API Diese Validierungen werden durchgeführt, wenn Sie anrufen. `StartChangeSet` Wenn die Anfrage die folgenden Anforderungen nicht erfüllt, schlägt sie mit einer HTTP-Antwort fehl.
| Eingabefeld | Validierungsregel | HTTP-Code |
| --- | --- | --- |
| AvailabilityEndDate | Erforderlich
Format: "YYYY-MM-DD“ | 422 |
**Asynchrone Fehler **
Die folgenden Fehler beziehen sich spezifisch auf `UpdateAvailability` Aktionen in der. AWS Marketplace Catalog API Diese Fehler werden zurückgegeben, wenn Sie `DescribeChangeSet` nach der Verarbeitung eines Änderungssatzes aufrufen. Weitere Informationen zur Verwendung`DescribeChangeSet`, um den Status einer Änderungsanforderung abzurufen, finden Sie unter[Mit Änderungssätzen arbeiten](catalog-apis.md#working-with-change-sets).
| Fehlercode | Fehlermeldung |
| --- | --- |
| INVALID\_AVAILABILITY\_END\_DATE | AvailabilityEndDate wird für öffentliche Angebote nicht unterstützt. |
| ENDDATUM DER UNGÜLTIGEN VERFÜGBARKEIT | Sorgen Sie für eine Zukunft. AvailabilityEndDate |
| ENDDATUM DER UNGÜLTIGEN VERFÜGBARKEIT | Geben Sie ein Datum an, das davor liegt. AvailabilityEndDate AgreementEndDate |
| FEHLENDES\_VERFÜGBARKEITSENDDATUM | Geben Sie ein Datum an, AvailabilityEndDate das vor dem Enddatum der Vereinbarung liegt. |
## Definieren Sie das Ablaufdatum von Verträgen, die mithilfe des Angebots erstellt wurden
Sie können die Katalog-API verwenden, um die Details zum Ablaufdatum von Verträgen zu definieren, die mithilfe des Angebots in erstellt wurden AWS Marketplace.
Diese Art der Änderung wirkt sich nicht auf bestehende Vereinbarungen aus.
**Anmerkung**
Sie können den `UpdateValidityTerms` Änderungstyp für ein privates Angebot verwenden, das bereits [ veröffentlicht wurde ](https://docs.aws.amazon.com/marketplace-catalog/latest/api-reference/offers.html#release-offer) (auch als * veröffentlicht bezeichnet*). Wenn Käufer das private Angebot bereits angenommen haben, sind diese bestehenden Verträge davon nicht betroffen.
Wenn Ihre [ Preisbedingungen für private Angebote für ** Produkte ** AMI-based ** und ** Pakete eine Laufzeit ](https://docs.aws.amazon.com/marketplace-catalog/latest/api-reference/offers.html#update-pricing-terms) enthalten, die eine `Duration` (z. B. die Laufzeitarten `FixedUpfrontPricingTerm` oder`ConfigurableUpfrontPricingTerm`) hat, muss Ihr `AgreementDuration` Wert für diese Änderungsart größer als die folgenden sein: die Anzahl der Tage vom heutigen Tag bis zum [ Ablauf des privaten Angebots ](https://docs.aws.amazon.com/marketplace-catalog/latest/api-reference/offers.html#update-availability) plus die Anzahl der Tage, die in den jeweiligen `Duration` Laufzeitarten festgelegt sind. Dies liegt daran, dass ein Käufer, nachdem er das private Angebot angenommen und die Vereinbarung abgeschlossen hat, optional weitere in diesen Laufzeittypen angegebene Ansprüche erwerben kann, bis das private Angebot abläuft. Darüber hinaus müssen alle zusätzlichen Ansprüche vor Ablauf der Vereinbarung enden. Wenn der Käufer beispielsweise das private Angebot am ersten verfügbaren Tag annimmt und dann die Ansprüche am letzten verfügbaren Tag erwirbt, dürfen diese Ansprüche nicht nach Ablauf des Vertrags enden.
Um die Details zum Ablaufdatum von Verträgen zu definieren, die mithilfe des Angebots erstellt wurden, rufen Sie den `StartChangeSet` API-Vorgang mit dem `UpdateValidityTerms` Änderungstyp auf, wie im folgenden Beispiel gezeigt.
**Anforderungssyntax**
```
POST /StartChangeSet HTTP/1.1
Content-type: application/json
{
"Catalog": "AWSMarketplace",
"ChangeSet": [
{
"ChangeType": "UpdateValidityTerms",
"Entity": {
"Type": "Offer@1.0",
"Identifier": "offer-123456789"
},
"DetailsDocument": {
"Terms": [
{
"Type": "ValidityTerm",
"AgreementDuration": "P12M",
"AgreementStartDate": "2021-08-01",
"AgreementEndDate": "2022-08-01"
}
]
}
}
]
}
```
Geben Sie Informationen für die Felder ein, um den `UpdateValidityTerms` Änderungstyp hinzuzufügen:
+ **Entität ** (Objekt) (erforderlich) — Ihr Angebot.
+ **Typ ** (Zeichenfolge) (erforderlich) — Das `Type` ist immer`Offer@1.0`.
+ **Identifier ** (string) (erforderlich) — Ihre Angebots-ID. Weitere Informationen finden Sie unter [Kennung](catalog-apis.md#identifier).
+ **DetailsDocument**(Objekt) (erforderlich) — Der JSON-Wert der Einzelheiten der Anfrage.
+ **Begriffe ** (Strukturarray) — Liste der Gültigkeitsbedingungen, die Sie aktualisieren möchten. Folgende Gültigkeitsbedingungen werden unterstützt:
+ **ValidityTerm**(Objekt) — Definiert die Bedingungen, unter denen eine Vereinbarung, die auf der Grundlage dieses Angebots zustande kommt, gültig bleibt.
+ **Typ ** (Zeichenfolge) — Kategorie des Begriffs, der aktualisiert wird. `ValidityTerm`
+ **AgreementDuration**(string) — Definiert die Dauer, für die die Vereinbarung aktiv bleibt. Wenn `AgreementStartDate` nicht angegeben, bezieht sich die Vertragsdauer auf den Zeitpunkt der Unterzeichnung der Vereinbarung. Die Dauer wird im ISO\_8601-Format dargestellt.
+ **AgreementStartDate**(string) — Definiert das Datum, an dem die Vereinbarung beginnt. `AgreementStartDate`wird im `YYYY-MM-DD` Format dargestellt. Die Vereinbarung beginnt um 00:00:00.000 UTC an dem angegebenen Datum. Falls `AgreementStartDate` nicht angegeben, wird das Startdatum der Vereinbarung auf der Grundlage des Zeitpunkts der Unterzeichnung der Vereinbarung bestimmt.
+ **AgreementEndDate**(string) — Definiert das Datum, an dem die Vereinbarung endet. Das `AgreementEndDate` wird im `YYYY-MM-DD` Format dargestellt. Die Vereinbarung endet um 23:59:59,999 UTC an dem angegebenen Datum. Falls `AgreementEndDate` nicht angegeben, hängt das Enddatum der Vereinbarung von der Gültigkeit der einzelnen Bedingungen ab.
**Syntax der Antwort **
Für Ihre Anfrage wird ein Änderungssatz erstellt. Die Antwort auf diese Anfrage gibt Ihnen das `ChangeSetId` und `ChangeSetArn` für den Änderungssatz und sieht wie folgt aus.
```
{
"ChangeSetId": "example123456789012abcdef",
"ChangeSetArn": "arn:aws:aws-marketplace:us-east-1:123456789012:AWSMarketplace/ChangeSet/example123456789012abcdef"
}
```
Die Änderungsanforderung wird einer Warteschlange hinzugefügt und verarbeitet. Dazu gehört auch die Überprüfung von Informationen, um sicherzustellen, dass sie den AWS Marketplace Richtlinien entsprechen. Der Validierungsvorgang kann einige Minuten dauern.
Sie können den Status der Anfrage über die AWS Marketplace Management Portal oder direkt über die Catalog API mithilfe der `[DescribeChangeSet](https://docs.aws.amazon.com/marketplace-catalog/latest/api-reference/API_DescribeChangeSet.html)` API-Operation überprüfen.
**Synchrone Validierungen **
Die folgenden Schemavalidierungen sind spezifisch für Aktionen in der. `UpdateValidityTerms` AWS Marketplace Catalog API Diese Validierungen werden durchgeführt, wenn Sie anrufen. `StartChangeSet` Wenn die Anfrage die folgenden Anforderungen nicht erfüllt, schlägt sie mit einer HTTP-Antwort fehl.
| Eingabefeld | Validierungsregel | HTTP-Code |
| --- | --- | --- |
| Bedingungen | Erforderlich | 422 |
| Begriffe [] .Type | Erforderlich
Kann nur sein `"ValidityTerm"` | 422 |
| Bedingungen []. AgreementDuration | Optional
Erwartetes Format pro Selektortyp: Dauer nach ISO 8601
Kann eigenständig oder in Kombination mit verwendet werden `AgreementStartDate` | 422 |
| Bedingungen []. AgreementEndDate | Optional
Das Datum muss wie folgt formatiert sein `"YYYY-MM-DD"` | 422 |
| Bedingungen []. AgreementStartDate | Optional
Das Datum muss wie folgt formatiert sein `"YYYY-MM-DD"`
Kann nur mit und gepaart `AgreementEndDate` werden `AgreementDuration` | 422 |
**Asynchrone Fehler **
Die folgenden Fehler beziehen sich spezifisch auf `UpdateValidityTerms` Aktionen in der. AWS Marketplace Catalog API Diese Fehler werden zurückgegeben, wenn Sie `DescribeChangeSet` nach der Verarbeitung eines Änderungssatzes aufrufen. Weitere Hinweise zur Verwendung`DescribeChangeSet`, um den Status einer Änderungsanforderung abzurufen, finden Sie unter[Mit Änderungssätzen arbeiten](catalog-apis.md#working-with-change-sets).
| Fehlercode | Fehlermeldung |
| --- | --- |
| INKOMPATIBELE\_VEREINBARUNG | AgreementStartDate kann nicht in der Zukunft liegen, wenn die aktuelle Vereinbarung, die ersetzt werden soll, nicht in die Zukunft datiert ist. |
| INKOMPATIBLES ENDDATUM DER VEREINBARUNG | AgreementEndDate kann nach der Veröffentlichung des Angebots nicht aktualisiert werden. |
| INKOMPATIBLE\_VEREINBAREN\_STARTDATUM | AgreementStartDate kann nach der Veröffentlichung des Angebots nicht aktualisiert werden. |
| INKOMPATIBLE\_PRODUKT | AgreementStartDate wird in Zukunft nicht unterstützt. |
| INKOMPATIBLE\_WIEDERVERKAUFSAUTORISIERUNG | Stellen Sie sicher, dass die Dauer zwischen und mit dem kompatibel ist. AgreementStartDate AgreementEndDate ResaleAuthorization |
| INKOMPATIBLE\_WIEDERVERKAUFSAUTORISIERUNG | Stellen Sie sicher, dass es mit dem kompatibel ist. AgreementStartDate ResaleAuthorization |
| INKOMPATIBLE\_WIEDERVERKAUFSAUTORISIERUNG | Stellen Sie sicher, dass es mit dem kompatibel ist. AgreementEndDate ResaleAuthorization |
| INKOMPATIBLE\_WIEDERVERKAUFSAUTORISIERUNG | Stellen Sie sicher, dass die Dauer zwischen und mit dem kompatibel ist. AgreementStartDate AgreementEndDate ResaleAuthorization |
| INKOMPATIBLE\_WIEDERVERKAUFSAUTORISIERUNG | Stellen Sie sicher, dass die in der angegebene Dauer übereinstimmt. AgreementDuration ResaleAuthorization |
| INKOMPATIBLE\_BEGRIFFE | ValidityTerm wird für öffentliche Angebote nicht unterstützt. |
| INKOMPATIBLE\_BEGRIFFE | Die angeforderte Änderung kann nach Ablauf des Angebots nicht mehr durchgeführt werden. |
| UNGÜLTIGE\_VEREINBARUNGSDAUER | Geben Sie an AgreementDuration , dass der Wert größer oder gleich [x] Tagen ist. |
| ENDDATUM DER VEREINBARUNG | Sorgen Sie für eine Zukunft. AgreementEndDate |
| ENDDATUM DER VEREINBARUNG | Geben Sie an AgreementEndDate , dass der Wert nach oder gleich [x] ist. |
| UNZULÄSSIGES STARTDATUM DER VEREINBARUNG | Geben Sie ein, das danach ist. AgreementStartDate AvailabilityEndDate |
| UNZULÄSSIGES STARTDATUM DER VEREINBARUNG | Geben Sie ein, das vor dem steht. AgreementStartDate AgreementEndDate |
| UNZULÄSSIGES STARTDATUM DER VEREINBARUNG | Geben Sie ein Datum an AgreementStartDate , das innerhalb von [x] Jahren ab heute liegt. |
| ZEITINTERVALL DER UNGÜLTIGE\_VEREINBARUNG | ValidityTerm mit beiden und wird nicht unterstützt. AgreementDuration AgreementEndDate |
| ZEITINTERVALL DER UNGÜLTIGE\_VEREINBARUNG | ValidityTerm mit beiden AgreementStartDate und wird in einem Angebot für AgreementDuration das Produkt nicht unterstützt. |
| ZEITINTERVALL DER UNGÜLTIGE\_VEREINBARUNG | ValidityTerm with wird in einem Angebot für das Produkt AgreementStartDate nicht unterstützt. |
| ZEITINTERVALL DER UNGÜLTIGE\_VEREINBARUNG | ValidityTerm with only wird nicht unterstützt. AgreementStartDate |
| ZEITINTERVALL DER UNGÜLTIGE\_VEREINBARUNG | AgreementEndDate wird nur unterstützt, wenn es in Kombination mit zukünftigen Angeboten oder als Ersatzangebot verwendet wird. AgreementStartDate |
| ZEITINTERVALL DER UNGÜLTIGE\_VEREINBARUNG | Geben Sie ein AgreementStartDate und AgreementEndDate an, wobei die Differenz kleiner oder gleich [x] Jahren ist. |
| FEHLENDES STARTDATUM DER VEREINBARUNG | Stellen Sie sicher, dass AgreementStartDate es vorhanden ist, wenn Sie es zusammen mit verwenden. ValidityTerm ConfigurableUpfrontPricingTerm |
| ENDDATUM DER VEREINBARUNG | Geben Sie ein Datum an AgreementEndDate , das innerhalb von [x] Jahren ab heute liegt. |
| INKOMPATIBLE\_VEREINBAREN\_STARTDATUM | Geben Sie dasselbe AgreementStartDate wie in der Vereinbarung definiert an, wenn die Vereinbarung ein zukünftiges Startdatum hat. |
| INKOMPATIBELE\_VEREINBARUNG | AgreementStartDate kann nicht in die Zukunft datiert werden, wenn die Vereinbarung nicht in die Zukunft datiert ist. |
## Details zum Zahlungsplan aktualisieren
Sie können die Katalog-API verwenden, um die Details des Zahlungsplans für Ihr Angebot zu aktualisieren, z. B. den flexiblen Zahlungsplan, in AWS Marketplace.
**Anmerkung**
Sie können den `UpdatePaymentScheduleTerms` Änderungstyp nicht für ein Angebot verwenden, das bereits [ veröffentlicht wurde ](https://docs.aws.amazon.com/marketplace-catalog/latest/api-reference/offers.html#release-offer) (auch als * veröffentlicht bezeichnet*).
Das private Angebot kann an jedem beliebigen Tag zwischen der Erstellung des privaten Angebots und seinem [ Ablauf ](https://docs.aws.amazon.com/marketplace-catalog/latest/api-reference/offers.html#update-availability) (festgelegt im`AvailabilityEndDate`) angenommen werden. Nur ein `ChargeDate` Wert des Zahlungsplans kann ein Datum sein, das am oder vor dem letzten Tag liegt, an dem der Käufer das private Angebot annehmen kann (das Ablaufdatum des privaten Angebots). Die verbleibenden Werte von `ChargeDate` müssen nach Ablauf des privaten Angebots liegen, jedoch nicht später als das Ende der Vereinbarung, wenn das private Angebot sofort angenommen wurde. Das Ende der Vereinbarung hängt davon ab, wann das private Angebot angenommen wird (wodurch die Vereinbarung zustande kommt), zuzüglich der [ Laufzeit der Vereinbarung](https://docs.aws.amazon.com/marketplace-catalog/latest/api-reference/offers.html#update-validity-terms).
Um die Details des Zahlungsplans für Ihr Angebot zu aktualisieren, rufen Sie den `StartChangeSet` API-Vorgang mit der `UpdatePaymentScheduleTerms` Änderungsart auf, wie im folgenden Beispiel gezeigt.
**Anforderungssyntax**
```
POST /StartChangeSet HTTP/1.1
Content-type: application/json
{
"Catalog": "AWSMarketplace",
"ChangeSet": [
{
"ChangeType": "UpdatePaymentScheduleTerms",
"Entity": {
"Type": "Offer@1.0",
"Identifier": "offer-123456789"
},
"DetailsDocument": {
"Terms": [
{
"Type": "PaymentScheduleTerm",
"Schedule": [
{
"ChargeDate": "2021-12-01",
"ChargeAmount": "200.00"
},
{
"ChargeDate": "2022-03-01",
"ChargeAmount": "250.00"
}
]
}
]
}
}
]
}
```
Geben Sie Informationen für die Felder ein, um den `UpdatePaymentScheduleTerms` Änderungstyp hinzuzufügen:
+ **Entität ** (Objekt) (erforderlich) — Ihr Angebot.
+ **Typ ** (Zeichenfolge) (erforderlich) — Das `Type` ist immer`Offer@1.0`.
+ **Identifier ** (string) (erforderlich) — Ihre Angebots-ID. Weitere Informationen finden Sie unter [Kennung](catalog-apis.md#identifier).
+ **DetailsDocument**(Objekt) (erforderlich) — Der JSON-Wert der Einzelheiten der Anfrage.
+ **Bedingungen ** (Reihe von Strukturen) — Liste der Zahlungsbedingungen, die Sie aktualisieren möchten. Folgende Zahlungsbedingungen werden unterstützt:
+ **PaymentScheduleTerm**(Objekt) — Definiert ein ratenbasiertes Preismodell, bei dem Kunden an verschiedenen Terminen während der Gültigkeitsdauer der Vereinbarung ein fester Preis berechnet wird.
+ **Typ ** (Zeichenfolge) — Typ der Bedingung, die aktualisiert wird. Dies ist der Objektwert:`"PaymentScheduleTerm"`.
+ **Zeitplan ** (Anordnung von Strukturen) — Liste des Zahlungsplans, in dem jedes Element eine Zahlungsrate definiert. Es enthält die Informationen, die für die Berechnung des zu zahlenden Preises erforderlich sind, und das Datum, an dem dem Kunden die Zahlung in Rechnung gestellt würde.
+ **ChargeDate**(string) — Das Datum, an dem der Kunde den in dieser Zahlungsfrist festgelegten Preis zahlen würde. `ChargeDate`wird im YYYY-MM-DD Format dargestellt. Rechnungen werden an dem angegebenen Datum generiert.
+ **ChargeAmount**(string) — Der Preis, den der Kunde am geplanten Datum (`ChargeDate`) zahlen würde.
**Syntax der Antwort **
Für Ihre Anfrage wird ein Änderungssatz erstellt. Die Antwort auf diese Anfrage gibt Ihnen das `ChangeSetId` und `ChangeSetArn` für den Änderungssatz und sieht wie folgt aus.
```
{
"ChangeSetId": "example123456789012abcdef",
"ChangeSetArn": "arn:aws:aws-marketplace:us-east-1:123456789012:AWSMarketplace/ChangeSet/example123456789012abcdef"
}
```
Die Änderungsanforderung wird einer Warteschlange hinzugefügt und verarbeitet. Dazu gehört auch die Überprüfung von Informationen, um sicherzustellen, dass sie den AWS Marketplace Richtlinien entsprechen. Der Validierungsvorgang kann einige Minuten dauern.
Sie können den Status der Anfrage über die AWS Marketplace Management Portal oder direkt über die Catalog API mithilfe der `[DescribeChangeSet](https://docs.aws.amazon.com/marketplace-catalog/latest/api-reference/API_DescribeChangeSet.html)` API-Operation überprüfen.
**Synchrone Validierungen **
Die folgenden Schemavalidierungen sind spezifisch für Aktionen in der. `UpdatePaymentScheduleTerms` AWS Marketplace Catalog API Diese Validierungen werden durchgeführt, wenn Sie anrufen. `StartChangeSet` Wenn die Anfrage die folgenden Anforderungen nicht erfüllt, schlägt sie mit einer HTTP-Antwort fehl.
| Eingabefeld | Validierungsregel | HTTP |
| --- | --- | --- |
| Bedingungen | Erforderlich
Nur `PaymentScheduleTerm` ist erlaubt
Die Listengröße muss kleiner als 2 sein | 422 |
| Begriffe [] .Type | Erforderlich
Kann nur sein `PaymentScheduleTerm` | 422 |
| Bedingungen []. PaymentScheduleTerm.CurrencyCode | Erforderlich
Unterstützte Währungen: ["USD“, „AUD“, „EUR“, „GBP“, „JPY"] | 422 |
| Bedingungen []. PaymentScheduleTerm.Schedule[] | Erforderlich | 422 |
| Bedingungen []. PaymentScheduleTerm.Schedule[]. ChargeAmount | ErforderlichDer Datumstyp ist „Zeichenfolge“
Non-negativeDezimalzahlen mit bis zu 2 Dezimalstellen werden unterstützt | 422 |
| Begriffe []. PaymentScheduleTerm.Schedule[]. ChargeDate | Erforderlich
Das Datum muss wie "“ YYYY-MM-DD formatiert sein | 422 |
**Asynchrone Fehler **
Die folgenden Fehler beziehen sich spezifisch auf `UpdatePaymentScheduleTerms` Aktionen in der. AWS Marketplace Catalog API Diese Fehler werden zurückgegeben, wenn Sie `DescribeChangeSet` nach der Verarbeitung eines Änderungssatzes aufrufen. Weitere Hinweise zur Verwendung`DescribeChangeSet`, um den Status einer Änderungsanforderung abzurufen, finden Sie unter[Mit Änderungssätzen arbeiten](catalog-apis.md#working-with-change-sets).
| Fehlercode | Fehlermeldung |
| --- | --- |
| DUPLICATE\_CHARGE\_DATES | Geben Sie eindeutige Abrechnungsdaten in an. PaymentScheduleTerm |
| INKOMPATIBELER\_WÄHRUNGSCODE | CurrencyCode kann nach der Veröffentlichung des Angebots nicht mehr geändert werden. |
| INKOMPATIBLE\_MARKUP\_PROZENTSATZ | PaymentScheduleTerm wird nicht unterstützt, wenn der Wert größer als Null (0) MarkupPercentage ist. |
| INKOMPATIBELE\_ZAHLUNGSEINSTELLUNGEN | Aktualisieren Sie Ihre Zahlungseinstellungen, um sie mit dem kompatibel zu machen. CurrencyCode |
| INKOMPATIBLE\_WIEDERVERKAUFSAUTORISIERUNG | Geben Sie Begriffe ein, die mit dem kompatibel sind. ResaleAuthorization Inkompatible Begriffe: [PaymentScheduleTerm]. |
| INKOMPATIBLE\_WIEDERVERKAUFSAUTORISIERUNG | Stellen Sie sicher, dass der Gesamtbetrag mit dem kompatibel ist. ChargeAmounts PaymentScheduleTerm ResaleAuthorization |
| INKOMPATIBLE\_VERKÄUFERVERIFIZIERUNG | Schließen Sie alle erforderlichen Verfahren zur Verkäuferverifizierung ab. |
| INKOMPATIBLE\_BEGRIFFE | Die angeforderte Änderung kann nach der Veröffentlichung des Angebots nicht mehr durchgeführt werden. |
| INKOMPATIBLE\_BEGRIFFE | Die angeforderte Änderung kann nach Ablauf des Angebots nicht mehr durchgeführt werden. |
| UNGÜLTIGE\_GEBÜHRENDATEN | Geben Sie frühere Abrechnungsdaten an. AgreementEndDate |
| UNGÜLTIGER\_WÄHRUNGSCODE | Geben Sie einen unterstützten an. CurrencyCode |
| UNGÜLTIGER\_WÄHRUNGSCODE | Geben Sie für alle Preis- und CurrencyCode Zahlungsbedingungen dasselbe an. |
| ZU\_VIELE\_RÜCKDATIERTE\_GEBÜHREN | Bieten Sie zuvor bis zu 1 planmäßige Zahlung an. AvailabilityEndDate |
| UNGÜLTIGE\_GEBÜHRENDATEN | Geben Sie ein Datum der letzten Abrechnung an, das davor liegt. AgreementEndDate |
| UNGÜLTIGE\_GEBÜHRENDATEN | Geben Sie ein erstes Abbuchungsdatum an, das nicht in der Vergangenheit liegt. |
| ZU\_VIELE\_GEBÜHREN | Stellen Sie bis zu [x] planmäßige Zahlungen bereit in. PaymentScheduleTerm |
## Nettozahlungsbedingungen aktualisieren
Sie können die Katalog-API verwenden, um die Nettozahlungsbedingungen für Ihr Angebot festzulegen AWS Marketplace. Eine Nettozahlungsfrist ist eine Frist, bei der Sie die Anzahl der Tage nach Rechnungsstellung angeben, bis zu der die Zahlung fällig ist.
**Anmerkung**
Nettozahlungsbedingungen werden nur für private Angebote unterstützt und gelten nur für Käufer, die eine Zahlungsmethode „Auf Rechnung“ aktiviert haben. AWS Wenn Sie keine Nettozahlungsbedingungen festlegen, gelten die Zahlungsbedingungen Ihres Käufers. AWS
Um die Nettozahlungsfrist für Ihr Angebot festzulegen, rufen Sie den `StartChangeSet` API-Vorgang mit der `UpdateNetPaymentTerms` Änderungsart auf, wie im folgenden Beispiel gezeigt.
**Anforderungssyntax**
```
POST /StartChangeSet HTTP/1.1
Content-type: application/json
{
"Catalog": "AWSMarketplace",
"ChangeSet": [
{
"ChangeType": "UpdateNetPaymentTerms",
"Entity": {
"Type": "Offer@1.0",
"Identifier": "offer-123456789"
},
"DetailsDocument": {
"Terms": [
{
"Type": "NetPaymentTerm",
"PaymentDuePeriod": "P30D"
}
]
}
}
]
}
```
Geben Sie Informationen für die Felder ein, um den `UpdateNetPaymentTerms` Änderungstyp hinzuzufügen:
+ **Entität ** (Objekt) (erforderlich) — Ihr Angebot.
+ **Typ ** (Zeichenfolge) (erforderlich) — Das `Type` ist immer`Offer@1.0`.
+ **Identifier ** (string) (erforderlich) — Ihre Angebots-ID. Weitere Informationen finden Sie unter [Kennung](catalog-apis.md#identifier).
+ **DetailsDocument**(Objekt) (erforderlich) — Der JSON-Wert der Einzelheiten der Anfrage.
+ **Bedingungen ** (Strukturarray) (erforderlich) — Liste der Nettozahlungsbedingungen, die Sie aktualisieren möchten. Ein Angebot kann maximal eine Nettozahlungsbedingung enthalten. Unterstützte Begriffe sind:
+ **NetPaymentTerm**(Objekt) — Definiert die Nettozahlungsbedingungen, die mit dem Käufer ausgehandelt werden.
+ **Type ** (string) — Typ der Bedingung, die aktualisiert wird. Dies ist der Objektwert:`"NetPaymentTerm"`.
+ **PaymentDuePeriod**(string) — Die Anzahl der Tage nach dem Ausstellungsdatum der Rechnung, an der die Zahlung fällig ist. Dieses Feld unterstützt das ISO 8601-Format. Unterstützte Werte sind `P15D`, `P30D`, `P45D`, `P60D`, `P90D` und `P120D`.
**Syntax der Antwort **
Für Ihre Anfrage wird ein Änderungssatz erstellt. Die Antwort auf diese Anfrage gibt Ihnen das `ChangeSetId` und `ChangeSetArn` für den Änderungssatz und sieht wie folgt aus.
```
{
"ChangeSetId": "example123456789012abcdef",
"ChangeSetArn": "arn:aws:aws-marketplace:us-east-1:123456789012:AWSMarketplace/ChangeSet/example123456789012abcdef"
}
```
Die Änderungsanforderung wird einer Warteschlange hinzugefügt und verarbeitet. Dazu gehört auch die Überprüfung von Informationen, um sicherzustellen, dass sie den AWS Marketplace Richtlinien entsprechen. Der Validierungsvorgang kann einige Minuten dauern.
Sie können den Status der Anfrage über die AWS Marketplace Management Portal oder direkt über die Catalog API mithilfe der `[DescribeChangeSet](https://docs.aws.amazon.com/marketplace-catalog/latest/api-reference/API_DescribeChangeSet.html)` API-Operation überprüfen.
**Synchrone Validierungen **
Die folgenden Schemavalidierungen sind spezifisch für Aktionen in der. `UpdateNetPaymentTerms` AWS Marketplace Catalog API Diese Validierungen werden durchgeführt, wenn Sie anrufen. `StartChangeSet` Wenn die Anfrage die folgenden Anforderungen nicht erfüllt, schlägt sie mit einer HTTP-Antwort fehl.
| Eingabefeld | Validierungsregel | HTTP |
| --- | --- | --- |
| Bedingungen | Erforderlich
Nur `NetPaymentTerm` ist erlaubt
Die Listengröße muss kleiner als 2 sein | 422 |
| Begriffe [] .Type | Erforderlich
Kann nur sein `NetPaymentTerm` | 422 |
| Bedingungen []. NetPaymentTerm.PaymentDuePeriod | Erforderlich
Erwartetes Format: ISO 8601-Dauer
Zulässige Werte: ["P15D“, „P30D“, „P45D“, „P60D“, „P90D“, „P120D"] | 422 |
**Asynchrone Fehler **
Die folgenden Fehler beziehen sich spezifisch auf `UpdateNetPaymentTerms` Aktionen in der. AWS Marketplace Catalog API Diese Fehler werden zurückgegeben, wenn Sie `DescribeChangeSet` nach der Verarbeitung eines Änderungssatzes aufrufen. Weitere Hinweise zur Verwendung`DescribeChangeSet`, um den Status einer Änderungsanforderung abzurufen, finden Sie unter[Mit Änderungssätzen arbeiten](catalog-apis.md#working-with-change-sets).
| Fehlercode | Fehlermeldung |
| --- | --- |
| INVALID\_PAYMENT\_DUE\_PERIOD | Geben Sie einen unterstützten an. PaymentDuePeriod |
| INKOMPATIBLE\_PRODUKT | Die folgenden Begriffe werden für das Produkt nicht unterstützt: [x, y, z]. |
| INKOMPATIBLE\_BEGRIFFE | NetPaymentTerm wird für öffentliche Angebote nicht unterstützt. |
| INKOMPATIBLE\_BEGRIFFE | Die angeforderte Änderung kann nach der Veröffentlichung des Angebots nicht mehr durchgeführt werden. |
| INKOMPATIBLE\_WIEDERVERKAUFSAUTORISIERUNG | NetPaymentTerm wird nicht unterstützt, weil das kein enthält. ResaleAuthorization NetPaymentTerm |
| INKOMPATIBLE\_WIEDERVERKAUFSAUTORISIERUNG | NetPaymentTerm kann nicht entfernt werden, weil das eine enthält. ResaleAuthorization NetPaymentTerm |
| INKOMPATIBLE\_WIEDERVERKAUFSAUTORISIERUNG | Stellen Sie sicher, dass in mit dem kompatibel ist. PaymentDuePeriod NetPaymentTerm ResaleAuthorization |
| DUPLIZIERTE\_BEGRIFFSTYPEN | Stellen Sie eine eindeutige Liste von Begriffstypen bereit. |
## Verlängerungsoptionen ändern
Sie können die Katalog-API verwenden, um die Verlängerungsoptionen der Verträge zu steuern, die mit diesem Angebot in erstellt wurden AWS Marketplace.
Für Angebote, die über die Catalog API erstellt wurden, bleibt die automatische Verlängerung standardmäßig deaktiviert, bis Sie den `UpdateRenewalTerms` Änderungstyp aufrufen, um die automatische Verlängerung zu ermöglichen. Diese Änderung wirkt sich nicht auf bestehende Verträge aus.
Um die Verlängerungsoptionen der Verträge zu steuern, die mit diesem Angebot erstellt werden, rufen Sie den `StartChangeSet` API-Vorgang mit dem `UpdateRenewalTerms` Änderungstyp auf, wie im folgenden Beispiel gezeigt.
**Anforderungssyntax**
```
POST /StartChangeSet HTTP/1.1
Content-type: application/json
{
"Catalog": "AWSMarketplace",
"ChangeSet": [
{
"ChangeType": "UpdateRenewalTerms",
"Entity": {
"Type": "Offer@1.0",
"Identifier": "offer-123456789"
},
"DetailsDocument": {
"Terms": [
{
"Type": "RenewalTerm"
}
]
}
}
]
}
```
Geben Sie Informationen für die Felder ein, um den `UpdateRenewalTerms` Änderungstyp hinzuzufügen:
+ **Entität ** (Objekt) (erforderlich) — Ihr Angebot.
+ **Typ ** (Zeichenfolge) (erforderlich) — Das `Type` ist immer`Offer@1.0`.
+ **Identifier ** (string) (erforderlich) — Ihre Angebots-ID. Weitere Informationen finden Sie unter [Kennung](catalog-apis.md#identifier).
+ **DetailsDocument**(Objekt) (erforderlich) — Der JSON-Wert der Einzelheiten der Anfrage.
+ **Bedingungen ** (Strukturanordnung) — Liste der Verlängerungsbedingungen, die Sie aktualisieren möchten. Folgende Verlängerungsbedingungen werden unterstützt:
+ **RenewalTerm**(Objekt) — Definiert, dass bei ordnungsgemäßer Kündigung (Ablauf des Vertrags`ValidityTerm`, nicht Käufer oder AWS Marketplace Kündigung) des Vertrags ein neuer Vertrag unter Verwendung der akzeptierten Bedingungen des bestehenden Vertrags erstellt wird. Mit anderen Worten, die Vereinbarung wird verlängert. Das Vorhandensein von `RenewalTerm` im Angebot bedeutet, dass eine automatische Verlängerung zulässig ist. Käufer haben bei der acceptance/agreement Angebotserstellung die Möglichkeit, die automatische Verlängerung zu akzeptieren oder abzulehnen.
+ **Typ ** (Zeichenfolge) — Typ des Begriffs, der aktualisiert wird. `RenewalTerm`
**Antwortsyntax **
Für Ihre Anfrage wird ein Änderungssatz erstellt. Die Antwort auf diese Anfrage gibt Ihnen das `ChangeSetId` und `ChangeSetArn` für den Änderungssatz und sieht wie folgt aus.
```
{
"ChangeSetId": "example123456789012abcdef",
"ChangeSetArn": "arn:aws:aws-marketplace:us-east-1:123456789012:AWSMarketplace/ChangeSet/example123456789012abcdef"
}
```
Die Änderungsanforderung wird einer Warteschlange hinzugefügt und verarbeitet. Dazu gehört auch die Überprüfung von Informationen, um sicherzustellen, dass sie den AWS Marketplace Richtlinien entsprechen. Der Validierungsvorgang kann einige Minuten dauern.
Sie können den Status der Anfrage über die AWS Marketplace Management Portal oder direkt über die Catalog API mithilfe der `[DescribeChangeSet](https://docs.aws.amazon.com/marketplace-catalog/latest/api-reference/API_DescribeChangeSet.html)` API-Operation überprüfen.
**Synchrone Validierungen **
Die folgenden Schemavalidierungen sind spezifisch für Aktionen in der. `UpdateRenewalTerms` AWS Marketplace Catalog API Diese Validierungen werden durchgeführt, wenn Sie anrufen. `StartChangeSet` Wenn die Anfrage die folgenden Anforderungen nicht erfüllt, schlägt sie mit einer HTTP-Antwort fehl.
| Eingabefeld | Validierungsregel | HTTP-Code |
| --- | --- | --- |
| Bedingungen | Erforderlich | 422 |
| Begriffe [] .Type | ErforderlichKann nur "“ RenewalTerm sein | 422 |
**Asynchrone Fehler **
Die folgenden Fehler beziehen sich spezifisch auf `UpdateRenewalTerms` Aktionen in der. AWS Marketplace Catalog API Diese Fehler werden zurückgegeben, wenn Sie `DescribeChangeSet` nach der Verarbeitung eines Änderungssatzes aufrufen. Weitere Informationen zur Verwendung`DescribeChangeSet`, um den Status einer Änderungsanforderung abzurufen, finden Sie unter[Mit Änderungssätzen arbeiten](catalog-apis.md#working-with-change-sets).
| Fehlercode | Fehlermeldung |
| --- | --- |
| INKOMPATIBELES\_PRODUKT | RenewalTerm wird in privaten Angeboten für das Produkt nicht unterstützt. |
| INKOMPATIBLE\_BEGRIFFE | RenewalTerm wird zusammen mit nicht unterstützt. PaymentScheduleTerm |
| INKOMPATIBLE\_BEGRIFFE | RenewalTerm wird mit dem nicht unterstützt. PricingModel |
| INKOMPATIBLE\_BEGRIFFE | Die angeforderte Änderung kann nach der Veröffentlichung des Angebots nicht mehr durchgeführt werden. |
| INKOMPATIBLE\_BEGRIFFE | Die angeforderte Änderung kann nach Ablauf des Angebots nicht mehr durchgeführt werden. |
## Veröffentlichen Sie ein Angebot
Sie können die Katalog-API verwenden, um die bei allen Aktualisierungsänderungstypen gesammelten Informationen zusammenzuführen und das Angebot dann zu veröffentlichen.
Angebote bleiben in einem `Draft` Status, bis sie `ReleaseOffer` aufgerufen werden. Nachdem das Angebot veröffentlicht wurde, ist es in AWS Marketplace auffindbar.
Um Ihr Angebot zu veröffentlichen, rufen Sie den `StartChangeSet` API-Vorgang mit dem `ReleaseOffer` Änderungstyp auf, wie im folgenden Beispiel gezeigt.
**Anforderungssyntax**
```
POST /StartChangeSet HTTP/1.1
Content-type: application/json
{
"Catalog": "AWSMarketplace",
"ChangeSet": [
{
"ChangeType": "ReleaseOffer",
"Entity": {
"Type": "Offer@1.0",
"Identifier": "offer-123456789"
},
"DetailsDocument": {}
}
]
}
```
Geben Sie Informationen für die Felder ein, um den `ReleaseOffer` Änderungstyp hinzuzufügen:
+ **Entität ** (Objekt) — Der benannte Entitätstyp, der erstellt wird. Das `Identifier` ist Ihre Angebots-ID und das `Type` ist immer`Offer@1.0`. Weitere Informationen finden Sie unter [Kennung](catalog-apis.md#identifier).
+ **DetailsDocument**(Objekt) — Der JSON-Wert der Einzelheiten der Anfrage. Es muss leer sein für`ReleaseOffer`.
**Syntax der Antwort **
Für Ihre Anfrage wird ein Änderungssatz erstellt. Die Antwort auf diese Anfrage gibt Ihnen das `ChangeSetId` und `ChangeSetArn` für den Änderungssatz und sieht wie folgt aus.
```
{
"ChangeSetId": "example123456789012abcdef",
"ChangeSetArn": "arn:aws:aws-marketplace:us-east-1:123456789012:AWSMarketplace/ChangeSet/example123456789012abcdef"
}
```
Die Änderungsanforderung wird einer Warteschlange hinzugefügt und verarbeitet. Dazu gehört auch die Überprüfung von Informationen, um sicherzustellen, dass sie den AWS Marketplace Richtlinien entsprechen. Der Validierungsvorgang kann einige Minuten dauern.
Sie können den Status der Anfrage über die AWS Marketplace Management Portal oder direkt über die Catalog API mithilfe der `[DescribeChangeSet](https://docs.aws.amazon.com/marketplace-catalog/latest/api-reference/API_DescribeChangeSet.html)` API-Operation überprüfen.
**Synchrone Validierungen **
Die folgenden Schemavalidierungen sind spezifisch für Aktionen in der. `ReleaseOffer` AWS Marketplace Catalog API Diese Validierungen werden durchgeführt, wenn Sie anrufen. `StartChangeSet` Wenn die Anfrage die folgenden Anforderungen nicht erfüllt, schlägt sie mit einer HTTP-Antwort fehl.
| Eingabefeld | Validierungsregel |
| --- | --- |
| DetailsDocument | Muss leer sein ({}) |
**Asynchrone Fehler **
Die folgenden Fehler beziehen sich spezifisch auf `ReleaseOffer` Aktionen in der. AWS Marketplace Catalog API Diese Fehler werden zurückgegeben, wenn Sie `DescribeChangeSet` nach der Verarbeitung eines Änderungssatzes aufrufen. Weitere Hinweise zur Verwendung`DescribeChangeSet`, um den Status einer Änderungsanforderung abzurufen, finden Sie unter[Mit Änderungssätzen arbeiten](catalog-apis.md#working-with-change-sets).
| Fehlercode | Fehlermeldung |
| --- | --- |
| INKOMPATIBLE\_PAYMENT\_SETTINGS | Aktualisieren Sie Ihre Zahlungseinstellungen, um sie mit dem kompatibel zu machen. CurrencyCode |
| INKOMPATIBLE\_PRODUKT | Erstellen Sie zunächst ein öffentliches Angebot für das Produkt. |
| INKOMPATIBLE\_VERKÄUFERVERIFIZIERUNG | Schließen Sie alle erforderlichen Verfahren zur Verkäuferverifizierung ab. |
| INKOMPATIBLE\_TARGETING | PreExistingAgreement wird nur für käuferorientierte Angebote unterstützt. |
| INKOMPATIBLE\_TARGETING | OfferSetId wird nur für käuferorientierte Angebote unterstützt. |
| UNGÜLTIGE\_STEUERINFORMATIONEN | Ihre Steuerinformationen sind unvollständig. Um professionelle Dienstleistungen weiterverkaufen zu können AWS Marketplace, müssen Sie den DAC7-Steuerfragebogen ausfüllen. Navigieren Sie zum Abschnitt Zahlungsinformationen und wählen Sie das DAC7-Steuerformular aus. Es kann bis zu zwei Stunden dauern, bis Ihre Steuerinformationen aktualisiert sind. |
| UNGÜLTIGE AKTUALISIERUNGSANFRAGE | Die angeforderte Änderung kann nach der Veröffentlichung des Angebots nicht mehr durchgeführt werden. |
| FEHLENDES\_ENDDATUM DER VEREINBARUNG | Stellen Sie ein Formular für Ersatzangebote bereit. AgreementEndDate |
| FEHLENDES\_VERFÜGBARKEITSENDDATUM | Bieten Sie ein privates Angebot an. AvailabilityEndDate |
| FEHLEN\_KÄUFERKONTEN | Sorgen Sie für Angebote, die PositiveTargeting mit erstellt wurden. BuyersAccounts ResaleAuthorization |
| FEHLEN\_KÄUFERKONTEN | Alle Angebote für das Produkt müssen privat sein. Versorgen Sie PositiveTargeting mit BuyersAccounts. |
| FEHLENDE\_BESCHREIBUNG | Legen Sie eine Beschreibung fest, bevor Sie das Angebot veröffentlichen. |
| FEHLENDE\_VERBINDLICHE\_BEDINGUNGEN | Füge [x] zum Angebot hinzu. |
| FEHLENDE\_VERBINDLICHE\_BEDINGUNGEN | Geben Sie a an, wenn das Angebot eine enthält FixedUpfrontPricingTerm . PaymentScheduleTerm |
| FEHLENDER\_NAME | Legen Sie einen Namen fest, bevor Sie das Angebot veröffentlichen. |
| ZU\_VIELE\_ANGEBOTE | Pro Produkt kann nur ein öffentliches kostenloses Testangebot erstellt werden. |
| ZU\_VIELE\_ANGEBOTE | Pro Produkt kann nur ein öffentliches Angebot erstellt werden. |
| FEHLENDE\_VERBINDLICHE\_BEDINGUNGEN | Stellen Sie öffentliche Angebote mit RenewalTerm Vertragspreisen für das Produkt zur Verfügung. |
| FEHLENDES\_ENDDATUM DER VEREINBARUNG | Stellen Sie ein Formular für Ersatzangebote bereit. AgreementEndDate |
## Beschreiben Sie die vorhandenen Angebotsdetails
Sie können die Katalog-API verwenden, um bestehende Angebotsdetails in zu beschreiben AWS Marketplace.
Um bestehende Angebotsdetails zu beschreiben, rufen Sie den `DescribeEntity` API-Vorgang mit dem `Offer@1.0` Entitätstyp auf, wie im folgenden Beispiel gezeigt.
**Anforderungssyntax**
```
GET /DescribeEntity?catalog=&entityId= HTTP/1.1
```
Geben Sie Informationen für die Felder ein, um den `DescribeEntity` Änderungstyp hinzuzufügen:
+ **catalog ** (string) — Der Katalog, der sich auf die Anfrage bezieht. Fester Wert:`AWSMarketplace`.
+ **entityId ** (string) — Die eindeutige ID des zu beschreibenden Angebots.
**Syntax der Antwort **
Die Antwort auf diese Anfrage enthält die Angebotsdetails und sieht wie folgt aus.
```
{
"EntityType": "Offer@1.0",
"EntityIdentifier": "offer-ad8EXAMPLE51@1",
"EntityArn": "arn:aws:aws-marketplace:us-east-1:111122223333:AWSMarketplace/Offer/offer-ad8EXAMPLE51",
"LastModifiedDate": "2021-03-10T21:57:16Z",
"DetailsDocument": {
"Id": "offer-3rEXAMPLErn",
"State": "Released",
"Name": "Test Offer",
"Description": "Worldwide offer for Test Product",
"PreExistingAgreement": {
"AcquisitionChannel": "External",
"PricingModel": "Contract"
},
"ProductId": "prod-ad8EXAMPLE51",
"OfferSetId": "offerset-b3f9EXAMPLE27",
"Terms": [
{
"Type": "SupportTerm",
"RefundPolicy": "If you need to request a refund for software sold by Amazon Web Services, LLC, please contact AWS Customer Service."
},
{
"Type": "LegalTerm",
"Documents": [
{
"Type": "CustomEula",
"Url": "https://s3.amazonaws.com/EULA/custom-eula-1234.txt"
}
]
},
{
"Type": "FreeTrialPricingTerm",
"Duration": "P30D",
"Grants": [
{
"DimensionKey": "m3.xlarge",
"MaxQuantity": 10
},
{
"DimensionKey": "m4.xlarge",
"MaxQuantity": 10
}
]
},
{
"Type": "ConfigurableUpfrontPricingTerm",
"CurrencyCode": "USD",
"RateCards": [
{
"Selector": {
"Type": "Duration",
"Value": "P365D"
},
"RateCard": [
{
"DimensionKey": "m3.large",
"Price": "300.00"
},
{
"DimensionKey": "m4.xlarge",
"Price": "400.00"
}
],
"Constraints": {
"MultipleDimensionSelection": "Allowed",
"QuantityConfiguration": "Allowed"
}
}
]
},
{
"Type": "UsageBasedPricingTerm",
"CurrencyCode": "USD",
"RateCards": [
{
"RateCard": [
{
"DimensionKey": "m3.large",
"Price": "0.10"
},
{
"DimensionKey": "m4.xlarge",
"Price": "0.20"
}
]
}
]
},
{
"Type": "FixedUpfrontPricingTerm",
"CurrencyCode": "USD",
"Price": "200.00",
"Grants": [
{
"DimensionKey": "Users",
"MaxQuantity": 10
}
]
},
{
"Type": "RecurringPaymentTerm",
"CurrencyCode": "USD",
"BillingPeriod": "Monthly",
"Price": "100.0"
},
{
"Type": "PaymentScheduleTerm",
"CurrencyCode": "USD",
"Schedule": [
{
"ChargeDate": "2020-12-01T00:00:00.000Z",
"ChargeAmount": "1000.00"
},
{
"ChargeDate": "2021-06-15T00:00:00.000Z",
"ChargeAmount": "1250.00"
}
]
},
{
"Type": "ByolPricingTerm"
},
{
"Type": "RenewalTerm"
},
{
"Type": "NetPaymentTerm",
"PaymentDuePeriod": "P30D"
}
],
"Rules": [
{
"Type": "TargetingRule",
"PositiveTargeting": {
"CountryCodes": [
"US",
"CA"
],
"BuyerAccounts": [
"444455556666"
]
},
"NegativeTargeting": {
"CountryCodes": [
"XX"
]
}
},
{
"Type": "AvailabilityRule",
"AvailabilityEndDate": "2024-08-30T01:56:03.000Z"
}
]
}
}
```
Im Folgenden finden Sie Informationen zu den Feldern, die Sie in der `DescribeEntity` Antwort sehen.
+ **EntityType**(string) — Der benannte Typ der Entität, nämlich`Offer@1.0`.
+ **EntityIdentifier**(string) — Der Bezeichner der Entität im Format von`EntityId@RevisionId`.
+ **EntityArn**(string) — Die ARN, die dem eindeutigen Bezeichner für den Änderungssatz zugeordnet ist, auf den in dieser Anfrage verwiesen wird.
+ **LastModifiedDate**(string) — Das Datum der letzten Änderung der Entität im ISO 8601-Format (zum Beispiel:`2018-02-27T13:45:22Z`).
+ **Details ** (Zeichenfolge) — Dieses stringifizierte JSON-Objekt enthält die folgenden Details der Entität:
+ **Id ** (string) — Eindeutige Kennung für eine Angebotsentität in AWS Marketplace und wird bei der Angebotserstellung generiert.
+ **State ** (string) — Der Status des Angebots.
+ **Name ** (Zeichenfolge) — Der Name, der dem Angebot zur besseren Lesbarkeit für Sie und Ihre Kunden zugeordnet ist. Er wird auch als Teil der Vertragsinformationen angezeigt.
+ **Beschreibung ** (Zeichenfolge) — Die Beschreibung ist ein Text in freier Form, der nur von Ihnen verwendet werden darf und den Käufern niemals zugänglich gemacht wird.
+ **PreExistingAgreement**(Zeichenfolge) — Legt fest, ob es sich bei diesem Angebot um eine Verlängerung einer bestehenden Vereinbarung mit einem bestehenden Kunden für dasselbe Basisprodukt handelt. Die bestehende Vereinbarung kann innerhalb oder außerhalb des Vertrags abgeschlossen werden AWS Marketplace. AWS kann prüfen und verifizieren, dass es sich bei Ihrem Angebot um eine Verlängerung handelt. Wenn AWS Ihr Angebot nicht verifiziert werden kann, AWS kann das Angebot und die damit verbundenen Rechte Ihrem Kunden entzogen werden.
+ **AcquisitionChannel**(string) — Gibt an, ob die bestehende Vereinbarung außerhalb AWS Marketplace oder innerhalb AWS Marketplace unterzeichnet wurde. Mögliche Werte:`External`,`AwsMarketplace`.
+ **PricingModel**(string) — Gibt an, welches Preismodell die bestehende Vereinbarung verwendet. Mögliche Werte:`Contract`,`Usage`,`Byol`,`Free`.
+ **ProductId**(string) — Die eindeutige Kennung des angebotenen Produkts.
+ **OfferSetId**(string) — Die eindeutige Kennung des Angebotssets, dem dieses Angebot zugeordnet werden soll.
+ **Begriffe ** (Reihe von Strukturen) — Liste der Begriffe.
+ **Regeln ** (Reihe von Strukturen) — Liste der Regeln.