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

在測試階段，通常需要模擬AWS動作。此模擬可讓合作夥伴徹底測試其與AWS服務整合的完整end-to-end流程。

### 模擬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”`中使用 `UpdateOpportunity`動作搭配 `"Catalog": "Sandbox"`和 `Lifecycle.ReviewStatus: “Approved”`或 。

 如果您要從 `GetOpportunity`動作取得承載來執行更新，請確定您將 ID 變更為 `Identifier`，並移除下列欄位：
+ `CreatedDate`
+ `OpportunityTeam`
+ `RelatedEntityIdentifiers`

例如：

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

## 在沙盒環境中測試事件
<a name="testing-events"></a>

合作夥伴可以從沙盒環境中取用機會事件，以協助測試事件型實作。AWS 帳戶使用規則在相同的 中設定 EventBridge，透過在事件詳細資訊`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 與 整合的挑戰AWS，或者如果您需要測試此處未涵蓋的特定案例，請透過下列步驟提出案例來尋求支援：

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

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

   1. 支援案例類型：`AWS Partner Central`。

   1. 有關 的問題：`Partner Central Tools or ACE leads and opportunities`。

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

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

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

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