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.

Notifications pour AWS API du compte Partner Central

Les notifications de connexion aux comptes partenaires permettent aux partenaires de rester informés des événements du cycle de vie des connexions qui ont un impact direct sur leurs relations commerciales et leurs flux de travail opérationnels. Ces événements sont essentiels pour que les partenaires puissent :

Remplissez le prérequis pour surveiller les événements

Les utilisateurs doivent disposer des autorisations IAM appropriées pour accéder aux événements publiés par l'API de connexion aux comptes et les gérer. Pour plus d'informations sur les actions, les ressources et les clés de condition disponibles pour EventBridge, consultez la section Utilisation des conditions de politique IAM sur Amazon EventBridge dans le guide de l' EventBridge utilisateur Amazon. L'une des clés de condition est events:detail-type celle qui peut être utilisée pour étendre les autorisations à des types d'événements spécifiques.

L'exemple de politique suivant montre comment personnaliser et étendre les autorisations pour les événements proposés. L'AllowPutRuleForPartnercentralAccountEventsinstruction permet de créer des règles, mais uniquement pour les événements provenant de la aws.partnercentral-account source.

Pour obtenir des exemples détaillés de politique IAM, consultez la documentation AWS sur EventBridge les autorisations.

{
  "Version": "2012-10-17",
  "Statement": [
    {
      "Sid": "AllowPutRuleForPartnerCentralAccountEvents",
      "Effect": "Allow",
      "Action": "events:PutRule",
      "Resource": "*",
      "Condition": {
        "StringEquals": {
          "events:source": "aws.partnercentral-account.connection"
        }
      }
    }
  ]
}

Configurer Amazon EventBridge pour surveiller les événements

Pour surveiller les événements de l'API de connexion aux comptes, vous devez créer une EventBridge règle qui correspond aux événements que vous souhaitez capturer. Vous pouvez utiliser le AWS Management Console ou les AWS SDK pour créer et gérer des règles. Les sections suivantes expliquent comment créer des règles à l'aide des deux méthodes. Quelle que soit la méthode utilisée, vous devez créer la règle dans la us-east-1 région USA Est (Virginie du Nord).

AWS Management Console configuration

Pour configurer une EventBridge règle à l'aide du AWS Management Console, suivez les étapes décrites dans la section Création de règles réagissant aux événements survenus sur Amazon EventBridge dans le guide de EventBridge l'utilisateur Amazon. Lors de la création de la règle, vous devez définir le bus d'événements par défaut et créer la règle dans la us-east-1 région USA Est (Virginie du Nord).

Voici un exemple de règle d'événement :

{
    "source": ["aws.partnercentral-account"],
    "detail": {
        "catalog": ["AWS"]
    }
}

AWS Configuration du SDK

Vous pouvez utiliser les AWS SDK pour créer et gérer des EventBridge règles par programmation. Pour plus d'informations, consultez PutRulele Amazon EventBridge API Reference.

L'exemple suivant utilise le AWS SDK pour Python (Boto3) :

import boto3

client = boto3.client('events', region_name='us-east-1')

response = client.put_rule(
    Name='MyConnectionInvitationReceivedRule',
    EventPattern=
    '{
        "source": ["aws.partnercentral-account"], 
        "detail-type": ["Partner Connection Invitation Received"], 
        "detail": {"catalog": ["AWS"]}
    }',
    State='ENABLED'
)
print('Rule ARN:', response['RuleArn'])

En savoir plus sur les événements de l'API de connexion aux comptes

Les sections suivantes décrivent les types d'événements de l'API de connexion aux comptes, les scénarios qui les déclenchent et des exemples d'événements.

Types d’événements

Vous trouverez ci-dessous les types d'événements et leurs déclencheurs.

Exemples d’événements

Les sections suivantes fournissent des exemples des événements répertoriés précédemment dans la section précédente.

Invitation de connexion avec le partenaire reçue

Contexte de déclenchement

Cet événement est généré lorsqu'une invitation de connexion est créée avec succès et conservée dans le magasin de données du PAC via l' CreateConnectionInvitation API. L'événement est envoyé immédiatement une fois la création de l'invitation terminée avec succès et est conservé dans le magasin de données du PAC, et pas seulement lorsque l'appel d'API est effectué.

L'événement sera automatiquement envoyé lorsqu'une nouvelle invitation de connexion sera créée. Un événement par invitation créé, sans qu'il n'y ait d'événements dupliqués pour la même invitation.

Destinataires

Le AWS compte du destinataire dans l'invitation de connexion.

Manipulation attendue

Actions typiques du client :

Modèles d'intégration courants :

Exemple

{
  "version": "1",
  "id": "<event id>",
  "detail-type": "Partner Connection Invitation Received",
  "source": "aws.partnercentral-account",
  "time": "<ISO 8601 date time>",
  "region": "us-east-1",
  "account": "<corresponding partner AWS account>",
  "resources": [ "<<Connection Invitation ARN>>" ],
  "detail": {
    "catalog": "AWS",
    "connectionInvitation" :{
        "arn": "<<Connection Invitation ARN>>",
        "id": "pacinv-****",
        "connectionType": "OpportunityCollaboration",
        "inviterEmail": "abc@def.com",
        "invitationMessage": "We'd like to collaborate on a joint solution for cloud security. Please accept this connection invitation to proceed.",
        "senderCompanyName": "<<Sender Partner Account Name>>",
        "senderProfileId": "pprofile-****",
        "expiresAt": "<ISO 8601 date time>"
    }
  }
}

Invitation de connexion avec un partenaire acceptée

Contexte de déclenchement

Cet événement est généré lorsqu'une invitation de connexion est acceptée avec succès et qu'une connexion est créée et conservée dans le magasin de données du PAC via l' AcceptConnectionInvitation API. L'événement est envoyé immédiatement une fois que l'acceptation de l'invitation est terminée avec succès et que la connexion est établie.

L'événement sera automatiquement envoyé lorsqu'une invitation de connexion sera acceptée. Un événement par invitation accepté, aucun événement dupliqué pour la même acceptation.

Destinataires

Les deux AWS comptes concernés par l'invitation de connexion : le compte expéditeur qui a initialement envoyé l'invitation et le compte destinataire qui a accepté l'invitation.

Manipulation attendue

Actions typiques du client :

Modèles d'intégration courants :

Exemple

{
  "version": "1",
  "id": "<event id>",
  "detail-type":  "Partner Connection Invitation Accepted",
  "source": "aws.partnercentral-account",
  "time": "<ISO 8601 date time>",
  "region": "us-east-1",
  "resources": [ "<<Connection Invitation ARN>>" , "<<Connection ARN>>" ],
  "account": "<corresponding partner AWS account>",
  "detail": {
    "catalog": "AWS",
    "connectionInvitation" :{
        "arn": "<<Connection Invitation ARN>>",
        "id": "pacinv-****",
        "connectionType": "OpportunityCollaboration"
    },
    "connection": {
        "arn": "<<Connection ARN>>",
         "id": "pac-*****",
         "Participant1AccountId": "<<Sender AWS AccountId>>", 
         "Participant2AccountId": "<<Receiver AWS AccountId>>",
         "status": "ACTIVE"
     }
  }
}

Invitation de connexion avec un partenaire rejetée

Contexte de déclenchement

Cet événement est généré lorsqu'une invitation de connexion est rejetée avec succès via l' RejectConnectionInvitation API. L'événement est envoyé immédiatement après le traitement du rejet de l'invitation et est conservé dans le magasin de données du PAC.

L'événement sera automatiquement envoyé lorsqu'une invitation de connexion est rejetée. Un événement par invitation rejeté, aucun événement dupliqué pour le même rejet.

Destinataires

Le AWS compte qui a initialement envoyé l'invitation de connexion (le compte de l'expéditeur).

Manipulation attendue

Actions typiques du client :

Modèles d'intégration courants :

Exemple

{
  "version": "1",
  "id": "<event id>",
  "detail-type": "Partner Connection Invitation Rejected",
  "source": "aws.partnercentral-account",
  "time": "<ISO 8601 date time>",
  "region": "us-east-1",
  "account": "<corresponding partner AWS account>",
  "resources": [ "<<Connection Invitation ARN>>" ],
  "detail": {
    "catalog": "AWS",
    "connectionInvitation" :{
        "arn": "<<Connection Invitation ARN>>",
        "id": "pacinv-****",
        "connectionType": "OpportunityCollaboration",
        "invitationMessage": "We'd like to collaborate on a joint solution for cloud security. Please accept this connection invitation to proceed.",
        "receiverProfileId": "pprofile-****"
    }
  }
}

Connexion avec le partenaire annulée

Contexte de déclenchement

Cet événement est généré lorsqu'une connexion active est annulée avec succès et que le statut actif est mis à jour pour être interrompu dans le magasin de données du PAC via l' CancelConnection API. L'événement est envoyé immédiatement après le traitement de l'annulation de la connexion et la mise à jour de l'état de la connexion.

L'événement sera automatiquement envoyé lorsqu'une connexion est interrompue. Un événement annulé par connexion, aucun événement dupliqué pour la même annulation.

Destinataires

Le AWS compte de l'autre participant à la connexion (et non celui qui a initié l'annulation).

Manipulation attendue

Actions typiques du client :

Modèles d'intégration courants :

Exemple

{
  "version": "1",
  "id": "<event id>",
  "detail-type": "Partner Connection Cancelled",
  "source": "aws.partnercentral-account",
  "time": "<ISO 8601 date time>",
  "region": "us-east-1",
  "resources": [ "<<Connection ARN>>" ],
  "account": "<corresponding partner AWS account>",
  "detail": {
    "catalog": "AWS",
    "connection" :{
        "arn": "<<Connection Invitation ARN>>",
        "id": "pac-****",
        "connectionType": "OpportunityCollaboration",
        "canceledBy": "<<AWS account ID>>"
    }
  }
}

Invitation de connexion avec un partenaire annulée

Contexte de déclenchement

Cet événement est généré lorsqu'une invitation de connexion en attente est annulée avec succès via l' CancelConnectionInvitation API. L'événement est envoyé immédiatement après le traitement de l'annulation de l'invitation et le statut de l'invitation est passé à ANNULÉ.

L'événement sera automatiquement envoyé lorsqu'une invitation de connexion est annulée. Une invitation à un événement par connexion est annulée, sans qu'aucun événement ne soit dupliqué pour la même annulation.

Destinataires

Le AWS compte censé recevoir l'invitation de connexion (le compte du destinataire).

Manipulation attendue

Actions typiques du client :

Modèles d'intégration courants :

Exemple

{
  "version": "1",
  "id": "<event id>",
  "detail-type": "Partner Connection Invitation Cancelled",
  "source": "aws.partnercentral-account",
  "time": "<ISO 8601 date time>",
  "region": "us-east-1",
  "account": "<corresponding partner AWS account>",
  "resources": [ "<<Connection Invitation ARN>>" ],
  "detail": {
    "catalog": "AWS",
    "connectionInvitation" :{
        "arn": "<<Connection Invitation ARN>>",
        "id": "pacinv-****",
        "connectionType": "OpportunityCollaboration",
        "invitationMessage": "We'd like to collaborate on a joint solution for cloud security. Please accept this connection invitation to proceed.",
        "senderProfileId": "pprofile-****"
    }
  }
}

Invitation de connexion aux partenaires expirée

Contexte de déclenchement

Cet événement est généré lorsqu'une invitation de connexion en attente expire automatiquement après avoir atteint son ExpiresAt horodatage sans être acceptée ou rejetée par le destinataire. L'événement est automatiquement déclenché par le système lorsque le délai d'expiration de l'invitation est atteint.

L'événement sera automatiquement envoyé à l'expiration d'une invitation de connexion. Un événement par invitation a expiré sans qu'il n'y ait eu de double événement pour la même date d'expiration.

Destinataires

Les deux AWS comptes concernés par l'invitation de connexion : le compte expéditeur qui a initialement envoyé l'invitation et le compte destinataire qui a reçu l'invitation.

Manipulation attendue

Actions typiques du client :

Modèles d'intégration courants :

Exemple

{
  "version": "1",
  "id": "<event id>",
  "detail-type": "Partner Connection Invitation Expired",
  "source": "aws.partnercentral-account",
  "time": "<ISO 8601 date time>",
  "region": "us-east-1",
  "resources": [ "<<Connection Invitation ARN>>" ],
  "detail": {
    "catalog": "AWS",
    "connectionInvitation": {
        "arn": "<<Connection Invitation ARN>>",
        "id": "pacinv-****",
        "connectionType": "OpportunityCollaboration",
        "inviterEmail": "abc@def.com",
        "invitationMessage": "We'd like to collaborate on a joint solution for cloud security. Please accept this connection invitation to proceed.",
        "senderProfileId": "pprofile-****",
        "receiverProfileId": "pprofile-****"
    }
  }
}