CPPO-Voraussetzungen Erstellen Sie ein CPPO Erstellen Sie ein privates Ersatzangebot für Vertriebspartner Markup aktualisieren Targeting-Konfiguration aktualisieren Rechtliche Ressourcen aktualisieren Aktualisieren Sie die Auffindbarkeit des CPPO Definieren Sie das Ablaufdatum von Vereinbarungen Preise aktualisieren Details zum Zahlungsplan aktualisieren Veröffentlichen Sie das CPPO Definieren Sie ein vorhandenes CPPO

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.

In den folgenden Themen wird beschrieben, wie Sie die Katalog-API verwenden, um CPPOs zu erstellen und zu aktualisieren:

Topics

CPPO-Voraussetzungen
Erstellen Sie ein CPPO
Erstellen Sie ein privates Ersatzangebot für Vertriebspartner
Markup aktualisieren
Targeting-Konfiguration aktualisieren
Rechtliche Ressourcen aktualisieren
Aktualisieren Sie die Auffindbarkeit des CPPO
Definieren Sie das Ablaufdatum von Vereinbarungen
Preise aktualisieren
Details zum Zahlungsplan aktualisieren
Veröffentlichen Sie das CPPO
Definieren Sie ein vorhandenes 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 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 einsehenDescribeEntity, 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 immerOffer@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, 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 API-Vorgangs überprüfen.

Die Antwort auf diese Anfrage gibt Ihnen den Status der Anfrage. Wenn der Status lautetSUCCEEDED, 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 DescribeChangeSet.

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 UpdateLegalTerms.
PricingTerms— Alle vom Hersteller in der beschriebenen Preisbedingungen (ConfigurableUpfrontPricingTermFixedUpfrontPricingTermUsageBasedPricingTerm,,,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 UpdateMarkup 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 verwendenUpdatePaymentScheduleTerms. Weitere Informationen finden Sie unter UpdatePaymentScheduleTerms.
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 UpdateTargeting.


{
  "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 unterMit Änderungssätzen arbeiten.

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.

CreateReplacementOfferUsingResaleAuthorizationerstellt 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 immerOffer@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.
  
  ResaleAuthorizationmuss 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 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 unterMit Änderungssätzen arbeiten.

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 immerOffer@1.0.
- Kennung (Zeichenfolge) (erforderlich) — Ihre Angebots-ID. Weitere Informationen finden Sie unter Kennung.
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"
}

Sie können den Status der Anfrage über die AWS Marketplace Management Portal oder direkt über die Catalog API mithilfe der DescribeChangeSet 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

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 unterMit Änderungssätzen arbeiten.

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ähnenResaleAuthorization. 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 immerOffer@1.0.
- Kennung (Zeichenfolge) (erforderlich) — Ihre Angebots-ID. Weitere Informationen finden Sie unter Kennung.
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 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 unterMit Änderungssätzen arbeiten.

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 einsehenDescribeEntity.

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 immerOffer@1.0.
- Kennung (Zeichenfolge) (erforderlich) — Ihre Angebots-ID. Weitere Informationen finden Sie unter Kennung.
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. TypeErforderlich, 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 istStandardEula. 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

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: CustomEula StandardEula	422
Bedingungen []. LegalTerm.Documents[] .URL	Erforderlich und muss eine gültige URL sein, wenn „Type“ einer von CustomEula	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 unterMit Änderungssätzen arbeiten.

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 immerOffer@1.0.
- Kennung (Zeichenfolge) (erforderlich) — Ihre Angebots-ID. Weitere Informationen finden Sie unter Kennung.
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"
}

Sie können den Status der Anfrage über die AWS Marketplace Management Portal oder direkt über die Catalog API mithilfe der DescribeChangeSet 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

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 unterMit Änderungssätzen arbeiten.

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 immerOffer@1.0.
- Kennung (Zeichenfolge) (erforderlich) — Ihre Angebots-ID. Weitere Informationen finden Sie unter Kennung.
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. AgreementStartDatewird 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"
}

Sie können den Status der Anfrage über die AWS Marketplace Management Portal oder direkt über die Catalog API mithilfe der DescribeChangeSet 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 unterMit Änderungssätzen arbeiten.

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 verwendenFixedUpFrontPricingTerm.

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 immerOffer@1.0.
- Kennung (Zeichenfolge) (erforderlich) — Ihre Angebots-ID. Weitere Informationen finden Sie unter Kennung.
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"
}

Sie können den Status der Anfrage über die AWS Marketplace Management Portal oder direkt über die Catalog API mithilfe der DescribeChangeSet 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 unterMit Änderungssätzen arbeiten.

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 immerOffer@1.0.
- Kennung (Zeichenfolge) (erforderlich) — Ihre Angebots-ID. Weitere Informationen finden Sie unter Kennung.
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. ChargeDatewird 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"
}

Sie können den Status der Anfrage über die AWS Marketplace Management Portal oder direkt über die Catalog API mithilfe der DescribeChangeSet 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	Erforderlich Der 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 unterMit Änderungssätzen arbeiten.

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 immerOffer@1.0.
- Kennung (Zeichenfolge) (erforderlich) — Ihre Angebots-ID. Weitere Informationen finden Sie unter Kennung.
DetailsDocument(Objekt) (erforderlich) — Der JSON-Wert der Einzelheiten der Anfrage. Er muss leer sein fürReleaseOffer.

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"
}

Sie können den Status der Anfrage über die AWS Marketplace Management Portal oder direkt über die Catalog API mithilfe der DescribeChangeSet 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 unterMit Änderungssätzen arbeiten.

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=<Catalog>&entityId=<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ämlichOffer@1.0.
EntityIdentifier(string) — Der Bezeichner der Entität im Format vonEntityId@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.

Dokumentkonventionen

Arbeiten Sie mit Wiederverkaufsberechtigungen

Arbeiten Sie mit Verlängerungen