Referensi API AWS Marketplace direstrukturisasi. Untuk informasi selengkapnya tentang operasi API yang didukung, lihat Referensi API AWS Marketplace.

Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

Bekerja dengan AMI-based produk

Anda dapat menggunakan AWS Marketplace Catalog API untuk mengotomatiskan tugas untuk bekerja dengan produk berbasis Amazon Machine Image (AMI).

Untuk informasi tentang membuat AMI-based produk menggunakan API Katalog, lihatBuat produk.

Topik berikut menjelaskan cara menggunakan API Katalog untuk melakukan tindakan pada AMI-based produk Anda:

Tambahkan versi baru

Anda dapat menggunakan API Katalog untuk menambahkan versi baru ke AMI-based produk yang sudah ada diAWS Marketplace. Untuk informasi selengkapnya tentang menambahkan versi AMI baru ke produk Anda menggunakanPortal Manajemen AWS Marketplace, lihat Menambahkan versi baru di Panduan AWS Marketplace Penjual.

Saat Anda membuat permintaan yang mencakup penambahan AMI baru ke AWS Marketplace, AMI harus disalin ke sistem AWS Marketplace dan kemudian dipindai untuk masalah keamanan. Anda harus memberikan AWS Marketplace akses ke AMI dengan membuat peran AWS Identity and Access Management (IAM) dengan izin untuk melakukan tindakan pada AMI Anda. Untuk informasi selengkapnya tentang izin yang diperlukan, lihat Memberi AWS Marktplace akses ke AMI Anda di Panduan Penjual. AWS Marketplace

Untuk menambahkan versi baru, panggil operasi StartChangeSet API dengan jenis AddDeliveryOptions perubahan untuk AMI-based produk, seperti yang ditunjukkan pada contoh berikut. Untuk menguji panggilan API Anda tanpa benar-benar membuat versi baru, setel Intent parameternya keVALIDATE. Untuk informasi selengkapnya, lihat Maksud.

Permintaan Sintaks

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"
}

Daftar berikut memberikan informasi tentang bidang input yang Anda gunakan dengan jenis AddDeliveryOptions perubahan. Semua bidang diperlukan kecuali dinyatakan lain. Untuk informasi selengkapnya tentang bidang ini, lihat Menambahkan versi baru di Panduan AWS Marketplace Penjual.

Sintaks Respon

Set perubahan dibuat untuk permintaan Anda. Respons terhadap permintaan ini memberi Anda ChangeSetId dan ChangeSetArn untuk set perubahan dan terlihat seperti berikut.

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

Permintaan perubahan ditambahkan ke antrian dan diproses. Ini termasuk memvalidasi informasi untuk memastikannya memenuhi AWS Marketplace pedoman. Proses validasi dapat berlangsung dari beberapa menit hingga beberapa jam.

Anda dapat memeriksa status permintaan melaluiPortal Manajemen AWS Marketplace, atau langsung melalui API Katalog menggunakan operasi DescribeChangeSet API.

Untuk informasi selengkapnya tentang kesalahan dalam set perubahan produk penjual, lihatUbah status dan kesalahan yang disetel.

Ketika permintaan selesai, versi ditambahkan, dan setiap pelanggan yang ada akan menerima pesan email yang memberi tahu mereka tentang versi baru. Untuk informasi selengkapnya tentang proses menambahkan versi baru, lihat Menambahkan versi baru di Panduan AWS Marketplace Penjual.

Kesalahan Asinkron

Kesalahan berikut khusus untuk AddDeliveryOptions tindakan diAWS Marketplace Catalog API. Kesalahan ini dikembalikan saat Anda memanggil DescribeChangeSet setelah set perubahan diproses. Untuk informasi selengkapnya tentang penggunaan DescribeChangeSet untuk mendapatkan status permintaan perubahan, lihatBekerja dengan set perubahan.

Anda juga dapat membuat AMI-based produk menggunakanPortal Manajemen AWS Marketplace. Untuk informasi selengkapnya, lihat produk AMI di Panduan AWS Marketplace Penjual.

Untuk panduan yang menunjukkan cara mengotomatiskan pembaruan AMI-based produk Anda, Anda juga dapat merujuk ke video, Mengotomatiskan pembaruan ke daftar produk Anda AWS Marketplace dengan API Katalog (5:08).

Perbarui informasi versi

Anda dapat menggunakan API Katalog untuk memperbarui detail versi AMI-based produk yang ada diAWS Marketplace.

Anda tidak dapat memperbarui AMI untuk versi tersebut. Jika Anda perlu memperbarui AMI, buat versi baru sebagai gantinya.

Untuk menambahkan versi baru, panggil operasi StartChangeSet API dengan jenis UpdateDeliveryOptions perubahan, seperti yang ditunjukkan pada contoh berikut.

Permintaan Sintaks

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."
              }
            }
          }
        ]
      }
    }
  ]
}

Berikut ini adalah informasi tentang kolom input yang Anda berikan untuk menambahkan jenis UpdateDeliveryOptions perubahan. Untuk informasi selengkapnya tentang bidang ini, lihat Memperbarui informasi versi di Panduan AWS Marketplace Penjual.

Sintaks Respon

Set perubahan dibuat untuk permintaan Anda. Respons terhadap permintaan ini memberi Anda ChangeSetId dan ChangeSetArn untuk set perubahan dan terlihat seperti berikut.

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

Permintaan perubahan ditambahkan ke antrian dan diproses. Ini termasuk memvalidasi informasi untuk memastikannya memenuhi AWS Marketplace pedoman. Proses validasi dapat berlangsung dari beberapa menit hingga beberapa jam.

Anda dapat memeriksa status permintaan melaluiPortal Manajemen AWS Marketplace, atau langsung melalui API Katalog menggunakan operasi DescribeChangeSet API.

Untuk informasi selengkapnya tentang set perubahan, lihatBekerja dengan set perubahan. Untuk informasi selengkapnya tentang kesalahan dalam set perubahan produk penjual, lihatUbah status dan kesalahan yang disetel.

Kesalahan Asinkron

Kesalahan berikut khusus untuk UpdateDeliveryOptions tindakan diAWS Marketplace Catalog API. Kesalahan ini dikembalikan saat Anda memanggil DescribeChangeSet setelah set perubahan diproses. Untuk informasi selengkapnya tentang penggunaan DescribeChangeSet untuk mendapatkan status permintaan perubahan, lihatBekerja dengan set perubahan.

Anda dapat mengambil UpdatePricingTerms tindakan dengan menggunakan DescribeChangeSet operasi setelah set perubahan mulai diproses. Untuk informasi selengkapnya tentang detail kesalahan dan pemecahan masalah, lihatUbah status dan kesalahan yang disetel, sebelumnya dalam panduan ini.

Batasi versi

Anda dapat menggunakan API Katalog untuk membatasi versi AMI-based produk Anda. Ini mencegah pembeli baru menggunakan versi itu, tetapi membuatnya tetap tersedia untuk pembeli yang ada. Membatasi semua opsi pengiriman dari versi membatasi versi. Membatasi satu atau lebih, tetapi tidak semua, opsi pengiriman dari versi membatasi hanya opsi pengiriman dalam versi itu. Anda harus selalu memiliki setidaknya satu versi produk yang tidak terbatas yang tersedia, sehingga Anda tidak dapat membatasi versi produk terakhir yang tersedia untuk umum.

Untuk membatasi versi, panggil operasi StartChangeSet API dengan jenis RestrictDeliveryOptions perubahan, seperti yang ditunjukkan pada contoh berikut.

Permintaan Sintaks

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"
        ]
      }
    }
  ]
}

Berikut ini adalah informasi tentang kolom input yang Anda berikan untuk menambahkan jenis RestrictDeliveryOptions perubahan:

Sintaks Respon

Set perubahan dibuat untuk permintaan Anda. Respons terhadap permintaan ini memberi Anda ChangeSetId dan ChangeSetArn untuk set perubahan dan terlihat seperti berikut.

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

Permintaan perubahan ditambahkan ke antrian dan diproses. Ini termasuk memvalidasi informasi untuk memastikannya memenuhi AWS Marketplace pedoman. Proses validasi dapat berlangsung dari beberapa menit hingga beberapa jam.

Anda dapat memeriksa status permintaan melaluiPortal Manajemen AWS Marketplace, atau langsung melalui API Katalog menggunakan operasi DescribeChangeSet API.

Kesalahan Asinkron

Kesalahan berikut khusus untuk RestrictDeliveryOptions tindakan diAWS Marketplace Catalog API. Kesalahan ini dikembalikan saat Anda memanggil DescribeChangeSet setelah set perubahan diproses. Untuk informasi selengkapnya tentang penggunaan DescribeChangeSet untuk mendapatkan status permintaan perubahan, lihatBekerja dengan set perubahan.

Perbarui futureWilayah AWSdukungan

Anda dapat menggunakan Catalog API untuk mengubah preferensi Wilayah AWS dukungan future untuk AMI-based produk Anda diAWS Marketplace.

Untuk mengubah preferensi Wilayah AWS dukungan future, panggil operasi StartChangeSet API dengan tipe UpdateFutureRegionSupport perubahan, seperti yang ditunjukkan pada contoh berikut.

Permintaan Sintaks

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"
          ]
        }
      }
    }
  ]
}

Berikan informasi untuk bidang untuk menambahkan jenis UpdateFutureRegionSupport perubahan:

Sintaks Respon

Set perubahan dibuat untuk permintaan Anda. Respons terhadap permintaan ini memberi Anda ChangeSetId dan ChangeSetArn untuk set perubahan dan terlihat seperti berikut.

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

Permintaan perubahan ditambahkan ke antrian dan diproses. Ini termasuk memvalidasi informasi untuk memastikannya memenuhi AWS Marketplace pedoman. Proses validasi dapat berlangsung dari beberapa menit hingga beberapa jam.

Anda dapat memeriksa status permintaan melaluiPortal Manajemen AWS Marketplace, atau langsung melalui API Katalog menggunakan operasi DescribeChangeSet API.

Kesalahan Asinkron

Kesalahan berikut khusus untuk UpdateFutureRegionSupport tindakan diAWS Marketplace Catalog API. Kesalahan ini dikembalikan saat Anda memanggil DescribeChangeSet setelah set perubahan diproses. Untuk informasi selengkapnya tentang penggunaan DescribeChangeSet untuk mendapatkan status permintaan perubahan, lihatBekerja dengan set perubahan.

Tambahkan yang didukungWilayah AWS

Anda dapat menggunakan API Katalog untuk menambahkan dukungan baru Wilayah AWS untuk AMI-based produk Anda diAWS Marketplace.

Untuk menambahkan Wilayah baru yang didukung, panggil operasi StartChangeSet API dengan jenis AddRegions perubahan, seperti yang ditunjukkan pada contoh berikut.

Permintaan Sintaks

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"
      }
    }
  ]
}

Berikan informasi untuk bidang untuk menambahkan jenis AddRegions perubahan.

Sintaks Respon

Set perubahan dibuat untuk permintaan Anda. Respons terhadap permintaan ini memberi Anda ChangeSetId dan ChangeSetArn untuk set perubahan dan terlihat seperti berikut.

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

Permintaan perubahan ditambahkan ke antrian dan diproses. Ini termasuk memvalidasi informasi untuk memastikannya memenuhi AWS Marketplace pedoman. Proses validasi dapat berlangsung dari beberapa menit hingga beberapa jam.

Anda dapat memeriksa status permintaan melaluiPortal Manajemen AWS Marketplace, atau langsung melalui API Katalog menggunakan operasi DescribeChangeSet API.

Kesalahan Asinkron

Kesalahan berikut khusus untuk AddRegions tindakan diAWS Marketplace Catalog API. Kesalahan ini dikembalikan saat Anda memanggil DescribeChangeSet setelah set perubahan diproses. Untuk informasi selengkapnya tentang penggunaan DescribeChangeSet untuk mendapatkan status permintaan perubahan, lihatBekerja dengan set perubahan.

BatasiWilayah AWS

Anda dapat menggunakan API Katalog untuk membatasi sebelumnya yang didukung Wilayah AWS untuk AMI-based produk Anda diAWS Marketplace.

Untuk membatasi Wilayah yang didukung sebelumnya, panggil operasi StartChangeSet API dengan tipe RestrictRegions perubahan, seperti yang ditunjukkan pada contoh berikut.

Permintaan Sintaks

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"
      }
    }
  ]
}

Berikan informasi untuk bidang untuk menambahkan jenis AddRegions perubahan.

Sintaks Respon

Set perubahan dibuat untuk permintaan Anda. Respons terhadap permintaan ini memberi Anda ChangeSetId dan ChangeSetArn untuk set perubahan dan terlihat seperti berikut.

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

Permintaan perubahan ditambahkan ke antrian dan diproses. Ini termasuk memvalidasi informasi untuk memastikannya memenuhi AWS Marketplace pedoman. Proses validasi dapat berlangsung dari beberapa menit hingga beberapa jam.

Anda dapat memeriksa status permintaan melaluiPortal Manajemen AWS Marketplace, atau langsung melalui API Katalog menggunakan operasi DescribeChangeSet API.

Kesalahan Asinkron

Kesalahan berikut khusus untuk AddRegions tindakan diAWS Marketplace Catalog API. Kesalahan ini dikembalikan saat Anda memanggil DescribeChangeSet setelah set perubahan diproses. Untuk informasi selengkapnya tentang penggunaan DescribeChangeSet untuk mendapatkan status permintaan perubahan, lihatBekerja dengan set perubahan.

Menambahkan jenis instance baru

Anda dapat menggunakan API Katalog untuk menambahkan jenis instans baru untuk AMI-based produk AndaAWS Marketplace.

AddInstanceTypesakan menambahkan jenis instance baru ke produk yang ada dan produk yang baru dibuat saat membuat produk. Jenis perubahan akan memperbarui semua versi dalam dokumen produk dengan jenis instance baru.

Saat menambahkan tipe instans terbatas, tipe instance dapat dihapus dari daftar terbatas dan ditambahkan ke daftar tipe instance yang tersedia. Ini memberi penjual lebih banyak kontrol untuk mengubah pembatasan produk mereka. Daftar tipe instance dapat dipertukarkan dan bukan status terbatas permanen untuk suatu produk.

Untuk produk yang diukur secara internal, penjual perlu memanggil jenis perubahan terpisah AddDimensions dan memperbarui harga UpdatePricingTerms untuk jenis instans.

Untuk menambahkan jenis instance baru, panggil operasi StartChangeSet API dengan tipe RestrictRegions perubahan, seperti yang ditunjukkan pada contoh berikut.

Permintaan Sintaks

Hanya jenis AddInstanceTypes perubahan yang ditunjukkan di bawah ini. Meskipun penjual AMI yang diukur secara internal diharuskan untuk menelepon AddInstanceTypes dan UpdatePricingTerms mengubah tipe untuk AMI mereka.

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"
        ]
      }
    }
  ]
}

Berikan informasi untuk bidang untuk menambahkan jenis AddInstanceTypes perubahan:

Sintaks Respon

Set perubahan dibuat untuk permintaan Anda. Respons terhadap permintaan ini memberi Anda ChangeSetId dan ChangeSetArn untuk set perubahan dan terlihat seperti berikut.

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

Permintaan perubahan ditambahkan ke antrian dan diproses. Ini termasuk memvalidasi informasi untuk memastikannya memenuhi AWS Marketplace pedoman. Proses validasi dapat berlangsung dari beberapa menit hingga beberapa jam.

Anda dapat memeriksa status permintaan melaluiPortal Manajemen AWS Marketplace, atau langsung melalui API Katalog menggunakan operasi DescribeChangeSet API.

Validasi sinkron

Validasi skema berikut khusus untuk AddInstanceTypes tindakan di. AWS Marketplace Catalog API Validasi ini dilakukan saat Anda menelepon. StartChangeSet Jika permintaan tidak memenuhi persyaratan berikut, itu akan gagal dengan respons HTTP.

Kesalahan Asinkron

Kesalahan berikut khusus untuk AddInstanceTypes tindakan diAWS Marketplace Catalog API. Kesalahan ini dikembalikan saat Anda memanggil DescribeChangeSet setelah set perubahan diproses. Untuk informasi selengkapnya tentang penggunaan DescribeChangeSet untuk mendapatkan status permintaan perubahan, lihatBekerja dengan set perubahan.

Batasi jenis instance

Anda dapat menggunakan API Katalog untuk membatasi atau membatasi jenis instans yang tersedia untuk AMI-based produk Anda. AWS Marketplace

Pelanggan yang ada tidak akan terpengaruh oleh perubahan ini dan mereka dapat menggunakan jenis instans terbatas. Namun, tidak ada pembeli baru yang dapat menggunakan jenis instans terbatas. Untuk menghentikan langganan jenis instans saat ini (setelah jenis instans dibatasi), Anda harus menghubungi Tim Operasi AWS Marketplace Penjual.

RestrictInstanctTypesmembatasi jenis instance untuk semua versi dalam dokumen produk. Dalam jenis AddInstanceTypes perubahan, Anda memperbarui semua versi produk. Anda tidak akan dapat membatasi jenis instans yang direkomendasikan. Jenis instans yang disarankan ada di tingkat versi, jadi ada kemungkinan penjual tidak akan dapat membatasi beberapa jenis instance.

Untuk produk yang diukur secara internal, Anda perlu memanggil jenis perubahan terpisah saat menelepon. RestrictDimensions Ini mencegah penawaran baru dibuat untuk jenis instans terbatas.

Untuk membatasi atau membatasi jenis instance yang tersedia untuk AMI-based produk Anda, panggil operasi StartChangeSet API dengan tipe RestrictInstanceTypes perubahan, seperti yang ditunjukkan pada contoh berikut.

Permintaan Sintaks

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"
        ]
      }
    }
  ]
}

Berikan informasi untuk bidang untuk menambahkan jenis RestrictInstanceTypes perubahan.

Sintaks Respon

Set perubahan dibuat untuk permintaan Anda. Respons terhadap permintaan ini memberi Anda ChangeSetId dan ChangeSetArn untuk set perubahan dan terlihat seperti berikut.

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

Permintaan perubahan ditambahkan ke antrian dan diproses. Ini termasuk memvalidasi informasi untuk memastikannya memenuhi AWS Marketplace pedoman. Proses validasi dapat berlangsung dari beberapa menit hingga beberapa jam.

Anda dapat memeriksa status permintaan melaluiPortal Manajemen AWS Marketplace, atau langsung melalui API Katalog menggunakan operasi DescribeChangeSet API.

Validasi sinkron

Validasi skema berikut khusus untuk RestrictInstanceTypes tindakan di. AWS Marketplace Catalog API Validasi ini dilakukan saat Anda menelepon. StartChangeSet Jika permintaan tidak memenuhi persyaratan berikut, itu akan gagal dengan respons HTTP.

Kesalahan Asinkron

Kesalahan berikut khusus untuk RestrictInstanceTypes tindakan diAWS Marketplace Catalog API. Kesalahan ini dikembalikan saat Anda memanggil DescribeChangeSet setelah set perubahan diproses. Untuk informasi selengkapnya tentang penggunaan DescribeChangeSet untuk mendapatkan status permintaan perubahan, lihatBekerja dengan set perubahan.