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 AMI-based Produkten

Sie können die verwenden AWS Marketplace Catalog API , um Aufgaben für die Arbeit mit auf Amazon Machine Image (AMI) basierenden 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 Catalog API verwenden, um Aktionen an Ihren AMI-based Produkten durchzuführen:

Fügen Sie eine neue Version hinzu

Sie können die Catalog 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äuferhandbuch. AWS Marketplace Management Portal

Wenn Sie eine Anfrage erstellen, die das Hinzufügen eines neuen AMI zum AWS Marketplace beinhaltet, muss das AMI in das AWS 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 zum Ausführen von Aktionen an Ihrem AMI erstellen. Weitere Informationen zu den erforderlichen Berechtigungen finden Sie im AWS Marketplace Verkäuferleitfaden unter Gewähren von AWS Marketplace 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 Absicht.

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 erforderlich, 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. Dazu gehörte auch die Überprüfung der 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.

Weitere Informationen zu Fehlern in den Produktänderungssätzen 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 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.

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

Eine Anleitung, wie Sie die Aktualisierung Ihres AMI-based Produkts automatisieren können, finden Sie auch im Video Automatisieren von Aktualisierungen Ihrer Produktangebote AWS Marketplace mit der Katalog-API (5:08).

Versionsinformationen aktualisieren

Sie können die Catalog 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 die StartChangeSet API-Operation 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äuferhandbuch unter Aktualisieren der Versionsinformationen.

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örte auch die Überprüfung der 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.

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

Asynchrone Fehler

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

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 zur Problembehandlung finden Sie weiter Status und Fehler des Sets ändern oben in diesem Handbuch.

Eine Version einschränken

Sie können die Catalog API verwenden, um eine Version Ihres AMI-based Produkts einzuschränken. Dadurch wird verhindert, dass neue Käufer diese Version verwenden, aber bestehende Käufer können sie weiterhin nutzen. 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. Es muss immer mindestens eine uneingeschränkte Version eines Produkts verfügbar sein, 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:

Antwortsyntax

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örte auch die Überprüfung der 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.

Asynchrone Fehler

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

Zukunft aktualisieren AWS-Region Support

Sie können die Catalog API verwenden, um zukünftige AWS-Region Support-Einstellungen für Ihr AMI-based Produkt in zu ändern AWS Marketplace.

Um zukünftige AWS-Region Support-Einstellungen 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 ein, 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. Dazu gehörte auch die Überprüfung der 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.

Asynchrone Fehler

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

Fügen Sie eine unterstützte hinzu AWS-Region

Sie können die Catalog 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 ein, 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. Dazu gehörte auch die Überprüfung der 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.

Asynchrone Fehler

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

Beschränken Sie eine AWS-Region

Sie können die Catalog API verwenden, um die zuvor AWS-Regionen für Ihr AMI-based Produkt unterstützten Optionen 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 ein, 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. Dazu gehörte auch die Überprüfung der 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.

Asynchrone Fehler

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

Neuen Instanztyp hinzufügen

Sie können die Catalog 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 bestehenden Produkten 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 eingeschränkten Liste 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 stellt keinen permanenten eingeschränkten Status für ein Produkt dar.

Bei Produkten mit interner Abrechnung müssen Verkäufer separate Änderungsarten aufrufen 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

Unten wird nur der AddInstanceTypes Änderungstyp angezeigt. Obwohl das AMI intern abgerechnet wird, müssen Verkäufer anrufen AddInstanceTypes und den Typ 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 ein, um den AddInstanceTypes Ä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örte auch die Überprüfung der 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. AddInstanceTypes 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 AddInstanceTypes 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.

Einen Instanztyp einschränken

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

Bestehende Abonnenten sind von dieser Änderung nicht betroffen und können die eingeschränkten Instanztypen verwenden. Allerdings werden keine neuen Käufer 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 die Instanztypen auf alle Versionen im Produktdokument ein. Beim AddInstanceTypes Änderungstyp aktualisieren Sie alle Versionen des Produkts. Sie werden die empfohlenen Instanztypen nicht einschränken können. Der empfohlene Instanztyp ist auf Versionsebene, daher ist es möglich, dass der Verkäufer nicht in der Lage ist, mehrere Instanztypen einzuschränken.

Bei einem Produkt, das intern berechnet wird, musst du beim Anruf separate Änderungstypen aufrufenRestrictDimensions. Dadurch wird verhindert, dass neue Angebote für die eingeschränkten Instanztypen erstellt werden.

Um die für Ihr AMI-based Produkt verfügbaren Instanztypen 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 ein, 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. Dazu gehörte auch die Überprüfung der 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. RestrictInstanceTypes 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 RestrictInstanceTypes 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.