AWS 合作夥伴中心 API 參考已重組。如需支援的 API 操作的詳細資訊，請參閱 [AWS 合作夥伴中心 API 參考](https://docs.aws.amazon.com/partner-central/latest/APIReference/Welcome.html)。

本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# 在沙盒中測試AWS Partner Central Channel API
<a name="testing-sandbox-channel"></a>

沙盒中的帳戶不符合頻道利益的資格，而且無法針對所有計劃需求進行驗證。

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

若要使用沙盒，請完成下列步驟：

1. 建立 IAM 角色：

   在與您的AWS Partner Central 帳戶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動作
<a name="testing-aws-actions"></a>

在測試階段，通常需要模擬AWS動作。此模擬可讓合作夥伴徹底測試其與AWS服務整合的完整end-to-end流程。每個請求都包含目錄參數，決定資料環境。

### 模擬建立程式管理帳戶
<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>

合作夥伴可以使用沙盒環境的事件，以協助測試事件型實作。AWS 帳戶使用規則在相同的 中設定 EventBridge，透過在事件詳細資訊`catalog: Sandbox`中指定 來接聽沙盒事件。如需詳細資訊，請參閱[AWS Partner Central Channel API 的通知](channel-api-events.md)。

範例事件規則：

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

指定 `catalog` 為 的事件規則`Sandbox`只會比對來自沙盒的事件，這些事件是由您在沙盒環境中執行的動作所產生。

## 取得說明
<a name="getting-help"></a>

如果您在測試時遇到挑戰，或者如果您需要測試此處未涵蓋的特定案例，請透過下列步驟提出案例來尋求支援：

1. 使用您的 [AWS Partner Network 登入資料登入 Partner Central](https://partnercentral.awspartner.com/)。AWS

1. 在 [Partner Central 支援中心](https://partnercentral.awspartner.com/support)上，選擇`Open New Case`記錄新案例。如下所示完成欄位：

   1. 支援案例類型： `Channel Program`

   1. 有關下列項目的問題： `General Program Inquiry`

   1. 取得特定：選取最適合的頻道案例類型。

   1. 主旨：包含請求的簡短描述。

   1. 描述：提供問題、問題、錯誤和故障診斷步驟的詳細說明。

   1. 附件：適用時包含日誌和螢幕擷取畫面。