View a markdown version of this page

Testando em uma caixa de areia para o AWS API de benefícios do Partner Central - AWS Central de Parceiros
Como usar o sandboxTeste AWS actionsNotas de teste adicionaisEventos de teste no ambiente sandbox

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.

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

Como usar o sandbox

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.

  2. 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.

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

  3. 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

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

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

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

  2. 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.

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

  4. Para passar para a produção, altere o valor do catálogo de Sandbox paraAWS.

Eventos de teste no ambiente sandbox

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.

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.