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

Notificações para o AWS API de conta do Partner Central

As notificações de conexão da conta do parceiro permitem que os parceiros se mantenham informados sobre os eventos do ciclo de vida da conexão que afetam diretamente seus relacionamentos comerciais e fluxos de trabalho operacionais. Esses eventos são essenciais para que os parceiros:

Preencha o pré-requisito para monitorar eventos

Os usuários precisam das permissões apropriadas do IAM para acessar e gerenciar eventos publicados pela API de conexões da conta. Para obter mais informações sobre as ações, os recursos e as chaves de condição disponíveis para EventBridge, consulte Usando as condições da política do IAM na Amazon EventBridge no Guia EventBridge do usuário da Amazon. Uma das chaves de condição éevents:detail-type, que pode ser usada para definir permissões para tipos específicos de eventos.

O exemplo de política a seguir demonstra como personalizar e definir o escopo das permissões para os eventos propostos. A AllowPutRuleForPartnercentralAccountEvents declaração permite a criação de regras, mas somente para eventos da aws.partnercentral-account fonte.

Para exemplos detalhados de políticas do IAM, consulte a documentação da AWS sobre EventBridge permissões.

{
  "Version": "2012-10-17",
  "Statement": [
    {
      "Sid": "AllowPutRuleForPartnerCentralAccountEvents",
      "Effect": "Allow",
      "Action": "events:PutRule",
      "Resource": "*",
      "Condition": {
        "StringEquals": {
          "events:source": "aws.partnercentral-account.connection"
        }
      }
    }
  ]
}

Configure EventBridge a Amazon para monitorar eventos

Para monitorar os eventos da API de conexões da conta, você cria uma EventBridge regra que corresponde aos eventos que você deseja capturar. Você pode usar o AWS Management Console ou os AWS SDKs para criar e gerenciar regras. As seções a seguir explicam como criar regras usando os dois métodos. Independentemente do método usado, você deve criar a regra na us-east-1 região Leste dos EUA (Norte da Virgínia).

AWS Management Console configuração

Para configurar uma EventBridge regra usando o AWS Management Console, siga as etapas em Criação de regras que reagem a eventos na Amazon EventBridge no Guia EventBridge do usuário da Amazon. Ao criar a regra, você deve definir o barramento de eventos como padrão e criar a regra na us-east-1 região Leste dos EUA (Norte da Virgínia).

Veja a seguir um exemplo de uma regra de evento:

{
    "source": ["aws.partnercentral-account"],
    "detail": {
        "catalog": ["AWS"]
    }
}

AWS Configuração do SDK

Você pode usar os AWS SDKs para criar e gerenciar EventBridge regras de forma programática. Para obter mais informações, consulte PutRulea Amazon EventBridge API Reference.

O exemplo a seguir usa o AWS SDK para Python (Boto3):

import boto3

client = boto3.client('events', region_name='us-east-1')

response = client.put_rule(
    Name='MyConnectionInvitationReceivedRule',
    EventPattern=
    '{
        "source": ["aws.partnercentral-account"], 
        "detail-type": ["Partner Connection Invitation Received"], 
        "detail": {"catalog": ["AWS"]}
    }',
    State='ENABLED'
)
print('Rule ARN:', response['RuleArn'])

Saiba mais sobre eventos da API de conexões de contas

As seções a seguir descrevem os tipos de eventos da API de conexões de conta, os cenários que os acionam e os exemplos de eventos.

Tipos de eventos

A seguir estão os tipos de eventos e seus gatilhos.

Eventos de exemplo

As seções a seguir fornecem exemplos dos eventos listados anteriormente na seção anterior.

Convite de conexão de parceiro recebido

Contexto de acionamento

Esse evento é gerado quando um convite de conexão é criado e mantido com sucesso no armazenamento de dados do PAC por meio da CreateConnectionInvitation API. O evento é enviado imediatamente após a conclusão bem-sucedida da criação do convite e persiste no armazenamento de dados do PAC, não apenas quando a chamada da API é feita.

O evento será enviado automaticamente quando um novo convite de conexão for criado. Um evento por convite criado sem eventos duplicados para o mesmo convite.

Destinatários

A AWS conta do destinatário no convite de conexão.

Tratamento esperado

Ações típicas do cliente:

Padrões comuns de integração:

Exemplo

{
  "version": "1",
  "id": "<event id>",
  "detail-type": "Partner Connection Invitation Received",
  "source": "aws.partnercentral-account",
  "time": "<ISO 8601 date time>",
  "region": "us-east-1",
  "account": "<corresponding partner AWS account>",
  "resources": [ "<<Connection Invitation ARN>>" ],
  "detail": {
    "catalog": "AWS",
    "connectionInvitation" :{
        "arn": "<<Connection Invitation ARN>>",
        "id": "pacinv-****",
        "connectionType": "OpportunityCollaboration",
        "inviterEmail": "abc@def.com",
        "invitationMessage": "We'd like to collaborate on a joint solution for cloud security. Please accept this connection invitation to proceed.",
        "senderCompanyName": "<<Sender Partner Account Name>>",
        "senderProfileId": "pprofile-****",
        "expiresAt": "<ISO 8601 date time>"
    }
  }
}

Convite de conexão de parceiro aceito

Contexto de acionamento

Esse evento é gerado quando um convite de conexão é aceito com sucesso e uma conexão é criada e mantida no armazenamento de dados do PAC por meio da AcceptConnectionInvitation API. O evento é enviado imediatamente após a conclusão bem-sucedida da aceitação do convite e o estabelecimento da conexão.

O evento será enviado automaticamente quando um convite de conexão for aceito. Aceito um evento por convite, sem eventos duplicados para a mesma aceitação.

Destinatários

Ambas as AWS contas envolvidas no convite de conexão: a conta do remetente que originalmente enviou o convite e a conta do destinatário que aceitou o convite.

Tratamento esperado

Ações típicas do cliente:

Padrões comuns de integração:

Exemplo

{
  "version": "1",
  "id": "<event id>",
  "detail-type":  "Partner Connection Invitation Accepted",
  "source": "aws.partnercentral-account",
  "time": "<ISO 8601 date time>",
  "region": "us-east-1",
  "resources": [ "<<Connection Invitation ARN>>" , "<<Connection ARN>>" ],
  "account": "<corresponding partner AWS account>",
  "detail": {
    "catalog": "AWS",
    "connectionInvitation" :{
        "arn": "<<Connection Invitation ARN>>",
        "id": "pacinv-****",
        "connectionType": "OpportunityCollaboration"
    },
    "connection": {
        "arn": "<<Connection ARN>>",
         "id": "pac-*****",
         "Participant1AccountId": "<<Sender AWS AccountId>>", 
         "Participant2AccountId": "<<Receiver AWS AccountId>>",
         "status": "ACTIVE"
     }
  }
}

Convite de conexão de parceiro rejeitado

Contexto de acionamento

Esse evento é gerado quando um convite de conexão é rejeitado com sucesso por meio da RejectConnectionInvitation API. O evento é enviado imediatamente após a rejeição do convite ser processada e persistida no armazenamento de dados do PAC.

O evento será enviado automaticamente quando um convite de conexão for rejeitado. Um evento por convite rejeitado sem eventos duplicados para a mesma rejeição.

Destinatários

A AWS conta que originalmente enviou o convite de conexão (a conta do remetente).

Tratamento esperado

Ações típicas do cliente:

Padrões comuns de integração:

Exemplo

{
  "version": "1",
  "id": "<event id>",
  "detail-type": "Partner Connection Invitation Rejected",
  "source": "aws.partnercentral-account",
  "time": "<ISO 8601 date time>",
  "region": "us-east-1",
  "account": "<corresponding partner AWS account>",
  "resources": [ "<<Connection Invitation ARN>>" ],
  "detail": {
    "catalog": "AWS",
    "connectionInvitation" :{
        "arn": "<<Connection Invitation ARN>>",
        "id": "pacinv-****",
        "connectionType": "OpportunityCollaboration",
        "invitationMessage": "We'd like to collaborate on a joint solution for cloud security. Please accept this connection invitation to proceed.",
        "receiverProfileId": "pprofile-****"
    }
  }
}

Conexão de parceiro cancelada

Contexto de acionamento

Esse evento é gerado quando uma conexão ativa é cancelada com sucesso e o status ativo é atualizado para encerrado no armazenamento de dados do PAC por meio da API. CancelConnection O evento é enviado imediatamente após o cancelamento da conexão ser processado e o status da conexão ser atualizado.

O evento será enviado automaticamente quando a conexão for encerrada. Um evento por conexão cancelado sem eventos duplicados para o mesmo cancelamento.

Destinatários

A AWS conta do outro participante na conexão (não daquele que iniciou o cancelamento).

Tratamento esperado

Ações típicas do cliente:

Padrões comuns de integração:

Exemplo

{
  "version": "1",
  "id": "<event id>",
  "detail-type": "Partner Connection Cancelled",
  "source": "aws.partnercentral-account",
  "time": "<ISO 8601 date time>",
  "region": "us-east-1",
  "resources": [ "<<Connection ARN>>" ],
  "account": "<corresponding partner AWS account>",
  "detail": {
    "catalog": "AWS",
    "connection" :{
        "arn": "<<Connection Invitation ARN>>",
        "id": "pac-****",
        "connectionType": "OpportunityCollaboration",
        "canceledBy": "<<AWS account ID>>"
    }
  }
}

Convite de conexão de parceiro cancelado

Contexto de acionamento

Esse evento é gerado quando um convite de conexão pendente é cancelado com sucesso por meio da CancelConnectionInvitation API. O evento é enviado imediatamente após o cancelamento do convite ser processado e o status do convite ser atualizado para CANCELADO.

O evento será enviado automaticamente quando um convite de conexão for cancelado. Um evento por convite de conexão foi cancelado sem eventos duplicados para o mesmo cancelamento.

Destinatários

A AWS conta que deveria receber o convite de conexão (a conta do destinatário).

Tratamento esperado

Ações típicas do cliente:

Padrões comuns de integração:

Exemplo

{
  "version": "1",
  "id": "<event id>",
  "detail-type": "Partner Connection Invitation Cancelled",
  "source": "aws.partnercentral-account",
  "time": "<ISO 8601 date time>",
  "region": "us-east-1",
  "account": "<corresponding partner AWS account>",
  "resources": [ "<<Connection Invitation ARN>>" ],
  "detail": {
    "catalog": "AWS",
    "connectionInvitation" :{
        "arn": "<<Connection Invitation ARN>>",
        "id": "pacinv-****",
        "connectionType": "OpportunityCollaboration",
        "invitationMessage": "We'd like to collaborate on a joint solution for cloud security. Please accept this connection invitation to proceed.",
        "senderProfileId": "pprofile-****"
    }
  }
}

O convite de conexão de parceiro expirou

Contexto de acionamento

Esse evento é gerado quando um convite de conexão pendente expira automaticamente após atingir seu registro de ExpiresAt data e hora sem ser aceito ou rejeitado pelo destinatário. O evento é acionado automaticamente pelo sistema quando o prazo de expiração do convite é atingido.

O evento será enviado automaticamente quando o convite de conexão expirar. Um evento por convite expirou sem eventos duplicados com a mesma expiração.

Destinatários

Ambas as AWS contas envolvidas no convite de conexão: a conta do remetente que originalmente enviou o convite e a conta do destinatário que recebeu o convite.

Tratamento esperado

Ações típicas do cliente:

Padrões comuns de integração:

Exemplo

{
  "version": "1",
  "id": "<event id>",
  "detail-type": "Partner Connection Invitation Expired",
  "source": "aws.partnercentral-account",
  "time": "<ISO 8601 date time>",
  "region": "us-east-1",
  "resources": [ "<<Connection Invitation ARN>>" ],
  "detail": {
    "catalog": "AWS",
    "connectionInvitation": {
        "arn": "<<Connection Invitation ARN>>",
        "id": "pacinv-****",
        "connectionType": "OpportunityCollaboration",
        "inviterEmail": "abc@def.com",
        "invitationMessage": "We'd like to collaborate on a joint solution for cloud security. Please accept this connection invitation to proceed.",
        "senderProfileId": "pprofile-****",
        "receiverProfileId": "pprofile-****"
    }
  }
}