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

# Trabalhando com conexões de contas de parceiros
<a name="working-with-account-connections"></a>

Os parceiros podem gerenciar conexões entre suas próprias contas ou conexões com AWS contas de outros parceiros usando a API AWS Partner Connection. O processo envolve duas fases:

1. **Fase de convite de conexão: ** iniciando e respondendo às solicitações de conexão

1. **Fase de conexão ativa: ** Gerenciando conexões estabelecidas e suas atividades comerciais associadas

## Criando e enviando um convite de conexão
<a name="creating-and-sending-connection-invitation"></a>

### Etapa 1: criar um convite de conexão
<a name="step-1-create-connection-invitation"></a>

A primeira etapa para estabelecer uma conexão de parceiro é criar e enviar um convite de conexão usando a `CreateConnectionInvitation` ação. Ao criar um convite, você deve especificar:
+ **Catálogo: ** O AWS catálogo (AWS ou Sandbox) em que a conexão será gerenciada
+ **ConnectionType: ** O tipo de relacionamento que você deseja estabelecer. Escolha uma das seguintes opções:
  + **`OPPORTUNITY_COLLABORATION`: ** use esse tipo quando quiser enviar uma solicitação de conexão para a conta de outro parceiro para que você possa enviar a ele convites de engajamento de oportunidades para colaboração em oportunidades.
  + **`SUBSIDIARY`: ** use esse tipo quando quiser conectar várias contas de vendedor do AWS Marketplace que você possui à sua conta “principal” vinculada à APN ou na qual você está registrado como parceiro
+ **ReceiverIdentifier: ID ** do perfil público do parceiro do destinatário (para o tipo de conexão Opportunity Collaboration) ou ID AWS da conta (para o tipo de conexão subsidiária)
+ **E-mail: ** Seu endereço de e-mail de contato para comunicação
+ **Nome: ** Seu nome como remetente
+ **Mensagem: ** Uma descrição explicando a finalidade da solicitação de conexão

Quando criado, o convite entra no estado Pendente, aguardando a ação do destinatário.

**Importante**  
Ao enviar um convite de conexão, você concorda em revelar o ID AWS da sua conta ao destinatário se ele aceitar o convite. Essa divulgação é necessária para estabelecer a conexão no nível da conta.

### Etapa 2: monitore seus convites enviados
<a name="step-2-monitor-sent-invitations"></a>

Você pode acompanhar o status dos convites enviados usando a `ListConnectionInvitations` ação com o `ParticipantType` parâmetro definido como. `SENDER` Isso permite a você:
+ Exibir todos os convites enviados
+ Filtrar por status (`PENDING``ACCEPTED`,,`REJECTED`,`EXPIRED`)
+ Filtrar por tipo de conexão
+ Verifique convites específicos para outros parceiros

### Etapa 3: cancelar um convite (opcional)
<a name="step-3-cancel-invitation"></a>

Se precisar retirar um convite pendente antes que ele seja aceito, você pode usar a `CancelConnectionInvitation` ação. Observe que:
+ Você só pode cancelar convites no estado Pendente
+ Depois que um convite é aceito e uma conexão é estabelecida, ele não pode ser cancelado
+ Para encerrar uma conexão estabelecida, você deve usar a `CancelConnection` ação em vez disso

## Recebendo e respondendo a convites de conexão
<a name="receiving-and-responding-to-invitations"></a>

### Etapa 1: Listar os convites recebidos
<a name="list-incoming-invitations"></a>

Para ver os convites de conexão que você recebeu, use a `ListConnectionInvitations` ação com o ParticipantType parâmetro definido como. `RECEIVER` Você pode filtrar por:
+ Tipo de conexão
+ Status (`PENDING`,`ACCEPTED`,`REJECTED`)
+ Identificador do remetente

### Etapa 2: revisar os detalhes do convite
<a name="review-invitation-details"></a>

Use a `GetConnectionInvitation` ação para ver os detalhes completos de um convite específico, incluindo:
+ Nome do remetente e e-mail de contato
+ Mensagem de convite explicando o propósito
+ Tipo de conexão que está sendo solicitado
+ Data de expiração
+ Informações do perfil público do remetente

### Etapa 3: aceitar ou rejeitar o convite
<a name="accept-or-reject-invitation"></a>

Depois de analisar os detalhes do convite, você tem duas opções:

#### Opção A: Aceitar o convite
<a name="option-a-accept-invitation"></a>

Use a `AcceptConnectionInvitation` ação para estabelecer a conexão. Quando você aceita:
+ Uma nova conexão é criada no estado Ativo
+ O status do convite muda para Aceito
+ O ID AWS da sua conta é revelado ao remetente
+ Você pode começar a conduzir atividades comerciais habilitadas pelo tipo de conexão

**Importante**  
**Consentimento importante: ** Ao aceitar um convite de conexão, você concorda em revelar o ID da sua AWS conta ao remetente. Essa divulgação é necessária para estabelecer a conexão no nível da conta.

#### Opção B: rejeitar o convite
<a name="option-b-reject-invitation"></a>

Use a `RejectConnectionInvitation` ação se não quiser estabelecer a conexão. Opcionalmente, você pode fornecer um motivo para a rejeição. Uma vez rejeitado:
+ O status do convite muda para Rejeitado
+ Nenhuma conexão foi estabelecida
+ O convite não aparecerá mais na sua lista de convites pendentes

### Expiração automática
<a name="automatic-expiration"></a>

Se nenhuma ação for tomada dentro do período de expiração, o sistema transita automaticamente o convite para o estado Expirado. Convites expirados não podem ser aceitos ou rejeitados.

## Gerenciando conexões ativas
<a name="managing-active-connections"></a>

### Visualizando suas conexões
<a name="viewing-your-connections"></a>

Depois que uma conexão é estabelecida, ambas as partes podem visualizá-la e gerenciá-la usando as seguintes ações:

**`ListConnections`: ** Recupere uma lista de suas conexões com opções de filtragem:
+ Filtrar por tipo de conexão e status (por exemplo,`OPPORTUNITY_COLLABORATION:ACTIVE`)
+ Filtrar pelo identificador de outra parte
+ Exibir informações resumidas de cada conexão

**`GetConnection`: ** recupere detalhes completos de uma conexão específica, incluindo:
+ Todos os tipos de conexão associados a esse relacionamento de parceria
+ Status de cada tipo de conexão (ativa ou encerrada)
+ Informações de contato do convite original
+ AWS IDs de conta e IDs de perfil público de ambas as partes
+ Carimbos de data e hora de criação e encerramento para cada tipo de conexão

### Adicionando tipos de conexão a uma conexão existente
<a name="adding-connection-types"></a>

Se você já tiver uma conexão ativa com um parceiro e quiser estabelecer um novo tipo de relacionamento, poderá enviar um novo convite de conexão com um tipo de conexão diferente. Após a aceitação:
+ O novo tipo de conexão é adicionado à conexão existente
+ Ambos os tipos de conexão permanecem gerenciáveis de forma independente
+ O mesmo ID de conexão é mantido para o relacionamento

**nota**  
Só pode haver uma conexão ativa de qualquer tipo entre duas contas em um determinado catálogo a qualquer momento.

### Encerrando tipos de conexão
<a name="terminating-connection-types"></a>

Qualquer uma das partes pode encerrar um tipo de conexão específico usando a `CancelConnection` ação. Ao encerrar:
+ Especifique o ID da conexão e o tipo de conexão a ser encerrada
+ Forneça um motivo para a rescisão
+ O status do tipo de conexão muda para `CANCELED`
+ Outros tipos de conexão dentro da mesma conexão permanecem inalterados

### Encerramento completo da conexão
<a name="complete-connection-termination"></a>

Quando todos os tipos de conexão em uma conexão são encerrados, a própria conexão passa para o estado Encerrado. Uma conexão completamente encerrada:
+ Não pode ser reativado, mas você pode enviar uma nova solicitação de conexão para continuar os negócios com essa conta
+ Permanece no sistema para manutenção de registros históricos
+ Pode ser visualizado usando a `GetConnection` API
+ Requer um novo convite para restabelecer o relacionamento

## Monitorando eventos de conexão
<a name="monitoring-connection-events"></a>

Os parceiros devem monitorar eventos relacionados à conexão usando a Amazon EventBridge para se manterem informados sobre:
+ Novos convites de conexão recebidos
+ Alterações de status nos convites enviados (`ACCEPTED`,,`REJECTED`) `EXPIRED`
+ Terminações de conexão iniciadas pela outra parte

Ao receber um evento, use a ação Get API apropriada para obter os detalhes mais recentes:
+ `GetConnectionInvitation`para atualizações de convites
+ `GetConnection`para atualizações de conexão

### Eventos possíveis
<a name="possible-events"></a>
+ **Convite de conexão criado: ** notifica a conta do destinatário sobre os convites de conexão recebidos.
+ **Convite de conexão cancelado: ** notifica a conta do destinatário quando um remetente cancela um convite de conexão recebido.
+ **Convite de conexão expirado: ** notifica as contas do remetente e do destinatário quando um convite de conexão expira sem ação.
+ **Convite de conexão rejeitado: ** notifica a conta do remetente quando o convite de conexão é rejeitado pelo destinatário.
+ **Convite de conexão aceito: ** notifica a conta do remetente quando o convite de conexão é aceito e uma conexão é estabelecida.
+ **Conexão cancelada: ** notifica ambas as partes conectadas quando toda a conexão é totalmente encerrada.

## Entendendo os estados de conexão
<a name="understanding-connection-states"></a>

### Estados do convite de conexão
<a name="connection-invitation-states"></a>


| Estado | Description | Pode fazer a transição para | 
| --- | --- | --- | 
| PENDING | Estado inicial quando criado; aguardando ação do receptor | ACCEPTED, REJECTED, EXPIRED, CANCELED | 
| ACCEPTED | Receptor aceito; conexão criada | Nenhum (estado terminal) | 
| REJECTED | Receptor recusado; contém o motivo opcional da rejeição | Nenhum (estado terminal) | 
| EXPIRED | System-expired devido a nenhuma ação dentro do período de expiração | Nenhum (estado terminal) | 
| CANCELED | O remetente retirou o convite antes da aceitação | Nenhum (estado terminal) | 

### Estados do tipo de conexão
<a name="connection-type-states"></a>


| Estado | Description | 
| --- | --- | 
| ACCEPTED | O tipo de conexão está operacional; as atividades comerciais associadas estão ativadas | 
| CANCELED | Tipo de conexão encerrado por qualquer uma das partes | 

## Práticas recomendadas
<a name="best-practices"></a>

1. **Comunicação clara: ** forneça mensagens claras e detalhadas em seus convites de conexão explicando o propósito e a colaboração esperada.

1. **Respostas oportunas: ** monitore e responda aos convites de conexão imediatamente para evitar a expiração automática.

1. **Revisão regular: revise ** periodicamente suas conexões ativas para garantir que elas permaneçam relevantes às suas necessidades comerciais atuais.

1. **Rescisão adequada: ** Ao encerrar um relacionamento comercial, use a CancelConnection ação com um motivo claro para manter a comunicação profissional.

1. **Monitoramento de eventos: ** configure EventBridge regras para receber automaticamente notificações de alterações no status da conexão, para ajudar a se manter informado sobre atualizações importantes.

1. **Gerenciamento do tipo de conexão: ** considere quais tipos de conexão são necessários antes de estabelecer conexões, pois cada tipo permite diferentes capacidades comerciais.

1. **Conscientização sobre segurança: ** lembre-se de que o estabelecimento de uma conexão revela os IDs das AWS contas entre as partes. Conecte-se apenas com parceiros confiáveis.

## Tipos de conexão e suas finalidades
<a name="connection-types-and-purposes"></a>


| Tipo de conexão | Finalidade | Caso de uso | 
| --- | --- | --- | 
| OPPORTUNITY\_COLLABORATION | Permite a colaboração em oportunidades de venda conjunta com outros parceiros | Quando você quiser que outro parceiro tenha acesso à sua oportunidade ou vice-versa, use esse tipo de conexão. Essa conexão permite que você envie convites de engajamento de oportunidades para parceiros conectados. | 
| SUBSIDIARY | Estabelece conexões entre suas várias contas de vendedor do AWS Marketplace e sua conta principal de parceiro | Use quando você tiver várias contas de vendedor do AWS Marketplace que deseja conectar à sua conta principal, na qual está registrado como parceiro e vendedor. |