View a markdown version of this page

使用合作夥伴帳戶連線 - AWS Partner Central
建立和傳送連線邀請接收和回應連線邀請管理作用中連線監控連線事件了解連線狀態最佳實務連線類型及其目的

AWS 合作夥伴中心 API 參考已重組。如需支援的 API 操作的詳細資訊，請參閱 AWS 合作夥伴中心 API 參考。

本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

使用合作夥伴帳戶連線

合作夥伴可以使用 Partner Connection API AWS管理他們自己的帳戶之間的連線，或與其他合作夥伴AWS帳戶的連線。此程序包含兩個階段：

  1. 連線邀請階段：啟動和回應連線請求

  2. 作用中連線階段：管理已建立的連線及其相關聯的業務活動

建立和傳送連線邀請

步驟 1：建立連線邀請

建立合作夥伴連線的第一步是使用 CreateConnectionInvitation動作建立和傳送連線邀請。建立邀請時，您必須指定：

  • 目錄：將管理連線的目錄AWS(AWS或沙盒）

  • ConnectionType：您要建立的關係類型。選擇下列其中一項：

    • OPPORTUNITY_COLLABORATION：當您想要將連線請求傳送至其他合作夥伴的帳戶時，請使用此類型，以便您可以向他們傳送機會參與邀請以進行機會協作

    • SUBSIDIARY：當您想要將您擁有的多個AWS Marketplace 賣方帳戶連接到您已與 APN 連結或您註冊為合作夥伴的「主要」帳戶時，請使用此類型

  • ReceiverIdentifier：接收者的公有合作夥伴設定檔 ID （適用於機會協作連線類型） 或AWS帳戶 ID （適用於次要連線類型）

  • 電子郵件：您的通訊聯絡人電子郵件地址

  • 名稱：您做為寄件者的名稱

  • 訊息：說明連線請求用途的說明

建立時，邀請會進入待定狀態，等待來自接收者的動作。

重要

透過傳送連線邀請，即表示您同意在接收者接受邀請時向他們公開AWS您的帳戶 ID。此揭露對於建立帳戶層級連線是必要的。

步驟 2：監控您傳送的邀請

您可以使用 ParticipantType 參數設為 ListConnectionInvitations的動作，追蹤您已傳送的邀請狀態SENDER。這可讓您：

  • 檢視所有傳出邀請

  • 依狀態 (PENDING、ACCEPTED、REJECTED、EXPIRED) 篩選

  • 依連線類型篩選

  • 檢查對其他合作夥伴的特定邀請

步驟 3：取消邀請 （選用）

如果您需要在邀請被接受之前撤銷待定的邀請，您可以使用 CancelConnectionInvitation動作。請注意：

  • 您只能取消處於待定狀態的邀請

  • 接受邀請並建立連線後，就無法取消該邀請

  • 若要結束已建立的連線，您必須改用 CancelConnection動作

接收和回應連線邀請

步驟 1：列出傳入邀請

若要檢視您收到的連線邀請，請使用 ListConnectionInvitations動作，並將 ParticipantType 參數設為 RECEIVER。您可以依下列條件篩選：

  • 連線類型

  • 狀態 (PENDING、ACCEPTED、REJECTED)

  • 寄件者的識別符

步驟 2：檢閱邀請詳細資訊

使用 GetConnectionInvitation動作來檢視特定邀請的完整詳細資訊，包括：

  • 寄件者名稱和聯絡人電子郵件

  • 解釋目的的邀請訊息

  • 正在請求的連線類型

  • 過期日期

  • 寄件者的公有設定檔資訊

步驟 3：接受或拒絕邀請

檢閱邀請詳細資訊後，您有兩個選項：

選項 A：接受邀請

使用 AcceptConnectionInvitation動作來建立連線。當您接受時：

  • 在作用中狀態下建立新的連線

  • 邀請的狀態變更為已接受

  • AWS您的帳戶 ID 會向寄件者公開

  • 您可以開始執行連線類型啟用的業務活動

重要

重要同意：接受連線邀請，即表示您同意向寄件者公開AWS您的帳戶 ID。此揭露對於建立帳戶層級連線是必要的。

選項 B：拒絕邀請

如果您不想建立連線，請使用 RejectConnectionInvitation動作。您可以選擇性地提供拒絕的原因。拒絕後：

  • 邀請的狀態變更為已拒絕

  • 未建立連線

  • 邀請將不再出現在您的待定邀請清單中

自動過期

如果在過期期間內未採取任何動作，系統會自動將邀請轉換為過期狀態。無法接受或拒絕過期的邀請。

管理作用中連線

檢視您的連線

建立連線後，雙方可以使用下列動作來檢視和管理連線：

ListConnections：使用篩選選項擷取連線清單：

  • 依連線類型和狀態篩選 （例如 OPPORTUNITY_COLLABORATION:ACTIVE)

  • 依其他方的識別符篩選

  • 檢視每個連線的摘要資訊

GetConnection：擷取特定連線的完整詳細資訊，包括：

  • 與此合作夥伴關係相關聯的所有連線類型

  • 每個連線類型的狀態 （作用中或已終止）

  • 來自原始邀請的聯絡資訊

  • AWS雙方的帳戶 IDs 和公開設定檔 IDs

  • 每個連線類型的建立和終止時間戳記

將連線類型新增至現有連線

如果您已與合作夥伴建立作用中的連線，並且想要建立新的關係類型，您可以傳送具有不同連線類型的新連線邀請。接受時：

  • 新的連線類型會新增至現有的連線

  • 這兩種連線類型都可以獨立管理

  • 關係會維持相同的連線 ID

注意

在任何時間，指定目錄中的兩個帳戶之間只能有一個指定類型的作用中連線。

終止連線類型

任一方都可以使用 CancelConnection動作終止特定連線類型。終止時：

  • 指定要終止的連線 ID 和連線類型

  • 提供終止的原因

  • 連線類型的狀態變更為 CANCELED

  • 相同連線中的其他連線類型不會受到影響

完成連線終止

當連線中的所有連線類型終止時，連線本身會轉換為已終止狀態。完全終止的連線：

  • 無法重新啟用，但您可以傳送新的連線請求，以繼續與該帳戶進行業務

  • 保留在系統中以保留歷史記錄

  • 可以使用 GetConnection API 檢視

  • 需要新的邀請才能重新建立關係

監控連線事件

合作夥伴應使用 Amazon EventBridge 監控連線相關事件，以隨時掌握下列事項：

  • 新的傳入連線邀請

  • 已傳送邀請的狀態變更 (ACCEPTED、REJECTED、EXPIRED)

  • 由另一方啟動的連線終止

收到事件時，請使用適當的取得 API 動作來擷取最新詳細資訊：

  • GetConnectionInvitation 邀請更新

  • GetConnection 用於連線更新

可能的事件

  • 已建立連線邀請：通知收件人帳戶傳入連線邀請。

  • 已取消連線邀請：當寄件者取消傳入連線邀請時，通知收件人帳戶。

  • 連線邀請已過期：當連線邀請過期而不採取動作時，通知寄件者和收件人帳戶。

  • 連線邀請遭拒：當收件人拒絕其連線邀請時，通知寄件者帳戶。

  • 已接受連線邀請：當寄件者帳戶接受連線邀請並建立連線時， 會通知寄件者帳戶。

  • 連線已取消：當所有連線完全終止時，通知兩個連線方。

了解連線狀態

連線邀請狀態

State 說明 可以轉換為
PENDING 建立時的初始狀態；等待接收者動作 ACCEPTED, REJECTED, EXPIRED, CANCELED
ACCEPTED 接受收件人；已建立連線 無 （終端狀態）
REJECTED 收件人拒絕；包含選用拒絕原因 無 （終端狀態）
EXPIRED 由於過期期間內沒有動作而導致系統過期 無 （終端狀態）
CANCELED 寄件者在接受之前撤回邀請 無 （終端狀態）

連線類型狀態

State 說明
ACCEPTED 連線類型可運作；相關的商業活動已啟用
CANCELED 任一方結束的連線類型

最佳實務

  1. 明確溝通：在連線邀請中提供詳細且明確的訊息，以說明目的和預期的協同合作。

  2. 及時回應：立即監控和回應連線邀請，以避免自動過期。

  3. 定期審查：定期審查您的作用中連線，以確保其與您目前的業務需求保持相關。

  4. 適當終止：結束商業關係時，請使用 CancelConnection 動作，並清楚說明維持專業溝通的原因。

  5. 事件監控：設定 EventBridge 規則以自動接收連線狀態變更的通知，以協助隨時掌握重要的更新。

  6. 連線類型管理：在建立連線之前，請考慮需要哪些連線類型，因為每種類型都啟用不同的業務功能。

  7. 安全意識：請記住，建立連線會在各方之間顯示AWS帳戶 IDs。僅與信任的合作夥伴連線。

連線類型及其目的

連線類型 用途 使用案例
OPPORTUNITY_COLLABORATION 啟用與其他合作夥伴共同銷售機會的協作 如果您希望其他合作夥伴能夠存取您的機會，反之亦然，請使用此連線類型。此連線可讓您傳送機會參與邀請給連線的合作夥伴。
SUBSIDIARY 在您的多個AWS Marketplace 賣方帳戶與主要合作夥伴帳戶之間建立連線 當您有多個AWS Marketplace Seller 帳戶想要連線到您註冊為合作夥伴和賣方的主要帳戶時，請使用 。