View a markdown version of this page

Perbarui informasi versi - AWS Marketplace
Sintaksis PermintaanBidang yang diperlukanSintaksis ResponsKesalahan

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.

Perbarui informasi versi

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 StartChangeSetuntuk menambahkan versi:

  • Untuk memperbarui informasi versi, panggil StartChangeSet operasi dengan jenis UpdateDeliveryOptions perubahan.

Sintaksis Permintaan

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

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

        • SageMakerModelPackageSubscriptionDetailsatau 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

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.

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

    • Melalui Portal AWS Marketplace Manajemen

    • Menggunakan DescribeChangeSet operasi

  3. Penyelesaian: Ketika disetujui, versi baru diperbarui.

Kesalahan

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.

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.