View a markdown version of this page

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

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：列出收到的邀请

要查看您收到的连接邀请，请使用 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 查看

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

监视连接事件

合作伙伴应使用 Amazon 监控与连接相关的事件 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 Marketplace 卖家账户和您的主要合作伙伴账户之间建立连接 当您有多个AWS Marketplace 卖家账户想要关联到注册为合作伙伴和卖家的主账户时使用。