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

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.

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 une modification d'une ressource ou d'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.

AWS les services envoient des événements au bus d'événements EventBridge par défaut. Si l'événement correspond au modèle d'événement d'une règle, EventBridge envoie l'événement aux cibles spécifiées pour cette règle.

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 le meilleur des cas ou sur une base durable (notez que certains événements peuvent être livrés dans le mauvais ordre). Ces niveaux de livraison sont décrits dans Niveau de livraison pour les événements de AWS service dans Amazon EventBridge Events Reference.

  • Les événements au niveau du serveur pour les serveurs SFTP, FTPS et FTP sont fournis dans la mesure du possible.

  • Les événements du connecteur SFTP sont fournis de manière durable.

  • Les AS2 événements sont organisés sur une base durable.

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.

Événements relatifs aux serveurs SFTP, FTPS et FTP

Les tableaux suivants répertorient les événements pour les serveurs SFTP, FTPS et FTP, organisés par type d'événement.

Événements relatifs au chargement et au téléchargement de fichiers

Type de détail de l'événement Description

Téléchargement du fichier du serveur FTP terminé

Un fichier a été téléchargé avec succès pour le protocole FTP.

Échec du téléchargement du fichier du serveur FTP

Une tentative de téléchargement de fichier a échoué pour le protocole FTP.

Téléchargement du fichier sur le serveur FTP terminé

Un fichier a été chargé avec succès pour le protocole FTP.

Échec du téléchargement du fichier sur le serveur FTP

Une tentative de téléchargement de fichier a échoué pour le protocole FTP.

Téléchargement du fichier du serveur FTPS terminé

Un fichier a été téléchargé avec succès pour le protocole FTPS.

Échec du téléchargement du fichier du serveur FTPS

Une tentative de téléchargement de fichier a échoué pour le protocole FTPS.

Téléchargement du fichier du serveur FTPS terminé

Un fichier a été chargé avec succès pour le protocole FTPS.

Échec du téléchargement du fichier sur le serveur FTPS

Une tentative de téléchargement de fichier a échoué pour le protocole FTPS.

Téléchargement du fichier du serveur SFTP terminé

Un fichier a été téléchargé avec succès pour le protocole SFTP.

Échec du téléchargement du fichier du serveur SFTP

Une tentative de téléchargement de fichier a échoué pour le protocole SFTP.

Téléchargement du fichier du serveur SFTP terminé

Un fichier a été chargé avec succès pour le protocole SFTP.

Échec du téléchargement du fichier sur le serveur SFTP

Une tentative de téléchargement de fichier a échoué pour le protocole SFTP.

Autres événements liés aux opérations sur les fichiers

Type de détail de l'événement Description

Création du répertoire du serveur FTP terminée

Un répertoire a été créé avec succès pour le protocole FTP.

La création du répertoire du serveur FTP a échoué

Une tentative de création d'un répertoire a échoué pour le protocole FTP.

Suppression du répertoire du serveur FTP terminée

Un répertoire a été supprimé avec succès pour le protocole FTP.

La suppression du répertoire du serveur FTP a échoué

Une tentative de suppression d'un répertoire a échoué pour le protocole FTP.

Suppression du fichier du serveur FTP terminée

Un fichier a été supprimé avec succès pour le protocole FTP.

Echec de la suppression du fichier du serveur FTP

Une tentative de suppression de fichier a échoué pour le protocole FTP.

Renommage du fichier du serveur FTP terminé

Un fichier a été renommé avec succès pour le protocole FTP.

Échec du renommage du fichier du serveur FTP

Une tentative de renommer un fichier a échoué pour le protocole FTP.

Création du répertoire du serveur FTPS terminée

Un répertoire a été créé avec succès pour le protocole FTPS.

La création du répertoire du serveur FTPS a échoué

Une tentative de création d'un répertoire a échoué pour le protocole FTPS.

Suppression du répertoire du serveur FTPS terminée

Un répertoire a été supprimé avec succès pour le protocole FTPS.

La suppression du répertoire du serveur FTPS a échoué

Une tentative de suppression d'un répertoire a échoué pour le protocole FTPS.

Suppression du fichier du serveur FTPS terminée

Un fichier a été supprimé avec succès pour le protocole FTPS.

La suppression du fichier du serveur FTPS a échoué

Une tentative de suppression de fichier a échoué pour le protocole FTPS.

Renommage du fichier du serveur FTPS terminé

Un fichier a été renommé avec succès pour le protocole FTPS.

Échec du renommage du fichier du serveur FTPS

Une tentative de renommer un fichier a échoué pour le protocole FTPS.

Création du répertoire du serveur SFTP terminée

Un répertoire a été créé avec succès pour le protocole SFTP.

La création du répertoire du serveur SFTP a échoué

Une tentative de création d'un répertoire a échoué pour le protocole SFTP.

Suppression du répertoire du serveur SFTP terminée

Un répertoire a été supprimé avec succès pour le protocole SFTP.

La suppression du répertoire du serveur SFTP a échoué

Une tentative de suppression d'un répertoire a échoué pour le protocole SFTP.

Suppression du fichier du serveur SFTP terminée

Un fichier a été supprimé avec succès pour le protocole SFTP.

Echec de la suppression du fichier du serveur SFTP

Une tentative de suppression de fichier a échoué pour le protocole SFTP.

Renommage du fichier du serveur SFTP terminé

Un fichier a été renommé avec succès pour le protocole SFTP.

Le changement de nom du fichier du serveur SFTP a échoué

Une tentative de renommer un fichier a échoué pour le protocole SFTP.

Événements relatifs au connecteur SFTP

Note

Ces événements sont diffusés à un EventBridge niveau durable, comme décrit dans la section Niveau de livraison pour les événements de AWS service dans Amazon EventBridge Events Reference.

Type de détail de l'événement Description

Envoi du fichier du connecteur SFTP terminé

Un transfert de fichier d'un connecteur vers un serveur SFTP distant s'est terminé avec succès.

Échec de l'envoi du fichier du connecteur SFTP

Un transfert de fichier d'un connecteur vers un serveur SFTP distant a échoué.

Récupération du fichier du connecteur SFTP terminée

Un transfert de fichier d'un serveur SFTP distant vers un connecteur s'est terminé avec succès.

Échec de la récupération du fichier du connecteur SFTP

Un transfert de fichier d'un serveur SFTP distant vers un connecteur a échoué.

La liste des répertoires du connecteur SFTP est terminée

Un appel de liste du répertoire de fichiers de démarrage qui s'est terminé avec succès.

Échec de la liste des répertoires du connecteur SFTP

Une liste de répertoires de fichiers de démarrage qui a échoué.

Déplacement à distance du connecteur SFTP terminé

Les fichiers ou les répertoires ont été déplacés ou renommés avec succès sur le serveur distant.

Échec du déplacement à distance du connecteur SFTP

Les fichiers ou les répertoires n'ont pas pu être déplacés ou renommés sur le serveur distant.

Suppression à distance du connecteur SFTP terminée

Les fichiers ou les répertoires ont été correctement supprimés sur le serveur distant.

Échec de la suppression à distance du connecteur SFTP

Les fichiers ou les répertoires n'ont pas pu être supprimés sur le serveur distant.

AS2 événements

Note

Ces événements sont diffusés à un EventBridge niveau durable, comme décrit dans la section Niveau de livraison pour les événements de AWS service dans Amazon EventBridge Events Reference.

Type de détail de l'événement Description

AS2 Ré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.

AS2 Envoi 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.

AS2 Réception MDN terminée

La notification de disposition d'un AS2 message a été reçue.

AS2 Échec de la réception MDN

La notification de disposition d'un AS2 message n'a pas été reçue.

AS2 Envoi MDN terminé

La notification de disposition d'un AS2 message a été envoyée avec succès.

AS2 Échec de l'envoi MDN

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.

Pour enregistrer AWS Transfer Family des événements sur Amazon EventBridge
  1. Connectez-vous à la EventBridge console Amazon AWS Management Console et ouvrez-la à l'adresse https://console.aws.amazon.com/events/.

  2. Dans le volet de navigation, choisissez Rules, puis Create rule.

  3. Entrez un nom descriptif pour la règle, et entrez éventuellement une description.

  4. Pour Type de règle, sélectionnez Règle avec un modèle d'événement, puis cliquez sur Suivant.

  5. Dans la section Source de l'événement, sélectionnez AWS des événements ou des événements EventBridge partenaires.

  6. Dans la section Méthode de création, choisissez Utiliser le formulaire de modèle.

  7. Dans la section Modèle d'événement, fournissez les informations suivantes.

    1. Pour Source d'événement, choisissez Services AWS .

    2. Pour le AWS service, choisissez Transfer.

    3. Dans Type d'événement, choisissez le type d'événement Transfer Family pour lequel vous souhaitez déclencher votre règle.

      Selon le type d'événement que vous avez sélectionné, une section Spécification du type d'événement 1 peut vous être présentée.

    4. Si vous voyez la section Spécification du type d'événement 1, sélectionnez les événements spécifiques que vous souhaitez capturer (ou sélectionnez N'importe quel événement pour capturer tous les événements correspondant au type d'événement sélectionné).

    5. (Facultatif) Utilisez l'éditeur de modèles d'événements pour définir des filtres pour les détails des événements.

    6. Choisissez Suivant.

  8. Choisissez une cible parmi les choix disponibles dans Sélectionner des cibles. Choisissez parmi les cibles disponibles suivantes.

    • AWS service. Les options les plus populaires sont les fonctions Lambda pour le calcul sans serveur, les files d'attente Amazon SQS pour le traitement des messages, les rubriques Amazon SNS pour les notifications et pour l'orchestration des flux de travail. AWS Step Functions

    • EventBridge Destination de l'API. Si vous souhaitez envoyer des événements à un point de terminaison HTTP en dehors de AWS, vous pouvez utiliser une destination d'API comme cible.

    • EventBridge bus événementiel. Vous pouvez envoyer des événements vers un autre bus d'événements, soit dans le même compte et dans la même région, soit dans un compte ou une région différents.

      Pour obtenir des instructions complètes sur la création de règles de bus d'événements, consultez la section Création de règles qui réagissent aux événements dans le guide de EventBridge l'utilisateur Amazon.

    Pour obtenir de l'aide sur la sélection d'une cible, consultez la section Sélectionner des cibles dans le guide de EventBridge l'utilisateur Amazon.

  9. Configurez toutes les options supplémentaires pour votre cible, puis choisissez Next.

  10. (Facultatif) Ajoutez des balises à votre règle et choisissez Next.

  11. Dans l'écran Réviser et créer, si tout semble correct, choisissez Créer une règle.

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 objet JSON 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 connecteur SFTP :

{ "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 téléchargements SFTP 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 les autres destinations auxquels les événements correspondants EventBridge sont envoyés, consultez la section Cibles.