Referensi API AWS Marketplace direstrukturisasi. Untuk informasi selengkapnya tentang operasi API yang didukung, lihat [Referensi API AWS Marketplace](https://docs.aws.amazon.com/marketplace/latest/APIReference/Welcome.html).
Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
# Bekerja dengan solusi
Solusi adalah kumpulan produk dan layanan yang bekerja sama untuk memecahkan masalah pelanggan tertentu. Solusi dapat mencakup produk AWS Marketplace dan produk non-AWS Marketplace. Solusi membantu Anda menunjukkan bagaimana beberapa produk berintegrasi untuk mengatasi kasus penggunaan khusus industri. Solusinya menjelaskan masalah pelanggan, kasus penggunaan, detail integrasi, dan produk terkait.
## Solusi di AWS Marketplace dan AWS Partner Central
Saat Anda bermigrasi dari Partner Central 2.0 ke Partner Central 3.0, Anda diminta untuk membuat akun AWS dan mendaftar sebagai penjual AWS Marketplace. Untuk informasi selengkapnya, lihat [Mendaftar dan membuat profil penjual Anda](https://docs.aws.amazon.com/marketplace/latest/userguide/create-public-profile.html). Pendaftaran ini diperlukan untuk:
+ Migrasikan solusi Partner Central Anda yang ada ke katalog AWS Marketplace (semua solusi akan dimigrasikan ke `AWSMarketplace` katalog)
+ Aktifkan solusi AWS Marketplace Anda untuk bekerja dengan API Pusat Mitra, seperti [Menjual API](https://docs.aws.amazon.com/partner-central/latest/APIReference/working-with-your-opportunities.html).
### Memahami penautan profil dan migrasi
Ada dua skenario berbeda untuk menghubungkan akun Partner Central dan AWS Marketplace Anda:
**Hanya penautan profil** — Jika Anda menautkan akun AWS Partner Central dan AWS Anda tanpa bermigrasi ke Partner Central 3.0, solusi AWS Marketplace dan solusi Partner Central Anda tetap terpisah. Anda mengelola setiap platform secara mandiri.
**Migrasi profil** — Saat Anda bermigrasi ke Partner Central 3.0 dengan profil penjual AWS Marketplace tertaut:
+ Solusi Partner Central 2.0 Anda bermigrasi ke AWS Marketplace
+ Anda mengelola solusi hanya melalui AWS Marketplace
+ API Pusat Mitra dapat mengakses solusi yang dimigrasi
**catatan**
Jika Anda telah menautkan akun AWS Partner Central dan AWS (lihat [Menautkan akun AWS Partner Central dan AWS](https://docs.aws.amazon.com/partner-central/latest/getting-started/account-linking.html)), Anda tidak perlu membuat akun AWS baru. Namun, verifikasi bahwa akun AWS Anda yang ada terdaftar sebagai penjual AWS Marketplace. Agar solusi Anda tersedia untuk umum di situs web pembeli AWS Marketplace, Anda memerlukan profil publik sebagai penjual AWS Marketplace. Untuk petunjuk pendaftaran penjual AWS Marketplace, lihat [Mendaftar dan membuat profil penjual Anda](https://docs.aws.amazon.com/marketplace/latest/userguide/create-public-profile.html).
### Menyediakan solusi AWS Marketplace yang sudah ada sebelumnya untuk API Pusat Mitra
Solusi AWS Marketplace yang Anda buat sebelum migrasi profil Partner Central 3.0 tidak secara otomatis dikenali oleh API Pusat Mitra. Ini berlaku bahkan setelah Anda menyelesaikan migrasi dan menautkan akun AWS Anda dengan akun Partner Central.
Untuk membuat solusi pra-migrasi yang ada terlihat oleh API Pusat Mitra, perbarui bidang apa pun dalam solusi. Anda dapat memasukkan informasi yang sama yang ada saat ini. Ulangi proses ini untuk setiap solusi yang Anda buat sebelum migrasi profil Partner Central 3.0.
Misalnya, gunakan jenis `UpdateInformation` perubahan untuk memperbarui nama solusi dengan nilainya saat ini. Setelah Anda memperbarui solusi satu kali, API Pusat Mitra akan secara otomatis mengenali pembaruan masa depan untuk solusi tersebut.
## Entitas solusi
Solusi adalah dokumen pemasaran yang membantu pembeli menemukan dan memahami penawaran Anda. Solusi berisi judul, deskripsi, kasus penggunaan, produk AWS Marketplace, dan produk non-AWS Marketplace. Solusi adalah jenis entitas terpisah dari set produk, penawaran, dan penawaran. Setiap solusi memiliki pengalaman penemuan dan daftar sendiri yang dapat ditelusuri pembeli secara terpisah dari masing-masing produk.
**Karakteristik utama**
+ Kelompokkan beberapa produk, termasuk produk AWS Marketplace dan produk non-AWS Marketplace.
+ Buat pengalaman penemuan dan daftar khusus untuk pembeli.
+ Kelompokkan produk yang Anda miliki dengan produk dari penjual lain.
Jenis entitas solusi adalah`Solution@1.0`.
**Pengidentifikasi entitas**
Solusi menggunakan format `soln-*` pengenal (misalnya,`soln-abc123def456`).
**Format ARN entitas**
Solusi mengikuti format AWS ARN standar:
```
arn:{aws-partition}:aws-marketplace:{region}:{account-id}:{aws-marketplace-catalog}/Solution/{solution-id}
```
Contoh:
```
arn:aws:aws-marketplace:us-east-1:123456789012:AWSMarketplace/Solution/soln-abc123def456
```
## Memulai dengan solusi
Bagian ini memberikan informasi terperinci tentang membuat dan mengelola solusi menggunakan [tipe perubahan](https://docs.aws.amazon.com/marketplace/latest/APIReference/API_Change.html) 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](https://docs.aws.amazon.com/marketplace/latest/userguide/create-public-profile.html).
+ Akses ke API dan prasyarat penjual yang lengkap. Untuk informasi selengkapnya, lihat [Kontrol akses untuk AWS Marketplace Catalog API](https://docs.aws.amazon.com/marketplace/latest/APIReference/catalog-api-access-control.html).
+ Mempelajari dasar-dasar penggunaan AWS Marketplace Catalog API, lihat [Menggunakan AWS Marketplace Catalog API](https://docs.aws.amazon.com/marketplace/latest/APIReference/catalog-apis.html).
## Daftar solusi Anda
Untuk mencantumkan semua solusi di akun Anda, hubungi operasi `ListEntities` API dan setel `EntityType` ke Solusi.
**Permintaan**
```
POST /ListEntities HTTP/1.1
Content-type: application/json
{
"Catalog": "AWSMarketplace",
"EntityType": "Solution"
}
```
**Respons**
```
{
"EntitySummaryList": [
{
"EntityArn": "arn:aws:aws-marketplace:us-east-1:123456789012:AWSMarketplace/Solution/soln-abc123456",
"EntityId": "soln-abc123456",
"EntityType": "Solution",
"LastModifiedDate": "2024-10-10T19:50:43Z",
"Name": "Test Solution 1",
"Visibility": "Limited"
}
],
"NextToken": null
}
```
### Filter solusi berdasarkan visibilitas
Anda dapat memfilter solusi berdasarkan visibilitas menggunakan `FilterList` parameter.
**Permintaan**
```
POST /ListEntities HTTP/1.1
Content-type: application/json
{
"Catalog": "AWSMarketplace",
"EntityType": "Solution",
"FilterList": [
{
"Name": "Visibility",
"ValueList": [
"Public"
]
}
]
}
```
## Dapatkan detail solusi
Untuk mendapatkan informasi rinci tentang solusi tertentu, hubungi operasi `DescribeEntity` API.
**catatan**
DescribeEntity Respons mengembalikan sebuah `EntityIdentifier` yang menggabungkan `EntityId` dengan solusi `RevisionId.` For, `EntityId` adalah ID solusi, dan `RevisionId` dapat digunakan untuk penguncian optimis. Untuk informasi selengkapnya, lihat [Pengidentifikasi](https://docs.aws.amazon.com/marketplace/latest/APIReference/catalog-apis.html#identifier).
**Permintaan**
```
GET /DescribeEntity?catalog=AWSMarketplace&entityId=soln-abc123456 HTTP/1.1
```
**Respons**
```
{
"Details": "{...}",
"DetailsDocument": {
"Lifecycle": {
"Visibility": "Limited"
},
"Identifiers": {
"Id": "soln-abc123456"
},
"Presentation": {
"Title": "My Solution",
"Name": "solution_for_customer_X",
"ShortDescription": "Solution value proposition",
"LongDescription": "Detailed solution description",
"LogoUrl": "https://s3.amazonaws.com/logo.jpg",
"UseCases": [
{
"Group": "advertising_and_marketing",
"SubGroup": "ad_intelligence_and_measurement",
"Item": "amazon_ads_insights",
"Description": "Use case description"
}
]
},
"RelatedProducts": {
"AwsMarketplaceProducts": [
{
"ProductId": "prod-123"
}
],
"IntegrationDescription": "How products work together",
"NonAwsMarketplaceProducts": [
{
"Type": "Hardware",
"Title": "A hardware product",
"Url": "https://example.com",
"Description": "My hardware product description"
}
]
},
"BuyerEngagement": [
{
"EngagementOption": "RequestPrivateOffer"
}
]
},
"EntityArn": "arn:aws:aws-marketplace:us-east-1:123456789012:AWSMarketplace/Solution/soln-abc123456",
"EntityIdentifier": "soln-abc123456@12",
"EntityType": "Solution@1.0",
"LastModifiedDate": "2025-04-22T01:02:48Z"
}
```
## Daftar riwayat perubahan untuk solusi
Untuk melihat riwayat perubahan untuk solusi tertentu, panggil operasi `ListChangeSets` API dengan filter entitas.
**Permintaan Sintaks**
```
POST /ListChangeSets HTTP/1.1
Content-type: application/json
{
"Catalog": "AWSMarketplace",
"FilterList": [
{
"Name": "EntityId",
"ValueList": [
"soln-abc123456"
]
}
]
}
```
## Menandai solusi dan mengubah set
Anda dapat menambahkan tag ke solusi dan mengubah set selama pembuatan atau memperbaruinya nanti.
**Tag selama pembuatan**
Anda `EntityTags` hanya dapat menambahkan ke jenis `CreateSolution` perubahan, bukan ke jenis perubahan solusi lainnya. Anda dapat menambahkan `ChangeSetTags` ke `StartChangeSet` muatan apa pun.
```
POST /StartChangeSet HTTP/1.1
Content-type: application/json
{
"Catalog": "AWSMarketplace",
"ChangeSet": [
{
"ChangeType": "CreateSolution",
"Entity": {
"Type": "Solution@1.0"
},
"DetailsDocument": {
"Name": "Test solution resource name"
},
"EntityTags": [
{
"Key": "Team",
"Value": "Solutions"
}
]
}
],
"ChangeSetTags": [
{
"Key": "Environment",
"Value": "Production"
}
]
}
```
**Kelola tag pada sumber daya yang ada**
Gunakan operasi `TagResource` dan `UntagResource` API untuk mengelola tag pada solusi yang ada dan mengubah set. Gunakan `ListTagsForResource` untuk melihat tag saat ini.
Untuk informasi selengkapnya, lihat [Mengelola tag pada sumber daya](https://docs.aws.amazon.com/marketplace/latest/APIReference/catalog-api-access-control.html#managing-tags-on-resources) dan [Menambahkan tag ke entitas dan mengubah set selama pembuatan](https://docs.aws.amazon.com/marketplace/latest/APIReference/catalog-api-access-control.html#example-adding-tags-entity-creation).
## Buat solusi
Anda dapat menggunakan jenis `CreateSolution` perubahan untuk membuat dokumen solusi baru hanya dengan ID dan nama solusi. Nilai-nilai lain belum terisi.
Ketika permintaan Anda berhasil diproses, AWS Marketplace membuat solusi dalam `Draft` status untuk Anda. Solusi yang tidak lengkap ini tidak terlihat oleh pembeli di AWS Marketplace.
Anda kemudian menggunakan jenis perubahan lain untuk menyelesaikan solusi:`UpdateInformation`,`UpdateRelatedProducts`, `UpdateBuyerEngagementOptions` (opsional untuk membuat `Limited` solusi), dan`ReleaseSolution`. Jenis `ReleaseSolution` perubahan memvalidasi bahwa semua bidang wajib yang diperlukan untuk `Limited` solusi ada pada solusi, dan kemudian memindahkannya ke `Limited` visibilitas.
**catatan**
Untuk memindahkan solusi ke status Publik atau mengubah status solusi, gunakan jenis `UpdateVisibility` perubahan setelah memberikan nilai yang diperlukan.
**Permintaan Sintaks**
```
POST /StartChangeSet HTTP/1.1
Content-type: application/json
{
"Catalog": "AWSMarketplace",
"ChangeSet": [
{
"ChangeType": "CreateSolution",
"Entity": {
"Type": "Solution@1.0"
},
"ChangeName": "CreateSolutionChange",
"DetailsDocument": {
"Name": "solution_for_customerX_en",
"Title": "New Partner Solution"
}
}
]
}
```
Berikan informasi untuk bidang untuk menambahkan jenis `CreateSolution` perubahan:
+ `Entity`(object) (required) - Jenis bernama dari entitas solusi yang sedang dibuat.
+ `Type`(string) (wajib) — `Type` Harus`Solution@1.0`.
+ `DetailsDocument`(objek) (wajib) — Rincian permintaan.
+ `Name`(string) (wajib) — Nama sumber daya AWS hanya untuk referensi penjual sendiri (tidak terlihat oleh pembeli). Panjang maks: 100 karakter. Tidak boleh berisi spasi putih, jeda baris, atau karakter kontrol di depan atau belakang. Anda juga dapat memperbarui ubin solusi melalui jenis `UpdateInformation` perubahan.
+ `Title`(string) (opsional) - Judul untuk solusi Anda. Panjang maks: 255 karakter. Tidak boleh berisi spasi putih, jeda baris, atau karakter kontrol di depan atau belakang. Anda juga dapat mengatur atau memperbarui judul solusi melalui jenis `UpdateInformation` perubahan.
**Sintaks Respon**
Set perubahan dibuat untuk permintaan Anda. Tanggapan memberi Anda `ChangeSetId` dan`ChangeSetArn`:
```
{
"ChangeSetId": "example123456789012abcdef",
"ChangeSetArn": "arn:aws:aws-marketplace:us-east-1:123456789012:AWSMarketplace/ChangeSet/example123456789012abcdef"
}
```
Permintaan perubahan ditambahkan ke antrian dan diproses. Anda dapat memeriksa status menggunakan AWS Marketplace Management Portal atau operasi `DescribeChangeSet` API.
Ketika permintaan berhasil diselesaikan (jika `Status` ada`SUCCEEDED`), ID solusi baru akan dihasilkan.
**Kesalahan Asinkron**
`CreateSolution`tindakan mengembalikan kesalahan tertentu, selain kesalahan [asinkron umum](#solution-error-codes). Anda menerima kesalahan ini dari `DescribeChangeSet` setelah set perubahan selesai diproses. Untuk mempelajari cara mendapatkan status permintaan perubahan, lihat [Bekerja dengan set perubahan](https://docs.aws.amazon.com/marketplace/latest/APIReference/catalog-apis.html#working-with-change-sets).
| Kode kesalahan | Pesan kesalahan |
| --- | --- |
| INVALID\_NAME | Solusi Panjang nama tidak valid. Masukkan Nama yang berada di antara 1 dan 100 karakter dan coba lagi. |
| HILANG\_NAMA | Diperlukan nilai Nama. Tentukan nilai Nama dan coba lagi. |
| INVALID\_TITLE | Solusi Panjang judul tidak valid. Masukkan judul yang antara 1 dan 255 karakter dan coba lagi. |
## Perbarui informasi solusi
Jika Anda sudah memiliki solusi di AWS Marketplace, Anda dapat menggunakan Catalog API untuk memperbarui informasi solusi.
Untuk memperbarui informasi solusi, hubungi operasi `StartChangeSet` API dengan jenis `UpdateInformation` perubahan dan detail terbaru Anda. Lihat contoh berikut ini.
**catatan**
Jenis `UpdateInformation` perubahan berperilaku seperti operasi HTTP PATCH untuk atribut tingkat atas. Bagaimana bidang diperbarui:
Jika atribut tingkat atas hadir di`DetailsDocument`, alur kerja memvalidasi input Anda dan menimpa nilai yang ada.
Jika bidang tingkat atas tidak ada di`DetailsDocument`, nilai yang ada dipertahankan.
Untuk menghapus kolom opsional, kirim JSON eksplisit `null` untuk bidang itu.
AWS Marketplace memverifikasi dan menyerap logo dan aset media promosi ke lokasi Marketplace-owned AWS. DescribeEntity mengembalikan URL yang dapat diakses untuk file yang dicerna, bukan masukan asli Anda. StartChangeSet Untuk melihat URL asli yang dikirimkan, gunakan DescribeChangeSet API.
**catatan**
Saat Anda memodifikasi file `PromotionalMedia` aset (dengan menyediakan URL baru) pada `Public` solusi, `UpdateInformation` memerlukan peninjauan manual dari tim AWS Marketplace Seller Operations. Ini meningkatkan waktu eksekusi. Dalam skenario ini, gunakan `UpdateInformation` secara terpisah dalam set perubahannya sendiri.
**Permintaan Sintaks**
```
POST /StartChangeSet HTTP/1.1
Content-type: application/json
{
"Catalog": "AWSMarketplace",
"ChangeSet": [
{
"ChangeType": "UpdateInformation",
"Entity": {
"Identifier": "soln-1234abcd",
"Type": "Solution@1.0"
},
"DetailsDocument": {
"Name": "project_cold_harbor",
"Title": "My Awesome Solution",
"ShortDescription": "Solution value proposition",
"LongDescription": "Detailed solution description explaining how this addresses customer needs",
"LogoUrl": "https://s3.amazonaws.com/awsmp-logos/logo.jpg",
"PromotionalMedia": [
{
"Type": "Image",
"Url": "https://s3.amazonaws.com/awsmp-media/image.jpg",
"Title": "Sample image",
"Description": "Sample image description"
},
{
"Type": "Video",
"Url": "https://s3.amazonaws.com/awsmp-media/video.mp4",
"Title": "Sample video",
"PreviewUrl": "https://s3.amazonaws.com/awsmp-media/preview.png",
"Description": "Sample video description"
}
],
"AdditionalResources": [
{
"Text": "Troubleshooting guide",
"Url": "https://example.com/troubleshooting"
}
],
"UseCases": [
{
"Group": "advertising_and_marketing",
"SubGroup": "ad_intelligence_and_measurement",
"Item": "amazon_ads_insights",
"Description": "Highlight description of this use case"
}
]
}
}
]
}
```
Berikan informasi untuk bidang untuk menambahkan jenis `UpdateInformation` perubahan:
+ `Entity`(object) (required) - Jenis entitas bernama yang diperbarui.
+ `Identifier`(string) (wajib) - ID solusi.
+ `Type`(string) (wajib) - Harus`Solution@1.0`.
+ `DetailsDocument`(objek) (wajib) - Detail permintaan termasuk informasi yang ingin Anda perbarui untuk solusi Anda. Setiap bidang bersifat opsional, tetapi Anda harus menyertakan setidaknya satu perubahan untuk memperbarui.
+ `Name`(string) — Nama sumber daya solusi, hanya dapat dilihat oleh penjual melalui operasi pembacaan API Katalog, tidak terlihat oleh pembeli. Panjang maks: 100 karakter. Tidak boleh berisi spasi putih, jeda baris, atau karakter kontrol di depan atau belakang.
+ `Title`(string) — Judul solusi yang akan ditampilkan kepada pembeli. Panjang maks: 255 karakter. Tidak boleh berisi spasi putih, jeda baris, atau karakter kontrol di depan atau belakang.
+ `ShortDescription`(string) — Deskripsi proposisi nilai dari aspek-aspek kunci dari solusi yang akan ditampilkan kepada pembeli. Ini biasanya 2-3 kalimat. Panjang maks: 1000 karakter. Tidak boleh berisi spasi putih atau karakter kontrol di depan atau belakang.
+ `LongDescription`(string) — Deskripsi yang lebih panjang dari solusi ini untuk ditampilkan kepada pembeli. Ini biasanya 1-3 paragraf. Panjang maks: 5000 karakter. Tidak boleh berisi spasi putih atau karakter kontrol di depan atau belakang.
+ `LogoUrl`(string) — URL ke gambar dalam bucket Amazon S3 yang dapat diakses publik atau URL S3 yang telah ditetapkan sebelumnya. Harus berupa URL S3 langsung (bukan di belakang CloudFront atau API Gateway). Panjang maks: 2048 karakter. Untuk spesifikasi logo, lihat [Persyaratan logo perusahaan dan produk](https://docs.aws.amazon.com/marketplace/latest/userguide/product-submission.html#seller-and-product-logos).
+ `PromotionalMedia`(array objek) — Daftar gambar dan video promosi. Maks 15 item (5 video dan 10 gambar). Untuk spesifikasi media promosi, lihat [Meningkatkan produk AWS Marketplace Anda dengan media promosi](https://docs.aws.amazon.com/marketplace/latest/userguide/promotional-media.html).
+ `Type`(string) (wajib) - Entah `Image` atau`Video`.
+ `Url`(string) (wajib) — URL ke file media. Harus berupa URL S3 langsung atau URL S3 yang telah ditentukan sebelumnya. Panjang maks: 2048 karakter. Harus berupa URL https.
+ `Title`(string) (wajib) — Judul media. Panjang maks: 100 karakter. Tidak boleh berisi spasi putih, jeda baris, atau karakter kontrol di depan atau belakang.
+ `Description`(string) (wajib) — Deskripsi media. Panjang maks: 200 karakter. Tidak boleh berisi spasi putih atau karakter kontrol di depan atau belakang.
+ `PreviewUrl`(string) (opsional) - Hanya untuk video, URL ke gambar pratinjau. Panjang maks: 2048 karakter. Harus berupa URL https.
+ `AdditionalResources`(array objek) — Daftar referensi ke sumber daya tambahan. Maks 8 item.
+ `Text`(string) — Nama atau judul sumber daya. Panjang maks: 500 karakter. Tidak boleh berisi spasi putih, jeda baris, atau karakter kontrol di depan atau belakang.
+ `Url`(string) — URL ke sumber daya. Panjang maks: 2048 karakter. Harus berupa URL https.
+ `UseCases`(array objek) - Daftar kasus penggunaan yang ditangani oleh solusi ini. Maks 3 item. Untuk kategori kasus penggunaan yang valid (kombinasi Grup, SubGroup, dan Item), lihat [daftar kategori kasus penggunaan](https://d1z4dgsxp8pfa2.cloudfront.net/awsmp-solutions/use-case-categories-list.json) untuk nilai aktif yang diterima dan [label pengantar](https://d1z4dgsxp8pfa2.cloudfront.net/awsmp-solutions/i18n/en.json). Kombinasi Grup, SubGroup, dan Item harus merupakan item yang valid dalam daftar kategori kasus penggunaan.
+ `Group`(string) — Kategori industri atau teknologi. Harus menjadi salah satu nilai Grup dalam [daftar kategori kasus penggunaan](https://d1z4dgsxp8pfa2.cloudfront.net/awsmp-solutions/use-case-categories-list.json).
+ `SubGroup`(string) - Gunakan grup kasus dalam kategori. Harus menjadi salah satu SubGroup nilai dalam [daftar kategori kasus penggunaan](https://d1z4dgsxp8pfa2.cloudfront.net/awsmp-solutions/use-case-categories-list.json).
+ `Item`(string) - Kasus penggunaan khusus. Harus menjadi salah satu Nilai item dalam [daftar kategori kasus penggunaan](https://d1z4dgsxp8pfa2.cloudfront.net/awsmp-solutions/use-case-categories-list.json).
+ `Description`(string) — Deskripsi tentang bagaimana solusi ini menangani kasus penggunaan. Panjang maks: 500 karakter. Tidak boleh berisi spasi putih atau karakter kontrol di depan atau belakang.
Untuk informasi URL yang telah ditetapkan sebelumnya, lihat [Berbagi objek dengan URL yang telah ditetapkan sebelumnya.](https://docs.aws.amazon.com/AmazonS3/latest/userguide/ShareObjectPreSignedURL.html)
**catatan**
Saat memanggil jenis UpdateInformation perubahan, Anda selalu dapat memberikan subset bidang yang akan diperbarui di `DetailsDocument` objek. Namun, sebelum memindahkan solusi dari `Draft` ke`Limited`, bidang berikut harus diatur dengan benar:`Title`,`ShortDescription`,`LongDescription`, dan`LogoUrl`.
Namun, ketika Anda memperbarui bidang yang ada pada solusi, Anda hanya dapat menyertakan atribut yang perlu diubah dalam `DetailsDocument` objek jenis `UpdateInformation` 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. Untuk memeriksa status permintaan, gunakan AWS Marketplace Management Portal atau hubungi `DescribeChangeSet` API.
Setelah memicu jenis perubahan ini dengan `PromotionalMedia` aset yang dimodifikasi untuk `Public` solusi, dibutuhkan waktu hingga 37 hari untuk menyelesaikannya. Ini termasuk waktu yang dibutuhkan Tim Operasi Penjual AWS Marketplace untuk meninjau, mengaudit, dan menyetujui.
**Kesalahan Asinkron**
Selain kesalahan [asinkron umum, kesalahan](#solution-error-codes) berikut khusus untuk `UpdateInformation` tindakan di AWS 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, lihat [Bekerja dengan set perubahan](https://docs.aws.amazon.com/marketplace/latest/APIReference/catalog-apis.html#working-with-change-sets).
| Kode kesalahan | Pesan kesalahan |
| --- | --- |
| INVALID\_SHORT\_DESCRIPTION | ShortDescription Panjang solusi tidak valid. Masukkan ShortDescription yang antara 1 dan 1000 karakter dan coba lagi. |
| INVALID\_LONG\_DESCRIPTION | LongDescription Panjang solusi tidak valid. Masukkan LongDescription yang antara 1 dan 5000 karakter dan coba lagi. |
| INVALID\_NAME | Solusi Panjang nama tidak valid. Masukkan Nama yang berada di antara 1 dan 100 karakter dan coba lagi. |
| INVALID\_TITLE | Solusi Panjang judul tidak valid. Masukkan judul yang antara 1 dan 255 karakter dan coba lagi. |
| INVALID\_ADDITIONAL\_RESOURCES | Solusi AdditionalResources [%d] .Panjang teks tidak valid. Masukkan Teks yang antara 1 dan 500 karakter dan coba lagi. |
| INVALID\_ADDITIONAL\_RESOURCES | URL berikut dalam sumber daya tambahan yang disediakan tidak dapat diakses: [%s]. Menyediakan URL yang valid dan dapat diakses |
| INVALID\_ADDITIONAL\_RESOURCES | Nilai Url diperlukan. Tentukan nilai Url dan coba lagi. |
| INVALID\_ADDITIONAL\_RESOURCES | Teks tidak boleh hilang. Berikan Teks |
| INVALID\_USE\_CASE | Panjang solusi UseCases [%d] .Description tidak valid. Masukkan Deskripsi antara 1 dan 500 karakter dan coba lagi. |
| INVALID\_USE\_CASE | UseCases[%d] .Group: Grup yang disediakan (%s) tidak valid. Berikan Grup yang valid. |
| INVALID\_USE\_CASE | UseCases[%d]. SubGroup: Grup yang disediakan (%s) tidak valid. Berikan yang valid SubGroup. |
| INVALID\_USE\_CASE | UseCases[%d] .Item: Item yang disediakan (%s) tidak valid. Berikan Item yang valid. |
| INVALID\_USE\_CASE | UseCases[%d] .Item: Kasus penggunaan yang disediakan tidak aktif. Menyediakan kasus penggunaan aktif |
| INVALID\_USE\_CASE | UseCases[%d] .Group: Grup tidak dapat hilang. Menyediakan Grup. |
| INVALID\_USE\_CASE | UseCases[%d]. SubGroup: SubGroup tidak bisa hilang. Menyediakan a SubGroup. |
| INVALID\_USE\_CASE | UseCases[%d] .Item: SubGroup tidak dapat hilang. Berikan Barang. |
| INVALID\_MEDIA | Solusi PromotionalMedia [%d] .Panjang judul tidak valid. Masukkan judul yang antara 1 dan 100 karakter dan coba lagi. |
| INVALID\_MEDIA | Panjang solusi PromotionalMedia [%d] .Description tidak valid. Masukkan Deskripsi antara 1 dan 200 karakter dan coba lagi. |
| INVALID\_MEDIA | URL tidak valid: %s Berikan URL baru untuk media yang disimpan di S3. |
| INVALID\_MEDIA | Lokasi media tidak dapat diakses: %s Berikan URL baru yang dapat diakses untuk media yang disimpan di salah satu lokasi berikut: [S3]. |
| INVALID\_MEDIA | Ukuran gambar melebihi %s. Berikan gambar yang berada di bawah %s. |
| INVALID\_MEDIA | Ukuran video melebihi %s. Berikan video yang berada di bawah %s. |
| INVALID\_MEDIA | Ukuran logo melebihi %s. Berikan logo yang berada di bawah %s. |
| INVALID\_MEDIA | Malware terdeteksi di %s. Menyediakan media tanpa malware. |
| INVALID\_MEDIA | Konten yang tidak pantas: %s terdeteksi. Menyediakan media tanpa konten yang tidak pantas |
| INVALID\_MEDIA | Konten eksplisit dalam %s: '{ExplicitContent}' terdeteksi. Menyediakan media tanpa konten eksplisit. |
| INVALID\_MEDIA | PromotionalMedia[%s] .Url: %s tidak dalam format yang didukung (%s). Gunakan gambar yang terbentuk dengan baik dalam format yang didukung: [JPEG, PNG]. |
| INVALID\_MEDIA | PromotionalMedia[%s] .Url: %s tidak dalam format yang didukung (%s). Gunakan video yang dibentuk dengan baik dalam format yang didukung: [MP4, MOV]. |
| INVALID\_MEDIA | LogoUrl di %s memiliki rasio aspek tidak valid. Berikan gambar dengan rasio aspek 1:1 (persegi) atau 2:1 (lebar). |
| INVALID\_MEDIA | Logo: %s memiliki dimensi yang tidak valid. Berikan gambar antara 120x120 dan 1080x1080 piksel. |
| INVALID\_MEDIA | PromotionalMedia[%d] .Type tidak didukung. Menyediakan PromotionalMedia dalam tipe yang didukung: %s |
| DUPLIKAT\_MEDIA | Media duplikat terdeteksi: [%s] Menyediakan item media tanpa duplikat. |
| INVALID\_MEDIA | PromotionalMedia[%d] .Url: Malware terdeteksi di %s. Menyediakan media tanpa malware. |
| JUGA\_BANYAK\_ITEM | Berikan tidak lebih dari %d %s. |
## Perbarui produk terkait
Anda dapat menggunakan API Katalog untuk memperbarui produk dan layanan yang disertakan dalam solusi Anda, termasuk produk AWS Marketplace dan produk non-AWS Marketplace.
Untuk memperbarui produk terkait, panggil operasi `StartChangeSet` API dengan jenis `UpdateRelatedProducts` perubahan, seperti yang ditunjukkan pada contoh berikut.
**catatan**
Jenis `UpdateRelatedProducts` perubahan berperilaku seperti operasi HTTP PATCH untuk atribut tingkat atas. Anda dapat menyediakan semua jenis produk AWS Marketplace saat ini seperti `AwsMarketplaceProducts` dalam`UpdateRelatedProducts`.
**Permintaan Sintaks**
```
POST /StartChangeSet HTTP/1.1
Content-type: application/json
{
"Catalog": "AWSMarketplace",
"ChangeSet": [
{
"ChangeType": "UpdateRelatedProducts",
"Entity": {
"Type": "Solution@1.0",
"Identifier": "soln-123456"
},
"DetailsDocument": {
"IntegrationDescription": "How to use the products in this solution (usage guide)",
"AwsMarketplaceProducts": [
{
"ProductId": "prod-123"
},
{
"ProductId": "prod-456"
}
],
"NonAwsMarketplaceProducts": [
{
"Type": "Hardware",
"Title": "Diamond engine",
"Description": "Hardware details",
"Url": "https://example.com/hardware-product-specs.html"
}
]
}
}
]
}
```
Berikan informasi untuk bidang untuk menambahkan jenis `UpdateRelatedProducts` perubahan:
+ `Entity`(object) (required) - Jenis entitas bernama yang diperbarui.
+ `Identifier`(string) (wajib) - ID solusi.
+ `Type`(string) (wajib) - Harus`Solution@1.0`.
+ `DetailsDocument`(objek) (wajib) — Rincian permintaan. Setiap bidang bersifat opsional, tetapi Anda harus menyertakan setidaknya satu perubahan untuk memperbarui.
+ `IntegrationDescription`(string) — Deskripsi tentang bagaimana produk bekerja sama dalam solusi ini. Panjang maks: 5000 karakter. Tidak boleh berisi spasi putih atau karakter kontrol di depan atau belakang.
+ `AwsMarketplaceProducts`(berbagai objek) — Produk AWS Marketplace yang disertakan dalam solusi ini. Maks 5 item
+ `ProductId`(string) — ID produk AWS Marketplace (UUID atau string yang dimulai dengan`prod-`). Panjang maks: 50 karakter.
+ `NonAwsMarketplaceProducts`(array objek) — Produk tidak tersedia di AWS Marketplace. Maks 5 item.
+ `Type`(string) (wajib) — Jenis produk. Nilai yang mungkin:`Software`,`Consulting`,`Hardware`,`Communication`,`Professional Service`,`Managed Service`,`Value-Added Resale`, `Training`
+ `Title`(string) (wajib) — Judul produk. Panjang maks: 255 karakter. Tidak boleh berisi spasi putih, jeda baris, atau karakter kontrol di depan atau belakang.
+ `Description`(string) (opsional) — Deskripsi produk. Panjang maks: 220 karakter. Tidak boleh berisi spasi putih atau karakter kontrol di depan atau belakang.
+ `Url`(string) (opsional) — URL ke informasi lebih lanjut tentang produk. Panjang maks: 2048 karakter. Harus berupa url https.
**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.
Untuk memeriksa status permintaan, gunakan AWS Marketplace Management Portal atau hubungi `DescribeChangeSet` API.
**Kesalahan Asinkron**
Selain kesalahan [asinkron umum, kesalahan](#solution-error-codes) berikut khusus untuk `UpdateRelatedProducts` tindakan di AWS 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, lihat [Bekerja dengan set perubahan](https://docs.aws.amazon.com/marketplace/latest/APIReference/catalog-apis.html#working-with-change-sets).
| Kode kesalahan | Pesan kesalahan |
| --- | --- |
| INCOMPATIBLE\_OPERATION\_UPDATE\_RELATED\_PRODUCTS\_SOLUTION | Operasi untuk memperbarui produk terkait tidak didukung untuk solusi publik. Untuk membuat perubahan ini, pertama-tama ubah visibilitas solusi menjadi terbatas dan coba lagi. |
| TIDAK VALID\_ AWS\_MARKETPLACE\_PRODUCTS | Produk AWS Marketplace '%s' tidak tersedia untuk akun Anda. Pilih produk Publik atau produk Terbatas di mana Anda memiliki akses daftar izin, atau hubungi penjual untuk meminta akses. |
| TIDAK VALID\_ AWS\_MARKETPLACE\_PRODUCTS | Tipe produk tertentu '%s' tidak didukung. Berikan salah satu jenis produk yang valid ini: [AmiProduct, SaasProduct,, ContainerProduct, MachineLearningProduct ProfessionalServicesProduct, DataProduct] dan coba lagi. |
| TIDAK VALID\_ AWS\_MARKETPLACE\_PRODUCTS | Produk '%s' tidak ditemukan. Berikan ID produk yang valid dalam katalog yang sama. |
| TIDAK VALID\_TIDAK\_ AWS\_MARKETPLACE\_PRODUCTS | URL produk Non-AWS Marketplace yang ditentukan tidak dapat diakses: [%s]. Verifikasi bahwa URL valid dan dapat diakses publik, dan coba lagi. |
| INVALID\_INTEGRATION\_DESCRIPTION | Berikan solusi IntegrationDescription antara 1 dan 5000 karakter. |
| TIDAK VALID\_TIDAK\_ AWS\_MARKETPLACE\_PRODUCTS | Solusi NonAwsMarketplaceProduct [%d] .Panjang judul tidak valid. Masukkan Deskripsi antara 1 dan 255 karakter dan coba lagi. |
| TIDAK VALID\_TIDAK\_ AWS\_MARKETPLACE\_PRODUCTS | Panjang solusi NonAwsMarketplaceProduct [%d] .Description tidak valid. Masukkan Deskripsi antara 1 dan 220 karakter dan coba lagi. |
| TIDAK VALID\_TIDAK\_ AWS\_MARKETPLACE\_PRODUCTS | Solusi NonAwsMarketplaceProduct [%d] .Panjang tipe tidak valid. Masukkan Tipe yang antara 1 dan 50 karakter dan coba lagi. |
| TIDAK VALID\_TIDAK\_ AWS\_MARKETPLACE\_PRODUCTS | NonAwsMarketplaceProduct[%d] .Type bukan tipe produk non-AWS Marketplace yang valid. Menyediakan salah satu jenis produk non-AWS Marketplace berikut: [%s] |
| TIDAK VALID\_TIDAK\_ AWS\_MARKETPLACE\_PRODUCTS | Nilai NonAwsMarketplaceProduct [%d] .Title diperlukan. Tentukan nilai Judul dan coba lagi. |
| TIDAK VALID\_TIDAK\_ AWS\_MARKETPLACE\_PRODUCTS | Nilai NonAwsMarketplaceProduct [%d] .Type diperlukan. Tentukan nilai Type dan coba lagi. |
| TOO\_MANY\_PRODUCTS | Jumlah maksimum produk AWS Marketplace yang dapat Anda tautkan adalah %d. Hapus produk tertaut yang ada sebelum menambahkan yang baru. |
| TOO\_MANY\_PRODUCTS | Jumlah maksimum produk AWS Marketplace yang tidak dapat Anda tambahkan adalah %d. Hapus produk AWS Marketplace yang tidak ada sebelum menambahkan yang baru. |
| TIDAK VALID\_ AWS\_MARKETPLACE\_PRODUCTS | ID produk AWS Marketplace duplikat tidak diizinkan. Setiap ID produk harus unik dalam solusi Anda. |
| INVALID\_REMOVE\_OPERATION | Operasi tidak valid, Anda tidak dapat menghapus semua produk. |
## Lepaskan solusi
Anda dapat menggunakan API Katalog untuk mempublikasikan `Draft` solusi ke dalam `Limited` visibilitas di AWS Marketplace.
Jenis `ReleaseSolution` perubahan memvalidasi bahwa semua bidang yang diperlukan untuk `Limited` solusi ada. Kemudian memindahkan solusi dari `Draft` `Limited` visibilitas. Setelah solusi dalam `Limited` visibilitas, Anda tidak dapat memindahkannya kembali ke `Draft` visibilitas.
Untuk merilis solusi, panggil operasi `StartChangeSet` API dengan tipe `ReleaseSolution` perubahan, seperti yang ditunjukkan pada contoh berikut.
**Permintaan Sintaks**
```
POST /StartChangeSet HTTP/1.1
Content-type: application/json
{
"Catalog": "AWSMarketplace",
"ChangeSet": [
{
"ChangeType": "ReleaseSolution",
"Entity": {
"Type": "Solution@1.0",
"Identifier": "soln-1234abcd"
},
"DetailsDocument": {}
}
]
}
```
Berikan informasi untuk bidang untuk menambahkan jenis `ReleaseSolution` perubahan:
+ `Entity`(object) (required) - Jenis entitas bernama yang dirilis.
+ `Identifier`(string) (wajib) - ID solusi.
+ `Type`(string) (wajib) - Harus`Solution@1.0`.
+ `DetailsDocument`(objek) (wajib) - Harus berupa objek kosong. Jenis perubahan `ReleaseSolution` tidak menerima detail apa pun.
**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. Anda dapat memeriksa status permintaan melalui AWS Marketplace Management Portal, atau langsung melalui Catalog API menggunakan operasi `DescribeChangeSet` API.
**Kesalahan Asinkron**
Selain kesalahan [asinkron umum, kesalahan](#solution-error-codes) berikut khusus untuk `ReleaseSolution` tindakan di AWS 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, lihat [Bekerja dengan set perubahan](https://docs.aws.amazon.com/marketplace/latest/APIReference/catalog-apis.html#working-with-change-sets).
| Kode kesalahan | Pesan kesalahan |
| --- | --- |
| MISSING\_REQUIRED\_FIELDS | Permintaan tidak memiliki parameter yang diperlukan: [%s]. Tentukan nilai untuk semua parameter yang diperlukan dan coba lagi. |
| INCOMPATIBLE\_OPERATION\_RELEASE\_SOLUTION | Jenis perubahan hanya dapat dipanggil pada Solusi dalam status Draf. Perbarui visibilitas Solusi ke Draf dan coba lagi. |
## Perbarui opsi keterlibatan pembeli
Anda dapat menggunakan API Katalog untuk mengonfigurasi cara pembeli berinteraksi dengan Anda tentang solusi Anda.
**catatan**
Untuk menggunakan jenis perubahan ini, Anda harus memiliki pendaftaran aktif dalam program [APN Customer Engagements (ACE](https://aws.amazon.com/partners/programs/ace/)). Anda juga harus menautkan akun AWS Anda dengan akun AWS Partner Central yang telah terdaftar di ACE. Untuk petunjuk, lihat [Menautkan akun AWS Partner Central dan AWS](https://docs.aws.amazon.com/partner-central/latest/getting-started/account-linking.html).
Untuk memperbarui opsi keterlibatan pembeli, panggil operasi `StartChangeSet` API dengan jenis `UpdateBuyerEngagementOptions` perubahan, seperti yang ditunjukkan pada contoh berikut.
**Permintaan Sintaks**
```
POST /StartChangeSet HTTP/1.1
Content-type: application/json
{
"Catalog": "AWSMarketplace",
"ChangeSet": [
{
"ChangeType": "UpdateBuyerEngagementOptions",
"Entity": {
"Type": "Solution@1.0",
"Identifier": "soln-1234abcd"
},
"DetailsDocument": [
{
"EngagementOption": "RequestProductDemo"
},
{
"EngagementOption": "RequestPrivateOffer"
}
]
}
]
}
```
Berikan informasi untuk bidang untuk menambahkan jenis `UpdateBuyerEngagementOptions` perubahan:
+ `Entity`(object) (required) - Jenis entitas bernama yang diperbarui.
+ `Identifier`(string) (wajib) - ID solusi.
+ `Type`(string) (wajib) - Harus`Solution@1.0`.
+ `DetailsDocument`(array objek) (wajib) — Opsi keterlibatan pembeli untuk mengaktifkan.
+ `EngagementOption`(string) (wajib) - Jenis opsi keterlibatan. Nilai-nilai yang valid: `RequestPrivateOffer`, `RequestProductDemo`.
**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.
Untuk memeriksa status permintaan, gunakan AWS Marketplace Management Portal atau hubungi `DescribeChangeSet` API.
**Kesalahan Asinkron**
Selain kesalahan [asinkron umum, kesalahan](#solution-error-codes) berikut khusus untuk `UpdateBuyerEngagementOptions` tindakan di AWS 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, lihat [Bekerja dengan set perubahan](https://docs.aws.amazon.com/marketplace/latest/APIReference/catalog-apis.html#working-with-change-sets).
| Kode kesalahan | Pesan kesalahan |
| --- | --- |
| INELIGIBLE\_SELLER | Validasi kelayakan ACE belum lengkap. Untuk melanjutkan: 1) Tautkan akun AWS Marketplace Anda ke akun APN Anda, 2) Lengkapi persyaratan kelayakan ACE. |
## Perbarui visibilitas solusi
Anda dapat menggunakan API Katalog untuk memperbarui visibilitas solusi di AWS Marketplace.
Anda dapat mengatur visibilitas target ke`Limited`,`Public`, atau`Restricted`.
+ **`Limited`**— Solusinya selesai dan telah berhasil menyelesaikan jenis `ReleaseSolution` perubahan. Anda dapat melihat detail situs web pembeli dari solusi dalam visibilitas ini. Di situs web pembeli AWS Marketplace, solusinya hanya dapat dilihat oleh akun pemilik, pemilik setiap produk AWS Marketplace yang disertakan dalam solusi, dan tim AWS Marketplace Seller Operations.
+ **`Public`**— Solusinya terlihat di AWS Marketplace. Pembeli dapat melihat dan terlibat dengan solusinya.
+ **`Restricted`**— Solusinya tidak lagi terlihat oleh publik di situs web pembeli AWS Marketplace.
**catatan**
Untuk memindahkan solusi ke `Public` visibilitas, Anda harus memenuhi persyaratan berikut:
Anda harus memiliki profil publik di AWS Marketplace.
Solusinya harus tidak memiliki `Public` produk non-produk.
Solusinya harus memiliki setidaknya 2 produk `Public` AWS Marketplace.
Solusinya harus memiliki setidaknya 1 produk AWS Marketplace dari akun AWS yang sama.
Solusinya harus mengaktifkan opsi keterlibatan `RequestPrivateOffer` pembeli.
Tim AWS Marketplace Seller Operations meninjau semua permintaan untuk memindahkan solusi ke `Public` visibilitas. Untuk dukungan, lihat [Mendapatkan dukungan untuk AWS Marketplace](https://docs.aws.amazon.com/marketplace/latest/buyerguide/getting-support.html).
Bila Anda menyetel `TargetVisibility` ke`Public`, jenis `UpdateVisibility` perubahan memerlukan peninjauan manual dari tim AWS Marketplace Seller Operations. Ini meningkatkan waktu eksekusi. Gunakan `UpdateVisibility` secara terpisah dalam set perubahannya sendiri.
Untuk memperbarui visibilitas solusi Anda, panggil operasi `StartChangeSet` API dengan tipe `UpdateVisibility` perubahan, seperti yang ditunjukkan pada contoh berikut.
**Permintaan Sintaks**
Untuk kapan `TargetVisibility` `Public` atau`Limited`.
```
POST /StartChangeSet HTTP/1.1
Content-type: application/json
{
"Catalog": "AWSMarketplace",
"ChangeSet": [
{
"ChangeType": "UpdateVisibility",
"Entity": {
"Type": "Solution@1.0",
"Identifier": "soln-1234abcd"
},
"DetailsDocument": {
"TargetVisibility": "Public"
}
}
]
}
```
Untuk kapan `TargetVisibility``Restricted`.
```
POST /StartChangeSet HTTP/1.1
Content-type: application/json
{
"Catalog": "AWSMarketplace",
"ChangeSet": [
{
"ChangeType": "UpdateVisibility",
"Entity": {
"Type": "Solution@1.0",
"Identifier": "soln-1234abcd"
},
"DetailsDocument": {
"TargetVisibility": "Restricted"
}
}
]
}
```
Berikan informasi untuk bidang untuk menambahkan jenis `UpdateVisibility` perubahan:
+ `Entity`(object) (required) - Jenis entitas bernama yang diperbarui.
+ `Identifier`(string) (wajib) - ID solusi.
+ `Type`(string) (wajib) - Harus`Solution@1.0`.
+ `DetailsDocument`(objek) (wajib) - Detail yang diperlukan untuk menjalankan set perubahan.
+ `TargetVisibility`(string) (wajib) - Visibilitas baru yang dimaksudkan dari solusi. Nilai yang mungkin:`Public`,`Limited`, dan`Restricted`.
**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.
Anda dapat memeriksa status permintaan melalui AWS Marketplace Management Portal, atau langsung melalui Catalog API menggunakan operasi `DescribeChangeSet` API.
Setelah memicu jenis perubahan ini dengan `TargetVisibility` as`Public`, dibutuhkan waktu hingga 37 hari untuk menyelesaikannya. Ini termasuk waktu yang dibutuhkan Tim Operasi Penjual AWS Marketplace untuk meninjau, mengaudit, dan menyetujui.
**Kesalahan Asinkron**
Kesalahan berikut khusus untuk `UpdateVisibility` tindakan di AWS 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, lihat [Bekerja dengan set perubahan](https://docs.aws.amazon.com/marketplace/latest/APIReference/catalog-apis.html#working-with-change-sets).
| Kode kesalahan | Pesan kesalahan |
| --- | --- |
| INVALID\_VISIBILITY\_TRANSITION | Solusinya tidak dapat dipindahkan kembali ke status Draft. Setelah dirilis, solusi hanya dapat bertransisi antara status Terbatas, Publik, dan Terbatas. |
| TOO\_FEW\_USE\_CASES | Setidaknya satu kasus penggunaan diperlukan untuk membuat solusi publik. Tambahkan kasus penggunaan dan coba lagi. |
| TOO\_FEW\_PUBLIC\_PRODUCTS | Minimal 2 produk AWS Marketplace publik diperlukan untuk membuat solusi publik. Tambahkan produk yang diperlukan dan coba lagi. |
| INCOMPATIBLE\_PRODUCTS | Solusinya berisi satu atau lebih produk AWS Marketplace non-publik. Untuk membuat solusi publik, hapus semua produk non-publik dan coba lagi. |
| TOO\_FEW\_SELF\_OWNED\_PRODUCTS | Solusinya memerlukan setidaknya satu produk AWS Marketplace yang dimiliki oleh pemilik solusi. Tambahkan produk AWS Marketplace dari akun Anda dan coba lagi. |
| INCOMPATIBLE\_BUYER\_ENGAGEMENT\_OPTIONS | Opsi keterlibatan RequestPrivateOffer pembeli harus diaktifkan untuk membuat solusi ini publik. Aktifkan RequestPrivateOffer dan coba lagi. |
| INCOMPATIBLE\_OPERATION\_UPDATE\_VISIBILITY | UpdateVisibility tidak didukung untuk solusi dalam status Draf. Publikasikan solusi terlebih dahulu dari Draft ke Limited menggunakan ReleaseSolution, lalu gunakan UpdateVisibility untuk mengubah ke Public atau Restricted. |
| LIMIT\_EXCEEDED\_TOO\_MANY\_PUBLIC\_SOLUTIONS | Akun ini telah mencapai batas 5 solusi publik. Perbarui solusi publik yang ada ke visibilitas Terbatas atau Terbatas dan coba lagi. |
| HILSING\_SELLER\_PROFILE\_INFORMATION | Profil penjual publik diperlukan untuk membuat solusi publik. Buat profil publik di akun penjual Anda dan coba lagi. |
## Kode kesalahan asinkron umum
Ada beberapa validasi asinkron yang berlaku di semua jenis perubahan solusi, seperti pemeriksaan validitas url dan karakter yang tidak didukung, dan kode kesalahan serta pesan galatnya tercantum di sini.
Setiap kolom URL yang disediakan harus menggunakan protokol HTTPS, dan sesuai dengan standar RFC2396 atau RFC 2732.
| Kode kesalahan | Pesan kesalahan |
| --- | --- |
| INVALID\_INPUT | Kolom '%s' tidak valid. Hapus karakter %s yang tidak didukung. |
| INVALID\_INPUT | Konten '%s' yang tidak pantas ditemukan di kolom %s. Berikan %s tanpa konten yang tidak pantas. |
| UNSUPPORTED\_CATALOG | Katalog yang diminta %s tidak didukung oleh tipe perubahan ini. |
| INVALID\_REMOVE\_OPERATION | Operasi tidak valid, Anda tidak dapat menghapus %s |
| AUDIT\_ERROR | (bervariasi berdasarkan hasil audit tim AWS Marketplace Seller Operations) |
## Siklus hidup solusi
Solusi berkembang melalui nilai visibilitas berikut:
+ `Draft`- Visibilitas awal setelah pembuatan. Anda dapat menambahkan informasi secara progresif menggunakan jenis perubahan lainnya.
+ `Limited`- Solusi lengkap dan terlihat oleh Anda dan pemilik produk untuk pratinjau. Anda mencapai ini dengan menggunakan`ReleaseSolution`.
+ `Public`- Solusi dapat dilihat oleh semua pembeli yang menjelajahi situs web AWS Marketplace. Ini membutuhkan validasi tambahan.
+ `Restricted`- Solusi tidak lagi terlihat oleh pembeli baru.
**penting**
Setelah solusi beralih dari `Draft` ke `Limited` visibilitas, Anda tidak dapat memindahkannya kembali`Draft`. `ReleaseSolution`memvalidasi bahwa semua bidang yang diperlukan untuk `Limited` solusi ada sebelum transisi ke `Limited` visibilitas.
### Persyaratan minimum untuk solusi lengkap
Untuk membuat solusi lengkap dan mempublikasikannya di luar status Draft, Anda memerlukan jenis dan atribut perubahan berikut:
+ **`CreateSolution`**: `Name`
+ **`UpdateInformation`**: `Title`, `ShortDescription`, `LongDescription`, `LogoUrl`
+ **`UpdateRelatedProducts`**:`IntegrationDescription`, setidaknya satu item di seluruh `AwsMarketplaceProducts` dan `NonAwsMarketplaceProducts`
+ **`ReleaseSolution`**
Contoh berikut menunjukkan cara membuat solusi lengkap dengan `Limited` visibilitas dalam satu set perubahan:
```
{
"Catalog": "AWSMarketplace",
"ChangeSet": [
{
"ChangeType": "CreateSolution",
"Entity": {
"Type": "Solution@1.0"
},
"ChangeName": "CreateSolutionChange",
"DetailsDocument": {
"Name": "complete_solution_example",
"Title": "Complete Solution Example"
}
},
{
"ChangeType": "UpdateInformation",
"Entity": {
"Type": "Solution@1.0",
"Identifier": "$CreateSolutionChange.Entity.Identifier"
},
"ChangeName": "UpdateInformationChange",
"DetailsDocument": {
"ShortDescription": "A comprehensive solution for customer needs",
"LongDescription": "This solution combines multiple products to address specific customer requirements in the advertising and marketing space.",
"LogoUrl": "https://s3.amazonaws.com/awsmp-logos/solution-logo.jpg",
"UseCases": [
{
"Group": "advertising_and_marketing",
"SubGroup": "ad_intelligence_and_measurement",
"Item": "amazon_ads_insights",
"Description": "Provides comprehensive advertising insights and measurement capabilities"
}
]
}
},
{
"ChangeType": "UpdateRelatedProducts",
"Entity": {
"Type": "Solution@1.0",
"Identifier": "$CreateSolutionChange.Entity.Identifier"
},
"ChangeName": "UpdateRelatedProductsChange",
"DetailsDocument": {
"AwsMarketplaceProducts": [
{
"ProductId": "prod-123"
}
],
"IntegrationDescription": "These products work together to provide end-to-end advertising analytics and optimization capabilities."
}
},
{
"ChangeType": "UpdateBuyerEngagementOptions",
"Entity": {
"Type": "Solution@1.0",
"Identifier": "$CreateSolutionChange.Entity.Identifier"
},
"ChangeName": "UpdateBuyerEngagementChange",
"DetailsDocument": [
{
"EngagementOption": "RequestPrivateOffer"
}
]
},
{
"ChangeType": "ReleaseSolution",
"Entity": {
"Type": "Solution@1.0",
"Identifier": "$CreateSolutionChange.Entity.Identifier"
},
"ChangeName": "ReleaseSolutionChange",
"DetailsDocument": {}
}
]
}
```
## Izin IAM untuk solusi
AWS Marketplace Catalog API menggunakan izin IAM standar. Lihat [Kontrol akses untuk AWS Marketplace Catalog API](https://docs.aws.amazon.com/marketplace/latest/APIReference/catalog-api-access-control.html) untuk detail selengkapnya.
Anda dapat menggunakan `AWSMarketplaceSellerProductFullAccess` untuk melakukan semua operasi yang diperlukan untuk mengakses Solusi melalui Catalog API dan Partner Central 3.0 di AWS Management Console.
### Contoh kebijakan IAM untuk solusi
Contoh kebijakan IAM berikut memungkinkan tindakan spesifik (`DescribeEntity`,`ListEntities`, dan`StartChangeSet`) pada `Solution@1.0` entitas. Anda dapat mempersempitnya lebih lanjut untuk membatasi akses prinsipal ke jenis perubahan tertentu pada ID entitas tertentu, atau memperluasnya untuk memungkinkan prinsipal juga beroperasi pada tipe entitas lain yang didukung oleh API Katalog.
```
{
"Statement": [
{
"Effect": "Allow",
"Action": [
"aws-marketplace:StartChangeSet"
],
"Resource": [
"arn:aws:aws-marketplace:us-east-1:123456789012:AWSMarketplace/Solution/*",
"arn:aws:aws-marketplace:us-east-1:123456789012:AWSMarketplace/ChangeSet/*"
],
"Condition": {
"StringEquals": {
"catalog:ChangeType": [
"CreateSolution",
"UpdateInformation",
"UpdateRelatedProducts",
"ReleaseSolution",
"UpdateBuyerEngagementOptions",
"UpdateVisibility"
]
}
}
},
{
"Effect": "Allow",
"Action": [
"aws-marketplace:ListEntities",
"aws-marketplace:DescribeEntity"
],
"Resource": [
"arn:aws:aws-marketplace:us-east-1:123456789012:AWSMarketplace/Solution/*"
]
},
{
"Effect": "Allow",
"Action": [
"aws-marketplace:DescribeChangeSet",
"aws-marketplace:ListChangeSets",
"aws-marketplace:CancelChangeSet"
],
"Resource": [
"arn:aws:aws-marketplace:us-east-1:123456789012:AWSMarketplace/ChangeSet/*"
]
},
{
"Effect": "Allow",
"Action": [
"aws-marketplace:TagResource",
"aws-marketplace:UntagResource",
"aws-marketplace:ListTagsForResource"
],
"Resource": [
"arn:aws:aws-marketplace:us-east-1:123456789012:AWSMarketplace/Solution/*",
"arn:aws:aws-marketplace:us-east-1:123456789012:AWSMarketplace/ChangeSet/*"
]
}
]
}
```
### Membatasi akses ke solusi spesifik
Anda dapat membatasi akses ke solusi tertentu dengan menggunakan ID solusi di ARN sumber daya:
```
{
"Statement": [
{
"Effect": "Allow",
"Action": [
"aws-marketplace:DescribeEntity",
"aws-marketplace:StartChangeSet"
],
"Resource": [
"arn:aws:aws-marketplace:us-east-1:123456789012:AWSMarketplace/Solution/soln-specific123"
]
}
]
}
```
### Membatasi akses ke jenis perubahan tertentu
Anda dapat membatasi akses ke jenis perubahan tertentu menggunakan tombol kondisi:
```
{
"Statement": [
{
"Effect": "Allow",
"Action": [
"aws-marketplace:StartChangeSet"
],
"Resource": [
"arn:aws:aws-marketplace:us-east-1:123456789012:AWSMarketplace/Solution/*"
],
"Condition": {
"StringEquals": {
"catalog:ChangeType": [
"UpdateInformation",
"UpdateRelatedProducts"
]
}
}
}
]
}
```