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 otorisasi penjualan kembali menggunakan AWS Marketplace API
Anda dapat menggunakan AWS Marketplace Catalog API untuk mengotomatiskan tugas untuk bekerja dengan Otorisasi Penjualan Kembali.
Sementara * produk * menjelaskan apa yang dijual AWS Marketplace, Otorisasi * Penjualan Kembali * (juga dikenal sebagai peluang) menjelaskan syarat dan aturan mengenai bagaimana produk ini diizinkan untuk dijual kembali. AWS Marketplace*CPPO * adalah target Otorisasi Penjualan Kembali.
Otorisasi Penjualan Kembali memiliki kumpulan syarat dan aturan yang akan diterima untuk perjanjian pengecer antara produsen dan mitra saluran. Menerima ketentuan Otorisasi Penjualan Kembali memungkinkan pengecer untuk membuat penawaran untuk produk sesuai ketentuan yang dinyatakan dalam persyaratan.
Ada dua jenis aturan dalam Otorisasi Penjualan Kembali:
+ **AvailabilityRule**— Mengontrol siklus hidup Otorisasi Penjualan Kembali di AWS Marketplace.
+ **PartnerTargetingRule **— Menentukan apakah Otorisasi Penjualan Kembali harus dapat diakses oleh kumpulan mitra saluran tertentu.
Lihat sumber daya berikut:
+ Untuk lab end-to-end dengan contoh kode kerja, lihat [ Lab: Mengotorisasi reseller ](https://catalog.workshops.aws/mpseller/en-US/manage-offers-with-api/authorize-a-reseller) di bengkel pen *AWS Marketplace jual. *
+ Untuk contoh kode permintaan API, lihat [ contoh [ Python ](https://github.com/aws-samples/aws-marketplace-reference-code/tree/main/python/src/catalog_api/resale_authorization) dan ](https://github.com/aws-samples/aws-marketplace-reference-code/tree/main/java/resources/changeSets/channel_partner_offers) Java di Sam *AWS pel * pada GitHub.
+ Untuk video tentang membuat otorisasi penjualan kembali, lihat [ Membuat Otorisasi Penjualan Kembali Menggunakan API Katalog aktif. AWS Marketplace](https://www.youtube.com/watch?v=vLIbvFYI974) YouTube
Topik berikut menjelaskan cara menggunakan API Katalog untuk membuat dan memperbarui Otorisasi Penjualan Kembali:
**Topics**
+ [Prasyarat Otorisasi Penjualan Kembali](#prerequisites)
+ [Buat Otorisasi Penjualan Kembali baru](#create-resale-authorization)
+ [Perbarui penargetan pembeli](#update-buyer-targeting)
+ [Perbarui ketersediaan](#update-availability-resale-auth)
+ [Perbarui validitas perjanjian bertanggal di masa depan](#update-validity-fda)
+ [Perbarui sumber daya hukum](#update-existing-legal-terms)
+ [Perbarui harga](#update-existing-pricing-terms)
+ [Perbarui jadwal pembayaran](#update-payment-schedule-details)
+ [Perbarui ketentuan pembayaran bersih](#update-resale-net-payment-terms)
+ [Perbarui rincian Otorisasi Penjualan Kembali](#update-resale-auth-information)
+ [Batasi Otorisasi Penjualan Kembali](#restricte-resale-auth)
+ [Melepaskan Otorisasi Penjualan Kembali dan membuatnya terlihat oleh Mitra Saluran](#release-resale-auth)
+ [Jelaskan Otorisasi Penjualan Kembali yang ada](#describe-entity-resale-auth)
## Prasyarat Otorisasi Penjualan Kembali
Untuk menggunakan Otorisasi Penjualan Kembali, vendor perangkat lunak independen (ISV) dan Mitra AWS Marketplace Saluran harus membuat peran terkait layanan yang memberikan izin berbagi sumber daya ke. AWS Jika kedua grup tidak melakukan prasyarat ini, tidak AWS dapat membagikan sumber daya otorisasi dari ISV ke Mitra Sal AWS Marketplace uran. Untuk informasi selengkapnya, lihat [ Menggunakan peran untuk Otorisasi Penjualan Kembali AWS Marketplace](https://docs.aws.amazon.com/marketplace/latest/userguide/using-roles-for-resale-authorization.html) di Panduan * Pen *AWS Marketplace jual.
## Buat Otorisasi Penjualan Kembali baru
Anda dapat menggunakan API Katalog untuk membuat Otorisasi Penjualan Kembali baru di AWS Marketplace.
Jika permintaan Anda berhasil diproses, AWS Marketplace Catalog API menghasilkan Otorisasi Penjualan Kembali dalam `Draft` status untuk Anda. Ini adalah Otorisasi Penjualan Kembali yang tidak lengkap dan tidak terlihat oleh mitra saluran di AWS Marketplace dalamnya.
Gunakan jenis `Update` perubahan untuk menyelesaikan Otorisasi Penjualan Kembali. Setelah Otorisasi Penjualan Kembali selesai, gunakan jenis `ReleaseResaleAuthorization` perubahan untuk menyelesaikan proses pembuatan Otorisasi Penjualan Kembali dan lepaskan Otorisasi Penjualan Kembali, yang akan memvalidasi seluruh Otorisasi Penjualan Kembali dan membuatnya terlihat oleh mitra saluran di dalamnya. AWS Marketplace
Untuk membuat Otorisasi Penjualan Kem `Draft` bali dalam status, pang `StartChangeSet` gil operasi API dengan jenis `CreateResaleAuthorization` perubahan, seperti yang ditunjukkan pada contoh berikut.
**Minta Sintaks **
```
POST /StartChangeSet HTTP/1.1
Content-type: application/json
{
"Catalog": "AWSMarketplace",
"ChangeSet":
[
{
"ChangeType": "CreateResaleAuthorization",
"ChangeName": "xyz",
"Entity":
{
"Type": "ResaleAuthorization@1.0"
},
"DetailsDocument":
{
"ProductId": "prod-ad8EXAMPLE51",
"Name": "Test ResaleAuthorization",
"Description": "Worldwide ResaleAuthorization for Test Product",
"ResellerAccountId": "777788889999"
}
}
]
}
```
Berikan informasi untuk bidang input untuk menambahkan jenis `CreateResaleAuthorization` perubahan:
+ **Entitas ** (objek) (wajib) — Otorisasi Penjualan Kembali Anda.
+ **Type ** (string) (required) — `Type` Itu selalu`ResaleAuthorization@1.0`.
+ **DetailsDocument**(objek) (wajib) — Spesifikasi permintaan.
+ **ProductId**(string) (wajib) — ID Produk yang digunakan untuk membuat otorisasi penjualan kembali.
+ **Nama ** (string) (wajib) — Nama yang terkait dengan nama ResaleAuthorization untuk keterbacaan yang lebih baik bagi Anda dan mitra saluran Anda.
+ **Deskripsi ** (string) (opsional) — Bidang teks bentuk bebas yang tersedia untuk menambahkan detail tentang. ResaleAuthorization
+ **ResellerAccountId**(string) (wajib) — Tambahkan mitra saluran yang ditargetkan Akun AWS yang dapat menjelaskan dan menggunakannya `ResaleAuthorization` untuk membuat penawaran pribadi.
**Sintaks Respons **
Kumpulan perubahan dibuat untuk permintaan Anda. Tanggapan terhadap permintaan ini memberi Anda `ChangeSetId` dan `ChangeSetArn` untuk set perubahan dan terlihat seperti berikut ini.
```
{
"ChangeSetId": "example123456789012abcdef",
"ChangeSetArn": "arn:aws:aws-marketplace:us-east-1:123456789012:AWSMarketplace/ChangeSet/example123456789012abcdef"
}
```
Permintaan perubahan ditambahkan ke antrian dan diproses.
Anda dapat memeriksa status permintaan melalui Portal Manajemen AWS Marketplace, atau langsung melalui Katalog API menggunakan operasi `[DescribeChangeSet](https://docs.aws.amazon.com/marketplace-catalog/latest/api-reference/API_DescribeChangeSet.html)` API.
Ketika permintaan selesai (jika `Status` ada`SUCCEEDED`), yang baru `ResaleAuthorization` dihasilkan. Meskipun `SUCCEEDED` status menunjukkan bahwa panggilan jenis `CreateResaleAuthorization` perubahan selesai, stat `ResaleAuthorization` usnya masih dalam `Draft` status.
Berikut ini menunjukkan respons dari operasi [ DescribeChangeSet ](https://docs.aws.amazon.com/marketplace-catalog/latest/api-reference/API_DescribeChangeSet.html) API.
```
{
"ChangeSetId": "example123456789012abcdef",
"ChangeSetArn": "arn:aws:aws-marketplace:us-east-1:123456789012:AWSMarketplace/ChangeSet/example123456789012abcdef",
"ChangeSetName": "Submitted by 123456789012",
"StartTime": "2021-05-27T22:21:26Z",
"EndTime": "2021-05-27T22:32:19Z",
"Status": "SUCCEEDED",
"ChangeSet":
[
{
"ChangeType": "CreateResaleAuthorization",
"Entity":
{
"Type": "ResaleAuthorization@1.0",
"Identifier": "resaleauthz-123456789"
},
"DetailsDocument":
{
"ProductId": "prod-ad8EXAMPLE51",
"Name": "Test ResaleAuthorization",
"Description": "Worldwide ResaleAuthorization for Test Product",
"ResellerAccountId": "777788889999",
"BulkRequestId": "84977023-5093-4a66-8b24-ef2c5a2f8b1f"
},
"ErrorDetailList":
[]
}
]
}
```
**Validasi Sinkron **
Validasi skema khusus untuk `CreateResaleAuthorization` tindakan di AWS Marketplace Catalog API. Validasi dilakukan saat Anda menelep `StartChangeSet` on. Jika permintaan tidak memenuhi persyaratan berikut, itu akan gagal dengan respons HTTP.
| Bidang masukan | Aturan validasi | Kode HTTP |
| --- | --- | --- |
| ProductId | Diperlukan
Tidak boleh nol atau kosong
Panjang harus antara 1 dan 50 karakter | 422 |
| ProductId | Pengguna harus diberi wewenang untuk membuat ResaleAuthorization untuk produk yang diberikan | 403 |
| ProductId | Harus produk yang ada di katalog dan bukan di Draft negara bagian Produk harus didukung untuk dijual kembali | 404 |
| Nama | Diperlukan
Tidak boleh nol atau kosong
Panjang harus antara 1 dan 100 karakter
Tidak ada karakter khusus yang diizinkan | 422 |
| Deskripsi | Opsional
Panjang harus antara 1 dan 255 karakter
Tidak ada karakter khusus yang diizinkan | 422 |
| ResellerAccountId | Diperlukan
Tidak boleh kosong
Akun AWS ID harus dalam format yang valid (angka 12 digit) | 422 |
| BulkRequestId | Opsional
Panjang harus antara 1 dan 50 karakter
Harus dalam format UUID | 422 |
| Properti yang tidak diketahui | Tidak ada properti tambahan yang diizinkan | 422 |
**Kesalahan Asinkron **
Kesalahan berikut khusus untuk `CreateResaleAuthorization ` tindakan di AWS Marketplace Catalog API. Kesalahan ini dikembalikan saat Anda memang `DescribeChangeSet` gil setelah set perubahan diproses. Untuk informasi selengkapnya tentang menggunakan `DescribeChangeSet` untuk mendapatkan status permintaan perubahan, lihat[Bekerja dengan set perubahan](catalog-apis.md#working-with-change-sets).
| Kode kesalahan | Pesan kesalahan |
| --- | --- |
| AKUN\_RESELLER\_TIDAK VALID | Berikan akun reseller yang valid. |
## Perbarui penargetan pembeli
Anda dapat menggunakan API Katalog untuk memperbarui pembeli yang menargetkan Otorisasi Penjualan Kembali Anda di AWS Marketplace.
Opsi penargetan yang ada yang tidak disertakan dalam permintaan terbaru akan dihapus dari Otorisasi Penjualan Kembali. Jenis perubahan ini opsional untuk rilis Otorisasi Penjualan Kembali.
Untuk memperbarui pembeli yang menargetkan Otorisasi Penjualan Kembali Anda, panggil operasi `StartChangeSet` API dengan jenis `UpdateBuyerTargetingTerms` perubahan, seperti yang ditunjukkan pada contoh berikut.
**Minta Sintaks **
```
POST /StartChangeSet HTTP/1.1
Content-type: application/json
{
"Catalog": "AWSMarketplace",
"ChangeSet": [
{
"ChangeType":"UpdateBuyerTargetingTerms",
"Entity":{
"Type": "ResaleAuthorization@1.0",
"Identifier": "resaleauthz-123456789"
},
"DetailsDocument":
{
"Terms":
[
{
"Type": "BuyerTargetingTerm",
"PositiveTargeting":
{
"BuyerAccounts":
[
"123456789012"
]
}
}
]
}
}
]
}
```
Berikan informasi untuk bidang untuk menambahkan jenis `UpdateBuyerTargetingTerms` perubahan:
+ **Entitas ** (objek) (wajib) — Otorisasi Penjualan Kembali Anda.
+ **Type ** (string) (required) — `Type` Itu selalu`ResaleAuthorization@1.0`.
+ **Identifier ** (string) (wajib) — ID Otorisasi Penjualan Kembali Anda. Untuk informasi selengkapnya, lihat [Pengidentifikasi](catalog-apis.md#identifier).
+ **DetailsDocument**(objek) (wajib) — Spesifikasi permintaan.
+ **Ketentuan ** (array struktur) (opsional) — Daftar istilah penargetan pembeli yang ingin Anda perbarui. Jika tujuannya bukan untuk menargetkan pembeli tertentu, maka bidang persyaratan dapat dilewati. `ResaleAuthorization` Secara default, `ResaleAuthorization` ditargetkan untuk semua pembeli. Istilah yang didukung adalah:
+ **BuyerTargetingTerms**(objek) (opsional) - Tentukan penargetan khusus pembeli untuk Anda. ResaleAuthorization
+ **Type ** (string) (required) — Kategori istilah yang diperbarui.
+ **PositiveTargeting**(objek) (wajib) - Mendefinisikan kriteria yang harus dipenuhi oleh profil pembeli mana pun untuk diizinkan akses ke`ResaleAuthorization`.
+ **BuyerAccounts**(array string) (opsional) — Daftar sebagai opsional. Anda dapat menambahkan pembeli yang ditargetkan Akun AWS. Jika tujuannya bukan `ResaleAuthorization` untuk menargetkan pembeli tertentu, maka bidang ini harus dihilangkan. Secara default, semua pembeli ditargetkan. Mitra saluran yang ditargetkan dapat memilih untuk membuat penawaran pribadi dan menargetkan subset pembeli, jika ditentukan.
**Sintaks Respons **
Kumpulan perubahan dibuat untuk permintaan Anda. Tanggapan terhadap permintaan ini memberi Anda `ChangeSetId` dan `ChangeSetArn` untuk set perubahan dan terlihat seperti berikut ini.
```
{
"ChangeSetId": "example123456789012abcdef",
"ChangeSetArn": "arn:aws:aws-marketplace:us-east-1:123456789012:AWSMarketplace/ChangeSet/example123456789012abcdef"
}
```
Permintaan perubahan ditambahkan ke antrian dan diproses. Ini termasuk memvalidasi informasi dengan tim Operasi Pen AWS Marketplace jual untuk memastikannya memenuhi AWS Marketplace pedoman. Proses validasi dapat memakan waktu mulai dari beberapa menit hingga beberapa jam.
Anda dapat memeriksa status permintaan melalui Portal Manajemen AWS Marketplace, atau langsung melalui Katalog API menggunakan operasi `[DescribeChangeSet](https://docs.aws.amazon.com/marketplace-catalog/latest/api-reference/API_DescribeChangeSet.html)` API.
**Validasi Sinkron **
Validasi skema khusus untuk `UpdateBuyerTargetingTerms` tindakan di AWS Marketplace Catalog API. Validasi ini dilakukan saat Anda menelep `StartChangeSet` on. Jika permintaan tidak memenuhi persyaratan berikut, itu akan gagal dengan respons HTTP.
| Bidang masukan | Aturan validasi |
| --- | --- |
| Istilah | Opsional
Tidak boleh nol atau kosong
Hanya "BuyerTargetingTerm" yang diperbolehkan dalam daftar
Ukuran daftar harus 1 (tidak ada kasus penggunaan hari ini yang memerlukan beberapa persyaratan pembeli) |
| BuyerTargetingTerm.PositiveTargeting | Diperlukan
Tidak boleh kosong |
| BuyerTargetingTerm.PositiveTargeting.BuyerAccounts | Opsional
Akun AWS ID harus dalam format yang valid (angka 12 digit)
Tidak boleh berisi lebih dari 25 akun |
| Properti yang tidak diketahui | Tidak ada properti tambahan yang diizinkan |
**Kesalahan Asinkron **
Kesalahan berikut khusus untuk `UpdateBuyerTargetingTerms` tindakan di AWS Marketplace Catalog API. Kesalahan ini dikembalikan saat Anda memang `DescribeChangeSet` gil setelah set perubahan diproses. Untuk informasi selengkapnya tentang menggunakan `DescribeChangeSet` untuk mendapatkan status permintaan perubahan, lihat[Bekerja dengan set perubahan](catalog-apis.md#working-with-change-sets).
| Kode kesalahan | Pesan kesalahan |
| --- | --- |
| PENARGETAN\_PEMBELI YANG TIDAK KOMPATIBEL | Setidaknya satu akun Pembeli harus hadir untuk ResaleAuthorization bersama PreExistingBuyerAgreement. |
## Perbarui ketersediaan
Anda dapat menggunakan API Katalog untuk membatasi ketersediaan berapa banyak penawaran pribadi yang dibuat atau sampai waktu tertentu penawaran pribadi dapat dibuat.
Secara default, nilainya adalah penggunaan tak terbatas dari Otorisasi Penjualan Kembali ini, meskipun Anda dapat memeriksa ketersediaan di bawah daftar aturan.
Untuk mengontrol ketersediaan dan kegunaan Otorisasi Penjualan Kembali Anda, `StartChangeSet` panggil operasi API dengan jenis `UpdateAvailability` perubahan, seperti yang ditunjukkan pada contoh berikut.
**Minta Sintaks **
```
POST /StartChangeSet HTTP/1.1
Content-type: application/json
{
"Catalog": "AWSMarketplace",
"ChangeSet":
[
{
"ChangeType": "UpdateAvailability",
"Entity":
{
"Type": "ResaleAuthorization@1.0",
"Identifier": "resaleauthz-123456789"
},
"DetailsDocument":
{
"AvailabilityEndDate": "2022-05-31",
"OffersMaxQuantity": 1
}
}
]
}
```
Berikan informasi untuk bidang untuk menambahkan jenis `UpdateAvailability` perubahan:
+ **Entitas ** (objek) (wajib) — Otorisasi Penjualan Kembali Anda.
+ **Type ** (string) (required) — `Type` Itu selalu`ResaleAuthorization@1.0`.
+ **Identifier ** (string) (wajib) — ID Otorisasi Penjualan Kembali Anda. Untuk informasi selengkapnya, lihat [Pengidentifikasi](catalog-apis.md#identifier).
+ **DetailsDocument**(objek) (wajib) — Spesifikasi permintaan.
+ **AvailabilityEndDate**(string) (opsional) — Tentukan tanggal akhir hingga Mitra Saluran dapat memanfa `ResaleAuthorization` atkannya untuk membuat penawaran. Mitra Saluran dapat menggunakan ini `ResaleAuthorization` beberapa kali hingga tanggal akhir yang ditentukan. Tanggal diwakili dalam format ISO\_8601.
+ **OffersMaxQuantity**(integer) (opsional) — Tentukan jumlah maksimum penawaran pribadi yang dapat dibuat menggunakan ResaleAuthorization. Ini tidak menentukan jumlah langganan.
**Sintaks Respons **
Kumpulan perubahan dibuat untuk permintaan Anda. Tanggapan terhadap permintaan ini memberi Anda `ChangeSetId` dan `ChangeSetArn` untuk set perubahan dan terlihat seperti berikut ini.
```
{
"ChangeSetId": "example123456789012abcdef",
"ChangeSetArn": "arn:aws:aws-marketplace:us-east-1:123456789012:AWSMarketplace/ChangeSet/example123456789012abcdef"
}
```
Permintaan perubahan ditambahkan ke antrian dan diproses. Ini termasuk memvalidasi informasi dengan tim Operasi Pen AWS Marketplace jual untuk memastikannya memenuhi AWS Marketplace pedoman. Proses validasi dapat memakan waktu mulai dari beberapa menit hingga beberapa jam.
Anda dapat memeriksa status permintaan melalui Portal Manajemen AWS Marketplace, atau langsung melalui Katalog API menggunakan operasi `[DescribeChangeSet](https://docs.aws.amazon.com/marketplace-catalog/latest/api-reference/API_DescribeChangeSet.html)` API.
**Validasi Sinkron **
Validasi skema khusus untuk `UpdateAvailability` tindakan di AWS Marketplace Catalog API. Validasi dilakukan saat Anda menelep `StartChangeSet` on. Jika permintaan tidak memenuhi persyaratan berikut, itu akan gagal dengan respons HTTP
| Bidang masukan | Aturan validasi |
| --- | --- |
| OffersMaxQuantity | Opsional
Harus bilangan bulat non-negatif
Nilai yang diizinkan hanya “1" (Saat ini tidak ada kasus penggunaan untuk mendukung beberapa kuantitas) |
| AvailabilityEndDate | Opsional
Harus diformat ISO\_8601
Harus menjadi kencan di masa depan |
| Ketersediaan | Berikan salah OffersMaxQuantity satu atau AvailabilityEndDate. |
| Properti yang tidak diketahui | Tidak ada properti tambahan yang diizinkan |
**Kesalahan Asinkron **
Kesalahan berikut ini khusus untuk `UpdateAvailability` tindakan di AWS Marketplace Catalog API. Kesalahan ini dikembalikan saat Anda memang `DescribeChangeSet` gil setelah set perubahan diproses. Untuk informasi selengkapnya tentang menggunakan `DescribeChangeSet` untuk mendapatkan status permintaan perubahan, lihat[Bekerja dengan set perubahan](catalog-apis.md#working-with-change-sets).
| Kode kesalahan | Pesan kesalahan |
| --- | --- |
| DATUM\_AKHIR\_KETERSEDIAAN\_TIDAK VALID | Ber AvailabilityEndDate ikan yang sebelum semua ChargeDate masuk ResalePaymentScheduleTerms. |
| DATUM\_AKHIR\_KETERSEDIAAN\_TIDAK VALID | Menyediakan masa depan AvailabilityEndDate. |
## Perbarui validitas perjanjian bertanggal di masa depan
Anda dapat menggunakan API Katalog untuk memodifikasi dan mengontrol tanggal mulai layanan bertanggal di masa mendatang di AWS Marketplace.
Kumpulan perubahan ini tidak wajib untuk merilis Otorisasi Penjualan Kembali.
Untuk mengubah dan mengontrol durasi perjanjian produk dari Otorisasi Penjualan Kembali Anda, `StartChangeSet` panggil operasi API dengan jenis `UpdateBuyerValidityTerms` perubahan, seperti yang ditunjukkan pada contoh berikut.
**catatan**
Future-dated perjanjian hanya didukung untuk jenis produk SaaS.
**Minta Sintaks **
```
POST /StartChangeSet HTTP/1.1
Content-type: application/json
{
"Catalog": "AWSMarketplace",
"ChangeSet":
[
{
"ChangeType": "UpdateBuyerValidityTerms",
"Entity":
{
"Type": "ResaleAuthorization@1.0",
"Identifier": "resaleauthz-123456789"
},
"DetailsDocument":
{
"Terms":
[
{
"Type": "BuyerValidityTerm",
"MaximumAgreementStartDate": "2024-05-31"
}
]
}
}
]
}
```
Berikan informasi untuk bidang input untuk menambahkan jenis `UpdateBuyerValidityTerms` perubahan:
+ **Entitas ** (objek) (wajib) — Otorisasi Penjualan Kembali Anda.
+ **Type ** (string) (required) — `Type` Itu selalu`ResaleAuthorization@1.0`.
+ **Identifier ** (string) (wajib) — ID Otorisasi Penjualan Kembali Anda. Untuk informasi selengkapnya, lihat [Pengidentifikasi](catalog-apis.md#identifier).
+ **DetailsDocument**(objek) (wajib) — Spesifikasi permintaan.
+ **Ketentuan ** (array struktur) — Daftar ketentuan validitas perjanjian yang ingin Anda perbarui. Istilah yang didukung adalah:
+ **BuyerValidityTerm**(objek) — Mendefinisikan ketersediaan layanan untuk produk di Anda ResaleAuthorization.
+ **Type ** (string) — Kategori istilah yang diperbarui.
+ **MaximumAgreementStartDate**(string) (wajib) — Tentukan tanggal mulai perjanjian untuk produk yang ditawarkan. Penawaran bertanggal di masa mendatang tidak dapat melebihi tanggal mulai layanan ini. Tanggal diwakili dalam format ISO\_8601.
**Sintaks Respons **
Kumpulan perubahan dibuat untuk permintaan Anda. Tanggapan terhadap permintaan ini memberi Anda `ChangeSetId` dan `ChangeSetArn` untuk set perubahan dan terlihat seperti berikut ini.
```
{
"ChangeSetId": "example123456789012abcdef",
"ChangeSetArn": "arn:aws:aws-marketplace:us-east-1:123456789012:AWSMarketplace/ChangeSet/example123456789012abcdef"
}
```
Permintaan perubahan ditambahkan ke antrian dan diproses. Ini termasuk memvalidasi informasi dengan tim Operasi Pen AWS Marketplace jual untuk memastikannya memenuhi AWS Marketplace pedoman. Proses validasi dapat memakan waktu mulai dari beberapa menit hingga beberapa jam.
Anda dapat memeriksa status permintaan melalui Portal Manajemen AWS Marketplace, atau langsung melalui Katalog API menggunakan operasi `[DescribeChangeSet](https://docs.aws.amazon.com/marketplace-catalog/latest/api-reference/API_DescribeChangeSet.html)` API.
**Validasi Sinkron **
Validasi skema khusus untuk `UpdateBuyerValidityTerms` tindakan di AWS Marketplace Catalog API. Validasi dilakukan saat Anda menelep `StartChangeSet` on. Jika permintaan tidak memenuhi persyaratan berikut, itu akan gagal dengan respons HTTP.
| Bidang masukan | Aturan validasi |
| --- | --- |
| Istilah | Diperlukan
Tidak boleh nol atau kosong
Hanya "BuyerValidityTerm" yang diperbolehkan dalam daftar
Ukuran daftar harus 1 (tidak ada kasus penggunaan saat ini yang memerlukan beberapa ketentuan ketersediaan layanan) |
| MaximumAgreementStartDate | Diperlukan
Tidak boleh nol atau kosong
Harus tanggal di masa depan dan tidak boleh melebihi lebih dari 3 tahun dari sekarang
Harus diformat ISO\_8601 |
| Properti yang tidak diketahui | Tidak ada properti tambahan yang diizinkan |
**Kesalahan Asinkron **
Kesalahan berikut khusus untuk `UpdateBuyerValidityTerms ` tindakan di AWS Marketplace Catalog API. Kesalahan ini dikembalikan saat Anda memang `DescribeChangeSet` gil setelah set perubahan diproses. Untuk informasi selengkapnya tentang menggunakan `DescribeChangeSet` untuk mendapatkan status permintaan perubahan, lihat[Bekerja dengan set perubahan](catalog-apis.md#working-with-change-sets).
| Kode kesalahan | Pesan kesalahan |
| --- | --- |
| PRODUK\_TIDAK KOMPATIBEL | BuyerValidityTerm tidak didukung untuk produk. |
| TIDAK VALID\_MAKSIMAL\_PERJANJIAN\_MULAI\_TANGGAL MULAI | Berikan masa depan MaximumAgreementStartDate dengan batas yang diizinkan. |
## Perbarui sumber daya hukum
Anda dapat menggunakan API Katalog untuk mengganti persyaratan hukum yang ada sepenuhnya di AWS Marketplace.
Ketentuan hukum yang tidak termasuk dalam permintaan terbaru akan dihapus dari Otorisasi Penjualan Kembali. `BuyerLegalTerm`berisi EULA yang akan dimasukkan dalam perjanjian pembeli akhir dan `LegalTerm` termasuk Kontrak Pengecer yang akan dimasukkan dalam perjanjian pengecer antara mitra saluran dan ISV.
Untuk memperbarui ketentuan hukum Anda`ResaleAuthorization`, panggil operasi `StartChangeSet` API dengan jenis `UpdateLegalTerms` perubahan, seperti yang ditunjukkan pada contoh berikut.
**Minta Sintaks **
```
POST /StartChangeSet HTTP/1.1
Content-type: application/json
{
"Catalog": "AWSMarketplace",
"ChangeSet":
[
{
"ChangeType": "UpdateLegalTerms",
"Entity":
{
"Type": "ResaleAuthorization@1.0",
"Identifier": "resaleauthz-123456789"
},
"DetailsDocument":
{
"Terms":
[
{
"Type": "BuyerLegalTerm",
"Documents":
[
{
"Type": "CustomEula",
"Url": "https://my-public-bucket.s3.amazonaws.com/eula-example12345.txt"
}
]
},
{
"Type": "ResaleLegalTerm",
"Documents":
[
{
"Type": "CustomResellerContract",
"Url": "https://my-public-bucket.s3.amazonaws.com/reseller-example12345.txt"
}
]
}
]
}
}
]
}
```
Berikan informasi untuk bidang untuk menambahkan jenis `UpdateLegalTerms` perubahan:
+ **Entitas ** (objek) (wajib) — Otorisasi Penjualan Kembali Anda.
+ **Type ** (string) (required) — `Type` Itu selalu`ResaleAuthorization@1.0`.
+ **Identifier ** (string) (wajib) — ID Otorisasi Penjualan Kembali Anda. Untuk informasi selengkapnya, lihat [Pengidentifikasi](catalog-apis.md#identifier).
+ **DetailsDocument**(objek) (wajib) — Spesifikasi permintaan.
+ **I ** stilah (array struktur) (wajib) - Daftar istilah hukum. Istilah hukum yang didukung adalah:
+ **BuyerLegalTerm**(object) (required) — Mendefinisikan daftar perjanjian teks yang akan diusulkan kepada akseptor. Misalnya, perjanjian lisensi pengguna akhir (EULA).
+ **Type ** (string) (required) — Kategori istilah yang diperbarui.
+ **Dokumen ** (susunan struktur) (wajib) — Daftar referensi ke sumber daya hukum yang akan diusulkan kepada pembeli. Misalnya, EULA. Setiap referensi terdiri dari a `Type` dan a`URL`:
+ **Jenis ** (string) (wajib) — Jenis dokumen. Jenis dokumen yang tersedia adalah:
+ **StandardEula**— Kontrak Standar untuk AWS Marketplace. Untuk informasi selengkapnya, lihat [ SCMP ](https://docs.aws.amazon.com/marketplace/latest/userguide/standardized-license-terms.html#standard-contracts) di Panduan * Pen *AWS Marketplace jual. Anda tidak perlu memberikan URL untuk jenis ini karena dikelola oleh AWS Marketplace.
+ **EnterpriseEula**— Kontrak Perusahaan untuk AWS Marketplace. Untuk informasi selengkapnya, lihat DSA di Panduan Pen AWS Marketplace jual. Anda tidak perlu memberikan URL untuk jenis ini karena dikelola oleh AWS Marketplace.
+ **CustomEula**— EULA khusus disediakan oleh Anda sebagai produsen. URL untuk EULA yang disimpan dalam bucket S3 yang dapat diakses diperlukan untuk jenis dokumen ini.
+ **Ur ** l (string) (diperlukan secara kondisional) — URL ke dokumen hukum untuk dibaca pembeli. Ini diperlukan ketika Jenis kategori ada`CustomEula`.
+ **ResaleLegalTerm**(object) (opsional) — Mendefinisikan daftar perjanjian teks untuk diusulkan hanya kepada mitra saluran. Istilah ini tidak akan tersedia untuk pembeli.
+ **Type ** (string) (required) — Kategori istilah yang diperbarui.
+ **Dokumen ** (susunan struktur) (wajib) — Daftar referensi ke sumber daya hukum reseller yang akan diusulkan kepada mitra saluran.
+ **Jenis ** (string) (wajib) — Kategori dokumen. Jenis dokumen yang tersedia adalah:
+ **StandardResellerContract**— Kontrak Pengecer Standar untuk AWS Marketplace.
+ **CustomResellerContract**— Kontrak reseller khusus oleh Anda sebagai produsen. URL untuk kontrak reseller disimpan dalam bucket S3 yang dapat diakses dan diperlukan untuk jenis dokumen ini.
+ **Ur ** l (string) (diperlukan secara kondisional) — URL ke dokumen kontrak reseller untuk dibaca oleh mitra saluran. Ini diperlukan ketika Tipe ada CustomResellerContract.
**Sintaks Respons **
Kumpulan perubahan dibuat untuk permintaan Anda. Tanggapan terhadap permintaan ini memberi Anda `ChangeSetId` dan `ChangeSetArn` untuk set perubahan dan terlihat seperti berikut ini.
```
{
"ChangeSetId": "example123456789012abcdef",
"ChangeSetArn": "arn:aws:aws-marketplace:us-east-1:123456789012:AWSMarketplace/ChangeSet/example123456789012abcdef"
}
```
Permintaan perubahan ditambahkan ke antrian dan diproses. Ini termasuk memvalidasi informasi untuk memastikan bahwa itu memenuhi AWS Marketplace pedoman. Proses validasi dapat memakan waktu mulai dari beberapa menit hingga beberapa jam.
Anda dapat memeriksa status permintaan melalui Portal Manajemen AWS Marketplace, atau langsung melalui Katalog API menggunakan operasi `[DescribeChangeSet](https://docs.aws.amazon.com/marketplace-catalog/latest/api-reference/API_DescribeChangeSet.html)` API.
**Validasi Sinkron **
Validasi skema khusus untuk `UpdateLegalTerms` tindakan di AWS Marketplace Catalog API. Validasi dilakukan saat Anda menelep `StartChangeSet` on. Jika permintaan tidak memenuhi persyaratan berikut, itu akan gagal dengan respons HTTP.
| Bidang masukan | Aturan validasi | Kode HTTP |
| --- | --- | --- |
| Istilah | Diperlukan
Tidak boleh nol atau kosong | 422 |
| Ketentuan []. BuyerLegalTerm | Diperlukan
Tidak boleh nol atau kosong | 422 |
| Ketentuan []. ResaleLegalTerm | Opsional
Tidak boleh nol atau kosong jika ada | 422 |
| Ketentuan []. BuyerLegalTerm.Documents | Diperlukan
Tidak boleh nol atau kosong | 422 |
| Ketentuan []. BuyerLegalTerm.Documents[] .Jenis | Diperlukan
Tidak boleh nol atau kosong
Nilai yang diizinkan:+ StandardEula
+ EnterpriseEula
+ CustomEula | 422 |
| Ketentuan []. BuyerLegalTerm.Documents[] .URL | Diperlukan dan harus menjadi URL yang valid ketika “Type” adalah "CustomEula” Tidak boleh diberikan jika “Jenis” adalah salah satu dari [” StandardEula “," EnterpriseEula “] | 422 |
| Ketentuan []. ResaleLegalTerm.Documents | Diperlukan
Tidak boleh nol atau kosong | 422 |
| Ketentuan []. ResaleLegalTerm.Documents[] .Jenis | Diperlukan
Tidak boleh nol atau kosong Nilai yang diizinkan:+ StandardEula
+ CustomResellerContract | 422 |
| Ketentuan []. ResaleLegalTerm.Documents[] .URL | Diperlukan dan harus menjadi URL yang valid ketika “Type” adalah "CustomResellerContract”
Tidak boleh diberikan jika “Tipe” adalah salah satu dari [” StandardContract “] | 422 |
| Properti yang tidak diketahui | Tidak ada properti tambahan yang diizinkan | 422 |
**Kesalahan Asinkron **
Kesalahan berikut khusus untuk `UpdateLegalTerms` tindakan di AWS Marketplace Catalog API. Kesalahan ini dikembalikan saat Anda menelepon`DescribeChangeSet`, setelah set perubahan diproses. Untuk informasi selengkapnya tentang menggunakan `DescribeChangeSet` untuk mendapatkan status permintaan perubahan, lihat[Bekerja dengan set perubahan](catalog-apis.md#working-with-change-sets).
| Kode kesalahan | Pesan kesalahan |
| --- | --- |
| DOKUMEN LEGAL\_PEMBELI YANG TIDAK VALID | Berikan URL untuk dokumen hukum pembeli yang disimpan dalam bucket S3 yang dapat diakses. |
| TIDAK VALID\_RESALE\_LEGAL\_DOKUMEN | Berikan URL untuk dokumen hukum penjualan kembali yang disimpan dalam bucket S3 yang dapat diakses. |
| HILANG\_SYARAT-SYARAT\_WAJIB | Berikan a BuyerLegalTerm. |
## Perbarui harga
Anda dapat menggunakan API Katalog untuk mengganti persyaratan harga yang ada sepenuhnya di AWS Marketplace.
Ketentuan harga yang tidak termasuk dalam permintaan terbaru akan dihapus dari Otorisasi Penjualan Kembali. Anda dapat memperbarui harga diskon untuk produk Anda melalui API ini.
Untuk memperbarui detail harga untuk Otorisasi Penjualan Kembali Anda, panggil operasi `StartChangeSet` API dengan jenis `UpdatePricingTerms` perubahan, seperti yang ditunjukkan pada contoh berikut.
**Minta Sintaks **
```
POST /StartChangeSet HTTP/1.1
Content-type: application/json
{
"Catalog": "AWSMarketplace",
"ChangeSet":
[
{
"ChangeType": "UpdatePricingTerms",
"Entity":
{
"Type": "ResaleAuthorization@1.0",
"Identifier": "resaleauthz-123456789"
},
"DetailsDocument":
{
"PricingModel": "Contract",
"Terms":
[
{
"Type": "ResaleUsageBasedPricingTerm",
"CurrencyCode": "USD",
"RateCards":
[
{
"RateCard":
[
{
"DimensionKey": "m3.large",
"Price": "0.10"
},
{
"DimensionKey": "m4.xlarge",
"Price": "0.20"
}
]
}
]
},
{
"Type": "ResaleConfigurableUpfrontPricingTerm",
"CurrencyCode": "USD",
"RateCards":
[
{
"Selector":
{
"Type": "Duration",
"Value": "P12M"
},
"RateCard":
[
{
"DimensionKey": "m3.large",
"Price": "300"
},
{
"DimensionKey": "m4.xlarge",
"Price": "400"
}
],
"Constraints":
{
"MultipleDimensionSelection": "Allowed",
"QuantityConfiguration": "Allowed"
}
}
]
},
{
"Type": "ResaleFixedUpfrontPricingTerm",
"CurrencyCode": "USD",
"Duration": "P2M",
"Price": "200.0",
"Grants":
[
{
"DimensionKey": "Users",
"MaxQuantity": 10
}
]
}
]
}
}
]
}
```
Berikan informasi untuk bidang untuk menambahkan jenis `UpdatePricingTerms` perubahan:
+ **Entitas ** (objek) (wajib) — Otorisasi Penjualan Kembali Anda.
+ **Type ** (string) (required) — `Type` Itu selalu`ResaleAuthorization@1.0`.
+ **Identifier ** (string) (wajib) — ID Otorisasi Penjualan Kembali Anda. Untuk informasi selengkapnya, lihat [Pengidentifikasi](catalog-apis.md#identifier).
+ **DetailsDocument**(objek) (wajib) — Spesifikasi permintaan.
+ **PricingModel**(string) (wajib) — Model harga untuk penawaran Anda. Nilai yang mungkin untuk model penetapan harga adalah:
+ **Penggunaan ** — model Usage-based harga di mana pembeli akan ditagih untuk penggunaan produk Anda.
+ **Kontr ** ak — Dalam model penetapan harga berbasis kontrak, pembeli ditagih di muka untuk penggunaan produk Anda atau ditawarkan jadwal pembayaran yang fleksibel. Pembeli juga dapat membayar untuk penggunaan tambahan di atas kontrak mereka. Mitra saluran dapat menambahkan markup mereka ke jadwal pembayaran dan harga ini untuk setiap dimensi.
+ **Ketentuan ** (array struktur) (wajib) — Daftar istilah harga yang ingin Anda perbarui. Ketentuan harga yang didukung adalah:
+ **ResaleUsageBasedPricingTerm**(object) — Mendefinisikan model penetapan harga pay-as-you-go (PAYG) di mana pelanggan dikenakan biaya berdasarkan penggunaan produk.
+ **Type ** (string) (required) — Kategori istilah.
+ **CurrencyCode**(string) — Mendefinisikan mata uang untuk harga yang disebutkan dalam istilah ini. Saat ini, hanya USD yang didukung.
+ **RateCards**(array struktur) — Daftar kartu tarif.
+ **RateCard**(array struktur) — Kartu tarif menentukan tarif per unit untuk dimensi produk.
+ **DimensionKey**(string) — Dimensi di mana hak yang diberikan berlaku. Dimensi mewakili kategori kapasitas dalam suatu produk dan ditentukan ketika produk terdaftar di AWS Marketplace.
+ **Harga ** (string) — Harga per unit untuk dimensi produk yang digunakan untuk menghitung jumlah yang akan dikenakan.
+ **Kendala ** (objek) (opsional) — Mendefinisikan batasan bagaimana istilah dapat dikonfigurasi oleh akseptor.
+ **MultipleDimensionSelection**(string) (opsional) - Menentukan apakah pembeli diizinkan untuk memilih beberapa dimensi dalam kartu tarif. Kemungkinan nilainya adalah `Allowed` and `Disallowed`. Nilai default-nya adalah `Allowed`.
+ **QuantityConfiguration**(string) (opsional) — Menentukan apakah akseptor diizinkan untuk mengonfigurasi kuantitas untuk setiap dimensi dalam kartu tarif. Kemungkinan nilainya adalah `Allowed` and `Disallowed`. Nilai default-nya adalah `Allowed`.
+ **ResaleFixedUpfrontPricingTerm**(objek) — Mendefinisikan model penetapan harga pra-bayar di mana pelanggan dikenakan biaya di muka yang tetap.
+ **Type ** (string) (required) — Kategori istilah yang diperbarui.
+ **CurrencyCode**(string) — Mendefinisikan mata uang untuk harga yang disebutkan dalam istilah ini. Mendefinisikan mata uang untuk harga yang disebutkan dalam istilah ini. USD, AUD, EUR, GBP, dan JPY didukung.
+ **Harga ** (string) (wajib) — Jumlah tetap yang akan dibebankan kepada pelanggan ketika istilah ini diterima.
+ **Durasi ** (string) (wajib) — Durasi kontrak ResaleAuthorization. Bidang ini mendukung format ISO 8601.
+ **Hibah ** (susunan struktur) (wajib) — Hak yang akan diberikan kepada akseptor penetapan harga di muka tetap sebagai bagian dari pelaksanaan perjanjian.
+ **DimensionKey**(string) (wajib) — Kunci dimensi unik yang ditentukan dalam dokumen produk. Dimensi mewakili kategori kapasitas dalam suatu produk dan ditentukan ketika produk terdaftar di AWS Marketplace.
+ **MaxQuantity**(integer) (wajib) — Jumlah maksimum kapasitas yang dapat dimiliki pembeli atas dimensi produk yang diberikan. Jika tidak MaxQuantity disediakan, pembeli akan dapat menggunakan jumlah yang tidak terbatas dari dimensi yang diberikan.
**Sintaks Respons **
Kumpulan perubahan dibuat untuk permintaan Anda. Tanggapan terhadap permintaan ini memberi Anda `ChangeSetId` dan `ChangeSetArn` untuk set perubahan dan terlihat seperti berikut ini.
```
{
"ChangeSetId": "example123456789012abcdef",
"ChangeSetArn": "arn:aws:aws-marketplace:us-east-1:123456789012:AWSMarketplace/ChangeSet/example123456789012abcdef"
}
```
Permintaan perubahan ditambahkan ke antrian dan diproses. Ini termasuk memvalidasi informasi untuk memastikan bahwa itu memenuhi AWS Marketplace pedoman. Proses validasi dapat memakan waktu mulai dari beberapa menit hingga beberapa jam.
Anda dapat memeriksa status permintaan melalui Portal Manajemen AWS Marketplace, atau langsung melalui Katalog API menggunakan operasi `[DescribeChangeSet](https://docs.aws.amazon.com/marketplace-catalog/latest/api-reference/API_DescribeChangeSet.html)` API.
**Validasi Sinkron **
Validasi skema berikut khusus untuk `UpdatePricingTerms` tindakan di AWS Marketplace Catalog API. Validasi dilakukan saat Anda menelep `StartChangeSet` on. Jika permintaan tidak memenuhi persyaratan berikut, itu akan gagal dengan respons HTTP.
| Bidang masukan | Aturan validasi |
| --- | --- |
| Istilah | Diperlukan
Tidak boleh nol atau kosong
Setiap istilah harus menampilkan hanya satu kali Istilah yang diizinkan:+ \* ResaleUsageBasedPricingTerm
+ \* ResaleConfigurableUpfrontPricingTerm
+ \* ResaleFixedupfrontPricingTerm |
| Ketentuan []. ResaleUsageBasedPricingTerm.CurrencyCode | Diperlukan
Nilai yang diizinkan: USD |
| Ketentuan []. ResaleUsageBasedPricingTerm.Validity | Diperlukan
Tidak boleh nol atau kosong
Format yang diharapkan: durasi ISO 8601 |
| Ketentuan []. ResaleUsageBasedPricingTerm.RateCards | Diperlukan
Tidak boleh nol atau kosong |
| Ketentuan []. ResaleUsageBasedPricingTerm.RateCards[]. DimensionKey | Diperlukan
Tidak boleh nol atau kosong
Panjangnya harus antara 1 dan 60 |
| Ketentuan []. ResaleUsageBasedPricingTerm.RateCards[] .Harga | Diperlukan
Tidak boleh nol atau kosong
Tipe data adalah “String”
Harus non-negatif
Mendukung hingga 8 Desimal
Tidak ada karakter khusus yang didukung |
| Ketentuan []. ResaleConfigurableUpfrontPricingTerm.CurrencyCode | Diperlukan
Nilai yang diizinkan: ["USD”, “AUD”, “EUR”, “GBP”, “JPN"] |
| Ketentuan []. ResaleConfigurableUpfrontPricingTerm.RateCards[]. Selector.Type | Diperlukan
Tidak boleh nol atau kosong
Nilai yang diizinkan: Durasi |
| Ketentuan []. ResaleConfigurableUpfrontPricingTerm.RateCards[]. Selector.Value | Diperlukan
Tidak boleh nol atau kosong
Format yang diharapkan: durasi ISO 8601 |
| Ketentuan []. ResaleConfigurableUpfrontPricingTerm.RateCards[]. RateCard.DimensionKey | Diperlukan
Tidak boleh nol atau kosong
Panjangnya harus antara 1 dan 60 |
| Ketentuan []. ResaleConfigurableUpfrontPricingTerm.RateCards[]. RateCard.Price | Diperlukan
Tidak boleh nol atau kosong
Jenis data adalah “String”
Harus non-negatif
Mendukung hingga 6 Desimal
Tidak ada karakter khusus yang didukung |
| Ketentuan []. ResaleConfigurableUpfrontPricingTerm.RateCards[] .Kendala | Opsional |
| Ketentuan []. ResaleFixedUpfrontPricingTerm.CurrencyCode | Diperlukan Nilai yang diizinkan: ["USD”, “AUD”, “EUR”, “GBP”, “JPN"] |
| Ketentuan []. ResaleFixedUpfrontPricingTerm.Price | Diperlukan
Tidak boleh nol atau kosong
Jenis data adalah “String”
Harus non-negatif
Mendukung hingga 6 Desimal
Tidak ada karakter khusus yang didukung
Nilai yang diizinkan: 0.0 |
| Ketentuan []. ResaleFixedUpfrontPricingTerm.Duration | Diperlukan
Tidak boleh nol atau kosong
Format yang diharapkan: durasi ISO 8601 |
| Ketentuan []. ResaleFixedUpfrontPricingTerm.Grants[]. DimensionKey | Diperlukan
Tidak boleh nol atau kosong
Panjangnya harus antara 1 dan 60 |
| Ketentuan []. ResaleFixedUpfrontPricingTerm.Grants[]. MaxQuantty | Diperlukan
Tidak boleh nol atau kosong |
| Properti yang tidak diketahui | Tidak ada properti tambahan yang diizinkan |
**Kesalahan Asinkron **
Kesalahan berikut khusus untuk `UpdatePricingTerms` tindakan di AWS Marketplace Catalog API. Kesalahan ini dikembalikan saat Anda memang `DescribeChangeSet` gil setelah set perubahan diproses. Untuk informasi selengkapnya tentang menggunakan `DescribeChangeSet` untuk mendapatkan status permintaan perubahan, lihat[Bekerja dengan set perubahan](catalog-apis.md#working-with-change-sets).
| Kode kesalahan | Pesan kesalahan |
| --- | --- |
| KODE\_MATA UANG TIDAK VALID | Berikan hal yang CurrencyCode sama di semua ketentuan harga dan pembayaran. |
| PRODUK\_TIDAK KOMPATIBEL | Gunakan dimensi yang ada dan tersedia dalam produk di [x]. |
| DUPLIKAT\_DIMENSI\_KUNCI | Berikan kartu tarif dengan daftar kunci dimensi unik di [x] |
| KARTU RATE\_TIDAK VALID | Berikan dimensi yang memiliki satuan yang sama di [x] |
| KARTU RATE\_TIDAK VALID | Berikan kartu tarif hanya untuk dimensi terukur di ResaleUsageBasedPricingTerm. |
| KARTU RATE\_TIDAK VALID | Berikan tarif berbasis penggunaan untuk semua dimensi terukur yang tersedia di ResaleUsageBasedPricingTerm. |
| TERLALU BANYAK\_TARIF | Berikan RateCards dalam batas yang diizinkan di ResaleUsageBasedPricingTerm. |
| DUPLIKAT\_PEMILIH | Berikan daftar unik Pemilih di ResaleConfigurableUpfrontPricingTerm. |
| KARTU RATE\_TIDAK VALID | ConfigurableUpfrontPricingTerm kehilangan satu atau lebih kunci dimensi untuk durasi [x]. Berikan harga untuk set kunci dimensi yang sama untuk semua durasi. |
| KARTU RATE\_TIDAK VALID | Berikan semua dimensi terukur atau semua dimensi yang berhak dalam [x]. |
| BATASAN RATE\_CARD\_INCOMPATIBLE\_RATE\_CARD\_ | Set MultipleDimensionSelection el dan QuantityConfiguration tidak diizinkan ResaleConfigurableUpfrontPricingTerm untuk. PricingModel |
| TERLALU BANYAK\_KARTU\_RATE\_CARD | Hanya satu kartu tarif yang ConfigurableUpfrontPricingTerm diperbolehkan untuk produk. |
| ISTILAH-ISTILAH YANG TIDAK KOMPATIBEL | Istilah berikut tidak kompatibel dengan PricingModel: [x, y, z]. |
| TERLALU BANYAK\_TARIF | Berikan RateCards dalam batas yang diizinkan dalam [istilah x]. |
| TERLALU BANYAK\_HIBAH | Berikan hingga [N] hibah dalam [x term]. |
| NILAI\_PEMILIH\_DURASI\_TIDAK VALID | Berikan durasi antara [x] dan [y] bulan di ResaleConfigurableUpfront |
| TERLALU BANYAK\_HIBAH | Berikan durasi antara [x] dan [y] bulan. |
| NILAI\_PEMILIH\_DURASI\_TIDAK VALID | Pastikan granularitas durasi berada pada tingkat hari untuk dimensi terukur di ResaleConfigurableUpfront |
| DURASI\_INVALID\_ | Pastikan granularitas durasi berada pada tingkat hari untuk dimensi terukur di. FixedUpfront |
| KARTU RATE\_TIDAK VALID | Berikan hanya dimensi berhak dalam [x]. |
| DURASI\_HILANG | Berikan Durasi dalam [x]. |
| DUPLIKAT\_DIMENSI\_KUNCI | Berikan Hibah dengan daftar kunci dimensi unik di [x]. |
| SETELAN\_PEMBAYARAN YANG TIDAK KOMPATIBEL | Perbarui pengaturan pembayaran Anda agar kompatibel dengan CurrencyCode. |
| VERIFIKASI\_PENJUAL YANG TIDAK KOMPATIBEL | Selesaikan semua proses verifikasi penjual yang diperlukan. |
| KODE\_MATA UANG TIDAK VALID | Berikan yang didukung CurrencyCode. |
| KODE\_MATA UANG TIDAK VALID | Berikan hal yang CurrencyCode sama di semua ketentuan harga dan pembayaran. |
| KODE\_MATA UANG YANG TIDAK KOMPATIBEL | CurrencyCode tidak dapat diubah setelah penawaran dirilis. |
## Perbarui jadwal pembayaran
Anda dapat menggunakan API Katalog untuk mengubah detail terkait pembayaran, seperti jadwal pembayaran yang fleksibel, di. AWS Marketplace
Untuk memperbarui detail terkait pembayaran untuk Otorisasi Penjualan Kembali Anda, panggil operasi `StartChangeSet` API dengan jenis `UpdatePaymentScheduleTerms` perubahan, seperti yang ditunjukkan pada contoh berikut.
**Minta Sintaks **
```
POST /StartChangeSet HTTP/1.1
Content-type: application/json
{
"Catalog": "AWSMarketplace",
"ChangeSet":
[
{
"ChangeType": "UpdatePaymentScheduleTerms",
"Entity":
{
"Type": "ResaleAuthorization@1.0",
"Identifier": "resaleauthz-123456789"
},
"DetailsDocument":
{
"Terms":
[
{
"Type": "ResalePaymentScheduleTerm",
"CurrencyCode": "USD",
"Schedule":
[
{
"ChargeDate": "2021-12-01",
"ChargeAmount": "200.00"
},
{
"ChargeDate": "2022-03-01",
"ChargeAmount": "250.00"
}
]
}
]
}
}
]
}
```
Berikan informasi untuk bidang untuk menambahkan jenis `UpdatePaymentScheduleTerms` perubahan:
+ **Entitas ** (objek) (wajib) — Otorisasi Penjualan Kembali Anda.
+ **Type ** (string) (required) — `Type` Itu selalu`ResaleAuthorization@1.0`.
+ **Identifier ** (string) (wajib) — ID Otorisasi Penjualan Kembali Anda. Untuk informasi selengkapnya, lihat [Pengidentifikasi](catalog-apis.md#identifier).
+ **DetailsDocument**(objek) (wajib) — Spesifikasi permintaan.
+ **Ketentuan ** (array struktur) — Daftar ketentuan pembayaran yang ingin Anda perbarui. Ketentuan pembayaran yang didukung adalah:
+ **ResalePaymentScheduleTerm**(objek) — Mendefinisikan model penetapan harga berbasis cicilan di mana pelanggan dikenakan harga tetap pada tanggal yang berbeda selama masa berlaku perjanjian.
+ **Type ** (string) — Kategori istilah yang diperbarui.
+ **CurrencyCode**(string) (required) — Mendefinisikan mata uang untuk pembayaran yang disebutkan dalam jadwal. USD, AUD, EUR, GBP, dan JPY didukung.
+ **Jadwal ** (array struktur) — Daftar jadwal pembayaran di mana setiap elemen mendefinisikan satu angsuran pembayaran. Ini berisi informasi yang diperlukan untuk menghitung harga yang harus dibayar dan tanggal di mana pelanggan akan dikenakan biaya.
+ **ChargeDate**(string) (wajib) — Tanggal pelanggan akan membayar harga yang ditentukan dalam jangka waktu jadwal pembayaran ini. Bidang ini mendukung format ISO 8601.
+ **ChargeAmount**(string) (required) — Harga yang akan dibayar pelanggan pada tanggal yang dijadwalkan (ChargeDate).
**Sintaks Respons **
Kumpulan perubahan dibuat untuk permintaan Anda. Tanggapan terhadap permintaan ini memberi Anda `ChangeSetId` dan `ChangeSetArn` untuk set perubahan dan terlihat seperti berikut ini.
```
{
"ChangeSetId": "example123456789012abcdef",
"ChangeSetArn": "arn:aws:aws-marketplace:us-east-1:123456789012:AWSMarketplace/ChangeSet/example123456789012abcdef"
}
```
Permintaan perubahan ditambahkan ke antrian dan diproses. Ini termasuk memvalidasi informasi untuk memastikan bahwa itu memenuhi AWS Marketplace pedoman. Proses validasi dapat memakan waktu mulai dari beberapa menit hingga beberapa jam.
Anda dapat memeriksa status permintaan melalui Portal Manajemen AWS Marketplace, atau langsung melalui Katalog API menggunakan operasi `[DescribeChangeSet](https://docs.aws.amazon.com/marketplace-catalog/latest/api-reference/API_DescribeChangeSet.html)` API.
**Validasi Sinkron **
Validasi skema khusus untuk `UpdatePaymentScheduleTerms` tindakan di AWS Marketplace Catalog API. Validasi dilakukan saat Anda menelep `StartChangeSet` on. Jika permintaan tidak memenuhi persyaratan berikut, itu akan gagal dengan respons HTTP.
| Bidang masukan | Aturan validasi | HTTP |
| --- | --- | --- |
| Terms.Type | Diperlukan
Tidak didukung untuk produk [x]
Istilah yang diizinkan: ResalePaymentScheduleTerm | 422 |
| Ketentuan []. CurrencyCode | Diperlukan
Nilai yang diizinkan: USD | 422 |
| Ketentuan []. ResalePaymentScheduleTerm.Schedule | Diperlukan
Panjangnya harus antara 1 dan 60 | 422 |
| Ketentuan []. ResalePaymentScheduleTerm.Shedule.ChargeDate | Diperlukan
Harus dalam format ISO 8601
Tanggal harus di masa depan | 422 |
| Ketentuan []. ResalePaymentScheduleTerm.Shedule.ChargeAmount | Diperlukan
Harus non-negatif | 422 |
| Properti yang tidak diketahui | Tidak ada properti tambahan yang diizinkan | 422 |
**Kesalahan Asinkron **
Kesalahan berikut khusus untuk `UpdatePaymentScheduleTerms` tindakan di AWS Marketplace Catalog API. Kesalahan ini dikembalikan saat Anda memanggil `DescribeChangeSet` setelah kumpulan perubahan diproses. atau informasi lebih lanjut tentang menggunakan `DescribeChangeSet` untuk mendapatkan status permintaan perubahan, lihat. [Bekerja dengan set perubahan](catalog-apis.md#working-with-change-sets)
| Kode kesalahan | Pesan kesalahan |
| --- | --- |
| ISTILAH-ISTILAH YANG TIDAK KOMPATIBEL | OffersMaxQuantity dan AvailabilityEndDate harus hadir dengan ResalePaymentScheduleTerm. |
| TERLALU BANYAK\_TERJADWAL\_PEMBAYARAN | Berikan hingga 60 pembayaran terjadwal ResalePaymentScheduleTerm. |
| DUPLIKAT\_TANGGAL\_TAGIHAN | Berikan tanggal pengisian unik di ResalePaymentScheduleTerm. |
| TANGGAL\_TAGIHAN TIDAK VALID | Menyediakan masa depan ChargeDate. |
| TANGGAL\_TAGIHAN TIDAK VALID | Berikan tanggal pengisian terakhir sebelum [x]. |
| HILANG\_SYARAT-SYARAT\_WAJIB | Berikan ResaleFixedUpfrontPricingTerm dan ResalePaymentScheduleTerm bersama-sama. |
| KODE\_MATA UANG TIDAK VALID | Berikan hal yang CurrencyCode sama di semua ketentuan harga dan pembayaran. |
| SETELAN\_PEMBAYARAN YANG TIDAK KOMPATIBEL | Perbarui pengaturan pembayaran Anda agar kompatibel dengan CurrencyCode. |
| VERIFIKASI\_PENJUAL YANG TIDAK KOMPATIBEL | Selesaikan semua proses verifikasi penjual yang diperlukan. |
| KODE\_MATA UANG TIDAK VALID | Berikan yang didukung CurrencyCode. |
| KODE\_MATA UANG TIDAK VALID | Berikan hal yang CurrencyCode sama di semua ketentuan harga dan pembayaran. |
| KODE\_MATA UANG YANG TIDAK KOMPATIBEL | CurrencyCode tidak dapat diubah setelah penawaran dirilis. |
## Perbarui ketentuan pembayaran bersih
Anda dapat menggunakan API Katalog untuk mengatur ketentuan pembayaran bersih dari Otorisasi Penjualan Kembali Anda di AWS Marketplace. Jangka waktu pembayaran bersih adalah istilah di mana Anda menentukan jumlah hari setelah penerbitan faktur yang jatuh tempo pembayaran.
Jangka waktu pembayaran bersih yang Anda tetapkan pada Otorisasi Penjualan Kembali adalah jangka waktu maksimum yang dapat ditawarkan mitra saluran kepada pembeli dalam penawaran pribadi mitra saluran (CPPO). Mitra saluran dapat menawarkan periode yang sama atau yang lebih pendek, tetapi tidak yang lebih lama. Untuk informasi selengkapnya, lihat [Buat CPPO](work-with-cppos.md#create-offer-using-resale-auth).
**catatan**
Ketentuan pembayaran bersih hanya berlaku untuk pembeli yang memiliki metode pembayaran bayar-by-faktur dengan. AWS Jika Anda tidak menetapkan ketentuan pembayaran bersih pada Otorisasi Penjualan Kembali, mitra saluran tidak dapat menetapkan ketentuan pembayaran bersih di CPPO, dan ketentuan pembayaran pembeli berlaku. AWS
Untuk mengatur jangka waktu pembayaran bersih Otorisasi Penjualan Kembali Anda, panggil operasi `StartChangeSet` API dengan jenis `UpdateNetPaymentTerms` perubahan, seperti yang ditunjukkan pada contoh berikut.
**Minta Sintaks **
```
POST /StartChangeSet HTTP/1.1
Content-type: application/json
{
"Catalog": "AWSMarketplace",
"ChangeSet": [
{
"ChangeType": "UpdateNetPaymentTerms",
"Entity": {
"Type": "ResaleAuthorization@1.0",
"Identifier": "resaleauthz-123456789"
},
"DetailsDocument": {
"Terms": [
{
"Type": "ResaleNetPaymentTerm",
"PaymentDuePeriod": "P60D"
}
]
}
}
]
}
```
Berikan informasi untuk bidang untuk menambahkan jenis `UpdateNetPaymentTerms` perubahan:
+ **Entitas ** (objek) (wajib) — Otorisasi Penjualan Kembali Anda.
+ **Type ** (string) (required) — `Type` Itu selalu`ResaleAuthorization@1.0`.
+ **Identifier ** (string) (wajib) — ID Otorisasi Penjualan Kembali Anda. Untuk informasi selengkapnya, lihat [Pengidentifikasi](catalog-apis.md#identifier).
+ **DetailsDocument**(object) (required) — Nilai JSON dari spesifikasi permintaan.
+ **Ketentuan ** (array struktur) (wajib) — Daftar ketentuan pembayaran bersih yang ingin Anda perbarui. Otorisasi Penjualan Kembali dapat berisi paling banyak satu jangka waktu pembayaran bersih. Untuk menghapus jangka waktu pembayaran bersih, berikan daftar kosong. Istilah yang didukung adalah:
+ **ResaleNetPaymentTerm**(objek) — Mendefinisikan jangka waktu pembayaran bersih maksimum yang dapat ditawarkan oleh mitra saluran kepada pembeli.
+ **Type ** (string) — Jenis istilah yang sedang diperbarui. Ini adalah nilai objek:`"ResaleNetPaymentTerm"`.
+ **PaymentDuePeriod**(string) — Jumlah hari setelah tanggal penerbitan faktur pembayaran jatuh tempo. Bidang ini mendukung format ISO 8601. Nilai yang didukung adalah `P15D`, `P30D`, `P45D`, `P60D`, `P90D`, dan `P120D`.
**Sintaks Respons **
Kumpulan perubahan dibuat untuk permintaan Anda. Tanggapan terhadap permintaan ini memberi Anda `ChangeSetId` dan `ChangeSetArn` untuk set perubahan dan terlihat seperti berikut ini.
```
{
"ChangeSetId": "example123456789012abcdef",
"ChangeSetArn": "arn:aws:aws-marketplace:us-east-1:123456789012:AWSMarketplace/ChangeSet/example123456789012abcdef"
}
```
Permintaan perubahan ditambahkan ke antrian dan diproses. Ini termasuk memvalidasi informasi untuk memastikan bahwa itu memenuhi AWS Marketplace pedoman. Proses validasi dapat memakan waktu beberapa menit.
Anda dapat memeriksa status permintaan melalui Portal Manajemen AWS Marketplace, atau langsung melalui Katalog API menggunakan operasi `[DescribeChangeSet](https://docs.aws.amazon.com/marketplace-catalog/latest/api-reference/API_DescribeChangeSet.html)` API.
**Validasi Sinkron **
Validasi skema berikut khusus untuk `UpdateNetPaymentTerms` tindakan di AWS Marketplace Catalog API. Validasi ini dilakukan saat Anda menelep `StartChangeSet` on. Jika permintaan tidak memenuhi persyaratan berikut, itu akan gagal dengan respons HTTP.
| Bidang masukan | Aturan validasi | Kode HTTP |
| --- | --- | --- |
| Istilah | Diperlukan
Hanya `ResaleNetPaymentTerm` diperbolehkan
Ukuran daftar harus kurang dari 2 | 422 |
| Ketentuan [] .Jenis | Diperlukan
Hanya bisa `ResaleNetPaymentTerm` | 422 |
| Ketentuan []. ResaleNetPaymentTerm.PaymentDuePeriod | Diperlukan
Format yang diharapkan: durasi ISO 8601
Nilai yang diizinkan: ["P15D”, “P30D”, “P45D”, “P60D”, “P90D”, “P120D"] | 422 |
**Kesalahan Asinkron **
Kesalahan berikut khusus untuk `UpdateNetPaymentTerms` tindakan di AWS Marketplace Catalog API. Kesalahan ini dikembalikan saat Anda memang `DescribeChangeSet` gil setelah set perubahan diproses. Untuk informasi selengkapnya tentang menggunakan `DescribeChangeSet` untuk mendapatkan status permintaan perubahan, lihat[Bekerja dengan set perubahan](catalog-apis.md#working-with-change-sets).
| Kode kesalahan | Pesan kesalahan |
| --- | --- |
| STATUS TIDAK KOMPATIBEL | UpdateNetPaymentTerms permintaan tidak dapat dilakukan setelah otorisasi penjualan kembali dirilis. |
| ISTILAH-ISTILAH YANG TIDAK KOMPATIBEL | ResaleNetPaymentTerm tidak didukung untuk akun penjual [x]. |
## Perbarui rincian Otorisasi Penjualan Kembali
Anda dapat menggunakan API Katalog untuk memperbarui detail Otorisasi Penjualan Kembali di AWS Marketplace.
Untuk memperbarui detail Otorisasi Penjualan Kembali, `StartChangeSet` panggil operasi API dengan jenis `UpdateInformation` perubahan, seperti yang ditunjukkan pada contoh berikut.
**catatan**
Jenis `UpdateInformation` perubahan hanya memperbarui bagian yang disediakan dalam permintaan; semua informasi lainnya tetap tidak berubah.
**Minta Sintaks **
```
POST /StartChangeSet HTTP/1.1
Content-type: application/json
{
"Catalog": "AWSMarketplace",
"ChangeSet":
[
{
"ChangeType": "UpdateInformation",
"Entity":
{
"Type": "ResaleAuthorization@1.0",
"Identifier": "resaleauthz-123456789"
},
"DetailsDocument":
{
"Name": "TestResaleAuthorization",
"Description": "Worldwide ResaleAuthorization for Test Product",
"PreExistingBuyerAgreement":
{
"AcquisitionChannel": "AwsMarketplace",
"PricingModel": "Contract"
}
}
}
]
}
```
Berikan informasi untuk bidang untuk menambahkan jenis `UpdateInformation` perubahan:
+ **Entitas ** (objek) (wajib) — Otorisasi Penjualan Kembali Anda.
+ **Type ** (string) (required) — `Type` Itu selalu`ResaleAuthorization@1.0`.
+ **Identifier ** (string) (wajib) — ID Otorisasi Penjualan Kembali Anda. Untuk informasi selengkapnya, lihat [Pengidentifikasi](catalog-apis.md#identifier).
+ **DetailsDocument**(objek) (wajib) — Rincian permintaan, termasuk informasi yang ingin Anda perbarui informasi untuk Otorisasi Penjualan Kembali.
+ **Nama ** (string) (opsional) — Nama yang terkait dengan ResaleAuthorization agar lebih mudah dibaca oleh Anda dan mitra saluran Anda.
+ **Deskripsi ** (string) (opsional) - Deskripsi adalah teks bentuk bebas di mana Anda dapat menambahkan detail tentang. ResaleAuthorization
+ **PreExistingBuyerAgreement**(objek) (opsional) — Menentukan apakah penawaran ini merupakan pembaruan untuk perjanjian yang ada dengan pelanggan yang sudah ada untuk produk dasar yang sama. Perjanjian yang ada bisa di dalam atau di luar AWS Marketplace. AWS dapat mengaudit dan memverifikasi penawaran Anda adalah pembaruan. Jika AWS tidak dapat memverifikasi penawaran Anda, maka AWS dapat mencabut penawaran dan hak dari pelanggan Anda.
+ **AcquisitionChannel**(string) (wajib) — Menunjukkan apakah perjanjian pembeli yang ada ditandatangani di luar AWS Marketplace atau di dalam AWS Marketplace.
Nilai yang mungkin:`External`, `AwsMarketplace`
+ **PricingModel**(string) (required) ** — Men ** unjukkan model penetapan harga yang digunakan perjanjian keluar.
Nilai yang mungkin:`Contract`,`Usage`,`BYOL`, `Free`
**Sintaks Respons **
Kumpulan perubahan dibuat untuk permintaan Anda. Tanggapan terhadap permintaan ini memberi Anda `ChangeSetId` dan `ChangeSetArn` untuk set perubahan dan terlihat seperti berikut ini.
```
{
"ChangeSetId": "example123456789012abcdef",
"ChangeSetArn": "arn:aws:aws-marketplace:us-east-1:123456789012:AWSMarketplace/ChangeSet/example123456789012abcdef"
}
```
Permintaan perubahan ditambahkan ke antrian dan diproses. Ini termasuk memvalidasi informasi untuk memastikan bahwa itu memenuhi AWS Marketplace pedoman. Proses validasi dapat memakan waktu mulai dari beberapa menit hingga beberapa jam.
Anda dapat memeriksa status permintaan melalui Portal Manajemen AWS Marketplace, atau langsung melalui Katalog API menggunakan operasi `[DescribeChangeSet](https://docs.aws.amazon.com/marketplace-catalog/latest/api-reference/API_DescribeChangeSet.html)` API.
**Validasi Sinkron **
Validasi skema berikut khusus untuk `UpdateInformation` tindakan di AWS Marketplace Catalog API. Validasi ini dilakukan saat Anda memanggil`StartChangeSet`, dan permintaan akan gagal dengan kesalahan HTTP jika input tidak memenuhi persyaratan berikut.
| Bidang masukan | Aturan validasi | Kode HTTP |
| --- | --- | --- |
| Nama | Opsional
Tidak boleh nol atau kosong
Panjang harus antara 1 dan 100 karakter
Pola ^ [A-Za-z0-9] \*$
Tidak ada karakter khusus atau spasi putih yang diizinkan | 422 |
| Deskripsi | Opsional
Panjang harus antara 1 dan 255 karakter
Pola ^ [A-Za-z0-9\\\\ s] \*$
Tidak ada karakter khusus yang diizinkan | 422 |
| Properti yang tidak diketahui | Tidak ada properti tambahan yang diizinkan | 422 |
**Kesalahan Asinkron **
Kesalahan berikut khusus untuk `UpdateInformation` tindakan di AWS Marketplace Catalog API. Kesalahan ini dikembalikan saat Anda memanggil `DescribeChangeSet` setelah kumpulan perubahan diproses. atau informasi lebih lanjut tentang menggunakan `DescribeChangeSet` untuk mendapatkan status permintaan perubahan, lihat. [Bekerja dengan set perubahan](catalog-apis.md#working-with-change-sets)
| Kode kesalahan | Pesan kesalahan |
| --- | --- |
| PENARGETAN\_PEMBELI YANG TIDAK KOMPATIBEL | Setidaknya satu akun Pembeli harus hadir untuk ResaleAuthorization bersama PreExistingBuyerAgreement. |
## Batasi Otorisasi Penjualan Kembali
Anda dapat menggunakan API Katalog untuk menetapkan aturan pembatasan ke Otorisasi Penjualan Kembali di AWS Marketplace.
Otorisasi Penjualan Kembali terbatas tidak dapat lagi digunakan oleh mitra saluran untuk membuat penawaran pribadi. Penawaran pribadi yang ada tidak akan terpengaruh.
Untuk membatasi Otorisasi Penjualan Kembali Anda, `StartChangeSet` panggil operasi API dengan jenis `RestrictResaleAuthorization` perubahan, seperti yang ditunjukkan pada contoh berikut.
**penting**
Ini adalah operasi yang tidak dapat dibalik. Setelah Otorisasi Penjualan Kembali ditandai sebagai`Restricted`, Otorisasi Penjualan Kembali tidak dapat berada dalam `Active` status lagi.
**Minta Sintaks **
```
POST /StartChangeSet HTTP/1.1
Content-type: application/json
{
"Catalog": "AWSMarketplace",
"ChangeSet": [
{
"ChangeType": "RestrictResaleAuthorization",
"Entity": {
"Type": "ResaleAuthorization@1.0",
"Identifier": "resaleauthz-123456789"
},
"DetailsDocument": {}
}
]
}
```
Berikan informasi untuk bidang untuk menambahkan jenis `RestrictResaleAuthorization` perubahan:
+ **Entitas ** (objek) (wajib) — Otorisasi Penjualan Kembali Anda.
+ **Type ** (string) (required) — `Type` Itu selalu`ResaleAuthorization@1.0`.
+ **Identifier ** (string) (wajib) — ID Otorisasi Penjualan Kembali Anda. Untuk informasi selengkapnya, lihat [Pengidentifikasi](catalog-apis.md#identifier).
+ **DetailsDocument**(objek) (wajib) — Spesifikasi permintaan. Itu harus menjadi objek kosong untuk`RestrictResaleAuthorization`.
**Sintaks Respons **
Kumpulan perubahan dibuat untuk permintaan Anda. Tanggapan terhadap permintaan ini memberi Anda `ChangeSetId` dan `ChangeSetArn` untuk set perubahan dan terlihat seperti berikut ini.
```
{
"ChangeSetId": "example123456789012abcdef",
"ChangeSetArn": "arn:aws:aws-marketplace:us-east-1:123456789012:AWSMarketplace/ChangeSet/example123456789012abcdef"
}
```
Permintaan perubahan ditambahkan ke antrian dan diproses. Ini termasuk memvalidasi informasi untuk memastikan bahwa itu memenuhi AWS Marketplace pedoman. Proses validasi dapat memakan waktu mulai dari beberapa menit hingga beberapa jam.
Anda dapat memeriksa status permintaan melalui Portal Manajemen AWS Marketplace, atau langsung melalui Katalog API menggunakan operasi `[DescribeChangeSet](https://docs.aws.amazon.com/marketplace-catalog/latest/api-reference/API_DescribeChangeSet.html)` API.
**Validasi Sinkron **
Validasi skema khusus untuk `RestrictResaleAuthorization` tindakan di AWS Marketplace Catalog API. Validasi ini dilakukan saat Anda menelep `StartChangeSet` on. Jika permintaan tidak memenuhi persyaratan berikut, itu akan gagal dengan respons HTTP.
| Bidang masukan | Aturan validasi | Kode HTTP |
| --- | --- | --- |
| DetailsDocument | Harus kosong | 422 |
| RestrictResaleAuthorization | Kedaluwarsa tidak ResaleAuthorization dapat ditandai sebagai `Restricted` | 422 |
| Properti yang tidak diketahui | Tidak ada properti tambahan yang diizinkan | 422 |
**Kesalahan Asinkron **
Kesalahan berikut khusus untuk `RestrictResaleAuthorization` tindakan di AWS Marketplace Catalog API. Kesalahan ini dikembalikan saat Anda memanggil `DescribeChangeSet` setelah kumpulan perubahan diproses. atau informasi lebih lanjut tentang menggunakan `DescribeChangeSet` untuk mendapatkan status permintaan perubahan, lihat. [Bekerja dengan set perubahan](catalog-apis.md#working-with-change-sets)
| Kode kesalahan | Pesan kesalahan |
| --- | --- |
| STATUS TIDAK KOMPATIBEL | Kedaluwarsa tidak ResaleAuthorization dapat ditandai sebagai terbatas. |
## Melepaskan Otorisasi Penjualan Kembali dan membuatnya terlihat oleh Mitra Saluran
Anda dapat menggunakan API Katalog untuk memulai `ResaleAuthorization` ke `Active` status.
`ReleaseResaleAuthorization`membuat Otorisasi Penjualan Kembali Anda aktif sehingga Mitra Saluran dapat menggunakan Otorisasi Penjualan Kembali Anda untuk membuat penawaran pribadi.
Untuk melepaskan Otorisasi Penjualan Kembali Anda, `StartChangeSet` panggil operasi API dengan jenis `ReleaseResaleAuthorization` perubahan, seperti yang ditunjukkan pada contoh berikut.
**Minta Sintaks **
```
POST /StartChangeSet HTTP/1.1
Content-type: application/json
{
"Catalog": "AWSMarketplace",
"ChangeSet":
[
{
"ChangeType": "ReleaseResaleAuthorization",
"Entity":
{
"Type": "ResaleAuthorization@1.0",
"Identifier": "resaleauthz-123456789"
},
"DetailsDocument": {}
}
]
}
```
Berikan informasi untuk bidang untuk menambahkan jenis `ReleaseResaleAuthorization` perubahan:
+ **Entitas ** (objek) (wajib) — Otorisasi Penjualan Kembali Anda.
+ **Type ** (string) (required) — `Type` Itu selalu`ResaleAuthorization@1.0`.
+ **Identifier ** (string) (wajib) — ID Otorisasi Penjualan Kembali Anda. Untuk informasi selengkapnya, lihat [Pengidentifikasi](catalog-apis.md#identifier).
+ **DetailsDocument**(objek) (wajib) — Spesifikasi permintaan. Itu harus kosong untuk`ReleaseResaleAuthorization`.
**Sintaks Respons **
Kumpulan perubahan dibuat untuk permintaan Anda. Tanggapan terhadap permintaan ini memberi Anda `ChangeSetId` dan `ChangeSetArn` untuk set perubahan dan terlihat seperti berikut ini.
```
{
"ChangeSetId": "example123456789012abcdef",
"ChangeSetArn": "arn:aws:aws-marketplace:us-east-1:123456789012:AWSMarketplace/ChangeSet/example123456789012abcdef"
}
```
Permintaan perubahan ditambahkan ke antrian dan diproses. Ini termasuk memvalidasi informasi untuk memastikan bahwa itu memenuhi AWS Marketplace pedoman. Proses validasi dapat memakan waktu mulai dari beberapa menit hingga beberapa jam.
Anda dapat memeriksa status permintaan melalui Portal Manajemen AWS Marketplace, atau langsung melalui Katalog API menggunakan operasi `[DescribeChangeSet](https://docs.aws.amazon.com/marketplace-catalog/latest/api-reference/API_DescribeChangeSet.html)` API.
**Validasi Sinkron **
Validasi skema khusus untuk `ReleaseResaleAuthorization` tindakan di AWS Marketplace Catalog API. Validasi dilakukan saat Anda menelep `StartChangeSet` on. Jika permintaan tidak memenuhi persyaratan berikut, itu akan gagal dengan respons HTTP.
| Bidang masukan | Aturan validasi | Kode HTTP |
| --- | --- | --- |
| Properti yang tidak diketahui | Tidak ada properti tambahan yang diizinkan | 422 |
**Kesalahan Asinkron **
Kesalahan berikut khusus untuk `ReleaseResaleAuthorization` tindakan di AWS Marketplace Catalog API. Kesalahan ini dikembalikan saat Anda memang `DescribeChangeSet` gil setelah set perubahan diproses. Untuk detail selengkapnya tentang menggunakan `DescribeChangeSet` untuk mendapatkan status permintaan perubahan, lihat[Bekerja dengan set perubahan](catalog-apis.md#working-with-change-sets).
| Kode kesalahan | Pesan kesalahan |
| --- | --- |
| HILANG\_SYARAT-SYARAT\_WAJIB | Berikan a BuyerLegalTerm. |
| HILANG\_SYARAT-SYARAT\_WAJIB | Berikan a PricingTerm. |
| PRODUK\_TIDAK KOMPATIBEL | Gunakan produk aktif dalam keadaan terbatas atau publik. |
| ISTILAH HARGA YANG TIDAK KOMPATIBEL | PaymentScheduleTerm dan FixedUpfrontPricingTerm harus hadir bersama. |
| PENARGETAN\_PEMBELI YANG TIDAK KOMPATIBEL | Setidaknya satu akun Pembeli harus hadir untuk ResaleAuthorization bersama PreExistingBuyerAgreement. |
| HILANG\_SYARAT-SYARAT\_WAJIB | Berikan setidaknya satu dari [x, y, z]. |
| STATUS TIDAK KOMPATIBEL | [x] permintaan tidak dapat dilakukan setelah otorisasi penjualan kembali dirilis. |
## Jelaskan Otorisasi Penjualan Kembali yang ada
Untuk menjelaskan detail Otorisasi Penjualan Kembali, `DescribeEntity` panggil operasi API dengan tipe `ResaleAuthorization@1.0` entitas, seperti yang ditunjukkan pada contoh berikut.
**Minta Sintaks **
```
GET /DescribeEntity?catalog=&entityId= HTTP/1.1
```
Berikan informasi untuk bidang untuk menambahkan jenis `DescribeEntity` perubahan:
+ **catalog ** (string) — Katalog yang terkait dengan permintaan. Nilai tetap:`AWSMarketplace`.
+ **entityId ** (string) — ID unik dari yang akan dijelaskan`ResaleAuthorization`.
**Sintaks Respons **
Tanggapan atas permintaan ini memberi Anda detail penawaran dan terlihat seperti berikut ini.
```
{
"EntityType": "ResaleAuthorization@1.0",
"EntityIdentifier": "resaleauthz-123456789",
"EntityArn": "arn:aws:aws-marketplace:us-east-1:111122223333:AWSMarketplace/ResaleAuthorization/resaleauthz-123456789",
"LastModifiedDate": "2021-03-10T21:57:16Z",
"DetailsDocument": {
"Name": "TestResaleAuthorization",
"Description": "ResaleAuthorization for Test Product",
"ProductId": "prod-ad8EXAMPLE51",
"ProductName": "TestProduct",
"Status": "Active", /*Draft, Active, Restricted*/
"PreExistingBuyerAgreement": {
"AcquisitionChannel": "Unknown",
"PricingModel": "Unknown"
},
"CreatedDate": "2023-07-18T16:39:31.335Z",
"ManufacturerLegalName": "ChannelCAPI.Inc",
"ManufacturerAccountId": "123456789012",
"Dimensions": [
{
"Name": "Protected Resources",
"Description": "Additional 100 protected resources",
"Key": "hundredresources",
"Unit": "Units",
"Types": [
"Entitled"
]
}
],
"OfferDetails": {
"OfferExtendedStatus": "Not Started", /* Not Started, Completed-Used, Completed-Usable*/
"OfferCreatedCount": 0
},
"Terms": [
{
"Type": "ResaleNetPaymentTerm",
"Id": "term_id_placeholder",
"PaymentDuePeriod": "P60D"
},
{
"Type": "ResaleUsageBasedPricingTerm",
"Id": "term_id_placeholder",
"CurrencyCode": "USD",
"RateCards": [
{
"RateCard": [
{
"DimensionKey": "resource_number",
"Price": "0.05"
},
{
"DimensionKey": "scanned_data",
"Price": "0.05"
}
]
}
]
},
{
"Type": "ResaleConfigurableUpfrontPricingTerm",
"Id": "term_id_placeholder",
"CurrencyCode": "USD",
"RateCards": [
{
"Selector": {
"Type": "Duration",
"Value": "P24M"
},
"RateCard": [
{
"DimensionKey": "hundredresources",
"Price": "0.04"
},
{
"DimensionKey": "tenTBData",
"Price": "0.03"
},
{
"DimensionKey": "channel_custom",
"Price": "0.02"
}
],
"Constraints": {
"MultipleDimensionSelection": "Allowed",
"QuantityConfiguration": "Allowed"
}
}
]
},
{
"Type": "ResaleFixedUpfrontPricingTerm",
"Id": "term-sdh27fb2",
"CurrencyCode": "USD",
"Duration": "P180D",
"Price": "0.0",
"Grants": [
{
"DimensionKey": "sdf73rbns93nl120d10xm1",
"MaxQuantity": 1
}
]
},
{
"Type": "ResalePaymentScheduleTerm",
"Id": "term-sdh27fb2",
"CurrencyCode": "USD",
"Schedule": [
{
"ChargeDate": "2018-07-01T00:00:00.000Z",
"ChargeAmount": "200.00"
},
{
"ChargeDate": "2019-05-01T00:00:00.000Z",
"ChargeAmount": "200.00"
}
]
},
{
"Type": "BuyerLegalTerm",
"Id": "term_id_placeholder",
"Documents": [
{
"Type": "StandardEula",
"Url": "https://resale-auth-legal-terms-iad-beta.s3.us-east-1.amazonaws.com/09ae57d6-c75a-3a4c-aadf-9b866bae64ab/a85cace8-6d9d-40ca-a053-78fc265479bf?isSigned=yes"
}
]
},
{
"Type": "ResaleLegalTerm",
"Id": "term_id_placeholder",
"Documents": [
{
"Type": "StandardResellerContract",
"Url": "https://resale-auth-legal-terms-iad-beta.s3.us-east-1.amazonaws.com/09ae57d6-c75a-3a4c-aadf-9b866bae64ab/bed55b56-7ab4-4c4c-b633-3bf4f6efcb98?isSigned=yes"
}
]
},
{
"Type": "BuyerValidityTerm",
"Id": "term_id_placeholder",
"MaximumAgreementStartDate": "2023-09-25T23:59:59.000Z"
},
{
"Type": "BuyerTargetingTerm",
"Id": "term_id_placeholder",
"PositiveTargeting": {
"BuyerAccounts": [
{
"AwsAccountId": "444455556666"
}
]
}
}
],
"Rules": [
{
"Type": "AvailabilityRule",
"Id": "availability_rule_id_placeholder",
/* If the AvailabilityEndDate and OffersMaxQuantity not present Usage will be Unlimited*/
"Usage": "Limited",
"AvailabilityEndDate": "2022-05-31T23:59:59Z",
"OffersMaxQuantity": 1
},
{
"Type": "PartnerTargetingRule",
"Id": "partner_targeting_rule_id_placeholder",
"ResellerAccountId": "777777777777",
"ResellerLegalName": "ChannelCAPICP.Inc"
}
]
}
}
```
Berikut ini adalah informasi tentang bidang yang Anda lihat dalam `DescribeEntity` respons.
+ **EntityType**(string) — Jenis entitas bernama, yaitu ResaleAuthorization @1 .0.
+ **EntityIdentifier**(string) — Pengidentifikasi entitas, dalam format EntityId @RevisionId.
+ **EntityArn**(string) — ARN yang terkait dengan pengidentifikasi unik untuk kumpulan perubahan yang direferensikan dalam permintaan ini.
+ **LastModifiedDate**(string) — Tanggal modifikasi terakhir entitas, dalam format ISO 8601 (2018-02- T13:45:22Z 27).
+ **DetailsDocument**(object) (required) — String JSON ini menyertakan detail entitas.
+ **Nama ** (string) — Nama yang terkait dengan nama ResaleAuthorization untuk keterbacaan yang lebih baik bagi Anda dan Mitra Saluran Anda. Ini ditampilkan sebagai bagian dari informasi Perjanjian.
+ **Deskripsi ** (string) - Deskripsi adalah teks bentuk bebas yang dimaksudkan untuk digunakan hanya oleh Anda dan tidak akan pernah diekspos ke pembeli.
+ **ProductId**(string) - Deskripsi adalah teks bentuk bebas yang dimaksudkan untuk digunakan hanya oleh Anda dan tidak akan pernah diekspos ke pembeli.
+ **AgreementToken**(string) — Dibuat dari konten di ResaleAuthorization. Ini berisi informasi tentang persyaratan, aturan, dan pengusul saat membuat perjanjian. Ini digunakan untuk pemeriksaan otorisasi dan validasi selama pengadaan.
+ **I ** stilah (array struktur) — Daftar istilah yang disajikan untuk diterima.
+ **Aturan ** (array struktur) — Daftar aturan atau set instruksi.