

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.

# Perbarui persyaratan harga
<a name="update-pricing-terms"></a>

Anda dapat menggunakan API Katalog untuk memperbarui harga produk pembelajaran mesin Anda di AWS Marketplace.

**catatan**  
Anda harus memberi harga semua jenis instans yang didukung dari produk pembelajaran mesin Anda. Saat membuat versi pertama Anda, `UpdatePricingTerms` dan `AddDeliveryOptions` ubah jenis dengan harga untuk semua jenis instans yang didukung untuk mempublikasikan produk Anda. Saat menambahkan versi baru ke produk yang sudah ada dengan tipe instans baru yang sebelumnya tidak didukung, Anda harus menyertakan jenis instance tersebut dalam `UpdatePricingTerms` dan `AddDeliveryOptions` mengubah jenis.

Untuk memperbarui persyaratan harga, hubungi `StartChangeSet` operasi dengan jenis `UpdatePricingTerms` perubahan.

## Sintaksis Permintaan
<a name="request-syntax"></a>

```
POST /StartChangeSet HTTP/1.1
Content-type: application/json
{
    "Catalog": "AWSMarketplace",
    "ChangeSet": [
        {
            "ChangeType": "UpdatePricingTerms",
            "Entity": {
                "Type": "Offer@1.0",
                "Identifier": "$CreateOfferChange.Entity.Identifier"
            },
            "DetailsDocument": {
                "PricingModel": "Usage",
                "Terms": [
                    {
                        "Type": "UsageBasedPricingTerm",
                        "CurrencyCode": "USD",
                        "RateCards": [
                            {
                                "RateCard": [
                                    {
                                      "DimensionKey": "ml.m4.4xlarge.m.i.b",
                                      "Price": 0.1
                                    },
                                    {
                                      "DimensionKey": "ml.m5.4xlarge.m.i.b",
                                      "Price": 0.1
                                    },
                                    {
                                      "DimensionKey": "ml.m4.16xlarge.m.i.b",
                                      "Price": 0.1
                                    },    
                                    {
                                      "DimensionKey": "m.i.c",
                                      "Price": 0.1
                                    },
                                    {
                                      "DimensionKey": "ml.m4.4xlarge.a.t",
                                      "Price": 0.1
                                    },
                                    {
                                      "DimensionKey": "ml.m5.4xlarge.a.t",
                                      "Price": 0.1
                                    },
                                    {
                                      "DimensionKey": "ml.m4.16xlarge.a.t",
                                      "Price": 0.1
                                    }
                                ]
                            }   
                        ]
                    },
                    {
                        "Type": "FreeTrialPricingTerm",
                        "Duration": "P30D",
                        "Grants": [
                            {
                                "DimensionKey": "ml.m4.4xlarge.m.i.b"
                            },
                              {
                                "DimensionKey": "ml.m5.4xlarge.m.i.b"
                              },
                              {
                                "DimensionKey": "ml.m4.16xlarge.m.i.b"
                              },
                              {
                                "DimensionKey": "m.i.c"
                              },
                              {
                                "DimensionKey": "ml.m4.4xlarge.a.t"
                              },
                              {
                                "DimensionKey": "ml.m5.4xlarge.a.t"
                              },
                              {
                                "DimensionKey": "ml.m4.16xlarge.a.t"
                              }
                        ]
                    }
                ]
            }
        },
    ]
}
```

## Bidang yang diperlukan
<a name="pricing-terms-required-fields"></a>
+ `Entity`(objek) (wajib) - Berisi informasi tentang penawaran produk ML Anda.
  + `Identifier`(string) (wajib) - ID penawaran yang ingin Anda perbarui ketentuan harga. Untuk informasi selengkapnya, lihat [Pengenal](https://docs.aws.amazon.com/marketplace/latest/APIReference/catalog-apis.html#identifier).
  + `Type`(string) (wajib) - `Type` Harus `Offer@1.0` untuk memperbarui harga.
+ `DetailsDocument`(objek) (wajib) — Detail tentang ketentuan harga produk pembelajaran mesin Anda.
  + `PricingModel`(string) (wajib) - Model harga untuk produk Anda - Anda dapat memilih antara Penggunaan, Gratis, dan Kontrak (untuk penawaran pribadi). Untuk informasi selengkapnya, lihat [Harga Produk Machine Learning](https://docs.aws.amazon.com/marketplace/latest/userguide/machine-learning-pricing.html).
  + `Terms`(array of objects) - Sebuah array istilah harga yang secara kolektif menentukan harga keseluruhan produk Anda.
    + `Type`(string) (wajib) - Jenis istilah harga. Opsi yang valid adalah `UsageBasedPricingTerm` `FreeTrialPricingTerm` atau atau `FixedUpfrontPricingTerm` (untuk penawaran pribadi).
    + `CurrencyCode`(string) (diperlukan untuk `UsageBasedPricingTerm` atau `FixedUpfrontPricingTerm` - mata uang dari istilah harga. Nilai yang valid adalah `USD`.
    + `RateCards`(array objek) (diperlukan untuk`UsageBasedPricingTerm`) - Kartu tarif yang menentukan harga untuk produk pembelajaran mesin Anda. Anda harus menyertakan satu `RateCard` hanya dalam array ini.
      + `RateCard`(array objek) - Array dimensi dan tarif untuk produk pembelajaran mesin Anda. Semua jenis instans yang didukung harus diberi harga untuk mempublikasikan produk Anda.
        + `DimensionKey`- Dimensi yang Anda tetapkan harga. Kunci dimensi yang valid adalah:
          + Jenis instans diikuti oleh operasi untuk tarif per jam:
            + Jenis instance akan dimulai dengan `ml` diikuti oleh nama dan ukuran instance. Sebagai contoh, `ml.m4.xlarge`
            + Operasi akan dilakukan `m.i.b` untuk transformasi batch, `m.i.r` untuk inferensi real-time per jam, dan `a.t` untuk pelatihan algoritme.
            + Contoh: `ml.m4.4xlarge.m.i.b` untuk transformasi batch, `ml.m4.xlarge.m.i.r` untuk inferensi waktu nyata, atau `ml.m4.16xlarge.a.t` untuk pelatihan algoritme
          + `m.i.c`untuk harga real-time per inferensi.
        + `Price`- Tingkat dimensi. Tarifnya adalah per jam atau per inferensi, tergantung pada DimensionKey.
    + `Duration`(string) (diperlukan untuk `FreeTrialPricingTerm` atau `FixedUpfrontPricingTerm` - Durasi uji coba atau kontrak gratis Anda. Untuk uji coba gratis nilai valid adalah antara X dan Y. Untuk kontrak, nilai yang valid adalah antara X dan Y.
    + Hibah (array objek) - Detail tentang DimensionKeys mana yang memenuhi syarat untuk uji coba gratis. Semua DimensionKeys yang didukung harus disediakan.
      + DimensionKey - Dimensi untuk dimasukkan sebagai bagian dari penawaran uji coba gratis.
        + Jenis instans diikuti oleh operasi untuk tarif per jam:
          + Jenis instance dimulai dengan `ml` diikuti oleh nama dan ukuran instance misalnya `ml.m4.xlarge`
          + Operasi adalah `m.i.b` untuk transformasi batch, `m.i.r` untuk inferensi real-time per jam, atau `a.t` untuk pelatihan algoritme.
          + Contoh: `ml.m4.4xlarge.m.i.b` untuk transformasi batch, `ml.m4.xlarge.m.i.r` untuk inferensi waktu nyata, atau `ml.m4.16xlarge.a.t` untuk pelatihan algoritme
        + `m.i.c`untuk harga real-time per inferensi.

## Sintaksis Respons
<a name="update-pricing-response-syntax"></a>

Permintaan yang berhasil mengembalikan:

```
{
    "ChangeSetId": "{{example123456789012abcdef}}",
    "ChangeSetArn": "arn:aws:aws-marketplace:{{us-east-1}}:{{123456789012}}:AWSMarketplace/ChangeSet/{{example123456789012abcdef}}"
}
```

## Ubah pemrosesan set
<a name="update-pricing-change-set-processing"></a>

Permintaan perubahan memasuki antrian pemrosesan, di mana ia mengalami beberapa langkah:

1. Validasi: Sistem memeriksa untuk memastikan semua informasi memenuhi AWS Marketplace pedoman.
   + Waktu pemrosesan: Beberapa menit hingga beberapa jam
   + Untuk kesalahan validasi, lihat [Mengubah status set dan kesalahan](https://docs.aws.amazon.com/marketplace/latest/APIReference/work-with-seller-products.html#seller-product-change-set-errors).

1. Pemantauan status: Anda dapat memeriksa status permintaan dengan dua cara.
   + Melalui Portal AWS Marketplace Manajemen
   + Menggunakan `DescribeChangeSet` operasi

1. Penyelesaian: Ketika disetujui, persyaratan harga diperbarui.

## Kesalahan
<a name="update-pricing-errors"></a>

**Kesalahan asinkron**  
Kesalahan spesifik untuk `UpdatePricingTerms` tindakan dapat diambil menggunakan `DescribeChangeSet` operasi setelah set perubahan mulai diproses. Untuk detail kesalahan dan pemecahan masalah, lihat [Mengubah status dan kesalahan yang disetel](https://docs.aws.amazon.com/marketplace/latest/APIReference/catalog-apis.html#working-with-change-sets).


| Kode kesalahan | Pesan kesalahan | 
| --- | --- | 
| INCOMPATIBLE\_PRODUCT\_STATUS | Gunakan produk terbatas atau publik yang ada. | 