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

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

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

## 如何使用沙盒
<a name="prm-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": "RevenueMeasurementCreation",
               "Effect": "Allow",
               "Action": [
                   "partnercentral:CreateRevenueAttribution",
                   "partnercentral:CreateMarketplaceRevenueShare",
                   "partnercentral:CreateMarketplaceRevenueShareAllocation"
               ],
               "Resource": "*",
               "Condition": {
                   "StringEquals": {
                       "partnercentral:Catalog": [
                           "Sandbox"
                       ]
                   }
               }
           },
           {
               "Sid": "RevenueMeasurementListing",
               "Effect": "Allow",
               "Action": [
                   "partnercentral:ListRevenueAttributions",
                   "partnercentral:ListRevenueAttributionAllocations",
                   "partnercentral:ListMarketplaceRevenueShares",
                   "partnercentral:ListMarketplaceRevenueShareAllocations"
               ],
               "Resource": "*",
               "Condition": {
                   "StringEquals": {
                       "partnercentral:Catalog": [
                           "Sandbox"
                       ]
                   }
               }
           },
           {
               "Sid": "RevenueAttributionManagement",
               "Effect": "Allow",
               "Action": [
                   "partnercentral:GetRevenueAttribution",
                   "partnercentral:UpdateRevenueAttribution",
                   "partnercentral:GetRevenueAttributionAllocation",
                   "partnercentral:StartRevenueAttributionAllocationsTask",
                   "partnercentral:GetRevenueAttributionAllocationsTask"
               ],
               "Resource": "arn:aws:partnercentral:*:*:catalog/Sandbox/revenue-attribution/*",
               "Condition": {
                   "StringEquals": {
                       "partnercentral:Catalog": [
                           "Sandbox"
                       ]
                   }
               }
           },
           {
               "Sid": "MarketplaceRevenueShareManagement",
               "Effect": "Allow",
               "Action": [
                   "partnercentral:GetMarketplaceRevenueShare",
                   "partnercentral:GetMarketplaceRevenueShareAllocation",
                   "partnercentral:UpdateMarketplaceRevenueShareAllocation"
               ],
               "Resource": "arn:aws:partnercentral:*:*:catalog/Sandbox/marketplace-revenue-share/*",
               "Condition": {
                   "StringEquals": {
                       "partnercentral:Catalog": [
                           "Sandbox"
                       ]
                   }
               }
           },
           {
               "Sid": "TaggingAccess",
               "Effect": "Allow",
               "Action": [
                   "partnercentral:TagResource",
                   "partnercentral:UntagResource",
                   "partnercentral:ListTagsForResource"
               ],
               "Resource": [
                   "arn:aws:partnercentral:*:*:catalog/Sandbox/revenue-attribution/*",
                   "arn:aws:partnercentral:*:*:catalog/Sandbox/marketplace-revenue-share/*"
               ],
               "Condition": {
                   "StringEquals": {
                       "partnercentral:Catalog": [
                           "Sandbox"
                       ]
                   }
               }
           },
           {
               "Sid": "OpportunityAccess",
               "Effect": "Allow",
               "Action": [
                   "partnercentral:ListOpportunities",
                   "partnercentral:GetOpportunity"
               ],
               "Resource": "*",
               "Condition": {
                   "StringEquals": {
                       "partnercentral:Catalog": [
                           "Sandbox"
                       ]
                   }
               }
           },
           {
               "Sid": "ListingAWSMarketplaceEntities",
               "Effect": "Allow",
               "Action": [
                   "aws-marketplace:ListEntities"
               ],
               "Resource": "*"
           },
           {
               "Sid": "AWSMarketplaceEntityAccess",
               "Effect": "Allow",
               "Action": [
                   "aws-marketplace:DescribeEntity"
               ],
               "Resource": [
                   "arn:aws:aws-marketplace:*:*:AWSMarketplace*/Offer/*"
               ]
           }
       ]
   }
   ```

1. 使用 IAM 角色登入資料：

   在您的解決方案中使用此 IAM 角色的登入資料 （私密金鑰和存取金鑰） 來執行 API 動作。

## 測試AWS動作
<a name="prm-testing-aws-actions"></a>

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

### 模擬營收歸因 ID 的建立
<a name="simulating-revenue-attribution-creation"></a>

若要模擬建立營收歸因 ID，請在 `CreateRevenueAttribution`動作的承載中，將 包含在承載`"Catalog": "Sandbox"`中。

例如：

```
{
  "Catalog": "Sandbox",
  "ClientToken": "String",
  "Name": "String",
  "Description": "String",
  "TenancyModel": "MULTI_TENANT | SINGLE_TENANT",
  "ProductIdentifier": "String",
  "Tags": [
    {
      "Key": "String",
      "Value": "String"
    }
  ]
}
```

## 其他測試備註
<a name="prm-additional-testing-notes"></a>

1. 若要測試其他動作，請在承載`"Catalog": "Sandbox"`中設定 。

1. 若要移至生產環境，請將目錄值從 `Sandbox`變更為 `AWS`。