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 informasi versi
<a name="ml-update-version"></a>

 Anda dapat menggunakan API Katalog untuk memperbarui detail versi produk pembelajaran mesin yang sudah ada di AWS Marketplace. 

**penting**  
 Anda tidak dapat memperbarui ARN untuk versi. Jika Anda perlu memodifikasi ARN, Anda harus membuat versi baru sebagai gantinya. 

**Menggunakan `StartChangeSet`untuk menambahkan versi:**
+  Untuk memperbarui informasi versi, panggil `StartChangeSet` operasi dengan jenis `UpdateDeliveryOptions` perubahan. 

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

```
POST /StartChangeSet HTTP/1.1
Content-type: application/json

{
  "Catalog": "AWSMarketplace",
  "ChangeSet":
  [
    {
      "ChangeType": "UpdateDeliveryOptions",
      "Entity":
      {
        "Identifier": "{{example1-abcd-1234-5ef6-7890abcdef12@1}}",
        "Type": "MachineLearningProduct@1.0"
      },
      "DetailsDocument":
      {
        "Version":
        {
          "ReleaseNotes": "{{Adding support for new parameters}}"
        },
        "DeliveryOptions":
        [
          {
            "Id": "{{example1-2222-cccc-2222-cccccccccccc}}",
            "Details":
            {
              "SagemakerModelPackageDeliveryOptionDetails":
              {
                "SampleNotebookUrl": "{{https://www.amazon.com}}",
                "RepositoryUrl":"{{https://www,amazon.com}}",
                "InputProperties": 
                { 
                    "SampleInput": {
                        "RealtimeInferenceUrl": "{{https://www.sampleData.com}}",
                        "BatchTranformUrl": "{{https://www.sampleData.com}}",
                     },
                 },
                 "RecommendedInstanceTypes": {
                        "BatchTransform": "{{ml.m4.large}}",
                        "RealtimeInference": "{{ml.m4.large}}"
                  }
            }
          }
        ]
      }
    }
  ]
}
```

## Bidang yang diperlukan
<a name="ml-update-version-required-fields"></a>
+  `Entity`(objek) —diperlukan 

  Berisi informasi tentang produk ML Anda.
  +  `Identifier`(string) —diperlukan 

    ID produk Anda. Untuk informasi selengkapnya, lihat [Pengenal](https://docs.aws.amazon.com/marketplace/latest/APIReference/catalog-apis.html#identifier).
  +  `Type`(string) —diperlukan 

    Menentukan metode pengiriman (jenis produk). Itu pasti`MachineLearningProduct@1.0`.
+  `DetailsDocument`(objek) —diperlukan 

   Berisi informasi versi yang diperbarui. 
  + `Version`(objek) —diperlukan

    Mendefinisikan informasi khusus versi.
    + `VersionTitle`(string) —diperlukan

      Pengidentifikasi versi ditampilkan kepada pembeli, seperti “Versi 1.1" atau “1.1". Pembeli menggunakan judul ini untuk memilih versi untuk penyebaran.
    + `ReleaseNotes`(string) —diperlukan 

      Catatan terperinci tentang versi ini, terbatas pada 30.000 karakter.
  + `DeliveryOptions`(array) —diperlukan 

    Menentukan metode pengiriman untuk versi produk Anda. Terbatas untuk satu opsi pengiriman per versi.
    + `Id`(string) —diperlukan 

      Pengidentifikasi unik untuk. DeliveryOption Ambil ini menggunakan DescribeEntity tindakan pada produk Anda.
    + `Details`(objek) —diperlukan 

      Berisi spesifikasi opsi pengiriman.
      + `SageMakerModelPackageSubscriptionDetails`atau `SageMakerAlgorithmSubscriptionDetails` (objek) —diperlukan 

        Detail opsi pengiriman.
        + `SampleNotebookUrl`(string) —diperlukan 

          Contoh tautan notebook Jupyter yang menyediakan kode untuk penggunaan pembeli.
        + `RepositoryUrl`(string) —diperlukan 

          URL repositori Git untuk kloning notebook dan data sampel.
        + `UsageInstructions`(string) —diperlukan 

          Untuk algoritma: informasi pelatihan. Untuk model: informasi penggunaan tambahan.
        + `InputProperties`(objek) —diperlukan 

          Rincian persyaratan input. model/algorithm
          + `Description`(string) —diperlukan 

            Deskripsi input yang diperlukan.
          + `Limitations`(tali) 

            Keterbatasan masukan apa pun.
          + `SampleInput`(objek) —diperlukan 

            Sampel data input untuk operasi yang berbeda.
            + `RealtimeInferenceUrl`(tali) 

              Contoh URL masukan untuk inferensi waktu nyata.
            + `RealtimeInferenceText`(tali) 

              Contoh teks masukan untuk inferensi waktu nyata.
            + `BatchTransformUrl`(tali) 

              Contoh URL input untuk pekerjaan transformasi batch.
            + `BatchTransformText`(tali) 

              Contoh teks masukan untuk pekerjaan transformasi batch.
          + `Parameters`(Array<Object>) 

            Detail untuk setiap parameter input.
            + `Name`(string) —diperlukan 

              Nama parameter input.
            + `Description`(string) —diperlukan 

              Deskripsi parameter input.
            + `Constraints`(tali) 

              Kendala parameter (MinValue,,,, MaxValue AllowedValues, Pola MinLength MaxLength, dll.).
            + `Required`(boolean) 

              Menunjukkan jika parameter diperlukan. Default adalah false.
          + `SageMakerCustomAttributes`(Array<Object>) 

            Detail untuk didukung CustomAttributes.
            + `Name`(string) —diperlukan 

              Nama atribut kustom.
            + `Description`(string) —diperlukan 

              Deskripsi atribut kustom.
            + `Constraints`(tali) 

              Kendala atribut (MinValue,,, MaxValue AllowedValues, Pola MinLength MaxLength, dll.).
            + `Required`(boolean) 

              Menunjukkan jika atribut diperlukan. Default adalah false.
        + `OutputProperties`(objek) —diperlukan 

          Detail output. model/algorithm
          + `Description`(string) —diperlukan 

            Deskripsi model/algorithm output.
          + `SampleOutput`(Array<Object>) —diperlukan 

            Sampel data keluaran untuk operasi yang berbeda.
            + `RealtimeInferenceUrl`(tali) 

              Contoh URL keluaran untuk inferensi waktu nyata.
            + `RealtimeInferenceText`(tali) 

              Contoh teks keluaran untuk inferensi waktu nyata.
            + `BatchTransformUrl`(tali) 

              Contoh URL keluaran untuk pekerjaan transformasi batch.
            + `BatchTransformText`(tali) 

              Contoh teks keluaran untuk pekerjaan transformasi batch.
          + `Parameters`(Array) 

            Detail untuk setiap parameter output.
            + `Name`(string) —diperlukan 

              Nama parameter output.
            + `Description`(string) —diperlukan 

              Deskripsi parameter output.
            + `AlwaysReturned`(boolean) 

              Menunjukkan jika parameter selalu dikembalikan. Default adalah false.
        + `RecommendedInstanceTypes`(objek) —diperlukan 

          Jenis instans yang direkomendasikan untuk kinerja optimal.
          + `BatchTransform`(string) —diperlukan 

            Jenis instans yang direkomendasikan untuk operasi transformasi batch.
          + `RealtimeInference`(string) —diperlukan 

            Jenis instans yang direkomendasikan untuk operasi inferensi waktu nyata.
          + `Training`(string) —diperlukan 

            Jenis instans yang direkomendasikan untuk operasi pelatihan algoritme. Diperlukan hanya untuk SageMaker Algoritma.

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

Permintaan yang berhasil mengembalikan:

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

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

1. Validasi: Sistem memeriksa apakah 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, versi baru diperbarui. 

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

**Kesalahan asinkron**  
Kesalahan spesifik untuk `UpdateDeliveryOptions` 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. | 
| INVALID\_DELIVERY\_OPTION\_ID | Berikan ID opsi pengiriman yang dapat ditemukan di produk. ID tidak ditemukan: [x] | 
| INCOMPATIBLE\_DELIVERY\_OPTION\_STATUS | Opsi pengiriman tidak dapat diperbarui karena dalam status terbatas. Coba tambahkan versi baru sebagai gantinya. | 
| INCOMPATIBLE\_DELIVERY\_OPTIONS | Produk sebelumnya digunakan [X] sebagai opsi pengiriman, oleh karena itu semua opsi pengiriman yang akan datang harus bertipe [X] | 
| INVALID\_RECOMMENDED | Menyediakan jenis instans yang tersedia untuk [X] (X dapat berupa Batch Transform, Realtime Inference atau Algorithm Training) | 
| DUPLIKATE\_VERSION\_TITLE | Judul versi harus berbeda dari judul versi lain dari produk ini. | 
| FIELD\_NOT\_ALLOWED\_TO\_CHANGE | Bidang X tidak boleh diubah. |