Referensi Pusat Partner AWS API direstrukturisasi. Untuk informasi selengkapnya tentang operasi API yang didukung, lihat [Referensi Pusat Partner AWS API](https://docs.aws.amazon.com/partner-central/latest/APIReference/Welcome.html).
Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
# Pemberitahuan untuk AWS API Manfaat Sentral Mitra
Layanan Manfaat menyediakan EventBridge acara untuk keduanya BenefitApplications dan BenefitAllocations. Peristiwa ini memungkinkan pelanggan untuk membangun arsitektur berbasis peristiwa komprehensif yang merespons perubahan di seluruh siklus hidup sumber daya - dari Aplikasi awal hingga Alokasi dan Pemenuhan akhir.
**Topics**
+ [Lengkapi prasyarat untuk memantau acara](#events-prerequites)
+ [Konfigurasikan Amazon EventBridge untuk memantau peristiwa](#eventbridge-setup)
+ [Pelajari selengkapnya tentang manfaat peristiwa API](#learn-about-events)
## Lengkapi prasyarat untuk memantau acara
Pengguna memerlukan izin IAM yang sesuai untuk mengakses dan mengelola peristiwa yang diterbitkan oleh API manfaat. Untuk informasi selengkapnya tentang tindakan, sumber daya, dan kunci kondisi yang tersedia EventBridge, lihat [Menggunakan kondisi kebijakan IAM di Amazon EventBridge](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-use-conditions.html#events-pattern-detail-type) di *Panduan EventBridge Pengguna Amazon*. Salah satu kunci kondisi adalah`events:detail-type`, yang dapat digunakan untuk cakupan izin untuk jenis peristiwa tertentu.
Contoh kebijakan berikut menunjukkan cara menyesuaikan dan cakupan izin untuk acara yang diusulkan. `AllowPutRuleForPartnercentralBenefitsEvents`Pernyataan tersebut memungkinkan pembuatan aturan, tetapi hanya untuk acara dari `aws.partnercentral-benefits` sumbernya.
Untuk contoh kebijakan IAM yang mendetail, lihat dokumentasi AWS tentang EventBridge izin.
```
{
"Version": "2012-10-17",
"Statement": [
{
"Sid": "AllowPutRuleForPartnerCentralBenefitsEvents",
"Effect": "Allow",
"Action": "events:PutRule",
"Resource": "*",
"Condition": {
"StringEquals": {
"events:source": "aws.partnercentral-benefits"
}
}
}
]
}
```
## Konfigurasikan Amazon EventBridge untuk memantau peristiwa
Untuk memantau peristiwa API manfaat, Anda membuat EventBridge aturan yang cocok dengan peristiwa yang ingin Anda tangkap. Anda dapat menggunakan AWS Management Console atau AWS SDK untuk membuat dan mengelola aturan. Bagian berikut menjelaskan cara membuat aturan menggunakan kedua metode. Terlepas dari metode yang Anda gunakan, Anda harus membuat aturan di `us-east-1` Wilayah AS Timur (Virginia N.).
### AWS Management Console mempersiapkan
Untuk menyiapkan EventBridge aturan menggunakan AWS Management Console, ikuti langkah-langkah dalam [Membuat aturan yang bereaksi terhadap peristiwa di Amazon EventBridge](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-create-rule.html) di *Panduan EventBridge Pengguna Amazon*. Saat membuat aturan, Anda harus mengatur bus acara ke **default**, dan membuat aturan di `us-east-1` Wilayah AS Timur (Virginia N.).
Berikut ini adalah contoh aturan acara:
```
{
"source": ["aws.partnercentral-benefits"],
"detail": {
"catalog": ["AWS"]
}
}
```
### AWS Pengaturan SDK
Anda dapat menggunakan AWS SDK untuk membuat dan mengelola EventBridge aturan secara terprogram. Untuk informasi selengkapnya, lihat [PutRule](https://docs.aws.amazon.com/eventbridge/latest/APIReference/API_PutRule.html)di *Referensi Amazon EventBridge API*.
Contoh berikut menggunakan AWS SDK for Python (Boto3):
```
import boto3
client = boto3.client('events', region_name='us-east-1')
response = client.put_rule(
Name='MyBenefitApplicationCreatedRule',
EventPattern=
'{
"source": ["aws.partnercentral-benefits"],
"detail-type": ["Benefit Application Created"],
"detail": {"catalog": ["AWS"]}
}',
State='ENABLED'
)
print('Rule ARN:', response['RuleArn'])
```
## Pelajari selengkapnya tentang manfaat peristiwa API
Bagian berikut menjelaskan manfaat jenis peristiwa API, skenario yang memicunya, dan contoh peristiwa.
### Tipe peristiwa
Berikut ini adalah jenis acara dan pemicunya.
#### Aplikasi Manfaat
+ [Aplikasi Manfaat Dibuat](#benefit-application-created): Saat Aplikasi Manfaat dibuat
+ [Aplikasi Manfaat Dalam Tinjauan](#benefit-application-in-review): Ketika Aplikasi Manfaat diajukan atau ketika Aplikasi beralih dari Tindakan yang Diperlukan kembali ke Dalam Tinjauan, acara ini dipicu.
+ [Tindakan Aplikasi Manfaat Diperlukan](#benefit-application-action-required): Peristiwa ini terjadi ketika peninjau internal memperbarui status aplikasi untuk menunjukkan bahwa mitra perlu memberikan informasi tambahan, klarifikasi, atau modifikasi sebelum peninjauan dapat dilanjutkan.
+ [Aplikasi Manfaat Ditolak](#benefit-application-rejected): Peristiwa ini terjadi ketika reviewer internal memperbarui status aplikasi untuk menunjukkan bahwa aplikasi tidak memenuhi kriteria atau persyaratan manfaat dan telah ditolak
+ [Aplikasi Manfaat Disetujui](#benefit-application-approved): Acara ini terjadi ketika peninjau internal memperbarui status aplikasi untuk menunjukkan bahwa aplikasi telah disetujui untuk alokasi manfaat.
+ [Tahap Aplikasi Manfaat Berubah](#benefit-application-stage-changed): Peristiwa ini terjadi ketika peninjau internal memperbarui tahap aplikasi selama proses peninjauan seperti Tinjauan Bisnis, Tinjauan,AWS Tinjauan Keuangan, dll.
#### Alokasi Manfaat
+ [Alokasi Manfaat Diaktifkan](#benefit-allocation-activated): Ketika Alokasi Manfaat dibuat atau diperbarui kembali ke Diaktifkan oleh layanan internal.
+ [Alokasi Manfaat Tidak Aktif](#benefit-allocation-inactivated): Peristiwa ini terjadi ketika reviewer internal memperbarui status alokasi atau ketika Alokasi Manfaat berakhir secara otomatis.
+ [Alokasi Manfaat Terpenuhi](#benefit-allocation-fulfilled): Acara ini terjadi ketika reviewer internal memperbarui status alokasi untuk menunjukkan bahwa alokasi telah sepenuhnya digunakan.
### Contoh peristiwa
Bagian berikut memberikan contoh peristiwa yang tercantum sebelumnya di bagian sebelumnya.
**Topics**
+ [Aplikasi Manfaat Dibuat](#benefit-application-created)
+ [Aplikasi Manfaat Dalam Tinjauan](#benefit-application-in-review)
+ [Tindakan Aplikasi Manfaat Diperlukan](#benefit-application-action-required)
+ [Aplikasi Manfaat Ditolak](#benefit-application-rejected)
+ [Aplikasi Manfaat Disetujui](#benefit-application-approved)
+ [Tahap Aplikasi Manfaat Berubah](#benefit-application-stage-changed)
+ [Alokasi Manfaat Diaktifkan](#benefit-allocation-activated)
+ [Alokasi Manfaat Tidak Aktif](#benefit-allocation-inactivated)
+ [Alokasi Manfaat Terpenuhi](#benefit-allocation-fulfilled)
#### Aplikasi Manfaat Dibuat
##### Memicu Konteks
Acara Benefit Application Created dipublikasikan ke Amazon EventBridge ketika Aplikasi Benefit baru berhasil dibuat melalui Layanan Manfaat. Peristiwa ini terjadi ketika panggilan CreateBenefitApplication API berhasil diselesaikan, yang menunjukkan bahwa mitra telah memulai permintaan untuk manfaat tertentu.
Acara ini merupakan awal dari siklus hidup aplikasi manfaat dan memberi pelanggan pemberitahuan segera ketika aplikasi baru dikirimkan ke akun mereka.
##### Penerima
Akun pemilik akan menerima acara untuk Alokasi Manfaat.
##### Contoh
```
{
"id": "7gh88765-k0jh-d08g-i292-2ff1796m030n",
"detail-type": "Benefit Application Created",
"source": "aws.partnercentral-benefits",
"account": "123456789012",
"time": "2025-02-10T15:45:00Z",
"region": "us-east-1",
"resources": [
"arn:aws:partnercentral:us-east-1:123456789012:benefit-application/benappl-12345abcdef123"
],
"detail": {
"catalog": "AWS",
"benefitApplication": {
"id": "benappl-12345abcdef123",
"fulfillmentTypes": ["CREDITS"],
"status": "PENDING_SUBMISSION",
"revision": "hh7e8400-e29b-41d4-a716-446655440012"
},
"benefit": {
"id": "ben-xyz789uvw012",
"name": "AWS Partner Credits",
"program": ["AWS Partner Network"]
}
}
}
```
#### Aplikasi Manfaat Dalam Tinjauan
##### Memicu Konteks
Acara Benefit Application In Review dipublikasikan ke Amazon EventBridge ketika Aplikasi Benefit beralih ke status IN\_REVIEW melalui Layanan Manfaat. Peristiwa ini terjadi ketika:
+ Mitra mengirimkan aplikasi mereka melalui panggilan SubmitBenefitApplication API
+ Transisi aplikasi dari ACTION\_REQUIRED kembali ke IN\_REVIEW setelah mitra menangani umpan balik
+ Aplikasi ditarik kembali dan kemudian dikirimkan kembali
Acara ini menunjukkan bahwa aplikasi telah memasuki proses peninjauan formal dan sedang dievaluasi oleh tim AWS internal.
##### Penerima
Akun pemilik akan menerima acara untuk Alokasi Manfaat.
##### Contoh
```
{
"id": "8hi99876-l1ki-e19h-j303-3gg2807n141o",
"detail-type": "Benefit Application In Review",
"source": "aws.partnercentral-benefits",
"account": "123456789012",
"time": "2025-02-10T16:00:00Z",
"region": "us-east-1",
"resources": [
"arn:aws:partnercentral:us-east-1:123456789012:benefit-application/benappl-12345abcdef123"
],
"detail": {
"catalog": "AWS",
"benefitApplication": {
"id": "benappl-12345abcdef123",
"fulfillmentTypes": ["CREDITS"],
"status": "IN_REVIEW",
"stage": "BUSINESS_REVIEW",
"revision": "ii8f9511-f30c-52e5-b827-557766551123"
},
"benefit": {
"id": "ben-xyz789uvw012",
"name": "AWS Partner Credits",
"program": ["AWS Partner Network"]
}
}
}
```
#### Tindakan Aplikasi Manfaat Diperlukan
##### Memicu Konteks
Peristiwa Benefit Application Action Required dipublikasikan ke Amazon EventBridge saat Aplikasi Benefit beralih ke status ACTION\_REQUIRED melalui Layanan Manfaat. Peristiwa ini terjadi ketika reviewer internal memperbarui status aplikasi melalui UpdateBenefitApplicationInternal API untuk menunjukkan bahwa mitra perlu memberikan informasi tambahan, klarifikasi, atau modifikasi sebelum peninjauan dapat dilanjutkan.
Peristiwa ini merupakan titik kritis dalam siklus hidup aplikasi di mana intervensi mitra diperlukan untuk memajukan aplikasi dalam proses peninjauan.
##### Penerima
Akun pemilik akan menerima acara untuk Alokasi Manfaat
##### Contoh
```
{
"id": "9ij00987-m2lj-f20i-k414-4hh3918o252p",
"detail-type": "Benefit Application Action Required",
"source": "aws.partnercentral-benefits",
"account": "123456789012",
"time": "2025-02-12T10:30:00Z",
"region": "us-east-1",
"resources": [
"arn:aws:partnercentral:us-east-1:123456789012:benefit-application/benappl-12345abcdef123"
],
"detail": {
"catalog": "AWS",
"benefitApplication": {
"id": "benappl-12345abcdef123",
"fulfillmentTypes": ["CREDITS"],
"status": "ACTION_REQUIRED",
"stage": "BUSINESS_REVIEW",
"revision": "jj9g0622-g41d-63f6-c938-668877662234"
},
"benefit": {
"id": "ben-xyz789uvw012",
"name": "AWS Partner Credits",
"program": ["AWS Partner Network"]
}
}
}
```
#### Aplikasi Manfaat Ditolak
##### Memicu Konteks
Acara yang Ditolak Aplikasi Manfaat dipublikasikan ke Amazon EventBridge saat Aplikasi Manfaat beralih ke status DITOLAK melalui Layanan Manfaat. Peristiwa ini terjadi ketika reviewer internal memperbarui status aplikasi melalui UpdateBenefitApplicationInternal API untuk menunjukkan bahwa aplikasi tidak memenuhi kriteria manfaat atau persyaratan dan telah ditolak.
Peristiwa ini mewakili status terminal dalam siklus hidup aplikasi di mana aplikasi telah ditolak secara resmi dan tidak akan melanjutkan ke alokasi manfaat.
##### Penerima
Akun pemilik akan menerima acara untuk Alokasi Manfaat.
##### Contoh
```
{
"id": "0kl11098-n3mk-g31j-l525-5ii4029p363q",
"detail-type": "Benefit Application Rejected",
"source": "aws.partnercentral-benefits",
"account": "123456789012",
"time": "2025-02-15T14:20:00Z",
"region": "us-east-1",
"resources": [
"arn:aws:partnercentral:us-east-1:123456789012:benefit-application/benappl-12345abcdef123"
],
"detail": {
"catalog": "AWS",
"benefitApplication": {
"id": "benappl-12345abcdef123",
"fulfillmentTypes": ["CREDITS"],
"status": "REJECTED",
"revision": "kk0h1733-h52e-74g7-d049-779988773345"
},
"benefit": {
"id": "ben-xyz789uvw012",
"name": "AWS Partner Credits",
"program": ["AWS Partner Network"]
}
}
}
```
#### Aplikasi Manfaat Disetujui
##### Memicu Konteks
Acara yang Disetujui Aplikasi Manfaat dipublikasikan ke Amazon EventBridge saat Aplikasi Manfaat beralih ke status DISETUJUI melalui Layanan Manfaat. Peristiwa ini terjadi ketika reviewer internal memperbarui status aplikasi melalui UpdateBenefitApplicationInternal API untuk menunjukkan bahwa aplikasi memenuhi semua kriteria manfaat dan persyaratan dan telah disetujui untuk alokasi manfaat.
Acara ini merupakan keberhasilan penyelesaian proses peninjauan aplikasi dan biasanya memicu pembuatan Alokasi Manfaat yang sesuai.
##### Penerima
Akun pemilik akan menerima acara untuk Alokasi Manfaat.
##### Contoh
```
{
"id": "1lm22109-o4nl-h42k-m636-6jj5130q474r",
"detail-type": "Benefit Application Approved",
"source": "aws.partnercentral-benefits",
"account": "123456789012",
"time": "2025-02-14T16:45:00Z",
"region": "us-east-1",
"resources": [
"arn:aws:partnercentral:us-east-1:123456789012:benefit-application/benappl-12345abcdef123"
],
"detail": {
"catalog": "AWS",
"benefitApplication": {
"id": "benappl-12345abcdef123",
"fulfillmentTypes": ["CREDITS"],
"status": "APPROVED",
"revision": "ll1i2844-i63f-85h8-e150-880099884456"
},
"benefit": {
"id": "ben-xyz789uvw012",
"name": "AWS Partner Credits",
"program": ["AWS Partner Network"]
}
}
}
```
#### Tahap Aplikasi Manfaat Berubah
##### Memicu Konteks
Acara Benefit Application Stage Changed dipublikasikan ke Amazon EventBridge ketika tahap peninjauan Aplikasi Benefit diperbarui melalui Layanan Manfaat. Peristiwa ini terjadi ketika reviewer internal memperbarui Tahap aplikasi ke salah satu nilai Enum yang mungkin (FINANCE\_REVIEW, BUSINESS\_REVIEW, TECH\_REVIEW dan \_REVIEW).AWS
Tidak seperti perubahan status, perubahan tahap adalah pembaruan informasi hanya-baca yang memberikan visibilitas ke dalam perkembangan alur kerja tinjauan internal tanpa memerlukan tindakan mitra.
##### Penerima
Akun pemilik akan menerima acara untuk Alokasi Manfaat.
##### Contoh
```
{
"id": "2mn33210-p5om-i53l-n747-7kk6241r585s",
"detail-type": "Benefit Application Stage Changed",
"source": "aws.partnercentral-benefits",
"account": "123456789012",
"time": "2025-02-13T11:15:00Z",
"region": "us-east-1",
"resources": [
"arn:aws:partnercentral:us-east-1:123456789012:benefit-application/benappl-12345abcdef123"
],
"detail": {
"catalog": "AWS",
"benefitApplication": {
"id": "benappl-12345abcdef123",
"fulfillmentTypes": ["CREDITS"],
"status": "IN_REVIEW",
"stage": "FINANCIAL_REVIEW",
"revision": "mm2j3955-j74g-96i9-f261-991100995567"
},
"benefit": {
"id": "ben-xyz789uvw012",
"name": "AWS Partner Credits",
"program": ["AWS Partner Network"]
}
}
}
```
#### Alokasi Manfaat Diaktifkan
##### Memicu Konteks
Acara Aktif Alokasi Manfaat dipublikasikan ke Amazon EventBridge saat Alokasi Manfaat beralih ke status AKTIF melalui Layanan Manfaat. Peristiwa ini terjadi ketika reviewer internal memperbarui status alokasi melalui UpdateBenefitAllocationInternal API untuk mengaktifkan kembali alokasi yang sebelumnya tidak aktif.
Peristiwa ini biasanya terjadi ketika alokasi yang dinonaktifkan sementara (karena kedaluwarsa, perubahan kebijakan, atau alasan administratif) dikembalikan ke status aktif, sehingga manfaat tersedia untuk pemanfaatan mitra lagi.
##### Penerima
AWS Akun milik Mitra akan menerima pesan tersebut. Dengan kata lain,AWS Akun yang memiliki sumber daya.
##### Contoh Acara
```
{
"id": "3no44321-q6pn-j64m-o858-8ll7352s696t",
"detail-type": "Benefit Allocation Activated",
"source": "aws.partnercentral-benefits",
"account": "123456789012",
"time": "2025-03-01T08:15:00Z",
"region": "us-east-1",
"resources": [
"arn:aws:partnercentral:us-east-1:123456789012:benefit-allocation/benalloc-abc123def456"
],
"detail": {
"catalog": "AWS",
"benefitAllocation": {
"id": "benalloc-abc123def456",
"fulfillmentType": "CREDITS",
"status": "ACTIVE"
},
"benefitApplication": {
"id": "benappl-12345abcdef123"
},
"benefit": {
"id": "ben-xyz789uvw012",
"name": "AWS Partner Credits",
"program": ["AWS Partner Network"]
}
}
}
```
#### Alokasi Manfaat Tidak Aktif
##### Memicu Konteks
Acara Alokasi Manfaat Tidak Aktif dipublikasikan ke Amazon EventBridge ketika Alokasi Manfaat beralih ke status TIDAK AKTIF melalui Layanan Manfaat. Peristiwa ini terjadi ketika reviewer internal memperbarui status alokasi melalui UpdateBenefitAllocationInternal API atau ketika Alokasi Manfaat kedaluwarsa secara otomatis.
Peristiwa ini biasanya terjadi ketika alokasi ditangguhkan sementara (karena kedaluwarsa, perubahan kebijakan, masalah kepatuhan, atau alasan administratif), membuat manfaat tidak tersedia untuk pemanfaatan mitra hingga diaktifkan kembali.
##### Penerima
AWS Akun milik Mitra akan menerima pesan tersebut. Dengan kata lain,AWS Akun yang memiliki sumber daya.
##### Contoh Acara
```
{
"id": "4op55432-r7qo-k75n-p969-9mm8463t707u",
"detail-type": "Benefit Allocation Inactivated",
"source": "aws.partnercentral-benefits",
"account": "123456789012",
"time": "2025-06-30T23:59:59Z",
"region": "us-east-1",
"resources": [
"arn:aws:partnercentral:us-east-1:123456789012:benefit-allocation/benalloc-abc123def456"
],
"detail": {
"catalog": "AWS",
"benefitAllocation": {
"id": "benalloc-abc123def456",
"fulfillmentType": "CREDITS",
"status": "INACTIVE"
},
"benefitApplication": {
"id": "benappl-12345abcdef123"
},
"benefit": {
"id": "ben-xyz789uvw012",
"name": "AWS Partner Credits",
"program": ["AWS Partner Network"]
}
}
}
```
#### Alokasi Manfaat Terpenuhi
##### Memicu Konteks
Acara Terpenuhi Alokasi Manfaat dipublikasikan ke Amazon EventBridge ketika Alokasi Manfaat beralih ke status TERPENUHI melalui Layanan Manfaat. Peristiwa ini terjadi ketika reviewer internal memperbarui status alokasi melalui UpdateBenefitAllocationInternal API untuk menunjukkan bahwa alokasi telah sepenuhnya digunakan atau bahwa persyaratan manfaat telah dipenuhi.
Acara ini merupakan penyelesaian siklus hidup manfaat, yang menunjukkan bahwa mitra telah berhasil memanfaatkan manfaat yang dialokasikan atau bahwa alokasi telah mencapai kesimpulan alaminya.
##### Penerima
AWS Akun milik Mitra akan menerima pesan tersebut. Dengan kata lain,AWS Akun yang memiliki sumber daya.
##### Contoh Acara
```
{
"id": "5pq66543-s8rp-l86o-q070-0nn9574u818v",
"detail-type": "Benefit Allocation Fulfilled",
"source": "aws.partnercentral-benefits",
"account": "123456789012",
"time": "2025-12-15T17:30:00Z",
"region": "us-east-1",
"resources": [
"arn:aws:partnercentral:us-east-1:123456789012:benefit-allocation/benalloc-abc123def456"
],
"detail": {
"catalog": "AWS",
"benefitAllocation": {
"id": "benalloc-abc123def456",
"fulfillmentType": "CREDITS",
"status": "FULFILLED"
},
"benefitApplication": {
"id": "benappl-12345abcdef123"
},
"benefit": {
"id": "ben-xyz789uvw012",
"name": "AWS Partner Credits",
"program": ["AWS Partner Network"]
}
}
}
```