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.

Arbeite mit AMI-based Produkten

Sie können das verwenden AWS Marketplace Catalog API , um Aufgaben für die Arbeit mit Amazon Machine Image (AMI) -basierten Produkten zu automatisieren.

Informationen zum Erstellen eines AMI-based Produkts mithilfe der Catalog API finden Sie unterErstellen Sie ein Produkt.

In den folgenden Themen wird beschrieben, wie Sie die Katalog-API verwenden, um Aktionen an Ihren AMI-based Produkten durchzuführen:

Eine neue Version hinzufügen

Sie können die Katalog-API verwenden, um einem vorhandenen AMI-based Produkt in eine neue Version hinzuzufügen AWS Marketplace. Weitere Informationen zum Hinzufügen neuer AMI-Versionen zu Ihrem Produkt mithilfe von finden Sie unter Hinzufügen einer neuen Version im AWS Marketplace Verkäuferleitfaden. AWS Marketplace Management Portal

Wenn Sie eine Anfrage erstellen, die das Hinzufügen eines neuen AMI zu AWS Marketplace beinhaltet, muss das AMI in das AWS Marketplace Marketplace-System kopiert und dann auf Sicherheitsprobleme überprüft werden. Sie müssen AWS Marketplace Zugriff auf das AMI gewähren, indem Sie eine AWS Identity and Access Management (IAM) -Rolle mit Berechtigungen zur Ausführung von Aktionen auf Ihrem AMI erstellen. Weitere Informationen zu den erforderlichen Berechtigungen finden Sie im AWS Marketplace Verkäuferleitfaden unter Gewähren von AWS Marktplace-Zugriff auf Ihr AMI.

Um eine neue Version hinzuzufügen, rufen Sie den StartChangeSet API-Vorgang mit dem AddDeliveryOptions Änderungstyp für AMI-based Produkte auf, wie im folgenden Beispiel gezeigt. Um Ihren API-Aufruf zu testen, ohne tatsächlich eine neue Version zu erstellen, setzen Sie den Intent Parameter aufVALIDATE. Weitere Informationen finden Sie unter Intent.

Anforderungssyntax

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

{
  "Catalog": "AWSMarketplace",
  "ChangeSet":
  [
    {
      "ChangeType": "AddDeliveryOptions",
      "Entity":
      {
        "Type": "AmiProduct@1.0",
        "Identifier": "prod-example12345"
      },
      "DetailsDocument":
      {
        "Version":
        {
          "VersionTitle": "My new title",
          "ReleaseNotes": "My new Release notes"
        },
        "DeliveryOptions":
        [
          {
            "Details":
            {
              "AmiDeliveryOptionDetails":
              {
                "AmiSource":
                {
                  "AmiId": "ami-1234567890abcdef",
                  "AccessRoleArn": "arn:aws:iam::12345678901:role/AwsMarketplaceAmiIngestion",
                  "UserName": "ec2-user",
                  "OperatingSystemName": "AMAZONLINUX",
                  "OperatingSystemVersion": "Amazon Linux 2 AMI 2.0.20210126.0 x86_64 HVM gp2",
                  "AfiIds": ["afi-1234567890abcdefg", "afi-abcdefg1234567890"] //Optional (Required only for FPGA products)
                },
                "UsageInstructions": "Easy to use AMI",
                "RecommendedInstanceType": "m4.xlarge",
                "SecurityGroups":
                [
                  {
                    "IpProtocol": "tcp",
                    "FromPort": 443,
                    "ToPort": 443,
                    "IpRanges":
                    [
                      "0.0.0.0/0"
                    ]
                  }
                ]
              }
            }
          },
          {
            "DeliveryOptionTitle": "My new AMI with CFTdelivery option",
            "Details":
            {
              "DeploymentTemplateDeliveryOptionDetails":
              {
                "ShortDescription": "My new short description",
                "LongDescription": "My new long description",
                "UsageInstructions": "My new usage instructions",
                "RecommendedInstanceType": "m4.xlarge",
                "ArchitectureDiagram": "https://my-bucket.s3.amazonaws.com/my-folder/diagram.png",
                "Template": "https://my-bucket.s3.amazonaws.com/my-folder/cft.template",
                "TemplateSources":
                [
                  {
                    "ParameterName": "MyAmiParam",
                    "AmiSource":
                    {
                      "AmiId": "ami-1234567890abcdef",
                      "AccessRoleArn": "arn:aws:iam::12345678901:role/AwsMarketplaceAmiIngestion",
                      "UserName": "ec2-user",
                      "OperatingSystemName": "AMAZONLINUX",
                      "OperatingSystemVersion": "Amazon Linux 2 AMI 2.0.20210126.0 x86_64 HVM gp2"
                    }
                  }
                ]
              }
            }
          }
        ]
      }
    }
  ],
  "Intent": "APPLY"
}

Die folgende Liste enthält Informationen zu den Eingabefeldern, die Sie für den AddDeliveryOptions Änderungstyp verwenden. Alle Felder sind Pflichtfelder, sofern nicht anders angegeben. Weitere Informationen zu diesen Feldern finden Sie im AWS Marketplace Verkäuferleitfaden unter Hinzufügen einer neuen Version.

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. Dies beinhaltete 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.

Weitere Informationen zu Fehlern in Produktänderungssets von Verkäufern finden Sie unterStatus und Fehler des Sets ändern.

Wenn die Anfrage abgeschlossen ist, wird die Version hinzugefügt, und alle bestehenden Abonnenten erhalten eine E-Mail-Nachricht, in der sie über die neue Version informiert werden. Weitere Informationen zum Hinzufügen einer neuen Version finden Sie im AWS Marketplace Verkäuferleitfaden unter Hinzufügen einer neuen Version.

Asynchrone Fehler

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

Sie können ein AMI-based Produkt auch mit dem AWS Marketplace Management Portal erstellen. Weitere Informationen finden Sie unter AMI-Produkte im AWS Marketplace Verkäuferleitfaden.

Eine Anleitung zur automatischen Aktualisierung Ihres AMI-based Produkts finden Sie auch im Video Automatisieren von Aktualisierungen Ihrer Produktangebote AWS Marketplace mit der Katalog-API (5:08).

Versionsinformationen aktualisieren

Sie können die Katalog-API verwenden, um die Details einer vorhandenen Version Ihres AMI-based Produkts in zu aktualisieren AWS Marketplace.

Sie können das AMI für die Version nicht aktualisieren. Wenn Sie das AMI aktualisieren müssen, erstellen Sie stattdessen eine neue Version.

Um eine neue Version hinzuzufügen, rufen Sie den StartChangeSet API-Vorgang mit dem UpdateDeliveryOptions Änderungstyp auf, wie im folgenden Beispiel gezeigt.

Anforderungssyntax

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

{
  "Catalog": "AWSMarketplace",
  "ChangeSet":
  [
    {
      "ChangeType": "UpdateDeliveryOptions",
      "Entity":
      {
        "Identifier": "example1-abcd-1234-5ef6-7890abcdef12@1",
        "Type": "AmiProduct@1.0"
      },
      "DetailsDocument":
      {
        "Version":
        {
          "ReleaseNotes": "*My new Release notes*"
        },
        "DeliveryOptions":
        [
          {
            "Id": "example1-2222-cccc-2222-cccccccccccc",
            "Details":
            {
              "AmiDeliveryOptionDetails":
              {
                "UsageInstructions": "Easy to use AMI"
              }
            }
          },
          {
            "Id": "example1-2222-dddd-2222-dddddddddddd",
            "Details":
            {
              "DeploymentTemplateDeliveryOptionDetails":
              {work with ami
                "DeliveryOptionTitle": "My updated delivery option title",
                "UsageInstructions": "Updated usage instructions here."
              }
            }
          }
        ]
      }
    }
  ]
}

Im Folgenden finden Sie Informationen zu den Eingabefeldern, die Sie für das Hinzufügen des UpdateDeliveryOptions Änderungstyps angeben. Weitere Informationen zu diesen Feldern finden Sie im AWS Marketplace Verkäuferleitfaden unter Versionsinformationen aktualisieren.

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. Dies beinhaltete 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.

Weitere Informationen über Änderungssätze finden Sie unter Mit Änderungssätzen arbeiten. Weitere Informationen zu Fehlern in Produktänderungssets von Verkäufern finden Sie unterStatus und Fehler des Sets ändern.

Asynchrone Fehler

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

Sie können UpdatePricingTerms Aktionen abrufen, indem Sie den DescribeChangeSet Vorgang verwenden, nachdem der Änderungssatz mit der Verarbeitung begonnen hat. Weitere Informationen zu Fehlerdetails und Problembehebung finden Sie weiter Status und Fehler des Sets ändern oben in diesem Handbuch.

Beschränken Sie eine Version

Sie können die Katalog-API verwenden, um eine Version Ihres AMI-based Produkts einzuschränken. Dadurch wird verhindert, dass neue Käufer diese Version verwenden, sie steht aber bestehenden Käufern weiterhin zur Verfügung. Wenn Sie alle Lieferoptionen einer Version einschränken, wird die Version eingeschränkt. Wenn Sie eine oder mehrere, aber nicht alle Lieferoptionen einer Version einschränken, werden nur die Lieferoptionen in dieser Version eingeschränkt. Sie müssen immer mindestens eine uneingeschränkte Version eines Produkts verfügbar haben, sodass Sie die letzte öffentlich verfügbare Version eines Produkts nicht einschränken können.

Um eine Version einzuschränken, rufen Sie den StartChangeSet API-Vorgang mit dem RestrictDeliveryOptions Änderungstyp auf, wie im folgenden Beispiel gezeigt.

Anforderungssyntax

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

{
  "Catalog": "AWSMarketplace",
  "ChangeSet":
  [
    {
      "ChangeType": "RestrictDeliveryOptions",
      "Entity":
      {
        "Identifier": "example1-abcd-1234-5ef6-7890abcdef12@1",
        "Type": "AmiProduct@1.0"
      },
      "DetailsDocument":
      {
        "DeliveryOptionIds":
        [
          "example1-2222-cccc-2222-cccccccccccc"
        ]
      }
    }
  ]
}

Im Folgenden finden Sie Informationen zu den Eingabefeldern, die Sie für das Hinzufügen des RestrictDeliveryOptions Änderungstyps angeben:

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. Dies beinhaltete 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.

Asynchrone Fehler

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

future aktualisieren AWS-Region Support

Sie können die Katalog-API verwenden, um future AWS-Region Supporteinstellungen für Ihr AMI-based Produkt in zu ändern AWS Marketplace.

Um future AWS-Region Supporteinstellungen zu ändern, rufen Sie den StartChangeSet API-Vorgang mit dem UpdateFutureRegionSupport Änderungstyp auf, wie im folgenden Beispiel gezeigt.

Anforderungssyntax

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

{
  "Catalog": "AWSMarketplace",
  "ChangeSet":
  [
    {
      "ChangeType": "UpdateFutureRegionSupport",
      "Entity":
      {
        "Identifier": "prod-example12345",
        "Type": "AmiProduct@1.0"
      },
      "DetailsDocument":
      {
        "FutureRegionSupport":
        {
          "SupportedRegions":
          [
            "All"
          ]
        }
      }
    }
  ]
}

Geben Sie Informationen für die Felder an, um den UpdateFutureRegionSupport Ä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. Dies beinhaltete 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.

Asynchrone Fehler

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

Fügen Sie ein unterstütztes hinzu AWS-Region

Sie können die Katalog-API verwenden, um neue, AWS-Regionen für Ihr AMI-based Produkt unterstützte Produkte hinzuzufügen AWS Marketplace.

Um neue unterstützte Regionen hinzuzufügen, rufen Sie den StartChangeSet API-Vorgang mit dem AddRegions Änderungstyp auf, wie im folgenden Beispiel gezeigt.

Anforderungssyntax

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

{
  "Catalog": "AWSMarketplace",
  "ChangeSet": [
    {
      "ChangeType": "AddRegions",
      "DetailsDocument": {
        "Regions": [
          "us-east-1",
          "ap-northeast-2"
        ]
      },
      "Entity": {
        "Identifier": "prod-123456@1",
        "Type": "AmiProduct@1.0"
      }
    }
  ]
}

Geben Sie Informationen für die Felder an, um den AddRegions Ä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. Dies beinhaltete 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.

Asynchrone Fehler

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

Beschränken Sie ein AWS-Region

Sie können die Katalog-API verwenden, um die zuvor AWS-Regionen für Ihr AMI-based Produkt unterstützte Version einzuschränken AWS Marketplace.

Um zuvor unterstützte Regionen einzuschränken, rufen Sie den StartChangeSet API-Vorgang mit dem RestrictRegions Änderungstyp auf, wie im folgenden Beispiel gezeigt.

Anforderungssyntax

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

{
  "Catalog": "AWSMarketplace",
  "ChangeSet": [
    {
      "ChangeType": "RestrictRegions",
      "DetailsDocument": {
        "Regions": [
          "us-east-1",
          "ap-northeast-2"
        ]
      },
      "Entity": {
        "Identifier": "prod-123456@1",
        "Type": "AmiProduct@1.0"
      }
    }
  ]
}

Geben Sie Informationen für die Felder an, um den AddRegions Ä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. Dies beinhaltete 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.

Asynchrone Fehler

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

Fügen Sie einen neuen Instanztyp hinzu

Sie können die Katalog-API verwenden, um neue Instanztypen für Ihr AMI-based Produkt hinzuzufügen AWS Marketplace.

AddInstanceTypesfügt bei der Erstellung eines Produkts neue Instanztypen zu vorhandenen und neu erstellten Produkten hinzu. Durch den Änderungstyp werden alle Versionen im Produktdokument mit einem neuen Instanztyp aktualisiert.

Beim Hinzufügen eines eingeschränkten Instanztyps kann der Instanztyp aus der Liste der eingeschränkten Instanztypen entfernt und der Liste der verfügbaren Instanztypen hinzugefügt werden. Dadurch haben Verkäufer mehr Kontrolle darüber, wie sie ihre Produkteinschränkungen ändern können. Die Liste der Instanztypen ist austauschbar und hat keinen dauerhaften eingeschränkten Status für ein Produkt.

Bei Produkten mit interner Abrechnung müssen Verkäufer separate Änderungstypen angeben AddDimensions und UpdatePricingTerms die Preise für den Instance-Typ aktualisieren.

Um neue Instanztypen hinzuzufügen, rufen Sie den StartChangeSet API-Vorgang mit dem RestrictRegions Änderungstyp auf, wie im folgenden Beispiel gezeigt.

Anforderungssyntax

Im Folgenden wird nur der AddInstanceTypes Änderungstyp angezeigt. Obwohl AMI-Verkäufer intern gemessen werden, müssen sie anrufen AddInstanceTypes und die Typen für ihr AMI UpdatePricingTerms ändern.

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

{
  "Catalog": "AWSMarketplace",
  "ChangeSet":
  [
    {
      "ChangeType": "AddInstanceTypes",
      "Entity":
      {
        "Identifier": "prod-example12345",
        "Type": "AmiProduct@1.0"
      },
      "DetailsDocument":
      {
        "InstanceTypes":
        [
          "m1.medium"
        ]
      }
    }
  ]
}

Geben Sie Informationen für die Felder an, in denen der AddInstanceTypes Änderungstyp hinzugefügt werden soll:

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. Dies beinhaltete 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. AddInstanceTypes 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 AddInstanceTypes 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.

Beschränken Sie einen Instanztyp

Sie können die Katalog-API verwenden, um die für Ihr AMI-based Produkt verfügbaren Instanztypen in einzuschränken oder einzuschränken AWS Marketplace.

Bestehende Abonnenten sind von dieser Änderung nicht betroffen und können die eingeschränkten Instanztypen verwenden. Neue Käufer werden jedoch nicht in der Lage sein, eingeschränkte Instance-Typen zu verwenden. Um Abonnements für aktuelle Instanztypen zu beenden (sobald die Instanztypen eingeschränkt sind), müssen Sie sich an das AWS Marketplace Seller Operations Team wenden.

RestrictInstanctTypesschränkt Instanztypen auf alle Versionen im Produktdokument ein. Beim AddInstanceTypes Änderungstyp aktualisieren Sie alle Versionen des Produkts. Sie können die empfohlenen Instance-Typen nicht einschränken. Der empfohlene Instance-Typ bezieht sich auf Versionsebene. Es ist also möglich, dass der Verkäufer nicht in der Lage ist, mehrere Instance-Typen einzuschränken.

Bei einem intern gemessenen Produkt müssen Sie beim Aufrufen separate Änderungstypen aufrufenRestrictDimensions. Dadurch wird verhindert, dass neue Angebote für die eingeschränkten Instance-Typen erstellt werden.

Um die für Ihr AMI-based Produkt verfügbaren Instance-Typen einzuschränken oder einzuschränken, rufen Sie den StartChangeSet API-Vorgang mit dem RestrictInstanceTypes Änderungstyp auf, wie im folgenden Beispiel gezeigt.

Anforderungssyntax

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

{
  "Catalog": "AWSMarketplace",
  "ChangeSet":
  [
    {
      "ChangeType": "RestrictInstanceTypes",
      "Entity":
      {
        "Identifier": "prod-example12345",
        "Type": "AmiProduct@1.0"
      },
      "DetailsDocument":
      {
        "InstanceTypes":
        [
          "m1.medium"
        ]
      }
    }
  ]
}

Geben Sie Informationen für die Felder an, um den RestrictInstanceTypes Ä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. Dies beinhaltete 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. RestrictInstanceTypes 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 RestrictInstanceTypes 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.