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 penawaran pribadi mitra saluran menggunakan AWS Marketplace API

Anda dapat menggunakan AWS Marketplace Catalog API untuk mengotomatiskan tugas untuk bekerja dengan penawaran pribadi mitra saluran (CPPO).

Saat Anda membuat atau memperbarui CPPO, draf penawaran akan berisi syarat dan aturan dari Otorisasi Penjualan Kembali dan tidak akan terlihat oleh pembeli. Dimungkinkan, tetapi tidak diperlukan, untuk melibatkan beberapa persona dalam organisasi Anda untuk membuat penawaran pribadi.

Misalnya, satu persona dapat bertanggung jawab untuk memperbarui harga sementara persona kedua dapat bertanggung jawab untuk memperbarui jadwal pembayaran. Kemudian, persona ketiga dapat bertanggung jawab untuk memperbarui ketentuan hukum. Anda dapat memberikan izin kepada persona untuk memperbarui bagian-bagian tertentu dari penawaran. Namun, Anda hanya dapat memberikan izin baca untuk Otorisasi Penjualan Kembali.

Sebagai prasyarat untuk memanggil jenis perubahan, Anda harus telah menerima satu atau lebih Otorisasi Penjualan Kembali dan terbiasa bekerja dengan. AWS Marketplace Catalog API

Untuk informasi selengkapnya, lihat Penawaran pribadi mitra saluran di Panduan AWS Marketplace Penjual.

Topik berikut menjelaskan cara menggunakan API Katalog untuk membuat dan memperbarui CPPO:

Prasyarat CPPO

Service-linked role for ResaleAuthorization (SLR) setup adalah prasyarat wajib untuk menggunakan otorisasi penjualan kembali untuk membuat CPPO. 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 CPPO

Anda menggunakan Otorisasi Penjualan Kembali yang ditargetkan kepada Anda untuk membuat penawaran pribadi mitra saluran (CPPO) di Draft negara bagian. AWS Marketplace

Jika permintaan Anda berhasil diproses, AWS Marketplace Catalog API menghasilkan penawaran di Draft negara bagian untuk Anda dengan ketentuan Otorisasi Penjualan Kembali. Anda dapat menggunakan DescribeEntity untuk melihat ketentuan yang diterapkan pada draf penawaran dari Otorisasi Penjualan Kembali. Ini adalah penawaran yang tidak lengkap dan tidak terlihat oleh pembeli di AWS Marketplace. Anda kemudian menggunakan jenis perubahan yang terkait dengan CPPO untuk menyelesaikan penawaran.

Setelah penawaran selesai, Anda menggunakan jenis ReleaseOffer perubahan untuk menyelesaikan proses pembuatan penawaran dan melepaskan penawaran. Ini akan memvalidasi seluruh penawaran dan membuat penawaran Anda terlihat oleh pembeli AWS Marketplace.

Untuk membuat penawaran pribadi mitra saluran, panggil operasi StartChangeSet API dengan jenis CreateOfferUsingResaleAuthorization perubahan, seperti yang ditunjukkan pada contoh berikut.

Minta Sintaks

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

{
  "Catalog": "AWSMarketplace",
  "ChangeSet": [
    {
      "ChangeType": "CreateOfferUsingResaleAuthorization",
      "Entity": {
        "Type": "Offer@1.0"
      },
      "DetailsDocument": {
        "ResaleAuthorizationId": "resaleauthz-123456789",
        "Name": "Test Offer",
        "OfferSetId": "offerset-b3f9EXAMPLE27"
      }
    }
  ]
}

Berikan informasi untuk bidang untuk menambahkan jenis CreateOfferUsingResaleAuthorization 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.

Tanggapan atas permintaan ini memberi Anda status permintaan. Jika statusnyaSUCCEEDED, maka yang baru OfferId dihasilkan.

{
  "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": "CreateOfferUsingResaleAuthorization",
      "Entity": {
        "Type": "Offer@1.0",
        "Identifier": "offer-123456789"
      },
      "DetailsDocument": {
        "ResaleAuthorizationId": "resaleauthz-123456789",
        "Name": "Test Offer"
      },
      "ErrorDetailList": []
    }
  ]
}

Anda dapat menggunakan GET DescribeEntity permintaan untuk menjelaskan draf aturan penawaran dan ketentuan yang dibuat dari ResaleAuthorization AWS Marketplace Catalog API Referensi. Untuk informasi selengkapnya, lihat DescribeChangeSet.

Syarat dan aturan dari ResaleAuthorization

{
  "EntityType": "Offer@1.0",
  "EntityIdentifier": "offer-a5EXAMPLEwzpu@1",
  "EntityArn": "arn:aws:aws-marketplace:us-east-1:444555666777:AWSMarketplace/Offer/offer-a5oEXAMPLEzpu",
  "LastModifiedDate": "2021-03-10T21:57:16Z",
  "DetailsDocument": {
    "Id": "offer-3rb23tu92rn",
    "Name": "Test Offer",
    "Description": "Worldwide private offer for Test Product",
    "ProductId": "prod-0bc848d78b51",
    "ResaleAuthorizationId": "resaleauthz-123456789",
    "Terms": [
      {
        "Type": "LegalTerm",
        "Documents": [
          {
            "Type": "CustomEula",
            "Url": "https://s3.amazonaws.com/EULA/custom-eula-1234.txt"
          }
        ]
      },
      {
        "Type": "ConfigurableUpfrontPricingTerm",
        "CurrencyCode": "USD",
        "RateCards": [
          {
            "Selector": {
              "Type": "Duration",
              "Value": "P12M"
            },
            "RateCard": [
              {
                "DimensionKey": "m3.large",
                "Price": "300.00"
              },
              {
                "DimensionKey": "m4.xlarge",
                "Price": "400.00"
              }
            ],
            "Constraints": {
              "MultipleDimensionSelection": "Allowed",
              "QuantityConfiguration": "Allowed"
            }
          }
        ]
      },
      {
        "Type": "UsageBasedPricingTerm",
        "CurrencyCode": "USD",
        "RateCards": [
          {
            "RateCard": [
              {
                "DimensionKey": "m3.large",
                "Price": "0.10"
              },
              {
                "DimensionKey": "m4.xlarge",
                "Price": "0.20"
              }
            ]
          }
        ]
      },
      {
        "Type": "PaymentScheduleTerm",
        "CurrencyCode": "USD",
        "Schedule": [
          {
            "ChargeDate": "2020-12-01T00:00:00.000Z",
            "ChargeAmount": "1000.00"
          },
          {
            "ChargeDate": "2021-06-15T00:00:00.000Z",
            "ChargeAmount": "1250.00"
          }
        ]
      }
    ],
    "Rules": [
      {
        "Type": "TargetingRule",
        "PositiveTargeting": {
          "BuyerAccounts": [
            "111222333444"
          ]
        }
      }
    ]
  }
}

Validasi Sinkron

Validasi skema berikut khusus untuk CreateOfferUsingResaleAuthorization 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 CreateOfferUsingResaleAuthorization 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.

Membuat penawaran pengganti pribadi mitra saluran

Anda dapat menggunakan API Katalog untuk membuat penawaran pengganti pribadi mitra saluran di AWS Marketplace.

Anda menggunakan yang ResaleAuthorization ditargetkan untuk Anda dan Perjanjian di mana Anda menjadi pengusulkan untuk membuat penawaran pengganti pribadi mitra saluran dalam Draft status di API Katalog dengan memanggil StartChangeSet dengan jenis CreateReplacementOfferUsingResaleAuthorization perubahan, seperti yang ditunjukkan pada contoh berikut. Penawaran pengganti dapat digunakan untuk menggantikan perjanjian dari penawaran sebelumnya sebelum berakhir.

CreateReplacementOfferUsingResaleAuthorizationakan membuat draf penawaran dengan akseptor perjanjian dalam penargetan. Penargetan ini tidak dapat diubah setelahnya. Draf penawaran juga akan berisi id penawaran sumber perjanjian.

Untuk membuat penawaran penggantian pribadi mitra saluran, panggil operasi StartChangeSet API dengan jenis CreateReplacementOfferUsingResaleAuthorization perubahan, seperti yang ditunjukkan pada contoh berikut.

Minta Sintaks

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

{
  "Catalog": "AWSMarketplace",
  "ChangeSet": [
    {
      "ChangeType": "CreateReplacementOfferUsingResaleAuthorization",
      "Entity": {
        "Type": "Offer@1.0"
      },
      "DetailsDocument": {
        "ResaleAuthorizationId": "2bd2c761-3b7f-3771-a9a7-e8ad36517698",
        "Name": "CAPI-saas-abo-contract-fps",
        "AgreementId": "agmt-f2ooEXAMLEamtm7mjj0j59gu"
      }
    }
  ]
}

Berikan informasi untuk bidang untuk menambahkan jenis CreateReplacementOfferUsingResaleAuthorization 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.

Validasi Sinkron

Validasi skema berikut khusus untuk CreateReplacementOfferUsingResaleAuthorization 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 CreateReplacementOfferUsingResaleAuthorization 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 markup

Anda dapat menggunakan API Katalog untuk memperbarui ketentuan harga dengan nilai persentase dalam penawaran Anda di AWS Marketplace.

Ini akan menerapkan markup persentase yang diberikan pada semua persyaratan harga dan ketentuan pembayaran (untuk jadwal pembayaran di masa mendatang) yang ditentukan oleh produsen di ResaleAuthorization. Markup yang ada akan diganti. Anda dapat melihat harga dan ketentuan pembayaran yang diperbarui menggunakanDescribeEntity.

Untuk memperbarui markup, panggil operasi StartChangeSet API dengan tipe UpdateMarkup perubahan, seperti yang ditunjukkan pada contoh berikut.

Minta Sintaks

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

{
  "Catalog": "AWSMarketplace",
  "ChangeSet": [
    {
      "ChangeType": "UpdateMarkup",
      "Entity": {
        "Type": "Offer@1.0",
        "Identifier": "offer-123456789"
      },
      "DetailsDocument": {
        "Percentage": "5.0"
      }
    }
  ]
}

Berikan informasi untuk bidang untuk menambahkan jenis UpdateMarkup 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 berikut khusus untuk UpdateMarkup 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 UpdateMarkup 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 konfigurasi penargetan

Anda dapat menggunakan API Katalog untuk mengganti konfigurasi penargetan yang ada sepenuhnya di AWS Marketplace.

Opsi penargetan yang ada yang tidak termasuk dalam permintaan terbaru akan dihapus dari penawaran. Produsen dapat menyebutkan pembeli yang ditargetkan tertentu diResaleAuthorization. Mitra saluran dapat memberikan penawaran pribadi kepada subset pembeli yang menggunakan PositiveTargeting jenis UpdateTargeting perubahan.

Untuk memperbarui konfigurasi penargetan penawaran Anda, StartChangeSet panggil operasi API dengan jenis UpdateTargeting perubahan, seperti yang ditunjukkan pada contoh berikut.

Minta Sintaks

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

{
  "Catalog": "AWSMarketplace",
  "ChangeSet": [
    {
      "ChangeType": "UpdateTargeting",
      "Entity": {
        "Type": "Offer@1.0",
        "Identifier": "offer-123456789"
      },
      "DetailsDocument": {
        "PositiveTargeting": {
          "CountryCodes": [
            "US",
            "CA"
          ],
          "BuyerAccounts": [
            "111222333444"
          ]
        },
        "NegativeTargeting": {
          "CountryCodes": [
            "XX"
          ]
        }
      }
    }
  ]
}

Berikan informasi untuk bidang untuk menambahkan jenis UpdateTargeting 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 UpdateTargeting 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 UpdateTargeting 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 menggabungkan ketentuan hukum Otorisasi Penjualan Kembali dan mengganti ketentuan hukum yang ada sepenuhnya di AWS Marketplace.

Perubahan ini tidak mempengaruhi perjanjian yang ada. Ketentuan hukum yang tidak termasuk dalam permintaan terbaru akan dihapus dari penawaran. Anda dapat melihat ketentuan hukum gabungan dengan meneleponDescribeEntity.

Untuk memperbarui ketentuan hukum penawaran Anda, 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": "Offer@1.0",
        "Identifier": "offer-123456789"
      },
      "DetailsDocument": {
        "Terms": [
          {
            "Type": "LegalTerm",
            "Documents": [
              {
                "Type": "CustomEula",
                "Url": "https://s3.amazonaws.com/EULA/custom-eula-1234.txt"
              }
            ]
          }
        ]
      }
    }
  ]
}

Berikan informasi untuk bidang untuk menambahkan jenis UpdateLegalTerms perubahan:

Kumpulan perubahan dibuat untuk permintaan Anda. Tanggapan terhadap permintaan ini memberi Anda ID untuk set perubahan.

Sintaks Respons

{
"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 di Katalog API dengan DescribeChangeSet tindakan.

Validasi Sinkron

Validasi skema berikut khusus untuk UpdateLegalTerms 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 UpdateLegalTerms 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 kemampuan ditemukan CPPO

Anda dapat menggunakan API Katalog untuk mengelola keterjangkauan penawaran Anda di AWS Marketplace. Jenis perubahan ini tidak memengaruhi perjanjian yang ada.

Anda dapat memilih untuk menetapkan tanggal tertentu di masa mendatang untuk membatasi ketersediaan penawaran Anda atau di masa lalu untuk mengakhiri penawaran Anda.

Untuk mengelola keterjangkauan penawaran Anda, panggil operasi StartChangeSet 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": "Offer@1.0",
        "Identifier": "offer-123456789"
      },
      "DetailsDocument": {
        "AvailabilityEndDate": "2024-05-31"
      }
    }
  ]
}

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

Tentukan tanggal kedaluwarsa perjanjian

Anda dapat menggunakan API Katalog untuk menentukan tanggal kedaluwarsa perjanjian yang dibuat menggunakan penawaran ini di AWS Marketplace.

Perubahan ini tidak mempengaruhi perjanjian yang ada. Pabrikan dapat menyebutkan tanggal mulai perjanjian maksimum dalam Otorisasi Penjualan Kembali. Namun, mitra saluran tidak dapat memberikan tanggal mulai perjanjian lebih lambat dari tanggal tersebut.

Untuk menentukan tanggal kedaluwarsa perjanjian, panggil operasi StartChangeSet API dengan jenis UpdateValidityTerms perubahan, seperti yang ditunjukkan pada contoh berikut.

Minta Sintaks

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

{
  "Catalog": "AWSMarketplace",
  "ChangeSet": [
    {
      "ChangeType": "UpdateValidityTerms",
      "Entity": {
        "Type": "Offer@1.0",
        "Identifier": "offer-123456789"
      },
      "DetailsDocument": {
        "Terms": [
          {
            "Type": "ValidityTerm",
            "AgreementDuration": "P12M",
            "AgreementStartDate": "2021-08-01",
            "AgreementEndDate": "2022-08-01"
          }
        ]
      }
    }
  ]
}

Berikan informasi untuk bidang untuk menambahkan jenis UpdateValidityTerms 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 UpdateValidityTerms 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 UpdateValidityTerms 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 harga

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

Ketentuan harga yang tidak termasuk dalam permintaan terbaru akan dihapus dari penawaran. Mitra saluran dapat menggunakan jenis perubahan ini hanya untuk lulusFixedUpFrontPricingTerm.

Untuk memperbarui ketentuan harga untuk penawaran 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": "Offer@1.0",
        "Identifier": "offer-123456789"
      },
      "Details": {
        "PricingModel": "Contract",
        "Terms": [
          {
            "Type": "FixedUpfrontPricingTerm",
            "CurrencyCode": "USD",
            "Price": "200.00",
            "Duration": "P465D",
            "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 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 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 rincian jadwal pembayaran

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

Jika produsen telah memberikan jadwal pembayaran di Otorisasi Penjualan Kembali, Mitra Saluran dapat:

Untuk memperbarui detail terkait pembayaran untuk penawaran 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": "Offer@1.0",
        "Identifier": "offer-123456789"
      },
      "DetailsDocument": {
        "Terms": [
          {
            "Type": "PaymentScheduleTerm",
            "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 berikut khusus untuk UpdatePaymentScheduleTerms 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 UpdatePaymentScheduleTerms 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 ketentuan pembayaran bersih

Jika Otorisasi Penjualan Kembali yang Anda gunakan untuk membuat penawaran pribadi mitra saluran (CPPO) berisi jangka waktu pembayaran bersih, jangka waktu tersebut adalah periode maksimum yang dapat Anda tawarkan kepada pembeli. Istilah dari Otorisasi Penjualan Kembali diterapkan ke CPPO Anda secara otomatis saat Anda membuatnya.

Untuk menawarkan pembeli Anda periode pembayaran yang lebih pendek daripada yang diotorisasi penjual, panggil operasi StartChangeSet API dengan jenis UpdateNetPaymentTerms perubahan pada penawaran Anda, seperti yang ditunjukkan pada contoh berikut. Jika Anda ingin menggunakan periode yang sama dengan yang diotorisasi penjual, Anda tidak perlu meneleponUpdateNetPaymentTerms.

Jika Otorisasi Penjualan Kembali tidak berisi jangka waktu pembayaran bersih, Anda tidak dapat menambahkannya ke CPPO, dan ketentuan pembayaran pembeli Anda berlaku. AWS Anda juga tidak dapat menghapus jangka waktu pembayaran bersih dari CPPO ketika Otorisasi Penjualan Kembali berisi satu.

Minta Sintaks

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

{
  "Catalog": "AWSMarketplace",
  "ChangeSet": [
    {
      "ChangeType": "UpdateNetPaymentTerms",
      "Entity": {
        "Type": "Offer@1.0",
        "Identifier": "offer-123456789"
      },
      "DetailsDocument": {
        "Terms": [
          {
            "Type": "NetPaymentTerm",
            "PaymentDuePeriod": "P30D"
          }
        ]
      }
    }
  ]
}

Berikan informasi untuk bidang untuk menambahkan jenis UpdateNetPaymentTerms perubahan:

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 ini khusus untuk UpdateNetPaymentTerms tindakan pada CPPO 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.

Publikasikan CPPO

Anda dapat menggunakan API Katalog untuk menggabungkan informasi yang dikumpulkan dari semua jenis perubahan pembaruan, dan kemudian mempublikasikan penawaran di AWS Marketplace.

Penawaran tetap dalam Draft keadaan, sampai ReleaseOffer dipanggil. Setelah penawaran dirilis, itu dapat ditemukan di AWS Marketplace.

Untuk mempublikasikan penawaran Anda, panggil operasi StartChangeSet API dengan jenis ReleaseOffer perubahan seperti yang ditunjukkan pada contoh berikut.

Minta Sintaks

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

{
  "Catalog": "AWSMarketplace",
  "ChangeSet": [
    {
      "ChangeType": "ReleaseOffer",
      "Entity": {
        "Type": "Offer@1.0",
        "Identifier": "offer-123456789"
      },
      "DetailsDocument": {}
    }
  ]
}

Berikan informasi untuk bidang untuk menambahkan jenis ReleaseOffer 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 ReleaseOffer 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 ReleaseOffer 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.

Tentukan CPPO yang ada

Anda dapat menggunakan API Katalog untuk menentukan detail CPPO di AWS Marketplace.

Untuk menentukan CPPO yang ada, panggil operasi DescribeEntity API dengan tipe Offer@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": "Offer@1.0",
  "EntityIdentifier": "offer-a5oEXAMPLEzpu@1",
  "EntityArn": "arn:aws:aws-marketplace:us-east-1:446235747164:AWSMarketplace/Offer/offer-a5oEXAMPLEzpu",
  "LastModifiedDate": "2021-03-10T21:57:16Z",
  "Details": {
    "Id": "offer-3rEXAMPLErn",
    "State": "Released",
    "Name": "Test Offer",
    "Description": "Worldwide private offer for Test Product",
    "PreExistingAgreement": {
      "AcquisitionChannel": "External",
      "PricingModel": "Contract"
    },
    "ProductId": "prod-0bEXAMPLEb51",
    "ResaleAuthorizationId": "resaleauthz-123456789",
    "MarkupPercentage": "5.0",
    "Terms": [
      {
        "Type": "LegalTerm",
        "Documents": [
          {
            "Type": "CustomEula",
            "Url": "https://s3.amazonaws.com/EULA/custom-eula-1234.txt"
          }
        ]
      },
      {
        "Type": "ConfigurableUpfrontPricingTerm",
        "CurrencyCode": "USD",
        "RateCards": [
          {
            "Selector": {
              "Type": "Duration",
              "Value": "P12M"
            },
            "RateCard": [
              {
                "DimensionKey": "m3.large",
                "Price": "300.00"
              },
              {
                "DimensionKey": "m4.xlarge",
                "Price": "400.00"
              }
            ],
            "Constraints": {
              "MultipleDimensionSelection": "Allowed",
              "QuantityConfiguration": "Allowed"
            }
          }
        ]
      },
      {
        "Type": "UsageBasedPricingTerm",
        "CurrencyCode": "USD",
        "RateCards": [
          {
            "RateCard": [
              {
                "DimensionKey": "m3.large",
                "Price": "0.10"
              },
              {
                "DimensionKey": "m4.xlarge",
                "Price": "0.20"
              }
            ]
          }
        ]
      },
      {
        "Type": "PaymentScheduleTerm",
        "CurrencyCode": "USD",
        "Schedule": [
          {
            "ChargeDate": "2020-12-01T00:00:00Z",
            "ChargeAmount": "1000.00"
          },
          {
            "ChargeDate": "2021-06-15T00:00:00Z",
            "ChargeAmount": "1250.00"
          }
        ]
      }
    ],
    "Rules": [
      {
        "Type": "TargetingRule",
        "PositiveTargeting": {
          "CountryCodes": [
            "US",
            "CA"
          ],
          "BuyerAccounts": [
            "118033953248"
          ]
        },
        "NegativeTargeting": {
          "CountryCodes": [
            "XX"
          ]
        }
      },
      {
        "Type": "AvailabilityRule",
        "AvailabilityEndDate": "2050-08-30T01:56:03Z"
      }
    ]
  }
}

Berikan informasi untuk bidang input untuk DescribeEntity respons: