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 di AWS Marketplace. Untuk informasi selengkapnya tentang menambahkan versi AMI baru ke produk Anda menggunakan Portal 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 akses AWS Marketplace 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 Memberikan akses AWS Marktplace ke AMI Anda di Panduan Pen AWS Marketplace jual.

Untuk menambahkan versi baru, panggil operasi StartChangeSet API dengan tipe 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 parameter keVALIDATE. Untuk informasi selengkapnya, lihat Intent.

Minta 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 masukan yang Anda gunakan dengan jenis AddDeliveryOptions perubahan. Semua bidang wajib diisi kecuali dinyatakan lain. Untuk informasi selengkapnya tentang bidang ini, lihat Men ambahkan versi baru di Panduan AWS Marketplace Penjual.

Sintaks Respons

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

{
  "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 memakan waktu mulai dari beberapa menit hingga beberapa jam.

Anda dapat memeriksa status permintaan melalui Portal Manajemen AWS Marketplace, atau langsung melalui Katalog API 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 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 Pen AWS Marketplace jual.

Kesalahan Asinkron

Kesalahan berikut khusus untuk AddDeliveryOptions tindakan di AWS Marketplace Catalog API. Kesalahan ini dikembalikan saat Anda memang DescribeChangeSet gil setelah set perubahan diproses. Untuk informasi selengkapnya tentang menggunakan DescribeChangeSet untuk mendapatkan status permintaan perubahan, lihatBekerja dengan set perubahan.

Anda juga dapat membuat AMI-based produk menggunakan Portal 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, Meng otomatisasi pembaruan untuk 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 di AWS 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 tipe UpdateDeliveryOptions perubahan, seperti yang ditunjukkan pada contoh berikut.

Minta 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 bidang masukan yang Anda berikan untuk menambahkan jenis UpdateDeliveryOptions perubahan. Untuk informasi selengkapnya tentang bidang ini, lihat Memperbarui informasi versi di Panduan AWS Marketplace Penjual.

Sintaks Respons

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

{
  "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 memakan waktu mulai dari beberapa menit hingga beberapa jam.

Anda dapat memeriksa status permintaan melalui Portal Manajemen AWS Marketplace, atau langsung melalui Katalog API 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 di AWS Marketplace Catalog API. Kesalahan ini dikembalikan saat Anda memang DescribeChangeSet gil setelah set perubahan diproses. Untuk informasi selengkapnya tentang menggunakan 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 masalahUbah status dan kesalahan yang disetel, lihat, 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 sudah 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 tipe RestrictDeliveryOptions perubahan, seperti yang ditunjukkan pada contoh berikut.

Minta 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 bidang masukan yang Anda berikan untuk menambahkan jenis RestrictDeliveryOptions perubahan:

Sintaks Respons

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

{
  "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 memakan waktu mulai dari beberapa menit hingga beberapa jam.

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

Kesalahan Asinkron

Kesalahan berikut khusus untuk RestrictDeliveryOptions tindakan di AWS Marketplace Catalog API. Kesalahan ini dikembalikan saat Anda memang DescribeChangeSet gil setelah set perubahan diproses. Untuk informasi selengkapnya tentang menggunakan DescribeChangeSet untuk mendapatkan status permintaan perubahan, lihatBekerja dengan set perubahan.

Perbarui masa depan Wilayah AWS dukungan

Anda dapat menggunakan API Katalog untuk mengubah preferensi Wilayah AWS dukungan masa depan untuk AMI-based produk Anda di AWS Marketplace.

Untuk mengubah preferensi Wilayah AWS dukungan di masa mendatang, StartChangeSet panggil operasi API dengan jenis UpdateFutureRegionSupport perubahan, seperti yang ditunjukkan pada contoh berikut.

Minta 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 Respons

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

{
  "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 memakan waktu mulai dari beberapa menit hingga beberapa jam.

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

Kesalahan Asinkron

Kesalahan berikut khusus untuk UpdateFutureRegionSupport tindakan di AWS Marketplace Catalog API. Kesalahan ini dikembalikan saat Anda memang DescribeChangeSet gil setelah set perubahan diproses. Untuk informasi selengkapnya tentang menggunakan DescribeChangeSet untuk mendapatkan status permintaan perubahan, lihatBekerja dengan set perubahan.

Tambahkan yang didukung Wilayah AWS

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

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

Minta 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 Respons

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

{
  "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 memakan waktu mulai dari beberapa menit hingga beberapa jam.

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

Kesalahan Asinkron

Kesalahan berikut khusus untuk AddRegions tindakan di AWS Marketplace Catalog API. Kesalahan ini dikembalikan saat Anda memang DescribeChangeSet gil setelah set perubahan diproses. Untuk informasi selengkapnya tentang menggunakan DescribeChangeSet untuk mendapatkan status permintaan perubahan, lihatBekerja dengan set perubahan.

Batasi Wilayah AWS

Anda dapat menggunakan API Katalog untuk membatasi dukungan sebelumnya Wilayah AWS untuk AMI-based produk Anda di AWS Marketplace.

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

Minta 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 Respons

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

{
  "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 memakan waktu mulai dari beberapa menit hingga beberapa jam.

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

Kesalahan Asinkron

Kesalahan berikut khusus untuk AddRegions tindakan di AWS Marketplace Catalog API. Kesalahan ini dikembalikan saat Anda memang DescribeChangeSet gil setelah set perubahan diproses. Untuk informasi selengkapnya tentang menggunakan 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 Anda di AWS 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 jenis instans terbatas, jenis instans dapat dihapus dari daftar terbatas dan ditambahkan ke daftar jenis instans yang tersedia. Ini memberi penjual lebih banyak kontrol untuk mengubah pembatasan produk mereka. Daftar jenis instans dapat dipertukarkan dan bukan status terbatas permanen untuk suatu produk.

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

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

Minta Sintaks

Hanya jenis AddInstanceTypes perubahan yang ditunjukkan di bawah ini. Meskipun penjual AMI yang diukur secara internal diharuskan untuk menelep AddInstanceTypes on dan UpdatePricingTerms mengubah jenis 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 Respons

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

{
  "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 memakan waktu mulai dari beberapa menit hingga beberapa jam.

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

Validasi Sinkron

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

Kesalahan Asinkron

Kesalahan berikut khusus untuk AddInstanceTypes tindakan di AWS Marketplace Catalog API. Kesalahan ini dikembalikan saat Anda memang DescribeChangeSet gil setelah set perubahan diproses. Untuk informasi selengkapnya tentang menggunakan DescribeChangeSet untuk mendapatkan status permintaan perubahan, lihatBekerja dengan set perubahan.

Membatasi jenis instance

Anda dapat menggunakan API Katalog untuk membatasi atau membatasi jenis instans yang tersedia untuk AMI-based produk Anda di 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 Oper AWS Marketplace asi Penjual.

RestrictInstanctTypesmembatasi jenis instans ke 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 berada di tingkat versi, jadi ada kemungkinan penjual tidak dapat membatasi beberapa jenis instans.

Untuk produk terukur secara internal, Anda perlu memang RestrictDimensions gil jenis perubahan terpisah saat menelepon. Ini mencegah penawaran baru dibuat untuk jenis instans terbatas.

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

Minta 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 Respons

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

{
  "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 memakan waktu mulai dari beberapa menit hingga beberapa jam.

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

Validasi Sinkron

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

Kesalahan Asinkron

Kesalahan berikut khusus untuk RestrictInstanceTypes tindakan di AWS Marketplace Catalog API. Kesalahan ini dikembalikan saat Anda memang DescribeChangeSet gil setelah set perubahan diproses. Untuk informasi selengkapnya tentang menggunakan DescribeChangeSet untuk mendapatkan status permintaan perubahan, lihatBekerja dengan set perubahan.