Gestion des Transfer Family événements à l'aide de Amazon EventBridge

Amazon EventBridge est un service sans serveur qui utilise des événements pour connecter les composants de l'application entre eux, ce qui peut vous permettre de créer plus facilement des applications évolutives pilotées par des événements. L'architecture axée sur les événements est un style qui consiste à créer des systèmes logiciels faiblement couplés qui fonctionnent ensemble en émettant des événements et en y répondant. Les événements représentent un changement dans une ressource ou un environnement.

Comme c'est le cas pour de nombreux AWS services, Transfer Family génère et envoie des événements au bus d'événements EventBridge par défaut. Notez que le bus d'événements par défaut est automatiquement configuré dans chaque AWS compte. Un bus d'événements est un routeur qui reçoit des événements et les transmet à zéro ou plusieurs destinations, ou cibles. Vous définissez des règles pour le bus d'événements qui évalue les événements à leur arrivée. Chaque règle vérifie si un événement correspond au modèle d'événements de la règle. Si l'événement correspond, le bus d'événements envoie l'événement à une ou plusieurs cibles spécifiées.

Rubriques

• Transfer Family événements
• Envoi d' Transfer Family événements à l'aide de EventBridge règles
• Amazon EventBridge autorisations
• EventBridge Ressources supplémentaires
• Transfer Family référence détaillée des événements

Transfer Family événements

Transfer Family envoie automatiquement les événements au bus d' EventBridge événements par défaut. Vous pouvez créer des règles sur le bus d'événements, chaque règle incluant un modèle d'événement et une ou plusieurs cibles. Les événements qui correspondent au modèle d'événements d'une règle sont transmis aux cibles spécifiées dans la mesure du possible, mais certains événements peuvent être livrés dans le désordre.

Les événements suivants sont générés par Transfer Family. Pour plus d'informations, consultez les EventBridge événements dans le guide de Amazon EventBridge l'utilisateur.

SFTPFTPS, et événements FTP du serveur

Type de détail de l'événement	Description
FTPTéléchargement du serveur de fichiers terminé	Un fichier a été téléchargé avec succès pour le FTP protocole.
FTPÉchec du téléchargement du serveur de fichiers	Une tentative de téléchargement de fichier a échoué pour le FTP protocole.
FTPChargement du serveur de fichiers terminé	Un fichier a été chargé avec succès pour le FTP protocole.
FTPEchec du téléchargement du serveur de fichiers	Une tentative de téléchargement de fichier a échoué pour le FTP protocole.
FTPSTéléchargement du serveur de fichiers terminé	Un fichier a été téléchargé avec succès pour le FTPS protocole.
FTPSÉchec du téléchargement du serveur de fichiers	Une tentative de téléchargement de fichier a échoué pour le FTPS protocole.
FTPSChargement du serveur de fichiers terminé	Un fichier a été chargé avec succès pour le FTPS protocole.
FTPSEchec du téléchargement du serveur de fichiers	Une tentative de téléchargement de fichier a échoué pour le FTPS protocole.
SFTPTéléchargement du fichier du serveur terminé	Un fichier a été téléchargé avec succès pour le SFTP protocole.
SFTPÉchec du téléchargement du fichier du serveur	Une tentative de téléchargement de fichier a échoué pour le SFTP protocole.
SFTPTéléchargement du fichier du serveur terminé	Un fichier a été chargé avec succès pour le SFTP protocole.
SFTPÉchec du téléchargement du fichier sur le serveur	Une tentative de téléchargement de fichier a échoué pour le SFTP protocole.

SFTPévénements liés aux connecteurs

Type de détail de l'événement	Description
SFTPEnvoi du fichier du connecteur terminé	Un transfert de fichier d'un connecteur vers un SFTP serveur distant s'est terminé avec succès.
SFTPÉchec de l'envoi du fichier du connecteur	Un transfert de fichier d'un connecteur vers un SFTP serveur distant a échoué.
SFTPRécupération du fichier du connecteur terminée	Un transfert de fichier d'un SFTP serveur distant vers un connecteur s'est terminé avec succès.
SFTPÉchec de la récupération du fichier du connecteur	Un transfert de fichier d'un SFTP serveur distant vers un connecteur a échoué.

Evénements A2S

Type de détail de l'événement	Description
AS2Réception de la charge utile terminée	La charge utile d'un AS2 message a été reçue.
AS2Échec de réception de la charge utile	La charge utile d'un AS2 message n'a pas été reçue.
AS2Envoi de la charge utile terminé	La charge utile d'un AS2 message a été envoyée avec succès.
AS2Échec de l'envoi de la charge utile	La charge utile d'un AS2 message n'a pas pu être envoyée.
AS2MDNRéception terminée	La notification de disposition d'un AS2 message a été reçue.
AS2MDNÉchec de réception	La notification de disposition d'un AS2 message n'a pas été reçue.
AS2MDNEnvoi terminé	La notification de disposition d'un AS2 message a été envoyée avec succès.
AS2MDNÉchec de l'envoi	La notification de disposition d'un AS2 message n'a pas pu être envoyée.

Envoi d' Transfer Family événements à l'aide de EventBridge règles

Si vous souhaitez que le bus d'événements EventBridge par défaut envoie Transfer Family des événements à une cible, vous devez créer une règle contenant un modèle d'événements correspondant aux données des Transfer Family événements souhaités.

Vous pouvez créer une règle en suivant ces étapes générales :

1. Créez un modèle d'événement pour la règle qui spécifie les éléments suivants :

   • Transfer Family est la source des événements évalués par la règle.

   • (Facultatif) Toute autre donnée d'événement à laquelle les comparer.

   Pour de plus amples informations, veuillez consulter Création de modèles d'événements pour les Transfer Family événements.

2. (Facultatif) Créez un transformateur d'entrée qui personnalise les données de l'événement avant de les EventBridge envoyer à la cible de la règle.

   Pour plus d'informations, consultez la section Transformation des entrées dans le guide de EventBridge l'utilisateur.

3. Spécifiez les cibles auxquelles vous souhaitez EventBridge envoyer des événements qui correspondent au modèle d'événement.

   Les cibles peuvent être d'autres AWS services, des applications SaaS (software as a service), des API destinations ou d'autres points de terminaison personnalisés. Pour plus d'informations, veuillez consulter la rubrique Cibles dans le Guide de l'utilisateur EventBridge .

Pour obtenir des instructions complètes sur la création de règles de bus d'événements, voir Création de règles réagissant aux événements dans le Guide de EventBridge l'utilisateur.

Création de modèles d'événements pour les Transfer Family événements

Lors Transfer Family de la transmission d'un événement au bus d'événements par défaut, EventBridge utilise le modèle d'événement défini pour chaque règle afin de déterminer si l'événement doit être transmis aux cibles de la règle. Un modèle d'événement correspond aux données des Transfer Family événements souhaités. Chaque modèle d'événement est un JSON objet qui contient les éléments suivants :

• Un attribut source qui identifie le service qui envoie l’événement. Pour les Transfer Family événements, la source estaws.transfer.

• (Facultatif) detail-type Attribut contenant un tableau des types d'événements à associer.

• (Facultatif) detail Attribut contenant toute autre donnée d'événement à laquelle faire correspondre.

Par exemple, le modèle d'événement suivant correspond à tous les événements provenant de Transfer Family :

{
  "source": ["aws.transfer"]
}

L'exemple de modèle d'événement suivant correspond à tous les événements du SFTP connecteur :

{
  "source": ["aws.transfer"],
  "detail-type": ["SFTP Connector File Send Completed", "SFTP Connector File Retrieve Completed",
                  "SFTP Connector File Retrieve Failed", "SFTP Connector File Send Failed"]
}

L'exemple de modèle d'événement suivant correspond à tous les événements ayant échoué dans Transfer Family :

{
  "source": ["aws.transfer"],
  "detail-type": [{"wildcard", "*Failed"}]
}

L'exemple de modèle d'événement suivant correspond à des SFTP téléchargements réussis pour l'utilisateur username:

{
  "source": ["aws.transfer"],
  "detail-type": ["SFTP Server File Download Completed"],
  "detail": {
    "username": [username]
  }
}

Pour plus d'informations sur la rédaction de modèles d'événements, consultez la section Modèles d'événements dans le guide de EventBridge l'utilisateur.

Tester les modèles d' Transfer Family événements pour les événements dans EventBridge

Vous pouvez utiliser le EventBridge Sandbox pour définir et tester rapidement un modèle d'événement, sans avoir à terminer le processus général de création ou de modification d'une règle. À l'aide du Sandbox, vous pouvez définir un modèle d'événement et utiliser un exemple d'événement pour confirmer que le modèle correspond aux événements souhaités. EventBridge vous permet de créer une nouvelle règle en utilisant ce modèle d'événement directement depuis le sandbox.

Pour plus d'informations, consultez la section Tester un modèle d'événement à l'aide du EventBridge Sandbox dans le guide de l'EventBridge utilisateur.

Amazon EventBridge autorisations

Transfer Family ne nécessite aucune autorisation supplémentaire pour diffuser des événements à Amazon EventBridge.

Les cibles que vous spécifiez peuvent nécessiter des autorisations ou une configuration spécifiques. Pour plus de détails sur l'utilisation de services spécifiques pour les cibles, voir Amazon EventBridge les cibles dans le guide de Amazon EventBridge l'utilisateur.

EventBridge Ressources supplémentaires

Reportez-vous aux rubriques suivantes du guide de Amazon EventBridge l'utilisateur pour plus d'informations sur le traitement et la gestion des événements. EventBridge

• Pour des informations détaillées sur le fonctionnement des bus d'événements, consultez la section bus Amazon EventBridge d'événements.

• Pour plus d'informations sur la structure des événements, consultez la section Événements.

• Pour plus d'informations sur la création de modèles d'événements EventBridge à utiliser lors de la mise en correspondance d'événements par rapport à des règles, voir Modèles d'événements.

• Pour plus d'informations sur la création de règles pour spécifier quels événements sont EventBridge traités, consultez la section Règles.

• Pour plus d'informations sur la manière de spécifier les services ou autres destinations vers lesquels les événements correspondants EventBridge sont envoyés, consultez la section Cibles.