AWS Partner Central API 참조가 재구성되었습니다. 지원되는 API 작업에 대한 자세한 내용은 [AWS Partner Central API 참조](https://docs.aws.amazon.com/partner-central/latest/APIReference/Welcome.html)를 참조하세요.

기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

# AWS Partner Central Benefits API용 샌드박스에서 테스트
<a name="testing-sandbox-benefits"></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": "BenefitsManagement",
               "Effect": "Allow",
               "Action": [
                   "partnercentral:ListBenefits",
                   "partnercentral:GetBenefit",
                   "partnercentral:CreateBenefitApplication",
                   "partnercentral:AmendBenefitApplication",
                   "partnercentral:UpdateBenefitApplication",
                   "partnercentral:SubmitBenefitApplication",
                   "partnercentral:GetBenefitApplication",
                   "partnercentral:CancelBenefitApplication",
                   "partnercentral:RecallBenefitApplication",
                   "partnercentral:ListBenefitApplications",
                   "partnercentral:AssociateBenefitApplicationResource",
                   "partnercentral:DisasssociateBenefitApplicationResource",
                   "partnercentral:ListBenefitAllocations",
                   "partnercentral:GetBenefitAllocation",
                   "partnercentral:TagResource",
                   "partnercentral:UntagResource",
                   "partnercentral:ListTagsForResource"
               ],
               "Resource": "*",
               "Condition": {
                   "StringEquals": {
                       "partnercentral:Catalog": [
                           "Sandbox"
                       ]
                   }
               }
           },
           {
               "Sid": "AWSPartnerOpportunityAccess",
               "Effect": "Allow",
               "Action": [
                   "partnercentral:GetAwsOpportunitySummary",
                   "partnercentral:GetOpportunity",
                   "partnercentral:ListOpportunities"
               ],
               "Resource": "*",
               "Condition": {
                   "StringEquals": {
                       "partnercentral:Catalog": [
                           "Sandbox"
                       ]
                   }
               }
           },
           {
               "Sid": "ListingAWSMarketplaceEntities",
               "Effect": "Allow",
               "Action": [
                   "aws-marketplace:ListEntities"
               ],
               "Resource": "*"
           },
           {
               "Sid": "AWSMarketplaceOffersAccess",
               "Effect": "Allow",
               "Action": [
                   "aws-marketplace:DescribeEntity"
               ],
   
               "Resource": [
                   "arn:aws:aws-marketplace:::AWSMarketplace/Offer/*"
               ]
           },
           {
               "Sid": "S3PutObjectAccess",
               "Effect": "Allow",
               "Action": [
                   "s3:PutObject"
               ],
               "Resource": ["arn:aws:s3:::aws-partner-central-marketplace-ephemeral-writeonly-files/*"]
           },
           {
               "Sid": "TaggingAccess",
               "Effect": "Allow",
               "Action": [
                   "partnercentral:TagResource",
                   "partnercentral:UntagResource",
                   "partnercentral:ListTagsForResource"
               ],
               "Resource": [
                   "arn:aws:partnercentral:us-east-1:*:catalog/Sandbox/benefit-application/*",
                   "arn:aws:partnercentral:us-east-1:*:catalog/Sandbox/benefit-allocation/*"
               ],
               "Condition": {
                   "StringEquals": {
                       "partnercentral:Catalog": [
                           "Sandbox"
                       ]
                   }
               }
           }
       ]
   }
   ```

1. IAM 역할 자격 증명 사용:

   솔루션에서이 IAM 역할의 자격 증명(보안 키 및 액세스 키)을 사용하여 API 작업을 수행합니다.

## AWS작업 테스트
<a name="testing-aws-actions"></a>

테스트 단계에서AWS는 작업을 시뮬레이션해야 하는 경우가 많습니다. 이 시뮬레이션을 통해 파트너는AWS서비스와의 통합에 대한 전체 end-to-end 흐름을 철저하게 테스트할 수 있습니다. 각 요청에는 데이터 환경을 결정하는 카탈로그 파라미터가 포함됩니다.

### 혜택 애플리케이션 생성 시뮬레이션
<a name="simulating-benefit-application"></a>

혜택 애플리케이션 생성을 시뮬레이션하려면 `CreateBenefitApplication` 작업의 페이로드에를 페이로드`"catalog": "Sandbox"`에 포함합니다.

예제:

```
{
  "Catalog": "Sandbox", 
  "ClientToken": "String", 
  "BenefitIdentifier": "String", 
  "FulfillmentTypes": ["String"],
  "BenefitApplicationDetails": JsonDocument,
  "Name": "String",
  "Description": "String",
  "Tags": [
    { 
      "Key": "string",
      "Value": "string"
    }
  ],
  "PartnerContacts": [ 
    { 
      "BusinessTitle": "string",
      "Email": "string",
      "FirstName": "string",
      "LastName": "string",
      "Phone": "string"
    }
  ],
  "FileDetails": [
    {
      "FileURI": "String", 
      "BusinessUseCase": "String"
    }
  ],
  "AssociatedResources": [
    {
      "ResourceType": "BENEFIT_ALLOCATION | OPPORTUNITY",
      "ResourceArn": "ARN"
    }
  ] 
}
```

## 추가 테스트 참고 사항
<a name="additional-testing-notes"></a>

1. 다른 작업을 테스트하려면 페이로드`"catalog": "Sandbox"`에서를 설정합니다.

1. 샌드박스 카탈로그와 AWS 카탈로그IDs는 다릅니다. 를 사용하여 `GetBenefit` API를 호출`"catalog": "Sandbox"`하여 샌드박스에서 혜택 식별자를 가져옵니다.

1. 샌드박스 카탈로그와 AWS 카탈로그의 혜택 할당은 다릅니다.

1. 프로덕션으로 이동하려면 카탈로그 값을에서 `Sandbox`로 변경합니다`AWS`.

## 샌드박스 환경에서 이벤트 테스트
<a name="testing-events"></a>

파트너는 샌드박스 환경의 이벤트를 사용하여 이벤트 기반 구현을 테스트할 수 있습니다. 이벤트 세부 정보에서를 지정하여 샌드박스 이벤트를 수신하도록 규칙을AWS 계정사용하여 동일한 `catalog: Sandbox`에 EventBridge를 설정합니다. 자세한 내용은 [AWS Partner Central Benefits API에 대한 알림](benefits-api-events.md) 단원을 참조하십시오.

이벤트 규칙의 예:

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

를 `catalog`로 지정하는 이벤트 규칙`Sandbox`은 샌드박스 환경에서 수행하는 작업에 의해 생성된 샌드박스에서 오는 이벤트와만 일치합니다.