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 oportunidades de vários parceiros
AWS Partner s podem trabalhar juntos em oportunidades AWS como participantes ativos.
**Topics**
+ [Engajamentos e fotos](#engagements-and-snapshots)
+ [Criação de uma política personalizada para ResourceSnapshotJobRole](#creating-custom-policy-resourcesnapshotjobrole)
+ [Convidando parceiros para uma oportunidade](#inviting-partners-to-an-opportunity)
+ [Recuperando detalhes do convite de engajamento](#retrieving-invitation-details)
+ [Respondendo a um convite de noivado](#responding-engagement-invitation)
+ [Analisando e atualizando oportunidades com vários parceiros](#reviewing-and-updating-multipartner-opportunities)
+ [Usando instantâneos para receber atualizações de parceiros](#using-snapshots-to-receive-partner-updates)
+ [Visualizando membros do engajamento](#viewing-engagement-members)
+ [Monitorando o status do trabalho de captura instantânea de recursos](#monitoring-resource-snapshot-job-status)
## Engajamentos e fotos
Um *contrato* é um recurso de propriedade da empresa AWS para colaboração entre várias AWS Partner contas e AWS sobre uma oportunidade para o cliente. Os contratos facilitam o compartilhamento seguro de informações entre parceiros e a colaboração, ao mesmo tempo em que mantêm a propriedade e o controle individuais das oportunidades. Os engajamentos abrangem oportunidades que se originam de ambos AWS e dos parceiros, como um participante AWS ativo. Os parceiros podem convidar AWS ou outros parceiros para participar de um compromisso usando`EngagementInvitations`. Quando os parceiros convidados aceitam, eles recebem sua própria oportunidade dentro do mesmo compromisso.
Os membros do engajamento compartilham o progresso por meio de instantâneos — cópias pontuais e imutáveis de campos específicos de um recurso subjacente, como uma oportunidade. Os instantâneos são criados dentro do engajamento e compartilhados com os membros. Quando o recurso subjacente muda, o proprietário pode criar uma nova revisão de instantâneo para refletir as atualizações.AWS fornece trabalhos instantâneos — trabalhos de propriedade do cliente que criam automaticamente novas revisões quando o recurso é alterado. Depois de compartilhados, os instantâneos permanecem permanentemente acessíveis aos membros do engajamento.
## Criação de uma política personalizada para ResourceSnapshotJobRole
Colaborar em oportunidades com vários parceiros exige compartilhar instantâneos de suas oportunidades com outros parceiros em um compromisso. Para manter o acesso aos detalhes mais recentes da oportunidade, você precisa criar um papel personalizado chamado`ResourceSnapshotJobRole`. Essa função permite que o sistema crie instantâneos de suas oportunidades em seu nome e recupere instantâneos de outros parceiros no mesmo contrato. Sem essa função, todas as atualizações que você fizer em sua oportunidade não serão visíveis para outros parceiros no engajamento, e eles continuarão vendo instantâneos desatualizados dos dados de sua oportunidade.
**nota**
Você pode usar um nome diferente de`ResourceSnapshotJobRole`. Se você usar um nome diferente, substitua todas as instâncias das `ResourceSnapshotJobRole` políticas a seguir pelo nome da sua política.
Para criar essa função, acesse seu console do IAM e crie a `ResourceSnapshotJobRole` função com a seguinte política de confiança personalizada:
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Principal": {
"Service": "resource-snapshot-job.partnercentral-selling.amazonaws.com"
},
"Action": "sts:AssumeRole"
}
]
}
```
------
Depois de criar essa função, você precisa anexar a política [AWSPartnerCentralSellingResourceSnapshotJobExecutionRolePolicy](https://docs.aws.amazon.com/aws-managed-policy/latest/reference/AWSPartnerCentralSellingResourceSnapshotJobExecutionRolePolicy.html)AWS gerenciada ou anexar a seguinte política de permissões:
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Action": [
"partnercentral:CreateResourceSnapshot"
],
"Resource": [
"arn:aws:partnercentral:*::catalog/AWS/engagement/*"
]
},
{
"Effect": "Allow",
"Action": [
"partnercentral:GetOpportunity"
],
"Resource": [
"arn:aws:partnercentral:*:{{111122223333}}:catalog/AWS/opportunity/*"
]
}
]
}
```
------
Substitua `{account}` pelo seu ID de conta da AWS.
Depois de criar a `ResourceSnapshotJobRole` função e anexar as permissões, você precisa definir a `ResourceSnapshotJobRole` para sua organização. Use a [PutSellingSystemSettings](https://docs.aws.amazon.com/partner-central/latest/APIReference/API_PutSellingSystemSettings.html)ação para definir a função que você criou como a da `ResourceSnapshotJobRole` sua empresa (identificada pela sua AWS conta):
```
aws-cli/2.13.5 Python/3.11.4 Linux/4.14.255-314-253.539.amzn2.x86_64
Host: partner-central.aws.amazon.com
Content-Type: application/json
{
"ResourceSnapshotJobRoleIdentifier": "arn:aws:iam::{account}:role/ResourceSnapshotJobRole"
}
```
`{account}`Substitua pelo ID da sua AWS conta e `ResourceSnapshotJobRole` pelo nome da função que você criou. Essa função será assumida implicitamente pelos trabalhos de instantâneos de recursos para acessar suas oportunidades e criar instantâneos para compartilhar com outros parceiros no compromisso.
## Convidando parceiros para uma oportunidade
Os parceiros podem colaborar em oportunidades provenientes de ambos os parceiros e AWS iniciando um convite de engajamento. Você pode convidar no máximo nove parceiros para uma oportunidade.
**Para convidar parceiros para uma oportunidade**
1. Siga as etapas em [Encontrar e se conectar com parceiros](https://docs.aws.amazon.com/partner-central/latest/sales-guide/partner-connections.html#finding-partners) no *Guia de vendas do AWS Partner Central*. Você deve se conectar com os parceiros antes de convidá-los para oportunidades. Essa conexão concede acesso mútuo aos IDs de conta uns dos outros, garantindo que os convites cheguem à conta do parceiro pretendido.
1. Use a [StartEngagementFromOpportunityTask](https://docs.aws.amazon.com/partner-central/latest/APIReference/API_StartEngagementFromOpportunityTask.html)ação para criar um engajamento e associar uma oportunidade a ele. Essa ação assíncrona executa as seguintes tarefas sequencialmente:
1. Cria um engajamento.
1. Associa a oportunidade ao engajamento.
1. Invoca a [CreateEngagementInvitation](https://docs.aws.amazon.com/partner-central/latest/APIReference/API_CreateEngagementInvitation.html)ação para.AWS
1. Envia a oportunidade para.AWS
1. Inicia o `ResourceSnapshotJob` para criar instantâneos.
1. Convide outros parceiros para participarem.
1. Para obter o ID de engajamento associado à sua oportunidade, use a [ListEngagementFromOpportunityTasks](https://docs.aws.amazon.com/partner-central/latest/APIReference/API_ListEngagementFromOpportunityTasks.html)ação, filtrada pelo `TaskIdentifier` retornado na etapa anterior.
1. Use o ID de engajamento e o ID da conta do parceiro receptor para enviar um convite com`CreateEngagementInvitation`.
Um convite bem-sucedido envia um evento criado pelo convite de engajamento para o parceiro receptor.
## Recuperando detalhes do convite de engajamento
Ao receber um evento criado por convite de engajamento, use a [GetEngagementInvitation](https://docs.aws.amazon.com/partner-central/latest/APIReference/API_GetEngagementInvitation.html)ação para recuperar os detalhes do convite. A resposta inclui informações essenciais sobre a oportunidade do cliente associada ao contrato.
Revise os detalhes do convite `InvitationMessage``Project.Title`, especialmente os `Project.CustomerBusinessProblem` campos`Project.CustomerUseCase`,, e. Essas informações fornecem contexto sobre a oportunidade do cliente e as expectativas de colaboração do parceiro convidativo.
Use esses detalhes para avaliar se você deseja aproveitar a oportunidade aceitando ou recusando o convite de engajamento.
## Respondendo a um convite de noivado
Quando um parceiro envia a você um convite de engajamento, ele cria um evento criado por convite de engajamento que notifica você sobre o convite. Você tem a opção de aceitar ou rejeitar o convite. Essa decisão determina seu envolvimento na oportunidade de vários parceiros.
**Para rejeitar um convite de engajamento:**
Use a [RejectEngagementInvitation](https://docs.aws.amazon.com/partner-central/latest/APIReference/API_RejectEngagementInvitation.html)ação para rejeitar o convite. Você deve fornecer um `RejectionReason` parâmetro explicando sua decisão. Depois de rejeitado, você perde o acesso aos detalhes do convite, e um evento de rejeição do convite de engajamento notifica o parceiro remetente de que você rejeitou o convite.
**Para aceitar um convite de noivado:**
Para aceitar o convite e continuar com a oportunidade de vários parceiros, use a [StartEngagementByAcceptingInvitationTask](https://docs.aws.amazon.com/partner-central/latest/APIReference/API_StartEngagementByAcceptingInvitationTask.html)ação. Essa ação assíncrona executa as seguintes tarefas sequencialmente:
1. Aceita o convite de noivado.
1. Cria uma nova oportunidade em sua conta de parceiro usando dados da oportunidade do parceiro remetente. Você receberá um evento criado por uma oportunidade.
1. Inclui detalhes adicionais necessários para identificar o cliente em sua conta.
1. Publica um evento aceito por convite de noivado que notifica o parceiro de que você aceitou o convite e foi adicionado ao compromisso.
**Convite de noivado expirado**
Se você não responder a um convite de engajamento dentro de quinze dias, ele expirará e você não poderá participar da oportunidade com vários parceiros. Um evento de convite de engajamento expirado notifica o parceiro remetente de que o convite expirou.
**nota**
Se você ainda quiser colaborar, o parceiro remetente deve iniciar um novo convite de engajamento.
## Analisando e atualizando oportunidades com vários parceiros
Quando um parceiro inicia um engajamento em uma oportunidade, o status de revisão da oportunidade recém-criada na conta do parceiro receptor é determinado pelo status da oportunidade do parceiro remetente.
**Oportunidade com status de avaliação enviada:**
Se a oportunidade do parceiro remetente estiver `Lifecycle.ReviewStatus` definida como`Submitted`, o seguinte processo ocorrerá:
1. A nova oportunidade criada na conta do parceiro receptor será `Lifecycle.ReviewStatus` definida como`Submitted`.
1. O `Submitted` status permanece até que a oportunidade do parceiro remetente seja`Approved`.
1. Depois que a oportunidade do parceiro remetente for validada `Lifecycle.ReviewStatus` e definida como`Approved`, as oportunidades dos outros parceiros herdarão automaticamente o status. `Approved`
Esse processo garante detalhes consistentes das oportunidades em oportunidades com vários parceiros, eliminando a necessidade de várias avaliações.
Depois de concluído, um evento criado pela oportunidade é acionado com o ID da oportunidade correspondente. Os parceiros podem usar essa ID com a `GetOpportunity` ação para recuperar os detalhes completos da oportunidade.
**Oportunidade com status de revisão aprovado:**
Se o parceiro remetente iniciar um engajamento em uma oportunidade com `Lifecycle.ReviewStatus` definido como`Approved`, o seguinte processo ocorrerá:
1. A nova oportunidade criada na conta do parceiro receptor será `Lifecycle.ReviewStatus` definida como`Approved`.
1. Um evento criado pela oportunidade é acionado com o ID da oportunidade correspondente.
1. Os parceiros podem usar a [GetOpportunity](https://docs.aws.amazon.com/partner-central/latest/APIReference/API_GetOpportunity.html)ação com o ID da oportunidade para recuperar todos os detalhes da oportunidade.
No entanto, a oportunidade aprovada pode não ter alguns detalhes específicos do parceiro que não foram copiados da oportunidade do parceiro remetente. O parceiro receptor deve atualizar esses detalhes usando a [UpdateOpportunity](https://docs.aws.amazon.com/partner-central/latest/APIReference/API_UpdateOpportunity.html)ação quando o estágio da oportunidade for atualizado para `Qualified` ou em um estágio posterior:
+ `Project.CustomerUseCase`
+ `Project.DeliveryModels`
+ `Solution`
+ `PrimaryNeedsFromAws`
+ `LifeCycle.TargetCloseDate`
+ `Project.ExpectedCustomerSpend.Amount`
+ `Project.ExpectedCustomerSpend.Currency`
+ `Marketing.source`
+ `Marketing.AwsFundingUsed`
Depois que a oportunidade é criada na conta do parceiro receptor, ela pode ser gerenciada e atualizada como qualquer outra oportunidade no sistema do parceiro. Os parceiros podem usar a [UpdateOpportunity](https://docs.aws.amazon.com/partner-central/latest/APIReference/API_UpdateOpportunity.html)ação para fazer alterações ou fornecer mais informações sobre seu envolvimento na oportunidade.
## Usando instantâneos para receber atualizações de parceiros
Em um contrato, os parceiros mantêm e atualizam suas oportunidades de forma independente. Quando alguém revisa os recursos de um engajamento, como adicionar uma oportunidade, um evento criado por um instantâneo do recurso de engajamento é publicado.
Para se manter informado sobre as mudanças e acessar as informações mais atuais das oportunidades de outros parceiros, você pode usar as seguintes ações:
+ [ListEngagementResourceAssociations](https://docs.aws.amazon.com/partner-central/latest/APIReference/API_ListEngagementResourceAssociations.html)— Use essa ação para recuperar o ID de engajamento associado à oportunidade.
+ [ListResourceSnapshots](https://docs.aws.amazon.com/partner-central/latest/APIReference/API_ListResourceSnapshots.html)— use essa ação para recuperar uma lista abrangente de todos os instantâneos de oportunidades associados ao contrato, fornecendo uma visão geral dos instantâneos disponíveis em todos os parceiros.
+ [GetResourceSnapshot](https://docs.aws.amazon.com/partner-central/latest/APIReference/API_GetResourceSnapshot.html)— use essa ação para obter resumos em tempo real de instantâneos de oportunidades específicas, permitindo que você visualize as informações mais atualizadas sem acessar diretamente a oportunidade de outro parceiro.
Se você identificar mudanças ou atualizações relevantes da oportunidade de outro parceiro que devem ser refletidas na sua, use a [UpdateOpportunity](https://docs.aws.amazon.com/partner-central/latest/APIReference/API_UpdateOpportunity.html)ação. Essa ação facilita a incorporação seletiva de dados pertinentes à sua oportunidade, garantindo alinhamento e consistência em todo o engajamento.
## Visualizando membros do engajamento
Um engajamento em uma oportunidade com vários parceiros pode ter até dez parceiros. Sempre que um novo parceiro aceita o convite de engajamento, um evento adicionado ao membro do engajamento é publicado, notificando todos os membros atuais sobre a mudança.
Para ver todos os membros colaborando em um compromisso, siga estas etapas:
1. Use a [ListEngagementResourceAssociations](https://docs.aws.amazon.com/partner-central/latest/APIReference/API_ListEngagementResourceAssociations.html)ação para recuperar o ID de engajamento associado à oportunidade.
1. Forneça o ID da etapa 1 até a [ListEngagementMembers](https://docs.aws.amazon.com/partner-central/latest/APIReference/API_ListEngagementMembers.html)ação para obter os detalhes dos parceiros dos membros do engajamento.
**nota**
Somente membros de um compromisso podem invocar a `ListEngagementMembers` ação.
## Monitorando o status do trabalho de captura instantânea de recursos
Ao trabalhar com oportunidades de vários parceiros, você deve criar uma função que permita criar instantâneos de suas oportunidades para outros parceiros e recuperar instantâneos de oportunidades de outros parceiros em um compromisso. Sem essa função, todas as atualizações que você fizer em sua oportunidade não estarão disponíveis para outros parceiros no contrato, e eles continuarão vendo fotos desatualizadas de sua oportunidade.
Para rastrear o status dos trabalhos de snapshot de recursos associados a uma oportunidade com vários parceiros em um contrato, siga estas etapas:
1. Use a [ListEngagementResourceAssociations](https://docs.aws.amazon.com/partner-central/latest/APIReference/API_ListEngagementResourceAssociations.html)ação para recuperar o ID de engajamento associado à oportunidade.
1. Forneça o ID da etapa 1 até a [ListResourceSnapshotJobs](https://docs.aws.amazon.com/partner-central/latest/APIReference/API_ListResourceSnapshotJobs.html)ação para gerar uma lista de todos os trabalhos de snapshot pertencentes ao chamador no compromisso. Recupere o ID do trabalho a partir da resposta.
1. Forneça o ID do trabalho para a [GetResourceSnapshotJob](https://docs.aws.amazon.com/partner-central/latest/APIReference/API_GetResourceSnapshotJob.html)ação para rastrear o status do trabalho e ver se ele está em execução.
A `ResourceSnapshotJob` operação publica métricas para a Amazon CloudWatch para suas operações assíncronas. CloudWatch processa os dados em métricas legíveis e quase em tempo real para ajudá-lo a monitorar o desempenho e a integridade do serviço.
As seguintes métricas estão disponíveis:
+ **Falhas** — contabiliza problemas internos durante a execução do trabalho. Use essa métrica para monitorar a estabilidade do serviço e definir alarmes para limites de falha.
+ **Erros** — rastreia problemas relacionados ao cliente durante o processamento do trabalho. Essa métrica ajuda a identificar problemas com as entradas ou configurações do cliente.
+ **Invocações** — Representa o número total de chamadas de tarefas, incluindo tentativas bem-sucedidas e fracassadas. Use isso para acompanhar as tendências de uso do serviço ao longo do tempo.
**nota**
As métricas são reportadas CloudWatch somente quando há atividade no `ResourceSnapshotJob` serviço. Se não houver trabalhos ou dados para uma métrica específica, essa métrica não será relatada.
Para garantir o bom funcionamento da `ResourceSnapshotJob` operação:
+ Use as métricas para verificar se o serviço funciona conforme o esperado.
+ Crie CloudWatch alarmes para monitorar métricas e acionar ações (como enviar notificações) quando as métricas excederem os intervalos aceitáveis.
+ Configure o monitoramento proativo para identificar e resolver problemas.
Para obter mais informações sobre o uso de CloudWatch métricas, consulte o [Guia CloudWatch do usuário da Amazon](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/).