View a markdown version of this page

Utilisation des connexions aux comptes partenaires - AWS Partner Central
Création et envoi d'une invitation de connexionRecevoir des invitations de connexion et y répondreGestion des connexions activesSurveillance des événements de connexionComprendre les états de connexionBonnes pratiquesLes types de connexion et leurs objectifs

La référence de AWS Partner Central l'API a été restructurée. Pour plus d'informations sur les opérations d'API prises en charge, consultez la référence des AWS Partner Central API.

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

Utilisation des connexions aux comptes partenaires

Les partenaires peuvent gérer les connexions entre leurs propres comptes ou les connexions avec les AWS comptes d'autres partenaires à l'aide de l'API AWS Partner Connection. Le processus comporte deux phases :

  1. Phase d'invitation à la connexion : lancement et réponse aux demandes de connexion

  2. Phase de connexion active : gestion des connexions établies et des activités commerciales associées

Création et envoi d'une invitation de connexion

Étape 1 : créer une invitation de connexion

La première étape pour établir une connexion partenaire consiste à créer et à envoyer une invitation de connexion à l'aide de l'CreateConnectionInvitationaction. Lors de la création d'une invitation, vous devez spécifier :

  • Catalogue : le AWS catalogue (AWS ou Sandbox) dans lequel la connexion sera gérée

  • ConnectionType: type de relation que vous souhaitez établir. Sélectionnez l’une des méthodes suivantes :

    • OPPORTUNITY_COLLABORATION: utilisez ce type lorsque vous souhaitez envoyer une demande de connexion au compte d'un autre partenaire afin de lui envoyer des invitations à participer à une opportunité de collaboration

    • SUBSIDIARY: utilisez ce type lorsque vous souhaitez connecter plusieurs comptes vendeurs AWS Marketplace que vous possédez à votre compte « principal » que vous avez associé à APN ou sur lequel vous êtes enregistré en tant que partenaire

  • ReceiverIdentifier: ID de profil de partenaire public du destinataire (pour le type de connexion Opportunity Collaboration) ou ID de AWS compte (pour le type de connexion filiale)

  • Email : Votre adresse e-mail de contact pour la communication

  • Nom : votre nom en tant qu'expéditeur

  • Message : description expliquant l'objectif de la demande de connexion

Une fois créée, l'invitation passe à l'état En attente, dans l'attente d'une action de la part du destinataire.

Important

En envoyant une invitation de connexion, vous consentez à révéler l'identifiant de votre AWS compte au destinataire s'il accepte l'invitation. Cette divulgation est nécessaire pour établir la connexion au niveau du compte.

Étape 2 : Surveillez vos invitations envoyées

Vous pouvez suivre l'état des invitations que vous avez envoyées à l'aide de l'ListConnectionInvitationsaction dont le ParticipantType paramètre est réglé surSENDER. Cela vous permet de :

  • Afficher toutes les invitations sortantes

  • Filtrer par statut (PENDINGACCEPTED,REJECTED,EXPIRED)

  • Filtrer par type de connexion

  • Consultez les invitations spécifiques à d'autres partenaires

Étape 3 : Annuler une invitation (facultatif)

Si vous devez retirer une invitation en attente avant qu'elle ne soit acceptée, vous pouvez utiliser cette CancelConnectionInvitation action. Remarque :

  • Vous ne pouvez annuler les invitations qu'à l'état En attente

  • Une fois qu'une invitation est acceptée et qu'une connexion est établie, elle ne peut pas être annulée

  • Pour mettre fin à une connexion établie, vous devez utiliser l'CancelConnectionaction à la place

Recevoir des invitations de connexion et y répondre

Étape 1 : Répertorier les invitations entrantes

Pour afficher les invitations de connexion que vous avez reçues, utilisez l'ListConnectionInvitationsaction dont le ParticipantType paramètre est défini surRECEIVER. Vous pouvez filtrer par :

  • Type de connexion

  • État (PENDING,ACCEPTED,REJECTED)

  • Identifiant de l'expéditeur

Étape 2 : Vérifiez les détails de l'invitation

Utilisez cette GetConnectionInvitation action pour afficher les détails complets d'une invitation spécifique, notamment :

  • Nom et e-mail de contact de l'expéditeur

  • Message d'invitation expliquant le but

  • Type de connexion demandé

  • Date d’expiration

  • Informations sur le profil public de l'expéditeur

Étape 3 : Accepter ou rejeter l'invitation

Après avoir examiné les détails de l'invitation, deux options s'offrent à vous :

Option A : Accepter l'invitation

Utilisez cette AcceptConnectionInvitation action pour établir la connexion. Lorsque vous acceptez :

  • Une nouvelle connexion est créée à l'état Actif

  • Le statut de l'invitation passe à Acceptée

  • L'identifiant de votre AWS compte est révélé à l'expéditeur

  • Vous pouvez commencer à mener des activités commerciales activées par le type de connexion

Important

Consentement important : En acceptant une invitation de connexion, vous consentez à révéler votre identifiant de AWS compte à l'expéditeur. Cette divulgation est nécessaire pour établir la connexion au niveau du compte.

Option B : Refuser l'invitation

Utilisez cette RejectConnectionInvitation action si vous ne souhaitez pas établir la connexion. Vous pouvez éventuellement fournir un motif de rejet. Une fois rejeté :

  • Le statut de l'invitation passe à Rejeté

  • Aucune connexion n'est établie

  • L'invitation n'apparaîtra plus dans votre liste d'invitations en attente

Expiration automatique

Si aucune action n'est entreprise pendant la période d'expiration, le système fait automatiquement passer l'invitation à l'état Expiré. Les invitations expirées ne peuvent être ni acceptées ni rejetées.

Gestion des connexions actives

Affichage de vos connexions

Une fois la connexion établie, les deux parties peuvent la visualiser et la gérer à l'aide des actions suivantes :

ListConnections: récupérez la liste de vos connexions avec des options de filtrage :

  • Filtrer par type de connexion et statut (par exemple,OPPORTUNITY_COLLABORATION:ACTIVE)

  • Filtrer par identifiant de l'autre partie

  • Afficher les informations récapitulatives pour chaque connexion

GetConnection: récupérez les détails complets d'une connexion spécifique, notamment :

  • Tous les types de connexion associés à cette relation de partenariat

  • État de chaque type de connexion (actif ou terminé)

  • Informations de contact figurant sur l'invitation originale

  • AWS identifiants de compte et identifiants de profil public des deux parties

  • Horodatages de création et de fin pour chaque type de connexion

Ajouter des types de connexion à une connexion existante

Si vous avez déjà une connexion active avec un partenaire et que vous souhaitez établir un nouveau type de relation, vous pouvez envoyer une nouvelle invitation de connexion avec un type de connexion différent. Lors de l'acceptation :

  • Le nouveau type de connexion est ajouté à la connexion existante

  • Les deux types de connexion restent gérables indépendamment

  • Le même ID de connexion est conservé pour la relation

Note

Il ne peut y avoir qu'une seule connexion active d'un type donné entre deux comptes d'un catalogue donné à la fois.

Types de connexion de terminaison

Chaque partie peut mettre fin à un type de connexion spécifique à l'aide de CancelConnection cette action. En cas de résiliation :

  • Spécifiez l'ID de connexion et le type de connexion à terminer

  • Indiquez le motif du licenciement

  • L'état du type de connexion passe à CANCELED

  • Les autres types de connexion au sein de la même connexion ne sont pas affectés

Résiliation complète de la connexion

Lorsque tous les types de connexion d'une connexion sont interrompus, la connexion elle-même passe à l'état Terminé. Une connexion complètement interrompue :

  • Ne peut pas être réactivé, mais vous pouvez envoyer une nouvelle demande de connexion pour continuer à utiliser ce compte

  • Demeure dans le système pour la tenue des dossiers historiques

  • Peut être consulté à l'aide de l'GetConnectionAPI

  • Nécessite une nouvelle invitation pour rétablir la relation

Surveillance des événements de connexion

Les partenaires doivent surveiller les événements liés à la connexion à l'aide d'Amazon EventBridge pour rester informés des points suivants :

  • Nouvelles invitations de connexion entrante

  • Changements de statut des invitations envoyées (ACCEPTED,REJECTED,EXPIRED)

  • Terminaisons de connexion initiées par l'autre partie

Lorsque vous recevez un événement, utilisez l'action Get API appropriée pour récupérer les informations les plus récentes :

  • GetConnectionInvitationpour les mises à jour des invitations

  • GetConnectionpour les mises à jour de connexion

Évènements possibles

  • Invitation de connexion créée  : Informe le compte destinataire des invitations de connexion entrantes.

  • Invitation de connexion annulée : avertit le compte du destinataire lorsqu'un expéditeur annule une invitation de connexion entrante.

  • Invitation de connexion expirée : avertit les comptes expéditeur et destinataire lorsqu'une invitation de connexion expire sans action.

  • Invitation de connexion rejetée : avertit le compte de l'expéditeur lorsque son invitation de connexion est rejetée par le destinataire.

  • Invitation de connexion acceptée : avertit le compte expéditeur lorsque son invitation de connexion est acceptée et qu'une connexion est établie.

  • Connexion annulée : avertit les deux parties connectées lorsqu'une connexion est complètement interrompue.

Comprendre les états de connexion

États d'invitation à la connexion

State Description Peut passer à
PENDING État initial lors de la création ; en attente d'une action du récepteur ACCEPTED, REJECTED, EXPIRED, CANCELED
ACCEPTED Récepteur accepté ; connexion créée Aucun (état terminal)
REJECTED Le destinataire a refusé ; contient un motif de rejet facultatif Aucun (état terminal)
EXPIRED System-expired en raison de l'absence d'action pendant la période d'expiration Aucun (état terminal)
CANCELED L'expéditeur a retiré l'invitation avant son acceptation Aucun (état terminal)

États du type de connexion

State Description
ACCEPTED Le type de connexion est opérationnel ; les activités commerciales associées sont activées
CANCELED Type de connexion interrompu par l'une ou l'autre des parties

Bonnes pratiques

  1. Communication claire : Fournissez des messages clairs et détaillés dans vos invitations de connexion expliquant l'objectif et la collaboration attendue.

  2. Réponses rapides : surveillez et répondez rapidement aux invitations de connexion pour éviter leur expiration automatique.

  3. Révision régulière : passez régulièrement en revue vos connexions actives pour vous assurer qu'elles restent pertinentes par rapport aux besoins actuels de votre entreprise.

  4. Résiliation appropriée : lorsque vous mettez fin à une relation commerciale, utilisez l' CancelConnection action avec une raison claire pour maintenir une communication professionnelle.

  5. Surveillance des événements : définissez des EventBridge règles pour recevoir automatiquement des notifications en cas de modification de l'état de la connexion, afin de rester informé des mises à jour importantes.

  6. Gestion des types de connexion : déterminez quels types de connexion sont nécessaires avant d'établir des connexions, car chaque type permet des fonctionnalités métier différentes.

  7. Sensibilisation à la sécurité : n'oubliez pas que l'établissement d'une connexion révèle les identifiants de AWS compte entre les parties. Communiquez uniquement avec des partenaires de confiance.

Les types de connexion et leurs objectifs

Type de connexion Objectif Cas d’utilisation
OPPORTUNITY_COLLABORATION Permet la collaboration sur les opportunités de co-vente avec d'autres partenaires Lorsque vous souhaitez que d'autres partenaires aient accès à votre opportunité ou vice versa, utilisez ce type de connexion. Cette connexion vous permet d'envoyer des invitations à participer à des opportunités aux partenaires connectés.
SUBSIDIARY Établit des liens entre vos multiples comptes vendeurs AWS Marketplace et votre compte partenaire principal À utiliser lorsque vous possédez plusieurs comptes vendeurs AWS Marketplace que vous souhaitez connecter à votre compte principal sur lequel vous êtes enregistré en tant que partenaire et vendeur.