View a markdown version of this page

Trabalhando com conexões de contas de parceiros - AWS Central de Parceiros
Criando e enviando um convite de conexãoRecebendo e respondendo a convites de conexãoGerenciando conexões ativasMonitorando eventos de conexãoEntendendo os estados de conexãoPráticas recomendadasTipos de conexão e suas finalidades

A referência AWS Partner Central da API foi reestruturada. Para obter mais informações sobre as operações de API suportadas, consulte a Referência AWS Partner Central 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á.

Trabalhando com conexões de contas de parceiros

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

  2. Fase de conexão ativa: gerenciamento de conexões estabelecidas e suas atividades comerciais associadas

Criando e enviando um convite de conexão

Etapa 1: criar um convite de conexão

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 de oportunidades

    • SUBSIDIARY: Use esse tipo quando quiser conectar várias contas de vendedor do AWS Marketplace que você possui à sua conta “principal” que você vinculou à 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 da 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 da sua AWS conta ao destinatário, caso ele aceite o convite. Essa divulgação é necessária para estabelecer a conexão no nível da conta.

Etapa 2: monitore seus convites enviados

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ê:

  • Veja todos os convites enviados

  • Filtrar por status (PENDINGACCEPTED,,REJECTED,EXPIRED)

  • Filtrar por tipo de conexão

  • Confira convites específicos para outros parceiros

Etapa 3: cancelar um convite (opcional)

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, ela não pode ser cancelada

  • Para encerrar uma conexão estabelecida, você deve usar a CancelConnection ação em vez disso

Recebendo e respondendo a convites de conexão

Etapa 1: Listar os convites recebidos

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

Use a GetConnectionInvitation ação para ver 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

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

Opção A: aceitar o convite

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

Use a RejectConnectionInvitation ação se você 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 é estabelecida

  • O convite não aparecerá mais na sua lista de convites pendentes

Expiração automática

Se nenhuma ação for tomada dentro do período de expiração, o sistema fará a transição automática do convite para o estado Expirado. Convites expirados não podem ser aceitos nem rejeitados.

Gerenciando conexões ativas

Visualizando suas conexões

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 e status da conexão (por exemplo,OPPORTUNITY_COLLABORATION:ACTIVE)

  • Filtrar pelo identificador de outra parte

  • Exibir informações resumidas para 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 parceiro

  • 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

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

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

Quando todos os tipos de conexão em uma conexão são encerrados, a própria conexão passa para o estado Terminado. 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

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:

  • GetConnectionInvitationpara atualizações de convites

  • GetConnectionpara atualizações de conexão

Eventos possíveis

  • 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

Estados do convite de conexão

Estado Description Pode fazer a transição para
PENDING Estado inicial quando criado; aguardando a ação do receptor ACCEPTED, REJECTED, EXPIRED, CANCELED
ACCEPTED Receptor aceito; conexão criada Nenhum (estado terminal)
REJECTED O destinatário recusou; 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

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

Práticas recomendadas

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

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

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

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

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

  6. 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 recursos comerciais.

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

Tipos de conexão e suas finalidades

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 do Partner Use quando você tiver várias contas de vendedor do AWS Marketplace que deseja conectar à sua conta principal, na qual você está registrado como parceiro e vendedor.