L' Centrale Partner AWS API Reference è stato ristrutturato. Per ulteriori informazioni sulle operazioni API supportate, consulta l'[Centrale Partner AWS API Reference.](https://docs.aws.amazon.com/partner-central/latest/APIReference/Welcome.html)
Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.
# Lavorare con opportunità multipartner
AWS Partner s può lavorare insieme sulle opportunitàAWS come partecipante attivo.
**Topics**
+ [Impegni e istantanee](#engagements-and-snapshots)
+ [Creazione di una politica personalizzata per ResourceSnapshotJobRole](#creating-custom-policy-resourcesnapshotjobrole)
+ [Invitare i partner a cogliere un'opportunità](#inviting-partners-to-an-opportunity)
+ [Recupero dei dettagli dell'invito al fidanzamento](#retrieving-invitation-details)
+ [Rispondere a un invito di fidanzamento](#responding-engagement-invitation)
+ [Revisione e aggiornamento delle opportunità multipartner](#reviewing-and-updating-multipartner-opportunities)
+ [Utilizzo delle istantanee per ricevere gli aggiornamenti dei partner](#using-snapshots-to-receive-partner-updates)
+ [Visualizzazione dei membri del coinvolgimento](#viewing-engagement-members)
+ [Monitoraggio dello stato del processo di snapshot delle risorse](#monitoring-resource-snapshot-job-status)
## Impegni e istantanee
Un *coinvolgimento* è una risorsa di proprietà di proprietàAWS per la collaborazione tra piùAWS Partner account e AWS su un'opportunità per i clienti. Gli impegni facilitano la condivisione sicura delle informazioni tra i partner e la collaborazione, mantenendo al contempo la proprietà e il controllo delle opportunità individuali. Gli impegni comprendono opportunità che provengono da entrambi i partner, in qualità di AWS partecipanti attivi.AWS I partner possono invitare AWS o altri partner a partecipare a un coinvolgimento utilizzando. `EngagementInvitations` Quando i partner invitati accettano, ricevono la propria opportunità nell'ambito dello stesso impegno.
I membri di Engagement condividono i progressi tramite istantanee, copie istantanee e immutabili di campi specifici provenienti da una risorsa sottostante come un'opportunità. Le istantanee vengono create all'interno del coinvolgimento e condivise con i membri. Quando la risorsa sottostante cambia, il proprietario può creare una nuova revisione dell'istantanea per riflettere gli aggiornamenti.AWS fornisce lavori istantanei, ovvero lavori di proprietà del cliente che creano automaticamente nuove revisioni quando la risorsa cambia. Una volta condivise, le istantanee rimangono accessibili in modo permanente ai membri del coinvolgimento.
## Creazione di una politica personalizzata per ResourceSnapshotJobRole
La collaborazione su opportunità con più partner richiede la condivisione di istantanee delle opportunità con altri partner coinvolti in un progetto. Per mantenere l'accesso ai dettagli delle opportunità più recenti, devi creare un ruolo personalizzato chiamato. `ResourceSnapshotJobRole` Questo ruolo consente al sistema di creare istantanee delle tue opportunità per tuo conto e di recuperare istantanee da altri partner coinvolti nello stesso incarico. Senza questo ruolo, gli aggiornamenti che apporterai alla tua opportunità non saranno visibili agli altri partner coinvolti nel progetto, che continueranno a visualizzare istantanee obsolete dei dati relativi alle opportunità.
**Nota**
Puoi usare un nome diverso da. `ResourceSnapshotJobRole` Se utilizzi un nome diverso, sostituisci tutte le istanze delle `ResourceSnapshotJobRole` seguenti politiche con il nome della tua politica.
Per creare questo ruolo, accedi alla tua console IAM e crea il `ResourceSnapshotJobRole` ruolo con la seguente policy di fiducia personalizzata:
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Principal": {
"Service": "resource-snapshot-job.partnercentral-selling.amazonaws.com"
},
"Action": "sts:AssumeRole"
}
]
}
```
------
Dopo aver creato questo ruolo, devi allegare la policy [AWSPartnerCentralSellingResourceSnapshotJobExecutionRolePolicy](https://docs.aws.amazon.com/aws-managed-policy/latest/reference/AWSPartnerCentralSellingResourceSnapshotJobExecutionRolePolicy.html)AWS gestita o allegare la seguente politica di autorizzazioni:
------
#### [ 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/*"
]
}
]
}
```
------
Sostituisci `{account}` con il tuo ID account AWS.
Dopo aver creato il `ResourceSnapshotJobRole` ruolo e aver associato le autorizzazioni, è necessario impostarle `ResourceSnapshotJobRole` per l'organizzazione. Utilizza l'[PutSellingSystemSettings](https://docs.aws.amazon.com/partner-central/latest/APIReference/API_PutSellingSystemSettings.html)azione per impostare il ruolo che hai creato come ruolo `ResourceSnapshotJobRole` per la tua azienda (identificato dal tuo AWS account):
```
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"
}
```
Sostituiscilo `{account}` con l'ID del tuo AWS account e `ResourceSnapshotJobRole` con il nome del ruolo che hai creato. Questo ruolo verrà assunto implicitamente dalla risorsa snapshot jobs per accedere alle tue opportunità e creare istantanee da condividere con altri partner coinvolti nel progetto.
## Invitare i partner a cogliere un'opportunità
I partner possono collaborare sulle opportunità offerte da entrambi i partner e AWS lanciando un invito al coinvolgimento. Puoi invitare un massimo di nove partner a un'opportunità.
**Per invitare i partner a cogliere un'opportunità**
1. Segui i passaggi descritti in [Ricerca e contatto con i AWS partner nella Partner](https://docs.aws.amazon.com/partner-central/latest/sales-guide/partner-connections.html#finding-partners) *Central Sales Guide*. È necessario entrare in contatto con i partner prima di poterli invitare a cogliere opportunità. Questa connessione garantisce l'accesso reciproco agli ID degli account degli altri, garantendo che gli inviti raggiungano l'account partner desiderato.
1. Usa l'[StartEngagementFromOpportunityTask](https://docs.aws.amazon.com/partner-central/latest/APIReference/API_StartEngagementFromOpportunityTask.html)azione per creare un coinvolgimento e associarlo a un'opportunità. Questa azione asincrona esegue le seguenti attività in sequenza:
1. Crea un coinvolgimento.
1. Associa l'opportunità al coinvolgimento.
1. Richiama l'azione a. [CreateEngagementInvitation](https://docs.aws.amazon.com/partner-central/latest/APIReference/API_CreateEngagementInvitation.html)AWS
1. Invia l'opportunità a.AWS
1. Avvia la creazione `ResourceSnapshotJob` di istantanee.
1. Invita altri partner a partecipare.
1. Per associare l'ID di coinvolgimento alla tua opportunità, utilizza l'[ListEngagementFromOpportunityTasks](https://docs.aws.amazon.com/partner-central/latest/APIReference/API_ListEngagementFromOpportunityTasks.html)azione, filtrata in base a quella `TaskIdentifier` restituita nel passaggio precedente.
1. Utilizza l'ID di coinvolgimento e l'ID account del partner ricevente con `CreateEngagementInvitation` cui inviare un invito.
Un invito andato a buon fine invia un evento creato con un invito al fidanzamento al partner ricevente.
## Recupero dei dettagli dell'invito al fidanzamento
Quando ricevi un evento creato con un invito di fidanzamento, utilizza l'[GetEngagementInvitation](https://docs.aws.amazon.com/partner-central/latest/APIReference/API_GetEngagementInvitation.html)azione per recuperare i dettagli dell'invito. La risposta include informazioni essenziali sull'opportunità per i clienti associata al coinvolgimento.
Controlla i dettagli dell'invito, in particolare i `Project.CustomerBusinessProblem` campi `InvitationMessage` `Project.Title``Project.CustomerUseCase`,, e. Queste informazioni forniscono un contesto sull'opportunità offerta ai clienti e sulle aspettative di collaborazione del partner invitante.
Utilizzate questi dettagli per valutare se volete cogliere l'opportunità accettando o rifiutando l'invito al fidanzamento.
## Rispondere a un invito di fidanzamento
Quando un partner ti invia un invito di fidanzamento, crea un evento creato da un invito di fidanzamento che ti avvisa dell'invito. Hai la possibilità di accettare o rifiutare l'invito. Questa decisione determina il tuo coinvolgimento nell'opportunità multipartner.
**Per rifiutare un invito di fidanzamento:**
Usa l'[RejectEngagementInvitation](https://docs.aws.amazon.com/partner-central/latest/APIReference/API_RejectEngagementInvitation.html)azione per rifiutare l'invito. Devi fornire un `RejectionReason` parametro che spieghi la tua decisione. Una volta rifiutato, perdi l'accesso ai dettagli dell'invito e un evento di fidanzamento rifiutato notifica al partner mittente che hai rifiutato il suo invito.
**Per accettare un invito di fidanzamento:**
Per accettare l'invito e procedere con l'opportunità multipartner, utilizza l'[StartEngagementByAcceptingInvitationTask](https://docs.aws.amazon.com/partner-central/latest/APIReference/API_StartEngagementByAcceptingInvitationTask.html)azione. Questa azione asincrona esegue le seguenti attività in sequenza:
1. Accetta l'invito al fidanzamento.
1. Crea una nuova opportunità nel tuo account partner utilizzando i dati dell'opportunità del partner mittente. Riceverai un evento creato da un'opportunità.
1. Include dettagli aggiuntivi necessari per identificare il cliente nel tuo account.
1. Pubblica un evento di fidanzamento accettato con invito al fidanzamento che notifica al partner che hai accettato l'invito e che sei stato aggiunto al coinvolgimento.
**Invito di fidanzamento scaduto**
Se non rispondi a un invito di fidanzamento entro quindici giorni, questo scade e non puoi partecipare all'opportunità multipartner. Un evento di invito di fidanzamento scaduto notifica al partner mittente che l'invito è scaduto.
**Nota**
Se desideri continuare a collaborare, il partner mittente deve avviare un nuovo invito al coinvolgimento.
## Revisione e aggiornamento delle opportunità multipartner
Quando un partner avvia una collaborazione su un'opportunità, lo stato di revisione dell'opportunità appena creata nell'account del partner ricevente è determinato dallo stato dell'opportunità del partner mittente.
**Opportunità con stato di revisione inviata:**
Se l'opportunità del partner mittente è `Lifecycle.ReviewStatus` impostata su`Submitted`, si verifica la seguente procedura:
1. La nuova opportunità creata nell'account del partner ricevente sarà `Lifecycle.ReviewStatus` impostata su`Submitted`.
1. Lo `Submitted` status rimane valido fino a quando non si presenta l'opportunità del partner mittente`Approved`.
1. Una volta convalidata l'opportunità del partner mittente e `Lifecycle.ReviewStatus` impostata`Approved`, le opportunità degli altri partner erediteranno automaticamente lo status. `Approved`
Questo processo garantisce dettagli coerenti sulle opportunità tra più partner, eliminando la necessità di revisioni multiple.
Una volta completato, un evento creato da un'opportunità viene attivato con l'ID dell'opportunità corrispondente. I partner possono utilizzare questo ID con l'`GetOpportunity`azione per recuperare i dettagli completi dell'opportunità.
**Opportunità con stato di revisione approvata:**
Se il partner mittente avvia un impegno su un'opportunità con `Lifecycle.ReviewStatus` set to`Approved`, si verifica il seguente processo:
1. La nuova opportunità creata nell'account del partner ricevente sarà `Lifecycle.ReviewStatus` impostata su. `Approved`
1. Un evento creato da un'opportunità viene attivato con l'ID dell'opportunità corrispondente.
1. I partner possono utilizzare l'[GetOpportunity](https://docs.aws.amazon.com/partner-central/latest/APIReference/API_GetOpportunity.html)azione con l'ID dell'opportunità per recuperare tutti i dettagli dell'opportunità.
Tuttavia, l'opportunità approvata potrebbe non avere alcuni dettagli specifici del partner che non siano stati copiati dall'opportunità del partner mittente. Il partner ricevente deve aggiornare questi dettagli utilizzando l'[UpdateOpportunity](https://docs.aws.amazon.com/partner-central/latest/APIReference/API_UpdateOpportunity.html)azione quando la fase relativa all'opportunità viene aggiornata `Qualified` o in una fase successiva:
+ `Project.CustomerUseCase`
+ `Project.DeliveryModels`
+ `Solution`
+ `PrimaryNeedsFromAws`
+ `LifeCycle.TargetCloseDate`
+ `Project.ExpectedCustomerSpend.Amount`
+ `Project.ExpectedCustomerSpend.Currency`
+ `Marketing.source`
+ `Marketing.AwsFundingUsed`
Una volta creata l'opportunità nell'account del partner ricevente, può essere gestita e aggiornata come qualsiasi altra opportunità all'interno del sistema del partner. I partner possono utilizzare l'[UpdateOpportunity](https://docs.aws.amazon.com/partner-central/latest/APIReference/API_UpdateOpportunity.html)azione per apportare modifiche o fornire ulteriori informazioni sul loro coinvolgimento nell'opportunità.
## Utilizzo delle istantanee per ricevere gli aggiornamenti dei partner
Nell'ambito di un impegno, i partner mantengono e aggiornano le proprie opportunità in modo indipendente. Quando qualcuno rivede le risorse di un coinvolgimento, ad esempio aggiungendo un'opportunità, viene pubblicata un'istantanea dell'evento creato da una risorsa di coinvolgimento.
Per rimanere informati sulle modifiche e accedere alle informazioni più aggiornate relative alle opportunità offerte da altri partner, puoi utilizzare le seguenti azioni:
+ [ListEngagementResourceAssociations](https://docs.aws.amazon.com/partner-central/latest/APIReference/API_ListEngagementResourceAssociations.html)— Utilizzare questa azione per recuperare l'ID di coinvolgimento associato all'opportunità.
+ [ListResourceSnapshots](https://docs.aws.amazon.com/partner-central/latest/APIReference/API_ListResourceSnapshots.html)— Utilizzate questa azione per recuperare un elenco completo di tutte le opportunità associate al coinvolgimento, fornendo una panoramica delle istantanee disponibili per tutti i partner.
+ [GetResourceSnapshot](https://docs.aws.amazon.com/partner-central/latest/APIReference/API_GetResourceSnapshot.html)— Utilizzate questa azione per ottenere riepiloghi in tempo reale di istantanee di opportunità specifiche, in modo da visualizzare le informazioni più aggiornate senza accedere direttamente all'opportunità di un altro partner.
Se identifichi modifiche o aggiornamenti pertinenti relativi all'opportunità di un altro partner che dovrebbero riflettersi nella tua, utilizza l'azione. [UpdateOpportunity](https://docs.aws.amazon.com/partner-central/latest/APIReference/API_UpdateOpportunity.html) Questa azione facilita l'integrazione selettiva dei dati pertinenti nella tua opportunità, garantendo l'allineamento e la coerenza in tutto il coinvolgimento.
## Visualizzazione dei membri del coinvolgimento
Un coinvolgimento su un'opportunità multipartner può avere fino a dieci partner. Ogni volta che un nuovo partner accetta l'invito al coinvolgimento, viene pubblicato un evento aggiunto a un membro del coinvolgimento, che notifica la modifica a tutti i membri attuali.
Per visualizzare tutti i membri che collaborano all'interno di un impegno, segui questi passaggi:
1. Utilizza l'[ListEngagementResourceAssociations](https://docs.aws.amazon.com/partner-central/latest/APIReference/API_ListEngagementResourceAssociations.html)azione per recuperare l'ID di coinvolgimento associato all'opportunità.
1. Fornisci l'ID dal passaggio 1 all'[ListEngagementMembers](https://docs.aws.amazon.com/partner-central/latest/APIReference/API_ListEngagementMembers.html)azione per recuperare i dettagli dei partner dei membri del coinvolgimento.
**Nota**
Solo i membri di un coinvolgimento possono richiamare l'azione`ListEngagementMembers`.
## Monitoraggio dello stato del processo di snapshot delle risorse
Quando lavori con opportunità multipartner, devi creare un ruolo che ti consenta di creare istantanee delle tue opportunità per altri partner e recuperare istantanee delle opportunità da altri partner coinvolti in un coinvolgimento. Senza questo ruolo, gli aggiornamenti che apporti alla tua opportunità non saranno disponibili per gli altri partner coinvolti nel coinvolgimento, che continueranno a vedere istantanee obsolete della tua opportunità.
Per tenere traccia dello stato delle offerte di lavoro basate sull'istantanea delle risorse associate a un'opportunità multipartner nell'ambito di un coinvolgimento, procedi nel seguente modo:
1. Utilizza l'[ListEngagementResourceAssociations](https://docs.aws.amazon.com/partner-central/latest/APIReference/API_ListEngagementResourceAssociations.html)azione per recuperare l'ID di coinvolgimento associato all'opportunità.
1. Fornisci l'ID dal passaggio 1 all'[ListResourceSnapshotJobs](https://docs.aws.amazon.com/partner-central/latest/APIReference/API_ListResourceSnapshotJobs.html)azione per generare un elenco di tutti i lavori istantanei di proprietà del chiamante coinvolto nel coinvolgimento. Recupera l'ID del lavoro dalla risposta.
1. Fornisci l'ID del lavoro all'[GetResourceSnapshotJob](https://docs.aws.amazon.com/partner-central/latest/APIReference/API_GetResourceSnapshotJob.html)azione per monitorare lo stato del lavoro e vedere se è in esecuzione.
L'`ResourceSnapshotJob`operazione pubblica i parametri su Amazon CloudWatch per le sue operazioni asincrone. CloudWatch elabora i dati in metriche leggibili e quasi in tempo reale per aiutarti a monitorare le prestazioni e lo stato del servizio.
Sono disponibili i seguenti parametri:
+ **Guasti**: conta i problemi interni durante l'esecuzione del lavoro. Utilizzate questa metrica per monitorare la stabilità del servizio e impostare allarmi per le soglie di errore.
+ **Errori**: tiene traccia dei problemi relativi ai clienti durante l'elaborazione del lavoro. Questa metrica aiuta a identificare i problemi relativi agli input o alle configurazioni dei clienti.
+ **Richiamazioni: rappresenta il numero totale di chiamate** di lavoro, inclusi i tentativi riusciti e quelli falliti. Utilizzatelo per tenere traccia delle tendenze di utilizzo del servizio nel tempo.
**Nota**
Le metriche vengono riportate CloudWatch solo quando c'è attività nel `ResourceSnapshotJob` servizio. Se non ci sono lavori o non ci sono dati per una metrica specifica, tale metrica non viene segnalata.
Per garantire il corretto funzionamento dell'`ResourceSnapshotJob`operazione:
+ Utilizza le metriche per verificare che il servizio funzioni come previsto.
+ Crea CloudWatch allarmi per monitorare le metriche e attivare azioni (come l'invio di notifiche) quando le metriche superano gli intervalli accettabili.
+ Imposta un monitoraggio proattivo per identificare e risolvere i problemi.
Per ulteriori informazioni sull'utilizzo delle CloudWatch metriche, consulta la [Amazon CloudWatch User Guide](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/).