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.

# Tambahkan versi baru
<a name="ml-add-version"></a>

Anda dapat menggunakan API Katalog atau Portal AWS Marketplace Manajemen untuk menambahkan versi baru ke produk pembelajaran mesin. Untuk informasi selengkapnya tentang penggunaan portal, lihat [Menambahkan versi baru](https://docs.aws.amazon.com/marketplace/latest/userguide/machine-learning-products.html) di *Panduan Penjual AWS Marketplace*. 

**catatan**  
Untuk produk ML, versi terdiri dari opsi pengiriman tunggal, yang mewakili produk yang Anda sediakan. Di API Katalog, bekerja dengan opsi pengiriman untuk produk ML secara efektif memodifikasi versi produk Anda.   
Saat menambahkan jenis instans baru, sertakan jenis `UpdatePricingTerms` perubahan dalam set perubahan Anda untuk menentukan harga untuk jenis instans baru. Untuk produk baru, `UpdatePricingTerms` harus mencakup semua jenis instans yang didukung. `UpdatePricingDimensions`tidak diperlukan atau didukung untuk produk ML, karena dimensi dibuat secara otomatis untuk semua jenis instans yang didukung. Untuk informasi lebih lanjut, lihat[Perbarui dimensi harga](work-with-seller-products.md#update-dimensions).

**Menggunakan `StartChangeSet`untuk menambahkan versi**

 Untuk menambahkan versi baru, panggil `StartChangeSet` operasi dengan jenis `AddDeliveryOptions` perubahan: 

1.  Untuk memvalidasi panggilan API Anda tanpa membuat versi, setel `Intent` ke`VALIDATE`. 

1.  Untuk pembuatan versi aktual, atur `Intent` ke`APPLY`. 

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

```
POST /StartChangeSet HTTP/1.1
Content-type: application/json
{
    "Catalog": "AWSMarketplace",
    "ChangeSet": [{
        "ChangeType": "AddDeliveryOptions",
        "Entity": {
            "Identifier": "example1-abcd-1234-5ef6-7890abcdef12@1",
            "Type": "MachineLearningProduct@1.0"
        },
        "DetailsDocument": {
            "Version": {
                "VersionTitle": "version 1.1",
                "ReleaseNotes": "Patch update for small bugfix in version 1.0"
            },
            "DeliveryOptions": [{
                "Details": {
                    "SageMakerAlgorithmDeliveryOptionDetails": {
                       "SageMakerAlgorithmArn": "arn:aws:sagemaker:us-east-2:605142612156:algorithm/scikit-decision-trees-1552343220",
                       "AccessRoleArn": "arn:aws:iam::12345678901:role/AwsMarketplaceSageMakerIngestion",
                        "UsageInstructions":"This is how you use your algorithm", 
                       "SampleNotebookUrl": "https://www.amazon.com",
                        "RepositoryUrl": "https://www,amazon.com",
                        "InputProperties": {
                            "Description": "Input should have all columns in the train/test file except for 'is_fraud' column.",
                            "Limitations": "Can predict on 1 input in the CSV only at a time",
                           "SampleInput": {
                                "RealtimeInferenceText": "{\"prompt\":\"Write summary\",
                                                            \"maxTokens\": 1 }",
                                "BatchTransformUrl": "https://www.sampleData.com",
                            },
                           "Parameters": [{
                                    "Name": "prompt",
                                    "Description": "Represents the instruct-style prompt for the model. DataType is String",
                                    "Constraints": "Minimum length should be 1",
                                    "Required": true
                                },
                                {
                                    "Name": "maxTokens",
                                    "Description": "Denotes the number of tokens to predict per generation. See BPE Tokens for more details.",
                                    "Constraints": "Minvalue: 1, MaxValue: 30"
                                }
                            ],
                            "SageMakerCustomAttributes": [{
                                    "Name": "threshold",
                                    "Description": "Threshold of the confidence score of the detected object",
                                    "Constraints": "Should be an Integer"
                            }]
                    },
                    "OutputProperties": {
                        "Description": "The output is a JSON object that has the generated text along with likelihoods of tokens, if requested. See example json.",
                       "SampleOutput": {
                            "RealtimeInferenceUrl": "https://www.sampledata.com",
                            "BatchTransformUrl": "https://www.sampleData.com",
                        },
                       "Parameters": [{
                                "Name": "id",
                                "Description": "An identifier for response"
                                "AlwaysReturned": true
                            },
                            {
                                "Name": "generations",
                                "Description": "The generated text along with the likelihoods for tokens requested.",
                            }
                        ],
                    },
                   "RecommendedInstanceTypes": {
                        "BatchTransform": "ml.m4.large",
                        "RealtimeInference": "ml.m4.large",
                        "Training": "ml.m4.large"
                   }
                }
            }]
        }
    }],
    "Intent": "APPLY"
}
```

## Bidang yang diperlukan
<a name="add-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 semua detail tentang versi baru produk Anda.
  + `Version`(objek) —diperlukan

    Detail tentang versi yang ditambahkan.
    + `VersionTitle`(string) —diperlukan

      Judul versi, seperti “Versi 1.1" atau “1.1". Pembeli memilih versi dari judul-judul ini.
    + `ReleaseNotes`(string) —diperlukan

      Catatan terperinci tentang versi ini. Harus di bawah 30.000 karakter.
  + `DeliveryOptions`(array) —diperlukan

    Array metode pengiriman untuk versi produk Anda. Terbatas untuk satu opsi pengiriman per versi.
    + `Details`(objek) —diperlukan
      + `SagemakerModelPackageDeliveryOptionDetails`atau `SageMakerAlgorithmDeliveryOptionDetails` (objek)
        + `SageMakerModelPackageArn`atau `SageMakerAlgorithmArn` (string) —diperlukan

          Nama Sumber Daya Amazon (ARN) dari paket model atau algoritme Anda.
        + `AccessRoleArn`(string) —diperlukan 

          IAM berperan ARN untuk AWS Marketplace untuk mengakses SageMaker sumber daya.
        + `SampleNotebookUrl`(string) —diperlukan 

          Tautan ke contoh notebook Jupyter dengan kode penggunaan. Untuk informasi selengkapnya, lihat [contoh templat buku catatan](https://github.com/aws/amazon-sagemaker-examples/blob/master/aws_marketplace/curating_aws_marketplace_listing_and_sample_notebook/ModelPackage/Sample_Notebook_Template/title_of_your_product-Model.ipynb) di GitHub.
        + `RepositoryUrl`(string) —diperlukan 

          URL repositori Git untuk notebook dan akses data sampel. Untuk informasi selengkapnya, lihat [contoh repositori Git](https://github.com/aws/amazon-sagemaker-examples/tree/master/aws_marketplace/curating_aws_marketplace_listing_and_sample_notebook/ModelPackage/Sample_Notebook_Template) di. GitHub 
        + `UsageInstructions`(string) —diperlukan 

          Informasi pelatihan untuk algoritme atau detail penggunaan untuk model.
        + `InputProperties`(objek) —diperlukan
          + `Description`(string) —diperlukan 

            Deskripsi model/algorithm input
          + `Limitations`(tali) 

            Keterbatasan masukan
          + `SampleInput`(objek) —diperlukan

            RealtimeInferenceUrl (string) \| RealtimeInferenceText (string) \| BatchTransformUrl (string) \| BatchTransformText (string)
          + `Parameters`(Array<Object>)

            Nama (string) —diperlukan \| Deskripsi (string) —Diperlukan \| Kendala (string) \| Diperlukan (boolean)
          + `SageMakerCustomAttributes`(Array<Object>)

            Menjelaskan apa pun [CustomAttributes](https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_runtime_InvokeEndpoint.html#API_runtime_InvokeEndpoint_RequestParameters)yang didukung oleh model Anda.

            `Name`(string) —diperlukan \| `Description` (string) —Diperlukan \| `Constraints` (string) \| `Required` (boolean)
        + `OutputProperties`(objek) —diperlukan
          + `Description`(string) —diperlukan
          + `SampleOutput`(Array<Object>) —diperlukan

            RealtimeInferenceUrl (string) \| RealtimeInferenceText (string) \| BatchTransformUrl (string) \| BatchTransformText (string)
          + `Parameters`(Array)

            Nama (string) —diperlukan \| Deskripsi (string) —diperlukan \| AlwaysReturned (boolean)
        + `RecommendedInstanceTypes`(objek) —diperlukan
          + `BatchTransform`(string) —Diperlukan
          + `RealtimeInference`(string) —Diperlukan
          + `Training`(string) —Diperlukan hanya untuk SageMaker Algoritma

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

Saat Anda mengirimkan permintaan, set perubahan dibuat dan API 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 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 Manajemen AWS Marketplace
   + Menggunakan `DescribeChangeSet` operasi

1.  Penyelesaian: Ketika disetujui, versi baru ditambahkan. 

## Kesalahan
<a name="errors"></a>

**Kesalahan asinkron**  
 Kesalahan berikut khusus untuk `AddDeliveryOptions` tindakan di API AWS Marketplace Katalog. Kesalahan ini muncul saat Anda menelepon `DescribeChangeSet` saat set perubahan sedang diproses. Untuk informasi selengkapnya tentang penggunaan `DescribeChangeSet` untuk memeriksa status permintaan perubahan, lihat [Bekerja dengan set perubahan](https://docs.aws.amazon.com/marketplace-catalog/latest/api-reference/welcome.html#working-with-change-sets). 




| Kode kesalahan | Pesan kesalahan | 
| --- | --- | 
| INCOMPATIBLE\_PRODUCT\_STATUS | Kami tidak dapat menemukan produk yang disediakan. Berikan produk yang valid. | 
| DUPLIKATE\_VERSION\_TITLE | Judul versi yang disediakan sudah digunakan. Buat judul versi unik. | 
| INVALID\_RECOMMENDED | Anda tidak memberikan tipe instance yang valid untuk [x]. Masukkan jenis instance yang valid dan coba lagi. Jenis yang valid adalah: [valids] | 
| INCOMPATIBLE\_DELIVERY\_OPTIONS | Opsi pengiriman yang Anda berikan tidak sesuai dengan pilihan Anda sebelumnya: [pilihan sebelumnya]. Perbarui opsi pengiriman Anda dan coba lagi. | 
| INVALID\_ASSET\_ARN | Anda tidak memberikan ARN yang valid untuk. SageMakerAlgorithmDeliveryOption Masukkan ARN yang valid dan coba lagi. | 
| DUPLIKAT\_ASET | Anda tidak menyediakan ARN unik untuk produk ini. Masukkan ARN unik dan coba lagi. | 
| ASSET\_NOT\_FOUND | Kami tidak dapat menemukan ARN yang Anda berikan. Verifikasi bahwa ARN sudah benar dan memiliki izin yang diperlukan. | 
| ASSET\_VALIDATION\_EXCEPTION | Tidak dapat menelan SagemakerModelArn/SagemakerAlgorithmArn [x] ke akun AWS Sagemaker | 
| INVALID\_ACCESS\_ROLE | Kami tidak dapat menemukan peran IAM ARN yang Anda berikan. Verifikasi bahwa ARN sudah benar dan coba lagi. | 
| UPDATE\_PRICING\_REQUIRED | UpdatePricingTerms diperlukan. |