Lengkapi prasyarat untuk memantau acara Konfigurasikan Amazon EventBridge untuk memantau peristiwa Pelajari lebih lanjut tentang peristiwa API koneksi akun

Pemberitahuan untuk AWS API Rekening Sentral Mitra

Pemberitahuan Koneksi Akun Mitra memungkinkan mitra untuk tetap mendapat informasi tentang peristiwa siklus hidup koneksi yang secara langsung memengaruhi hubungan bisnis dan alur kerja operasional mereka. Peristiwa ini sangat penting bagi mitra untuk:

Bereaksi segera terhadap kolaborasi baru
Pertahankan kesadaran akan status portofolio koneksi mereka
Mengambil tindakan yang tepat ketika koneksi dibuat atau dihentikan
Pastikan kelangsungan bisnis dengan mengetahui kapan hubungan berubah

Topik

Lengkapi prasyarat untuk memantau acara
Konfigurasikan Amazon EventBridge untuk memantau peristiwa
Pelajari lebih lanjut tentang peristiwa API koneksi akun

Lengkapi prasyarat untuk memantau acara

Pengguna memerlukan izin IAM yang sesuai untuk mengakses dan mengelola peristiwa yang diterbitkan oleh API koneksi akun. 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. AllowPutRuleForPartnercentralAccountEventsPernyataan tersebut memungkinkan pembuatan aturan, tetapi hanya untuk acara dari aws.partnercentral-account sumbernya.

Untuk contoh kebijakan IAM yang mendetail, lihat dokumentasi AWS tentang EventBridge izin.


{
  "Version": "2012-10-17",
  "Statement": [
    {
      "Sid": "AllowPutRuleForPartnerCentralAccountEvents",
      "Effect": "Allow",
      "Action": "events:PutRule",
      "Resource": "*",
      "Condition": {
        "StringEquals": {
          "events:source": "aws.partnercentral-account.connection"
        }
      }
    }
  ]
}

Konfigurasikan Amazon EventBridge untuk memantau peristiwa

Untuk memantau peristiwa API koneksi akun, Anda membuat EventBridge aturan yang cocok dengan peristiwa yang ingin Anda tangkap. Anda dapat menggunakan Konsol Manajemen AWS 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.).

Konsol Manajemen AWS mempersiapkan

Untuk menyiapkan EventBridge aturan menggunakan Konsol Manajemen AWS, 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-account"],
    "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='MyConnectionInvitationReceivedRule',
    EventPattern=
    '{
        "source": ["aws.partnercentral-account"], 
        "detail-type": ["Partner Connection Invitation Received"], 
        "detail": {"catalog": ["AWS"]}
    }',
    State='ENABLED'
)
print('Rule ARN:', response['RuleArn'])

Pelajari lebih lanjut tentang peristiwa API koneksi akun

Bagian berikut menjelaskan jenis peristiwa API koneksi akun, skenario yang memicunya, dan contoh peristiwa.

Tipe peristiwa

Berikut ini adalah jenis acara dan pemicunya.

Undangan Koneksi Mitra Diterima: Memberi tahu penerima bahwa mitra lain ingin membuat koneksi
Undangan Koneksi Mitra Diterima: Memberi tahu pengirim bahwa undangan mereka diterima dan koneksi sekarang aktif
Undangan Koneksi Mitra Ditolak: Memberi tahu pengirim bahwa undangan mereka ditolak
Koneksi Mitra Dibatalkan: Memberi tahu peserta lain yang terhubung saat koneksi aktif dihentikan
Undangan Koneksi Mitra Dibatalkan: Memberi tahu penerima bahwa pengirim telah menarik undangan mereka sebelum tindakan apa pun diambil
Undangan Koneksi Mitra Kedaluwarsa: Memberi tahu pengirim dan penerima bahwa undangan telah kedaluwarsa

Contoh peristiwa

Bagian berikut memberikan contoh peristiwa yang tercantum sebelumnya di bagian sebelumnya.

Undangan Koneksi Mitra Diterima

Memicu Konteks

Peristiwa ini dihasilkan ketika undangan koneksi berhasil dibuat dan disimpan di penyimpanan data PAC melalui API. CreateConnectionInvitation Acara dikirim segera setelah pembuatan undangan selesai dengan sukses dan disimpan di penyimpanan data PAC, tidak hanya saat panggilan API dilakukan.

Acara akan dikirim secara otomatis ketika undangan koneksi baru dibuat. Satu acara per undangan dibuat tanpa duplikat acara untuk undangan yang sama.

Penerima

AWS Akun penerima dalam undangan koneksi.

Penanganan yang diharapkan

Tindakan Pelanggan Khas:

Pemberitahuan Segera: Memicu peringatan ke tim bisnis tentang peluang kemitraan baru
Otomatisasi Alur Kerja: Secara otomatis memperbarui sistem manajemen mitra dengan undangan yang tertunda
Decision Support: Rute undangan ke pengambil keputusan yang sesuai berdasarkan jenis koneksi
Audit Logging: Catat tanda terima undangan untuk kepatuhan dan pelacakan kemitraan
Otomatisasi Respons: Untuk mitra tepercaya, berpotensi menerima jenis undangan tertentu secara otomatis

Pola Integrasi Umum:

Fungsi Lambda → Perbarui dasbor portal mitra
Antrian SQS → Undangan proses batch untuk ditinjau
Topik SNS → Email/Slack pemberitahuan ke tim bisnis
Tujuan API → Webhook ke sistem CRM/partner manajemen eksternal

Contoh


{
  "version": "1",
  "id": "<event id>",
  "detail-type": "Partner Connection Invitation Received",
  "source": "aws.partnercentral-account",
  "time": "<ISO 8601 date time>",
  "region": "us-east-1",
  "account": "<corresponding partner AWS account>",
  "resources": [ "<<Connection Invitation ARN>>" ],
  "detail": {
    "catalog": "AWS",
    "connectionInvitation" :{
        "arn": "<<Connection Invitation ARN>>",
        "id": "pacinv-****",
        "connectionType": "OpportunityCollaboration",
        "inviterEmail": "abc@def.com",
        "invitationMessage": "We'd like to collaborate on a joint solution for cloud security. Please accept this connection invitation to proceed.",
        "senderCompanyName": "<<Sender Partner Account Name>>",
        "senderProfileId": "pprofile-****",
        "expiresAt": "<ISO 8601 date time>"
    }
  }
}

Undangan Koneksi Mitra Diterima

Memicu Konteks

Acara ini dihasilkan ketika undangan koneksi berhasil diterima dan koneksi dibuat dan bertahan di penyimpanan data PAC melalui API. AcceptConnectionInvitation Acara dikirim segera setelah penerimaan undangan selesai dengan sukses dan koneksi terjalin.

Acara akan dikirim secara otomatis ketika undangan koneksi diterima. Satu acara per undangan diterima tanpa duplikat acara untuk penerimaan yang sama.

Penerima

Kedua AWS akun yang terlibat dalam undangan koneksi: akun pengirim yang awalnya mengirim undangan dan akun penerima yang menerima undangan.

Penanganan yang diharapkan

Tindakan Pelanggan Khas:

Aktivasi Kemitraan: Memicu alur kerja untuk mengaktifkan aktivitas bisnis Layer 2
Pembaruan Status: Perbarui sistem manajemen mitra dengan status koneksi aktif
Pemberitahuan: Beri tahu tim bisnis tentang keberhasilan pembentukan kemitraan
Penyediaan Akses: Secara otomatis memberikan izin yang sesuai untuk kolaborasi
Analytics: Lacak tingkat konversi kemitraan dan metrik keberhasilan

Pola Integrasi Umum:

Fungsi Lambda → Aktifkan izin berbagi data dan perbarui portal mitra
Antrian SQS → Aktivasi koneksi proses batch untuk pengaturan bisnis
Topik SNS → Email/Slack pemberitahuan untuk tim bisnis dan teknis
Tujuan API → Webhook ke sistem CRM untuk memperbarui status kemitraan

Contoh


{
  "version": "1",
  "id": "<event id>",
  "detail-type":  "Partner Connection Invitation Accepted",
  "source": "aws.partnercentral-account",
  "time": "<ISO 8601 date time>",
  "region": "us-east-1",
  "resources": [ "<<Connection Invitation ARN>>" , "<<Connection ARN>>" ],
  "account": "<corresponding partner AWS account>",
  "detail": {
    "catalog": "AWS",
    "connectionInvitation" :{
        "arn": "<<Connection Invitation ARN>>",
        "id": "pacinv-****",
        "connectionType": "OpportunityCollaboration"
    },
    "connection": {
        "arn": "<<Connection ARN>>",
         "id": "pac-*****",
         "Participant1AccountId": "<<Sender AWS AccountId>>", 
         "Participant2AccountId": "<<Receiver AWS AccountId>>",
         "status": "ACTIVE"
     }
  }
}

Undangan Koneksi Mitra Ditolak

Memicu Konteks

Peristiwa ini dihasilkan ketika undangan koneksi berhasil ditolak melalui RejectConnectionInvitation API. Acara dikirim segera setelah penolakan undangan diproses dan disimpan di penyimpanan data PAC.

Acara akan dikirim secara otomatis ketika undangan koneksi ditolak. Satu acara per undangan ditolak tanpa duplikat acara untuk penolakan yang sama.

Penerima

AWS Akun yang awalnya mengirim undangan koneksi (akun pengirim).

Penanganan yang diharapkan

Tindakan Pelanggan Khas:

Pembaruan Status: Perbarui sistem manajemen mitra dengan status penolakan
Follow-up Tindakan: Memicu alur kerja untuk pendekatan kemitraan alternatif
Pemberitahuan: Beri tahu tim bisnis tentang keputusan kemitraan
Pembersihan: Hapus referensi undangan yang tertunda dari sistem internal

Pola Integrasi Umum:

Fungsi Lambda → Perbarui portal mitra dan picu alur kerja tindak lanjut
Antrian SQS → Penolakan proses batch untuk analisis bisnis
Topik SNS → Email/Slack pemberitahuan kepada tim pengembangan bisnis
Tujuan API → Webhook ke sistem CRM untuk memperbarui status peluang

Contoh


{
  "version": "1",
  "id": "<event id>",
  "detail-type": "Partner Connection Invitation Rejected",
  "source": "aws.partnercentral-account",
  "time": "<ISO 8601 date time>",
  "region": "us-east-1",
  "account": "<corresponding partner AWS account>",
  "resources": [ "<<Connection Invitation ARN>>" ],
  "detail": {
    "catalog": "AWS",
    "connectionInvitation" :{
        "arn": "<<Connection Invitation ARN>>",
        "id": "pacinv-****",
        "connectionType": "OpportunityCollaboration",
        "invitationMessage": "We'd like to collaborate on a joint solution for cloud security. Please accept this connection invitation to proceed.",
        "receiverProfileId": "pprofile-****"
    }
  }
}

Koneksi Mitra Dibatalkan

Memicu Konteks

Peristiwa ini dihasilkan ketika koneksi aktif berhasil dibatalkan dan status aktif diperbarui untuk dihentikan di penyimpanan data PAC melalui API. CancelConnection Acara dikirim segera setelah pembatalan koneksi diproses dan status koneksi diperbarui.

Acara akan dikirim secara otomatis ketika koneksi dihentikan. Satu acara per koneksi dibatalkan tanpa duplikat acara untuk pembatalan yang sama.

Penerima

AWS Akun peserta lain dalam koneksi (bukan orang yang memulai pembatalan).

Penanganan yang diharapkan

Tindakan Pelanggan Khas:

Pencabutan Akses: Segera cabut izin dan nonaktifkan berbagi data
Pembaruan Status: Perbarui sistem manajemen mitra dengan status koneksi yang dihentikan
Pemberitahuan: Peringatkan tim bisnis dan teknis tentang penghentian kemitraan
Pembersihan: Hapus referensi koneksi dan bersihkan sumber daya bersama
Analytics: Lacak durasi koneksi dan pola penghentian

Pola Integrasi Umum:

Fungsi Lambda → Cabut izin dan perbarui status portal mitra
Antrian SQS → Penghentian koneksi proses batch untuk alur kerja pembersihan
Topik SNS → Email/Slack pemberitahuan untuk tim bisnis dan teknis
Tujuan API → Webhook ke sistem CRM untuk memperbarui status kemitraan

Contoh


{
  "version": "1",
  "id": "<event id>",
  "detail-type": "Partner Connection Cancelled",
  "source": "aws.partnercentral-account",
  "time": "<ISO 8601 date time>",
  "region": "us-east-1",
  "resources": [ "<<Connection ARN>>" ],
  "account": "<corresponding partner AWS account>",
  "detail": {
    "catalog": "AWS",
    "connection" :{
        "arn": "<<Connection Invitation ARN>>",
        "id": "pac-****",
        "connectionType": "OpportunityCollaboration",
        "canceledBy": "<<AWS account ID>>"
    }
  }
}

Undangan Koneksi Mitra Dibatalkan

Memicu Konteks

Peristiwa ini dihasilkan ketika undangan koneksi yang tertunda berhasil dibatalkan melalui CancelConnectionInvitation API. Acara dikirim segera setelah pembatalan undangan diproses dan status undangan diperbarui menjadi DIBATALKAN.

Acara akan dikirim secara otomatis ketika undangan koneksi dibatalkan. Satu acara per undangan koneksi dibatalkan tanpa duplikat acara untuk pembatalan yang sama.

Penerima

AWS Akun yang seharusnya menerima undangan koneksi (akun penerima).

Penanganan yang diharapkan

Tindakan Pelanggan Khas:

Pembaruan Status: Perbarui sistem manajemen mitra untuk menghapus referensi undangan yang tertunda
Pemberitahuan: Beri tahu tim bisnis bahwa peluang kemitraan potensial telah ditarik
Pembersihan: Hapus referensi undangan dari sistem pelacakan internal
Analytics: Lacak pola pembatalan undangan untuk wawasan kemitraan

Pola Integrasi Umum:

Fungsi Lambda → Perbarui portal mitra dan hapus pemberitahuan undangan yang tertunda
Antrian SQS → Pembatalan proses batch untuk analisis bisnis
Topik SNS → Email/Slack pemberitahuan kepada tim pengembangan bisnis
Tujuan API → Webhook ke sistem CRM untuk memperbarui status peluang

Contoh


{
  "version": "1",
  "id": "<event id>",
  "detail-type": "Partner Connection Invitation Cancelled",
  "source": "aws.partnercentral-account",
  "time": "<ISO 8601 date time>",
  "region": "us-east-1",
  "account": "<corresponding partner AWS account>",
  "resources": [ "<<Connection Invitation ARN>>" ],
  "detail": {
    "catalog": "AWS",
    "connectionInvitation" :{
        "arn": "<<Connection Invitation ARN>>",
        "id": "pacinv-****",
        "connectionType": "OpportunityCollaboration",
        "invitationMessage": "We'd like to collaborate on a joint solution for cloud security. Please accept this connection invitation to proceed.",
        "senderProfileId": "pprofile-****"
    }
  }
}

Undangan Koneksi Mitra Kedaluwarsa

Memicu Konteks

Acara ini dihasilkan ketika undangan koneksi yang tertunda secara otomatis kedaluwarsa setelah mencapai ExpiresAt stempel waktu tanpa diterima atau ditolak oleh penerima. Acara ini secara otomatis dipicu oleh sistem ketika waktu kedaluwarsa undangan tercapai.

Acara akan dikirim secara otomatis ketika undangan koneksi kedaluwarsa. Satu acara per undangan kedaluwarsa tanpa duplikat acara untuk kedaluwarsa yang sama.

Penerima

Kedua AWS akun yang terlibat dalam undangan koneksi: akun pengirim yang awalnya mengirim undangan dan akun penerima yang menerima undangan.

Penanganan yang diharapkan

Tindakan Pelanggan Khas:

Pembaruan Status: Perbarui sistem manajemen mitra untuk menandai undangan sebagai kedaluwarsa
Follow-up Tindakan: Memicu alur kerja untuk keterlibatan kembali atau pendekatan kemitraan alternatif
Pemberitahuan: Beri tahu tim bisnis tentang peluang kemitraan yang terlewatkan
Pembersihan: Hapus referensi undangan yang kedaluwarsa dari sistem pelacakan internal

Pola Integrasi Umum:

Fungsi Lambda → Perbarui portal mitra dan picu alur kerja tindak lanjut
Antrian SQS → Kedaluwarsa proses batch untuk analisis bisnis
Topik SNS → Email/Slack pemberitahuan kepada tim pengembangan bisnis
Tujuan API → Webhook ke sistem CRM untuk memperbarui status peluang

Contoh


{
  "version": "1",
  "id": "<event id>",
  "detail-type": "Partner Connection Invitation Expired",
  "source": "aws.partnercentral-account",
  "time": "<ISO 8601 date time>",
  "region": "us-east-1",
  "resources": [ "<<Connection Invitation ARN>>" ],
  "detail": {
    "catalog": "AWS",
    "connectionInvitation": {
        "arn": "<<Connection Invitation ARN>>",
        "id": "pacinv-****",
        "connectionType": "OpportunityCollaboration",
        "inviterEmail": "abc@def.com",
        "invitationMessage": "We'd like to collaborate on a joint solution for cloud security. Please accept this connection invitation to proceed.",
        "senderProfileId": "pprofile-****",
        "receiverProfileId": "pprofile-****"
    }
  }
}

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

Notifikasi

Pemberitahuan untuk AWS API Penjualan Sentral Mitra