View a markdown version of this page

Lavorare con le connessioni degli account partner - AWS Centrale Partner
Creazione e invio di un invito alla connessioneRicezione e risposta agli inviti di connessioneGestione delle connessioni attiveMonitoraggio degli eventi di connessioneComprensione degli stati di connessioneBest practiceTipi di connessione e relativi scopi

L' Centrale Partner AWS API Reference è stato ristrutturato. Per ulteriori informazioni sulle operazioni API supportate, consulta l'Centrale Partner AWS API Reference.

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

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

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

Creazione e invio di un invito alla connessione

Passaggio 1: creare un invito alla connessione

Il primo passo per stabilire una connessione con un partner è creare e inviare un invito alla connessione utilizzando l'CreateConnectionInvitationazione. 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

Puoi monitorare lo stato degli inviti che hai inviato utilizzando l'ListConnectionInvitationsazione 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)

Se devi ritirare un invito in sospeso prima che venga accettato, puoi utilizzare l'CancelConnectionInvitationazione. 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

Fase 1: Elenca gli inviti in arrivo

Per visualizzare gli inviti alla connessione che hai ricevuto, utilizza l'ListConnectionInvitationsazione 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

Usa l'GetConnectionInvitationazione 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

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

Opzione A: Accetta l'invito

Usa l'AcceptConnectionInvitationazione 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

Usa l'RejectConnectionInvitationazione 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

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

Visualizzazione delle connessioni

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

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

Entrambe le parti possono interrompere un tipo di connessione specifico utilizzando l'azioneCancelConnection. 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

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'GetConnectionAPI

  • Richiede un nuovo invito per ristabilire la relazione

Monitoraggio degli eventi di connessione

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:

  • GetConnectionInvitationper gli aggiornamenti degli inviti

  • GetConnectionper gli aggiornamenti della connessione

Eventi possibili

  • 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

Stati degli inviti alla connessione

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

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

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

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

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

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

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

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

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

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.