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 set penawaran
Kumpulan penawaran AWS Marketplace memungkinkan penjual untuk mengemas beberapa penawaran pribadi ke dalam paket transaksikan multi-produk terpadu untuk pembeli. Kemampuan ini memenuhi permintaan pelanggan yang terus meningkat akan solusi menyeluruh dan menyeluruh di lingkungan perusahaan yang kompleks.
Secara tradisional, pembeli harus menemukan dan mendapatkan produk individual dari beberapa penjual, menghasilkan pengalaman yang terfragmentasi, tantangan integrasi, dan siklus pengadaan yang lebih lama. Kumpulan penawaran menyederhanakan hal ini dengan memungkinkan mitra AWS Marketplace untuk menggabungkan beberapa penawaran bersama-sama, merampingkan proses transaksi melalui penawaran pribadi terkoordinasi di mana pelanggan dapat meninjau dan menerima semua komponen dengan persetujuan satu kali.
Set penawaran bekerja sama dengan solusi untuk memberikan penawaran multi-produk yang komprehensif. Solusi menyediakan konten pemasaran yang kaya termasuk deskripsi terperinci, diagram arsitektur, dan dokumentasi kasus penggunaan, sementara set penawaran menangani kemasan yang dapat ditransaksikan dan persyaratan komersial untuk pengadaan terpadu.
Menawarkan entitas set
Set penawaran adalah wadah yang mengelompokkan 2-7 penawaran pribadi ke dalam satu paket yang dapat ditransaksikan. Setiap penawaran dalam satu set penawaran mempertahankan harga, ketentuan pembayaran, durasi, dan Perjanjian Lisensi Pengguna Akhir (EULA) yang berbeda, sementara set penawaran memberikan pengalaman penemuan dan penerimaan terpadu bagi pembeli.
Karakteristik utama:
Kelompokkan beberapa penawaran pribadi (minimal 2, maksimum 7)
Memungkinkan penerimaan pembeli terpadu dari semua penawaran dengan satu tindakan
Mempertahankan fleksibilitas dengan persyaratan yang berbeda untuk setiap penawaran
Membuat perjanjian terpisah untuk setiap produk, memungkinkan manajemen independen setelah pembelian
Dapat dikaitkan secara opsional dengan solusi untuk konten pemasaran yang disempurnakan
Jenis entitas set penawaran adalahOfferSet@1.0.
Pengidentifikasi entitas
Set penawaran menggunakan format offerset-* pengenal (misalnya,offerset-abc123def456).
Format ARN entitas
Set penawaran mengikuti format AWS ARN standar:
arn:aws:aws-marketplace:{region}:{account-id}:AWSMarketplace/OfferSet/{offerset-id}
Contoh:
arn:aws:aws-marketplace:us-east-1:123456789012:AWSMarketplace/OfferSet/offerset-abc123def456
Memulai dengan set penawaran
Bagian ini memberikan informasi terperinci tentang membuat dan mengelola set penawaran menggunakan tipe perubahan API AWS Marketplace Katalog.
Sebelum Anda mulai, pastikan Anda memiliki:
Pendaftaran penjual AWS Marketplace yang valid dan profil publik. Untuk informasi selengkapnya, lihat Mendaftar dan membuat profil penjual Anda.
Akses ke API dan prasyarat penjual yang lengkap. Untuk informasi selengkapnya, lihat Kontrol akses untuk AWS Marketplace Catalog API.
Mempelajari dasar-dasar penggunaan AWS Marketplace Catalog API, lihat Menggunakan AWS Marketplace Catalog API.
Daftar set penawaran
Untuk mencantumkan semua set penawaran di akun Anda, panggil operasi ListEntities API dengan EntityType disetel keOfferSet.
Permintaan
POST /ListEntities HTTP/1.1 Content-type: application/json { "Catalog": "AWSMarketplace", "EntityType": "OfferSet" }
Respons
{ "EntitySummaryList": [ { "EntityType": "OfferSet", "EntityId": "offerset-xyz123", "EntityArn": "arn:aws:aws-marketplace:us-east-1:123456789012:AWSMarketplace/OfferSet/offerset-xyz123", "LastModifiedDate": "2025-06-25T23:46:25Z", "OfferSetSummary": { "Name": "Enterprise Security Solution Offer Set", "State": "Released", "ReleaseDate": "2025-06-25T23:46:20Z", "SolutionId": "soln-abc987", "AssociatedOfferIds": [ "offer-abc123", "offer-def456", "offer-ghi789" ] } } ], "NextToken": null }
Filter penawaran set menurut negara
Anda dapat memfilter set penawaran berdasarkan status menggunakan EntityTypeFilters parameter.
Permintaan
POST /ListEntities HTTP/1.1 Content-type: application/json { "Catalog": "AWSMarketplace", "EntityType": "OfferSet", "EntityTypeFilters": { "OfferSetFilters": { "State": { "ValueList": [ "Released" ] } } } }
Filter set penawaran berdasarkan ID solusi
Anda dapat memfilter set penawaran berdasarkan ID solusi menggunakan EntityTypeFilters parameter.
Permintaan
POST /ListEntities HTTP/1.1 Content-type: application/json { "Catalog": "AWSMarketplace", "EntityType": "OfferSet", "EntityTypeFilters": { "OfferSetFilters": { "SolutionId": { "ValueList": [ "soln-abc987" ] } } } }
Filter set penawaran berdasarkan tanggal rilis
Anda dapat memfilter set penawaran berdasarkan tanggal rilis dan mengurutkan hasil menggunakan EntityTypeSort parameter EntityTypeFilters dan.
Permintaan
POST /ListEntities HTTP/1.1 Content-type: application/json { "Catalog": "AWSMarketplace", "EntityType": "OfferSet", "EntityTypeFilters": { "OfferSetFilters": { "ReleaseDate": { "AfterValue": "2025-11-01" } } }, "EntityTypeSort": { "OfferSetSort": { "SortBy": "ReleaseDate", "SortOrder": "DESCENDING" } } }
Jelaskan set penawaran
Untuk mendapatkan informasi rinci tentang set penawaran tertentu, hubungi operasi DescribeEntity API.
Permintaan
GET /DescribeEntity?catalog=AWSMarketplace&entityId=offerset-xyz123 HTTP/1.1
Respons
{ "EntityType": "OfferSet@1.0", "EntityId": "offerset-xyz123", "EntityArn": "arn:aws:aws-marketplace:us-east-1:123456789012:AWSMarketplace/OfferSet/offerset-xyz123", "LastModifiedDate": "2025-06-25T23:46:25Z", "DetailsDocument": { "Id": "offerset-xyz123", "Name": "Enterprise Security Solution Offer Set", "BuyerNotes": "Complete security solution including endpoint protection and network monitoring", "State": "Released", "SolutionId": "soln-abc987", "ReleaseDate": "2025-06-25T23:46:20Z", "AssociatedOffers": [ { "OfferId": "offer-abc123" }, { "OfferId": "offer-def456" }, { "OfferId": "offer-ghi789" } ] } }
Buat set penawaran
Gunakan jenis CreateOfferSet perubahan untuk membuat entitas set penawaran baru dalam status Draf. Ini adalah langkah pertama dalam siklus hidup set penawaran, menetapkan entitas dasar yang nantinya akan dikonfigurasi dengan asosiasi penawaran dan metadata sebelum dirilis ke pembeli.
Permintaan Sintaks
POST /StartChangeSet HTTP/1.1 Content-type: application/json { "Catalog": "AWSMarketplace", "ChangeSet": [ { "ChangeType": "CreateOfferSet", "Entity": { "Type": "OfferSet@1.0" }, "ChangeName": "CreateOfferSetChange", "DetailsDocument": { "Name": "Enterprise Security Solution Offer Set" } } ] }
Berikan informasi untuk bidang untuk menambahkan jenis CreateOfferSet perubahan:
Entity(object) (required) - Jenis entitas yang sedang dibuat.Type(string) (wajib) - HarusOfferSet@1.0.
DetailsDocument(objek) (wajib) — Rincian permintaan.Name(string) (wajib) — Nama yang terkait dengan penawaran ditetapkan untuk keterbacaan yang lebih baik bagi Anda dan pelanggan Anda. Panjang minimum: 1 karakter. Panjang maksimum: 150 karakter.
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 memastikan bahwa informasi tersebut memenuhi pedoman AWS Marketplace. Proses validasi dapat memakan waktu beberapa menit.
Anda dapat memeriksa status permintaan melalui AWS Marketplace Management Portal, atau langsung melalui Catalog API menggunakan operasi DescribeChangeSet API.
Setelah pemrosesan berhasil, buat AWS Marketplace penawaran yang ditetapkan dalam status Draf dengan pengenal unik yang diawali dengan. offerset-
Perbarui informasi set penawaran
Gunakan jenis UpdateInformation perubahan untuk memodifikasi rincian set penawaran yang ada, termasuk nama dan catatan pembeli.
Permintaan Sintaks
POST /StartChangeSet HTTP/1.1 Content-type: application/json { "Catalog": "AWSMarketplace", "ChangeSet": [ { "ChangeType": "UpdateInformation", "Entity": { "Type": "OfferSet@1.0", "Identifier": "offerset-abc123" }, "DetailsDocument": { "Name": "Updated Enterprise Security Offer Set", "BuyerNotes": "Complete security solution including endpoint protection, network monitoring, and professional services implementation" } } ] }
Berikan informasi untuk bidang untuk menambahkan jenis UpdateInformation perubahan:
Entity(objek) (wajib) - Entitas yang diperbarui.Identifier(string) (wajib) - ID set penawaran Anda. Untuk informasi selengkapnya, lihat Pengidentifikasi.Type(string) (wajib) - HarusOfferSet@1.0.
DetailsDocument(objek) (wajib) - Setidaknya satu bidang harus disediakan.Name(string) (opsional) - Nama tampilan terlihat oleh pembeli. Panjang minimum: 1 karakter. Panjang maksimum: 150 karakter.BuyerNotes(string) (opsional) — Informasi terperinci tentang set penawaran yang membantu pembeli memahami tujuan dan isinya. Panjang minimum: 1 karakter. Panjang maksimum: 1.000 karakter.
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 memastikan bahwa informasi tersebut memenuhi pedoman AWS Marketplace. Proses validasi dapat memakan waktu beberapa menit.
Anda dapat memeriksa status permintaan melalui AWS Marketplace Management Portal, atau langsung melalui Catalog API menggunakan operasi DescribeChangeSet API.
Mengaitkan penawaran dengan set penawaran
Gunakan jenis AssociateOffers perubahan untuk mengaitkan beberapa AWS Marketplace penawaran dengan set penawaran. Ini menciptakan hubungan antara penawaran dan set penawaran, menjadikan penawaran sebagai bagian dari konfigurasi transaksi set penawaran.
Operasi ini idempoten dan memungkinkan penawaran terkait terlepas dari keadaannya saat ini, memungkinkan konfigurasi lengkap sebelum penawaran individual dirilis. Setiap penawaran hanya dapat dimiliki oleh satu set penawaran.
penting
Penawaran individual tidak dapat diubah dan hanya dapat diatur selama pembuatan penawaran. OfferSetId Sebelum mengaitkan penawaran dengan penawaran yang digunakanAssociateOffers, Anda harus terlebih dahulu membuat penawaran individual dan menentukan OfferSetId selama pembuatan penawaran. Jika Anda perlu menyertakan penawaran yang sudah ada yang tidak benarOfferSetId, Anda harus membuat penawaran baru dengan yang OfferSetId ditentukan dengan benar.
Untuk informasi tentang izin IAM yang diperlukan, lihat. Izin IAM untuk set penawaran
Permintaan Sintaks
POST /StartChangeSet HTTP/1.1 Content-type: application/json { "Catalog": "AWSMarketplace", "ChangeSet": [ { "ChangeType": "AssociateOffers", "Entity": { "Type": "OfferSet@1.0", "Identifier": "offerset-abc123" }, "DetailsDocument": { "Offers": [ { "OfferId": "offer-xyz789" }, { "OfferId": "offer-def456" }, { "OfferId": "offer-ghi123" } ] } } ] }
Berikan informasi untuk bidang untuk menambahkan jenis AssociateOffers perubahan:
Entity(objek) (wajib) - Entitas yang diperbarui.Identifier(string) (wajib) - ID set penawaran Anda. Untuk informasi selengkapnya, lihat Pengidentifikasi.Type(string) (wajib) - HarusOfferSet@1.0.
DetailsDocument(objek) (wajib) — Rincian permintaan.Offers(array) (wajib) — Daftar AWS Marketplace penawaran untuk diasosiasikan. Minimal: 1 item. Maksimal: 7 item.OfferId(string) (wajib) — Pengenal AWS Marketplace penawaran. Panjang minimum: 1 karakter. Panjang maksimum: 36 karakter.
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 memastikan bahwa informasi tersebut memenuhi pedoman AWS Marketplace. Proses validasi dapat memakan waktu beberapa menit.
Anda dapat memeriksa status permintaan melalui AWS Marketplace Management Portal, atau langsung melalui Catalog API menggunakan operasi DescribeChangeSet API.
Kesalahan Asinkron
Kesalahan berikut khusus untuk AssociateOffers tindakan di API AWS Marketplace Katalog. 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.
| Kode kesalahan | Pesan kesalahan |
|---|---|
TOO_MANY_OFFERS |
Kaitkan hingga 7 penawaran ke set penawaran. |
INCOMPATIBLE_OFFER_SET_REFERENCE |
Pastikan semua penawaran dibuat khusus untuk set penawaran ini. |
INVALID_UPDATE_REQUEST |
Perubahan yang diminta tidak dapat dilakukan setelah set penawaran dirilis. |
Pisahkan penawaran dari satu set penawaran
Gunakan jenis DisassociateOffers perubahan untuk menghapus beberapa AWS Marketplace penawaran dari satu set penawaran. Operasi idempoten ini menghapus hubungan asosiasi sambil mempertahankan atribut penawaran. OfferSetId Penawaran yang tidak terkait menjadi tersembunyi dari penemuan pembeli sampai dikaitkan kembali dengan set penawaran yang sama. Mereka tidak dapat dikaitkan dengan set penawaran yang berbeda.
Permintaan Sintaks
POST /StartChangeSet HTTP/1.1 Content-type: application/json { "Catalog": "AWSMarketplace", "ChangeSet": [ { "ChangeType": "DisassociateOffers", "Entity": { "Type": "OfferSet@1.0", "Identifier": "offerset-abc123" }, "DetailsDocument": { "Offers": [ { "OfferId": "offer-xyz789" } ] } } ] }
Berikan informasi untuk bidang untuk menambahkan jenis DisassociateOffers perubahan:
Entity(objek) (wajib) - Entitas yang diperbarui.Identifier(string) (wajib) - ID set penawaran Anda. Untuk informasi selengkapnya, lihat Pengidentifikasi.Type(string) (wajib) - HarusOfferSet@1.0.
DetailsDocument(objek) (wajib) — Rincian permintaan.Offers(array) (wajib) — Daftar penawaran untuk dipisahkan. Minimal: 1 item. Maksimal: 7 item.OfferId(string) (wajib) — Pengenal penawaran AWS Marketplace. Panjang minimum: 1 karakter. Panjang maksimum: 36 karakter.
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 memastikan bahwa informasi tersebut memenuhi pedoman AWS Marketplace. Proses validasi dapat memakan waktu beberapa menit.
Anda dapat memeriksa status permintaan melalui AWS Marketplace Management Portal, atau langsung melalui Catalog API menggunakan operasi DescribeChangeSet API.
Kesalahan Asinkron
Kesalahan berikut khusus untuk DisassociateOffers tindakan di API AWS Marketplace Katalog. 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.
| Kode kesalahan | Pesan kesalahan |
|---|---|
INVALID_UPDATE_REQUEST |
Perubahan yang diminta tidak dapat dilakukan setelah set penawaran dirilis. |
Kaitkan solusi dengan set penawaran
Gunakan jenis AssociateSolution perubahan untuk mengaitkan satu solusi AWS Marketplace dengan set penawaran. Ini menciptakan hubungan yang memungkinkan pembeli menemukan koneksi set penawaran ke solusi dan mengakses konten pemasaran solusi yang kaya seperti deskripsi terperinci, diagram arsitektur, dan dokumentasi kasus penggunaan.
catatan
Ini adalah asosiasi yang digabungkan secara longgar. AWS Marketplace tidak menerapkan konsistensi antara solusi dan set penawaran. Solusi tidak dapat berisi produk AWS Marketplace, produk yang berbeda dari yang ada di set penawaran, atau produk yang tumpang tindih. Anda memiliki fleksibilitas penuh untuk mengaitkan solusi apa pun yang Anda miliki untuk tujuan pemasaran dan penemuan.
Untuk informasi tentang izin IAM yang diperlukan, lihat. Izin IAM untuk set penawaran
Permintaan Sintaks
POST /StartChangeSet HTTP/1.1 Content-type: application/json { "Catalog": "AWSMarketplace", "ChangeSet": [ { "ChangeType": "AssociateSolution", "Entity": { "Type": "OfferSet@1.0", "Identifier": "offerset-abc123" }, "DetailsDocument": { "SolutionId": "soln-xyz789" } } ] }
Berikan informasi untuk bidang untuk menambahkan jenis AssociateSolution perubahan:
Entity(objek) (wajib) - Entitas yang diperbarui.Identifier(string) (wajib) - ID set penawaran Anda. Untuk informasi selengkapnya, lihat Pengidentifikasi.Type(string) (wajib) - HarusOfferSet@1.0.
DetailsDocument(objek) (wajib) — Rincian permintaan.SolutionId(string) (wajib) — Pengenal solusi AWS Marketplace untuk diasosiasikan. Panjang minimum: 1 karakter. Panjang maksimum: 50 karakter. Harus cocok dengan pola^soln-[A-Za-z0-9]+$.
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 memastikan bahwa informasi tersebut memenuhi pedoman AWS Marketplace. Proses validasi dapat memakan waktu beberapa menit.
Anda dapat memeriksa status permintaan melalui AWS Marketplace Management Portal, atau langsung melalui Catalog API menggunakan operasi DescribeChangeSet API.
Kesalahan Asinkron
Kesalahan berikut khusus untuk AssociateSolution tindakan di API AWS Marketplace Katalog. 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.
| Kode kesalahan | Pesan kesalahan |
|---|---|
INCOMPATIBLE_SOLUTION_ASSOCIATION |
Lepaskan solusi yang ada sebelum mengaitkan solusi baru. |
INVALID_UPDATE_REQUEST |
Perubahan yang diminta tidak dapat dilakukan setelah set penawaran dirilis. |
Pisahkan solusi dari set penawaran
Gunakan jenis DisassociateSolution perubahan untuk menghapus asosiasi antara solusi dan set penawaran. Ini menghapus konten pemasaran solusi dari set penawaran sambil mempertahankan fungsionalitas transaksi set penawaran.
Permintaan Sintaks
POST /StartChangeSet HTTP/1.1 Content-type: application/json { "Catalog": "AWSMarketplace", "ChangeSet": [ { "ChangeType": "DisassociateSolution", "Entity": { "Type": "OfferSet@1.0", "Identifier": "offerset-abc123" }, "DetailsDocument": { "SolutionId": "soln-xyz789" } } ] }
Berikan informasi untuk bidang untuk menambahkan jenis DisassociateSolution perubahan:
Entity(objek) (wajib) - Entitas yang diperbarui.Identifier(string) (wajib) - ID set penawaran Anda. Untuk informasi selengkapnya, lihat Pengidentifikasi.Type(string) (wajib) - HarusOfferSet@1.0.
DetailsDocument(objek) (wajib) — Rincian permintaan.SolutionId(string) (wajib) — Pengidentifikasi solusi untuk memisahkan. Panjang minimum: 1 karakter. Panjang maksimum: 50 karakter.
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 memastikan bahwa informasi tersebut memenuhi pedoman AWS Marketplace. Proses validasi dapat memakan waktu beberapa menit.
Anda dapat memeriksa status permintaan melalui AWS Marketplace Management Portal, atau langsung melalui Catalog API menggunakan operasi DescribeChangeSet API.
Kesalahan Asinkron
Kesalahan berikut khusus untuk DisassociateSolution tindakan di API AWS Marketplace Katalog. 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.
| Kode kesalahan | Pesan kesalahan |
|---|---|
INVALID_UPDATE_REQUEST |
Perubahan yang diminta tidak dapat dilakukan setelah set penawaran dirilis. |
Lepaskan satu set penawaran
Gunakan jenis ReleaseOfferSet perubahan untuk membuat set penawaran tersedia bagi pembeli. Setelah dirilis, penawaran mengatur transisi dari Draft ke status Dirilis, menjadi dapat ditemukan melalui AWS Marketplace, dan penawaran terkait hanya dapat ditemukan sebagai bagian dari paket terpadu.
Set penawaran yang dirilis menghasilkan pemberitahuan pada dua tingkat: penawaran individual dan penawaran itu sendiri. Semua pemberitahuan penawaran individu termasuk OfferSetId di saluran notifikasi yang ada (pemberitahuan email dan EventBridge acara Amazon). Pemberitahuan set-level penawaran dikirim untuk acara-acara penting seperti saat set penawaran dirilis.
Permintaan Sintaks
POST /StartChangeSet HTTP/1.1 Content-type: application/json { "Catalog": "AWSMarketplace", "ChangeSet": [ { "ChangeType": "ReleaseOfferSet", "Entity": { "Type": "OfferSet@1.0", "Identifier": "offerset-abc123" }, "DetailsDocument": {} } ] }
Berikan informasi untuk bidang untuk menambahkan jenis ReleaseOfferSet perubahan:
Entity(objek) (wajib) - Entitas yang diperbarui.Identifier(string) (wajib) - ID set penawaran Anda. Untuk informasi selengkapnya, lihat Pengidentifikasi.Type(string) (wajib) - HarusOfferSet@1.0.
DetailsDocument(object) (required) - Objek kosong untuk operasi ini.
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 memastikan bahwa informasi tersebut memenuhi pedoman AWS Marketplace. Proses validasi dapat memakan waktu beberapa menit.
Anda dapat memeriksa status permintaan melalui AWS Marketplace Management Portal, atau langsung melalui Catalog API menggunakan operasi DescribeChangeSet API.
Kesalahan Asinkron
Kesalahan berikut khusus untuk ReleaseOfferSet tindakan di API AWS Marketplace Katalog. 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.
| Kode kesalahan | Pesan kesalahan |
|---|---|
HILANG_BUYER_NOTES |
Berikan BuyerNotes sebelum merilis set penawaran. |
HILANG_PENAWARAN |
Kaitkan setidaknya dua penawaran ke penawaran yang ditetapkan sebelum merilisnya. |
TOO_MANY_OFFERS_PER_PRODUCT |
Kaitkan hanya satu penawaran per produk ke set penawaran. |
INKONSISTEN_OFFER_CURRENCY_CODE |
Pastikan semua penawaran terkait memiliki kecocokan CurrencyCode. |
INKONSISTEN_OFFER_AVAILABILITY_END_DATE |
Pastikan semua penawaran terkait memiliki kecocokan AvailabilityEndDate. |
INCONSISTENT_OFFER_TARGETING_RULE |
Pastikan semua penawaran terkait memiliki kecocokan TargetingRule. |
INCOMPATIBLE_OFFER_TARGETING_RULE |
Hanya penawaran yang ditargetkan pembeli yang dapat dikaitkan dengan set penawaran. |
KEDALUWARSA_PENAWARAN |
Lepaskan penawaran yang kedaluwarsa dari penawaran yang ditetapkan atau perpanjang. AvailabilityEndDates |
DRAFT_OFFERS |
Lepaskan semua penawaran terkait sebelum merilis set penawaran. |
INCOMPATIBLE_SOLUTION_STATE |
Memberikan solusi di negara terbatas atau publik. |
INVALID_UPDATE_REQUEST |
Perubahan yang diminta tidak dapat dilakukan setelah set penawaran dirilis. |
Tawarkan siklus hidup yang ditetapkan
Siklus hidup yang ditetapkan penawaran terdiri dari tahapan berikut:
Fase penciptaan
Buat entitas set penawaran dalam status Draft menggunakan jenis CreateOfferSet perubahan. Set penawaran menerima pengenal unik dan dimulai dalam status Draf.
Fase konfigurasi
Selama konfigurasi, Anda:
Tambahkan atau perbarui metadata menggunakan
UpdateInformation(nama, catatan pembeli)Buat penawaran pribadi individual, tentukan
OfferSetIdselama pembuatan penawaranKaitkan penawaran dengan penawaran yang ditetapkan menggunakan
AssociateOffersSecara opsional mengaitkan solusi menggunakan konten pemasaran
AssociateSolutionyang disempurnakan
penting
Penawaran individual tidak dapat diubah dan hanya dapat diatur selama pembuatan penawaran. OfferSetId Sebelum mengaitkan penawaran dengan penawaran yang digunakanAssociateOffers, Anda harus terlebih dahulu membuat penawaran individual dan menentukan OfferSetId selama pembuatan penawaran. Jika Anda perlu menyertakan penawaran yang sudah ada yang tidak benarOfferSetId, Anda harus membuat penawaran baru dengan yang OfferSetId ditentukan dengan benar.
Fase validasi
Sebelum merilis set penawaran, pastikan:
Set penawaran berisi antara 2 dan 7 penawaran
Semua penawaran terkait harus:
Dalam keadaan Dirilis
Aktif
Menggunakan mata uang yang sama
Menargetkan ID akun AWS pembeli yang sama
Memiliki tanggal kedaluwarsa yang identik
Fase rilis
Saat siap, gunakan jenis ReleaseOfferSet perubahan untuk mentransisikan set penawaran dari Draft ke status Dirilis. Hal ini membuat set penawaran dapat ditemukan oleh pembeli melalui. AWS Marketplace
Post-release manajemen
Manajemen kedaluwarsa:
Kedaluwarsa efektif dari satu set penawaran dihitung sebagai tanggal kedaluwarsa paling awal di antara semua penawaran terkait
Anda dapat mengubah tanggal kedaluwarsa penawaran individual menggunakan kemampuan manajemen penawaran yang ada (jenis
UpdateAvailabilityperubahan)
Tawarkan modifikasi set:
Saat pembeli meminta perubahan pada set penawaran yang dirilis, gunakan alur kerja rekreasi:
Buat entitas set penawaran baru
Untuk penawaran yang tidak memerlukan perubahan, kloning penawaran yang ada melalui Portal AWS Marketplace Manajemen
Untuk penawaran yang membutuhkan modifikasi, buat penawaran baru dengan perubahan yang diminta, tentukan yang baru
OfferSetIdKaitkan semua penawaran (kloning dan baru) dengan set penawaran baru menggunakan
AssociateOffersLepaskan set penawaran baru menggunakan
ReleaseOfferSetKedaluwarsa penawaran asli yang ditetapkan dengan menetapkan tanggal akhir ketersediaan penawaran terkait
Izin IAM untuk set penawaran
Untuk bekerja dengan set penawaran menggunakan API AWS Marketplace Katalog, Anda memerlukan izin IAM tertentu. Bagian ini menjelaskan izin yang diperlukan untuk operasi set penawaran dan persyaratan otorisasi lintas entitas.
Tindakan IAM yang diperlukan
Tindakan IAM berikut diperlukan untuk operasi set penawaran:
aws-marketplace:StartChangeSet— Diperlukan untuk semua jenis perubahan set penawaran termasuk membuat, memperbarui, mengaitkan, dan operasi rilisaws-marketplace:DescribeChangeSet— Diperlukan untuk memeriksa status dan hasil eksekusi set perubahanaws-marketplace:ListEntities— Diperlukan untuk mencantumkan set penawaran di akun Andaaws-marketplace:DescribeEntity— Diperlukan untuk mengambil informasi rinci tentang set penawaran
Izin sumber daya
Gunakan pola ARN berikut untuk memberikan izin pada sumber daya tertentu:
Set penawaran —
arn:aws:aws-marketplace:us-east-1:123456789012:AWSMarketplace/OfferSet/*Penawaran individu —
arn:aws:aws-marketplace:us-east-1:123456789012:AWSMarketplace/Offer/*Solusi —
arn:aws:aws-marketplace:us-east-1:123456789012:AWSMarketplace/Solution/*
Untuk izin yang lebih ketat, ganti wildcard (*) dengan pengenal entitas tertentu.
Cross-entity otorisasi
Beberapa operasi set penawaran memerlukan izin pada set penawaran dan entitas yang terkait:
AssociateOffers
aws-marketplace:StartChangeSetizin pada entitas set penawaranaws-marketplace:StartChangeSetizin dengan jenisAssociateWithOfferSetperubahan pada setiap entitas penawaran individu yang terkait
AssociateSolution
aws-marketplace:StartChangeSetizin pada entitas set penawaranaws-marketplace:StartChangeSetizin dengan jenisAssociateWithOfferSetperubahan pada entitas solusi yang terkait
catatan
Hanya memiliki izin DescribeEntity (hanya-baca) pada penawaran atau solusi tidak cukup untuk operasi asosiasi. Anda harus memiliki StartChangeSet izin dengan jenis AssociateWithOfferSet perubahan pada entitas yang terkait dengan set penawaran.
Contoh kebijakan IAM
Manajemen set penawaran dasar
Kebijakan ini memberikan izin untuk operasi set penawaran dasar tanpa asosiasi lintas entitas:
{ "Version": "2012-10-17", "Statement": [ { "Effect": "Allow", "Action": [ "aws-marketplace:StartChangeSet", "aws-marketplace:DescribeChangeSet", "aws-marketplace:ListEntities", "aws-marketplace:DescribeEntity" ], "Resource": [ "arn:aws:aws-marketplace:us-east-1:123456789012:AWSMarketplace/OfferSet/*" ] } ] }
Cross-entity izin untuk AssociateOffers
Kebijakan ini menunjukkan izin dan ketentuan khusus yang diperlukan untuk: AssociateOffers
{ "Version": "2012-10-17", "Statement": [ { "Effect": "Allow", "Action": "aws-marketplace:StartChangeSet", "Resource": "arn:aws:aws-marketplace:us-east-1:123456789012:AWSMarketplace/OfferSet/*", "Condition": { "StringEquals": { "catalog:ChangeType": ["AssociateOffers"] } } }, { "Effect": "Allow", "Action": "aws-marketplace:DescribeEntity", "Resource": "arn:aws:aws-marketplace:us-east-1:123456789012:AWSMarketplace/Offer/*" }, { "Effect": "Allow", "Action": "aws-marketplace:StartChangeSet", "Resource": "arn:aws:aws-marketplace:us-east-1:123456789012:AWSMarketplace/Offer/*", "Condition": { "StringEquals": { "catalog:ChangeType": ["AssociateWithOfferSet"] } } } ] }
Untuk izin yang lebih ketat, ganti wildcard (*) dengan pengenal entitas tertentu.
Cross-entity izin untuk AssociateSolution
Kebijakan ini menunjukkan izin dan ketentuan khusus yang diperlukan untuk: AssociateSolution
{ "Version": "2012-10-17", "Statement": [ { "Effect": "Allow", "Action": "aws-marketplace:StartChangeSet", "Resource": "arn:aws:aws-marketplace:us-east-1:123456789012:AWSMarketplace/OfferSet/*", "Condition": { "StringEquals": { "catalog:ChangeType": ["AssociateSolution"] } } }, { "Effect": "Allow", "Action": "aws-marketplace:DescribeEntity", "Resource": "arn:aws:aws-marketplace:us-east-1:123456789012:AWSMarketplace/Solution/*" }, { "Effect": "Allow", "Action": "aws-marketplace:StartChangeSet", "Resource": "arn:aws:aws-marketplace:us-east-1:123456789012:AWSMarketplace/Solution/*", "Condition": { "StringEquals": { "catalog:ChangeType": ["AssociateWithOfferSet"] } } } ] }
Untuk izin yang lebih ketat, ganti wildcard (*) dengan pengenal entitas tertentu.