View a markdown version of this page

Bekerja dengan Koneksi Akun Mitra - AWS Pusat Partner

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:

  1. Fase Undangan Koneksi: Memulai dan menanggapi permintaan koneksi

  2. 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 CancelConnection tindakan 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 GetConnection API

  • 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

  1. Komunikasi yang jelas: Ber ikan pesan terperinci dan jelas dalam undangan koneksi Anda yang menjelaskan tujuan dan kolaborasi yang diharapkan.

  2. Tanggapan Tepat Waktu: Pan tau dan tanggapi undangan koneksi segera untuk menghindari kedaluwarsa otomatis.

  3. Tinjauan Reg uler: Tinjau koneksi aktif Anda secara berkala untuk memastikan mereka tetap relevan dengan kebutuhan bisnis Anda saat ini.

  4. Pengakhiran yang Tepat: Saat mengakhiri hubungan bisnis, gunakan CancelConnection tindakan dengan alasan yang jelas untuk mempertahankan komunikasi profesional.

  5. Pemantauan Per istiwa: EventBridge Siapkan aturan untuk secara otomatis menerima pemberitahuan perubahan status koneksi, untuk membantu tetap mendapat informasi tentang pembaruan penting.

  6. Manajemen Jenis Koneksi: Pertimbangkan jenis koneksi mana yang diperlukan sebelum membuat koneksi, karena setiap jenis memungkinkan kemampuan bisnis yang berbeda.

  7. 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.