Die AWS Marketplace-API-Referenz wurde umstrukturiert. Weitere Informationen zu den unterstützten API-Vorgängen finden Sie in der AWS Marketplace-API-Referenz.

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 Vertriebspartnern mithilfe der AWS Marketplace APIs

Sie können die verwenden AWS Marketplace Catalog API , um Aufgaben für die Arbeit mit privaten Angeboten (CPPOs) von Vertriebspartnern zu automatisieren.

Wenn Sie ein CPPO erstellen oder aktualisieren, enthält der Angebotsentwurf die Bedingungen und Regeln einer Wiederverkaufsgenehmigung und ist für den Käufer unsichtbar. Es ist möglich, aber nicht erforderlich, mehrere Personen in Ihrem Unternehmen einzubeziehen, um ein privates Angebot zu erstellen.

Beispielsweise kann eine Persona 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 Bedingungen verantwortlich sein. Du kannst einer Persona die Erlaubnis geben, bestimmte Teile eines Angebots zu aktualisieren. Sie können Wiederverkaufsberechtigungen jedoch nur Leseberechtigungen erteilen.

Als Voraussetzung für das Aufrufen von Änderungstypen müssen Sie eine oder mehrere Wiederverkaufsberechtigungen erhalten haben und mit der Arbeit vertraut sein. 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 Catalog API verwenden, um CPPOs zu erstellen und zu aktualisieren:

CPPO-Voraussetzungen

Service-linked Die Rolle für das ResaleAuthorization (SLR) -Setup ist eine obligatorische Voraussetzung, um mithilfe der Wiederverkaufsautorisierung ein CPPO zu erstellen. Um die Wiederverkaufsautorisierung verwenden zu können, müssen sowohl unabhängige Softwareanbieter (ISVs) als auch AWS Marketplace Vertriebspartner eine serviceverknüpfte 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 vom ISV nicht mit dem Vertriebspartner teilen. AWS Marketplace Weitere Informationen finden Sie im AWS Marketplace Verkäuferleitfaden unter Verwenden von Rollen für die Wiederverkaufsautorisierung. AWS Marketplace

Erstellen Sie ein CPPO

Sie verwenden eine speziell auf Sie zugeschnittene Wiederverkaufsgenehmigung, um ein privates Angebot (CPPO) für Vertriebspartner im Draft Bundesstaat zu erstellen. AWS Marketplace

Wenn Ihre Anfrage erfolgreich bearbeitet wurde, wird für Sie ein AWS Marketplace Catalog API aktuelles Angebot mit den Draft Bedingungen der Wiederverkaufsautorisierung generiert. In der DescribeEntity Wiederverkaufsgenehmigung können Sie die Bedingungen einsehen, die auf den Angebotsentwurf angewendet wurden. Dies ist ein unvollständiges Angebot und für Käufer nicht sichtbar. AWS Marketplace Anschließend verwenden Sie die dem CPPO zugewiesenen Ä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 freizugeben. Dadurch wird das gesamte Angebot validiert und Ihr Angebot wird für Käufer 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 ein, um den CreateOfferUsingResaleAuthorization Änderungstyp hinzuzufügen:

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 Catalog 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 ein neuer 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 AWS Marketplace Catalog API anhand ResaleAuthorization der Referenz erstellt wurde. Weitere Informationen finden Sie unter DescribeChangeSet.

Bedingungen und Regeln von ResaleAuthorization

{
  "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 anrufen. StartChangeSet Wenn die Anfrage die folgenden Anforderungen nicht erfüllt, schlägt sie mit einer HTTP-Antwort fehl.

Asynchrone Fehler

Die folgenden Fehler beziehen sich spezifisch auf CreateOfferUsingResaleAuthorization Aktionen in der. AWS Marketplace Catalog API Diese Fehler werden zurückgegeben, wenn Sie DescribeChangeSet nach der Verarbeitung eines Änderungssatzes aufrufen. Weitere Hinweise zur VerwendungDescribeChangeSet, um den Status einer Änderungsanforderung abzurufen, finden Sie unterMit Änderungssätzen arbeiten.

Erstellen Sie ein privates Ersatzangebot für Vertriebspartner

Sie können die Catalog API verwenden, um ein privates Ersatzangebot für Vertriebspartner in zu erstellen AWS Marketplace.

Sie verwenden das auf Sie ResaleAuthorization zugeschnittene Angebot und eine Vereinbarung, deren Anbieter Sie sind, um ein privates Ersatzangebot für Vertriebspartner zu erstellen, das in der Katalog-API Draft angegeben ist, indem Sie den CreateReplacementOfferUsingResaleAuthorization Änderungstyp aufrufenStartChangeSet, wie im folgenden Beispiel gezeigt. Ersatzangebote können verwendet werden, um eine Vereinbarung aus einem früheren Angebot zu ersetzen, bevor dieses endet.

CreateReplacementOfferUsingResaleAuthorizationerstellt einen Angebotsentwurf, bei dem der Vertragspartner im Visier ist. Dieses Targeting kann nachträglich 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 ein, um den CreateReplacementOfferUsingResaleAuthorization Änderungstyp hinzuzufügen:

Syntax der Antwort

Für Ihre Anfrage wird ein Änderungssatz erstellt. Die Antwort auf diese Anfrage gibt Ihnen das ChangeSetId und ChangeSetArn für den Änderungssatz und sieht wie folgt aus.

{
  "ChangeSetId": "example123456789012abcdef",
  "ChangeSetArn": "arn:aws:aws-marketplace:us-east-1:123456789012:AWSMarketplace/ChangeSet/example123456789012abcdef"
}

Die Änderungsanforderung wird einer Warteschlange hinzugefügt und verarbeitet.

Sie können den Status der Anfrage über die AWS Marketplace Management Portal oder direkt über die Catalog API mithilfe der DescribeChangeSet API-Operation ü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 anrufen. StartChangeSet Wenn die Anfrage die folgenden Anforderungen nicht erfüllt, schlägt sie mit einer HTTP-Antwort fehl.

Asynchrone Fehler

Die folgenden Fehler beziehen sich spezifisch auf CreateReplacementOfferUsingResaleAuthorization Aktionen in der. AWS Marketplace Catalog API Diese Fehler werden zurückgegeben, wenn Sie DescribeChangeSet nach der Verarbeitung eines Änderungssatzes aufrufen. Weitere Hinweise zur VerwendungDescribeChangeSet, um den Status einer Änderungsanforderung abzurufen, finden Sie unterMit Änderungssätzen arbeiten.

Markup aktualisieren

Sie können die Katalog-API verwenden, um die Preisbedingungen in Ihrem Angebot um einen Prozentwert zu aktualisieren. AWS Marketplace

Dadurch wird der angegebene prozentuale Aufschlag auf alle Preis- und Zahlungsbedingungen (für zukünftige Zahlungspläne) angewendet, die vom Hersteller in der ResaleAuthorization definiert sind. Jeder vorhandene Aufschlag wird überschrieben. Die aktualisierten 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 ein, um den UpdateMarkup Änderungstyp hinzuzufügen:

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 mit dem Team von AWS Marketplace Seller Operations, um sicherzustellen, dass sie den AWS Marketplace Richtlinien entsprechen. Der Validierungsvorgang 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. UpdateMarkup AWS Marketplace Catalog API Diese Validierungen werden durchgeführt, wenn Sie anrufen. StartChangeSet Wenn die Anfrage die folgenden Anforderungen nicht erfüllt, schlägt sie mit einer HTTP-Antwort fehl.

Asynchrone Fehler

Die folgenden Fehler beziehen sich spezifisch auf UpdateMarkup Aktionen in der. AWS Marketplace Catalog API Diese Fehler werden zurückgegeben, wenn Sie DescribeChangeSet nach der Verarbeitung eines Änderungssatzes aufrufen. Weitere Hinweise zur VerwendungDescribeChangeSet, um den Status einer Änderungsanforderung abzurufen, finden Sie unterMit Änderungssätzen arbeiten.

Targeting-Konfiguration aktualisieren

Sie können die Catalog API verwenden, um die bestehende Targeting-Konfiguration 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, die den UpdateTargeting Änderungstyp verwendenPositiveTargeting, private Angebote unterbreiten.

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 ein, um den UpdateTargeting Änderungstyp hinzuzufügen:

Syntax der Antwort

Für Ihre Anfrage wird ein Änderungssatz erstellt. Die Antwort auf diese Anfrage gibt Ihnen das ChangeSetId und ChangeSetArn für den Änderungssatz und sieht wie folgt aus.

{
  "ChangeSetId": "example123456789012abcdef",
  "ChangeSetArn": "arn:aws:aws-marketplace:us-east-1:123456789012:AWSMarketplace/ChangeSet/example123456789012abcdef"
}

Die Änderungsanforderung wird einer Warteschlange hinzugefügt und verarbeitet. Dazu gehört auch die Überprüfung von Informationen, um sicherzustellen, dass sie den AWS Marketplace Richtlinien entsprechen. Der Validierungsvorgang kann 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 UpdateTargeting Aktionen in der. AWS Marketplace Catalog API Diese Validierungen werden durchgeführt, wenn Sie anrufen. StartChangeSet Wenn die Anfrage die folgenden Anforderungen nicht erfüllt, schlägt sie mit einer HTTP-Antwort fehl.

Asynchrone Fehler

Die folgenden Fehler beziehen sich spezifisch auf UpdateTargeting Aktionen in der. AWS Marketplace Catalog API Diese Fehler werden zurückgegeben, wenn Sie DescribeChangeSet nach der Verarbeitung eines Änderungssatzes aufrufen. Weitere Hinweise zur VerwendungDescribeChangeSet, um den Status einer Änderungsanforderung abzurufen, finden Sie unterMit Änderungssätzen arbeiten.

Rechtliche Ressourcen aktualisieren

Sie können die Katalog-API verwenden, um die rechtlichen Bestimmungen zur Wiederverkaufsgenehmigung zusammenzuführen und die bestehenden rechtlichen Bestimmungen vollständig zu ersetzen. AWS Marketplace

Diese Änderung wirkt sich nicht auf bestehende Vereinbarungen aus. Die rechtlichen Bestimmungen, die nicht in der letzten Anfrage enthalten sind, werden aus dem Angebot entfernt. Sie können die zusammengeführten rechtlichen Bedingungen telefonisch einsehenDescribeEntity.

Um die rechtlichen Bedingungen Ihres Angebots zu aktualisieren, rufen Sie den StartChangeSet API-Vorgang mit dem UpdateLegalTerms Änderungstyp auf, wie im folgenden Beispiel gezeigt.

Anforderungssyntax

POST /StartChangeSet HTTP/1.1
Content-type: application/json

{
  "Catalog": "AWSMarketplace",
  "ChangeSet": [
    {
      "ChangeType": "UpdateLegalTerms",
      "Entity": {
        "Type": "Offer@1.0",
        "Identifier": "offer-123456789"
      },
      "DetailsDocument": {
        "Terms": [
          {
            "Type": "LegalTerm",
            "Documents": [
              {
                "Type": "CustomEula",
                "Url": "https://s3.amazonaws.com/EULA/custom-eula-1234.txt"
              }
            ]
          }
        ]
      }
    }
  ]
}

Geben Sie Informationen für die Felder ein, um den UpdateLegalTerms Änderungstyp hinzuzufügen:

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 mit dem Team von AWS Marketplace Seller Operations, um sicherzustellen, dass sie den AWS Marketplace Richtlinien entsprechen. Der Validierungsvorgang kann zwischen einigen Minuten und einigen Stunden dauern. Sie können den Status der Anfrage über die AWS Marketplace Management Portal oder in der Catalog API mit der DescribeChangeSet Aktion überprüfen.

Synchrone Validierungen

Die folgenden Schemavalidierungen sind spezifisch für Aktionen in der. UpdateLegalTerms AWS Marketplace Catalog API Diese Validierungen werden durchgeführt, wenn Sie anrufen. StartChangeSet Wenn die Anfrage die folgenden Anforderungen nicht erfüllt, schlägt sie mit einer HTTP-Antwort fehl.

Asynchrone Fehler

Die folgenden Fehler beziehen sich spezifisch auf UpdateLegalTerms Aktionen in der. AWS Marketplace Catalog API Diese Fehler werden zurückgegeben, wenn Sie DescribeChangeSet nach der Verarbeitung eines Änderungssatzes aufrufen. Weitere Hinweise zur VerwendungDescribeChangeSet, um den Status einer Änderungsanforderung abzurufen, finden Sie unterMit Änderungssätzen arbeiten.

Aktualisiere die Auffindbarkeit des CPPO

Sie können die Katalog-API verwenden, um die Auffindbarkeit Ihres Angebots in zu verwalten. AWS Marketplace Diese Art der Änderung wirkt sich nicht auf bestehende Vereinbarungen aus.

Sie können entweder ein bestimmtes Datum in der Zukunft festlegen, um die Auffindbarkeit Ihres Angebots einzuschränken, oder in der Vergangenheit, um Ihr Angebot ablaufen zu lassen.

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 ein, um den UpdateAvailability Änderungstyp hinzuzufügen:

Syntax der Antwort

Für Ihre Anfrage wird ein Änderungssatz erstellt. Die Antwort auf diese Anfrage gibt Ihnen das ChangeSetId und ChangeSetArn für den Änderungssatz und sieht wie folgt aus.

{
  "ChangeSetId": "example123456789012abcdef",
  "ChangeSetArn": "arn:aws:aws-marketplace:us-east-1:123456789012:AWSMarketplace/ChangeSet/example123456789012abcdef"
}

Die Änderungsanforderung wird einer Warteschlange hinzugefügt und verarbeitet. Dazu gehört auch die Überprüfung von Informationen, um sicherzustellen, dass sie den AWS Marketplace Richtlinien entsprechen. Der Validierungsvorgang kann zwischen einigen Minuten und einigen Stunden dauern.

Sie können den Status der Anfrage über die oder direkt über die AWS Marketplace Management Portal Catalog API mithilfe des DescribeChangeSet API-Vorgangs überprüfen.

Synchrone Validierungen

Die folgenden Schemavalidierungen sind spezifisch für Aktionen in der. UpdateAvailability AWS Marketplace Catalog API Diese Validierungen werden durchgeführt, wenn Sie anrufen. StartChangeSet Wenn die Anfrage die folgenden Anforderungen nicht erfüllt, schlägt sie mit einer HTTP-Antwort fehl.

Asynchrone Fehler

Die folgenden Fehler beziehen sich spezifisch auf UpdateAvailability Aktionen in der. AWS Marketplace Catalog API Diese Fehler werden zurückgegeben, wenn Sie DescribeChangeSet nach der Verarbeitung eines Änderungssatzes aufrufen. Weitere Hinweise zur VerwendungDescribeChangeSet, um den Status einer Änderungsanforderung abzurufen, finden Sie unterMit Änderungssätzen arbeiten.

Definieren Sie das Ablaufdatum von Vereinbarungen

Sie können die Katalog-API verwenden, um das Ablaufdatum der Vereinbarungen zu definieren, die mithilfe dieses Angebots in erstellt werden AWS Marketplace.

Diese Änderung wirkt sich nicht auf bestehende Vereinbarungen aus. Der Hersteller könnte in einer Wiederverkaufsgenehmigung das maximale Startdatum der Vereinbarung angeben. Vertriebspartner können jedoch kein späteres Startdatum als dieses Datum angeben.

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 ein, um den UpdateValidityTerms Änderungstyp hinzuzufügen:

Syntax der Antwort

Für Ihre Anfrage wird ein Änderungssatz erstellt. Die Antwort auf diese Anfrage gibt Ihnen das ChangeSetId und ChangeSetArn für den Änderungssatz und sieht wie folgt aus.

{
  "ChangeSetId": "example123456789012abcdef",
  "ChangeSetArn": "arn:aws:aws-marketplace:us-east-1:123456789012:AWSMarketplace/ChangeSet/example123456789012abcdef"
}

Die Änderungsanforderung wird einer Warteschlange hinzugefügt und verarbeitet. Dazu gehört auch die Überprüfung von Informationen, um sicherzustellen, dass sie den AWS Marketplace Richtlinien entsprechen. Der Validierungsvorgang kann zwischen einigen Minuten und einigen Stunden dauern.

Sie können den Status der Anfrage über die oder direkt über die AWS Marketplace Management Portal Catalog API mithilfe des DescribeChangeSet API-Vorgangs überprüfen.

Synchrone Validierungen

Die folgenden Schemavalidierungen sind spezifisch für Aktionen in der. UpdateValidityTerms AWS Marketplace Catalog API Diese Validierungen werden durchgeführt, wenn Sie anrufen. StartChangeSet Wenn die Anfrage die folgenden Anforderungen nicht erfüllt, schlägt sie mit einer HTTP-Antwort fehl.

Asynchrone Fehler

Die folgenden Fehler beziehen sich spezifisch auf UpdateValidityTerms Aktionen in der. AWS Marketplace Catalog API Diese Fehler werden zurückgegeben, wenn Sie DescribeChangeSet nach der Verarbeitung eines Änderungssatzes aufrufen. Weitere Hinweise zur VerwendungDescribeChangeSet, um den Status einer Änderungsanforderung abzurufen, finden Sie unterMit Änderungssätzen arbeiten.

Preise aktualisieren

Sie können die Katalog-API verwenden, um die bestehenden Preisbedingungen vollständig zu ersetzen.

Die Preisbedingungen, die nicht in der letzten Anfrage enthalten sind, werden aus dem Angebot entfernt. Vertriebspartner können diese Art der Änderung nur zur Weitergabe 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:

Syntax der Antwort

Für Ihre Anfrage wird ein Änderungssatz erstellt. Die Antwort auf diese Anfrage gibt Ihnen das ChangeSetId und ChangeSetArn für den Änderungssatz und sieht wie folgt aus.

{
  "ChangeSetId": "example123456789012abcdef",
  "ChangeSetArn": "arn:aws:aws-marketplace:us-east-1:123456789012:AWSMarketplace/ChangeSet/example123456789012abcdef"
}

Die Änderungsanforderung wird einer Warteschlange hinzugefügt und verarbeitet. Dazu gehört auch die Überprüfung von Informationen, um sicherzustellen, dass sie den AWS Marketplace Richtlinien entsprechen. Der Validierungsvorgang kann 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. UpdatePricingTerms AWS Marketplace Catalog API Diese Validierungen werden durchgeführt, wenn Sie anrufen. StartChangeSet Wenn die Anfrage die folgenden Anforderungen nicht erfüllt, schlägt sie mit einer HTTP-Antwort fehl.

Asynchrone Fehler

Die folgenden Fehler beziehen sich spezifisch auf UpdatePricingTerms Aktionen in der. AWS Marketplace Catalog API Diese Fehler werden zurückgegeben, wenn Sie DescribeChangeSet nach der Verarbeitung eines Änderungssatzes aufrufen. Weitere Hinweise zur VerwendungDescribeChangeSet, um den Status einer Änderungsanforderung abzurufen, finden Sie unterMit Änderungssätzen arbeiten.

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 in der Wiederverkaufsautorisierung einen Zahlungsplan angegeben hat, kann der Vertriebspartner entweder:

Um die mit der Zahlung verbundenen Details für Ihr Angebot zu aktualisieren, rufen Sie den StartChangeSet API-Vorgang mit der UpdatePaymentScheduleTerms Änderungsart auf, wie im folgenden Beispiel gezeigt.

Anforderungssyntax

POST /StartChangeSet HTTP/1.1
Content-type: application/json

{
  "Catalog": "AWSMarketplace",
  "ChangeSet": [
    {
      "ChangeType": "UpdatePaymentScheduleTerms",
      "Entity": {
        "Type": "Offer@1.0",
        "Identifier": "offer-123456789"
      },
      "DetailsDocument": {
        "Terms": [
          {
            "Type": "PaymentScheduleTerm",
            "Schedule": [
              {
                "ChargeDate": "2021-12-01",
                "ChargeAmount": "200.00"
              },
              {
                "ChargeDate": "2022-03-01",
                "ChargeAmount": "250.00"
              }
            ]
          }
        ]
      }
    }
  ]
}

Geben Sie Informationen für die Felder ein, um den UpdatePaymentScheduleTerms Änderungstyp hinzuzufügen:

Syntax der Antwort

Für Ihre Anfrage wird ein Änderungssatz erstellt. Die Antwort auf diese Anfrage gibt Ihnen das ChangeSetId und ChangeSetArn für den Änderungssatz und sieht wie folgt aus.

{
  "ChangeSetId": "example123456789012abcdef",
  "ChangeSetArn": "arn:aws:aws-marketplace:us-east-1:123456789012:AWSMarketplace/ChangeSet/example123456789012abcdef"
}

Die Änderungsanforderung wird einer Warteschlange hinzugefügt und verarbeitet. Dazu gehört auch die Überprüfung von Informationen, um sicherzustellen, dass sie den AWS Marketplace Richtlinien entsprechen. Der Validierungsvorgang kann zwischen einigen Minuten und einigen Stunden dauern.

Sie können den Status der Anfrage über die oder direkt über die AWS Marketplace Management Portal Catalog API mithilfe des DescribeChangeSet API-Vorgangs überprüfen.

Synchrone Validierungen

Die folgenden Schemavalidierungen sind spezifisch für Aktionen in der. UpdatePaymentScheduleTerms AWS Marketplace Catalog API Diese Validierungen werden durchgeführt, wenn Sie anrufen. StartChangeSet Wenn die Anfrage die folgenden Anforderungen nicht erfüllt, schlägt sie mit einer HTTP-Antwort fehl.

Asynchrone Fehler

Die folgenden Fehler beziehen sich spezifisch auf UpdatePaymentScheduleTerms Aktionen in der. AWS Marketplace Catalog API Diese Fehler werden zurückgegeben, wenn Sie DescribeChangeSet nach der Verarbeitung eines Änderungssatzes aufrufen. Weitere Hinweise zur VerwendungDescribeChangeSet, um den Status einer Änderungsanforderung abzurufen, finden Sie unterMit Änderungssätzen arbeiten.

Nettozahlungsbedingungen aktualisieren

Wenn die Wiederverkaufsermächtigung, mit der Sie ein Privatangebot für Vertriebspartner (CPPO) erstellen, eine Nettozahlungsfrist enthält, ist diese Frist der Höchstzeitraum, den Sie Ihrem Käufer anbieten können. Die Laufzeit aus der Wiederverkaufsgenehmigung wird automatisch auf Ihr CPPO angewendet, wenn Sie es erstellen.

Um Ihrem Käufer eine kürzere Zahlungsfrist als die vom Verkäufer autorisierte anzubieten, rufen Sie den StartChangeSet API-Vorgang mit der UpdateNetPaymentTerms Änderungsart in Ihrem Angebot auf, wie im folgenden Beispiel gezeigt. Wenn Sie den gleichen Zeitraum verwenden möchten, den der Verkäufer autorisiert hat, müssen Sie nicht anrufenUpdateNetPaymentTerms.

Wenn die Wiederverkaufsautorisierung keine Nettozahlungsbedingung enthält, können Sie dem CPPO keine hinzufügen, und es gelten die Zahlungsbedingungen Ihres Käufers. AWS Sie können die Nettozahlungsbedingung auch nicht aus einem CPPO entfernen, wenn die Wiederverkaufsgenehmigung eine solche enthält.

Anforderungssyntax

POST /StartChangeSet HTTP/1.1
Content-type: application/json

{
  "Catalog": "AWSMarketplace",
  "ChangeSet": [
    {
      "ChangeType": "UpdateNetPaymentTerms",
      "Entity": {
        "Type": "Offer@1.0",
        "Identifier": "offer-123456789"
      },
      "DetailsDocument": {
        "Terms": [
          {
            "Type": "NetPaymentTerm",
            "PaymentDuePeriod": "P30D"
          }
        ]
      }
    }
  ]
}

Geben Sie Informationen für die Felder ein, um den UpdateNetPaymentTerms Änderungstyp hinzuzufügen:

Synchrone Validierungen

Die folgenden Schemavalidierungen sind spezifisch für Aktionen in der. UpdateNetPaymentTerms AWS Marketplace Catalog API Diese Validierungen werden durchgeführt, wenn Sie anrufen. StartChangeSet Wenn die Anfrage die folgenden Anforderungen nicht erfüllt, schlägt sie mit einer HTTP-Antwort fehl.

Asynchrone Fehler

Die folgenden Fehler beziehen sich spezifisch auf UpdateNetPaymentTerms Aktionen auf einem CPPO in der. AWS Marketplace Catalog API Diese Fehler werden zurückgegeben, wenn Sie DescribeChangeSet nach der Verarbeitung eines Änderungssatzes aufrufen. Weitere Hinweise zur VerwendungDescribeChangeSet, um den Status einer Änderungsanforderung abzurufen, finden Sie unterMit Änderungssätzen arbeiten.

Veröffentlichen Sie das CPPO

Sie können die Catalog API verwenden, um die bei allen Aktualisierungsänderungstypen gesammelten Informationen zusammenzuführen und das Angebot dann in AWS Marketplace zu veröffentlichen.

Angebote bleiben in einem Draft Status, bis sie ReleaseOffer aufgerufen werden. Nachdem das Angebot veröffentlicht wurde, ist es in AWS Marketplace auffindbar.

Um Ihr Angebot zu veröffentlichen, rufen Sie den StartChangeSet API-Vorgang mit dem ReleaseOffer Änderungstyp auf, wie im folgenden Beispiel gezeigt.

Anforderungssyntax

POST /StartChangeSet HTTP/1.1
Content-type: application/json

{
  "Catalog": "AWSMarketplace",
  "ChangeSet": [
    {
      "ChangeType": "ReleaseOffer",
      "Entity": {
        "Type": "Offer@1.0",
        "Identifier": "offer-123456789"
      },
      "DetailsDocument": {}
    }
  ]
}

Geben Sie Informationen für die Felder ein, um den ReleaseOffer Änderungstyp hinzuzufügen:

Syntax der Antwort

Für Ihre Anfrage wird ein Änderungssatz erstellt. Die Antwort auf diese Anfrage gibt Ihnen das ChangeSetId und ChangeSetArn für den Änderungssatz und sieht wie folgt aus.

{
  "ChangeSetId": "example123456789012abcdef",
  "ChangeSetArn": "arn:aws:aws-marketplace:us-east-1:123456789012:AWSMarketplace/ChangeSet/example123456789012abcdef"
}

Die Änderungsanforderung wird einer Warteschlange hinzugefügt und verarbeitet. Dazu gehört auch die Überprüfung von Informationen, um sicherzustellen, dass sie den AWS Marketplace Richtlinien entsprechen. Der Validierungsvorgang kann zwischen einigen Minuten und einigen Stunden dauern.

Sie können den Status der Anfrage über die oder direkt über die AWS Marketplace Management Portal Catalog API mithilfe des DescribeChangeSet API-Vorgangs überprüfen.

Synchrone Validierungen

Die folgenden Schemavalidierungen sind spezifisch für Aktionen in der. ReleaseOffer AWS Marketplace Catalog API Diese Validierungen werden durchgeführt, wenn Sie anrufen. StartChangeSet Wenn die Anfrage die folgenden Anforderungen nicht erfüllt, schlägt sie mit einer HTTP-Antwort fehl.

Asynchrone Fehler

Die folgenden Fehler beziehen sich spezifisch auf ReleaseOffer Aktionen in der. AWS Marketplace Catalog API Diese Fehler werden zurückgegeben, wenn Sie DescribeChangeSet nach der Verarbeitung eines Änderungssatzes aufrufen. Weitere Hinweise zur VerwendungDescribeChangeSet, um den Status einer Änderungsanforderung abzurufen, finden Sie unterMit Änderungssätzen arbeiten.

Definieren Sie ein vorhandenes CPPO

Sie können die Catalog 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 ein, um den DescribeEntity Änderungstyp hinzuzufügen:

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 ein: