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

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

# 在沙箱中测试AWS合作伙伴中心渠道 API
<a name="testing-sandbox-channel"></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)。

   ```
   {
     "Version": "2012-10-17",		 	 	 
     "Statement": [
       {
         "Sid": "ChannelManagement",
         "Effect": "Allow",
         "Action": [
           "partnercentral:CreateProgramManagementAccount",
           "partnercentral:UpdateProgramManagementAccount",
           "partnercentral:DeleteProgramManagementAccount",
           "partnercentral:ListProgramManagementAccounts",
           "partnercentral:GetProgramManagementAccount",
           "partnercentral:CreateRelationship",
           "partnercentral:UpdateRelationship",
           "partnercentral:DeleteRelationship",
           "partnercentral:GetRelationship",
           "partnercentral:ListRelationships",
           "partnercentral:CreateChannelHandshake",
           "partnercentral:AcceptChannelHandshake",
           "partnercentral:RejectChannelHandshake",
           "partnercentral:CancelChannelHandshake",
           "partnercentral:ListChannelHandshakes"
         ],
         "Resource": "*",
         "Condition": {
           "StringEquals": {
             "partnercentral:Catalog": [
               "Sandbox"
             ]
           }
         }
       },
       {
         "Sid": "TaggingAccess",
         "Effect": "Allow",
         "Action": [
           "partnercentral:TagResource",
           "partnercentral:UntagResource",
           "partnercentral:ListTagsForResource"
         ],
         "Resource": [
           "arn:aws:partnercentral:*:*:catalog/Sandbox/program-management-account/*",
           "arn:aws:partnercentral:*:*:catalog/Sandbox/channel-handshake/*"
         ],
         "Condition": {
           "StringEquals": {
             "partnercentral:Catalog": [
               "Sandbox"
             ]
           }
         }
       }
     ]
   }
   ```

1. 使用 IAM 角色证书：

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

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

在测试阶段，通常需要模拟AWS动作。该模拟使合作伙伴能够全面测试其与AWS服务集成的完整端到端流程。每个请求都包含一个用于确定数据环境的目录参数。

### 模拟项目管理账户的创建
<a name="simulating-pma"></a>

要模拟程序管理帐户的创建，请在`CreateProgramManagementAccount`操作的有效载荷`"catalog": "Sandbox"`中包含在有效载荷中。

例如：

```
{
  "catalog": "Sandbox",
  "accountId": "123456789012",
  "displayName": "Test PMA Name",
  "clientToken": "123abc456def789ghi",
  "program": "SOLUTION_PROVIDER",
  "tags": [
    {
      "key": "testkey",
      "value": "testvalue"
    }
  ]
}
```

### 模拟关系的更新
<a name="simulate-relationship-updates"></a>

要模拟关系的更新，请在负载`"catalog": "Sandbox"`中使用带的`UpdateRelationship`操作。

例如：

```
{
  "catalog": "Sandbox",
  "displayName": "Updated Test PMA",
  "identifier": "rs-abc123def456g",
  "programManagementAccountIdentifier": "pma-123abc456def7"
}
```

## 其他测试说明
<a name="additional-testing-notes"></a>

1. 要测试其他操作，请在有效载荷`"catalog": "Sandbox"`中进行设置。

1. 要移至生产环境，请将目录值从更改`Sandbox`为`AWS`。

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

合作伙伴可以使用沙盒环境中的事件，以帮助测试基于事件的实现。通过 EventBridge 在事件详细信息中指定来设置监听沙盒事件`catalog: Sandbox`的规则。AWS 账户有关更多信息，请参阅 [的通知AWS合作伙伴中心渠道 API](channel-api-events.md)。

事件规则示例：

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

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

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

如果您在测试中遇到挑战，或者需要测试此处未涵盖的特定场景，请通过以下步骤提出案例来寻求支持：

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

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

   1. 支持案例类型：`Channel Program`

   1. 关于以下的问题：`General Program Inquiry`

   1. 具体说明：选择最合适的渠道案例类型。

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

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

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