对 AWS 合作伙伴中心 API 参考进行了重组。有关支持的 API 操作的更多信息，请参阅 [AWS 合作伙伴中心 API 参考](https://docs.aws.amazon.com/partner-central/latest/APIReference/Welcome.html)。

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

# 在沙箱中测试AWS Partner Central Selling API
<a name="testing-sandbox"></a>

## 如何使用沙箱
<a name="use-sandbox"></a>

1. 创建一个 IAM 角色：

   在与您的AWS合作伙伴中心账户AWS 账户关联的 IAM 角色中创建。

1. 分配策略：

   将以下策略分配给 IAM 角色。有关更多信息，请参阅[添加和删除 IAM 身份权限](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies_manage-attach-detach.html)。

------
#### [ JSON ]

****  

   ```
   {
       "Version":"2012-10-17",		 	 	 
       "Statement": [
           {
               "Effect": "Allow",
               "Action": [
                   "partnercentral:CreateOpportunity",
                   "partnercentral:UpdateOpportunity",
                   "partnercentral:ListOpportunities",
                   "partnercentral:GetOpportunity",
                   "partnercentral:GetAwsOpportunitySummary",
                   "partnercentral:ListSolutions",
                   "partnercentral:AssociateOpportunity",
                   "partnercentral:DisassociateOpportunity",
                   "partnercentral:AssignOpportunity",
                   "partnercentral:SubmitOpportunity",
                   "partnercentral:AcceptEngagementInvitation",
                   "partnercentral:CreateEngagementInvitation",
                   "partnercentral:RejectEngagementInvitation",
                   "partnercentral:GetEngagementInvitation",
                   "partnercentral:ListEngagementInvitations",
                   "partnercentral:StartEngagementFromOpportunityTask",
                   "partnercentral:StartEngagementByAcceptingInvitationTask",
                   "partnercentral:CreateResourceSnapshotJob",
                   "partnercentral:StartResourceSnapshotJob",
                   "partnercentral:CreateEngagement"
               ],
               "Resource": "*",
               "Condition": {
                   "StringEquals": {
                       "partnercentral:Catalog": "Sandbox"
                   }
               }
           },
           {
               "Effect": "Allow",
               "Action": [
                   "aws-marketplace:ListEntities",
                   "aws-marketplace:DescribeEntity"
               ],
               "Resource": "*"
           },
           {
               "Effect": "Allow",
               "Action": [
                   "aws-marketplace:SearchAgreements",
                   "aws-marketplace:DescribeAgreement"
               ],
               "Resource": "*",
               "Condition": {
                   "StringEquals": {
                       "aws-marketplace:PartyType": "Proposer"
                   }
               }
           }
       ]
   }
   ```

------

1. 使用 IAM 角色证书：

   在您的解决方案中使用此 IAM 角色的证书（私有密钥和访问密钥）来执行 API 操作。

## 测试AWS actions
<a name="testing-aws-actions"></a>

在测试阶段，通常需要模拟AWS动作。该模拟使合作伙伴能够全面测试其与AWS服务集成的完整端到端流程。

### 模拟创建AWS起源机会
<a name="simulating"></a>

要模拟AWS产生机会的创建，请在`CreateOpportunity`操作的有效载荷中包括`"Catalog": "Sandbox"`和`"Origin": "AWS Referral"`。

例如：

```
{
    "Catalog": "Sandbox",
    "Origin": "AWS Referral",
    "OpportunityIdentifier": "O123456",
    "Title": "Test Opportunity",
    ...
}
```

### 模拟合作伙伴发起的机会的更新
<a name="simulate-updates"></a>

要模拟合作伙伴发起的机会的更新或其他操作，请在有效载荷`“Action Required”`中使用带`"Catalog": "Sandbox"`和`Lifecycle.ReviewStatus: “Approved”`或的`UpdateOpportunity`操作。

 如果您要使用`GetOpportunity`操作中的有效负载进行更新，请确保将 ID 更改为`Identifier`，然后移除以下字段：
+ `CreatedDate`
+ `OpportunityTeam`
+ `RelatedEntityIdentifiers`

例如：

```
{
    "Catalog": "Sandbox",
    "Identifier": "O123456",
    "Title": "Updated Test Opportunity",
    "Lifecycle": {
        "ReviewStatus": "Approved"
    }
    ...
}
```

## 在沙盒环境中测试事件
<a name="testing-events"></a>

合作伙伴可以利用沙盒环境中的机会事件来帮助测试基于事件的实施。通过 EventBridge 在事件详细信息中指定来设置AWS 账户与监听沙盒事件`catalog: sandbox`的规则相同。有关更多信息，请参阅 [的通知AWS Partner Central Selling API](selling-api-events.md)。

事件规则示例：

```
{
    "source": ["aws.partnercentral-selling"],
    "detail": {
        "catalog": ["Sandbox"] 
    }
}
```

指定`catalog`为的事件规则`Sandbox`将仅匹配来自沙箱的事件，这些事件是由您在沙盒环境中执行的操作生成的。

## 其他测试注意事项
<a name="additional-testing-notes"></a>

1. 测试`AssociateOpportunity`操作：

   1. 使用默认解决方案`"S-1234567"`来测试`AssociateOpportunity`操作。

   1. 要测试 Marketplace 报价，请使用您账户中的真实报价 ID。

1. 要移至生产，请将`catalog`值从更改`Sandbox`为`AWS`。

## 获取帮助
<a name="getting-help"></a>

如果您在将 CRM 与 CRM 集成时遇到困难AWS，或者需要测试此处未涵盖的特定场景，请通过以下步骤提出案例来寻求支持：

1. 使用您的[AWS合作伙伴网络凭据登录AWS合作伙伴中心](https://partnercentral.awspartner.com/)。

1. 在[合作伙伴中心的 Supp](https://partnercentral.awspartner.com/support) ort Center 上`Open New Case`，选择记录新案例。完成字段，如下所示：

   1. 支持案例的类型:`AWS Partner Central`.

   1. 有关的问题:`Partner Central Tools or ACE leads and opportunities`.

   1. 具体说明：选择最合适的 CRM 集成案例类型。

   1. 主题：包括对请求的简要描述。

   1. 描述：提供问题、问题、错误和故障排除步骤的详细描述。

   1. 附件：包括日志和屏幕截图（如果适用）。