View a markdown version of this page

使用合作伙伴账户连接 - AWS 合作伙伴中心
创建和发送连接邀请接收和回复连接邀请管理活动连接监控连接事件了解连接状态最佳实践连接类型及其用途

对 AWS 合作伙伴中心 API 参考进行了重组。有关支持的 API 操作的更多信息，请参阅 AWS 合作伙伴中心 API 参考。

本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

使用合作伙伴账户连接

合作伙伴可以使用合作伙伴连接 API 管理自己的账户之间的连接或与其他合作伙伴 AWS 账户的 AWS 连接。该过程包括两个阶段：

  1. 连接邀请阶段：启动和响应连接请求

  2. 活跃连接阶段：管理已建立的连接及其关联的业务活动

创建和发送连接邀请

步骤 1：创建连接邀请

建立合作伙伴连接的第一步是使用CreateConnectionInvitation操作创建和发送连接邀请。创建邀请时，必须指定：

  • 目录：用于管理连接的 AWS 目录（AWS 或沙盒）

  • ConnectionType：您要建立的关系类型。选择下列选项之一：

    • OPPORTUNITY_COLLABORATION：当您想要向其他合作伙伴的账户发送连接请求时，请使用此类型，这样您就可以向他们发送机会协作机会参与邀请

    • SUBSIDIARY：当您想将您拥有的多个 AWS 商城卖家账户与您与 APN 关联或注册为合作伙伴的 “主要” 账户关联时，请使用此类型

  • ReceiverIdentifier: 接收者的公共合作伙伴个人资料 ID（适用于机会协作连接类型）或 AWS 账户 ID（子公司连接类型）

  • 电子邮件：您的联系电子邮件地址，用于沟通

  • 姓名：你作为发件人的名字

  • 消息：解释连接请求目的的描述

创建后，邀请进入待处理状态，等待接收者的操作。

重要

发送连接邀请即表示您同意在接收者接受邀请时向他们透露您的 AWS 账户 ID。此披露对于建立账户级连接是必要的。

第 2 步：监控您发送的邀请

您可以使用ParticipantType参数设置为的ListConnectionInvitations操作来跟踪已发送邀请的状态SENDER。从而让您能够实现以下目的：

  • 查看所有发出的邀请

  • 按状态筛选 (PENDING,ACCEPTED,REJECTED,EXPIRED)

  • 按连接类型筛选

  • 查看向其他合作伙伴发出的具体邀请

第 3 步：取消邀请（可选）

如果您需要在待处理的邀请被接受之前撤回该邀请，则可以使用该CancelConnectionInvitation操作。请注意：

  • 您只能取消处于 “待处理” 状态的邀请

  • 一旦接受邀请并建立连接，就无法取消

  • 要终止已建立的连接，必须改用该CancelConnection操作

接收和回复连接邀请

第 1 步：列出收到的邀请

要查看您收到的连接邀请，请使用 ParticipantType 参数设置为的ListConnectionInvitations操作RECEIVER。您可以按以下条件筛选：

  • 连接类型

  • 状态 (PENDING,ACCEPTED,REJECTED)

  • 发件人的标识符

第 2 步：查看邀请详情

使用GetConnectionInvitation操作查看特定邀请的完整详细信息，包括：

  • 发件人的姓名和联系邮箱

  • 解释目的的邀请消息

  • 正在请求的连接类型

  • 到期日期

  • 发件人的公开个人资料信息

第 3 步：接受或拒绝邀请

查看邀请详细信息后，您有两种选择：

选项 A：接受邀请

使用AcceptConnectionInvitation操作建立连接。当你接受时：

  • 在 “活动” 状态下创建了一个新连接

  • 邀请的状态更改为 “已接受”

  • 您的 AWS 账户ID已显示给发件人

  • 您可以开始开展由连接类型启用的业务活动

重要

重要同意：接受连接邀请即表示您同意向发件人透露您的 AWS 账户 ID。此披露对于建立账户级连接是必要的。

选项 B：拒绝邀请

如果您不想建立连接，请使用该RejectConnectionInvitation操作。您可以选择提供拒绝的理由。一旦被拒绝：

  • 邀请的状态更改为 “已拒绝”

  • 未建立任何连接

  • 该邀请将不再出现在您的待处理邀请列表中

自动到期

如果在到期时间内未采取任何操作，系统会自动将邀请转换为 “已过期” 状态。过期的邀请无法接受或拒绝。

管理活动连接

查看您的连接

建立连接后，双方都可以使用以下操作查看和管理连接：

ListConnections: 使用筛选选项检索您的连接列表：

  • 按连接类型和状态筛选（例如，OPPORTUNITY_COLLABORATION:ACTIVE）

  • 按其他方的标识符过滤

  • 查看每个连接的摘要信息

GetConnection：检索特定连接的完整详细信息，包括：

  • 与此合作伙伴关系相关的所有连接类型

  • 每种连接类型的状态（活动或已终止）

  • 原始邀请中的联系信息

  • AWS 双方的账户 ID 和公开个人资料 ID

  • 每种连接类型的创建和终止时间戳

向现有连接添加连接类型

如果您已经与合作伙伴建立了活跃的连接并想建立一种新的关系类型，则可以使用不同的连接类型发送新的连接邀请。接受后：

  • 新的连接类型将添加到现有连接中

  • 两种连接类型均可独立管理

  • 关系保持相同的连接 ID

注意

在任何时候，给定目录中的两个账户之间只能有一个任何给定类型的活跃连接。

终止连接类型

任何一方都可以使用CancelConnection操作终止特定的连接类型。终止时：

  • 指定要终止的连接 ID 和连接类型

  • 提供终止理由

  • 连接类型的状态更改为 CANCELED

  • 同一连接中的其他连接类型不受影响

完全终止连接

当连接中的所有连接类型都终止时，连接本身会转换为 “已终止” 状态。完全终止的连接：

  • 无法重新激活，但您可以发送新的连接请求以继续使用该账户开展业务

  • 保留在系统中用于保存历史记录

  • 可以使用 GetConnection API 查看

  • 需要新的邀请才能重新建立关系

监控连接事件

合作伙伴应使用亚马逊监控与连接相关的事件， EventBridge 以随时了解以下情况：

  • 新的传入连接邀请

  • 已发送邀请的状态更改 (ACCEPTED,REJECTED,EXPIRED)

  • 另一方发起的连接终止

收到事件后，使用相应的 Get API 操作来获取最新的详细信息：

  • GetConnectionInvitation获取邀请更新

  • GetConnection用于连接更新

可能发生的事件

  • 连接邀请已创建：将收到的连接邀请通知收件人帐户。

  • 连接邀请已取消：当发件人取消传入的连接邀请时，通知收件人帐户。

  • 连接邀请已过期：当连接邀请过期而未采取任何操作时，通知发件人和收件人帐户。

  • 连接邀请被拒绝：当收件人拒绝连接邀请时，通知发件人账户。

  • 已接受连接邀请：当发件人的连接邀请被接受并建立连接时通知发件人账户。

  • 连接已取消：当所有连接完全终止时，通知连接的双方。

了解连接状态

连接邀请状态

州 说明 可以过渡到
PENDING 创建时的初始状态；等待接收器操作 ACCEPTED, REJECTED, EXPIRED, CANCELED
ACCEPTED 接收方已接受；连接已创建 无（终端状态）
REJECTED 收件人已拒绝；包含可选的拒绝原因 无（终端状态）
EXPIRED System-expired 由于在到期期内没有采取任何行动 无（终端状态）
CANCELED 发件人在接受之前撤回了邀请 无（终端状态）

连接类型状态

州 说明
ACCEPTED 连接类型处于运行状态；关联业务活动已启用
CANCELED 连接类型由任何一方结束

最佳实践

  1. 清晰的沟通：在连接邀请中提供详细、清晰的信息，解释目的和预期的合作。

  2. 及时响应：及时监控和回复连接邀请，以避免自动过期。

  3. 定期审查：定期审查您的活跃连接，确保它们与您当前的业务需求保持相关性。

  4. 正确终止：终止业务关系时，使用有明确理由的 CancelConnection 行动来保持专业沟通。

  5. 事件监控：设置 EventBridge 规则以自动接收连接状态更改通知，以帮助随时了解重要更新。

  6. 连接类型管理：在建立连接之前考虑需要哪些连接类型，因为每种类型支持不同的业务功能。

  7. 安全意识：请记住，建立连接会显示各方之间的 AWS 账户 ID。仅与值得信赖的合作伙伴建立联系。

连接类型及其用途

连接类型 用途 使用场景
OPPORTUNITY_COLLABORATION 支持与其他合作伙伴就共同销售机会进行合作 如果您希望其他合作伙伴有机会获得您的机会，反之亦然，请使用此连接类型。此连接允许您向关联的合作伙伴发送机会参与邀请。
SUBSIDIARY 在您的多个 AWS 商城卖家账户和您的主要合作伙伴账户之间建立连接 当您有多个 AWS 商城卖家账户想要连接到注册为合作伙伴和卖家的主账户时使用。