A referência Central de Parceiros da AWS da API foi reestruturada. Para obter mais informações sobre as operações de API suportadas, consulte a [Referência Central de Parceiros da AWS da API](https://docs.aws.amazon.com/partner-central/latest/APIReference/Welcome.html).

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

# Testando em uma caixa de areia para o AWS API de benefícios do Partner Central
<a name="testing-sandbox-benefits"></a>

## Como usar o sandbox
<a name="use-sandbox"></a>

Para usar o sandbox, conclua as seguintes etapas:

1. Crie uma função do IAM:

   Crie uma função do IAM Conta da AWS vinculada à sua conta do AWS Partner Central.

1. Atribuir política:

   Atribua a política a seguir à função do IAM. Para obter mais informações, consulte [Adicionar e remover permissões de identidade do 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. Use as credenciais da função do IAM:

   Use as credenciais (chave secreta e chave de acesso) dessa função do IAM em sua solução para realizar as ações da API.

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

Durante a fase de teste, muitas vezes é necessário simular AWS ações. Essa simulação permite que os parceiros testem minuciosamente o fluxo completo de sua integração com AWS os serviços. Cada solicitação inclui um parâmetro de catálogo, que determina o ambiente de dados.

### Simulando a criação de um aplicativo de benefícios
<a name="simulating-benefit-application"></a>

Para simular a criação de um aplicativo de benefícios, na carga útil da `CreateBenefitApplication` ação, inclua `"catalog": "Sandbox"` na carga útil.

Por exemplo:

```
{
  "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"
    }
  ] 
}
```

## Notas de teste adicionais
<a name="additional-testing-notes"></a>

1. Para testar outras ações, defina `"catalog": "Sandbox"` a carga útil.

1. Os IDs de benefícios no catálogo Sandbox e no catálogo da AWS são diferentes. Faça uma chamada de `GetBenefit` API com `"catalog": "Sandbox"` para obter o Identificador de Benefícios na Sandbox.

1. A alocação de benefícios no catálogo Sandbox e no catálogo da AWS é diferente.

1. Para passar para a produção, altere o valor do catálogo de `Sandbox` para`AWS`.

## Eventos de teste no ambiente sandbox
<a name="testing-events"></a>

Os parceiros podem consumir eventos do ambiente sandbox para ajudar a testar as implementações baseadas em eventos. Configure EventBridge o mesmo Conta da AWS com regras para ouvir eventos de sandbox especificando `catalog: Sandbox` nos detalhes do evento. Para obter mais informações, consulte [Notificações para o AWS API de benefícios do Partner Central](benefits-api-events.md).

Exemplo de regra de evento:

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

As regras de eventos que especificam `catalog` como `Sandbox` corresponderão somente aos eventos provenientes do sandbox, gerados pelas ações que você executa no ambiente sandbox.