Comment puis-je recevoir des notifications lorsqu'une tâche DataSync s'exécute avec succès ou échoue ?

Résolution

Configurez Amazon Simple Notification Service (Amazon SNS) et Amazon EventBridge afin qu'ils vous envoient des notifications par e-mail lorsque le statut d'exécution d'une tâche DataSync passe à RÉUSSITE ou ERREUR. 

Prérequis : Vous devez créer une tâche DataSync.

Créer une rubrique Amazon SNS et abonner votre e-mail à cette rubrique

Procédez comme suit :

1. Ouvrez la console Amazon SNS.
2. Dans le volet de navigation, sélectionnez Rubriques.
3. Sélectionnez Créer une rubrique.
4. Dans Nom, saisissez un nom pour cette rubrique.
5. Sélectionnez Créer une rubrique.
6. Sur la page de votre rubrique, choisissez l'onglet Abonnements.
7. Sélectionnez Créer un abonnement.
8. Sur la page Créer un abonnement, effectuez les actions suivantes :
   Dans Protocole, sélectionnez E-mail.
   Dans Point de terminaison, saisissez l’adresse électronique de réception des notifications.
9. Sélectionnez Créer un abonnement.
10. Dans le message de confirmation d'abonnement que vous recevez, cliquez sur le lien Confirmer l'abonnement.

Créer une règle EventBridge pour DataSync et définir la rubrique SNS comme cible

Procédez comme suit :

1. Ouvrez la console EventBridge.
2. Dans le volet de navigation, sélectionnez Règles.
3. Sélectionnez Créer une règle.
4. Saisissez un nom et une description pour la règle.
5. Dans Créer un modèle d'événement, sélectionnez Événements AWS ou événements partenaires EventBridge dans la section Événements.
6. Sous Modèle d'événement, sélectionnez Utiliser le formulaire de modèle.
7. Dans Source de l'événement, sélectionnez Services AWS.
8. Dans Service AWS, sélectionnez DataSync.
9. Dans Type d'événement, sélectionnez Changement d’état d’exécution des tâches DataSync.
10. Dans Modèle d'événement, saisissez le code JSON suivant pour recevoir des notifications pour toutes les exécutions de tâches qui se trouvent à l’état RÉUSSITE ou ERREUR :

{  
  "source": [  
    "aws.datasync"  
  ],  
  "detail-type": [  
    "DataSync Task Execution State Change"  
  ],  
  "detail": {  
    "State": [  
      "SUCCESS",  
      "ERROR"  
    ]  
  }  
}

11. Sous Sélectionner des cibles, effectuez les actions suivantes :
    Dans Cible, sélectionnez Rubrique SNS.
    Dans Rubrique, sélectionnez la rubrique que vous avez créée.
12. Sélectionnez Créer.

Lancer une tâche DataSync pour tester les notifications par e-mail

Pour tester les notifications par e-mail relatives à l'état d'exécution des tâches DataSync, créez d'abord une tâche, puis démarrez-la.

Après avoir démarré la tâche, vous recevez une notification par e-mail concernant l'état d'exécution des tâches DataSync. En cas d'exécution réussie d'une tâche, vous recevez un message de notification RÉUSSITE similaire au message suivant :

{  
    "version": "0",  
    "id": "example0-c014-d9e9-d7ac-44f00d5d1200",  
    "detail-type": "DataSync Task Execution State Change",  
    "source": "aws.datasync",  
    "account": "111122223333",  
    "time": "2019-01-23T12:35:26Z",  
    "region": "us-west-2",  
    "resources": ["arn:aws:sync:us-west-2:9111122223333:task/task-example23d67d5be5/execution/exec-example316440271f"],  
    "detail": {  
        "State": "SUCCESS"  
    }  
}

Recevoir des notifications pour une seule tâche DataSync

Pour recevoir des notifications pour une seule tâche DataSync, utilisez les opérateurs de comparaison EventBridge pour rechercher des correspondances partielles avec l'ARN de la tâche.

Par exemple, spécifiez l'ARN de la tâche comme valeur du paramètre préfixe dans le fichier JSON suivant :

{  
  "detail-type": ["DataSync Task Execution State Change"],  
  "source": ["aws.datasync"],  
  "resources": [{  
    "prefix": "arn:aws:datasync:REGION:ACCOUNT-ID:task/TASK-ID/execution/exec-"  
  }],  
  "detail": {  
    "State": ["SUCCESS", "ERROR"]  
  }  
}

Recevoir des notifications pour plusieurs tâches DataSync

Utiliser le paramètre préfixe

Pour recevoir des notifications concernant plusieurs tâches, vous pouvez inclure un paramètre préfixe pour chaque tâche. Par exemple, le fichier JSON suivant active les notifications pour deux tâches :

{  
  "source": ["aws.datasync"],  
  "detail-type": ["DataSync Task Execution State Change"],  
  "resources": [{  
    "prefix": "arn:aws:datasync:REGION:ACCOUNT-ID:task/TASK1-ID/execution/exec-"  
  }, {  
    "prefix": "arn:aws:datasync:REGION:ACCOUNT-ID:task/TASK2-ID/execution/exec-"  
  }],  
  "detail": {  
    "State": ["SUCCESS", "ERROR"]  
  }  
}

Remarque : Remplacez REGION par votre région AWS et ACCOUNT-ID par votre ID de compte AWS. Remplacez également TASK1-ID et TASK2-ID par les ID de vos tâches.

Utiliser le paramètre de caractère générique

Vous pouvez également utiliser le paramètre de caractère générique pour recevoir des notifications concernant des tâches spécifiques. Par exemple, le fichier JSON suivant active les notifications pour toutes les tâches dont le préfixe ARN spécifié est précédé du caractère * :

{  
  "detail-type": ["DataSync Task Execution State Change"],  
  "source": ["aws.datasync"],  
  "resources": [{  
    "wildcard": "arn:aws:datasync:REGION:ACCOUNT-ID:task/TASK-ID/execution/exec-*"  
  }],  
  "detail": {  
    "State": ["SUCCESS", "ERROR"]  
  }  
}

Remarque : Remplacez REGION par votre région, ACCOUNT-ID par votre ID de compte et TASK-ID par l'ID de votre tâche.

Pour recevoir des notifications uniquement pour quelques tâches, utilisez le fichier JSON suivant :

{  
  "detail-type": ["DataSync Task Execution State Change"],  
  "source": ["aws.datasync"],  
  "resources": [{  
    "wildcard": "*/TASK1-ID/execution/exec-*"  
  }, {  
    "wildcard": "*/TASK2-ID/execution/exec-*"  
  }],  
  "detail": {  
    "State": ["SUCCESS", "ERROR"]  
  }  
}

Remarque : Remplacez TASK1-ID et TASK2-ID par les ID de vos tâches.

Informations connexes

Surveillance des événements à l'aide d'Amazon EventBridge

Création de règles qui réagissent aux événements dans Amazon EventBridge