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 Koneksi Akun Mitra
Mitra dapat mengelola koneksi antara akun mereka sendiri atau koneksi dengan AWS akun mitra lain menggunakan API Koneksi AWS Mitra. Prosesnya melibatkan dua fase:
-
Fase Undangan Koneksi: Memulai dan menanggapi permintaan koneksi
-
Fase Koneksi Aktif: Mengelola koneksi yang sudah mapan dan kegiatan bisnis terkait
Membuat dan Mengirim Undangan Koneksi
Langkah 1: Buat Undangan Koneksi
Langkah pertama dalam membangun koneksi mitra adalah membuat dan mengirim undangan koneksi menggunakan CreateConnectionInvitation tindakan. Saat membuat undangan, Anda harus menentukan:
-
Katalog: AWS Katalog (AWS atau Sandbox) tempat koneksi akan dikelola
-
ConnectionType: Jenis hubungan yang ingin Anda bangun. Pilih salah satu cara berikut:
-
OPPORTUNITY_COLLABORATION: Gunakan jenis ini saat Anda ingin mengirim permintaan koneksi ke akun mitra lain sehingga Anda dapat mengirimi mereka undangan keterlibatan peluang untuk kolaborasi peluang -
SUBSIDIARY: Gunakan jenis ini jika Anda ingin menghubungkan beberapa akun penjual AWS Marketplace yang Anda miliki ke akun “utama” yang telah Anda tautkan dengan APN atau tempat Anda terdaftar sebagai Mitra
-
-
ReceiverIdentifier: ID profil mitra publik penerima (untuk jenis koneksi Kolaborasi Peluang) atau ID AWS akun (untuk jenis koneksi Anak Perusahaan)
-
Email: Alamat email kontak Anda untuk komunikasi
-
Nama: Nama Anda sebagai pengirim
-
Pesan: Deskripsi yang menjelaskan tujuan permintaan koneksi
Saat dibuat, undangan memasuki status Tertunda, menunggu tindakan dari penerima.
penting
Dengan mengirimkan undangan koneksi, Anda setuju untuk mengungkapkan ID AWS akun Anda kepada penerima jika mereka menerima undangan. Pengungkapan ini diperlukan untuk membangun koneksi tingkat akun.
Langkah 2: Pantau Undangan Anda yang Dikirim
Anda dapat melacak status undangan yang telah Anda kirim menggunakan ListConnectionInvitations tindakan dengan ParticipantType parameter disetel keSENDER. Hal ini memungkinkan Anda untuk:
-
Lihat semua undangan keluar
-
Filter berdasarkan status (
PENDING,ACCEPTED,REJECTED,EXPIRED) -
Filter berdasarkan jenis koneksi
-
Periksa undangan khusus ke mitra lain
Langkah 3: Batalkan Undangan (Opsional)
Jika Anda perlu menarik undangan yang tertunda sebelum diterima, Anda dapat menggunakan CancelConnectionInvitation tindakan tersebut. Perhatikan bahwa:
-
Anda hanya dapat membatalkan undangan dalam status Tertunda
-
Setelah undangan diterima dan koneksi dibuat, itu tidak dapat dibatalkan
-
Untuk mengakhiri koneksi yang sudah mapan, Anda harus menggunakan
CancelConnectiontindakan sebagai gantinya
Menerima dan Menanggapi Undangan Koneksi
Langkah 1: Daftar Undangan Masuk
Untuk melihat undangan koneksi yang telah Anda terima, gunakan ListConnectionInvitations tindakan dengan ParticipantType parameter disetel keRECEIVER. Anda dapat memfilter berdasarkan:
-
Tipe koneksi
-
Status (
PENDING,ACCEPTED,REJECTED) -
Pengidentifikasi pengirim
Langkah 2: Tinjau Detail Undangan
Gunakan GetConnectionInvitation tindakan untuk melihat detail lengkap undangan tertentu, termasuk:
-
Nama pengirim dan email kontak
-
Pesan undangan yang menjelaskan tujuannya
-
Jenis koneksi yang diminta
-
Tanggal kedaluwarsa
-
Informasi profil publik Sender
Langkah 3: Terima atau Tolak Undangan
Setelah meninjau detail undangan, Anda memiliki dua opsi:
Opsi A: Terima Undangan
Gunakan AcceptConnectionInvitation tindakan untuk membuat koneksi. Ketika Anda menerima:
-
Koneksi baru dibuat dalam keadaan Aktif
-
Status undangan berubah menjadi Diterima
-
ID AWS akun Anda diungkapkan kepada pengirim
-
Anda dapat mulai melakukan aktivitas bisnis yang diaktifkan oleh jenis koneksi
penting
Persetujuan Penting: Dengan menerima undangan koneksi, Anda setuju untuk mengungkapkan ID AWS akun Anda kepada pengirim. Pengungkapan ini diperlukan untuk membangun koneksi tingkat akun.
Opsi B: Tolak Undangan
Gunakan RejectConnectionInvitation tindakan jika Anda tidak ingin membuat koneksi. Anda dapat secara opsional memberikan alasan penolakan. Setelah ditolak:
-
Status undangan berubah menjadi Ditolak
-
Tidak ada koneksi yang dibuat
-
Undangan tidak akan lagi muncul dalam daftar undangan yang tertunda
Kedaluwarsa Otomatis
Jika tidak ada tindakan yang diambil dalam periode kedaluwarsa, sistem secara otomatis mengalihkan undangan ke status Kedaluwarsa. Undangan kedaluwarsa tidak dapat diterima atau ditolak.
Mengelola Koneksi Aktif
Melihat Koneksi Anda
Setelah koneksi dibuat, kedua belah pihak dapat melihat dan mengelolanya menggunakan tindakan berikut:
ListConnections: Ambil daftar koneksi Anda dengan opsi pemfilteran:
-
Filter berdasarkan jenis koneksi dan status (mis.,
OPPORTUNITY_COLLABORATION:ACTIVE) -
Filter berdasarkan pengidentifikasi pihak lain
-
Lihat informasi ringkasan untuk setiap koneksi
GetConnection: Ambil detail lengkap dari koneksi tertentu, termasuk:
-
Semua jenis koneksi yang terkait dengan hubungan mitra ini
-
Status setiap jenis koneksi (Aktif atau Dihentikan)
-
Informasi kontak dari undangan asli
-
AWS ID akun dan ID profil publik kedua belah pihak
-
Stempel waktu pembuatan dan penghentian untuk setiap jenis koneksi
Menambahkan Jenis Koneksi ke Koneksi yang Ada
Jika Anda sudah memiliki koneksi aktif dengan mitra dan ingin membangun jenis hubungan baru, Anda dapat mengirim undangan koneksi baru dengan jenis koneksi yang berbeda. Setelah diterima:
-
Jenis koneksi baru ditambahkan ke koneksi yang ada
-
Kedua jenis koneksi tetap dapat dikelola secara independen
-
ID koneksi yang sama dipertahankan untuk hubungan
catatan
Hanya dapat ada satu koneksi aktif dari jenis tertentu antara dua akun dalam katalog tertentu setiap saat.
Mengakhiri Jenis Koneksi
Salah satu pihak dapat menghentikan jenis koneksi tertentu menggunakan CancelConnection tindakan. Saat mengakhiri:
-
Tentukan ID koneksi dan jenis koneksi yang akan diakhiri
-
Berikan alasan penghentian
-
Status jenis koneksi berubah menjadi
CANCELED -
Jenis koneksi lain dalam koneksi yang sama tetap tidak terpengaruh
Penghentian Koneksi Lengkap
Ketika semua jenis koneksi dalam koneksi dihentikan, koneksi itu sendiri bertransisi ke status Terhenti. Koneksi yang sepenuhnya dihentikan:
-
Tidak dapat diaktifkan kembali, tetapi Anda dapat mengirim permintaan koneksi baru untuk melanjutkan bisnis dengan akun tersebut
-
Tetap dalam sistem untuk pencatatan sejarah
-
Dapat dilihat menggunakan
GetConnectionAPI -
Membutuhkan undangan baru untuk membangun kembali hubungan
Memantau Acara Koneksi
Mitra harus memantau peristiwa terkait koneksi menggunakan Amazon EventBridge untuk tetap mendapat informasi tentang:
-
Undangan koneksi masuk baru
-
Perubahan status untuk undangan terkirim (
ACCEPTED,REJECTED,EXPIRED) -
Penghentian koneksi yang diprakarsai oleh pihak lain
Setelah menerima acara, gunakan tindakan Get API yang sesuai untuk mengambil detail terbaru:
-
GetConnectionInvitationuntuk pembaruan undangan -
GetConnectionuntuk pembaruan koneksi
Kemungkinan Peristiwa
-
Undangan Koneksi Di buat: Memberi tahu akun penerima undangan koneksi masuk.
-
Undangan Koneksi Di batalkan: Memberi tahu akun penerima saat pengirim membatalkan undangan koneksi masuk.
-
Undangan Koneksi Kedaluwar sa: Memberi tahu akun pengirim dan penerima ketika undangan koneksi kedaluwarsa tanpa tindakan.
-
Undangan Koneksi Dit olak: Memberi tahu akun pengirim saat undangan koneksi ditolak oleh penerima.
-
Undangan Koneksi D iterima: Memberi tahu akun pengirim saat undangan koneksi diterima dan koneksi dibuat.
-
Koneksi Dibatalkan: Memberi tahu kedua pihak yang terhubung ketika semua koneksi sepenuhnya dihentikan.
Memahami Status Koneksi
Status Undangan Koneksi
| Status | Deskripsi | Dapat Transisi Ke |
|---|---|---|
PENDING |
Status awal saat dibuat; menunggu tindakan penerima | ACCEPTED, REJECTED, EXPIRED, CANCELED |
ACCEPTED |
Penerima diterima; koneksi dibuat | Tidak ada (status terminal) |
REJECTED |
Penerima ditolak; berisi alasan penolakan opsional | Tidak ada (status terminal) |
EXPIRED |
System-expired karena tidak ada tindakan dalam periode kedaluwarsa | Tidak ada (status terminal) |
CANCELED |
Pengirim menarik undangan sebelum diterima | Tidak ada (status terminal) |
Status Jenis Koneksi
| Status | Deskripsi |
|---|---|
ACCEPTED |
Jenis koneksi bersifat operasional; aktivitas bisnis terkait diaktifkan |
CANCELED |
Jenis koneksi diakhiri oleh salah satu pihak |
Praktik Terbaik
-
Komunikasi yang jelas: Ber ikan pesan terperinci dan jelas dalam undangan koneksi Anda yang menjelaskan tujuan dan kolaborasi yang diharapkan.
-
Tanggapan Tepat Waktu: Pan tau dan tanggapi undangan koneksi segera untuk menghindari kedaluwarsa otomatis.
-
Tinjauan Reg uler: Tinjau koneksi aktif Anda secara berkala untuk memastikan mereka tetap relevan dengan kebutuhan bisnis Anda saat ini.
-
Pengakhiran yang Tepat: Saat mengakhiri hubungan bisnis, gunakan CancelConnection tindakan dengan alasan yang jelas untuk mempertahankan komunikasi profesional.
-
Pemantauan Per istiwa: EventBridge Siapkan aturan untuk secara otomatis menerima pemberitahuan perubahan status koneksi, untuk membantu tetap mendapat informasi tentang pembaruan penting.
-
Manajemen Jenis Koneksi: Pertimbangkan jenis koneksi mana yang diperlukan sebelum membuat koneksi, karena setiap jenis memungkinkan kemampuan bisnis yang berbeda.
-
Kesadaran Keamanan: Ingatlah bahwa membuat koneksi mengungkapkan ID AWS akun antar pihak. Hanya terhubung dengan mitra tepercaya.
Jenis Koneksi dan Tujuannya
| Jenis Koneksi | Tujuan | Kasus Penggunaan |
|---|---|---|
OPPORTUNITY_COLLABORATION |
Memungkinkan kolaborasi pada peluang penjualan bersama dengan mitra lain | Jika Anda ingin mitra lain memiliki akses ke peluang Anda atau sebaliknya, gunakan jenis koneksi ini. Koneksi ini memungkinkan Anda mengirim undangan keterlibatan peluang ke mitra yang terhubung. |
SUBSIDIARY |
Menetapkan koneksi antara beberapa akun penjual AWS Marketplace dan akun Mitra utama Anda | Gunakan jika Anda memiliki beberapa AWS Akun Penjual Marketplace yang ingin Anda sambungkan ke akun utama tempat Anda terdaftar sebagai mitra dan penjual. |