对 AWS 合作伙伴中心 API 参考进行了重组。有关支持的 API 操作的更多信息，请参阅 [AWS 合作伙伴中心 API 参考](https://docs.aws.amazon.com/partner-central/latest/APIReference/Welcome.html)。
本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。
# 利用多合作伙伴机会
AWS PartnerAWS作为一个积极的参与者，可以共同寻找机会。
**Topics**
+ [互动和快照](#engagements-and-snapshots)
+ [为创建自定义策略 ResourceSnapshotJobRole](#creating-custom-policy-resourcesnapshotjobrole)
+ [邀请合作伙伴抓住机会](#inviting-partners-to-an-opportunity)
+ [检索参与邀请详情](#retrieving-invitation-details)
+ [回复订婚邀请](#responding-engagement-invitation)
+ [查看和更新多合作伙伴机会](#reviewing-and-updating-multipartner-opportunities)
+ [使用快照接收合作伙伴最新消息](#using-snapshots-to-receive-partner-updates)
+ [查看参与成员](#viewing-engagement-members)
+ [监控资源快照任务状态](#monitoring-resource-snapshot-job-status)
## 互动和快照
*交互是指*多个AWS Partner客户之间以及AWS针对客户机会进行协作而AWS拥有的一种资源。互动促进了合作伙伴之间的安全信息共享和协作，同时保持了个人机会的所有权和控制权。参与包括来自双方AWS和合作伙伴的机会，并以积极参与者的AWS身份出现。合作伙伴可以使用邀请AWS或其他合作伙伴加入互动`EngagementInvitations`。当被邀请的合作伙伴接受时，他们将在同一个参与中获得自己的机会。
参与成员通过快照共享进度，快照是来自基础资源（例如机会）的特定字段的不可变副本。快照是在互动中创建的，并与成员共享。当底层资源发生变化时，所有者可以创建新的快照修订版以反映更新。AWS提供快照作业，即客户拥有的作业，可在资源更改时自动创建新的修订版。共享后，参与成员仍可永久访问快照。
## 为创建自定义策略 ResourceSnapshotJobRole
合作开发多合作伙伴机会需要与项目中的其他合作伙伴共享您的机会快照。要保持对最新机会详细信息的访问权限，您需要创建一个名为的自定义角色`ResourceSnapshotJobRole`。此角色允许系统代表您创建机会的快照，并从同一项目中的其他合作伙伴那里检索快照。如果没有这个角色，参与活动的其他合作伙伴将无法看到您对机会所做的任何更新，他们将继续看到您的机会数据的过时快照。
**注意**
你可以使用除之外的名称`ResourceSnapshotJobRole`。如果您使用其他名称，请用您的策略名称替换以下策略`ResourceSnapshotJobRole`中的所有实例。
要创建此角色，请转到您的 IAM 控制台并使用以下自定义信任策略创建该`ResourceSnapshotJobRole`角色：
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Principal": {
"Service": "resource-snapshot-job.partnercentral-selling.amazonaws.com"
},
"Action": "sts:AssumeRole"
}
]
}
```
------
创建此角色后，您需要附加[AWSPartnerCentralSellingResourceSnapshotJobExecutionRolePolicy](https://docs.aws.amazon.com/aws-managed-policy/latest/reference/AWSPartnerCentralSellingResourceSnapshotJobExecutionRolePolicy.html)AWS托管策略或附加以下权限策略：
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Action": [
"partnercentral:CreateResourceSnapshot"
],
"Resource": [
"arn:aws:partnercentral:*::catalog/AWS/engagement/*"
]
},
{
"Effect": "Allow",
"Action": [
"partnercentral:GetOpportunity"
],
"Resource": [
"arn:aws:partnercentral:*:{{111122223333}}:catalog/AWS/opportunity/*"
]
}
]
}
```
------
将 `{account}` 替换为您的 Amazon Web Services account ID。
创建`ResourceSnapshotJobRole`角色并附加权限后，您需要为组织`ResourceSnapshotJobRole`进行设置。使用[PutSellingSystemSettings](https://docs.aws.amazon.com/partner-central/latest/APIReference/API_PutSellingSystemSettings.html)操作将您创建的角色设置`ResourceSnapshotJobRole`为公司的角色（由您的AWS账户标识）：
```
aws-cli/2.13.5 Python/3.11.4 Linux/4.14.255-314-253.539.amzn2.x86_64
Host: partner-central.aws.amazon.com
Content-Type: application/json
{
"ResourceSnapshotJobRoleIdentifier": "arn:aws:iam::{account}:role/ResourceSnapshotJobRole"
}
```
`{account}`替换为您的AWS账户 ID `ResourceSnapshotJobRole` 和您创建的角色名称。资源快照任务将隐含地担任此角色，以访问您的机会并创建快照，以便与项目中的其他合作伙伴共享。
## 邀请合作伙伴抓住机会
合作伙伴可以就来自双方的机会进行协作，也可以AWS发起参与邀请。您最多可以邀请九位合作伙伴参与一个机会。
**邀请合作伙伴抓住机会**
1. 按照《合作伙伴*中心销售指南*》中的 “[寻找合作伙伴并与之建立联系](https://docs.aws.amazon.com/partner-central/latest/sales-guide/partner-connections.html#finding-partners)”AWS中的步骤进行操作。您必须先与合作伙伴建立联系，然后才能邀请他们参与机会。此连接允许相互访问彼此的账户 ID，从而确保邀请到达目标合作伙伴账户。
1. 使用[StartEngagementFromOpportunityTask](https://docs.aws.amazon.com/partner-central/latest/APIReference/API_StartEngagementFromOpportunityTask.html)操作创建交互并将机会与之关联。此异步操作按顺序执行以下任务：
1. 创建互动。
1. 将机会与参与联系起来。
1. 调用该动[CreateEngagementInvitation](https://docs.aws.amazon.com/partner-central/latest/APIReference/API_CreateEngagementInvitation.html)作。AWS
1. 将机会提交给AWS。
1. 启动`ResourceSnapshotJob`以创建快照。
1. 邀请其他合作伙伴加入。
1. 要获取与您的机会关联的互动 ID，请使用按上一步`TaskIdentifier`返回的[ListEngagementFromOpportunityTasks](https://docs.aws.amazon.com/partner-central/latest/APIReference/API_ListEngagementFromOpportunityTasks.html)操作进行筛选。
1. 使用接收合作伙伴的参与 ID 和账户 ID 向发送邀请`CreateEngagementInvitation`。
成功的邀请会向接收的合作伙伴发送参与邀请创建的事件。
## 检索参与邀请详情
当您收到互动邀请创建的活动时，请使用[GetEngagementInvitation](https://docs.aws.amazon.com/partner-central/latest/APIReference/API_GetEngagementInvitation.html)操作来检索邀请的详细信息。回复包括与该项目相关的客户机会的基本信息。
查看邀请详情，特别是`InvitationMessage`、`Project.Title``Project.CustomerUseCase`、和`Project.CustomerBusinessProblem`字段。这些信息提供了有关客户机会和邀请合作伙伴对合作的期望的背景信息。
使用这些详细信息来评估您是否想通过接受或拒绝参与邀请来抓住机会。
## 回复订婚邀请
当合作伙伴向您发送参与邀请时，它会创建一个创建互动邀请的事件，通知您该邀请。您可以选择接受或拒绝邀请。此决定决定了您是否参与多合作伙伴机会。
**要拒绝订婚邀请，请执行以下操作：**
使用[RejectEngagementInvitation](https://docs.aws.amazon.com/partner-central/latest/APIReference/API_RejectEngagementInvitation.html)操作拒绝邀请。您必须提供一个`RejectionReason`参数来解释您的决定。一旦被拒绝，您将无法访问邀请的详细信息，而参与邀请被拒绝的事件会通知发送合作伙伴您已拒绝他们的邀请。
**要接受订婚邀请，请执行以下操作：**
要接受邀请并继续使用多合作伙伴机会，请使用[StartEngagementByAcceptingInvitationTask](https://docs.aws.amazon.com/partner-central/latest/APIReference/API_StartEngagementByAcceptingInvitationTask.html)操作。此异步操作按顺序执行以下任务：
1. 接受订婚邀请。
1. 使用来自发送合作伙伴机会的数据，在您的合作伙伴账户中创建新商机。您将收到一个机会创建的活动。
1. 包括识别您账户中的客户所需的其他详细信息。
1. 发布已接受参与邀请的事件，通知合作伙伴您已接受邀请并已添加到互动中。
**订婚邀请已过期**
如果您未在十五天内回复参与邀请，则该邀请将过期，并且您无法参与多合作伙伴机会。参与邀请过期事件会通知发送合作伙伴邀请已过期。
**注意**
如果您仍想协作，则发送方合作伙伴必须发起新的参与邀请。
## 查看和更新多合作伙伴机会
当合作伙伴就机会发起互动时，接收合作伙伴账户中新创建的机会的审核状态由发送合作伙伴的机会状态决定。
**评论状态为已提交的机会：**
如果发送伙伴的机会`Lifecycle.ReviewStatus`设置为`Submitted`，则会发生以下过程：
1. 在接收合作伙伴的账户中创建的新机会将`Lifecycle.ReviewStatus`设置为`Submitted`。
1. 该`Submitted`状态将保持不变，直到发送伙伴有机会为止`Approved`。
1. 一旦发送合作伙伴的机会得到验证并设置`Lifecycle.ReviewStatus`为`Approved`，其他合作伙伴的机会将自动继承该`Approved`状态。
此流程可确保多合作伙伴机会的商机详情保持一致，无需进行多次审查。
完成后，将使用相应的商机 ID 触发商机创建事件。合作伙伴可以在`GetOpportunity`操作中使用此 ID 来检索完整的机会详情。
**审核状态为已批准的机会：**
如果发送方合作伙伴针对`Lifecycle.ReviewStatus`设置为的商机发起互动`Approved`，则会发生以下过程：
1. 在接收合作伙伴的账户中创建的新机会将`Lifecycle.ReviewStatus`设置为`Approved`。
1. 使用相应的商机 ID 触发商机创建事件。
1. 合作伙伴可以使用带有商机 ID 的[GetOpportunity](https://docs.aws.amazon.com/partner-central/latest/APIReference/API_GetOpportunity.html)操作来检索完整的机会详情。
但是，已批准的机会中可能没有一些未从发送合作伙伴的机会中复制的特定于合作伙伴的详细信息。当机会阶段更新到`Qualified`或更晚阶段时，接收合作伙伴应使用[UpdateOpportunity](https://docs.aws.amazon.com/partner-central/latest/APIReference/API_UpdateOpportunity.html)操作来更新这些详细信息：
+ `Project.CustomerUseCase`
+ `Project.DeliveryModels`
+ `Solution`
+ `PrimaryNeedsFromAws`
+ `LifeCycle.TargetCloseDate`
+ `Project.ExpectedCustomerSpend.Amount`
+ `Project.ExpectedCustomerSpend.Currency`
+ `Marketing.source`
+ `Marketing.AwsFundingUsed`
一旦在接收合作伙伴的账户中创建了机会，就可以像合作伙伴系统中的任何其他机会一样对其进行管理和更新。合作伙伴可以利用该[UpdateOpportunity](https://docs.aws.amazon.com/partner-central/latest/APIReference/API_UpdateOpportunity.html)操作进行更改或提供有关其参与机会的更多信息。
## 使用快照接收合作伙伴最新消息
在项目中，合作伙伴独立维护和更新其机会。当有人修改项目资源（例如添加机会）时，系统会发布一个创建的互动资源快照事件。
要随时了解变化并从其他合作伙伴的机会中获取最新信息，您可以使用以下操作：
+ [ListEngagementResourceAssociations](https://docs.aws.amazon.com/partner-central/latest/APIReference/API_ListEngagementResourceAssociations.html)— 使用此操作检索与机会关联的参与 ID。
+ [ListResourceSnapshots](https://docs.aws.amazon.com/partner-central/latest/APIReference/API_ListResourceSnapshots.html)— 使用此操作可检索与该项目相关的所有机会快照的完整列表，从而概述所有合作伙伴的可用快照。
+ [GetResourceSnapshot](https://docs.aws.amazon.com/partner-central/latest/APIReference/API_GetResourceSnapshot.html)— 使用此操作可获取特定机会快照的实时摘要，从而无需直接访问其他合作伙伴的机会即可查看最新信息。
如果您发现其他合作伙伴机会的相关更改或更新应反映在您自己的机会中，请使用[UpdateOpportunity](https://docs.aws.amazon.com/partner-central/latest/APIReference/API_UpdateOpportunity.html)操作。此操作有助于有选择地将相关数据整合到您的机会中，从而确保整个项目的一致性和一致性。
## 查看参与成员
参与多合作伙伴机会最多可以有十个合作伙伴。每当新的合作伙伴接受参与邀请时，就会发布参与成员添加的活动，通知所有当前成员有关变更的信息。
要查看参与中所有成员的协作，请按照以下步骤操作：
1. 使用[ListEngagementResourceAssociations](https://docs.aws.amazon.com/partner-central/latest/APIReference/API_ListEngagementResourceAssociations.html)操作检索与机会关联的互动 ID。
1. 提供从步骤 1 到[ListEngagementMembers](https://docs.aws.amazon.com/partner-central/latest/APIReference/API_ListEngagementMembers.html)操作的 ID，以获取参与成员的合作伙伴详细信息。
**注意**
只有参与的成员才能调用该`ListEngagementMembers`操作。
## 监控资源快照任务状态
在处理多合作伙伴机会时，您必须创建一个角色，允许您为其他合作伙伴创建机会快照，并从参与中其他合作伙伴那里检索机会快照。如果没有这个角色，您对机会所做的任何更新都将无法提供给参与该项目的其他合作伙伴，他们将继续看到您的机会的过时快照。
要跟踪与项目中的多合作伙伴商机相关的资源快照任务的状态，请按照以下步骤操作：
1. 使用[ListEngagementResourceAssociations](https://docs.aws.amazon.com/partner-central/latest/APIReference/API_ListEngagementResourceAssociations.html)操作检索与机会关联的互动 ID。
1. 提供从步骤 1 到[ListResourceSnapshotJobs](https://docs.aws.amazon.com/partner-central/latest/APIReference/API_ListResourceSnapshotJobs.html)操作的 ID，以生成项目中来电者拥有的所有快照任务的列表。从响应中检索任务 ID。
1. 向[GetResourceSnapshotJob](https://docs.aws.amazon.com/partner-central/latest/APIReference/API_GetResourceSnapshotJob.html)操作提供作业 ID 以跟踪任务状态并查看其是否正在运行。
该`ResourceSnapshotJob`操作向 Amazon 发布其异步操作 CloudWatch 的指标。 CloudWatch 将数据处理成可读的近乎实时的指标，以帮助您监控服务的性能和运行状况。
可供使用的指标如下：
+ **故障**-计算作业执行期间的内部问题。使用此指标来监控服务稳定性并设置故障阈值警报。
+ **错误**-跟踪任务处理期间与客户相关的问题。该指标有助于识别客户输入或配置存在的问题。
+ **调用-表示任务调用的**总数，包括成功和失败的尝试。使用它来跟踪一段时间内的服务使用趋势。
**注意**
CloudWatch 仅当`ResourceSnapshotJob`服务中有活动时，才会向其报告指标。如果没有任务或没有特定指标的数据，则不会报告该指标。
为确保操作顺利进行：`ResourceSnapshotJob`
+ 使用这些指标来验证服务是否按预期执行。
+ 创建 CloudWatch 警报以监控指标，并在指标超过可接受范围时触发操作（例如发送通知）。
+ 设置主动监控以识别和解决问题。
有关使用 CloudWatch 指标的更多信息，请参阅 [Amazon CloudWatch 用户指南](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/)。