Lengkapi prasyarat untuk memantau acara Konfigurasikan Amazon EventBridge untuk memantau peristiwa Pelajari selengkapnya tentang manfaat peristiwa API

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.

Topik

Lengkapi prasyarat untuk memantau acara
Konfigurasikan Amazon EventBridge untuk memantau peristiwa
Pelajari selengkapnya tentang manfaat peristiwa API

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 di Panduan EventBridge Pengguna Amazon. Salah satu kunci kondisi adalahevents: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. AllowPutRuleForPartnercentralBenefitsEventsPernyataan 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 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 PutRuledi 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: Saat Aplikasi Manfaat dibuat
Aplikasi Manfaat Dalam Tinjauan: Ketika Aplikasi Manfaat diajukan atau ketika Aplikasi beralih dari Tindakan yang Diperlukan kembali ke Dalam Tinjauan, acara ini dipicu.
Tindakan Aplikasi Manfaat Diperlukan: 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: 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: Acara ini terjadi ketika peninjau internal memperbarui status aplikasi untuk menunjukkan bahwa aplikasi telah disetujui untuk alokasi manfaat.
Tahap Aplikasi Manfaat Berubah: 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: Ketika Alokasi Manfaat dibuat atau diperbarui kembali ke Diaktifkan oleh layanan internal.
Alokasi Manfaat Tidak Aktif: Peristiwa ini terjadi ketika reviewer internal memperbarui status alokasi atau ketika Alokasi Manfaat berakhir secara otomatis.
Alokasi Manfaat Terpenuhi: 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.

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"]
    }
  }
}

Awas Javascript dinonaktifkan atau tidak tersedia di browser Anda.

Untuk menggunakan Dokumentasi AWS, Javascript harus diaktifkan. Lihat halaman Bantuan browser Anda untuk petunjuk.

Konvensi Dokumen

Pemberitahuan untuk AWS API Penjualan Sentral Mitra

Pemberitahuan untuk AWS API Saluran Pusat Mitra