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

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

Während das Produkt beschreibt, was verkauft wird AWS Marketplace, beschreibt die Wiederverkaufsgenehmigung (auch als Verkaufschance bezeichnet) die Bedingungen und Regeln, nach denen dieses Produkt zum Weiterverkauf autorisiert wird. AWS Marketplace Die CPPO ist das Ziel der Wiederverkaufsgenehmigung.

Eine Wiederverkaufsgenehmigung umfasst eine Reihe von Bedingungen und Regeln, die für eine Wiederverkäufervereinbarung zwischen Herstellern und Vertriebspartnern akzeptiert werden müssen. Wenn der Wiederverkäufer die Bedingungen der Wiederverkaufsgenehmigung akzeptiert, kann er Angebote für das Produkt gemäß den darin enthaltenen Bedingungen erstellen.

Bei einer Wiederverkaufsautorisierung gibt es zwei Arten von Regeln:

Weitere Informationen finden Sie in den folgenden Ressourcen:

In den folgenden Themen wird beschrieben, wie Sie mithilfe der Catalog API Wiederverkaufsberechtigungen erstellen und aktualisieren:

Voraussetzungen für die Wiederverkaufsautorisierung

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 eine neue Wiederverkaufsautorisierung

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

Wenn Ihre Anfrage erfolgreich bearbeitet wurde, wird eine Wiederverkaufsgenehmigung für Sie AWS Marketplace Catalog API generiert. Draft Es handelt sich um eine unvollständige Wiederverkaufsgenehmigung, 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 den Prozess zur Erstellung der Wiederverkaufsautorisierung abzuschließen und die Wiederverkaufsautorisierung freizugeben. Dadurch wird die gesamte Wiederverkaufsautorisierung validiert und Ihre Wiederverkaufsberechtigung wird für Vertriebspartner sichtbar. AWS Marketplace

Um eine Wiederverkaufsautorisierung im Draft Status „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 AWS Marketplace Management Portal oder direkt über die Catalog API mithilfe der DescribeChangeSet API-Operation überprüfen.

Wenn die Anfrage abgeschlossen ist (falls Status jaSUCCEEDED), ResaleAuthorization wird eine neue generiert. Der SUCCEEDED Status gibt zwar an, dass der Aufruf zum CreateResaleAuthorization Ändern des Typs abgeschlossen ist, der ResaleAuthorization Status ist jedoch weiterhin Draft gültig.

Im Folgenden wird die Antwort des DescribeChangeSet API-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 der. 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 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.

Käufer-Targeting aktualisieren

Sie können die Katalog-API verwenden, um Käufer auf dem Laufenden zu halten, die auf Ihre Wiederverkaufsautorisierung abzielen. AWS Marketplace

Alle vorhandenen Targeting-Optionen, die nicht in der letzten Anfrage enthalten sind, werden aus der Wiederverkaufsautorisierung entfernt. Diese Art der Änderung ist für die Freigabe der Wiederverkaufsautorisierung optional.

Um Käufer auf dem Laufenden zu halten, die auf Ihre Wiederverkaufsautorisierung abzielen, rufen Sie den StartChangeSet API-Vorgang mit dem UpdateBuyerTargetingTerms Änderungstyp auf, 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 ein, 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 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 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 UpdateBuyerTargetingTerms Aktionen in der. 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 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.

Verfügbarkeit aktualisieren

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

Standardmäßig lautet der Wert „Unbegrenzte Nutzung dieser Wiederverkaufsautorisierung“. 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 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 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 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 der. 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 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 Gültigkeit einer zukünftigen Vereinbarung

Sie können die Catalog API verwenden, um ein zukünftiges Startdatum für Dienste in der Zukunft zu ändern und zu kontrollieren AWS Marketplace.

Dieser Änderungssatz ist nicht erforderlich, um eine Wiederverkaufsautorisierung freizugeben.

Um die Dauer der Produktvereinbarung Ihrer Wiederverkaufsautorisierung zu ändern und zu kontrollieren, rufen Sie den StartChangeSet API-Vorgang mit dem UpdateBuyerValidityTerms Änderungstyp auf, wie im folgenden Beispiel gezeigt.

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 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 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 der. 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 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 vorhandenen rechtlichen Begriffe vollständig zu ersetzen AWS Marketplace.

Die rechtlichen Bestimmungen, die nicht in der letzten Anfrage enthalten sind, werden aus der Wiederverkaufsgenehmigung entfernt. BuyerLegalTermenthält die EULA, die in die endgültige Käufervereinbarung aufgenommen wird, und LegalTerm den Wiederverkäufervertrag, der in die Wiederverkäufervereinbarung zwischen dem Vertriebspartner und dem ISV aufgenommen 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 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 Schemavalidierungen sind spezifisch für Aktionen in der. 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 der. AWS Marketplace Catalog API Diese Fehler werden zurückgegebenDescribeChangeSet, wenn Sie 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 AWS Marketplace.

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

Um die Preisdetails für Ihre Wiederverkaufsberechtigungen 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 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 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 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.

Zahlungsplan aktualisieren

Sie können die Catalog 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 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": "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 ein, 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 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 Schemavalidierungen sind spezifisch für Aktionen in der. 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 der. AWS Marketplace Catalog API Diese Fehler werden zurückgegeben, wenn Sie DescribeChangeSet nach der Verarbeitung eines Änderungssatzes aufrufen. Weitere Informationen zur Verwendung DescribeChangeSet zum Abrufen des Status einer Änderungsanforderung finden Sie unter. Mit Änderungssätzen arbeiten

Nettozahlungsbedingungen aktualisieren

Sie können die Katalog-API verwenden, um die Nettozahlungsbedingungen Ihrer Wiederverkaufsautorisierung festzulegen. AWS Marketplace Eine Nettozahlungsbedingung ist eine Bedingung, bei der Sie die Anzahl der Tage nach Rechnungsstellung angeben, bis zu der die Zahlung fällig ist.

Die Nettozahlungsfrist, die Sie für eine Wiederverkaufsgenehmigung festgelegt haben, ist die maximale Laufzeit, die der Vertriebspartner einem Käufer im Rahmen eines privaten Vertriebspartnerangebots (CPPO) anbieten kann. Der Vertriebspartner kann den gleichen Zeitraum oder einen kürzeren, jedoch keinen längeren Zeitraum anbieten. Weitere Informationen finden Sie unter Erstellen Sie ein CPPO.

Um die Nettozahlungsbedingung für Ihre Wiederverkaufsgenehmigung festzulegen, rufen Sie den StartChangeSet API-Vorgang mit der UpdateNetPaymentTerms Änderungsart auf, wie im folgenden Beispiel gezeigt.

Anforderungssyntax

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

{
  "Catalog": "AWSMarketplace",
  "ChangeSet": [
    {
      "ChangeType": "UpdateNetPaymentTerms",
      "Entity": {
        "Type": "ResaleAuthorization@1.0",
        "Identifier": "resaleauthz-123456789"
      },
      "DetailsDocument": {
        "Terms": [
          {
            "Type": "ResaleNetPaymentTerm",
            "PaymentDuePeriod": "P60D"
          }
        ]
      }
    }
  ]
}

Geben Sie Informationen für die Felder ein, um den UpdateNetPaymentTerms Ä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 einige Minuten dauern.

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

Synchrone Validierungen

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

Asynchrone Fehler

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

Angaben zur Wiederverkaufsautorisierung aktualisieren

Sie können die Catalog 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 ein, 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 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. UpdateInformation AWS Marketplace Catalog API Diese Validierungen werden durchgefü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 der. AWS Marketplace Catalog API Diese Fehler werden zurückgegeben, wenn Sie DescribeChangeSet nach der Verarbeitung eines Änderungssatzes aufrufen. Weitere Informationen zur Verwendung DescribeChangeSet zum Abrufen des Status einer Änderungsanforderung finden Sie unter. Mit Änderungssätzen arbeiten

Eine Wiederverkaufsautorisierung einschränken

Sie können die Catalog API verwenden, um Regeln zur Beschränkung einer Wiederverkaufsautorisierung in festzulegen. AWS Marketplace

Eine eingeschränkte Wiederverkaufsautorisierung kann von einem Vertriebspartner nicht mehr zur Erstellung eines privaten Angebots verwendet werden. Ein bestehendes privates Angebot wird nicht beeinträchtigt.

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 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 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 der. AWS Marketplace Catalog API Diese Fehler werden zurückgegeben, wenn Sie DescribeChangeSet nach der Verarbeitung eines Änderungssatzes aufrufen. Weitere Informationen zur Verwendung DescribeChangeSet zum Abrufen des Status einer Änderungsanforderung finden Sie unter. Mit Änderungssätzen arbeiten

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

Sie können die Catalog API verwenden, um Ihre ResaleAuthorization Registrierung in einem Active Bundesstaat einzuleiten.

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 ein, 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 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 Schemavalidierungen sind spezifisch für Aktionen in der. 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 der. AWS Marketplace Catalog API Diese Fehler werden zurückgegeben, wenn Sie DescribeChangeSet nach der Verarbeitung eines Änderungssatzes aufrufen. Weitere Informationen zur VerwendungDescribeChangeSet, um den Status einer Änderungsanforderung abzurufen, finden Sie unterMit Änderungssätzen arbeiten.

Beschreiben Sie eine bestehende Wiederverkaufsgenehmigung

Um Details zur 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 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": "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": "ResaleNetPaymentTerm",
        "Id": "term_id_placeholder",
        "PaymentDuePeriod": "P60D"
      },
      {
        "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.