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 Transfer Family événements utilisant 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. Event-driven L'architecture est un style de construction de 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 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é pour 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énement* 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.
**Topics**
+ [Transfer Family events](#supported-events)
+ [Envoi Transfer Family événements en utilisant EventBridge rules](#eventbridge-using-events-rules)
+ [Amazon EventBridge des autorisations](#eventbridge-permissions)
+ [Additionnel EventBridge resources](#eventbridge-additonal-resources)
+ [Transfer Family référence détaillée des événements](events-detail-reference.md)
## Transfer Family events
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 où chaque règle inclut 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 diffusés aux cibles spécifiées, soit dans la mesure du possible*, soit sur une * * base * durable (notez que certains événements peuvent être diffusés dans le désordre). Ces niveaux de livraison sont décrits dans la section Niveau [ de livraison pour les événements ](https://docs.aws.amazon.com/eventbridge/latest/ref/event-delivery-level.html) de AWS service du manuel * Amazon EventBridge Events Reference*.
+ Server-level les événements pour les serveurs SFTP, FTPS et FTP sont fournis dans la mesure du possible.
+ Les événements du connecteur SFTP sont fournis sur une base durable.
+ Les événements AS2 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 ](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-events.html) dans le Guide de *Amazon EventBridge l'utilisateur*.
### Événements liés 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 de chargement et de téléchargement de fichiers **
| Type de détail d’événement | Description |
| --- | --- |
| [Téléchargement du fichier du serveur FTP terminé ](events-detail-reference.md#event-detail-server-events) | Un fichier a été téléchargé avec succès pour le protocole FTP. |
| [Le téléchargement du fichier du serveur FTP a échoué ](events-detail-reference.md#event-detail-server-events) | Une tentative de téléchargement d'un fichier a échoué pour le protocole FTP. |
| [Téléchargement du fichier du serveur FTP terminé ](events-detail-reference.md#event-detail-server-events) | Un fichier a été chargé avec succès pour le protocole FTP. |
| [Le chargement du fichier du serveur FTP a échoué ](events-detail-reference.md#event-detail-server-events) | Une tentative de téléchargement de fichier a échoué pour le protocole FTP. |
| [Téléchargement du fichier du serveur FTPS terminé ](events-detail-reference.md#event-detail-server-events) | Un fichier a été téléchargé avec succès pour le protocole FTPS. |
| [Le téléchargement du fichier du serveur FTPS a échoué ](events-detail-reference.md#event-detail-server-events) | Une tentative de téléchargement d'un fichier a échoué pour le protocole FTPS. |
| [Téléchargement du fichier du serveur FTPS terminé ](events-detail-reference.md#event-detail-server-events) | Un fichier a été chargé avec succès pour le protocole FTPS. |
| [Échec du chargement du fichier du serveur FTPS ](events-detail-reference.md#event-detail-server-events) | Une tentative de téléchargement de fichier a échoué pour le protocole FTPS. |
| [Téléchargement du fichier du serveur SFTP terminé ](events-detail-reference.md#event-detail-server-events) | Un fichier a été téléchargé avec succès pour le protocole SFTP. |
| [Le téléchargement du fichier du serveur SFTP a échoué ](events-detail-reference.md#event-detail-server-events) | Une tentative de téléchargement d'un fichier a échoué pour le protocole SFTP. |
| [Téléchargement du fichier du serveur SFTP terminé ](events-detail-reference.md#event-detail-server-events) | Un fichier a été chargé avec succès pour le protocole SFTP. |
| [Échec du chargement du fichier du serveur SFTP ](events-detail-reference.md#event-detail-server-events) | 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 d’événement | Description |
| --- | --- |
| [Création du répertoire du serveur FTP terminée ](events-detail-reference.md#event-detail-server-events) | Un répertoire a été créé avec succès pour le protocole FTP. |
| [La création du répertoire du serveur FTP a échoué ](events-detail-reference.md#event-detail-server-events) | Une tentative de création d'un répertoire a échoué pour le protocole FTP. |
| [Suppression du répertoire du serveur FTP terminée ](events-detail-reference.md#event-detail-server-events) | Un répertoire a été supprimé avec succès pour le protocole FTP. |
| [La suppression du répertoire du serveur FTP a échoué ](events-detail-reference.md#event-detail-server-events) | Une tentative de suppression d'un répertoire a échoué pour le protocole FTP. |
| [Suppression du fichier du serveur FTP terminée ](events-detail-reference.md#event-detail-server-events) | Un fichier a été supprimé avec succès pour le protocole FTP. |
| [La suppression du fichier du serveur FTP a échoué ](events-detail-reference.md#event-detail-server-events) | Une tentative de suppression d'un fichier a échoué pour le protocole FTP. |
| [Renommage du fichier du serveur FTP terminé ](events-detail-reference.md#event-detail-server-events) | Un fichier a été renommé avec succès pour le protocole FTP. |
| [Échec du changement de nom du fichier du serveur FTP ](events-detail-reference.md#event-detail-server-events) | Une tentative de renommer un fichier a échoué pour le protocole FTP. |
| [Création de l'annuaire du serveur FTPS terminée ](events-detail-reference.md#event-detail-server-events) | Un répertoire a été créé avec succès pour le protocole FTPS. |
| [La création de l'annuaire du serveur FTPS a échoué ](events-detail-reference.md#event-detail-server-events) | Une tentative de création d'un répertoire a échoué pour le protocole FTPS. |
| [Suppression du répertoire du serveur FTPS terminée ](events-detail-reference.md#event-detail-server-events) | Un répertoire a été supprimé avec succès pour le protocole FTPS. |
| [La suppression du répertoire du serveur FTPS a échoué ](events-detail-reference.md#event-detail-server-events) | Une tentative de suppression d'un répertoire a échoué pour le protocole FTPS. |
| [Suppression du fichier du serveur FTPS terminée ](events-detail-reference.md#event-detail-server-events) | Un fichier a été supprimé avec succès pour le protocole FTPS. |
| [La suppression du fichier du serveur FTPS a échoué ](events-detail-reference.md#event-detail-server-events) | Une tentative de suppression d'un fichier a échoué pour le protocole FTPS. |
| [Renommage du fichier du serveur FTPS terminé ](events-detail-reference.md#event-detail-server-events) | Un fichier a été renommé avec succès pour le protocole FTPS. |
| [Échec du changement de nom du fichier du serveur FTPS ](events-detail-reference.md#event-detail-server-events) | Une tentative de renommer un fichier a échoué pour le protocole FTPS. |
| [Création du répertoire du serveur SFTP terminée ](events-detail-reference.md#event-detail-server-events) | Un répertoire a été créé avec succès pour le protocole SFTP. |
| [La création du répertoire du serveur SFTP a échoué ](events-detail-reference.md#event-detail-server-events) | Une tentative de création d'un répertoire a échoué pour le protocole SFTP. |
| [Suppression du répertoire du serveur SFTP terminée ](events-detail-reference.md#event-detail-server-events) | Un répertoire a été supprimé avec succès pour le protocole SFTP. |
| [La suppression du répertoire du serveur SFTP a échoué ](events-detail-reference.md#event-detail-server-events) | Une tentative de suppression d'un répertoire a échoué pour le protocole SFTP. |
| [Suppression du fichier du serveur SFTP terminée ](events-detail-reference.md#event-detail-server-events) | Un fichier a été supprimé avec succès pour le protocole SFTP. |
| [La suppression du fichier du serveur SFTP a échoué ](events-detail-reference.md#event-detail-server-events) | Une tentative de suppression d'un fichier a échoué pour le protocole SFTP. |
| [Renommage du fichier du serveur SFTP terminé ](events-detail-reference.md#event-detail-server-events) | Un fichier a été renommé avec succès pour le protocole SFTP. |
| [Échec du changement de nom du fichier du serveur SFTP ](events-detail-reference.md#event-detail-server-events) | Une tentative de renommage d'un fichier a échoué pour le protocole SFTP. |
### Événements liés 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 du ](https://docs.aws.amazon.com/eventbridge/latest/ref/event-delivery-level.html) manuel * Amazon EventBridge Events Reference*.
| Type de détail d’événement | Description |
| --- | --- |
| [Envoi du fichier du connecteur SFTP terminé ](events-detail-reference.md#event-detail-sftp-connector-events) | Le transfert de fichiers d'un connecteur vers un serveur SFTP distant s'est terminé avec succès. |
| [Echec de l'envoi du fichier du connecteur SFTP ](events-detail-reference.md#event-detail-sftp-connector-events) | Un transfert de fichiers depuis un connecteur vers un serveur SFTP distant a échoué. |
| [Récupération du fichier du connecteur SFTP terminée ](events-detail-reference.md#event-detail-sftp-connector-events) | Le transfert de fichiers d'un serveur SFTP distant vers un connecteur s'est terminé avec succès. |
| [Echec de la récupération du fichier du connecteur SFTP ](events-detail-reference.md#event-detail-sftp-connector-events) | Un transfert de fichiers depuis un serveur SFTP distant vers un connecteur a échoué. |
| [Liste du répertoire des connecteurs SFTP terminée ](events-detail-reference.md#event-detail-sftp-connector-events) | Un appel de liste de répertoires de fichiers de démarrage qui s'est terminé avec succès. |
| [Échec de la liste des répertoires du connecteur SFTP ](events-detail-reference.md#event-detail-sftp-connector-events) | Une liste de répertoires de fichiers de démarrage qui a échoué. |
| [Déplacement à distance du connecteur SFTP terminé ](events-detail-reference.md#event-detail-sftp-connector-events) | 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 ](events-detail-reference.md#event-detail-sftp-connector-events) | Impossible de déplacer ou de renommer des fichiers ou des répertoires sur le serveur distant. |
| [Suppression à distance du connecteur SFTP terminée ](events-detail-reference.md#event-detail-sftp-connector-events) | Les fichiers ou les répertoires ont été supprimés avec succès sur le serveur distant. |
| [Échec de la suppression à distance du connecteur SFTP ](events-detail-reference.md#event-detail-sftp-connector-events) | Les fichiers ou les répertoires n'ont pas pu être supprimés sur le serveur distant. |
### Événements AS2
**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 du ](https://docs.aws.amazon.com/eventbridge/latest/ref/event-delivery-level.html) manuel * Amazon EventBridge Events Reference*.
| Type de détail d’événement | Description |
| --- | --- |
| [Réception de la charge utile AS2 terminée ](events-detail-reference.md#event-detail-as2-server-events) | La charge utile d'un message AS2 a été reçue. |
| [Echec de réception de la charge utile AS2 ](events-detail-reference.md#event-detail-as2-server-events) | La charge utile d'un message AS2 n'a pas été reçue. |
| [Envoi de la charge utile AS2 terminé ](events-detail-reference.md#event-detail-as2-server-events) | La charge utile d'un message AS2 a été envoyée avec succès. |
| [Échec de l'envoi de la charge utile AS2 ](events-detail-reference.md#event-detail-as2-server-events) | La charge utile d'un message AS2 n'a pas pu être envoyée. |
| [Réception AS2 MDN terminée ](events-detail-reference.md#event-detail-as2-server-events) | La notification de disposition du message pour un message AS2 a été reçue. |
| [Echec de réception AS2 MDN ](events-detail-reference.md#event-detail-as2-server-events) | La notification de disposition d'un message AS2 n'a pas été reçue. |
| [Envoi AS2 MDN terminé ](events-detail-reference.md#event-detail-as2-server-events) | La notification de disposition du message pour un message AS2 a été envoyée avec succès. |
| [Échec de l'envoi AS2 MDN ](events-detail-reference.md#event-detail-as2-server-events) | La notification de disposition d'un message AS2 n'a pas pu être envoyée. |
## Envoi Transfer Family événements en utilisant EventBridge rules
Si vous souhaitez que le bus d' Transfer Family événements EventBridge par défaut envoie des événements à une cible, vous devez créer une règle contenant un modèle d'événement correspondant aux données des Transfer Family événements souhaités.
**Pour capturer AWS Transfer Family événements sur Amazon EventBridge**
1. Connectez-vous au Console de gestion AWS et ouvrez la EventBridge console Amazon à l'adresse [ https://console.aws.amazon.com/events/](https://console.aws.amazon.com/events/).
1. Dans le volet de navigation, choisissez ** Règles**, puis sélectionnez ** Créer une règle**.
1. Entrez un nom descriptif pour la règle et, si vous le souhaitez, entrez une description.
1. Dans Type de ** règle**, sélectionnez ** Règle avec un modèle d'événement**, puis choisissez ** Suivant**.
1. Dans la ** section Source de l'**événement, sélectionnez **AWS des événements ou des événements EventBridge partenaires**.
1. Dans la ** section Méthode de ** création, choisissez ** Utiliser le formulaire modèle**.
1. Dans la ** section Modèle d'**événement, fournissez les informations suivantes.
1. Pour **Source d'événement**, choisissez **Services AWS **.
1. Pour le **AWS service**, choisissez ** Transférer**.
1. 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.
1. 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 du type d'événement que vous avez sélectionné).
1. (Facultatif) Utilisez l'**éditeur de modèles d'**événements pour spécifier des filtres pour les détails des événements.
1. Choisissez **Suivant**.
1. 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 AWS Step Functions pour l'orchestration des flux de travail.
+ **EventBridge Destination de l'API**. Si vous souhaitez envoyer des événements à un point de terminaison HTTP extérieur à AWS, vous pouvez utiliser une destination 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 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 ](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-create-rule.html) dans le Guide de EventBridge l'utilisateur * Amazon*.
Pour obtenir de l'aide sur la sélection d'une cible, consultez la section [ Sélection de cibles ](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-create-rule.html#eb-create-rule-target) dans le Guide de EventBridge l'utilisateur * Amazon*.
1. Configurez toutes les options supplémentaires pour votre cible, puis choisissez ** Suivant**.
1. (Facultatif) Ajoutez des balises à votre règle et choisissez ** Suivant**.
1. 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 Transfer Family events
Lorsque Transfer Family transmet 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 diffusé 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 est`aws.transfer`.
+ (Facultatif) `detail-type` Attribut contenant un tableau des types d'événements correspondants.
+ (Facultatif) `detail` Attribut contenant toutes les autres données d'événement auxquelles il convient de faire correspondre.
Par exemple, le modèle d'événement suivant correspond à tous les événements 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 ](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-event-patterns.html) dans le Guide de *EventBridge l'utilisateur*.
### Tester les modèles d'événements pour Transfer Family événements en EventBridge
Vous pouvez utiliser le EventBridge Sandbox pour définir et tester rapidement un modèle d'événement, sans avoir à terminer le processus plus large 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 donne la possibilité de créer une nouvelle règle en utilisant ce modèle d'événement directement depuis le sandbox.
Pour plus d'informations, voir [ Tester un modèle d'événement à l'aide du EventBridge Sandbox ](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-event-pattern-sandbox.html) dans le Guide * de l'*EventBridge utilisateur.
## Amazon EventBridge des 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, consultez [Amazon EventBridge les cibles ](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-targets.html) dans le Guide de *Amazon EventBridge l'utilisateur*.
## Additionnel EventBridge resources
Reportez-vous aux rubriques suivantes du Guide de l'[*Amazon EventBridge utilisateur *](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-what-is.html) pour plus d'informations sur la façon EventBridge de traiter et de gérer les événements.
+ Pour des informations détaillées sur le fonctionnement des bus événementiels, consultez la section Bus [Amazon EventBridge événementiel](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-event-bus.html).
+ Pour plus d'informations sur la structure des événements, voir [ Événements](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-events.html).
+ Pour plus d'informations sur la création de modèles d'événements EventBridge à utiliser pour faire correspondre des événements à des règles, voir Modèles [ d'événements](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-event-patterns.html).
+ Pour plus d'informations sur la création de règles permettant de spécifier EventBridge les événements à traiter, voir [ Règles](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-rules.html).
+ Pour plus d'informations sur la manière de spécifier les services ou autres destinations vers lesquels les EventBridge événements correspondants sont envoyés, voir [ Cibles](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-targets.html).