View a markdown version of this page

Bekerja dengan Koneksi Akun Mitra - AWS Pusat Partner
Membuat dan Mengirim Undangan KoneksiMenerima dan Menanggapi Undangan KoneksiMengelola Koneksi AktifMemantau Acara KoneksiMemahami Negara KoneksiPraktik TerbaikJenis Koneksi dan Tujuannya

Referensi AWS Partner Central API direstrukturisasi. Untuk informasi selengkapnya tentang operasi API yang didukung, lihat Referensi AWS Partner Central 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 mapan dan aktivitas 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 ketika Anda ingin menghubungkan beberapa akun penjual AWS Marketplace yang Anda miliki ke akun “utama” yang telah Anda tautkan dengan APN atau di mana Anda terdaftar sebagai Mitra

  • ReceiverIdentifier: ID profil mitra publik penerima (untuk jenis koneksi Opportunity Collaboration) 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 Pending, menunggu tindakan dari penerima.

penting

Dengan mengirimkan undangan koneksi, Anda setuju untuk mengungkapkan ID AWS akun Anda kepada penerima jika mereka menerima undangan tersebut. Pengungkapan ini diperlukan untuk membangun koneksi tingkat akun.

Langkah 2: Pantau Undangan Anda yang Terkirim

Anda dapat melacak status undangan yang Anda kirim menggunakan ListConnectionInvitations tindakan dengan ParticipantType parameter yang disetel ke. SENDER 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 dibuat, Anda harus menggunakan CancelConnection tindakan sebagai gantinya

Menerima dan Menanggapi Undangan Koneksi

Langkah 1: Daftar Undangan Masuk

Untuk melihat undangan koneksi yang Anda terima, gunakan ListConnectionInvitations tindakan dengan ParticipantType parameter yang disetel ke. RECEIVER Anda dapat memfilter berdasarkan:

  • Tipe koneksi

  • Status (PENDING,ACCEPTED,REJECTED)

  • Pengenal 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 tujuan

  • Jenis koneksi yang diminta

  • Tanggal kedaluwarsa

  • Informasi profil publik pengirim

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 status 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 muncul lagi di daftar undangan yang tertunda

Kedaluwarsa Otomatis

Jika tidak ada tindakan yang diambil dalam periode kedaluwarsa, sistem secara otomatis mentransisikan 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 dan status koneksi (mis.,OPPORTUNITY_COLLABORATION:ACTIVE)

  • Filter menurut pengenal 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 Terminasi)

  • Informasi kontak dari undangan asli

  • AWS ID akun dan ID profil publik kedua belah pihak

  • Cap waktu pembuatan dan penghentian untuk setiap jenis koneksi

Menambahkan Jenis Koneksi ke Koneksi yang Ada

Jika Anda sudah memiliki koneksi aktif dengan pasangan 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 ada satu koneksi aktif dari jenis tertentu antara dua akun dalam katalog tertentu kapan saja.

Mengakhiri Jenis Koneksi

Salah satu pihak dapat mengakhiri jenis koneksi tertentu menggunakan CancelConnection tindakan. Saat mengakhiri:

  • Tentukan ID koneksi dan jenis koneksi yang akan dihentikan

  • Berikan alasan untuk penghentian

  • Status jenis koneksi berubah menjadi CANCELED

  • Jenis koneksi lain dalam koneksi yang sama tetap tidak terpengaruh

Terminasi Koneksi Lengkap

Ketika semua jenis koneksi dalam koneksi dihentikan, koneksi itu sendiri bertransisi ke status Terminated. Koneksi yang sepenuhnya terputus:

  • Tidak dapat diaktifkan kembali, tetapi Anda dapat mengirim permintaan koneksi baru untuk melanjutkan bisnis dengan akun itu

  • 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 agar tetap mendapat informasi tentang:

  • Undangan koneksi masuk baru

  • Perubahan status undangan terkirim (ACCEPTED,,REJECTED) EXPIRED

  • Pengakhiran 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 Dibuat: Memberi tahu akun penerima undangan koneksi masuk.

  • Undangan Koneksi Dibatalkan: Memberi tahu akun penerima saat pengirim membatalkan undangan koneksi masuk.

  • Undangan Koneksi Kedaluwarsa: Memberi tahu akun pengirim dan penerima saat undangan koneksi kedaluwarsa tanpa tindakan.

  • Undangan Koneksi Ditolak: Memberi tahu akun pengirim ketika undangan koneksi mereka ditolak oleh penerima.

  • Undangan Koneksi Diterima: Memberi tahu akun pengirim ketika undangan koneksi mereka diterima dan koneksi dibuat.

  • Koneksi Dibatalkan: Memberi tahu kedua pihak yang terhubung saat semua koneksi terputus sepenuhnya.

Memahami Negara Koneksi

Negara Undangan Koneksi

Status Deskripsi Bisa 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)

Negara Jenis Koneksi

Status Deskripsi
ACCEPTED Jenis koneksi operasional; kegiatan bisnis terkait diaktifkan
CANCELED Jenis koneksi diakhiri oleh salah satu pihak

Praktik Terbaik

  1. Clear Communication: Berikan pesan terperinci dan jelas dalam undangan koneksi Anda yang menjelaskan tujuan dan kolaborasi yang diharapkan.

  2. Respons Tepat Waktu: Pantau dan tanggapi undangan koneksi dengan segera untuk menghindari kedaluwarsa otomatis.

  3. Tinjauan Reguler: Tinjau koneksi aktif Anda secara berkala untuk memastikannya tetap relevan dengan kebutuhan bisnis Anda saat ini.

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

  5. Pemantauan Acara: Siapkan EventBridge 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 dalam peluang penjualan bersama dengan mitra lain Bila 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 Anda dan akun Mitra utama Anda Gunakan saat Anda memiliki beberapa Akun Penjual AWS Marketplace yang ingin Anda sambungkan ke akun utama tempat Anda terdaftar sebagai mitra dan penjual.