Solusi di AWS Marketplace dan AWS Partner Central Entitas solusi Memulai dengan solusi Daftar solusi Anda Dapatkan detail solusi Daftar riwayat perubahan untuk solusi Menandai solusi dan mengubah set Buat solusi Perbarui informasi solusi Perbarui produk terkait Lepaskan solusi Perbarui opsi keterlibatan pembeli Perbarui visibilitas solusi Kode kesalahan asinkron umum Siklus hidup solusi Izin IAM untuk solusi

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. 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.

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), 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.

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 adalahSolution@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 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 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.

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 dan Menambahkan tag ke entitas dan mengubah set selama pembuatan.

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), danReleaseSolution. 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 HarusSolution@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 danChangeSetArn:


{
  "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 adaSUCCEEDED), ID solusi baru akan dihasilkan.

Kesalahan Asinkron

CreateSolutiontindakan mengembalikan kesalahan tertentu, selain kesalahan asinkron umum. Anda menerima kesalahan ini dari DescribeChangeSet setelah set perubahan selesai diproses. Untuk mempelajari cara mendapatkan status permintaan perubahan, lihat Bekerja dengan set perubahan.

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 diDetailsDocument, alur kerja memvalidasi input Anda dan menimpa nilai yang ada.
Jika bidang tingkat atas tidak ada diDetailsDocument, 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) - HarusSolution@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.
- 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.
  - Type(string) (wajib) - Entah Image atauVideo.
  - 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 untuk nilai aktif yang diterima dan label pengantar. 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.
  - SubGroup(string) - Gunakan grup kasus dalam kategori. Harus menjadi salah satu SubGroup nilai dalam daftar kategori kasus penggunaan.
  - Item(string) - Kasus penggunaan khusus. Harus menjadi salah satu Nilai item dalam daftar kategori kasus penggunaan.
  - 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.

catatan

Saat memanggil jenis UpdateInformation perubahan, Anda selalu dapat memberikan subset bidang yang akan diperbarui di DetailsDocument objek. Namun, sebelum memindahkan solusi dari Draft keLimited, bidang berikut harus diatur dengan benar:Title,ShortDescription,LongDescription, danLogoUrl.

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 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.

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.

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 dalamUpdateRelatedProducts.

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) - HarusSolution@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 denganprod-). 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 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.

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) - HarusSolution@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 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.

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). 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.

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) - HarusSolution@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 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.

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 keLimited,Public, atauRestricted.

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.

Bila Anda menyetel TargetVisibility kePublic, 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 atauLimited.


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 TargetVisibilityRestricted.


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) - HarusSolution@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, danRestricted.

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 asPublic, 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.

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 menggunakanReleaseSolution.
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 kembaliDraft. ReleaseSolutionmemvalidasi 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 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, danStartChangeSet) 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"
          ]
        }
      }
    }
  ]
}

Awas Javascript dinonaktifkan atau tidak tersedia di browser Anda.

Untuk menggunakan Dokumentasi AWS, Javascript harus diaktifkan. Lihat halaman Bantuan browser Anda untuk petunjuk.

Konvensi Dokumen

Bekerja dengan solusi multi-produk

Bekerja dengan set penawaran