View a markdown version of this page

Probando en una caja de arena para AWS API de beneficios de Partner Central - AWS Centro de socios
Cómo utilizar el sandboxTesteo AWS actionsNotas adicionales sobre las pruebasProbar eventos en el entorno sandbox

Se reestructuró la referencia de la Centro de socios de AWS API. Para obtener más información sobre las operaciones de API compatibles, consulta la referencia de la Centro de socios de AWS API.

Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

Probando en una caja de arena para AWS API de beneficios de Partner Central

Cómo utilizar el sandbox

Para usar la caja de arena, complete los siguientes pasos:

  1. Cree un rol de IAM:

    Cree un rol de IAM en la cuenta Cuenta de AWS vinculada a su cuenta de AWS Partner Central.

  2. Política de asignación:

    Asigne la siguiente política a la función de IAM. Para obtener más información, consulte Añadir y eliminar permisos de identidad de 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. Utilice las credenciales del rol de IAM:

    Utilice las credenciales (clave secreta y clave de acceso) de este rol de IAM en su solución para realizar las acciones de la API.

Testeo AWS actions

Durante la fase de pruebas, a menudo es necesario simular AWS acciones. Esta simulación permite a los socios probar exhaustivamente el flujo completo de principio a fin de su integración con AWS los servicios. Cada solicitud incluye un parámetro de catálogo, que determina el entorno de datos.

Simulación de la creación de una solicitud de prestaciones

Para simular la creación de una solicitud de prestaciones, inclúyala en la carga útil de la CreateBenefitApplication acción. "catalog": "Sandbox"

Por ejemplo:

{
  "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 adicionales sobre las pruebas

  1. Para probar otras acciones, configura "catalog": "Sandbox" la carga útil.

  2. Los ID de beneficios del catálogo de Sandbox y del catálogo de AWS son diferentes. Realice una llamada a la GetBenefit API "catalog": "Sandbox" para obtener el identificador de beneficios en Sandbox.

  3. La asignación de beneficios en el catálogo Sandbox y en el catálogo de AWS es diferente.

  4. Para pasar a producción, cambie el valor del catálogo de Sandbox aAWS.

Probar eventos en el entorno sandbox

Los socios pueden consumir los eventos del entorno sandbox para ayudar a probar las implementaciones basadas en eventos. EventBridge Configúrelo del mismo modo Cuenta de AWS con reglas para detectar los eventos de entorno aislado especificando catalog: Sandbox los detalles del evento. Para obtener más información, consulte Notificaciones para el AWS API de beneficios de Partner Central.

Ejemplo de regla de evento:

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

Las reglas de eventos que especifican catalog como Sandbox solo coincidirán con los eventos que provengan del entorno de prueba, generados por las acciones que realices en el entorno de espacio aislado.