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.

Bekerja dengan otorisasi penjualan kembali menggunakan AWS Marketplace API

Anda dapat menggunakan AWS Marketplace Catalog API untuk mengotomatiskan tugas untuk bekerja dengan Otorisasi Penjualan Kembali.

Sementara produk menggambarkan apa yang sedang dijual AWS Marketplace, Otorisasi Penjualan Kembali (juga dikenal sebagai peluang) menjelaskan persyaratan dan aturan mengenai bagaimana produk ini diizinkan untuk dijual kembali. AWS MarketplaceCPPO adalah target dari Resale Authorization.

Otorisasi Penjualan Kembali memiliki kumpulan syarat dan aturan yang harus diterima untuk perjanjian pengecer antara produsen dan mitra saluran. Menerima ketentuan Otorisasi Penjualan Kembali memungkinkan pengecer untuk membuat penawaran untuk produk sesuai ketentuan yang dinyatakan dalam ketentuan.

Ada dua jenis aturan dalam Otorisasi Penjualan Kembali:

Lihat sumber daya berikut:

Topik berikut menjelaskan cara menggunakan API Katalog untuk membuat dan memperbarui Otorisasi Penjualan Kembali:

Prasyarat Otorisasi Penjualan Kembali

Untuk menggunakan Otorisasi Penjualan Kembali, vendor perangkat lunak independen (ISV) dan Mitra AWS Marketplace Saluran harus membuat peran terkait layanan yang menyediakan izin berbagi sumber daya. AWS Jika kedua grup tidak melakukan prasyarat ini, tidak AWS dapat membagikan sumber otorisasi dari ISV ke Mitra Saluran. AWS Marketplace Untuk informasi selengkapnya, lihat Menggunakan peran untuk Otorisasi Penjualan Kembali AWS Marketplace di Panduan AWS Marketplace Penjual.

Buat Otorisasi Penjualan Kembali baru

Anda dapat menggunakan API Katalog untuk membuat Otorisasi Penjualan Kembali baru di. AWS Marketplace

Jika permintaan Anda berhasil diproses, AWS Marketplace Catalog API buat Otorisasi Penjualan Kembali dalam Draft status untuk Anda. Ini adalah Otorisasi Penjualan Kembali yang tidak lengkap dan tidak terlihat oleh mitra saluran di. AWS Marketplace

Gunakan jenis Update perubahan untuk menyelesaikan Otorisasi Penjualan Kembali. Setelah Otorisasi Penjualan Kembali selesai, gunakan jenis ReleaseResaleAuthorization perubahan untuk menyelesaikan proses pembuatan Otorisasi Penjualan Kembali dan lepaskan Otorisasi Penjualan Kembali, yang akan memvalidasi seluruh Otorisasi Penjualan Kembali dan membuatnya terlihat oleh mitra saluran di. AWS Marketplace

Untuk membuat Otorisasi Penjualan Kembali dalam Draft status, panggil operasi StartChangeSet API dengan jenis CreateResaleAuthorization perubahan, seperti yang ditunjukkan pada contoh berikut.

Permintaan Sintaks

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

{
  "Catalog": "AWSMarketplace",
  "ChangeSet":
  [
    {
      "ChangeType": "CreateResaleAuthorization",
      "ChangeName": "xyz",
      "Entity":
      {
        "Type": "ResaleAuthorization@1.0"
      },
      "DetailsDocument":
      {
        "ProductId": "prod-ad8EXAMPLE51",
        "Name": "Test ResaleAuthorization",
        "Description": "Worldwide ResaleAuthorization for Test Product",
        "ResellerAccountId": "777788889999"
      }
    }
  ]
}

Berikan informasi untuk kolom input untuk menambahkan jenis CreateResaleAuthorization perubahan:

Sintaks Respon

Set perubahan dibuat untuk permintaan Anda. Respons terhadap permintaan ini memberi Anda ChangeSetId dan ChangeSetArn untuk set perubahan dan terlihat seperti berikut.

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

Permintaan perubahan ditambahkan ke antrian dan diproses.

Anda dapat memeriksa status permintaan melalui Portal Manajemen AWS Marketplace, atau langsung melalui API Katalog menggunakan operasi DescribeChangeSet API.

Ketika permintaan selesai (jika Status adaSUCCEEDED), yang baru ResaleAuthorization dihasilkan. Meskipun SUCCEEDED status menunjukkan bahwa panggilan jenis CreateResaleAuthorization perubahan selesai, ResaleAuthorization status masih dalam Draft status.

Berikut ini menunjukkan respons dari operasi DescribeChangeSetAPI.

{
  "ChangeSetId": "example123456789012abcdef",
  "ChangeSetArn": "arn:aws:aws-marketplace:us-east-1:123456789012:AWSMarketplace/ChangeSet/example123456789012abcdef",
  "ChangeSetName": "Submitted by 123456789012",
  "StartTime": "2021-05-27T22:21:26Z",
  "EndTime": "2021-05-27T22:32:19Z",
  "Status": "SUCCEEDED",
  "ChangeSet":
  [
    {
      "ChangeType": "CreateResaleAuthorization",
      "Entity":
      {
        "Type": "ResaleAuthorization@1.0",
        "Identifier": "resaleauthz-123456789"
      },
      "DetailsDocument":
      {
        "ProductId": "prod-ad8EXAMPLE51",
        "Name": "Test ResaleAuthorization",
        "Description": "Worldwide ResaleAuthorization for Test Product",
        "ResellerAccountId": "777788889999",
        "BulkRequestId": "84977023-5093-4a66-8b24-ef2c5a2f8b1f"
      },
      "ErrorDetailList":
      []
    }
  ]
}

Validasi sinkron

Validasi skema khusus untuk CreateResaleAuthorization tindakan di. AWS Marketplace Catalog API Validasi dilakukan saat Anda menelepon. StartChangeSet Jika permintaan tidak memenuhi persyaratan berikut, itu akan gagal dengan respons HTTP.

Kesalahan Asinkron

Kesalahan berikut khusus untuk CreateResaleAuthorization tindakan di AWS Marketplace Catalog API. Kesalahan ini dikembalikan saat Anda memanggil DescribeChangeSet setelah set perubahan diproses. Untuk informasi selengkapnya tentang penggunaan DescribeChangeSet untuk mendapatkan status permintaan perubahan, lihatBekerja dengan set perubahan.

Perbarui penargetan pembeli

Anda dapat menggunakan API Katalog untuk memperbarui pembeli yang menargetkan Otorisasi Penjualan Kembali Anda di. AWS Marketplace

Opsi penargetan yang ada yang tidak disertakan dalam permintaan terbaru akan dihapus dari Otorisasi Penjualan Kembali. Jenis perubahan ini opsional untuk rilis Otorisasi Penjualan Kembali.

Untuk memperbarui pembeli yang menargetkan Otorisasi Penjualan Kembali Anda, panggil operasi StartChangeSet API dengan jenis UpdateBuyerTargetingTerms perubahan, seperti yang ditunjukkan pada contoh berikut.

Permintaan Sintaks

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

{
   "Catalog": "AWSMarketplace",
   "ChangeSet": [        
      {
         "ChangeType":"UpdateBuyerTargetingTerms",
         "Entity":{
            "Type": "ResaleAuthorization@1.0", 
            "Identifier": "resaleauthz-123456789"
         },
         "DetailsDocument":
         {
           "Terms":
           [
             {
               "Type": "BuyerTargetingTerm",
               "PositiveTargeting":
               {
                 "BuyerAccounts":
                 [
                  "123456789012"
                 ]
               }
             }
           ]
         }
      }
   ]
}

Berikan informasi untuk bidang untuk menambahkan jenis UpdateBuyerTargetingTerms perubahan:

Sintaks Respon

Set perubahan dibuat untuk permintaan Anda. Respons terhadap permintaan ini memberi Anda ChangeSetId dan ChangeSetArn untuk set perubahan dan terlihat seperti berikut.

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

Permintaan perubahan ditambahkan ke antrian dan diproses. Ini termasuk memvalidasi informasi dengan tim Operasi AWS Marketplace Penjual untuk memastikannya memenuhi AWS Marketplace pedoman. Proses validasi dapat berlangsung dari beberapa menit hingga beberapa jam.

Anda dapat memeriksa status permintaan melalui Portal Manajemen AWS Marketplace, atau langsung melalui API Katalog menggunakan operasi DescribeChangeSet API.

Validasi sinkron

Validasi skema khusus untuk UpdateBuyerTargetingTerms tindakan di. AWS Marketplace Catalog API Validasi ini dilakukan saat Anda menelepon. StartChangeSet Jika permintaan tidak memenuhi persyaratan berikut, itu akan gagal dengan respons HTTP.

Kesalahan Asinkron

Kesalahan berikut khusus untuk UpdateBuyerTargetingTerms tindakan di AWS Marketplace Catalog API. Kesalahan ini dikembalikan saat Anda memanggil DescribeChangeSet setelah set perubahan diproses. Untuk informasi selengkapnya tentang penggunaan DescribeChangeSet untuk mendapatkan status permintaan perubahan, lihatBekerja dengan set perubahan.

Perbarui ketersediaan

Anda dapat menggunakan API Katalog untuk membatasi ketersediaan berapa banyak penawaran pribadi yang dibuat atau sampai waktu tertentu penawaran pribadi dapat dibuat.

Secara default, nilainya adalah penggunaan tak terbatas dari Otorisasi Penjualan Kembali ini, meskipun Anda dapat memeriksa ketersediaan di bawah daftar aturan.

Untuk mengontrol ketersediaan dan kegunaan Otorisasi Penjualan Kembali Anda, panggil operasi StartChangeSet API dengan jenis UpdateAvailability perubahan, seperti yang ditunjukkan pada contoh berikut.

Permintaan Sintaks

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

{
  "Catalog": "AWSMarketplace",
  "ChangeSet":
  [
    {
      "ChangeType": "UpdateAvailability",
      "Entity":
      {
        "Type": "ResaleAuthorization@1.0",
        "Identifier": "resaleauthz-123456789"
      },
      "DetailsDocument":
      {
        "AvailabilityEndDate": "2022-05-31",
        "OffersMaxQuantity": 1
      }
    }
  ]
}

Berikan informasi untuk bidang untuk menambahkan jenis UpdateAvailability perubahan:

Sintaks Respon

Set perubahan dibuat untuk permintaan Anda. Respons terhadap permintaan ini memberi Anda ChangeSetId dan ChangeSetArn untuk set perubahan dan terlihat seperti berikut.

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

Permintaan perubahan ditambahkan ke antrian dan diproses. Ini termasuk memvalidasi informasi dengan tim Operasi AWS Marketplace Penjual untuk memastikannya memenuhi AWS Marketplace pedoman. Proses validasi dapat berlangsung dari beberapa menit hingga beberapa jam.

Anda dapat memeriksa status permintaan melalui Portal Manajemen AWS Marketplace, atau langsung melalui API Katalog menggunakan operasi DescribeChangeSet API.

Validasi sinkron

Validasi skema khusus untuk UpdateAvailability tindakan di. AWS Marketplace Catalog API Validasi dilakukan saat Anda menelepon. StartChangeSet Jika permintaan tidak memenuhi persyaratan berikut, itu akan gagal dengan respons HTTP

Kesalahan Asinkron

Kesalahan berikut khusus untuk UpdateAvailability tindakan di AWS Marketplace Catalog API. Kesalahan ini dikembalikan saat Anda memanggil DescribeChangeSet setelah set perubahan diproses. Untuk informasi selengkapnya tentang penggunaan DescribeChangeSet untuk mendapatkan status permintaan perubahan, lihatBekerja dengan set perubahan.

Memperbarui validitas perjanjian bertanggal di masa depan

Anda dapat menggunakan API Katalog untuk memodifikasi dan mengontrol tanggal mulai layanan bertanggal di masa mendatang AWS Marketplace.

Set perubahan ini tidak wajib untuk merilis Otorisasi Penjualan Kembali.

Untuk mengubah dan mengontrol durasi perjanjian produk dari Otorisasi Penjualan Kembali Anda, panggil operasi StartChangeSet API dengan jenis UpdateBuyerValidityTerms perubahan, seperti yang ditunjukkan pada contoh berikut.

Permintaan Sintaks

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

{
  "Catalog": "AWSMarketplace",
  "ChangeSet":
  [
    {
      "ChangeType": "UpdateBuyerValidityTerms",
      "Entity":
      {
        "Type": "ResaleAuthorization@1.0",
        "Identifier": "resaleauthz-123456789"
      },
      "DetailsDocument":
      {
        "Terms":
        [
          {
            "Type": "BuyerValidityTerm",
            "MaximumAgreementStartDate": "2024-05-31"
          }
        ]
      }
    }
  ]
}

Berikan informasi untuk kolom input untuk menambahkan jenis UpdateBuyerValidityTerms perubahan:

Sintaks Respon

Set perubahan dibuat untuk permintaan Anda. Respons terhadap permintaan ini memberi Anda ChangeSetId dan ChangeSetArn untuk set perubahan dan terlihat seperti berikut.

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

Permintaan perubahan ditambahkan ke antrian dan diproses. Ini termasuk memvalidasi informasi dengan tim Operasi AWS Marketplace Penjual untuk memastikannya memenuhi AWS Marketplace pedoman. Proses validasi dapat berlangsung dari beberapa menit hingga beberapa jam.

Anda dapat memeriksa status permintaan melalui Portal Manajemen AWS Marketplace, atau langsung melalui API Katalog menggunakan operasi DescribeChangeSet API.

Validasi sinkron

Validasi skema khusus untuk UpdateBuyerValidityTerms tindakan di. AWS Marketplace Catalog API Validasi dilakukan saat Anda menelepon. StartChangeSet Jika permintaan tidak memenuhi persyaratan berikut, itu akan gagal dengan respons HTTP.

Kesalahan Asinkron

Kesalahan berikut khusus untuk UpdateBuyerValidityTerms tindakan di AWS Marketplace Catalog API. Kesalahan ini dikembalikan saat Anda memanggil DescribeChangeSet setelah set perubahan diproses. Untuk informasi selengkapnya tentang penggunaan DescribeChangeSet untuk mendapatkan status permintaan perubahan, lihatBekerja dengan set perubahan.

Perbarui sumber daya hukum

Anda dapat menggunakan API Katalog untuk mengganti persyaratan hukum yang ada sepenuhnya di AWS Marketplace.

Ketentuan hukum yang tidak termasuk dalam permintaan terbaru akan dihapus dari Otorisasi Penjualan Kembali. BuyerLegalTermberisi EULA yang akan dimasukkan pada perjanjian pembeli akhir dan LegalTerm termasuk Kontrak Reseller yang akan dimasukkan dalam perjanjian pengecer antara mitra saluran dan ISV.

Untuk memperbarui ketentuan hukum AndaResaleAuthorization, panggil operasi StartChangeSet API dengan jenis UpdateLegalTerms perubahan, seperti yang ditunjukkan pada contoh berikut.

Permintaan Sintaks

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

{
  "Catalog": "AWSMarketplace",
  "ChangeSet":
  [
    {
      "ChangeType": "UpdateLegalTerms",
      "Entity":
      {
        "Type": "ResaleAuthorization@1.0",
        "Identifier": "resaleauthz-123456789"
      },
      "DetailsDocument":
      {
        "Terms":
        [
          {
            "Type": "BuyerLegalTerm",
            "Documents":
            [
              {
                "Type": "CustomEula",
                "Url": "https://my-public-bucket.s3.amazonaws.com/eula-example12345.txt"
              }
            ]
          },
          {
            "Type": "ResaleLegalTerm",
            "Documents":
            [
              {
                "Type": "CustomResellerContract",
                "Url": "https://my-public-bucket.s3.amazonaws.com/reseller-example12345.txt"
              }
            ]
          }
        ]
      }
    }
  ]
}

Berikan informasi untuk bidang untuk menambahkan jenis UpdateLegalTerms perubahan:

Sintaks Respon

Set perubahan dibuat untuk permintaan Anda. Respons terhadap permintaan ini memberi Anda ChangeSetId dan ChangeSetArn untuk set perubahan dan terlihat seperti berikut.

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

Permintaan perubahan ditambahkan ke antrian dan diproses. Ini termasuk memvalidasi informasi untuk memastikan bahwa itu memenuhi AWS Marketplace pedoman. Proses validasi dapat berlangsung dari beberapa menit hingga beberapa jam.

Anda dapat memeriksa status permintaan melalui Portal Manajemen AWS Marketplace, atau langsung melalui API Katalog menggunakan operasi DescribeChangeSet API.

Validasi sinkron

Validasi skema khusus untuk UpdateLegalTerms tindakan di. AWS Marketplace Catalog API Validasi dilakukan saat Anda menelepon. StartChangeSet Jika permintaan tidak memenuhi persyaratan berikut, itu akan gagal dengan respons HTTP.

Kesalahan Asinkron

Kesalahan berikut khusus untuk UpdateLegalTerms tindakan di AWS Marketplace Catalog API. Kesalahan ini dikembalikan saat Anda meneleponDescribeChangeSet, setelah set perubahan diproses. Untuk informasi selengkapnya tentang penggunaan DescribeChangeSet untuk mendapatkan status permintaan perubahan, lihatBekerja dengan set perubahan.

Perbarui harga

Anda dapat menggunakan API Katalog untuk mengganti persyaratan harga yang ada sepenuhnya AWS Marketplace.

Ketentuan harga yang tidak termasuk dalam permintaan terbaru akan dihapus dari Otorisasi Penjualan Kembali. Anda dapat memperbarui harga diskon untuk produk Anda melalui API ini.

Untuk memperbarui detail harga untuk Otorisasi Penjualan Kembali, panggil operasi StartChangeSet API dengan jenis UpdatePricingTerms perubahan, seperti yang ditunjukkan pada contoh berikut.

Permintaan Sintaks

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

{
  "Catalog": "AWSMarketplace",
  "ChangeSet":
  [
    {
      "ChangeType": "UpdatePricingTerms",
      "Entity":
      {
        "Type": "ResaleAuthorization@1.0",
        "Identifier": "resaleauthz-123456789"
      },
      "DetailsDocument":
      {
        "PricingModel": "Contract",
        "Terms":
        [
          {
            "Type": "ResaleUsageBasedPricingTerm",
            "CurrencyCode": "USD",
            "RateCards":
            [
              {
                "RateCard":
                [
                  {
                    "DimensionKey": "m3.large",
                    "Price": "0.10"
                  },
                  {
                    "DimensionKey": "m4.xlarge",
                    "Price": "0.20"
                  }
                ]
              }
            ]
          },
          {
            "Type": "ResaleConfigurableUpfrontPricingTerm",
            "CurrencyCode": "USD",
            "RateCards":
            [
              {
                "Selector":
                {
                  "Type": "Duration",
                  "Value": "P12M"
                },
                "RateCard":
                [
                  {
                    "DimensionKey": "m3.large",
                    "Price": "300"
                  },
                  {
                    "DimensionKey": "m4.xlarge",
                    "Price": "400"
                  }
                ],
                "Constraints":
                {
                  "MultipleDimensionSelection": "Allowed",
                  "QuantityConfiguration": "Allowed"
                }
              }
            ]
          },
          {
            "Type": "ResaleFixedUpfrontPricingTerm",
            "CurrencyCode": "USD",
            "Duration": "P2M",
            "Price": "200.0",
            "Grants":
            [
              {
                "DimensionKey": "Users",
                "MaxQuantity": 10
              }
            ]
          }
        ]
      }
    }
  ]
}

Berikan informasi untuk bidang untuk menambahkan jenis UpdatePricingTerms perubahan:

Sintaks Respon

Set perubahan dibuat untuk permintaan Anda. Respons terhadap permintaan ini memberi Anda ChangeSetId dan ChangeSetArn untuk set perubahan dan terlihat seperti berikut.

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

Permintaan perubahan ditambahkan ke antrian dan diproses. Ini termasuk memvalidasi informasi untuk memastikan bahwa itu memenuhi AWS Marketplace pedoman. Proses validasi dapat berlangsung dari beberapa menit hingga beberapa jam.

Anda dapat memeriksa status permintaan melalui Portal Manajemen AWS Marketplace, atau langsung melalui API Katalog menggunakan operasi DescribeChangeSet API.

Validasi sinkron

Validasi skema berikut khusus untuk UpdatePricingTerms tindakan di AWS Marketplace Catalog API. Validasi dilakukan saat Anda menelepon. StartChangeSet Jika permintaan tidak memenuhi persyaratan berikut, itu akan gagal dengan respons HTTP.

Kesalahan Asinkron

Kesalahan berikut khusus untuk UpdatePricingTerms tindakan di AWS Marketplace Catalog API. Kesalahan ini dikembalikan saat Anda memanggil DescribeChangeSet setelah set perubahan diproses. Untuk informasi selengkapnya tentang penggunaan DescribeChangeSet untuk mendapatkan status permintaan perubahan, lihatBekerja dengan set perubahan.

Perbarui jadwal pembayaran

Anda dapat menggunakan API Katalog untuk mengubah detail terkait pembayaran, seperti jadwal pembayaran yang fleksibel, di. AWS Marketplace

Untuk memperbarui detail terkait pembayaran untuk Otorisasi Penjualan Kembali, panggil operasi StartChangeSet API dengan jenis UpdatePaymentScheduleTerms perubahan, seperti yang ditunjukkan pada contoh berikut.

Permintaan Sintaks

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

{
  "Catalog": "AWSMarketplace",
  "ChangeSet":
  [
    {
      "ChangeType": "UpdatePaymentScheduleTerms",
      "Entity":
      {
        "Type": "ResaleAuthorization@1.0",
        "Identifier": "resaleauthz-123456789"
      },
      "DetailsDocument":
      {
        "Terms":
        [
          {
            "Type": "ResalePaymentScheduleTerm",
            "CurrencyCode": "USD",
            "Schedule":
            [
              {
                "ChargeDate": "2021-12-01",
                "ChargeAmount": "200.00"
              },
              {
                "ChargeDate": "2022-03-01",
                "ChargeAmount": "250.00"
              }
            ]
          }
        ]
      }
    }
  ]
}

Berikan informasi untuk bidang untuk menambahkan jenis UpdatePaymentScheduleTerms perubahan:

Sintaks Respon

Set perubahan dibuat untuk permintaan Anda. Respons terhadap permintaan ini memberi Anda ChangeSetId dan ChangeSetArn untuk set perubahan dan terlihat seperti berikut.

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

Permintaan perubahan ditambahkan ke antrian dan diproses. Ini termasuk memvalidasi informasi untuk memastikan bahwa itu memenuhi AWS Marketplace pedoman. Proses validasi dapat berlangsung dari beberapa menit hingga beberapa jam.

Anda dapat memeriksa status permintaan melalui Portal Manajemen AWS Marketplace, atau langsung melalui API Katalog menggunakan operasi DescribeChangeSet API.

Validasi sinkron

Validasi skema khusus untuk UpdatePaymentScheduleTerms tindakan di. AWS Marketplace Catalog API Validasi dilakukan saat Anda menelepon. StartChangeSet Jika permintaan tidak memenuhi persyaratan berikut, itu akan gagal dengan respons HTTP.

Kesalahan Asinkron

Kesalahan berikut khusus untuk UpdatePaymentScheduleTerms tindakan di AWS Marketplace Catalog API. Kesalahan ini dikembalikan saat Anda memanggil DescribeChangeSet setelah set perubahan sedang diproses. atau informasi selengkapnya tentang penggunaan DescribeChangeSet untuk mendapatkan status permintaan perubahan, lihat. Bekerja dengan set perubahan

Perbarui detail Otorisasi Penjualan Kembali

Anda dapat menggunakan API Katalog untuk memperbarui detail Otorisasi Penjualan Kembali di. AWS Marketplace

Untuk memperbarui detail Otorisasi Penjualan Kembali, panggil operasi StartChangeSet API dengan jenis UpdateInformation perubahan, seperti yang ditunjukkan pada contoh berikut.

Permintaan Sintaks

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

{
  "Catalog": "AWSMarketplace",
  "ChangeSet":
  [
    {
      "ChangeType": "UpdateInformation",
      "Entity":
      {
        "Type": "ResaleAuthorization@1.0",
        "Identifier": "resaleauthz-123456789"
      },
      "DetailsDocument":
      {
        "Name": "TestResaleAuthorization",
        "Description": "Worldwide ResaleAuthorization for Test Product",
        "PreExistingBuyerAgreement":
        {
          "AcquisitionChannel": "AwsMarketplace",
          "PricingModel": "Contract"
        }
      }
    }
  ]
}

Berikan informasi untuk bidang untuk menambahkan jenis UpdateInformation perubahan:

Sintaks Respon

Set perubahan dibuat untuk permintaan Anda. Respons terhadap permintaan ini memberi Anda ChangeSetId dan ChangeSetArn untuk set perubahan dan terlihat seperti berikut.

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

Permintaan perubahan ditambahkan ke antrian dan diproses. Ini termasuk memvalidasi informasi untuk memastikan bahwa itu memenuhi AWS Marketplace pedoman. Proses validasi dapat berlangsung dari beberapa menit hingga beberapa jam.

Anda dapat memeriksa status permintaan melalui Portal Manajemen AWS Marketplace, atau langsung melalui API Katalog menggunakan operasi DescribeChangeSet API.

Validasi sinkron

Validasi skema berikut khusus untuk UpdateInformation tindakan di. AWS Marketplace Catalog API Validasi ini dilakukan saat Anda meneleponStartChangeSet, dan permintaan akan gagal dengan kesalahan HTTP jika input tidak memenuhi persyaratan berikut.

Kesalahan Asinkron

Kesalahan berikut khusus untuk UpdateInformation tindakan di AWS Marketplace Catalog API. Kesalahan ini dikembalikan saat Anda memanggil DescribeChangeSet setelah set perubahan sedang diproses. atau informasi selengkapnya tentang penggunaan DescribeChangeSet untuk mendapatkan status permintaan perubahan, lihat. Bekerja dengan set perubahan

Batasi Otorisasi Penjualan Kembali

Anda dapat menggunakan API Katalog untuk menetapkan aturan pembatasan ke Otorisasi Penjualan Kembali di. AWS Marketplace

Otorisasi Penjualan Kembali terbatas tidak dapat lagi digunakan oleh mitra saluran untuk membuat penawaran pribadi. Penawaran pribadi yang ada tidak akan terpengaruh.

Untuk membatasi Otorisasi Penjualan Kembali, panggil operasi StartChangeSet API dengan tipe RestrictResaleAuthorization perubahan, seperti yang ditunjukkan pada contoh berikut.

Permintaan Sintaks

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

{
  "Catalog": "AWSMarketplace",
  "ChangeSet": [
    {
      "ChangeType": "RestrictResaleAuthorization",
      "Entity": {
        "Type": "ResaleAuthorization@1.0",
        "Identifier": "resaleauthz-123456789"
      },
      "DetailsDocument": {}
    }
  ]
}

Berikan informasi untuk bidang untuk menambahkan jenis RestrictResaleAuthorization perubahan:

Sintaks Respon

Set perubahan dibuat untuk permintaan Anda. Respons terhadap permintaan ini memberi Anda ChangeSetId dan ChangeSetArn untuk set perubahan dan terlihat seperti berikut.

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

Permintaan perubahan ditambahkan ke antrian dan diproses. Ini termasuk memvalidasi informasi untuk memastikan bahwa itu memenuhi AWS Marketplace pedoman. Proses validasi dapat berlangsung dari beberapa menit hingga beberapa jam.

Anda dapat memeriksa status permintaan melalui Portal Manajemen AWS Marketplace, atau langsung melalui API Katalog menggunakan operasi DescribeChangeSet API.

Validasi sinkron

Validasi skema khusus untuk RestrictResaleAuthorization tindakan di AWS Marketplace Catalog API. Validasi ini dilakukan saat Anda menelepon. StartChangeSet Jika permintaan tidak memenuhi persyaratan berikut, itu akan gagal dengan respons HTTP.

Kesalahan Asinkron

Kesalahan berikut khusus untuk RestrictResaleAuthorization tindakan di AWS Marketplace Catalog API. Kesalahan ini dikembalikan saat Anda memanggil DescribeChangeSet setelah set perubahan sedang diproses. atau informasi selengkapnya tentang penggunaan DescribeChangeSet untuk mendapatkan status permintaan perubahan, lihat. Bekerja dengan set perubahan

Melepaskan Otorisasi Penjualan Kembali dan membuatnya terlihat oleh Mitra Saluran

Anda dapat menggunakan API Katalog untuk memulai ResaleAuthorization ke Active status.

ReleaseResaleAuthorizationmembuat Otorisasi Penjualan Kembali Anda aktif sehingga Mitra Saluran dapat menggunakan Otorisasi Penjualan Kembali Anda untuk membuat penawaran pribadi.

Untuk merilis Resale Authorization, panggil operasi StartChangeSet API dengan tipe ReleaseResaleAuthorization perubahan, seperti yang ditunjukkan pada contoh berikut.

Permintaan Sintaks

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

{
  "Catalog": "AWSMarketplace",
  "ChangeSet":
  [
    {
      "ChangeType": "ReleaseResaleAuthorization",
      "Entity":
      {
        "Type": "ResaleAuthorization@1.0",
        "Identifier": "resaleauthz-123456789"
      },
      "DetailsDocument": {}
    }
  ]
}

Berikan informasi untuk bidang untuk menambahkan jenis ReleaseResaleAuthorization perubahan:

Sintaks Respon

Set perubahan dibuat untuk permintaan Anda. Respons terhadap permintaan ini memberi Anda ChangeSetId dan ChangeSetArn untuk set perubahan dan terlihat seperti berikut.

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

Permintaan perubahan ditambahkan ke antrian dan diproses. Ini termasuk memvalidasi informasi untuk memastikan bahwa itu memenuhi AWS Marketplace pedoman. Proses validasi dapat berlangsung dari beberapa menit hingga beberapa jam.

Anda dapat memeriksa status permintaan melalui Portal Manajemen AWS Marketplace, atau langsung melalui API Katalog menggunakan operasi DescribeChangeSet API.

Validasi sinkron

Validasi skema khusus untuk ReleaseResaleAuthorization tindakan di. AWS Marketplace Catalog API Validasi dilakukan saat Anda menelepon. StartChangeSet Jika permintaan tidak memenuhi persyaratan berikut, itu akan gagal dengan respons HTTP.

Kesalahan Asinkron

Kesalahan berikut khusus untuk ReleaseResaleAuthorization tindakan di AWS Marketplace Catalog API. Kesalahan ini dikembalikan saat Anda memanggil DescribeChangeSet setelah set perubahan diproses. Untuk detail selengkapnya tentang penggunaan DescribeChangeSet untuk mendapatkan status permintaan perubahan, lihatBekerja dengan set perubahan.

Jelaskan Otorisasi Penjualan Kembali yang ada

Untuk menjelaskan detail Otorisasi Penjualan Kembali, panggil operasi DescribeEntity API dengan tipe ResaleAuthorization@1.0 entitas, seperti yang ditunjukkan pada contoh berikut.

Permintaan Sintaks

GET /DescribeEntity?catalog=<Catalog>&entityId=<EntityId> HTTP/1.1

Berikan informasi untuk bidang untuk menambahkan jenis DescribeEntity perubahan:

Sintaks Respon

Tanggapan atas permintaan ini memberi Anda detail penawaran dan terlihat seperti berikut ini.

{
  "EntityType": "ResaleAuthorization@1.0",
  "EntityIdentifier": "resaleauthz-123456789",
  "EntityArn": "arn:aws:aws-marketplace:us-east-1:111122223333:AWSMarketplace/ResaleAuthorization/resaleauthz-123456789",
  "LastModifiedDate": "2021-03-10T21:57:16Z",
  "DetailsDocument": {
    "Name": "TestResaleAuthorization",
    "Description": "ResaleAuthorization for Test Product",
    "ProductId": "prod-ad8EXAMPLE51",
    "ProductName": "TestProduct",
    "Status": "Active", /*Draft, Active, Restricted*/
    "PreExistingBuyerAgreement": {
      "AcquisitionChannel": "Unknown",
      "PricingModel": "Unknown"
    },
    "CreatedDate": "2023-07-18T16:39:31.335Z",
    "ManufacturerLegalName": "ChannelCAPI.Inc",
    "ManufacturerAccountId": "123456789012",
    "Dimensions": [
      {
        "Name": "Protected Resources",
        "Description": "Additional 100 protected resources",
        "Key": "hundredresources",
        "Unit": "Units",
        "Types": [
          "Entitled"
        ]
      }
    ],
    "OfferDetails": {
      "OfferExtendedStatus": "Not Started", /* Not Started, Completed-Used, Completed-Usable*/
      "OfferCreatedCount": 0
    },
    "Terms": [
      {
        "Type": "ResaleUsageBasedPricingTerm",
        "Id": "term_id_placeholder",
        "CurrencyCode": "USD",
        "RateCards": [
          {
            "RateCard": [
              {
                "DimensionKey": "resource_number",
                "Price": "0.05"
              },
              {
                "DimensionKey": "scanned_data",
                "Price": "0.05"
              }
            ]
          }
        ]
      },
      {
        "Type": "ResaleConfigurableUpfrontPricingTerm",
        "Id": "term_id_placeholder",
        "CurrencyCode": "USD",
        "RateCards": [
          {
            "Selector": {
              "Type": "Duration",
              "Value": "P24M"
            },
            "RateCard": [
              {
                "DimensionKey": "hundredresources",
                "Price": "0.04"
              },
              {
                "DimensionKey": "tenTBData",
                "Price": "0.03"
              },
              {
                "DimensionKey": "channel_custom",
                "Price": "0.02"
              }
            ],
            "Constraints": {
              "MultipleDimensionSelection": "Allowed",
              "QuantityConfiguration": "Allowed"
            }
          }
        ]
      },
      {
        "Type": "ResaleFixedUpfrontPricingTerm",
        "Id": "term-sdh27fb2",
        "CurrencyCode": "USD",
        "Duration": "P180D",
        "Price": "0.0",
        "Grants": [
          {
            "DimensionKey": "sdf73rbns93nl120d10xm1",
            "MaxQuantity": 1
          }
        ]
      },
      {
        "Type": "ResalePaymentScheduleTerm",
        "Id": "term-sdh27fb2",
        "CurrencyCode": "USD",
        "Schedule": [
          {
            "ChargeDate": "2018-07-01T00:00:00.000Z",
            "ChargeAmount": "200.00"
          },
          {
            "ChargeDate": "2019-05-01T00:00:00.000Z",
            "ChargeAmount": "200.00"
          }
        ]
      },
      {
        "Type": "BuyerLegalTerm",
        "Id": "term_id_placeholder",
        "Documents": [
          {
            "Type": "StandardEula",
            "Url": "https://resale-auth-legal-terms-iad-beta.s3.us-east-1.amazonaws.com/09ae57d6-c75a-3a4c-aadf-9b866bae64ab/a85cace8-6d9d-40ca-a053-78fc265479bf?isSigned=yes"
          }
        ]
      },
      {
        "Type": "ResaleLegalTerm",
        "Id": "term_id_placeholder",
        "Documents": [
          {
            "Type": "StandardResellerContract",
            "Url": "https://resale-auth-legal-terms-iad-beta.s3.us-east-1.amazonaws.com/09ae57d6-c75a-3a4c-aadf-9b866bae64ab/bed55b56-7ab4-4c4c-b633-3bf4f6efcb98?isSigned=yes"
          }
        ]
      },
      {
        "Type": "BuyerValidityTerm",
        "Id": "term_id_placeholder",
        "MaximumAgreementStartDate": "2023-09-25T23:59:59.000Z"
      },
      {
        "Type": "BuyerTargetingTerm",
        "Id": "term_id_placeholder",
        "PositiveTargeting": {
          "BuyerAccounts": [
            {
              "AwsAccountId": "444455556666"
            }
          ]
        }
      }
    ],
    "Rules": [
      {
        "Type": "AvailabilityRule",
        "Id": "availability_rule_id_placeholder",
        /* If the AvailabilityEndDate and OffersMaxQuantity not present Usage will be Unlimited*/
        "Usage": "Limited",
        "AvailabilityEndDate": "2022-05-31T23:59:59Z",
        "OffersMaxQuantity": 1
      },
      {
        "Type": "PartnerTargetingRule",
        "Id": "partner_targeting_rule_id_placeholder",
        "ResellerAccountId": "777777777777",
        "ResellerLegalName": "ChannelCAPICP.Inc"
      }
    ]
  }
}

Berikut ini adalah informasi tentang bidang yang Anda lihat dalam DescribeEntity respons.