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 menjelaskan apa yang dijual AWS Marketplace, Otorisasi Penjualan Kembali (juga dikenal sebagai peluang) menjelaskan syarat dan aturan mengenai bagaimana produk ini diizinkan untuk dijual kembali. AWS MarketplaceCPPO adalah target Otorisasi Penjualan Kembali.

Otorisasi Penjualan Kembali memiliki kumpulan syarat dan aturan yang akan 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 persyaratan.

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 memberikan izin berbagi sumber daya ke. AWS Jika kedua grup tidak melakukan prasyarat ini, tidak AWS dapat membagikan sumber daya otorisasi dari ISV ke Mitra Sal AWS Marketplace uran. Untuk informasi selengkapnya, lihat Menggunakan peran untuk Otorisasi Penjualan Kembali AWS Marketplace di Panduan Pen AWS Marketplace jual.

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 menghasilkan 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 dalamnya.

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 dalamnya. AWS Marketplace

Untuk membuat Otorisasi Penjualan Kem Draft bali dalam status, pang StartChangeSet gil operasi API dengan jenis CreateResaleAuthorization perubahan, seperti yang ditunjukkan pada contoh berikut.

Minta 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 bidang input untuk menambahkan jenis CreateResaleAuthorization perubahan:

Sintaks Respons

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

{
  "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 Katalog API menggunakan operasi DescribeChangeSet API.

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

Berikut ini menunjukkan respons dari operasi DescribeChangeSet API.

{
  "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 menelep StartChangeSet on. 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 memang DescribeChangeSet gil setelah set perubahan diproses. Untuk informasi selengkapnya tentang menggunakan 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.

Minta 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 Respons

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

{
  "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 Pen AWS Marketplace jual untuk memastikannya memenuhi AWS Marketplace pedoman. Proses validasi dapat memakan waktu mulai dari beberapa menit hingga beberapa jam.

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

Validasi Sinkron

Validasi skema khusus untuk UpdateBuyerTargetingTerms tindakan di AWS Marketplace Catalog API. Validasi ini dilakukan saat Anda menelep StartChangeSet on. 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 memang DescribeChangeSet gil setelah set perubahan diproses. Untuk informasi selengkapnya tentang menggunakan 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, StartChangeSet panggil operasi API dengan jenis UpdateAvailability perubahan, seperti yang ditunjukkan pada contoh berikut.

Minta 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 Respons

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

{
  "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 Pen AWS Marketplace jual untuk memastikannya memenuhi AWS Marketplace pedoman. Proses validasi dapat memakan waktu mulai dari beberapa menit hingga beberapa jam.

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

Validasi Sinkron

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

Kesalahan Asinkron

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

Perbarui validitas perjanjian bertanggal di masa depan

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

Kumpulan perubahan ini tidak wajib untuk merilis Otorisasi Penjualan Kembali.

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

Minta 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 bidang input untuk menambahkan jenis UpdateBuyerValidityTerms perubahan:

Sintaks Respons

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

{
  "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 Pen AWS Marketplace jual untuk memastikannya memenuhi AWS Marketplace pedoman. Proses validasi dapat memakan waktu mulai dari beberapa menit hingga beberapa jam.

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

Validasi Sinkron

Validasi skema khusus untuk UpdateBuyerValidityTerms tindakan di AWS Marketplace Catalog API. Validasi dilakukan saat Anda menelep StartChangeSet on. 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 memang DescribeChangeSet gil setelah set perubahan diproses. Untuk informasi selengkapnya tentang menggunakan 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 dalam perjanjian pembeli akhir dan LegalTerm termasuk Kontrak Pengecer 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.

Minta 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 Respons

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

{
  "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 memakan waktu mulai dari beberapa menit hingga beberapa jam.

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

Validasi Sinkron

Validasi skema khusus untuk UpdateLegalTerms tindakan di AWS Marketplace Catalog API. Validasi dilakukan saat Anda menelep StartChangeSet on. 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 menggunakan DescribeChangeSet untuk mendapatkan status permintaan perubahan, lihatBekerja dengan set perubahan.

Perbarui harga

Anda dapat menggunakan API Katalog untuk mengganti persyaratan harga yang ada sepenuhnya di 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 Anda, panggil operasi StartChangeSet API dengan jenis UpdatePricingTerms perubahan, seperti yang ditunjukkan pada contoh berikut.

Minta 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 Respons

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

{
  "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 memakan waktu mulai dari beberapa menit hingga beberapa jam.

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

Validasi Sinkron

Validasi skema berikut khusus untuk UpdatePricingTerms tindakan di AWS Marketplace Catalog API. Validasi dilakukan saat Anda menelep StartChangeSet on. 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 memang DescribeChangeSet gil setelah set perubahan diproses. Untuk informasi selengkapnya tentang menggunakan 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 Anda, panggil operasi StartChangeSet API dengan jenis UpdatePaymentScheduleTerms perubahan, seperti yang ditunjukkan pada contoh berikut.

Minta 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 Respons

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

{
  "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 memakan waktu mulai dari beberapa menit hingga beberapa jam.

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

Validasi Sinkron

Validasi skema khusus untuk UpdatePaymentScheduleTerms tindakan di AWS Marketplace Catalog API. Validasi dilakukan saat Anda menelep StartChangeSet on. 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 kumpulan perubahan diproses. atau informasi lebih lanjut tentang menggunakan DescribeChangeSet untuk mendapatkan status permintaan perubahan, lihat. Bekerja dengan set perubahan

Perbarui ketentuan pembayaran bersih

Anda dapat menggunakan API Katalog untuk mengatur ketentuan pembayaran bersih dari Otorisasi Penjualan Kembali Anda di AWS Marketplace. Jangka waktu pembayaran bersih adalah istilah di mana Anda menentukan jumlah hari setelah penerbitan faktur yang jatuh tempo pembayaran.

Jangka waktu pembayaran bersih yang Anda tetapkan pada Otorisasi Penjualan Kembali adalah jangka waktu maksimum yang dapat ditawarkan mitra saluran kepada pembeli dalam penawaran pribadi mitra saluran (CPPO). Mitra saluran dapat menawarkan periode yang sama atau yang lebih pendek, tetapi tidak yang lebih lama. Untuk informasi selengkapnya, lihat Buat CPPO.

Untuk mengatur jangka waktu pembayaran bersih Otorisasi Penjualan Kembali Anda, panggil operasi StartChangeSet API dengan jenis UpdateNetPaymentTerms perubahan, seperti yang ditunjukkan pada contoh berikut.

Minta Sintaks

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

{
  "Catalog": "AWSMarketplace",
  "ChangeSet": [
    {
      "ChangeType": "UpdateNetPaymentTerms",
      "Entity": {
        "Type": "ResaleAuthorization@1.0",
        "Identifier": "resaleauthz-123456789"
      },
      "DetailsDocument": {
        "Terms": [
          {
            "Type": "ResaleNetPaymentTerm",
            "PaymentDuePeriod": "P60D"
          }
        ]
      }
    }
  ]
}

Berikan informasi untuk bidang untuk menambahkan jenis UpdateNetPaymentTerms perubahan:

Sintaks Respons

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

{
  "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 memakan waktu beberapa menit.

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

Validasi Sinkron

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

Kesalahan Asinkron

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

Perbarui rincian Otorisasi Penjualan Kembali

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

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

Minta 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 Respons

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

{
  "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 memakan waktu mulai dari beberapa menit hingga beberapa jam.

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

Validasi Sinkron

Validasi skema berikut khusus untuk UpdateInformation tindakan di AWS Marketplace Catalog API. Validasi ini dilakukan saat Anda memanggilStartChangeSet, 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 kumpulan perubahan diproses. atau informasi lebih lanjut tentang menggunakan 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 Anda, StartChangeSet panggil operasi API dengan jenis RestrictResaleAuthorization perubahan, seperti yang ditunjukkan pada contoh berikut.

Minta 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 Respons

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

{
  "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 memakan waktu mulai dari beberapa menit hingga beberapa jam.

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

Validasi Sinkron

Validasi skema khusus untuk RestrictResaleAuthorization tindakan di AWS Marketplace Catalog API. Validasi ini dilakukan saat Anda menelep StartChangeSet on. 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 kumpulan perubahan diproses. atau informasi lebih lanjut tentang menggunakan 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 melepaskan Otorisasi Penjualan Kembali Anda, StartChangeSet panggil operasi API dengan jenis ReleaseResaleAuthorization perubahan, seperti yang ditunjukkan pada contoh berikut.

Minta 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 Respons

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

{
  "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 memakan waktu mulai dari beberapa menit hingga beberapa jam.

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

Validasi Sinkron

Validasi skema khusus untuk ReleaseResaleAuthorization tindakan di AWS Marketplace Catalog API. Validasi dilakukan saat Anda menelep StartChangeSet on. 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 memang DescribeChangeSet gil setelah set perubahan diproses. Untuk detail selengkapnya tentang menggunakan DescribeChangeSet untuk mendapatkan status permintaan perubahan, lihatBekerja dengan set perubahan.

Jelaskan Otorisasi Penjualan Kembali yang ada

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

Minta Sintaks

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

Berikan informasi untuk bidang untuk menambahkan jenis DescribeEntity perubahan:

Sintaks Respons

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": "ResaleNetPaymentTerm",
        "Id": "term_id_placeholder",
        "PaymentDuePeriod": "P60D"
      },
      {
        "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.