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

Registrando o AWS API de conta do Partner Central

AWS CloudTrailé um serviço que permite governança, conformidade, auditoria operacional e auditoria de risco de seu.Conta da AWS Com AWS CloudTrail, você pode registrar, monitorar continuamente e reter as atividades da conta relacionadas às ações em toda a sua AWS infraestrutura.AWS A atividade da API da conta do Partner Central é registrada como eventos em CloudTrail. Você pode criar uma trilha, uma configuração que permite a entrega de eventos como arquivos de log para um bucket do Amazon S3.

Visão geral do

A API de conta do AWS Partner Central está integrada com AWS CloudTrail, um serviço que fornece um registro das ações realizadas por um usuário, função ou AWS serviço no AWS Partner Central. CloudTrail captura todas as chamadas de API para a API da conta do AWS Partner Central como eventos. As chamadas capturadas incluem chamadas do AWS Partner Central e de chamadas de código para as operações da API da conta do AWS Partner Central.

Se você criar uma trilha, poderá habilitar a entrega contínua de CloudTrail eventos para um bucket do Amazon S3, incluindo eventos para a API de contas do AWS Partner Central. Se você não configurar uma trilha, ainda poderá ver os eventos mais recentes no CloudTrail console no Histórico de eventos.

Usando as informações coletadas por CloudTrail, você pode determinar a solicitação feita à API da Conta do AWS Partner Central, o endereço IP do qual a solicitação foi feita, quem fez a solicitação, quando ela foi feita e detalhes adicionais.

Noções básicas AWS Entradas do arquivo de log da Partner Central Account API

Uma trilha é uma configuração que permite a entrega de eventos como arquivos de log para um bucket do Amazon S3. Quando sua trilha acompanha os eventos da API da Conta do AWS Partner Central, CloudTrail processa os eventos como arquivos de log em todas as regiões. Cada arquivo de log pode conter um ou mais eventos.

O exemplo a seguir mostra uma entrada de CloudTrail registro que demonstra a CreatePartner ação na API de conta do AWS Partner Central:

{
    "eventVersion": "1.11",
    "userIdentity": {
        "type": "IAMUser",
        "principalId": "EX_PRINCIPAL_ID",
        "arn": "arn:aws:iam::123456789012:user/CloudTrailTestUser",
        "accountId": "123456789012",
        "accessKeyId": "ABCDEFGHIJKLMNOP1234",
        "sessionContext": {
            "sessionIssuer": {
                "type": "Role",
                "principalId": "AROAEXAMPLE52AGFT725JGDZ",
                "arn": "arn:aws:iam::123456789012:role/ExampleRole",
                "accountId": "123456789012",
                "userName": "ExampleRole"
            },
            "attributes": {
                "creationDate": "2025-11-07T19:45:28Z",
                "mfaAuthenticated": "false"
            }
        }
    },
    "eventTime": "2025-11-07T19:45:58Z",
    "eventSource": "partnercentral-account.amazonaws.com",
    "eventName": "CreatePartner",
    "awsRegion": "us-east-1",
    "sourceIPAddress": "127.0.0.1",
    "userAgent": "PostmanRuntime/7.18.0",
    "requestParameters": {
        "catalog": "AWS",
        "clientToken": "abcdef12-3456-7890-bcde-f123456789ab",
        "legalName": "ExampleLegalName",
        "primarySolutionType": "VALUE_ADDED_RESALE_AWS_SERVICES",
        "allianceLeadContact": {
            "firstName": "ExampleFirstName",
            "lastName": "ExampleLastName",
            "email": "example@domain.com",
            "businessTitle": "ExampleBusinessTitle"
        },
        "emailVerificationCode": "ExampleVerificationCode",
        "tags": [
            {
                "key": "office",
                "value": "1"
            }
        ]
    },
    "responseElements": {
        "catalog": "AWS",
        "arn": "arn:aws:partnercentral:us-east-1:123456789012:catalog/AWS/partner/EXAMPLE_PARTNER_ID",
        "id": "EXAMPLE_PARTNER_ID",
        "legalName": "ExampleLegalName",
        "createdAt": "2025-11-07T19:45:57.867007329Z",
        "profile": {
            "primarySolutionType": "VALUE_ADDED_RESALE_AWS_SERVICES"
        },
        "allianceLeadContact": {
            "firstName": "ExampleFirstName",
            "lastName": "ExampleLastName",
            "email": "example@domain.com",
            "businessTitle": "ExampleBusinessTitle"
        }
    },
    "requestID": "12345678-1234-5678-9abc-def012345678",
    "eventID": "87654321-4321-8765-cba9-fed098765432",
    "readOnly": false,
    "resources": [
        {
            "accountId": "123456789012",
            "type": "AWS::PartnerCentral::Partner",
            "ARN": "arn:aws:partnercentral:us-east-1:123456789012:catalog/AWS/partner/EXAMPLE_PARTNER_ID"
        }
    ],
    "eventType": "AwsApiCall",
    "managementEvent": true,
    "recipientAccountId": "123456789012",
    "eventCategory": "Management",
    "tlsDetails": {
        "tlsVersion": "TLSv1.3",
        "cipherSuite": "TLS_AES_128_GCM_SHA256",
        "clientProvidedHostHeader": "partnercentral-account.partner.us-east-1.api.aws"
    }
}

Neste exemplo, a CreatePartner ação foi chamada pelo usuário do IAM chamado CloudTrailTestUser. A solicitação foi feita em 7 de novembro de 2025 às 19:45:58 UTC. A solicitação criou um novo parceiro com ID EXAMPLE_PARTNER_ID para o catálogo da AWS com o nome legal "ExampleLegalName”.

Campos em AWS Entradas do arquivo de log da Partner Central Account API

Cada entrada em um arquivo de CloudTrail log contém informações sobre quem fez uma solicitação, os recursos utilizados na solicitação e os elementos de resposta retornados pela API de conta do AWS Partner Central. A lista de campos em uma entrada de registro, como eventVersionuserIdentity, eeventTime, fornece informações detalhadas sobre a ação. Por exemplo, o sourceIPAddress campo mostra o endereço IP do qual a solicitação foi feita.