View a markdown version of this page

Travailler avec des connexions de comptes partenaires - AWS Partner Central
Création et envoi d'une invitation de connexionRéception et réponse aux invitations de connexionGestion des connexions activesSurveillance des événements de connexionComprendre les états de connexionBonnes pratiquesLes types de connexion et leurs objectifs

La référence AWS Partner Central d'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.

Travailler avec des connexions de 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 de leurs 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 de l'établissement d'une connexion partenaire consiste à créer et à envoyer une invitation de connexion à l'aide de l'CreateConnectionInvitationaction. Lorsque vous créez une invitation, vous devez spécifier :

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

  • ConnectionType: le 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 à un engagement pour 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é à l'APN ou sur lequel vous êtes enregistré en tant que partenaire

  • ReceiverIdentifier: ID de profil 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 le but de la demande de connexion

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

Important

En envoyant une invitation de connexion, vous consentez à révéler votre identifiant de 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 le statut des invitations que vous avez envoyées à l'aide de l'ListConnectionInvitationsaction dont le ParticipantType paramètre est défini surSENDER. Cela vous permet de :

  • Afficher toutes les invitations sortantes

  • Filtrer par statut (PENDING,ACCEPTED,REJECTED,EXPIRED)

  • Filtrer par type de connexion

  • Vérifiez les invitations spécifiques adressées à 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 que si l'état est 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 plutôt utiliser l'CancelConnectionaction

Réception et réponse aux invitations de connexion

Étape 1 : Répertorier les invitations entrantes

Pour consulter 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 adresse e-mail de contact de l'expéditeur

  • Message d'invitation expliquant l'objectif

  • Type de connexion demandé

  • Date d’expiration

  • Informations de 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 l'AcceptConnectionInvitationaction 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. En cas de 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

Afficher vos connexions

Une fois la connexion établie, les deux parties peuvent la consulter 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 par état (par exemple,OPPORTUNITY_COLLABORATION:ACTIVE)

  • Filtrer en fonction de l'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 (active ou interrompue)

  • Informations de contact figurant sur l'invitation originale

  • AWS les identifiants de compte et les 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 autre type de connexion. 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 identifiant 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 dans un catalogue donné à la fois.

Types de connexion de terminaison

L'une ou l'autre des parties 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 de la résiliation

  • 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

Fin 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

  • Reste 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 afin de rester informés des points suivants :

  • Nouvelles invitations de connexion entrantes

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

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

À la réception d'un événement, utilisez l'action Get API appropriée pour obtenir les derniers détails :

  • GetConnectionInvitationpour les mises à jour des invitations

  • GetConnectionpour les mises à jour de connexion

Évènements possibles

  • Invitation de connexion créée : avertit le compte du 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 de l'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 lorsque toutes les connexions sont complètement interrompues.

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 du terminal)
REJECTED Destinataire refusé ; contient un motif de rejet facultatif Aucun (état du terminal)
EXPIRED System-expired en raison de l'absence d'action pendant la période d'expiration Aucun (état du terminal)
CANCELED L'expéditeur a retiré l'invitation avant son acceptation Aucun (état du 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 terminé par l'une ou l'autre des parties

Bonnes pratiques

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

  2. Réponses rapides : surveillez les invitations de connexion et répondez-y rapidement 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 répondent toujours 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 : configurez 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 offre des fonctionnalités commerciales différentes.

  7. Sensibilisation à la sécurité : N'oubliez pas que l'établissement d'une connexion révèle les identifiants des AWS comptes entre les parties. Connectez-vous uniquement à 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 covente avec d'autres partenaires Si vous souhaitez qu'un autre partenaire ait accès à votre opportunité ou vice versa, utilisez ce type de connexion. Cette connexion vous permet d'envoyer des invitations à participer à des opportunités à des partenaires connectés.
SUBSIDIARY Établit des connexions entre vos multiples comptes vendeur AWS Marketplace et votre compte partenaire principal À utiliser lorsque vous possédez plusieurs comptes vendeur AWS Marketplace que vous souhaitez connecter à votre compte principal sur lequel vous êtes enregistré en tant que partenaire et vendeur.