Die AWS Marketplace API-Referenz wurde neu strukturiert. Weitere Informationen zu den unterstützten API-Vorgängen finden Sie in der [AWS Marketplace API-Referenz](https://docs.aws.amazon.com/marketplace/latest/APIReference/Welcome.html).
Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.
# Arbeiten Sie mit privaten Angeboten von Channel-Partnern zusammen, indem Sie den AWS Marketplace APIs
Sie können die verwenden AWS Marketplace Catalog API , um Aufgaben für die Arbeit mit privaten Angeboten (CPPOs) von Channel-Partnern zu automatisieren.
Wenn Sie ein CPPO erstellen oder aktualisieren, enthält der Angebotsentwurf die Bedingungen und Regeln einer Wiederverkaufserlaubnis und ist für den Käufer unsichtbar. Es ist möglich, aber nicht erforderlich, mehrere Personen in Ihrer Organisation einzubeziehen, um ein privates Angebot zu erstellen.
Beispielsweise kann eine Person für die Aktualisierung der Preise verantwortlich sein, während eine zweite Person für die Aktualisierung des Zahlungsplans verantwortlich sein kann. Dann kann eine dritte Person für die Aktualisierung der rechtlichen Bestimmungen verantwortlich sein. Sie können einer Person die Erlaubnis geben, bestimmte Teile eines Angebots zu aktualisieren. Sie können jedoch nur Leseberechtigungen für Wiederverkaufsberechtigungen erteilen.
Voraussetzung für das Aufrufen von Änderungstypen ist, dass Sie eine oder mehrere Wiederverkaufsberechtigungen erhalten haben und mit der Bedienung vertraut sind. AWS Marketplace Catalog API
Weitere Informationen finden Sie im *AWS Marketplace Verkäuferleitfaden* unter [Private Angebote von Vertriebspartnern](https://docs.aws.amazon.com/marketplace/latest/userguide/channel-partner-offers.html).
In den folgenden Themen wird beschrieben, wie Sie die Katalog-API verwenden, um CPPOs zu erstellen und zu aktualisieren:
**Topics**
+ [CPPO-Voraussetzungen](#cppo-prerequisites)
+ [Erstellen Sie ein CPPO](#create-offer-using-resale-auth)
+ [Erstellen Sie ein privates Ersatzangebot für Vertriebspartner](#create-replacement-offer-using-resale-auth)
+ [Markup aktualisieren](#update-markup)
+ [Targeting-Konfiguration aktualisieren](#update-targeting-cppo)
+ [Rechtliche Ressourcen aktualisieren](#update-legal-terms-cppo)
+ [Aktualisieren Sie die Auffindbarkeit des CPPO](#update-availability-cppo)
+ [Definieren Sie das Ablaufdatum von Vereinbarungen](#update-validity-terms-cppo)
+ [Preise aktualisieren](#update-pricing-terms-cppo)
+ [Details zum Zahlungsplan aktualisieren](#update-payment-schedule-terms-cppo)
+ [Veröffentlichen Sie das CPPO](#release-offer-cppo)
+ [Definieren Sie ein vorhandenes CPPO](#describe-entity-cppo)
## CPPO-Voraussetzungen
Service-linked Die Einrichtung von Role for ResaleAuthorization (SLR) ist eine zwingende Voraussetzung für die Verwendung der Wiederverkaufsautorisierung zur Erstellung eines CPPO. Um die Resale Authorization nutzen zu können, müssen sowohl unabhängige Softwareanbieter (ISVs) als auch AWS Marketplace Vertriebspartner eine dienstbezogene Rolle einrichten, die Berechtigungen für die gemeinsame Nutzung von Ressourcen gewährt. AWS Wenn beide Gruppen diese Voraussetzung nicht erfüllen, AWS können sie die Autorisierungsressource nicht vom ISV an den Channel-Partner weitergeben. AWS Marketplace Weitere Informationen finden Sie im [*AWS Marketplace Verkäuferleitfaden* unter Rollen für die Wiederverkaufsautorisierung](https://docs.aws.amazon.com/marketplace/latest/userguide/using-roles-for-resale-authorization.html) verwenden. AWS Marketplace
## Erstellen Sie ein CPPO
Sie verwenden eine auf Sie zugeschnittene Wiederverkaufsgenehmigung, um ein privates Angebot für Vertriebspartner (CPPO) im Bundesstaat in `Draft` zu erstellen. AWS Marketplace
Wenn Ihre Anfrage erfolgreich bearbeitet wurde, wird für Sie ein Angebot mit den Bedingungen `Draft` für die Wiederverkaufsgenehmigung AWS Marketplace Catalog API generiert. Hier können Sie die Bedingungen einsehen`DescribeEntity`, die auf den Angebotsentwurf von Resale Authorization angewendet wurden. Dies ist ein unvollständiges Angebot, das für Käufer in AWS Marketplace nicht sichtbar ist. Anschließend verwenden Sie die mit dem CPPO verknüpften Änderungstypen, um das Angebot abzuschließen.
Nachdem das Angebot abgeschlossen ist, verwenden Sie den `ReleaseOffer` Ä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 in sichtbar AWS Marketplace.
Um ein privates Angebot für Vertriebspartner zu erstellen, rufen Sie den `StartChangeSet` API-Vorgang mit dem `CreateOfferUsingResaleAuthorization` Änderungstyp auf, wie im folgenden Beispiel gezeigt.
**Anforderungssyntax**
```
POST /StartChangeSet HTTP/1.1
Content-type: application/json
{
"Catalog": "AWSMarketplace",
"ChangeSet": [
{
"ChangeType": "CreateOfferUsingResaleAuthorization",
"Entity": {
"Type": "Offer@1.0"
},
"DetailsDocument": {
"ResaleAuthorizationId": "resaleauthz-123456789",
"Name": "Test Offer",
"OfferSetId": "offerset-b3f9EXAMPLE27"
}
}
]
}
```
Geben Sie Informationen für die Felder an, um den `CreateOfferUsingResaleAuthorization` Änderungstyp hinzuzufügen:
+ **Entität** (Objekt) (erforderlich) — Ihr CPPO.
+ **Typ** (Zeichenfolge) (erforderlich) — Das `Type` ist immer`Offer@1.0`.
+ **DetailsDocument**(object) (erforderlich) — Der JSON-Wert der Einzelheiten der Anfrage.
+ **ResaleAuthorizationId**(string) (erforderlich) — Die eindeutige Kennung, die die angebotenen Produkte, Begriffe und Regeln umfasst. Vertriebspartner können mithilfe von Aktualisierungsänderungstypen zusätzliche Bedingungen und Regeln hinzufügen. ResaleAuthorization muss für Sie als Partner verfügbar und zielgerichtet sein.
+ **Name** (Zeichenfolge) (optional) — Der Name, der dem Angebot zugeordnet ist, um die Lesbarkeit zu verbessern. Er wird als Teil der Vertragsinformationen angezeigt.
+ **OfferSetId**(string) (optional) — Die ID des Angebotssatzes, mit dem dieses Angebot verknüpft werden soll. Geben Sie dieses Feld nur an, wenn Sie ein Angebot erstellen, das Teil eines Angebotssets sein soll. Wenn OfferSetId nicht angegeben, wird ein individuelles Angebot erstellt, das eigenständig erworben werden kann. Beachten Sie, dass die Angabe eines OfferSetId bei der Angebotserstellung nur Ihre Absicht signalisiert, das Angebot mit diesem Angebotssatz zu verknüpfen. 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 oder direkt über die AWS Marketplace Management Portal Katalog-API mithilfe des `[DescribeChangeSet](https://docs.aws.amazon.com/marketplace-catalog/latest/api-reference/API_DescribeChangeSet.html)` API-Vorgangs überprüfen.
Die Antwort auf diese Anfrage gibt Ihnen den Status der Anfrage. Wenn der Status lautet`SUCCEEDED`, `OfferId` wird eine neue generiert.
```
{
"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": "CreateOfferUsingResaleAuthorization",
"Entity": {
"Type": "Offer@1.0",
"Identifier": "offer-123456789"
},
"DetailsDocument": {
"ResaleAuthorizationId": "resaleauthz-123456789",
"Name": "Test Offer"
},
"ErrorDetailList": []
}
]
}
```
Sie können die `GET` `DescribeEntity` Anfrage verwenden, um den Entwurf der Angebotsregeln und -bedingungen zu beschreiben, der `ResaleAuthorization` in der AWS Marketplace Catalog API Referenz erstellt wurde. Weitere Informationen finden Sie unter [https://docs.aws.amazon.com/marketplace-catalog/latest/api-reference/API_DescribeChangeSet.html](https://docs.aws.amazon.com/marketplace-catalog/latest/api-reference/API_DescribeChangeSet.html).
**Bedingungen und Regeln von ResaleAuthorization**
+ **LegalTerms**— Bestimmungen, die rechtliche Begriffe beschreiben, wie z. B. die EULA in der, ResaleAuthorization werden dem Angebotsentwurf hinzugefügt. Sie können rechtliche Bestimmungen mithilfe des `UpdateLegalTerms` Änderungstyps hinzufügen. Weitere Informationen finden Sie unter [https://docs.aws.amazon.com/marketplace-catalog/latest/api-reference/cppos.html#update-legal-terms-cppo](https://docs.aws.amazon.com/marketplace-catalog/latest/api-reference/cppos.html#update-legal-terms-cppo).
+ **PricingTerms**— Alle vom Hersteller in der beschriebenen Preisbedingungen (`ConfigurableUpfrontPricingTerm``FixedUpfrontPricingTerm``UsageBasedPricingTerm`,,,`PaymentScheduleTerms`) ResaleAuthorization werden dem Angebotsentwurf hinzugefügt. Sie können sich dafür entscheiden, die Preise (für jede Dimension) für Ihre Zielkunden zu erhöhen, indem Sie die Art der `UpdateMarkup` Änderung verwenden. Weitere Informationen finden Sie unter [https://docs.aws.amazon.com/marketplace-catalog/latest/api-reference/cppos.html#update-markup](https://docs.aws.amazon.com/marketplace-catalog/latest/api-reference/cppos.html#update-markup) in diesem Handbuch.
+ **PaymentTerms**— Wenn der Hersteller den zukünftigen Zahlungsplan im definiert hat ResaleAuthorization, können Sie die Zahlungsbedingungen im Angebotsentwurf sehen. Mithilfe der Option „`UpdateMarkup`Änderung“ können Sie den Betrag des Zahlungsplans für Ihre Zielkunden erhöhen. Wenn Sie den Zahlungsplan für Ihre Käufer festlegen möchten, können Sie verwenden`UpdatePaymentScheduleTerms`. Weitere Informationen finden Sie unter [https://docs.aws.amazon.com/marketplace-catalog/latest/api-reference/cppos.html#update-payment-schedule-terms-cppo](https://docs.aws.amazon.com/marketplace-catalog/latest/api-reference/cppos.html#update-payment-schedule-terms-cppo).
+ **TargetingRule**— Wenn der auf bestimmte Käufer ausgerichtet ResaleAuthorization ist, können Vertriebspartner einer Untergruppe von Käufern private Angebote unterbreiten. PositiveTargeting Standardmäßig umfasst die Regel alle Käufer von ResaleAuthorization. Sie können bestimmte Käufer auswählen und den Angebotsentwurf mithilfe der `UpdateTargeting` Änderungsart aktualisieren. Weitere Informationen finden Sie unter [https://docs.aws.amazon.com/marketplace-catalog/latest/api-reference/cppos.html#update-targeting-cppo](https://docs.aws.amazon.com/marketplace-catalog/latest/api-reference/cppos.html#update-targeting-cppo).
```
{
"EntityType": "Offer@1.0",
"EntityIdentifier": "offer-a5EXAMPLEwzpu@1",
"EntityArn": "arn:aws:aws-marketplace:us-east-1:444555666777:AWSMarketplace/Offer/offer-a5oEXAMPLEzpu",
"LastModifiedDate": "2021-03-10T21:57:16Z",
"DetailsDocument": {
"Id": "offer-3rb23tu92rn",
"Name": "Test Offer",
"Description": "Worldwide private offer for Test Product",
"ProductId": "prod-0bc848d78b51",
"ResaleAuthorizationId": "resaleauthz-123456789",
"Terms": [
{
"Type": "LegalTerm",
"Documents": [
{
"Type": "CustomEula",
"Url": "https://s3.amazonaws.com/EULA/custom-eula-1234.txt"
}
]
},
{
"Type": "ConfigurableUpfrontPricingTerm",
"CurrencyCode": "USD",
"RateCards": [
{
"Selector": {
"Type": "Duration",
"Value": "P12M"
},
"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": "PaymentScheduleTerm",
"CurrencyCode": "USD",
"Schedule": [
{
"ChargeDate": "2020-12-01T00:00:00.000Z",
"ChargeAmount": "1000.00"
},
{
"ChargeDate": "2021-06-15T00:00:00.000Z",
"ChargeAmount": "1250.00"
}
]
}
],
"Rules": [
{
"Type": "TargetingRule",
"PositiveTargeting": {
"BuyerAccounts": [
"111222333444"
]
}
}
]
}
}
```
**Synchrone Validierungen**
Die folgenden Schemavalidierungen sind spezifisch für Aktionen in der. `CreateOfferUsingResaleAuthorization` AWS Marketplace Catalog API Diese Validierungen werden durchgeführt, wenn Sie aufrufen. `StartChangeSet` Wenn die Anfrage die folgenden Anforderungen nicht erfüllt, schlägt sie mit einer HTTP-Antwort fehl.
| Eingabefeld | Validierungsregel | HTTP-Code |
| --- | --- | --- |
| Name | Erforderlich
Die Länge muss zwischen 1 und 150 Zeichen liegen | 422 |
| Description | Erforderlich
Die Länge muss zwischen 1 und 255 Zeichen liegen | 422 |
| ResaleAuthorizationId | Erforderlich
Die Länge muss zwischen 1 und 50 Zeichen liegen | 422 |
| ResaleAuthorizationId | ResaleAuthorization muss auf den Vertriebspartner ausgerichtet sein. | 422 |
| ResaleAuthorizationId | ResaleAuthorization muss aktiv sein | 422 |
| Vertriebspartner | Der Vertriebspartner muss als Verkäufer bezahlt worden sein AWS Marketplace | 422 |
**Asynchrone Fehler**
Die folgenden Fehler beziehen sich spezifisch auf `CreateOfferUsingResaleAuthorization` Aktionen in. AWS Marketplace Catalog API Diese Fehler werden zurückgegeben, wenn Sie aufrufen, `DescribeChangeSet` nachdem ein Änderungssatz verarbeitet wurde. Weitere Hinweise zur Verwendung `DescribeChangeSet` zum Abrufen des Status einer Änderungsanforderung finden Sie unter[Mit Änderungssätzen arbeiten](catalog-apis.md#working-with-change-sets).
| Fehlercode | Fehlermeldung |
| --- | --- |
| INCOMPATIBLE\_RESALE\_AUTHORIZATION | Verwenden Sie einen im aktiven Zustand. ResaleAuthorization |
| INKOMPATIBLE\_PRODUKT | OfferSetId wird in Angeboten für das Produkt nicht unterstützt. |
## Erstellen Sie ein privates Ersatzangebot für Vertriebspartner
Sie können die Katalog-API verwenden, um ein privates Ersatzangebot für Vertriebspartner in zu erstellen AWS Marketplace.
Sie verwenden das `ResaleAuthorization` auf Sie zugeschnittene Angebot und eine Vereinbarung, deren Anbieter Sie sind, um ein privates Ersatzangebot für Vertriebspartner in `Draft` der Katalog-API zu erstellen, indem Sie `StartChangeSet` mit dem `CreateReplacementOfferUsingResaleAuthorization` Änderungstyp aufrufen, wie im folgenden Beispiel gezeigt. Ersatzangebote können verwendet werden, um eine Vereinbarung aus einem früheren Angebot zu ersetzen, bevor dieses ausläuft.
`CreateReplacementOfferUsingResaleAuthorization`erstellt einen Angebotsentwurf, bei dem der Vertragsakzeptor als Zielperson ausgewählt wird. Dieses Targeting kann im Nachhinein nicht mehr geändert werden. Der Angebotsentwurf wird auch die Quellangebots-ID der Vereinbarung enthalten.
Um ein privates Ersatzangebot für Vertriebspartner zu erstellen, rufen Sie den `StartChangeSet` API-Vorgang mit dem `CreateReplacementOfferUsingResaleAuthorization` Änderungstyp auf, wie im folgenden Beispiel gezeigt.
**Anforderungssyntax**
```
POST /StartChangeSet HTTP/1.1
Content-type: application/json
{
"Catalog": "AWSMarketplace",
"ChangeSet": [
{
"ChangeType": "CreateReplacementOfferUsingResaleAuthorization",
"Entity": {
"Type": "Offer@1.0"
},
"DetailsDocument": {
"ResaleAuthorizationId": "2bd2c761-3b7f-3771-a9a7-e8ad36517698",
"Name": "CAPI-saas-abo-contract-fps",
"AgreementId": "agmt-f2ooEXAMLEamtm7mjj0j59gu"
}
}
]
}
```
Geben Sie Informationen für die Felder an, um den `CreateReplacementOfferUsingResaleAuthorization` Änderungstyp hinzuzufügen:
+ **Entität** (Objekt) (erforderlich) — Ihr CPPO.
+ **Typ** (Zeichenfolge) (erforderlich) — Das `Type` ist immer`Offer@1.0`.
+ **DetailsDocument**(object) (erforderlich) — Der JSON-Wert der Einzelheiten der Anfrage.
+ **ResaleAuthorizationId**(string) (erforderlich) — `ResaleAuthorizationId` ist die eindeutige Kennung, die das angebotene Produkt, die Bedingungen und Regeln umfasst. Vertriebspartner können mithilfe von Aktualisierungs-Änderungstypen zusätzliche Bedingungen und Regeln hinzufügen.
`ResaleAuthorization`muss für Sie als Partner verfügbar und zielgerichtet sein.
+ **Name** (Zeichenfolge) (optional) — dem Angebot `Name` zugeordnet, damit es für Sie und Ihre Kunden besser lesbar ist. Er wird auch als Teil der Vertragsinformationen angezeigt.
+ **AgreementId**(Zeichenfolge) (erforderlich) — `AgreementId` ist die eindeutige Kennung der Vereinbarung, die erstellt wurde, als der Zielkäufer das vorherige Angebot angenommen hat, das Sie ersetzen möchten
**Syntax der Antwort**
Für Ihre Anfrage wird ein Änderungssatz erstellt. Die Antwort auf diese Anfrage gibt Ihnen das `ChangeSetId` und `ChangeSetArn` für den Änderungssatz und sieht wie folgt aus.
```
{
"ChangeSetId": "example123456789012abcdef",
"ChangeSetArn": "arn:aws:aws-marketplace:us-east-1:123456789012:AWSMarketplace/ChangeSet/example123456789012abcdef"
}
```
Die Änderungsanforderung wird einer Warteschlange hinzugefügt und verarbeitet.
Sie können den Status der Anfrage über die oder direkt über die AWS Marketplace Management Portal Katalog-API mithilfe des `[DescribeChangeSet](https://docs.aws.amazon.com/marketplace-catalog/latest/api-reference/API_DescribeChangeSet.html)` API-Vorgangs überprüfen.
**Synchrone Validierungen**
Die folgenden Schemavalidierungen sind spezifisch für Aktionen in der. `CreateReplacementOfferUsingResaleAuthorization` AWS Marketplace Catalog API Diese Validierungen werden durchgeführt, wenn Sie aufrufen. `StartChangeSet` Wenn die Anfrage die folgenden Anforderungen nicht erfüllt, schlägt sie mit einer HTTP-Antwort fehl.
| Eingabefeld | Validierungsregel |
| --- | --- |
| Name | Die Länge muss zwischen 1 und 150 Zeichen liegen |
| AgreementId | Die angegebene Vereinbarung muss aktiv sein Vorausgesetzt, die Vereinbarung muss existieren
Die bereitgestellte Vereinbarung muss Eigentum des Channel-Partners sein |
| ResaleAuthorizationId | Erforderlich
Die Länge muss zwischen 1 und 50 Zeichen liegen |
| ResaleAuthorizationId | ResaleAuthorization muss auf den Vertriebspartner ausgerichtet sein. |
| ResaleAuthorizationId | ResaleAuthorization muss aktiv sein |
| Vertriebspartner | Der Vertriebspartner muss als Verkäufer bezahlt worden sein AWS Marketplace |
**Asynchrone Fehler**
Die folgenden Fehler beziehen sich spezifisch auf `CreateReplacementOfferUsingResaleAuthorization` Aktionen in. AWS Marketplace Catalog API Diese Fehler werden zurückgegeben, wenn Sie aufrufen, `DescribeChangeSet` nachdem ein Änderungssatz verarbeitet wurde. Weitere Hinweise zur Verwendung `DescribeChangeSet` zum Abrufen des Status einer Änderungsanforderung finden Sie unter[Mit Änderungssätzen arbeiten](catalog-apis.md#working-with-change-sets).
| Fehlercode | Fehlermeldung |
| --- | --- |
| INCOMPATIBLE\_RESALE\_AUTHORIZATION | Verwenden Sie einen im aktiven Zustand. ResaleAuthorization |
| INCOMPATIBLE\_RESALE\_AUTHORIZATION | Das ResaleAuthorization muss für dasselbe Produkt gelten, das mit der Vereinbarung verknüpft ist. |
| INCOMPATIBLE\_RESALE\_AUTHORIZATION | Verwenden Sie eine, die sich an den Akzeptor der ResaleAuthorization Vereinbarung richtet. |
## Markup aktualisieren
Sie können die Katalog-API verwenden, um die Preisbedingungen um einen prozentualen Wert in Ihrem Angebot in AWS Marketplace zu aktualisieren.
Dadurch wird der angegebene prozentuale Aufschlag auf alle Preisbedingungen und Zahlungsbedingungen (für future Zahlungspläne) angewendet, die vom Hersteller in der ResaleAuthorization definiert sind. Alle vorhandenen Aufschläge werden überschrieben. Aktualisierte Preis- und Zahlungsbedingungen können Sie unter einsehen. `DescribeEntity`
Um das Markup zu aktualisieren, rufen Sie den `StartChangeSet` API-Vorgang mit dem `UpdateMarkup` Änderungstyp auf, wie im folgenden Beispiel gezeigt.
**Anforderungssyntax**
```
POST /StartChangeSet HTTP/1.1
Content-type: application/json
{
"Catalog": "AWSMarketplace",
"ChangeSet": [
{
"ChangeType": "UpdateMarkup",
"Entity": {
"Type": "Offer@1.0",
"Identifier": "offer-123456789"
},
"DetailsDocument": {
"Percentage": "5.0"
}
}
]
}
```
Geben Sie Informationen für die Felder an, um den `UpdateMarkup` Änderungstyp hinzuzufügen:
+ **Entität** (Objekt) (erforderlich) — Ihr CPPO.
+ **Typ** (Zeichenfolge) (erforderlich) — Das `Type` ist immer`Offer@1.0`.
+ **Kennung** (Zeichenfolge) (erforderlich) — Ihre Angebots-ID. Weitere Informationen finden Sie unter [Kennung](catalog-apis.md#identifier).
+ **DetailsDocument**(Objekt) (erforderlich) — Der JSON-Wert der Einzelheiten der Anfrage.
+ **Percentage** (string) (erforderlich) — Der prozentuale Wert wird zu den Preis- oder Zahlungsbedingungen des Herstellers hinzugerechnet.
**Syntax der Antwort**
Für Ihre Anfrage wird ein Änderungssatz erstellt. Die Antwort auf diese Anfrage gibt Ihnen das `ChangeSetId` und `ChangeSetArn` für den Änderungssatz und sieht wie folgt aus.
```
{
"ChangeSetId": "example123456789012abcdef",
"ChangeSetArn": "arn:aws:aws-marketplace:us-east-1:123456789012:AWSMarketplace/ChangeSet/example123456789012abcdef"
}
```
Die Änderungsanforderung wird einer Warteschlange hinzugefügt und verarbeitet. Dazu gehört auch die Überprüfung der Informationen durch das AWS Marketplace Seller Operations Team, um sicherzustellen, dass sie den AWS Marketplace Richtlinien entsprechen. Der Validierungsprozess kann zwischen einigen Minuten und einigen Stunden dauern.
Sie können den Status der Anfrage über die AWS Marketplace Management Portal oder 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. `UpdateMarkup` AWS Marketplace Catalog API Diese Validierungen werden durchgeführt, wenn Sie aufrufen. `StartChangeSet` Wenn die Anfrage die folgenden Anforderungen nicht erfüllt, schlägt sie mit einer HTTP-Antwort fehl.
| Eingabefeld | Validierungsregel |
| --- | --- |
| Prozentsatz | Erforderlich
Der Datentyp ist „Zeichenfolge“
Muss nicht negativ sein
Erlauben Sie bis zu 9 Dezimalstellen |
**Asynchrone Fehler**
Die folgenden Fehler beziehen sich spezifisch auf `UpdateMarkup` Aktionen in. AWS Marketplace Catalog API Diese Fehler werden zurückgegeben, wenn Sie aufrufen, `DescribeChangeSet` nachdem ein Änderungssatz verarbeitet wurde. Weitere Hinweise zur Verwendung `DescribeChangeSet` zum Abrufen des Status einer Änderungsanforderung finden Sie unter[Mit Änderungssätzen arbeiten](catalog-apis.md#working-with-change-sets).
| Fehlercode | Fehlermeldung |
| --- | --- |
| INCOMPATIBLE\_MARKUP | Die angeforderte Änderung kann nach der Veröffentlichung des Angebots nicht durchgeführt werden. |
| INCOMPATIBLE\_RESALE\_AUTHORIZATION | MarkupPercentagekönnen nicht aktualisiert werden, wenn PaymentScheduleTerm oder im Angebot vorhanden sind und nicht vorhanden FixedUpfrontPricingTerm sind. ResaleAuthorization |
| INKOMPATIBLE\_TERMS | Verwenden Sie entweder UpdatePaymentScheduleTerms mit einem bestimmten Zahlungsbetrag oder UpdateMarkup mit einem einzigen Aufschlagsprozentsatz für die geplanten Termine. |
| INVALID\_MARKUP\_PERCENTAGE | UpdateMarkup kann nur für Angebote aufgerufen werden, die mit erstellt wurden. ResaleAuthorization |
## Targeting-Konfiguration aktualisieren
Sie können die Katalog-API verwenden, um die bestehende Targeting-Konfiguration in vollständig zu ersetzen AWS Marketplace.
Alle vorhandenen Targeting-Optionen, die nicht in der letzten Anfrage enthalten sind, werden aus dem Angebot entfernt. Hersteller können bestimmte Zielkäufer in erwähnen`ResaleAuthorization`. Vertriebspartner können einer Untergruppe von Käufern private Angebote unterbreiten, indem sie `PositiveTargeting` den `UpdateTargeting` Änderungstyp verwenden.
Um die Targeting-Konfigurationen 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": [
"111222333444"
]
},
"NegativeTargeting": {
"CountryCodes": [
"XX"
]
}
}
}
]
}
```
Geben Sie Informationen für die Felder an, um den `UpdateTargeting` Änderungstyp hinzuzufügen:
+ **Entität** (Objekt) (erforderlich) — Ihr CPPO.
+ **Typ** (Zeichenfolge) (erforderlich) — Das `Type` ist immer`Offer@1.0`.
+ **Kennung** (Zeichenfolge) (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 jedes Käuferprofil erfüllen muss, um auf das Angebot zugreifen zu können. Dieses Feld ist optional, aber wenn dieses Feld vorhanden ist, sollte mindestens eine Targeting-Option angegeben werden.
+ **CountryCodes**(Zeichenkettenarray) (optional) — Liste als Option, um die Ausrichtung auf Länderbasis 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 einen Ländercode enthalten. Jedes Element in dieser Liste sollte ein gültiger Ländercode mit zwei Buchstaben sein und das folgende Format verwenden: ISO 3166-1 Alpha-2.
+ **BuyerAccounts**(Reihe von Zeichenketten) (optional) — Liste als Option, um Targeting auf Basis von AWS-Konten (auch bekannt als „Privatangebot“) zu ermöglichen. 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 nur eingeschränkt auf das Angebot zugreifen zu können. Obwohl dieses Feld optional ist, sollte mindestens eine Targeting-Option angegeben werden, wenn dieses Feld vorhanden ist.
+ **CountryCodes**(Zeichenkettenarray) (erforderlich) — Liste als Option, um die Ausrichtung auf Länderbasis 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 einen Ländercode enthalten. Bei jedem Element in dieser Liste sollte es sich um einen gültigen Ländercode mit zwei Buchstaben handeln, der das folgende Format verwendet: 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 der Informationen, um sicherzustellen, dass sie den AWS Marketplace Richtlinien entsprechen. Der Validierungsprozess kann zwischen einigen Minuten und einigen Stunden dauern.
Sie können den Status der Anfrage über die AWS Marketplace Management Portal oder 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 aufrufen. `StartChangeSet` Wenn die Anfrage die folgenden Anforderungen nicht erfüllt, schlägt sie mit einer HTTP-Antwort fehl.
| Eingabefeld | Validierungsregel | HTTP-Code |
| --- | --- | --- |
| Details | Erforderlich | 422 |
| PositiveTargeting | Optional | 422 |
| NegativeTargeting | Optional | 422 |
| PositiveTargeting.CountryCodes | Optional
Die Ländercodes müssen gültig sein (ISO 3166-1 Alpha-2) | 422 |
| PositiveTargeting.BuyerAccounts | Optional
AWS-Konto IDs müssen ein gültiges Format haben (12-stellige Zahl)
Darf nicht mehr als 25 Konten enthalten | 422 |
| NegativeTargeting.CountryCodes | Optional
Die Ländercodes müssen gültig sein (ISO 3166-1 Alpha-2) | 422 |
| NegativeTargeting.BuyerAccounts | Darf nicht angegeben werden (negatives Targeting on wird BuyerAccounts nicht unterstützt) | 422 |
**Asynchrone Fehler**
Die folgenden Fehler beziehen sich spezifisch auf `UpdateTargeting` Aktionen in. AWS Marketplace Catalog API Diese Fehler werden zurückgegeben, wenn Sie aufrufen, `DescribeChangeSet` nachdem ein Änderungssatz verarbeitet wurde. Weitere Hinweise zur Verwendung `DescribeChangeSet` zum Abrufen des Status einer Änderungsanforderung finden Sie unter[Mit Änderungssätzen arbeiten](catalog-apis.md#working-with-change-sets).
| Fehlercode | Fehlermeldung |
| --- | --- |
| INVALID\_BUYER\_ACCOUNTS | Geben Sie gültige Käuferkonten an. Ungültige Konten: [x]. |
| INVALID\_COUNTRY\_CODES | Geben Sie die unterstützten Ländercodes an. |
| UNGÜLTIGES TARGETING | Verwenden Sie entweder negatives oder positives Targeting für dasselbe Attribut. |
| INKOMPATIBLE\_PRODUCT | Country-based Targeting wird für das Produkt nicht unterstützt. |
| INCOMPATIBLE\_RESALE\_AUTHORIZATION | Vorausgesetzt, dass sie mit dem kompatibel sind. BuyerAccounts ResaleAuthorization |
| INKOMPATIBLE\_TARGETING | Die angeforderte Änderung kann nicht durchgeführt werden, nachdem das Angebot veröffentlicht wurde. |
| INCOMPATIBLE\_TARGETING | Die angeforderte Änderung kann nicht durchgeführt werden, nachdem das Angebot abgelaufen ist. |
| INCOMPATIBLE\_TARGETING | Das Targeting kann bei einem Ersatzangebot nicht aktualisiert werden. Wenn der Käufer nicht mit dem bereitgestellten Angebot verknüpft ist AgreementId, erstellen Sie ein neues privates Angebot, indem Sie ein mit dem Käufer AgreementId verknüpftes Angebot angeben. |
| ZU VIELE KONTEN VON KÄUFERN | Geben Sie innerhalb der zulässigen Grenzen an. BuyerAccounts |
## Rechtliche Ressourcen aktualisieren
Sie können die Katalog-API verwenden, um die rechtlichen Bestimmungen der Resale Authorization zusammenzuführen und die bestehenden rechtlichen Bestimmungen in AWS Marketplace vollständig zu ersetzen.
Diese Änderung hat keine Auswirkungen auf bestehende Vereinbarungen. Die rechtlichen Bestimmungen, die in der letzten Anfrage nicht enthalten sind, werden aus dem Angebot entfernt. Sie können die zusammengefassten rechtlichen Bestimmungen telefonisch einsehen`DescribeEntity`.
Um die rechtlichen Bestimmungen 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 an, um den `UpdateLegalTerms` Änderungstyp hinzuzufügen:
+ **Entität** (Objekt) (erforderlich) — Ihr CPPO.
+ **Typ** (Zeichenfolge) (erforderlich) — Das `Type` ist immer`Offer@1.0`.
+ **Kennung** (Zeichenfolge) (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** (Anordnung von Strukturen) (erforderlich) — Liste der rechtlichen Begriffe, die Sie aktualisieren möchten. Folgende Rechtsbegriffe werden unterstützt:
+ **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) — Kategorie des Begriffs, der aktualisiert wird.
+ **Dokumente** (Anordnung von Strukturen) (erforderlich) — Liste mit Verweisen auf juristische Ressourcen, die den Käufern vorgeschlagen werden sollen. Ein Beispiel für eine solche Ressource ist die Endbenutzer-Lizenzvereinbarung (EULA). Jede Referenz besteht aus einem Typ und einer URL:
+ **Typ** (Zeichenfolge) (erforderlich) — Art des Dokuments. Verfügbare Dokumenttypen sind:
+ **CustomEula**— Eine benutzerdefinierte EULA, die von Ihnen als Verkäufer bereitgestellt wurde. Für diesen Dokumenttyp ist eine URL für eine EULA erforderlich, die in einem zugänglichen S3-Bucket gespeichert ist.
+ **StandardEula**— Standardvertrag für AWS Marketplace (SCMP). Weitere Informationen zu SCMP finden Sie im AWS Marketplace Verkäuferleitfaden. Sie geben keine URL für diesen Typ an, da er von AWS Marketplace verwaltet wird.
+ **Url** (Zeichenfolge) (bedingt erforderlich) — Eine URL zu dem rechtlichen Dokument, das Käufer lesen können. `Type`Erforderlich, wenn einer der folgenden Werte zutrifft [`CustomEula`].
+ **Version** (Zeichenfolge) (bedingt erforderlich) — Eine Version von Standardverträgen, bereitgestellt von AWS Marketplace. Dies ist erforderlich, wenn dies der Fall `Type` ist`StandardEula`. Verfügbare Versionen sind:
+ **14.07.2022** — Diese Version des Standardvertrags für AWS Marketplace ist in diesem Amazon S3 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)
Für Ihre Anfrage wird ein Änderungssatz erstellt. Die Antwort auf diese Anfrage gibt Ihnen die ID für den Änderungssatz.
**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 auch die Überprüfung der Informationen durch das AWS Marketplace Seller Operations Team, um sicherzustellen, dass sie den AWS Marketplace Richtlinien entsprechen. Der Validierungsprozess kann zwischen einigen Minuten und einigen Stunden dauern. Sie können den Status der Anfrage über die AWS Marketplace Management Portal oder in der Katalog-API mit der `DescribeChangeSet` Aktion ü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 aufrufen. `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 |
| Bedingungen []. LegalTerm.Documents | Erforderlich | 422 |
| Bedingungen []. LegalTerm.Documents[] .Typ | Erforderlich
Zulässige Werte:[See the AWS documentation website for more details](http://docs.aws.amazon.com/de_de/marketplace/latest/developerguide/work-with-cppos.html) | 422 |
| Bedingungen []. LegalTerm.Documents[] .URL | Erforderlich und muss eine gültige URL sein, wenn „Type“ einer von[See the AWS documentation website for more details](http://docs.aws.amazon.com/de_de/marketplace/latest/developerguide/work-with-cppos.html) | 422 |
**Asynchrone Fehler**
Die folgenden Fehler beziehen sich spezifisch auf `UpdateLegalTerms` Aktionen in. AWS Marketplace Catalog API Diese Fehler werden zurückgegeben, wenn Sie aufrufen, `DescribeChangeSet` nachdem ein Änderungssatz verarbeitet wurde. Weitere Hinweise zur Verwendung `DescribeChangeSet` zum Abrufen des Status einer Änderungsanforderung finden Sie unter[Mit Änderungssätzen arbeiten](catalog-apis.md#working-with-change-sets).
| Fehlercode | Fehlermeldung |
| --- | --- |
| INCOMPATIBLE\_TERMS | Die angeforderte Änderung kann nach Veröffentlichung des Angebots nicht durchgeführt werden. |
| INKOMPATIBLE\_TERMS | Die angeforderte Änderung kann nicht durchgeführt werden, nachdem das Angebot abgelaufen ist. |
| UNGÜLTIGE\_LEGAL\_DOCUMENTS | Geben Sie URLs für juristische Dokumente an, die in zugänglichen S3-Buckets gespeichert sind. |
| UNGÜLTIGE\_LEGAL\_DOCUMENTS | Nur die neueste Version von StandardEula wird für neue Angebote unterstützt. |
| UNGÜLTIGE\_LEGAL\_DOCUMENTS | Stellen Sie juristische Dokumente in den unterstützten Dateiformaten bereit. |
| UNGÜLTIGE\_LEGAL\_DOKUMENTE | Stellen Sie juristische Dokumente unter Verwendung der unterstützten Dokumenttypen bereit. |
| LIMIT\_EXCEEDED\_LEGAL\_DOCUMENT\_SIZE | Stellen Sie juristische Dokumente innerhalb der zulässigen Größenbeschränkungen bereit. |
## Aktualisieren Sie die Auffindbarkeit des CPPO
Sie können die Katalog-API verwenden, um die Auffindbarkeit Ihres Angebots in zu verwalten. AWS Marketplace Dieser Änderungstyp hat keine Auswirkungen auf bestehende Vereinbarungen.
Sie können entweder ein bestimmtes Datum in der future festlegen, um die Auffindbarkeit Ihres Angebots einzuschränken, oder ob Ihr Angebot in der Vergangenheit ablaufen soll.
Um die Auffindbarkeit Ihres Angebots zu verwalten, 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 an, um den `UpdateAvailability` Änderungstyp hinzuzufügen:
+ **Entität** (Objekt) (erforderlich) — Ihr CPPO.
+ **Typ** (Zeichenfolge) (erforderlich) — Das `Type` ist immer`Offer@1.0`.
+ **Kennung** (Zeichenfolge) (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) — Datum, bis zu dem das Angebot auffindbar und käuflich erworben werden kann. AWS Marketplace Sie können wählen, ob Sie ein bestimmtes Datum in der future festlegen möchten, um die Verfügbarkeit einzuschränken, oder ob das Angebot in der Vergangenheit abläuft. Daten werden im `YYYY-MM-DD` Format dargestellt. Das Angebot läuft am angegebenen Datum um 23:59:59.999 UTC 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 der Informationen, um sicherzustellen, dass sie den AWS Marketplace Richtlinien entsprechen. Der Validierungsprozess kann zwischen einigen Minuten und einigen Stunden dauern.
Sie können den Status der Anfrage über die AWS Marketplace Management Portal oder 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. `UpdateAvailability` AWS Marketplace Catalog API Diese Validierungen werden durchgeführt, wenn Sie aufrufen. `StartChangeSet` Wenn die Anfrage die folgenden Anforderungen nicht erfüllt, schlägt sie mit einer HTTP-Antwort fehl.
| Eingabefeld | Validierungsregel | HTTP-Code |
| --- | --- | --- |
| AvailabilityEndDate | Erforderlich
Format: "YYYY-MM-DD“ | 422 |
**Asynchrone Fehler**
Die folgenden Fehler beziehen sich spezifisch auf `UpdateAvailability` Aktionen in. AWS Marketplace Catalog API Diese Fehler werden zurückgegeben, wenn Sie aufrufen, `DescribeChangeSet` nachdem ein Änderungssatz verarbeitet wurde. Weitere Hinweise zur Verwendung `DescribeChangeSet` zum Abrufen des Status einer Änderungsanforderung finden Sie unter[Mit Änderungssätzen arbeiten](catalog-apis.md#working-with-change-sets).
| Fehlercode | Fehlermeldung |
| --- | --- |
| INVALID\_AVAILABILITY\_END\_DATE | AvailabilityEndDate wird für öffentliche Angebote nicht unterstützt. |
| UNGÜLTIGES VERFÜGBARKEITSENDDATUM | Sorgen Sie für eine future AvailabilityEndDate. |
| UNGÜLTIGER\_VERFÜGBARKEITSENDDATUM | Geben Sie einen Wert an, der 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 Vereinbarungen
Sie können die Katalog-API verwenden, um das Ablaufdatum der Vereinbarungen zu definieren, die mit diesem Angebot in erstellt wurden AWS Marketplace.
Diese Änderung hat keine Auswirkungen auf bestehende Vereinbarungen. Der Hersteller könnte in einer Wiederverkaufserlaubnis das maximale Startdatum der Vereinbarung angeben. Vertriebspartner können jedoch kein Startdatum für die Vereinbarung angeben, das nach diesem Datum liegt.
Um das Ablaufdatum von Vereinbarungen zu definieren, 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 an, um den `UpdateValidityTerms` Änderungstyp hinzuzufügen:
+ **Entität** (Objekt) (erforderlich) — Ihr CPPO.
+ **Typ** (Zeichenfolge) (erforderlich) — Das `Type` ist immer`Offer@1.0`.
+ **Kennung** (Zeichenfolge) (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** (Anordnung von Strukturen) **—** Liste der Gültigkeitsbedingungen, die Sie aktualisieren möchten. Folgende Gültigkeitsbedingungen werden unterstützt:
+ **ValidityTerm**(Objekt) **—** Definiert die Bedingungen, unter denen eine auf der Grundlage dieses Angebots erstellte Vereinbarung gültig bleibt.
+ **Typ** (Zeichenfolge) **—** Kategorie des Begriffs, der aktualisiert wird.
+ **AgreementDuration**(string) **—** Definiert die Dauer, für die die Vereinbarung aktiv bleibt. Wenn `AgreementStartDate` nicht angegeben, bezieht sich die Dauer der Vereinbarung auf die Zeit 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 am angegebenen Datum. Falls `AgreementStartDate` nicht angegeben, wird das Startdatum der Vereinbarung anhand der Uhrzeit der Unterzeichnung der Vereinbarung bestimmt.
+ **AgreementEndDate**(Zeichenfolge) **—** 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 am angegebenen Datum. Wenn `AgreementEndDate` nicht angegeben, wird das Enddatum der Vereinbarung durch die Gültigkeit der einzelnen Bedingungen bestimmt.
**Syntax der Antwort**
Für Ihre Anfrage wird ein Änderungssatz erstellt. Die Antwort auf diese Anfrage gibt Ihnen das `ChangeSetId` und `ChangeSetArn` für den Änderungssatz und sieht wie folgt aus.
```
{
"ChangeSetId": "example123456789012abcdef",
"ChangeSetArn": "arn:aws:aws-marketplace:us-east-1:123456789012:AWSMarketplace/ChangeSet/example123456789012abcdef"
}
```
Die Änderungsanforderung wird einer Warteschlange hinzugefügt und verarbeitet. Dazu gehört auch die Überprüfung der Informationen, um sicherzustellen, dass sie den AWS Marketplace Richtlinien entsprechen. Der Validierungsprozess kann zwischen einigen Minuten und einigen Stunden dauern.
Sie können den Status der Anfrage über die 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 aufrufen. `StartChangeSet` Wenn die Anfrage die folgenden Anforderungen nicht erfüllt, schlägt sie mit einer HTTP-Antwort fehl.
| Eingabefeld | Validierungsregel | HTTP-Code |
| --- | --- | --- |
| Bedingungen | Erforderlich
In der Liste ist nur ValidityTerm "" zulässig
Muss leer sein oder nur einen Begriff enthalten | 422 |
| Bedingungen []. ValidityTerm | Unterstützte Anwendungsfälle:
1. ValidityTerm mit nur AgreementDuration
2. ValidityTerm mit nur AgreementStartDate
3. ValidityTerm mit nur AgreementEndDate
4. ValidityTerm mit beiden AgreementStartDate und AgreementEndDate | 422 |
| Bedingungen []. ValidityTerm.AgreementDuration | Optional
Dargestellt im ISO\_8601-Format. | 422 |
| Bedingungen []. ValidityTerm.AgreementStartDate | Optional
Format: "YYYY-MM-DD“ | 422 |
| Bedingungen []. ValidityTerm.AgreementEndDate | Optional
Format: "YYYY-MM-DD“ | 422 |
**Asynchrone Fehler**
Die folgenden Fehler beziehen sich spezifisch auf `UpdateValidityTerms` Aktionen in. AWS Marketplace Catalog API Diese Fehler werden zurückgegeben, wenn Sie aufrufen, `DescribeChangeSet` nachdem ein Änderungssatz verarbeitet wurde. Weitere Hinweise zur Verwendung `DescribeChangeSet` zum Abrufen des Status einer Änderungsanforderung finden Sie unter[Mit Änderungssätzen arbeiten](catalog-apis.md#working-with-change-sets).
| Fehlercode | Fehlermeldung |
| --- | --- |
| INCOMPATIBLE\_AGREEMENT | AgreementStartDate kann nicht in der future liegen, wenn die aktuelle Vereinbarung, die ersetzt werden soll, nicht in der future datiert ist. |
| INCOMPATIBLE\_AGREEMENT\_END\_DATE | AgreementEndDate kann nicht aktualisiert werden, nachdem das Angebot veröffentlicht wurde. |
| INCOMPATIBLE\_AGREEMENT\_START\_DATE | AgreementStartDate kann nicht aktualisiert werden, nachdem das Angebot veröffentlicht wurde. |
| INKOMPATIBLE\_PRODUKT | AgreementStartDate wird in future nicht unterstützt. |
| INCOMPATIBLE\_RESALE\_AUTHORIZATION | Stellen Sie sicher, dass die Dauer zwischen und mit dem kompatibel ist. AgreementStartDate AgreementEndDate ResaleAuthorization |
| INCOMPATIBLE\_RESALE\_AUTHORIZATION | Stellen Sie sicher, dass es kompatibel ist mit dem. AgreementStartDate ResaleAuthorization |
| INCOMPATIBLE\_RESALE\_AUTHORIZATION | Stellen Sie sicher, dass es kompatibel ist mit dem. AgreementEndDate ResaleAuthorization |
| INCOMPATIBLE\_RESALE\_AUTHORIZATION | Stellen Sie sicher, dass die Dauer zwischen und mit dem kompatibel ist. AgreementStartDate AgreementEndDate ResaleAuthorization |
| INCOMPATIBLE\_RESALE\_AUTHORIZATION | Stellen Sie sicher, dass die in der angegebene Dauer eingehalten wird. AgreementDuration ResaleAuthorization |
| INKOMPATIBLE\_TERMS | ValidityTerm wird für öffentliche Angebote nicht unterstützt. |
| INKOMPATIBLE\_TERMS | Die angeforderte Änderung kann nicht durchgeführt werden, nachdem das Angebot abgelaufen ist. |
| INVALID\_AGREEMENT\_DURATION | Geben Sie an AgreementDuration , dass dies mehr als oder gleich [x] Tagen ist. |
| UNGÜLTIGER\_ENDDATUM DER VEREINBARUNG | Sorgen Sie für eine future AgreementEndDate. |
| UNGÜLTIGER\_ENDDATUM DER VEREINBARUNG | Geben Sie an AgreementEndDate , dass es nach oder gleich [x] liegt. |
| UNGÜLTIGES STARTDATUM DER VEREINBARUNG | Geben Sie eine an, die danach ist. AgreementStartDate AvailabilityEndDate |
| UNGÜLTIGER\_STARTDATUM DER VEREINBARUNG | Geben Sie eine an, die vor dem liegt. AgreementStartDate AgreementEndDate |
| UNGÜLTIGES STARTDATUM DER VEREINBARUNG | Geben Sie eine Frist an AgreementStartDate , die innerhalb von [x] Jahren ab heute liegt. |
| INVALID\_AGREEMENT\_TIME\_INTERVAL | ValidityTerm mit beiden und wird nicht unterstützt. AgreementDuration AgreementEndDate |
| INVALID\_AGREEMENT\_TIME\_INTERVAL | ValidityTerm mit beiden AgreementStartDate und wird in einem Angebot für AgreementDuration das Produkt nicht unterstützt. |
| INVALID\_AGREEMENT\_TIME\_INTERVAL | ValidityTerm with wird in einem Angebot für das Produkt AgreementStartDate nicht unterstützt. |
| INVALID\_AGREEMENT\_TIME\_INTERVAL | ValidityTerm with only wird nicht unterstützt. AgreementStartDate |
| INVALID\_AGREEMENT\_TIME\_INTERVAL | AgreementEndDate wird nur unterstützt, wenn es in Kombination mit future Angeboten AgreementStartDate oder Ersatzangeboten verwendet wird. |
| INVALID\_AGREEMENT\_TIME\_INTERVAL | Geben Sie AgreementStartDate AgreementEndDate an, wobei der Unterschied weniger als oder gleich [x] Jahren ist. |
| FEHLENDES STARTDATUM DER VEREINBARUNG | Stellen Sie sicher, dass AgreementStartDate es vorhanden ist, wenn es zusammen mit verwendet wird. ValidityTerm ConfigurableUpfrontPricingTerm |
## Preise aktualisieren
Sie können die Katalog-API verwenden, um die bestehenden Preisbedingungen vollständig zu ersetzen.
Die Preisbedingungen, die in der letzten Anfrage nicht enthalten sind, werden aus dem Angebot entfernt. Channel-Partner können diesen Änderungstyp nur zum Bestehen verwenden`FixedUpFrontPricingTerm`.
Um die Preisbedingungen für Ihre Angebote zu aktualisieren, rufen Sie den `StartChangeSet` API-Vorgang mit dem `UpdatePricingTerms` Änderungstyp auf, wie im folgenden Beispiel gezeigt.
**Anforderungssyntax**
```
POST /StartChangeSet HTTP/1.1
Content-type: application/json
{
"Catalog": "AWSMarketplace",
"ChangeSet": [
{
"ChangeType": "UpdatePricingTerms",
"Entity": {
"Type": "Offer@1.0",
"Identifier": "offer-123456789"
},
"Details": {
"PricingModel": "Contract",
"Terms": [
{
"Type": "FixedUpfrontPricingTerm",
"CurrencyCode": "USD",
"Price": "200.00",
"Duration": "P465D",
"Grants": [
{
"DimensionKey": "Users",
"MaxQuantity": 10
}
]
}
]
}
}
]
}
```
Geben Sie Informationen für die Felder ein, um den `UpdatePricingTerms` Änderungstyp hinzuzufügen:
+ **Entität** (Objekt) (erforderlich) — Ihr CPPO.
+ **Typ** (Zeichenfolge) (erforderlich) — Das `Type` ist immer`Offer@1.0`.
+ **Kennung** (Zeichenfolge) (erforderlich) — Ihre Angebots-ID. Weitere Informationen finden Sie unter [Kennung](catalog-apis.md#identifier).
+ **Details** (Zeichenfolge) (erforderlich) — Einzelheiten der Anfrage. Dieses Feld ist ein JSON-Zeichenkettenfeld. Es muss für ein einzeiliges Zeichenkettenfeld ordnungsgemäß formatiert sein, einschließlich Escape-Zeichen (wie Anführungszeichen), die in einer Zeichenfolge nicht vorkommen dürfen.
+ **PricingModel**(string) (erforderlich) — Preismodell für Ihr Angebot. Mögliche Werte für das Preismodell sind:
+ **Vertrag** — Contract-based Preismodell, bei dem den Käufern entweder die Nutzung Ihres Produkts im Voraus in Rechnung gestellt wird oder ein flexibler Zahlungsplan angeboten wird. Käufer können auch für eine zusätzliche Nutzung bezahlen, die über ihren Vertrag hinausgeht.
+ **Bedingungen** (Anordnung von Strukturen) (erforderlich) — Liste der Preisbedingungen, die Sie aktualisieren möchten. Folgende Preisbedingungen werden unterstützt:
+ **FixedUpfrontPricingTerm**(Objekt) — Definiert ein Prepaid-Preismodell, bei dem den Kunden ein fester Vorausbetrag berechnet wird.
+ **Type** (string) (erforderlich) — Typ des Begriffs, der aktualisiert wird.
+ **CurrencyCode**(string) (erforderlich) — Definiert die Währung für die in diesem Begriff genannten Preise. Bei öffentlichen Angeboten werden nur USD unterstützt. Bei privaten Angeboten werden USD, AUD, EUR, GBP und JPY unterstützt.
+ **Preis** (Zeichenfolge) (erforderlich) — Festbetrag, der dem Kunden in Rechnung gestellt wird, wenn diese Frist akzeptiert wird.
+ **Zuschüsse** (eine Reihe von Strukturen) (erforderlich) — Ansprüche, die dem Antragsteller im Rahmen der Vertragsabwicklung im Voraus gewährt werden.
+ **DimensionKey**(string) (erforderlich) — Eindeutiger Dimensionsschlüssel, der im Produktdokument definiert ist. Abmessungen stellen Kapazitätskategorien in einem Produkt dar und werden angegeben, wenn das Produkt aufgeführt wird AWS Marketplace.
+ **MaxQuantity**(Ganzzahl) (optional) — Maximale Kapazität, auf die der Käufer bei der angegebenen Produktgröße Anspruch haben kann. Wenn nicht `MaxQuantity` angegeben, kann der Käufer eine unbegrenzte Menge der angegebenen Größe nutzen.
+ **Dauer** (Zeichenfolge) (optional) — Definiert die Dauer, für die der Begriff 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 der Informationen, um sicherzustellen, dass sie den AWS Marketplace Richtlinien entsprechen. Der Validierungsprozess kann zwischen einigen Minuten und einigen Stunden dauern.
Sie können den Status der Anfrage über die AWS Marketplace Management Portal oder 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 aufrufen. `StartChangeSet` Wenn die Anfrage die folgenden Anforderungen nicht erfüllt, schlägt sie mit einer HTTP-Antwort fehl.
| Eingabefeld | Validierungsregel |
| --- | --- |
| PricingModel | Erforderlich
Zulässige Preismodelle:
Vertrag |
| Bedingungen | Erforderlich
Zulässige Begriffe:
FixedUpfrontPricingTerm |
| Bedingungen []. FixedUpfrontPricingTerm.CurrencyCode | Erforderlich
Zulässige Werte: ["USD“, „AUD“, „EUR“, „GBP“, „JPN"]
Zulässige Preismodelle:
Vertrag |
| Bedingungen []. FixedUpfrontPricingTerm.Price | Erforderlich
Der Datentyp ist „Zeichenfolge“. Muss nicht negativ sein
Support bis zu 6 Dezimalstellen
Es werden keine Sonderzeichen unterstützt |
| Bedingungen []. FixedUpfrontPricingTerm.Duration | Erforderlich
Erwartetes Format: ISO 8601-Dauer |
| Bedingungen []. FixedUpfrontPricingTerm.Grants[]. DimensionKey | Erforderlich
Die Länge muss zwischen 1 und 60 liegen |
| Bedingungen []. FixedUpfrontPricingTerm.Grants[]. MaxQuantity | Erforderlich |
**Asynchrone Fehler**
Die folgenden Fehler beziehen sich spezifisch auf `UpdatePricingTerms` Aktionen in. AWS Marketplace Catalog API Diese Fehler werden zurückgegeben, wenn Sie aufrufen, `DescribeChangeSet` nachdem ein Änderungssatz verarbeitet wurde. Weitere Hinweise zur Verwendung `DescribeChangeSet` zum Abrufen des Status einer Änderungsanforderung finden Sie unter[Mit Änderungssätzen arbeiten](catalog-apis.md#working-with-change-sets).
| Fehlercode | Fehlermeldung |
| --- | --- |
| DUPLICATE\_DIMENSION\_KEYS | Stellen Sie Grants eine eindeutige Liste von Dimensionsschlüsseln in [x] zur Verfügung. |
| DUPLICATE\_DIMENSION\_KEYS | Geben Sie in RateCard [x] eine eindeutige Liste von Dimensionsschlüsseln an. |
| DUPLICATE\_SELECTORS | Stellen Sie eine eindeutige Liste von Selektoren in bereit. ConfigurableUpfrontPricingTerm |
| DUPLICATE\_TERM\_TYPES | Stellen Sie eine eindeutige Liste von Begriffstypen bereit. |
| INKOMPATIBLE\_AGREEMENT | Die folgenden Begriffe können nicht aus dem Ersatzangebot entfernt werden: [x, y, z]. |
| INCOMPATIBLE\_AGREEMENT | Die folgenden Bedingungen können dem Ersatzangebot nicht hinzugefügt werden: [x, y, z]. |
| INKOMPATIBLE\_CURRENCY\_CODE | CurrencyCode kann nach Veröffentlichung des Angebots nicht mehr geändert werden. |
| INCOMPATIBLE\_PAYMENT\_SETTINGS | Aktualisieren Sie Ihre Zahlungseinstellungen, damit sie mit dem kompatibel sind. CurrencyCode |
| INKOMPATIBLE\_PRODUKT | Das Nutzungspreismodell wird für das Produkt nicht unterstützt. |
| INKOMPATIBLE\_PRODUKT | Das vertraglich vereinbarte Preismodell 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\_PRODUCT | Vorausgesetzt, dass die Zahlungs- und Preisbedingungen nicht kompatibel sind. |
| INKOMPATIBLE\_PRODUCT | Verwenden Sie die vorhandenen, verfügbaren Abmessungen des Produkts in [x]. |
| INKOMPATIBLE\_PRODUCT | FreeTrialPricingTerm da die einzige Preisbedingung des Angebots für das Produkt nicht unterstützt wird. |
| INKOMPATIBLE\_PRODUCT | Die folgenden Begriffe werden für das Produkt nicht unterstützt: [x, y, z]. |
| INKOMPATIBLE\_PRODUCT | Ersatzangebote werden nur für das Vertragspreismodell unterstützt. |
| INKOMPATIBLE\_PRODUCT | Geben Sie Preisbedingungen an, die mit den Produktabmessungen kompatibel sind. Inkompatible Preisbedingungen: [x, y, z]. |
| INCOMPATIBLE\_RATE\_CARD\_CONSTRAINTS | Legen Sie für das Nutzungspreismodell die Option MultipleDimensionSelection und auf Zulässig fest. QuantityConfiguration ConfigurableUpfrontPricingTerm |
| INCOMPATIBLE\_RATE\_CARD\_CONSTRAINTS | Legen Sie im Preismodell für die Nutzung den Wert MultipleDimensionSelection und auf Nicht zulässig fest. QuantityConfiguration ConfigurableUpfrontPricingTerm |
| INCOMPATIBLE\_RATE\_CARD\_CONSTRAINTS | QuantityConfiguration Ihre E-Mail-Adresse ConfigurableUpfrontPricingTerm kann nach der Veröffentlichung des Angebots nicht mehr geändert werden. |
| INCOMPATIBLE\_RATE\_CARD\_CONSTRAINTS | MultipleDimensionSelection Ihre E-Mail-Adresse ConfigurableUpfrontPricingTerm kann nach der Veröffentlichung des Angebots nicht mehr geändert werden. |
| INCOMPATIBLE\_RATES | Setzen Sie alle Gebührenbeträge und Preise auf Null (0), wenn Sie das kostenlose Preismodell verwenden. |
| INCOMPATIBLE\_RATES | Für ein kostenloses Testangebot UsageBasedPricingTerm für das Produkt sind nur Preise von Null (0) zulässig. |
| INCOMPATIBLE\_RESALE\_AUTHORIZATION | Geben Sie dasselbe ein, das in der angegeben ist. CurrencyCode ResaleAuthorization |
| INCOMPATIBLE\_RESALE\_AUTHORIZATION | Stellen Sie sicher, dass die Dauer der Übereinstimmung mit der in der angegebenen Dauer angegeben ist. FixedUpfrontPricingTerm ResaleAuthorization |
| INCOMPATIBLE\_RESALE\_AUTHORIZATION | Geben Sie Begriffe an, 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 |
| INCOMPATIBLE\_SELLER\_VERIFICATION | Schließen Sie alle erforderlichen Prozesse zur Verkäuferverifizierung ab. |
| INKOMPATIBLE\_TERMS | [x] wird zusammen mit den folgenden Begriffen nicht unterstützt: [y, z]. |
| INKOMPATIBLE\_TERMS | Die folgenden Begriffe können nach Veröffentlichung des Angebots nicht mehr hinzugefügt werden: [x, y, z]. |
| INKOMPATIBLE\_TERMS | Die folgenden Bedingungen können nach Veröffentlichung des Angebots nicht mehr entfernt werden: [x, y, z]. |
| INKOMPATIBLE\_TERMS | [x] wird für private Angebote nicht unterstützt. |
| INKOMPATIBLE\_TERMS | Die folgenden Begriffe werden nicht unterstützt FreeTrialPricingTerm , wenn eine unbegrenzte Nutzung gewährt wird: [x, y, z]. |
| INKOMPATIBLE\_TERMS | Die folgenden Begriffe werden FreeTrialPricingTerm für das Produkt nicht unterstützt: [x, y, z]. |
| INKOMPATIBLE\_TERMS | Geben Sie einen Preis von Null (0) an, FixedUpfrontPricingTerm wenn das Angebot eine enthält. PaymentScheduleTerm |
| INKOMPATIBLE\_TERMS | Die folgenden Begriffe sind nicht kompatibel mit PricingModel: [x, y, z]. |
| INKOMPATIBLE\_TERMS | FixedUpfrontPricingTerm wird nicht unterstützt, wenn es größer als Null (0) MarkupPercentage ist. |
| INKOMPATIBLE\_TERMS | Die angeforderte Änderung kann nach Veröffentlichung des Angebots nicht durchgeführt werden. |
| INKOMPATIBLE\_TERMS | Die angeforderte Änderung kann nicht durchgeführt werden, nachdem das Angebot abgelaufen ist. |
| INVALID\_AGREEMENT\_DURATION | Geben Sie eine Dauer zwischen [x] und [y] Monaten an. |
| INVALID\_AGREEMENT\_DURATION | Stellen Sie sicher, dass die Granularität der Dauer für gemessene Dimensionen auf Tagesebene liegt. |
| UNGÜLTIGER\_WÄHRUNGSCODE | Geben Sie eine unterstützte 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. |
| INVALID\_DURATION | Geben Sie eine Dauer ein 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 Grants in ein. FreeTrialPricingTerm |
| INVALID\_GRANTS | Stellen Sie Zuschüsse für alle verfügbaren gemessenen Dimensionen in bereit. FreeTrialPricingTerm |
| INVALID\_PRICE\_CHANGE | [x] kann erst nach [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. |
| INVALID\_PRICE\_CHANGE | Preiserhöhungen und das Hinzufügen von Dimensionen in [x] werden in derselben Anfrage nicht unterstützt. Fügen Sie zuerst Dimensionen hinzu. |
| INVALID\_PRICE\_CHANGE | Preiserhöhung und -senkung von werden in derselben Anfrage UsageBasedPricingTerm nicht unterstützt. Senken Sie zuerst die Preise. |
| INVALID\_PRICE\_CHANGE | Preiserhöhung RecurringPaymentTerm und Preissenkung von werden in UsageBasedPricingTerm derselben Anfrage nicht unterstützt. Senken Sie zuerst die Preise. |
| INVALID\_PRICE\_CHANGE | Preissenkung RecurringPaymentTerm und Preiserhöhung von werden in UsageBasedPricingTerm derselben Anfrage nicht unterstützt. Senken Sie zuerst die Preise. |
| INVALID\_RATE\_CARD | ConfigurableUpfrontPricingTerm für die Dauer [x] fehlen ein oder mehrere Dimensionsschlüssel. Geben Sie für alle Zeiträume Preise für denselben Satz von Dimensionsschlüsseln an. |
| INVALID\_RATE\_CARD | Stellen Sie eine Preisliste bereit, die nur für gemessene Abmessungen gilt. UsageBasedPricingTerm |
| INVALID\_RATE\_CARD | Tarife können nicht aus [x] entfernt werden. Geben Sie die Preise für alle Dimensionen in der vorhandenen Preisliste an. |
| INVALID\_RATE\_CARD | Geben Sie Abmessungen mit derselben Einheit in [x] an. |
| INVALID\_RATE\_CARD | Geben Sie entweder alle gemessenen oder alle angegebenen Abmessungen in [x] ein. |
| INVALID\_RATE\_CARD | Geben Sie in [x] nur die angegebenen Abmessungen an. |
| INVALID\_RATE\_CARD | Geben Sie nutzungsabhängige Tarife für alle verfügbaren gemessenen Abmessungen in an. UsageBasedPricingTerm |
| INVALID\_RATE\_CARD | Bieten Sie nutzungsabhängige Tarife für alle kostenlosen Testversionen an. |
| INVALID\_RATE\_CARD | Geben Sie Preise mit bis zu 8 Dezimalstellen an. UsageBasedPricingTerm |
| INVALID\_SELECTOR\_DURATION\_VALUE | Geben Sie eine Dauer zwischen [x] und [y] Monaten an. |
| INVALID\_SELECTOR\_DURATION\_VALUE | Stellen Sie sicher, dass die Granularität der Dauer für gemessene Dimensionen auf Tagesebene liegt. |
| INVALID\_SELECTOR\_DURATION\_VALUE | Stellen Sie sicher, dass Duration in innerhalb des zulässigen Bereichs liegt. ConfigurableUpfrontPricingTerm |
| INVALID\_SELECTOR\_DURATION\_VALUE | Geben Sie eine oder mehrere unterstützte Vertragslaufzeiten an. |
| INVALID\_SELECTOR\_DURATION\_VALUE | Geben Sie eine oder mehrere unterstützte Vertragsdauern oder eine einzelne benutzerdefinierte Laufzeit an. |
| INVALID\_SELECTOR\_DURATION\_VALUE | Geben Sie eine Dauer ein, die der Dauer zwischen und entspricht. ConfigurableUpfrontPricingTerm AgreementStartDate AgreementEndDate |
| MISSING\_DURATION | Geben Sie Dauer in ein. FixedUpfrontPricingTerm |
| FEHLENDE VERBINDLICHE BEDINGUNGEN | FixedUpfrontPricingTerm wird nur unterstützt, wenn es mit oder kombiniert wird. ByolPricingTerm PaymentScheduleTerm |
| MISSING\_MANDATORY\_TERMS | Geben Sie mindestens eines von [x, y, z] an. |
| FEHLENDE VERBINDLICHE BEGRIFFE | Geben Sie eine an, wenn Sie das ByolPricingTerm Byol-Preismodell verwenden. |
| TOO\_MANY\_GRANTS | Stellen Sie bis zu [x] Zuschüsse in [y] bereit. |
| ZU VIELE GÜNSTIGE KARTEN | Für das Produkt ist nur eine Preiskarte zulässig. ConfigurableUpfrontPricingTerm |
| ZU VIELE PREISKARTEN | Für das Produkt sind Karten mit einem Tarif von bis zu [x] zulässig. ConfigurableUpfrontPricingTerm |
| ZU VIELE TARIFE | Geben Sie RateCards innerhalb der zulässigen Grenzen in an. ConfigurableUpfrontPricingTerm |
| ZU VIELE TARIFE | Geben Sie RateCards innerhalb der zulässigen Grenzen in an. UsageBasedPricingTerm |
## Details zum Zahlungsplan aktualisieren
Sie können die Katalog-API verwenden, um die Details des Zahlungsplans, z. B. den flexiblen Zahlungsplan, in zu ändern AWS Marketplace.
Wenn der Hersteller im Rahmen der Resale Authorization einen Zahlungsplan angegeben hat, kann der Vertriebspartner entweder:
+ Verwenden Sie die Art der `UpdateMarkup` Änderung, um allen Zahlungsplänen einen einheitlichen prozentualen Aufschlag zuzuweisen.
+ Verwenden Sie die `UpdatePaymentScheduleTerms` Änderungsart, um benutzerdefinierte Zahlungsbeträge auf einen Wert festzulegen, der größer oder gleich dem Wert ist, der in der Wiederverkaufsgenehmigung angegeben ist. Zahlungsdaten können nicht geändert werden. Beide Optionen können nicht gleichzeitig angewendet werden. Wenn zuerst ein Aufschlag angewendet wird und Sie ihn ändern müssen, um einen Zahlungsplan anzuwenden, legen Sie den Aufschlag auf `0` Durchgehend über den `UpdateMarkup` Änderungstyp fest. Wenn zuerst ein Zahlungsplan angewendet wird, können Sie die Änderung nicht rückgängig machen, um den Aufschlag anzuwenden.
Um die zahlungsbezogenen Details für Ihr Angebot zu aktualisieren, rufen Sie den `StartChangeSet` API-Vorgang mit dem `UpdatePaymentScheduleTerms` Änderungstyp 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 an, um den `UpdatePaymentScheduleTerms` Änderungstyp hinzuzufügen:
+ **Entität** (Objekt) (erforderlich) — Ihr CPPO.
+ **Typ** (Zeichenfolge) (erforderlich) — Das `Type` ist immer`Offer@1.0`.
+ **Kennung** (Zeichenfolge) (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** (Anordnung von Strukturen) — Liste der Zahlungsbedingungen, die Sie aktualisieren möchten. Folgende Zahlungsbedingungen werden unterstützt:
+ **PaymentScheduleTerm**(Objekt) — Definiert ein Ratenzahlungsmodell, bei dem Kunden während der Gültigkeitsdauer des Vertrags an unterschiedlichen Tagen ein Festpreis berechnet wird.
+ **Typ** (Zeichenfolge) — Typ des Begriffs, der 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 und des Datums, an dem der Kunde die Zahlung erhalten würde, erforderlich sind.
+ **ChargeDate**(Zeichenfolge) — Das Datum, an dem der Kunde den in diesem Zahlungsplan festgelegten Preis zahlen würde. `ChargeDate`wird im YYYY-MM-DD Format dargestellt. Rechnungen werden an dem angegebenen Datum generiert.
+ **ChargeAmount**(Zeichenfolge) — Der Preis, den der Kunde am geplanten Datum zahlen würde (`ChargeDate`).
**Syntax der Antwort**
Für Ihre Anfrage wird ein Änderungssatz erstellt. Die Antwort auf diese Anfrage gibt Ihnen das `ChangeSetId` und `ChangeSetArn` für den Änderungssatz und sieht wie folgt aus.
```
{
"ChangeSetId": "example123456789012abcdef",
"ChangeSetArn": "arn:aws:aws-marketplace:us-east-1:123456789012:AWSMarketplace/ChangeSet/example123456789012abcdef"
}
```
Die Änderungsanforderung wird einer Warteschlange hinzugefügt und verarbeitet. Dazu gehört auch die Überprüfung der Informationen, um sicherzustellen, dass sie den AWS Marketplace Richtlinien entsprechen. Der Validierungsprozess kann zwischen einigen Minuten und einigen Stunden dauern.
Sie können den Status der Anfrage über die 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 aufrufen. `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 zulässig
Die Listengröße muss kleiner als 2 sein | 422 |
| Bedingungen []. PaymentScheduleTerm.CurrencyCode | Erforderlich
Unterstützte Währungen: ["USD“, „AUD“, „EUR“, „GBP“, „JPN"] | 422 |
| Bedingungen []. PaymentScheduleTerm.Schedule[] | Erforderlich
Die Listengröße muss zwischen 1 und 60 (einschließlich) liegen | 422 |
| Bedingungen []. PaymentScheduleTerm.Schedule[]. ChargeDate | Erforderlich
Format: "YYYY-MM-DD“ | 422 |
| Bedingungen []. PaymentScheduleTerm.Schedule[]. ChargeAmount | ErforderlichDer Datentyp ist „Zeichenfolge“
Non-negativeDezimalzahlen mit bis zu 2 Dezimalstellen werden unterstützt
Zusätzliche Eigenschaften sind nicht zulässig | 422 |
**Asynchrone Fehler**
Die folgenden Fehler beziehen sich spezifisch auf `UpdatePaymentScheduleTerms` Aktionen in. AWS Marketplace Catalog API Diese Fehler werden zurückgegeben, wenn Sie aufrufen, `DescribeChangeSet` nachdem ein Änderungssatz verarbeitet wurde. Weitere Hinweise zur Verwendung `DescribeChangeSet` zum Abrufen des Status einer Änderungsanforderung finden Sie unter[Mit Änderungssätzen arbeiten](catalog-apis.md#working-with-change-sets).
| Fehlercode | Fehlermeldung |
| --- | --- |
| DUPLICATE\_CHARGE\_DATES | Geben Sie eindeutige Ladedaten in an. PaymentScheduleTerm |
| INCOMPATIBLE\_MARKUP\_PERCENTAGE | PaymentScheduleTerm wird nicht unterstützt, wenn es größer als Null (0) MarkupPercentage ist. |
| INCOMPATIBLE\_RESALE\_AUTHORIZATION | Geben Sie Begriffe an, die mit dem kompatibel sind. ResaleAuthorization Inkompatible Begriffe: [PaymentScheduleTerm]. |
| INCOMPATIBLE\_RESALE\_AUTHORIZATION | Stellen Sie sicher, dass der Gesamtwert mit dem kompatibel ist. ChargeAmounts PaymentScheduleTerm ResaleAuthorization |
| INCOMPATIBLE\_RESALE\_AUTHORIZATION | Stellen Sie sicher, dass die Ladedaten in PaymentScheduleTerm mit den Ladedaten in übereinstimmen. ResaleAuthorization |
| INCOMPATIBLE\_RESALE\_AUTHORIZATION | Stellen Sie sicher, dass der Gebührenbetrag in größer oder gleich dem für dieses Datum angegebenen Gebührenbetrag PaymentScheduleTerm ist. ResaleAuthorization |
| INKOMPATIBLE\_TERMS | Die angeforderte Änderung kann nach Veröffentlichung des Angebots nicht durchgeführt werden. |
| INKOMPATIBLE\_TERMS | Die angeforderte Änderung kann nicht durchgeführt werden, nachdem das Angebot abgelaufen ist. |
| INKOMPATIBLE\_TERMS | Verwenden Sie entweder UpdatePaymentScheduleTerms mit einem bestimmten Zahlungsbetrag oder UpdateMarkup mit einem einzigen Aufschlagsprozentsatz für die geplanten Termine. |
| INVALID\_CHARGE\_DATES | Geben Sie vorher die Abbuchungsdaten an. AgreementEndDate |
| ZU VIELE\_ZURÜCKDATIERTE\_GEBÜHREN | Stellen Sie vorher bis zu 1 planmäßige Zahlung bereit. AvailabilityEndDate |
| Fehlercode | Fehlermeldung |
| --- | --- |
| DUPLICATE\_CHARGE\_DATES | Geben Sie eindeutige Ladedaten in an. PaymentScheduleTerm |
| INKOMPATIBLE\_CURRENCY\_CODE | CurrencyCode kann nach Veröffentlichung des Angebots nicht mehr geändert werden. |
| INCOMPATIBLE\_MARKUP\_PERCENTAGE | PaymentScheduleTerm wird nicht unterstützt, wenn es größer als Null (0) MarkupPercentage ist. |
| INKOMPATIBLE\_PAYMENT\_SETTINGS | Aktualisieren Sie Ihre Zahlungseinstellungen, damit sie mit dem kompatibel sind. CurrencyCode |
| INCOMPATIBLE\_RESALE\_AUTHORIZATION | Geben Sie Begriffe an, die mit dem kompatibel sind. ResaleAuthorization Inkompatible Begriffe: [PaymentScheduleTerm]. |
| INCOMPATIBLE\_RESALE\_AUTHORIZATION | Stellen Sie sicher, dass der Gesamtwert mit dem kompatibel ist. ChargeAmounts PaymentScheduleTerm ResaleAuthorization |
| INCOMPATIBLE\_SELLER\_VERIFICATION | Schließen Sie alle erforderlichen Prozesse zur Verkäuferverifizierung ab. |
| INKOMPATIBLE\_TERMS | Die angeforderte Änderung kann nach Veröffentlichung des Angebots nicht durchgeführt werden. |
| INKOMPATIBLE\_TERMS | Die angeforderte Änderung kann nicht durchgeführt werden, nachdem das Angebot abgelaufen ist. |
| INVALID\_CHARGE\_DATES | Geben Sie vorher die Abbuchungsdaten an. AgreementEndDate |
| UNGÜLTIGER\_WÄHRUNGSCODE | Geben Sie eine unterstützte an. CurrencyCode |
| UNGÜLTIGER\_WÄHRUNGSCODE | Geben Sie für alle Preis- und CurrencyCode Zahlungsbedingungen dasselbe an. |
| ZU VIELE VERALTETE GEBÜHREN | Stellen Sie vorher bis zu 1 planmäßige Zahlung bereit. AvailabilityEndDate |
## Veröffentlichen Sie das CPPO
Sie können die Katalog-API verwenden, um die aus allen Arten von Aktualisierungen gesammelten Informationen zusammenzuführen und das Angebot anschließend in AWS Marketplace zu veröffentlichen.
Angebote behalten ihren `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 an, um den `ReleaseOffer` Änderungstyp hinzuzufügen:
+ **Entität** (Objekt) (erforderlich) — Ihr CPPO.
+ **Typ** (Zeichenfolge) (erforderlich) — Das `Type` ist immer`Offer@1.0`.
+ **Kennung** (Zeichenfolge) (erforderlich) — Ihre Angebots-ID. Weitere Informationen finden Sie unter [Kennung](catalog-apis.md#identifier).
+ **DetailsDocument**(Objekt) (erforderlich) — Der JSON-Wert der Einzelheiten der Anfrage. Er 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 der Informationen, um sicherzustellen, dass sie den AWS Marketplace Richtlinien entsprechen. Der Validierungsprozess kann zwischen einigen Minuten und einigen Stunden dauern.
Sie können den Status der Anfrage über die AWS Marketplace Management Portal oder 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 aufrufen. `StartChangeSet` Wenn die Anfrage die folgenden Anforderungen nicht erfüllt, schlägt sie mit einer HTTP-Antwort fehl.
| Eingabefeld | Validierungsregel |
| --- | --- |
| Details | Muss leer sein ({}) |
**Asynchrone Fehler**
Die folgenden Fehler beziehen sich spezifisch auf `ReleaseOffer` Aktionen in. AWS Marketplace Catalog API Diese Fehler werden zurückgegeben, wenn Sie aufrufen, `DescribeChangeSet` nachdem ein Änderungssatz verarbeitet wurde. Weitere Hinweise zur Verwendung `DescribeChangeSet` zum Abrufen des Status einer Änderungsanforderung finden Sie unter[Mit Änderungssätzen arbeiten](catalog-apis.md#working-with-change-sets).
| Fehlercode | Fehlermeldung |
| --- | --- |
| INCOMPATIBLE\_PAYMENT\_SETTINGS | Aktualisieren Sie Ihre Zahlungseinstellungen, damit sie mit dem kompatibel sind. CurrencyCode |
| INKOMPATIBLE\_PRODUKT | Erstellen Sie zunächst ein öffentliches Angebot für das Produkt. |
| INCOMPATIBLE\_SELLER\_VERIFICATION | Schließen Sie alle erforderlichen Prozesse zur Verkäuferverifizierung ab. |
| INVALID\_UPDATE\_REQUEST | Die angeforderte Änderung kann nicht durchgeführt werden, nachdem das Angebot veröffentlicht wurde. |
| MISSING\_AGREEMENT\_END\_DATE | Stellen Sie ein Formular für Ersatzangebote bereit. AgreementEndDate |
| FEHLENDES VERFÜGBARKEITSENDDATUM | Stellen Sie ein privates Angebot bereit. AvailabilityEndDate |
| FEHLENDE\_VERBINDLICHE\_BEDINGUNGEN | Geben Sie a an, wenn das Angebot eine enthält FixedUpfrontPricingTerm . PaymentScheduleTerm |
| FEHLENDES\_KÄUFERKONTO | Geben Sie für Angebote an, die mit erstellt wurden PositiveTargeting . BuyersAccounts ResaleAuthorization |
| MISSING\_BUYER\_ACCOUNTS | Alle Angebote für das Produkt müssen privat sein. Bereitstellen PositiveTargeting mit BuyersAccounts. |
| FEHLENDES\_BESCHREIBUNG | Lege die Beschreibung fest, bevor du das Angebot veröffentlichst. |
| 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 den Namen fest, bevor Sie das Angebot veröffentlichen. |
| ZU VIELE\_ANGEBOTE | Pro Produkt kann nur ein öffentliches Angebot erstellt werden. |
| ZU VIELE\_ANGEBOTE | Pro Produkt kann nur ein öffentliches kostenloses Testangebot erstellt werden. |
## Definieren Sie ein vorhandenes CPPO
Sie können die Katalog-API verwenden, um CPPO-Details in zu definieren. AWS Marketplace
Um ein vorhandenes CPPO zu definieren, 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 an, 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-a5oEXAMPLEzpu@1",
"EntityArn": "arn:aws:aws-marketplace:us-east-1:446235747164:AWSMarketplace/Offer/offer-a5oEXAMPLEzpu",
"LastModifiedDate": "2021-03-10T21:57:16Z",
"Details": {
"Id": "offer-3rEXAMPLErn",
"State": "Released",
"Name": "Test Offer",
"Description": "Worldwide private offer for Test Product",
"PreExistingAgreement": {
"AcquisitionChannel": "External",
"PricingModel": "Contract"
},
"ProductId": "prod-0bEXAMPLEb51",
"ResaleAuthorizationId": "resaleauthz-123456789",
"MarkupPercentage": "5.0",
"Terms": [
{
"Type": "LegalTerm",
"Documents": [
{
"Type": "CustomEula",
"Url": "https://s3.amazonaws.com/EULA/custom-eula-1234.txt"
}
]
},
{
"Type": "ConfigurableUpfrontPricingTerm",
"CurrencyCode": "USD",
"RateCards": [
{
"Selector": {
"Type": "Duration",
"Value": "P12M"
},
"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": "PaymentScheduleTerm",
"CurrencyCode": "USD",
"Schedule": [
{
"ChargeDate": "2020-12-01T00:00:00Z",
"ChargeAmount": "1000.00"
},
{
"ChargeDate": "2021-06-15T00:00:00Z",
"ChargeAmount": "1250.00"
}
]
}
],
"Rules": [
{
"Type": "TargetingRule",
"PositiveTargeting": {
"CountryCodes": [
"US",
"CA"
],
"BuyerAccounts": [
"118033953248"
]
},
"NegativeTargeting": {
"CountryCodes": [
"XX"
]
}
},
{
"Type": "AvailabilityRule",
"AvailabilityEndDate": "2050-08-30T01:56:03Z"
}
]
}
}
```
Geben Sie Informationen für die Eingabefelder für die `DescribeEntity` Antwort an:
+ **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) — Der ARN, der dem eindeutigen Bezeichner für den in dieser Anfrage referenzierten Änderungssatz zugeordnet ist.
+ **LastModifiedDate**(string) — Das Datum der letzten Änderung der Entität im ISO 8601-Format (`2018-02-27T13:45:22Z`).
+ **DetailsDocument**(Objekt) — Das JSON-Objekt enthält die Details der Entität.
+ **Id** (Zeichenfolge) — Eindeutiger Bezeichner für eine Angebotsentität in AWS Marketplace und wird bei der Erstellung eines Angebots generiert.
+ **State** (Zeichenfolge) — Der Status des Angebots.
+ **Name** (Zeichenfolge) — Name, der dem Angebot zugeordnet ist, damit es für Sie und Ihre Kunden besser lesbar ist. Er wird auch als Teil der Vertragsinformationen angezeigt.
+ **Beschreibung** (Zeichenfolge) — Die Beschreibung ist ein frei formatierter Text, der nur von Ihnen verwendet werden darf und niemals Käufern zugänglich gemacht wird.
+ **PreExistingAgreement**(Zeichenfolge) — Stellt fest, ob es sich bei diesem Angebot um eine Verlängerung einer bestehenden Vereinbarung mit einem Bestandskunden für dasselbe zugrunde liegende Produkt handelt. Die bestehende Vereinbarung kann intern oder extern 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 es Ihrem Kunden das Angebot und die damit verbundenen Rechte entziehen.
+ **AcquisitionChannel**(Zeichenfolge) — Gibt an, ob die bestehende Vereinbarung von außen AWS Marketplace oder von innen 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 Beschreibung ist ein frei formatierter Text, der nur von Ihnen verwendet werden darf und niemals Käufern zugänglich gemacht wird.
+ **ResaleAuthorizationId**(string) — ResaleAuthorization wird verwendet, um das private Angebot zu erstellen.
+ **MarkupPercentage**(string) — Prozentualer Wert, den der Channel-Partner beim `UpdateMarkup` Änderungstyp übergeben hat. Dieses Markup wurde bereits auf die Bedingungen angewendet.
+ **Begriffe** (Anordnung von Strukturen) — Liste von Begriffen.
+ **Regeln** (Anordnung von Strukturen) — Liste von Regeln.