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

# Notificações para o AWS API de conta do Partner Central
<a name="account-api-events"></a>

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:
+ Reaja prontamente à nova colaboração
+ Mantenha o conhecimento do status do portfólio de conexões
+ Tome as medidas apropriadas quando as conexões forem estabelecidas ou encerradas
+ Garanta a continuidade dos negócios sabendo quando os relacionamentos mudam

**Topics**
+ [Preencha o pré-requisito para monitorar eventos](#events-prerequites)
+ [Configure EventBridge a Amazon para monitorar eventos](#eventbridge-setup)
+ [Saiba mais sobre eventos da API de conexões de contas](#learn-about-events)

## Preencha o pré-requisito para monitorar eventos
<a name="events-prerequites"></a>

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](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-use-conditions.html#events-pattern-detail-type) 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
<a name="eventbridge-setup"></a>

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 Console de gerenciamento da AWS 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).

### Console de gerenciamento da AWS configuração
<a name="eventbridge-console-setup"></a>

Para configurar uma EventBridge regra usando o Console de gerenciamento da AWS, siga as etapas em [Criação de regras que reagem a eventos na Amazon EventBridge](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-create-rule.html) 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
<a name="eventbridge-sdk-setup"></a>

Você pode usar os AWS SDKs para criar e gerenciar EventBridge regras de forma programática. Para obter mais informações, consulte [PutRule](https://docs.aws.amazon.com/eventbridge/latest/APIReference/API_PutRule.html)a *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
<a name="learn-about-events"></a>

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 name="types-of-events"></a>

A seguir estão os tipos de eventos e seus gatilhos.
+ [Convite de conexão de parceiro recebido](#connection-invitation-received): notifica o receptor de que outro parceiro deseja estabelecer uma conexão
+ [Convite de conexão de parceiro aceito](#connection-invitation-accepted): notifica o remetente de que o convite foi aceito e que a conexão agora está ativa
+ [Convite de conexão de parceiro rejeitado](#connection-invitation-rejected): notifica o remetente de que o convite foi recusado
+ [Conexão de parceiro cancelada](#connection-cancelled): notifica o outro participante conectado quando uma conexão ativa é encerrada
+ [Convite de conexão de parceiro cancelado](#connection-invitation-cancelled): notifica o destinatário de que o remetente retirou o convite antes que qualquer ação fosse tomada
+ [Convite de conexão de parceiro expirado](#connection-invitation-expired): notifica o remetente e o destinatário de que o convite expirou

### Eventos de exemplo
<a name="example-rules"></a>

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

**Topics**
+ [Convite de conexão de parceiro recebido](#connection-invitation-received)
+ [Convite de conexão de parceiro aceito](#connection-invitation-accepted)
+ [Convite de conexão de parceiro rejeitado](#connection-invitation-rejected)
+ [Conexão de parceiro cancelada](#connection-cancelled)
+ [Convite de conexão de parceiro cancelado](#connection-invitation-cancelled)
+ [O convite de conexão de parceiro expirou](#connection-invitation-expired)

#### Convite de conexão de parceiro recebido
<a name="connection-invitation-received"></a>

##### Contexto de acionamento
<a name="connection-invitation-received-context"></a>

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 name="connection-invitation-received-recipients"></a>

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

##### Tratamento esperado
<a name="connection-invitation-received-handling"></a>

Ações típicas do cliente:
+ Notificação imediata: acione alertas para as equipes de negócios sobre novas oportunidades de parceria
+ Automação do fluxo de trabalho: atualize automaticamente os sistemas de gerenciamento de parceiros com convites pendentes
+ Apoio à decisão: encaminhe convites para os tomadores de decisão apropriados com base no tipo de conexão
+ Registro de auditoria: registre o recebimento do convite para acompanhamento de conformidade e parceria
+ Automação de respostas: para parceiros confiáveis, é possível aceitar automaticamente determinados tipos de convite

Padrões comuns de integração:
+ Função Lambda → Atualizar o painel do portal do parceiro
+ Fila SQS → Processar convites em lote para análise
+ Tópico do SNS → Email/Slack notificações para equipes de negócios
+ Destino da API → Webhook para sistemas CRM/partner de gerenciamento externos

##### Exemplo
<a name="connection-invitation-received-example"></a>

```
{
  "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
<a name="connection-invitation-accepted"></a>

##### Contexto de acionamento
<a name="connection-invitation-accepted-context"></a>

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
<a name="connection-invitation-accepted-recipients"></a>

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 name="connection-invitation-accepted-handling"></a>

Ações típicas do cliente:
+ Ativação de parceria: acione fluxos de trabalho para permitir atividades comerciais de camada 2
+ Atualizações de status: atualize os sistemas de gerenciamento de parceiros com o status da conexão ativa
+ Notificação: Alerte as equipes de negócios sobre o estabelecimento bem-sucedido da parceria
+ Provisionamento de acesso: conceda automaticamente as permissões apropriadas para colaboração
+ Analytics: acompanhe as taxas de conversão de parcerias e as métricas de sucesso

Padrões comuns de integração:
+ Função Lambda → Ativar permissões de compartilhamento de dados e atualizar o portal do parceiro
+ Fila SQS → Batch processa ativações de conexão para configuração de negócios
+ Tópico do SNS → Email/Slack notificações para equipes técnicas e comerciais
+ Destino da API → Webhook para sistemas de CRM para atualizar o status da parceria

##### Exemplo
<a name="connection-invitation-accepted-example"></a>

```
{
  "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
<a name="connection-invitation-rejected"></a>

##### Contexto de acionamento
<a name="connection-invitation-rejected-context"></a>

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 name="connection-invitation-rejected-recipients"></a>

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

##### Tratamento esperado
<a name="connection-invitation-rejected-handling"></a>

Ações típicas do cliente:
+ Atualizações de status: atualize os sistemas de gerenciamento de parceiros com o status de rejeição
+ Follow-up Ações: acionar fluxos de trabalho para abordagens alternativas de parceria
+ Notificação: alerte as equipes de negócios sobre a decisão de parceria
+ Limpeza: remova referências de convites pendentes dos sistemas internos

Padrões comuns de integração:
+ Função Lambda → Atualize o portal do parceiro e acione fluxos de trabalho de acompanhamento
+ Fila SQS → Rejeições de processos em lote para análise de negócios
+ Tópico do SNS → Email/Slack notificações para equipes de desenvolvimento de negócios
+ Destino da API → Webhook para sistemas de CRM para atualizar o status da oportunidade

##### Exemplo
<a name="connection-invitation-rejected-example"></a>

```
{
  "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
<a name="connection-cancelled"></a>

##### Contexto de acionamento
<a name="connection-cancelled-context"></a>

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 name="connection-cancelled-recipients"></a>

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

##### Tratamento esperado
<a name="connection-cancelled-handling"></a>

Ações típicas do cliente:
+ Revogação de acesso: revogue imediatamente as permissões e desative o compartilhamento de dados
+ Atualizações de status: atualize os sistemas de gerenciamento de parceiros com o status da conexão encerrada
+ Notificação: Alerte as equipes técnicas e comerciais sobre o término da parceria
+ Limpeza: remova as referências de conexão e limpe os recursos compartilhados
+ Análise: acompanhe a duração da conexão e os padrões de encerramento

Padrões comuns de integração:
+ Função Lambda → Revogar permissões e atualizar o status do portal do parceiro
+ Fila SQS → Terminações de conexão de processamento em lote para fluxos de trabalho de limpeza
+ Tópico do SNS → Email/Slack notificações para equipes técnicas e comerciais
+ Destino da API → Webhook para sistemas de CRM para atualizar o status da parceria

##### Exemplo
<a name="connection-cancelled-example"></a>

```
{
  "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
<a name="connection-invitation-cancelled"></a>

##### Contexto de acionamento
<a name="connection-invitation-cancelled-context"></a>

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 name="connection-invitation-cancelled-recipients"></a>

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

##### Tratamento esperado
<a name="connection-invitation-cancelled-handling"></a>

Ações típicas do cliente:
+ Atualizações de status: atualize os sistemas de gerenciamento de parceiros para remover referências de convites pendentes
+ Notificação: alerte as equipes de negócios de que uma possível oportunidade de parceria foi retirada
+ Limpeza: remova as referências de convite dos sistemas internos de rastreamento
+ Analytics: acompanhe os padrões de cancelamento de convites para obter informações sobre parcerias

Padrões comuns de integração:
+ Função Lambda → Atualizar o portal do parceiro e remover notificações de convites pendentes
+ Fila SQS → Cancelamentos de processos em lote para análise de negócios
+ Tópico do SNS → Email/Slack notificações para equipes de desenvolvimento de negócios
+ Destino da API → Webhook para sistemas de CRM para atualizar o status da oportunidade

##### Exemplo
<a name="connection-invitation-cancelled-example"></a>

```
{
  "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
<a name="connection-invitation-expired"></a>

##### Contexto de acionamento
<a name="connection-invitation-expired-context"></a>

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
<a name="connection-invitation-expired-recipients"></a>

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 name="connection-invitation-expired-handling"></a>

Ações típicas do cliente:
+ Atualizações de status: atualize os sistemas de gerenciamento de parceiros para marcar o convite como expirado
+ Follow-up Ações: acionar fluxos de trabalho para reengajamento ou abordagens alternativas de parceria
+ Notificação: alerte as equipes de negócios sobre oportunidades de parceria perdidas
+ Limpeza: remova referências de convite expiradas dos sistemas internos de rastreamento

Padrões comuns de integração:
+ Função Lambda → Atualize o portal do parceiro e acione fluxos de trabalho de acompanhamento
+ Fila SQS → Expirações de processos em lote para análise de negócios
+ Tópico do SNS → Email/Slack notificações para equipes de desenvolvimento de negócios
+ Destino da API → Webhook para sistemas de CRM para atualizar o status da oportunidade

##### Exemplo
<a name="connection-invitation-expired-example"></a>

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