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 le connessioni degli account partner
<a name="working-with-account-connections"></a>

I partner possono gestire le connessioni tra i propri account o le connessioni con gli account di altri partner utilizzando l' AWS API AWS Partner Connection. Il processo prevede due fasi:

1. **Fase di invito alla connessione: ** avvio e risposta alle richieste di connessione

1. **Fase di connessione attiva: ** gestione delle connessioni stabilite e delle attività commerciali associate

## Creazione e invio di un invito alla connessione
<a name="creating-and-sending-connection-invitation"></a>

### Passaggio 1: creare un invito alla connessione
<a name="step-1-create-connection-invitation"></a>

Il primo passo per stabilire una connessione con un partner è creare e inviare un invito alla connessione utilizzando l'`CreateConnectionInvitation`azione. Quando si crea un invito, è necessario specificare:
+ **Catalogo: ** il AWS catalogo (AWS o sandbox) in cui verrà gestita la connessione
+ **ConnectionType: ** Il tipo di relazione che desideri stabilire. Seleziona una delle seguenti opzioni:
  + **`OPPORTUNITY_COLLABORATION`: ** utilizza questo tipo quando desideri inviare una richiesta di connessione all'account di un altro partner in modo da poter inviare loro inviti a un'opportunità di coinvolgimento per un'opportunità di collaborazione
  + **`SUBSIDIARY`: ** utilizza questo tipo quando desideri collegare più account venditore di AWS Marketplace di tua proprietà al tuo account «principale» che hai collegato all'APN o dove sei registrato come partner
+ **ReceiverIdentifier: ** l'ID del profilo partner pubblico del destinatario (per il tipo di connessione Opportunity Collaboration) o l'ID AWS dell'account (per il tipo di connessione sussidiaria)
+ **E-mail: ** il tuo indirizzo email di contatto per le comunicazioni
+ **Nome: ** il tuo nome come mittente
+ **Messaggio: ** una descrizione che spiega lo scopo della richiesta di connessione

Una volta creato, l'invito passa allo stato In sospeso, in attesa dell'intervento del destinatario.

**Importante**  
Inviando un invito alla connessione, acconsenti a rivelare l'ID del tuo AWS account al destinatario se accetta l'invito. Questa divulgazione è necessaria per stabilire la connessione a livello di account.

### Fase 2: Monitora gli inviti inviati
<a name="step-2-monitor-sent-invitations"></a>

Puoi monitorare lo stato degli inviti che hai inviato utilizzando l'`ListConnectionInvitations`azione con il `ParticipantType` parametro impostato su. `SENDER` Ciò consente di:
+ Visualizza tutti gli inviti in uscita
+ Filtra per stato (`PENDING`,,`ACCEPTED`,`REJECTED`) `EXPIRED`
+ Filtra per tipo di connessione
+ Controlla gli inviti specifici ad altri partner

### Fase 3: Annullare un invito (opzionale)
<a name="step-3-cancel-invitation"></a>

Se devi ritirare un invito in sospeso prima che venga accettato, puoi utilizzare l'`CancelConnectionInvitation`azione. Note:
+ Puoi annullare gli inviti solo nello stato In sospeso
+ Una volta accettato un invito e stabilita una connessione, non può essere annullato
+ Per terminare una connessione stabilita, è necessario invece utilizzare l'azione `CancelConnection`

## Ricezione e risposta agli inviti di connessione
<a name="receiving-and-responding-to-invitations"></a>

### Fase 1: Elenca gli inviti in arrivo
<a name="list-incoming-invitations"></a>

Per visualizzare gli inviti alla connessione che hai ricevuto, utilizza l'`ListConnectionInvitations`azione con il ParticipantType parametro impostato su. `RECEIVER` Puoi filtrare per:
+ Tipo di connessione
+ Stato (`PENDING`,`ACCEPTED`,`REJECTED`)
+ Identificativo del mittente

### Fase 2: Rivedi i dettagli dell'invito
<a name="review-invitation-details"></a>

Usa l'`GetConnectionInvitation`azione per visualizzare i dettagli completi di un invito specifico, tra cui:
+ Nome e indirizzo email di contatto del mittente
+ Messaggio di invito che spiega lo scopo
+ Tipo di connessione richiesto
+ Data di scadenza
+ Informazioni sul profilo pubblico del mittente

### Fase 3: Accetta o rifiuta l'invito
<a name="accept-or-reject-invitation"></a>

Dopo aver esaminato i dettagli dell'invito, hai due opzioni:

#### Opzione A: Accetta l'invito
<a name="option-a-accept-invitation"></a>

Usa l'`AcceptConnectionInvitation`azione per stabilire la connessione. Quando accetti:
+ Viene creata una nuova connessione nello stato Attivo
+ Lo stato dell'invito cambia in Accettato
+ L'ID AWS del tuo account viene rivelato al mittente
+ Puoi iniziare a condurre attività commerciali abilitate dal tipo di connessione

**Importante**  
**Consenso importante: ** accettando un invito alla connessione, acconsenti a rivelare l'ID del tuo AWS account al mittente. Questa divulgazione è necessaria per stabilire la connessione a livello di account.

#### Opzione B: Rifiuta l'invito
<a name="option-b-reject-invitation"></a>

Usa l'`RejectConnectionInvitation`azione se non desideri stabilire la connessione. Facoltativamente, puoi fornire un motivo del rifiuto. Una volta rifiutato:
+ Lo stato dell'invito cambia in Rifiutato
+ Non viene stabilita alcuna connessione
+ L'invito non comparirà più nell'elenco degli inviti in sospeso

### Scadenza automatica
<a name="automatic-expiration"></a>

Se non viene intrapresa alcuna azione entro il periodo di scadenza, il sistema passa automaticamente allo stato Scaduto. Gli inviti scaduti non possono essere accettati o rifiutati.

## Gestione delle connessioni attive
<a name="managing-active-connections"></a>

### Visualizzazione delle connessioni
<a name="viewing-your-connections"></a>

Una volta stabilita una connessione, entrambe le parti possono visualizzarla e gestirla utilizzando le seguenti azioni:

**`ListConnections`: ** recupera un elenco delle tue connessioni con opzioni di filtro:
+ Filtra per tipo e stato della connessione (ad es.) `OPPORTUNITY_COLLABORATION:ACTIVE`
+ Filtra in base all'identificatore dell'altra parte
+ Visualizza le informazioni di riepilogo per ogni connessione

**`GetConnection`: ** recupera i dettagli completi di una connessione specifica, tra cui:
+ Tutti i tipi di connessione associati a questa relazione con il partner
+ Stato di ciascun tipo di connessione (attiva o terminata)
+ Informazioni di contatto contenute nell'invito originale
+ AWS ID degli account e ID dei profili pubblici di entrambe le parti
+ Timestamp di creazione e terminazione per ogni tipo di connessione

### Aggiungere tipi di connessione a una connessione esistente
<a name="adding-connection-types"></a>

Se hai già una connessione attiva con un partner e desideri stabilire un nuovo tipo di relazione, puoi inviare un nuovo invito alla connessione con un tipo di connessione diverso. Dopo l'accettazione:
+ Il nuovo tipo di connessione viene aggiunto alla connessione esistente
+ Entrambi i tipi di connessione rimangono gestibili indipendentemente
+ Per la relazione viene mantenuto lo stesso ID di connessione

**Nota**  
Può esserci una sola connessione attiva di un determinato tipo tra due account in un determinato catalogo in qualsiasi momento.

### Interruzione dei tipi di connessione
<a name="terminating-connection-types"></a>

Entrambe le parti possono interrompere un tipo di connessione specifico utilizzando l'azione`CancelConnection`. Al termine:
+ Specificare l'ID di connessione e il tipo di connessione da terminare
+ Indicare il motivo della cessazione
+ Lo stato del tipo di connessione cambia in `CANCELED`
+ Gli altri tipi di connessione all'interno della stessa connessione rimangono inalterati

### Interruzione completa della connessione
<a name="complete-connection-termination"></a>

Quando tutti i tipi di connessione all'interno di una connessione vengono terminati, la connessione stessa passa allo stato Terminata. Una connessione completamente terminata:
+ Non può essere riattivata, ma puoi inviare una nuova richiesta di connessione per continuare a lavorare con quell'account
+ Rimane nel sistema per la conservazione dei registri storici
+ Può essere visualizzato utilizzando l'`GetConnection`API
+ Richiede un nuovo invito per ristabilire la relazione

## Monitoraggio degli eventi di connessione
<a name="monitoring-connection-events"></a>

I partner devono monitorare gli eventi relativi alla connessione utilizzando Amazon EventBridge per rimanere informati su:
+ Nuovi inviti alla connessione in arrivo
+ Modifiche allo stato degli inviti inviati (`ACCEPTED`,,) `REJECTED` `EXPIRED`
+ Interruzioni della connessione avviate dall'altra parte

Alla ricezione di un evento, utilizza l'azione Get API appropriata per recuperare i dettagli più recenti:
+ `GetConnectionInvitation`per gli aggiornamenti degli inviti
+ `GetConnection`per gli aggiornamenti della connessione

### Eventi possibili
<a name="possible-events"></a>
+ **Invito di connessione creato: ** notifica all'account del destinatario gli inviti alla connessione in arrivo.
+ **Invito alla connessione annullato: ** notifica all'account del destinatario quando un mittente annulla un invito alla connessione in entrata.
+ **Invito alla connessione scaduto: ** notifica sia l'account del mittente che quello del destinatario quando un invito alla connessione scade senza alcuna azione.
+ **Invito alla connessione rifiutato: ** notifica all'account del mittente quando l'invito alla connessione viene rifiutato dal destinatario.
+ **Invito di connessione accettato: ** notifica all'account del mittente quando l'invito alla connessione viene accettato e viene stabilita una connessione.
+ **Connessione annullata: ** notifica a entrambe le parti connesse quando tutte le connessioni sono terminate completamente.

## Comprensione degli stati di connessione
<a name="understanding-connection-states"></a>

### Stati degli inviti alla connessione
<a name="connection-invitation-states"></a>


| Stato | Description | Può passare a | 
| --- | --- | --- | 
| PENDING | Stato iniziale al momento della creazione; in attesa dell'azione del destinatario | ACCEPTED, REJECTED, EXPIRED, CANCELED | 
| ACCEPTED | Ricevitore accettato; connessione creata | Nessuno (stato del terminale) | 
| REJECTED | Ricevitore rifiutato; contiene un motivo opzionale per il rifiuto | Nessuno (stato del terminale) | 
| EXPIRED | System-expired a causa di nessuna azione entro il periodo di scadenza | Nessuno (stato terminale) | 
| CANCELED | Il mittente ha ritirato l'invito prima dell'accettazione | Nessuno (stato terminale) | 

### Stati del tipo di connessione
<a name="connection-type-states"></a>


| Stato | Description | 
| --- | --- | 
| ACCEPTED | Il tipo di connessione è operativo; le attività aziendali associate sono abilitate | 
| CANCELED | Tipo di connessione terminato da una delle parti | 

## Best practice
<a name="best-practices"></a>

1. **Comunicazione chiara: negli inviti alla connessione ** fornisci messaggi chiari e dettagliati che spieghino lo scopo e la collaborazione prevista.

1. **Risposte tempestive: ** monitora e rispondi tempestivamente agli inviti alla connessione per evitare la scadenza automatica.

1. **Revisione ** periodica: controlla periodicamente le connessioni attive per assicurarti che rimangano pertinenti alle tue attuali esigenze aziendali.

1. **Risoluzione corretta: ** quando si termina un rapporto commerciale, utilizza l' CancelConnection azione con un chiaro motivo per mantenere una comunicazione professionale.

1. **Monitoraggio degli eventi: ** imposta EventBridge regole per ricevere automaticamente notifiche sulle modifiche allo stato della connessione, per rimanere informati sugli aggiornamenti importanti.

1. **Gestione del tipo di connessione: ** considera quali tipi di connessione sono necessari prima di stabilire le connessioni, poiché ogni tipo abilita funzionalità aziendali diverse.

1. **Consapevolezza della sicurezza: ** ricorda che la creazione di una connessione rivela gli ID degli AWS account tra le parti. Connettiti solo con partner fidati.

## Tipi di connessione e relativi scopi
<a name="connection-types-and-purposes"></a>


| Tipo di connessione | Scopo | Caso d'uso | 
| --- | --- | --- | 
| OPPORTUNITY\_COLLABORATION | Consente la collaborazione su opportunità di co-vendita con altri partner | Se desideri che un altro partner abbia accesso alla tua opportunità o viceversa, utilizza questo tipo di connessione. Questa connessione ti consente di inviare inviti a un'opportunità di coinvolgimento ai partner connessi. | 
| SUBSIDIARY | Stabilisce connessioni tra i tuoi diversi account venditore di AWS Marketplace e il tuo account Partner principale | Utilizzalo quando disponi di più Account venditore AWS Marketplace da collegare al tuo account principale in cui sei registrato come partner e venditore. |