View a markdown version of this page

Utilizzo delle connessioni agli 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à.

Utilizzo delle connessioni agli account partner

I partner possono gestire le connessioni tra i propri account o le connessioni con gli account di altri AWS partner utilizzando l'AWS API 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 passaggio per stabilire una connessione con un partner consiste nel 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 si desidera 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 potergli inviare inviti al coinvolgimento in opportunità di collaborazione

    • SUBSIDIARY: utilizza questo tipo quando desideri collegare più account venditore AWS Marketplace di tua proprietà al tuo account «principale» che hai collegato ad APN o al quale 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 e-mail di contatto per la comunicazione

  • 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 di intervento da parte 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, devi 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, usa l'ListConnectionInvitationsazione con il ParticipantType parametro impostato su. RECEIVER Puoi filtrare per:

  • Tipo di connessione

  • Stato (PENDING,ACCEPTED,REJECTED)

  • Identificatore del mittente

Fase 2: Rivedi i dettagli dell'invito

Utilizza 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 ne spiega lo scopo

  • Tipo di connessione richiesto

  • Data di scadenza

  • Informazioni sul profilo pubblico del mittente

Fase 3: Accettare o rifiutare 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: rifiutare l'invito

Usa l'RejectConnectionInvitationazione se non desideri stabilire la connessione. Facoltativamente, puoi fornire un motivo per il 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 le opzioni di filtro:

  • Filtra per tipo e stato di connessione (ad esempio,) OPPORTUNITY_COLLABORATION:ACTIVE

  • Filtra in base all'identificatore dell'altra parte

  • Visualizza 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 i partner

  • Stato di ogni tipo di connessione (Attiva o Interrotta)

  • Informazioni di contatto contenute nell'invito originale

  • AWS ID di account e ID di profilo pubblico 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 in modo indipendente

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

Terminazione 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

  • Fornisci un motivo per la 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 Terminato. 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 dati storici

  • Può essere visualizzato utilizzando l'API GetConnection

  • 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 entrata

  • Modifiche allo stato degli inviti inviati (ACCEPTED,,) REJECTED EXPIRED

  • Interruzioni della connessione avviate dall'altra parte

Dopo aver ricevuto un evento, utilizza l'azione Get API appropriata per recuperare i dettagli più recenti:

  • GetConnectionInvitationper gli aggiornamenti sugli inviti

  • GetConnectionper aggiornamenti sulla connessione

Eventi possibili

  • Invito alla 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 all'account mittente e al destinatario quando un invito alla connessione scade senza alcuna azione.

  • Invito alla connessione rifiutato: notifica all'account mittente quando l'invito alla connessione viene rifiutato dal destinatario.

  • Invito alla connessione accettato: notifica all'account 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 di invito 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 terminale)
REJECTED Il destinatario ha rifiutato; contiene un motivo facoltativo per il rifiuto Nessuno (stato terminale)
EXPIRED System-expired a causa della mancata 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à commerciali associate sono abilitate
CANCELED Tipo di connessione interrotto da una delle parti

Best practice

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

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

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

  4. Risoluzione corretta: quando terminate una relazione d'affari, utilizzate l' CancelConnection azione con un motivo chiaro per mantenere una comunicazione professionale.

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

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

  7. Attenzione alla sicurezza: ricorda che la creazione di una connessione rivela gli ID degli AWS account tra le parti. Connettiti solo con partner affidabili.

Tipi di connessione e relativi scopi

Tipo di connessione Scopo Caso d'uso
OPPORTUNITY_COLLABORATION Consente la collaborazione su opportunità di co-selling con altri partner Se desideri che altri partner abbiano accesso alla tua opportunità o viceversa, utilizza questo tipo di connessione. Questa connessione consente di inviare inviti alla partecipazione a opportunità a partner connessi.
SUBSIDIARY Stabilisce connessioni tra i tuoi diversi account venditore AWS Marketplace e il tuo account Partner principale Utilizzalo se disponi di più account venditore AWS Marketplace da collegare al tuo account principale dove sei registrato come partner e venditore.