Referensi Pusat Partner AWS API direstrukturisasi. Untuk informasi selengkapnya tentang operasi API yang didukung, lihat Refer Pusat Partner AWS ensi API.
Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
Bekerja dengan Alokasi Manfaat
Alokasi Manfaat mewakili manfaat yang telah diberikan kepada mitra. Ketika aplikasi manfaat disetujui, buat satu AWS atau lebih alokasi manfaat yang memberi mitra kredit aktual, pendanaan, akses, atau pemenuhan manfaat lainnya.
Memahami Alokasi Manfaat
Alokasi manfaat dapat mewakili berbagai jenis pemenuhan:
-
Pencairan Keuangan (TUNAI) - Pembayaran keuangan langsung ke mitra dengan pelacakan pencairan
-
AWS Kredit (KREDIT) - Kode kredit yang berlaku untuk AWS akun dengan pelacakan penggunaan
-
Alokasi Konsumsi - jumlah Pre-approved pendanaan atau dompet dengan pelacakan pemanfaatan
-
Access Grants (ACCESS) - Akses ke sistem, alat, atau sumber daya
-
Pengakuan (PENGAKUAN) - Lencana digital, sertifikasi, atau penunjukan status
-
Sumber Daya (RESOURCE) - Dukungan teknis, layanan konsultasi, atau ProServe keterlibatan
Setiap alokasi manfaat memiliki siklus hidup yang dilacak melalui bidang Status:
-
AKTIF - Alokasi tersedia untuk digunakan
-
TIDAK AKTIF - Alokasi sementara tidak tersedia
-
TER PENUHI - Alokasi telah sepenuhnya digunakan atau dikirimkan
Alokasi manfaat juga mencakup informasi temporal yang menentukan kapan mereka menjadi efektif (StartsAt) dan kapan kedaluwarsa (ExpiresAt), memungkinkan mitra untuk memahami kerangka waktu untuk memanfaatkan manfaat.
Daftar Alokasi Manfaat
Mitra dapat melihat semua alokasi manfaat mereka menggunakan tindakan ListBenefitAllocations API. Ini mengembalikan daftar ringkasan alokasi yang dipaginasi dengan kemampuan pemfilteran komprehensif.
Mitra dapat memfilter alokasi dengan:
-
Benefit Identifier - Lihat alokasi untuk manfaat tertentu
-
Benefit Application Identifier - Melihat alokasi yang dihasilkan dari aplikasi tertentu
-
Jenis Pemenuhan - Filter berdasarkan jenis alokasi (
CREDITSCASH,ACCESS,, dll.) -
Status - Filter berdasarkan status alokasi (
ACTIVE,INACTIVE,FULFILLED)
Tanggapan daftar mencakup ringkasan alokasi yang berisi:
-
ID Alokasi, ARN, dan nama
-
ID manfaat terkait dan ID aplikasi manfaat (jika ada)
-
Jenis pemenuhan
-
Status saat ini
-
Stempel waktu pembuatan
-
Tanggal mulai
Tampilan daftar ini memungkinkan mitra untuk membuat dasbor pelacakan alokasi dan mengidentifikasi:
-
Alokasi aktif tersedia untuk penggunaan segera
-
Alokasi mendekati kedaluwarsa
-
Alokasi terpenuhi untuk pelacakan historis
-
Total nilai alokasi menurut program atau jenis pemenuhan
Melihat Informasi Alokasi Terperinci
Mitra dapat mengambil detail alokasi lengkap menggunakan tindakan GetBenefitAllocation API. Ini memberikan informasi komprehensif tentang alokasi termasuk rincian khusus pemenuhan yang bervariasi berdasarkan jenis alokasi.
Informasi Alokasi Inti:
-
Pengidentifikasi unik (ID) dan Nama Sumber Daya Amazon (ARN)
-
Nama dan status alokasi
-
Alasan status (penjelasan status saat ini)
-
ID manfaat terkait dan ID aplikasi manfaat
-
Jenis pemenuhan
-
Stempel waktu pembuatan, pembaruan, mulai, dan kedaluwarsa
Rincian Pemenuhan (Type-Specific):
Bid FulfillmentDetail ang berisi struktur informasi yang berbeda berdasarkan jenis pemenuhan:
Rincian Pencairan Tunai (Jenis TUNAI)
Untuk pembayaran tunai langsung, rincian pemenuhan meliputi:
-
Jumlah yang dicairkan - Jumlah total pendanaan yang dicairkan, termasuk nilai jumlah dan kode mata uang
-
Rincian Penerbitan (jika berlaku) - Informasi tentang pesanan pembelian atau peristiwa penerbitan:
-
ID Penerbitan - Pengidentifikasi unik untuk pencairan
-
Jumlah Penerbitan - Jumlah dalam mata uang lokal
-
Diterbitkan Pada - Stempel waktu pencairan
-
Struktur ini mendukung pencairan tunggal dan skenario pendanaan yang telah disetujui sebelumnya di mana beberapa penerbitan dapat terjadi terhadap satu alokasi.
Rincian Kredit (Jenis KREDIT)
Untuk AWS kredit, rincian pemenuhan meliputi:
-
Jumlah yang dialokasikan - Jumlah total kredit yang dialokasikan
-
Jumlah yang diterbitkan - Jumlah total kredit yang dikeluarkan (mungkin kurang dari yang dialokasikan untuk penerbitan bertahap)
-
Kode Kredit - Array rincian kode kredit individu:
-
AWS ID Akun - Akun tempat kredit diterapkan
-
Nilai - Nilai moneter dari kode kredit
-
AWS Kode Kredit - String kode kredit yang sebenarnya
-
Status - Status kode kredit (
ACTIVE,INACTIVE,FULFILLED) -
Diterbitkan Pada - Saat kode kredit dikeluarkan
-
Kedaluwarsa Pada - Saat kode kredit kedaluwarsa
-
Pelacakan kredit terperinci ini memungkinkan mitra untuk memantau pemanfaatan kredit di beberapa akun dan memahami kredit mana yang tersedia, digunakan sebagian, atau sepenuhnya dikonsumsi.
Rincian Alokasi Konsumsi () Pre-Approved Amounts/Wallets
Untuk kumpulan pendanaan yang telah disetujui sebelumnya, rincian pemenuhan meliputi:
-
Jumlah yang dialokasikan - Jumlah total dalam alokasi
-
Jumlah Sisa - Jumlah yang tidak digunakan masih tersedia
-
Jumlah yang Dig unakan - Jumlah yang sudah dikonsumsi
-
Rincian Penerbitan (jika berlaku) - Informasi pesanan pembelian untuk alokasi
Alokasi yang dapat dikonsumsi memungkinkan mitra untuk menarik dana sesuai kebutuhan untuk kegiatan yang memenuhi syarat, dengan pelacakan saldo yang tersisa secara real-time.
Detail Akses (Tipe AKSES)
Untuk hibah akses, rincian pemenuhan meliputi:
-
Deskripsi - Penjelasan terperinci tentang akses yang diberikan dan cara memanfaatkannya
Alokasi akses mungkin menyediakan akses ke layanan pratinjau, alat khusus, atau sumber daya terbatas. Bidang deskripsi memberikan petunjuk tentang bagaimana mitra dapat mengaktifkan dan menggunakan akses yang diberikan.
Menerapkan Alokasi untuk Aplikasi Manfaat Baru
Bid ApplicableBenefitIds ang dalam alokasi manfaat mengidentifikasi manfaat lain yang dapat memanfaatkan alokasi ini. Hal ini memungkinkan rantai manfaat di mana mitra dapat menggunakan alokasi yang ada untuk mengajukan manfaat tambahan.
Misalnya, pasangan mungkin:
-
Menerima alokasi pendanaan MAP yang telah disetujui sebelumnya
-
Buat aplikasi manfaat untuk proyek migrasi pelanggan individu
-
Kaitkan aplikasi tersebut dengan alokasi yang telah disetujui sebelumnya
-
Menarik dana dari alokasi saat proyek disetujui
Pendekatan ini merampingkan proses aplikasi manfaat untuk mitra dengan pendanaan yang telah disetujui sebelumnya, mengurangi siklus peninjauan untuk permintaan proyek individu.