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 mengotomatisasi tugas untuk bekerja dengan penawaran pribadi mitra saluran (CPPO).

Saat Anda membuat atau memperbarui CPPO, rancangan penawaran akan berisi persyaratan dan aturan dari Otorisasi Penjualan Kembali dan tidak akan terlihat oleh pembeli. Dimungkinkan, tetapi tidak diharuskan, untuk melibatkan banyak persona di 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 persyaratan hukum. Anda dapat memberikan izin persona untuk memperbarui 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 dengannya. 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 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 CPPO

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

Jika permintaan Anda berhasil diproses, AWS Marketplace Catalog API buat penawaran di Draft negara bagian untuk Anda dengan ketentuan Otorisasi Penjualan Kembali. Anda dapat menggunakan DescribeEntity untuk melihat persyaratan yang diterapkan pada draf penawaran dari Resale Authorization. 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.

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

Tanggapan terhadap 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 istilah yang dibuat dari ResaleAuthorization dalam 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 menelepon. StartChangeSet 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 memanggil DescribeChangeSet setelah set perubahan diproses. Untuk informasi selengkapnya tentang penggunaan DescribeChangeSet untuk mendapatkan status permintaan perubahan, lihatBekerja dengan set perubahan.

Buat 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 yang menjadi pengusul Anda untuk membuat penawaran pengganti pribadi mitra saluran dalam Draft status di API Katalog StartChangeSet dengan menelepon dengan jenis CreateReplacementOfferUsingResaleAuthorization perubahan, seperti yang ditunjukkan pada contoh berikut. Penawaran pengganti dapat digunakan untuk menggantikan perjanjian dari penawaran sebelumnya sebelum berakhir.

CreateReplacementOfferUsingResaleAuthorizationakan membuat rancangan 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.

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

Validasi sinkron

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

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

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

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

Permintaan 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 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 berikut khusus untuk UpdateMarkup 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 UpdateMarkup 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 konfigurasi penargetan

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

Setiap opsi penargetan yang ada yang tidak termasuk dalam permintaan terbaru akan dihapus dari penawaran. Produsen dapat menyebutkan pembeli yang ditargetkan secara spesifik diResaleAuthorization. Mitra saluran dapat memberikan penawaran pribadi kepada sebagian pembeli yang menggunakan PositiveTargeting jenis UpdateTargeting perubahan.

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

Permintaan 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 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 UpdateTargeting 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 UpdateTargeting 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 menggabungkan persyaratan hukum Otorisasi Penjualan Kembali dan mengganti persyaratan 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 persyaratan hukum gabungan dengan meneleponDescribeEntity.

Untuk memperbarui ketentuan hukum penawaran Anda, hubungi 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": "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:

Set perubahan dibuat untuk permintaan Anda. Respons terhadap permintaan ini memberi Anda ID untuk set perubahan.

Sintaks Respon

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

Validasi sinkron

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

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

Anda dapat memilih untuk menetapkan tanggal tertentu di masa depan untuk membatasi penemuan penawaran Anda atau di masa lalu untuk kedaluwarsa penawaran Anda.

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

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

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.

Permintaan 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 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 UpdateValidityTerms 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 UpdateValidityTerms 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 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 hanya dapat menggunakan jenis perubahan ini untuk meneruskanFixedUpFrontPricingTerm.

Untuk memperbarui ketentuan harga penawaran Anda, hubungi 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": "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 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 ini 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 detail jadwal pembayaran

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

Jika pabrikan telah memberikan jadwal pembayaran dalam Otorisasi Penjualan Kembali, Mitra Saluran dapat:

Untuk memperbarui detail terkait pembayaran untuk penawaran Anda, hubungi 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": "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 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 UpdatePaymentScheduleTerms 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 UpdatePaymentScheduleTerms 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.

Publikasikan CPPO

Anda dapat menggunakan API Katalog untuk menggabungkan informasi yang dikumpulkan dari semua jenis perubahan pembaruan, lalu memublikasikan penawaran tersebut. AWS Marketplace

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

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

Permintaan 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 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 ReleaseOffer 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 ReleaseOffer 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.

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.

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": "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 kolom masukan untuk DescribeEntity respons: