View a markdown version of this page

Menggunakan AWS Marketplace API Perjanjian - AWS Marketplace
Konsep utamaTitik akhirIzin

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.

Menggunakan AWS Marketplace API Perjanjian

AWS Marketplace adalah katalog digital yang dikuratori yang dapat digunakan pelanggan untuk menemukan, membeli, menyebarkan, dan mengelola perangkat lunak, data, dan layanan pihak ketiga untuk membangun solusi dan menjalankan bisnis mereka. Layanan AWS Marketplace Perjanjian menyediakan antarmuka API yang membantu AWS Marketplace pembeli dan penjual mengelola perjanjian mereka, termasuk daftar, pencarian, dan pemfilteran perjanjian.

Konsep utama

Tabel berikut menjelaskan konsep kunci yang digunakan dalam AWS Marketplace Agreement API.

Konsep Deskripsi
Akseptor Pihak yang menerima semua atau sebagian dari persyaratan yang diperpanjang oleh pengusul dalam suatu perjanjian. Untuk kasus penggunaan yang paling umum, akseptor adalah pembeli produk.
Perjanjian Dokumen yang mengikat dua pihak, termasuk pengusul (umumnya, seller/ISV atau mitra saluran) dan akseptor (umumnya, pembeli) dan mendefinisikan syarat dan ketentuan yang berlaku di antara mereka.
Permintaan Pembatalan Perjanjian Permintaan yang diprakarsai oleh penjual (pengusul) untuk membatalkan perjanjian aktif. Pembeli (akseptor) dapat menerima atau menolak permintaan pembatalan. Jika diterima, alur kerja pembatalan perjanjian dijalankan secara asinkron dan status perjanjian berubah menjadi dibatalkan. Jika ditolak, perjanjian tetap aktif dan penjual dapat mengajukan permintaan pembatalan baru.
Proposal Perjanjian Entitas mengacu pada himpunan terms/offer yang diusulkan oleh seller/proposer.
Permintaan Perjanjian Entitas mengacu pada sumber daya yang dibuat sebagai hasil dari tindakan pelanggan, menguraikan creation/modification parameter perjanjian, siklus hidup permintaan, dan perkiraan hasil setelah permintaan diterima.
Dimensi yang dapat ditagih Elemen yang terkait dengan bagaimana harga produk. Misalnya, instans Amazon Elastic Compute Cloud (Amazon EC2) untuk produk Amazon Machine Image (AMI), atau premium dibandingkan dengan pengguna hanya-baca untuk produk perangkat lunak sebagai layanan (SaaS).
Mitra Saluran (CP) Organizations yang diberi wewenang oleh pemilik produk (ISV) untuk menjual kembali produk mereka atas nama mereka. AWS Marketplace
Vendor Perangkat Lunak Independen (ISV) Penjual yang mencantumkan dan mengelola produk mereka sendiri di AWS Marketplace.
Niat Maksud mewakili motivasi pembeli saat membuat Perjanjian. Maksud yang didukung saat ini adalah Baru, Ubah, dan Ganti selama alur pembuatan perjanjian.
Permintaan Pembayaran Permintaan yang diprakarsai oleh penjual (pengusul) untuk pembayaran yang terkait dengan perjanjian. Pembeli (akseptor) dapat menerima atau menolak permintaan pembayaran.
Pengusul Pihak yang memperluas serangkaian persyaratan awal dalam suatu perjanjian, paling sering dengan menggunakan penawaran.
Pesanan Pembelian Organizations mewajibkan pembeli untuk menggunakan pesanan pembelian untuk membeli dari pemasok yang disetujui, melacak apa yang mereka beli, dan memastikan pengeluaran diperkirakan, dianggarkan, disetujui, dan ditugaskan ke pusat biaya yang bertanggung jawab.
Sumber daya Unit atau sumber daya yang penjual berniat untuk menjual AWS Marketplace, sering disebut sebagai produk dasar. Produk dasar tidak lengkap untuk konsumsi pembeli sampai informasi produk, atribut penyebaran, dan informasi penagihan ditambahkan. Produk menjelaskan informasi produk, atribut penyebaran perangkat lunak, dan mekanisme penagihan dari daftar yang ingin dijual oleh penjual. Produk harus dipasangkan dengan penawaran untuk menjadi unit transactable yang dapat dijual dan digunakan oleh pembeli di. AWS Marketplace
Jangka Waktu Unit dalam perjanjian yang mengatur bagaimana perjanjian ditegakkan (misalnya, penetapan harga).

Titik akhir

Anda dapat mengakses Layanan AWS Marketplace Perjanjian dengan titik akhir berikut:

Titik akhir Region Protokol IP yang Didukung
agreement-marketplace.us-east-1.api.aws AS Timur (Virginia Utara) IPv4, IPv6

Izin

API Perjanjian menggunakan otentikasi AWS Signature Version 4 (SigV4) standar. Anda harus memiliki AWS kredensi yang valid dan izin IAM yang sesuai untuk memanggil API. Lihat perinciannya di Kontrol akses untuk AWS Marketplace API Perjanjian.

Kode eror

Kode galat berikut berlaku untuk tindakan Layanan AWS Marketplace Perjanjian. Kode kesalahan tunggal dapat dikembalikan untuk beberapa kasus penggunaan. Lihat deskripsi di bawah ini untuk mengidentifikasi skenario spesifik di mana setiap kode kesalahan terjadi. Daftar ini tidak lengkap dan dapat diperbarui saat fitur baru dirilis.

ValidationException

Kode kesalahan Deskripsi
INVALID_SOURCE_AGREEMENT_IDENTIFIER Dikembalikan ketika pengenal perjanjian sumber tidak cocok dengan format yang diharapkan, atau ketika pengidentifikasi perjanjian sumber disediakan untuk maksud yang tidak memerlukannya (seperti BARU).
MISSING_SOURCE_AGREEMENT_IDENTIFIER Dikembalikan ketika pengidentifikasi perjanjian sumber tidak disediakan untuk maksud yang memerlukannya (seperti REPLACE atau AMEND).
INVALID_REQUESTED_TERM_CONFIGURATION

Dikembalikan ketika konfigurasi istilah yang diminta tidak valid. Skenario yang mungkin:

  • Konfigurasi disediakan untuk istilah yang tidak menerimanya.

  • Konfigurasi yang diperlukan tidak ada.

  • Nilai pemilih bukan milik proposal perjanjian.

  • Dimensi hanya dapat berisi satu dimensi ketika pemilihan beberapa dimensi tidak diperbolehkan.

  • Kunci dimensi tidak diakui dalam proposal perjanjian atau persyaratan yang diterima.

  • Nilai dimensi hanya bisa 1 ketika konfigurasi kuantitas tidak diaktifkan untuk dimensi.

  • Konfigurasi berisi tombol dimensi duplikat.

  • Konfigurasi tidak berbeda dari perjanjian sumber.
INVALID_AGREEMENT_PROPOSAL_IDENTIFIER Dikembalikan ketika pengidentifikasi proposal perjanjian tidak cocok dengan format yang diharapkan, atau ketika pengidentifikasi proposal perjanjian disediakan untuk maksud yang tidak memerlukannya (seperti AMEND).
MISSING_AGREEMENT_PROPOSAL_IDENTIFIER Dikembalikan ketika pengidentifikasi proposal perjanjian tidak disediakan untuk maksud yang memerlukannya (seperti BARU atau GANTI).
INVALID_FILTER_NAME Dikembalikan ketika nama filter yang disediakan bukan filter yang dikenali, atau ketika nama filter duplikat disertakan dalam permintaan.
INVALID_FILTER_VALUES Dikembalikan ketika nilai filter tidak valid, digandakan, kosong, melebihi jumlah maksimum yang diizinkan, atau ketika filter rentang tanggal menentukan nilai yang mendahului BeforeEndTime nilai. AfterEndTime
INVALID_NEXT_TOKEN Dikembalikan ketika token pagination salah bentuk, kedaluwarsa, tidak dapat didekripsi, atau ketika parameter permintaan telah berubah di antara panggilan paginasi.
DUPLICATE_CHARGES Dikembalikan ketika permintaan berisi pengidentifikasi biaya duplikat, atau ketika nilai pesanan pembelian yang berbeda disediakan untuk pengenal biaya yang sama.
UNSUPPORTED_FILTERS Dikembalikan ketika kombinasi filter yang disediakan tidak didukung. Kombinasi filter yang didukung bervariasi berdasarkan jenis pesta. Periksa kombinasi yang didukung dalam dokumentasi publik.
INVALID_PURCHASE_ORDER_REFERENCE Dikembalikan ketika referensi pesanan pembelian tidak memenuhi persyaratan format, atau ketika pesanan pembelian yang diperlukan tidak disediakan seperti yang dikonfigurasi oleh administrator akun.
INVALID_CHARGE_AMOUNT

Dikembalikan ketika jumlah tagihan tidak valid. Skenario yang mungkin:

  • Jumlah tagihan melebihi jumlah total biaya maksimum untuk jangka waktu tersebut.

  • Format jumlah tagihan tidak sesuai dengan persyaratan mata uang (misalnya, terlalu banyak tempat desimal).

  • Tidak ada jumlah sisa yang tersedia karena perjanjian telah mencapai jumlah total biaya maksimum.
UNSUPPORTED_ACTION

Dikembalikan ketika operasi yang diminta tidak didukung untuk status sumber daya saat ini. Skenario spesifik bervariasi menurut API:

  • UpdatePurchaseOrders— Tanggal tagihan di masa lalu dan perpanjangan otomatis dinonaktifkan, tanggal tagihan dalam 3 jam, biaya adalah biaya pengembalian uang, revisi biaya bukan yang terbaru, pesanan pembelian tidak semua milik perjanjian yang sama, atau perjanjian tidak aktif.

  • CreateAgreementRequest— Mengubah perjanjian bertanggal masa depan tidak didukung, jenis sumber daya dan kombinasi jenis istilah tidak mendukung maksud yang diminta, mengganti perjanjian aktif dengan perjanjian bertanggal masa depan tidak diperbolehkan, durasi perjanjian tidak dapat diubah selama amandemen, perjanjian tidak dapat diperbarui saat ini (misalnya, hak yang tertunda ada), proposal perjanjian harus mengacu pada sumber daya yang sama dengan perjanjian sumber, proposal perjanjian harus berbeda dari perjanjian sumber, atau jenis perjanjian tidak mendukung tindakan ini.

  • AcceptAgreementRequest— Jenis sumber daya dan kombinasi tipe istilah tidak mendukung tindakan ini, jenis perjanjian tidak mendukung tindakan ini, perjanjian aktif sudah ada pada sumber daya yang sama, atau perjanjian tidak dapat diperbarui saat ini.

  • CancelAgreement— Perjanjian memiliki hak yang tertunda, jenis perjanjian tidak mendukung pembatalan, perjanjian dengan UsageBasedPricingTerm tidak dapat dibatalkan saat perjanjian dengan atau masih aktif pada sumber daya yang sama, ConfigurableUpfrontPricingTerm atau PaymentScheduleTerm jenis sumber daya dan kombinasi tipe istilah tidak mendukung pembatalan.

  • GetBillingAdjustmentRequest— Perjanjian adalah jenis perjanjian non-pembelian, atau penelepon adalah akseptor perjanjian.

  • SendAgreementCancellationRequestJenis perjanjian tidak mendukung tindakan ini.

  • AcceptAgreementCancellationRequestJenis perjanjian tidak mendukung tindakan ini.

  • RejectAgreementCancellationRequestJenis perjanjian tidak mendukung tindakan ini.

  • CancelAgreementCancellationRequestJenis perjanjian tidak mendukung tindakan ini.

  • GetAgreementCancellationRequest— Perjanjian adalah jenis perjanjian non-pembelian.

ResourceNotFoundException

ResourceNotFoundExceptionTermasuk resourceType dan resourceId bidang yang mengidentifikasi sumber daya yang tidak dapat ditemukan. Tabel berikut menjelaskan skenario yang dapat menyebabkan pengecualian ini untuk setiap jenis sumber daya.

catatan

Untuk alasan keamanan, kesalahan yang sama dikembalikan apakah sumber daya tidak ada atau penelepon tidak memiliki akses ke sana. Ini mencegah pencacahan pengidentifikasi sumber daya yang valid.

Tipe sumber daya Skenario yang mungkin
AgreementProposal

  • Tidak ada proposal perjanjian yang ditemukan untuk pengenal yang diberikan.

  • Penawaran ini tidak ditargetkan ke akseptor.

  • Penawaran ini tidak tersedia di negara akseptor.
Agreement

  • Tidak ada kesepakatan yang ditemukan untuk pengenal yang diberikan.

  • Penelepon bukanlah akseptor atau pengusul perjanjian.
AgreementRequest

  • Tidak ada permintaan perjanjian yang ditemukan untuk pengenal yang diberikan.

  • Permintaan perjanjian milik penelepon lain.

  • Permintaan perjanjian telah kedaluwarsa.

  • Permintaan perjanjian telah digantikan oleh permintaan yang diterima berikutnya pada produk atau penawaran yang sama.

  • Proposal perjanjian menjadi tidak aktif antara CreateAgreementRequest dan AcceptAgreementRequest panggilan karena penawaran penerbitan ulang atau penawaran kedaluwarsa.
Charge

  • Tidak ada biaya yang ditemukan untuk pengenal yang diberikan.

  • Tagihan tidak termasuk dalam perjanjian yang ditentukan.
BillingAdjustmentRequest

  • Tidak ada permintaan penyesuaian penagihan yang ditemukan untuk pengenal yang diberikan.

  • Penelepon bukanlah akseptor atau pengusul perjanjian yang terkait dengan penyesuaian.
AgreementCancellationRequest

  • Tidak ada permintaan pembatalan perjanjian yang ditemukan untuk pengenal yang diberikan.

  • Penelepon bukanlah akseptor atau pengusul perjanjian yang terkait dengan permintaan pembatalan.
PaymentRequest

  • Tidak ada permintaan pembayaran yang ditemukan untuk pengenal yang diberikan.

  • Penelepon bukanlah akseptor atau pengusul perjanjian yang terkait dengan permintaan pembayaran.