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

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 Wiederverkaufsberechtigungen unter Verwendung der AWS Marketplace APIs

Sie können das verwenden AWS Marketplace Catalog API , um Aufgaben für die Arbeit mit Wiederverkaufsautorisierungen zu automatisieren.

Während das Produkt beschreibt, worin verkauft wird AWS Marketplace, beschreibt die Wiederverkaufserlaubnis (auch als Verkaufschance bezeichnet) die Bedingungen und Regeln, nach denen dieses Produkt zum Weiterverkauf zugelassen wird. AWS Marketplace Das CPPO ist das Ziel der Resale Authorization.

Eine Wiederverkaufserlaubnis umfasst eine Sammlung von Bedingungen und Regeln, die für eine Wiederverkäufervereinbarung zwischen Herstellern und Vertriebspartnern akzeptiert werden müssen. Die Annahme der Bedingungen der Wiederverkaufsgenehmigung ermöglicht es dem Wiederverkäufer, Angebote für das Produkt gemäß den in den Bedingungen genannten Bedingungen zu erstellen.

Bei einer Wiederverkaufsgenehmigung gibt es zwei Arten von Regeln:

Weitere Informationen finden Sie in den folgenden Ressourcen:

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

Voraussetzungen für die Wiederverkaufsautorisierung

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 zur gemeinsamen Nutzung von Ressourcen für erteilt. 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 eine neue Wiederverkaufsautorisierung

Sie können die Katalog-API verwenden, um eine neue Wiederverkaufsautorisierung in zu erstellen. AWS Marketplace

Wenn Ihre Anfrage erfolgreich bearbeitet wurde, wird für Sie eine entsprechende Wiederverkaufsgenehmigung AWS Marketplace Catalog API generiert. Draft Es handelt sich um eine unvollständige Wiederverkaufserlaubnis, die für Vertriebspartner in nicht sichtbar ist. AWS Marketplace

Verwenden Sie die Update Änderungstypen, um die Wiederverkaufsautorisierung abzuschließen. Nachdem die Wiederverkaufsautorisierung abgeschlossen ist, verwenden Sie den ReleaseResaleAuthorization Änderungstyp, um die Erstellung der Wiederverkaufsgenehmigung abzuschließen und die Wiederverkaufsautorisierung freizugeben, wodurch die gesamte Wiederverkaufserlaubnis validiert und Ihre Weiterverkaufsautorisierung für Vertriebspartner in sichtbar gemacht wird. AWS Marketplace

Um eine Wiederverkaufsautorisierung im Draft Status zu erstellen, rufen Sie den StartChangeSet API-Vorgang mit dem CreateResaleAuthorization Änderungstyp auf, wie im folgenden Beispiel gezeigt.

Anforderungssyntax

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

{
  "Catalog": "AWSMarketplace",
  "ChangeSet":
  [
    {
      "ChangeType": "CreateResaleAuthorization",
      "ChangeName": "xyz",
      "Entity":
      {
        "Type": "ResaleAuthorization@1.0"
      },
      "DetailsDocument":
      {
        "ProductId": "prod-ad8EXAMPLE51",
        "Name": "Test ResaleAuthorization",
        "Description": "Worldwide ResaleAuthorization for Test Product",
        "ResellerAccountId": "777788889999"
      }
    }
  ]
}

Geben Sie Informationen für die Eingabefelder ein, um den CreateResaleAuthorization Ä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 Katalog-API mithilfe des DescribeChangeSet API-Vorgangs überprüfen.

Wenn die Anfrage abgeschlossen ist (falls Status jaSUCCEEDED), ResaleAuthorization wird eine neue generiert. Der SUCCEEDED Status gibt zwar an, dass der Aufruf vom Typ „CreateResaleAuthorizationChange Type“ abgeschlossen ist, der ResaleAuthorization Status befindet sich jedoch weiterhin im Draft Status.

Im Folgenden wird die Antwort des DescribeChangeSetAPI-Vorgangs dargestellt.

{
  "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": "CreateResaleAuthorization",
      "Entity":
      {
        "Type": "ResaleAuthorization@1.0",
        "Identifier": "resaleauthz-123456789"
      },
      "DetailsDocument":
      {
        "ProductId": "prod-ad8EXAMPLE51",
        "Name": "Test ResaleAuthorization",
        "Description": "Worldwide ResaleAuthorization for Test Product",
        "ResellerAccountId": "777788889999",
        "BulkRequestId": "84977023-5093-4a66-8b24-ef2c5a2f8b1f"
      },
      "ErrorDetailList":
      []
    }
  ]
}

Synchrone Validierungen

Die Schemavalidierungen sind spezifisch für Aktionen in. CreateResaleAuthorization AWS Marketplace Catalog API Die 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.

Asynchrone Fehler

Die folgenden Fehler beziehen sich spezifisch auf CreateResaleAuthorization 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.

Käufer-Targeting aktualisieren

Sie können die Katalog-API verwenden, um Käufer zu aktualisieren, die auf Ihre Wiederverkaufserlaubnis abzielen. AWS Marketplace

Alle vorhandenen Targeting-Optionen, die nicht in der letzten Anfrage enthalten sind, werden aus der Wiederverkaufserlaubnis entfernt. Dieser Änderungstyp ist für die Freigabe der Wiederverkaufserlaubnis optional.

Rufen Sie den StartChangeSet API-Vorgang mit dem UpdateBuyerTargetingTerms Änderungstyp auf, um Käufer zu aktualisieren, die auf Ihre Wiederverkaufserlaubnis abzielen, wie im folgenden Beispiel gezeigt.

Anforderungssyntax

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

{
   "Catalog": "AWSMarketplace",
   "ChangeSet": [        
      {
         "ChangeType":"UpdateBuyerTargetingTerms",
         "Entity":{
            "Type": "ResaleAuthorization@1.0", 
            "Identifier": "resaleauthz-123456789"
         },
         "DetailsDocument":
         {
           "Terms":
           [
             {
               "Type": "BuyerTargetingTerm",
               "PositiveTargeting":
               {
                 "BuyerAccounts":
                 [
                  "123456789012"
                 ]
               }
             }
           ]
         }
      }
   ]
}

Geben Sie Informationen für die Felder an, um den UpdateBuyerTargetingTerms Ä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 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 oder direkt über die AWS Marketplace Management Portal Catalog API mithilfe des DescribeChangeSet API-Vorgangs überprüfen.

Synchrone Validierungen

Die Schemavalidierungen sind spezifisch für Aktionen in. UpdateBuyerTargetingTerms 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.

Asynchrone Fehler

Die folgenden Fehler beziehen sich spezifisch auf UpdateBuyerTargetingTerms 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.

Verfügbarkeit aktualisieren

Sie können die Katalog-API verwenden, um die Verfügbarkeit der Anzahl der erstellten privaten Angebote oder bis zu dem bestimmten Zeitpunkt, zu dem ein privates Angebot erstellt werden kann, einzuschränken.

Standardmäßig ist der Wert „unbegrenzte Nutzung“ dieser Wiederverkaufsautorisierung aktiviert. Sie können die Verfügbarkeit jedoch anhand der Regelliste überprüfen.

Um die Verfügbarkeit und Nutzbarkeit Ihrer Wiederverkaufsautorisierung zu kontrollieren, rufen Sie den StartChangeSet API-Vorgang mit dem UpdateAvailability Änderungstyp auf, wie im folgenden Beispiel gezeigt.

Anforderungssyntax

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

{
  "Catalog": "AWSMarketplace",
  "ChangeSet":
  [
    {
      "ChangeType": "UpdateAvailability",
      "Entity":
      {
        "Type": "ResaleAuthorization@1.0",
        "Identifier": "resaleauthz-123456789"
      },
      "DetailsDocument":
      {
        "AvailabilityEndDate": "2022-05-31",
        "OffersMaxQuantity": 1
      }
    }
  ]
}

Geben Sie Informationen für die Felder an, 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 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 oder direkt über die AWS Marketplace Management Portal Catalog API mithilfe des DescribeChangeSet API-Vorgangs überprüfen.

Synchrone Validierungen

Die Schemavalidierungen sind spezifisch für Aktionen in. UpdateAvailability AWS Marketplace Catalog API Die 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

Asynchrone Fehler

Die folgenden Fehler beziehen sich spezifisch auf UpdateAvailability Aktionen in der 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.

Aktualisieren Sie die Gültigkeit einer Vereinbarung mit zukünftigem Datum

Sie können die Katalog-API verwenden, um ein future Dienststartdatum in zu ändern und zu steuern AWS Marketplace.

Dieser Änderungssatz ist für die Freigabe einer Wiederverkaufsautorisierung nicht erforderlich.

Rufen Sie den StartChangeSet API-Vorgang mit dem Änderungstyp auf, wie im folgenden Beispiel gezeigt, um die Dauer der Produktvereinbarung für Ihre Wiederverkaufsgenehmigung zu UpdateBuyerValidityTerms ändern und zu kontrollieren.

Anforderungssyntax

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

{
  "Catalog": "AWSMarketplace",
  "ChangeSet":
  [
    {
      "ChangeType": "UpdateBuyerValidityTerms",
      "Entity":
      {
        "Type": "ResaleAuthorization@1.0",
        "Identifier": "resaleauthz-123456789"
      },
      "DetailsDocument":
      {
        "Terms":
        [
          {
            "Type": "BuyerValidityTerm",
            "MaximumAgreementStartDate": "2024-05-31"
          }
        ]
      }
    }
  ]
}

Geben Sie Informationen für die Eingabefelder ein, um den UpdateBuyerValidityTerms Ä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 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 oder direkt über die AWS Marketplace Management Portal Catalog API mithilfe des DescribeChangeSet API-Vorgangs überprüfen.

Synchrone Validierungen

Die Schemavalidierungen sind spezifisch für Aktionen in. UpdateBuyerValidityTerms AWS Marketplace Catalog API Die 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.

Asynchrone Fehler

Die folgenden Fehler beziehen sich spezifisch auf UpdateBuyerValidityTerms 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.

Rechtliche Ressourcen aktualisieren

Sie können die Katalog-API verwenden, um die bestehenden rechtlichen Bestimmungen in vollständig zu ersetzen AWS Marketplace.

Die rechtlichen Bestimmungen, die nicht in der letzten Anfrage enthalten sind, werden aus der Wiederverkaufserlaubnis entfernt. BuyerLegalTermenthält die EULA, die in der endgültigen Käufervereinbarung enthalten sein wird, sowie LegalTerm den Reseller-Vertrag, der in der Reseller-Vereinbarung zwischen dem Vertriebspartner und dem ISV enthalten sein wird.

Um Ihre rechtlichen Bestimmungen zu aktualisierenResaleAuthorization, 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": "ResaleAuthorization@1.0",
        "Identifier": "resaleauthz-123456789"
      },
      "DetailsDocument":
      {
        "Terms":
        [
          {
            "Type": "BuyerLegalTerm",
            "Documents":
            [
              {
                "Type": "CustomEula",
                "Url": "https://my-public-bucket.s3.amazonaws.com/eula-example12345.txt"
              }
            ]
          },
          {
            "Type": "ResaleLegalTerm",
            "Documents":
            [
              {
                "Type": "CustomResellerContract",
                "Url": "https://my-public-bucket.s3.amazonaws.com/reseller-example12345.txt"
              }
            ]
          }
        ]
      }
    }
  ]
}

Geben Sie Informationen für die Felder ein, um den UpdateLegalTerms Ä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, um sicherzustellen, dass sie den AWS Marketplace Richtlinien entsprechen. Der Validierungsprozess kann zwischen einigen Minuten und einigen Stunden dauern.

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

Synchrone Validierungen

Die Schemavalidierungen sind spezifisch für Aktionen in. UpdateLegalTerms AWS Marketplace Catalog API Die 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.

Asynchrone Fehler

Die folgenden Fehler beziehen sich spezifisch auf UpdateLegalTerms Aktionen in. AWS Marketplace Catalog API Diese Fehler werden zurückgegeben, wenn Sie aufrufenDescribeChangeSet, nachdem ein Änderungssatz verarbeitet wurde. Weitere Hinweise zur Verwendung DescribeChangeSet zum Abrufen des Status einer Änderungsanforderung finden Sie unterMit Änderungssätzen arbeiten.

Preisgestaltung aktualisieren

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

Preisbedingungen, die in der letzten Anfrage nicht enthalten sind, werden aus der Wiederverkaufserlaubnis entfernt. Sie können die ermäßigten Preise für Ihr Produkt über diese API aktualisieren.

Um die Preisdetails für Ihre Wiederverkaufsautorisierungen 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": "ResaleAuthorization@1.0",
        "Identifier": "resaleauthz-123456789"
      },
      "DetailsDocument":
      {
        "PricingModel": "Contract",
        "Terms":
        [
          {
            "Type": "ResaleUsageBasedPricingTerm",
            "CurrencyCode": "USD",
            "RateCards":
            [
              {
                "RateCard":
                [
                  {
                    "DimensionKey": "m3.large",
                    "Price": "0.10"
                  },
                  {
                    "DimensionKey": "m4.xlarge",
                    "Price": "0.20"
                  }
                ]
              }
            ]
          },
          {
            "Type": "ResaleConfigurableUpfrontPricingTerm",
            "CurrencyCode": "USD",
            "RateCards":
            [
              {
                "Selector":
                {
                  "Type": "Duration",
                  "Value": "P12M"
                },
                "RateCard":
                [
                  {
                    "DimensionKey": "m3.large",
                    "Price": "300"
                  },
                  {
                    "DimensionKey": "m4.xlarge",
                    "Price": "400"
                  }
                ],
                "Constraints":
                {
                  "MultipleDimensionSelection": "Allowed",
                  "QuantityConfiguration": "Allowed"
                }
              }
            ]
          },
          {
            "Type": "ResaleFixedUpfrontPricingTerm",
            "CurrencyCode": "USD",
            "Duration": "P2M",
            "Price": "200.0",
            "Grants":
            [
              {
                "DimensionKey": "Users",
                "MaxQuantity": 10
              }
            ]
          }
        ]
      }
    }
  ]
}

Geben Sie Informationen für die Felder an, 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 der Informationen, um sicherzustellen, dass sie den AWS Marketplace Richtlinien entsprechen. Der Validierungsprozess kann zwischen einigen Minuten und einigen Stunden dauern.

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

Synchrone Validierungen

Die folgenden Schemavalidierungen sind spezifisch für UpdatePricingTerms Aktionen in der AWS Marketplace Catalog API. Die 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.

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.

Zahlungsplan aktualisieren

Sie können die Katalog-API verwenden, um zahlungsbezogene Details, wie z. B. einen flexiblen Zahlungsplan, in zu ändern. AWS Marketplace

Um die zahlungsbezogenen Details für Ihre Wiederverkaufsautorisierung 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": "ResaleAuthorization@1.0",
        "Identifier": "resaleauthz-123456789"
      },
      "DetailsDocument":
      {
        "Terms":
        [
          {
            "Type": "ResalePaymentScheduleTerm",
            "CurrencyCode": "USD",
            "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 Änderungstyp hinzuzufügen: UpdatePaymentScheduleTerms

Syntax der Antwort

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

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

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

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

Synchrone Validierungen

Die Schemavalidierungen sind spezifisch für Aktionen in. UpdatePaymentScheduleTerms AWS Marketplace Catalog API Die 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.

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 Informationen zur Verwendung DescribeChangeSet zum Abrufen des Status einer Änderungsanforderung finden Sie unter. Mit Änderungssätzen arbeiten

Aktualisieren Sie die Details zur Wiederverkaufsautorisierung

Sie können die Katalog-API verwenden, um die Details zur Wiederverkaufsautorisierung in zu aktualisieren. AWS Marketplace

Um die Details zur Wiederverkaufsautorisierung zu aktualisieren, rufen Sie den StartChangeSet API-Vorgang mit dem UpdateInformation Änderungstyp auf, wie im folgenden Beispiel gezeigt.

Anforderungssyntax

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

{
  "Catalog": "AWSMarketplace",
  "ChangeSet":
  [
    {
      "ChangeType": "UpdateInformation",
      "Entity":
      {
        "Type": "ResaleAuthorization@1.0",
        "Identifier": "resaleauthz-123456789"
      },
      "DetailsDocument":
      {
        "Name": "TestResaleAuthorization",
        "Description": "Worldwide ResaleAuthorization for Test Product",
        "PreExistingBuyerAgreement":
        {
          "AcquisitionChannel": "AwsMarketplace",
          "PricingModel": "Contract"
        }
      }
    }
  ]
}

Geben Sie Informationen für die Felder an, um den UpdateInformation Ä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, um sicherzustellen, dass sie den AWS Marketplace Richtlinien entsprechen. Der Validierungsprozess kann zwischen einigen Minuten und einigen Stunden dauern.

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

Synchrone Validierungen

Die folgenden Schemavalidierungen sind spezifisch für Aktionen in. UpdateInformation AWS Marketplace Catalog API Diese Validierungen werden ausgeführt, wenn Sie aufrufenStartChangeSet, und die Anforderung schlägt mit einem HTTP-Fehler fehl, wenn die Eingabe die folgenden Anforderungen nicht erfüllt.

Asynchrone Fehler

Die folgenden Fehler beziehen sich spezifisch auf UpdateInformation Aktionen in. AWS Marketplace Catalog API Diese Fehler werden zurückgegeben, wenn Sie aufrufen, DescribeChangeSet nachdem ein Änderungssatz verarbeitet wurde. Weitere Informationen zur Verwendung DescribeChangeSet zum Abrufen des Status einer Änderungsanforderung finden Sie unter. Mit Änderungssätzen arbeiten

Beschränken Sie eine Genehmigung für den Weiterverkauf

Sie können die Katalog-API verwenden, um Einschränkungsregeln für eine Wiederverkaufsautorisierung in festzulegen. AWS Marketplace

Eine eingeschränkte Wiederverkaufsautorisierung kann nicht mehr von einem Vertriebspartner verwendet werden, um ein privates Angebot zu erstellen. Ein bestehendes privates Angebot ist davon nicht betroffen.

Um Ihre Wiederverkaufsautorisierung einzuschränken, rufen Sie den StartChangeSet API-Vorgang mit dem RestrictResaleAuthorization Änderungstyp auf, wie im folgenden Beispiel gezeigt.

Anforderungssyntax

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

{
  "Catalog": "AWSMarketplace",
  "ChangeSet": [
    {
      "ChangeType": "RestrictResaleAuthorization",
      "Entity": {
        "Type": "ResaleAuthorization@1.0",
        "Identifier": "resaleauthz-123456789"
      },
      "DetailsDocument": {}
    }
  ]
}

Geben Sie Informationen für die Felder ein, um den RestrictResaleAuthorization Ä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, um sicherzustellen, dass sie den AWS Marketplace Richtlinien entsprechen. Der Validierungsprozess kann zwischen einigen Minuten und einigen Stunden dauern.

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

Synchrone Validierungen

Die Schemavalidierungen sind spezifisch für RestrictResaleAuthorization 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 RestrictResaleAuthorization Aktionen in. AWS Marketplace Catalog API Diese Fehler werden zurückgegeben, wenn Sie aufrufen, DescribeChangeSet nachdem ein Änderungssatz verarbeitet wurde. Weitere Informationen zur Verwendung DescribeChangeSet zum Abrufen des Status einer Änderungsanforderung finden Sie unter. Mit Änderungssätzen arbeiten

Geben Sie eine Wiederverkaufserlaubnis frei und machen Sie sie für einen Vertriebspartner sichtbar

Sie können die Katalog-API verwenden, um Ihre Bestellung zu einem bestimmten Active Bundesstaat ResaleAuthorization zu starten.

ReleaseResaleAuthorizationaktiviert Ihre Wiederverkaufsautorisierung, sodass ein Vertriebspartner Ihre Wiederverkaufsautorisierung verwenden kann, um private Angebote zu erstellen.

Um Ihre Wiederverkaufsautorisierung freizugeben, rufen Sie den StartChangeSet API-Vorgang mit dem ReleaseResaleAuthorization Änderungstyp auf, wie im folgenden Beispiel gezeigt.

Anforderungssyntax

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

{
  "Catalog": "AWSMarketplace",
  "ChangeSet":
  [
    {
      "ChangeType": "ReleaseResaleAuthorization",
      "Entity":
      {
        "Type": "ResaleAuthorization@1.0",
        "Identifier": "resaleauthz-123456789"
      },
      "DetailsDocument": {}
    }
  ]
}

Geben Sie Informationen für die Felder an, um den ReleaseResaleAuthorization Ä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, um sicherzustellen, dass sie den AWS Marketplace Richtlinien entsprechen. Der Validierungsprozess kann zwischen einigen Minuten und einigen Stunden dauern.

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

Synchrone Validierungen

Die Schemavalidierungen sind spezifisch für Aktionen in. ReleaseResaleAuthorization AWS Marketplace Catalog API Die 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.

Asynchrone Fehler

Die folgenden Fehler beziehen sich spezifisch auf ReleaseResaleAuthorization Aktionen in. AWS Marketplace Catalog API Diese Fehler werden zurückgegeben, wenn Sie aufrufen, DescribeChangeSet nachdem ein Änderungssatz verarbeitet wurde. Weitere Informationen zur Verwendung DescribeChangeSet zum Abrufen des Status einer Änderungsanforderung finden Sie unterMit Änderungssätzen arbeiten.

Beschreiben Sie eine bestehende Wiederverkaufserlaubnis

Um die Einzelheiten der Wiederverkaufsautorisierung zu beschreiben, rufen Sie den DescribeEntity API-Vorgang mit dem ResaleAuthorization@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:

Syntax der Antwort

Die Antwort auf diese Anfrage enthält die Angebotsdetails und sieht wie folgt aus.

{
  "EntityType": "ResaleAuthorization@1.0",
  "EntityIdentifier": "resaleauthz-123456789",
  "EntityArn": "arn:aws:aws-marketplace:us-east-1:111122223333:AWSMarketplace/ResaleAuthorization/resaleauthz-123456789",
  "LastModifiedDate": "2021-03-10T21:57:16Z",
  "DetailsDocument": {
    "Name": "TestResaleAuthorization",
    "Description": "ResaleAuthorization for Test Product",
    "ProductId": "prod-ad8EXAMPLE51",
    "ProductName": "TestProduct",
    "Status": "Active", /*Draft, Active, Restricted*/
    "PreExistingBuyerAgreement": {
      "AcquisitionChannel": "Unknown",
      "PricingModel": "Unknown"
    },
    "CreatedDate": "2023-07-18T16:39:31.335Z",
    "ManufacturerLegalName": "ChannelCAPI.Inc",
    "ManufacturerAccountId": "123456789012",
    "Dimensions": [
      {
        "Name": "Protected Resources",
        "Description": "Additional 100 protected resources",
        "Key": "hundredresources",
        "Unit": "Units",
        "Types": [
          "Entitled"
        ]
      }
    ],
    "OfferDetails": {
      "OfferExtendedStatus": "Not Started", /* Not Started, Completed-Used, Completed-Usable*/
      "OfferCreatedCount": 0
    },
    "Terms": [
      {
        "Type": "ResaleUsageBasedPricingTerm",
        "Id": "term_id_placeholder",
        "CurrencyCode": "USD",
        "RateCards": [
          {
            "RateCard": [
              {
                "DimensionKey": "resource_number",
                "Price": "0.05"
              },
              {
                "DimensionKey": "scanned_data",
                "Price": "0.05"
              }
            ]
          }
        ]
      },
      {
        "Type": "ResaleConfigurableUpfrontPricingTerm",
        "Id": "term_id_placeholder",
        "CurrencyCode": "USD",
        "RateCards": [
          {
            "Selector": {
              "Type": "Duration",
              "Value": "P24M"
            },
            "RateCard": [
              {
                "DimensionKey": "hundredresources",
                "Price": "0.04"
              },
              {
                "DimensionKey": "tenTBData",
                "Price": "0.03"
              },
              {
                "DimensionKey": "channel_custom",
                "Price": "0.02"
              }
            ],
            "Constraints": {
              "MultipleDimensionSelection": "Allowed",
              "QuantityConfiguration": "Allowed"
            }
          }
        ]
      },
      {
        "Type": "ResaleFixedUpfrontPricingTerm",
        "Id": "term-sdh27fb2",
        "CurrencyCode": "USD",
        "Duration": "P180D",
        "Price": "0.0",
        "Grants": [
          {
            "DimensionKey": "sdf73rbns93nl120d10xm1",
            "MaxQuantity": 1
          }
        ]
      },
      {
        "Type": "ResalePaymentScheduleTerm",
        "Id": "term-sdh27fb2",
        "CurrencyCode": "USD",
        "Schedule": [
          {
            "ChargeDate": "2018-07-01T00:00:00.000Z",
            "ChargeAmount": "200.00"
          },
          {
            "ChargeDate": "2019-05-01T00:00:00.000Z",
            "ChargeAmount": "200.00"
          }
        ]
      },
      {
        "Type": "BuyerLegalTerm",
        "Id": "term_id_placeholder",
        "Documents": [
          {
            "Type": "StandardEula",
            "Url": "https://resale-auth-legal-terms-iad-beta.s3.us-east-1.amazonaws.com/09ae57d6-c75a-3a4c-aadf-9b866bae64ab/a85cace8-6d9d-40ca-a053-78fc265479bf?isSigned=yes"
          }
        ]
      },
      {
        "Type": "ResaleLegalTerm",
        "Id": "term_id_placeholder",
        "Documents": [
          {
            "Type": "StandardResellerContract",
            "Url": "https://resale-auth-legal-terms-iad-beta.s3.us-east-1.amazonaws.com/09ae57d6-c75a-3a4c-aadf-9b866bae64ab/bed55b56-7ab4-4c4c-b633-3bf4f6efcb98?isSigned=yes"
          }
        ]
      },
      {
        "Type": "BuyerValidityTerm",
        "Id": "term_id_placeholder",
        "MaximumAgreementStartDate": "2023-09-25T23:59:59.000Z"
      },
      {
        "Type": "BuyerTargetingTerm",
        "Id": "term_id_placeholder",
        "PositiveTargeting": {
          "BuyerAccounts": [
            {
              "AwsAccountId": "444455556666"
            }
          ]
        }
      }
    ],
    "Rules": [
      {
        "Type": "AvailabilityRule",
        "Id": "availability_rule_id_placeholder",
        /* If the AvailabilityEndDate and OffersMaxQuantity not present Usage will be Unlimited*/
        "Usage": "Limited",
        "AvailabilityEndDate": "2022-05-31T23:59:59Z",
        "OffersMaxQuantity": 1
      },
      {
        "Type": "PartnerTargetingRule",
        "Id": "partner_targeting_rule_id_placeholder",
        "ResellerAccountId": "777777777777",
        "ResellerLegalName": "ChannelCAPICP.Inc"
      }
    ]
  }
}

Im Folgenden finden Sie Informationen zu den Feldern, die Sie in der DescribeEntity Antwort sehen.