Referensi API AWS Marketplace direstrukturisasi. Untuk informasi selengkapnya tentang operasi API yang didukung, lihat Referensi API AWS Marketplace.
Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
Tambahkan versi baru
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 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. UpdatePricingDimensionstidak diperlukan atau didukung untuk produk ML, karena dimensi dibuat secara otomatis untuk semua jenis instans yang didukung. Untuk informasi lebih lanjut, lihatPerbarui dimensi harga.
Menggunakan StartChangeSetuntuk menambahkan versi
Untuk menambahkan versi baru, panggil StartChangeSet operasi dengan jenis AddDeliveryOptions perubahan:
-
Untuk memvalidasi panggilan API Anda tanpa membuat versi, setel
IntentkeVALIDATE. -
Untuk pembuatan versi aktual, atur
IntentkeAPPLY.
Sintaksis Permintaan
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
-
Entity(objek) —diperlukanBerisi informasi tentang produk ML Anda.
-
Identifier(string) —diperlukanID produk Anda. Untuk informasi selengkapnya, lihat Pengenal.
-
Type(string) —diperlukanMenentukan metode pengiriman (jenis produk). Itu pasti
MachineLearningProduct@1.0.
-
-
DetailsDocument(objek) —diperlukanBerisi semua detail tentang versi baru produk Anda.
-
Version(objek) —diperlukanDetail tentang versi yang ditambahkan.
-
VersionTitle(string) —diperlukanJudul versi, seperti “Versi 1.1" atau “1.1". Pembeli memilih versi dari judul-judul ini.
-
ReleaseNotes(string) —diperlukanCatatan terperinci tentang versi ini. Harus di bawah 30.000 karakter.
-
-
DeliveryOptions(array) —diperlukanArray metode pengiriman untuk versi produk Anda. Terbatas untuk satu opsi pengiriman per versi.
-
Details(objek) —diperlukan-
SagemakerModelPackageDeliveryOptionDetailsatauSageMakerAlgorithmDeliveryOptionDetails(objek)-
SageMakerModelPackageArnatauSageMakerAlgorithmArn(string) —diperlukanNama Sumber Daya Amazon (ARN) dari paket model atau algoritme Anda.
-
AccessRoleArn(string) —diperlukanIAM berperan ARN untuk AWS Marketplace untuk mengakses SageMaker sumber daya.
-
SampleNotebookUrl(string) —diperlukanTautan ke contoh notebook Jupyter dengan kode penggunaan. Untuk informasi selengkapnya, lihat contoh templat buku catatan
di GitHub. -
RepositoryUrl(string) —diperlukanURL repositori Git untuk notebook dan akses data sampel. Untuk informasi selengkapnya, lihat contoh repositori Git
di. GitHub -
UsageInstructions(string) —diperlukanInformasi pelatihan untuk algoritme atau detail penggunaan untuk model.
-
InputProperties(objek) —diperlukan-
Description(string) —diperlukanDeskripsi model/algorithm input
-
Limitations(tali)Keterbatasan masukan
-
SampleInput(objek) —diperlukanRealtimeInferenceUrl (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 CustomAttributesyang didukung oleh model Anda.
Name(string) —diperlukan |Description(string) —Diperlukan |Constraints(string) |Required(boolean)
-
-
OutputProperties(objek) —diperlukan-
Description(string) —diperlukan -
SampleOutput(Array<Object>) —diperlukanRealtimeInferenceUrl (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
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:
-
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.
-
-
Pemantauan status: Anda dapat memeriksa status permintaan dengan dua cara.
-
Melalui Portal Manajemen AWS Marketplace
-
Menggunakan
DescribeChangeSetoperasi
-
-
Penyelesaian: Ketika disetujui, versi baru ditambahkan.
Kesalahan
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.
| 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. |