View a markdown version of this page

Tambahkan versi baru - AWS Marketplace

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:

  1. Untuk memvalidasi panggilan API Anda tanpa membuat versi, setel Intent keVALIDATE.

  2. Untuk pembuatan versi aktual, atur Intent keAPPLY.

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) —diperlukan

    Berisi informasi tentang produk ML Anda.

    • Identifier(string) —diperlukan

      ID produk Anda. Untuk informasi selengkapnya, lihat Pengenal.

    • Type(string) —diperlukan

      Menentukan metode pengiriman (jenis produk). Itu pastiMachineLearningProduct@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

        • SagemakerModelPackageDeliveryOptionDetailsatau SageMakerAlgorithmDeliveryOptionDetails (objek)

          • SageMakerModelPackageArnatau 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 di GitHub.

          • RepositoryUrl(string) —diperlukan

            URL repositori Git untuk notebook dan akses data sampel. Untuk informasi selengkapnya, lihat contoh repositori Git 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 CustomAttributesyang 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

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.

  2. Pemantauan status: Anda dapat memeriksa status permintaan dengan dua cara.

    • Melalui Portal Manajemen AWS Marketplace

    • Menggunakan DescribeChangeSet operasi

  3. 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.