¿Cómo recibo las notificaciones cuando la ejecución de una tarea de DataSync se realiza correctamente o devuelve un error?

Resolución

Configura Amazon Simple Notification Service (Amazon SNS) y Amazon EventBridge para recibir notificaciones por correo electrónico cuando el estado de ejecución de una tarea de DataSync cambie a CORRECTA o ERROR. 

Requisito previo: Debes crear una tarea de DataSync.

Creación de un tema de Amazon SNS y suscripción del correo electrónico al tema

Sigue estos pasos:

1. Abre la consola de Amazon SNS.
2. En el panel de navegación, elige Temas.
3. Elige Crear tema.
4. En Nombre, escribe un nombre para el tema.
5. Elige Crear tema.
6. En la página de tu tema, selecciona la pestaña Suscripciones.
7. Selecciona Crear suscripción.
8. En la página Crear suscripción, realiza las siguientes acciones:
   En Protocolo, selecciona Correo electrónico.
   En Punto de enlace, introduce la dirección de correo electrónico en la que quieras recibir las notificaciones.
9. Selecciona Crear suscripción.
10. En el mensaje de confirmación de suscripción que recibas, selecciona el enlace Confirmar suscripción.

Creación de una regla de EventBridge para DataSync y establecimiento del tema SNS como objetivo

Sigue estos pasos:

1. Abre la consola de EventBridge.
2. En el panel de navegación, selecciona Reglas.
3. Selecciona Crear regla.
4. Introduce un nombre y una descripción para la regla.
5. En Crear un patrón de eventos, elige eventos de AWS o eventos de socios de EventBridge en la sección Eventos.
6. En Patrón de eventos, elige Usar formulario de patrón.
7. En Origen del evento, elige Servicios de AWS.
8. En Servicio de AWS, elige DataSync.
9. En Tipo de evento, elige Cambio del estado de ejecución de la tarea de DataSync.
10. En Patrón de eventos, introduce el siguiente JSON para recibir notificaciones de todas las ejecuciones de tareas que tengan el estado CORRECTA o ERROR:

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

11. En Seleccionar objetivos, realiza las siguientes acciones:
    En Objetivo, elige Tema de SNS.
    En Tema, selecciona el tema que creaste.
12. Selecciona Crear.

Inicio de una tarea de DataSync para probar las notificaciones por correo electrónico

Para probar los estados de ejecución de las tareas de DataSync en las notificaciones por correo electrónico, primero debes crear una tarea y, a continuación, iníciala.

Tras iniciar la tarea, recibirás una notificación por correo electrónico sobre el estado de ejecución de la tarea de DataSync. Si la ejecución de una tarea se realiza correctamente, recibirás un mensaje con la notificación CORRECTA similar al siguiente:

{  
    "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"  
    }  
}

Recepción de notificaciones de una sola tarea de DataSync

Para recibir notificaciones de una sola tarea de DataSync, usa los operadores de comparación de EventBridge para buscar coincidencias parciales del ARN de la tarea.

Por ejemplo, especifica el ARN de la tarea como el valor del parámetro de prefijo en el siguiente JSON:

{  
  "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"]  
  }  
}

Recepción de notificaciones de varias tareas de DataSync

Uso del parámetro de prefijo

Para recibir notificaciones de varias tareas, puedes incluir un parámetro de prefijo para cada tarea. Por ejemplo, el siguiente JSON activa las notificaciones de dos tareas:

{  
  "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"]  
  }  
}

Nota: Sustituye REGION por tu región de AWS y ACCOUNT-ID por tu ID de cuenta de AWS. También debes sustituir TASK1-ID y TASK2-ID por los ID de las tareas.

Uso del parámetro comodín

También puedes usar el parámetro comodín para recibir notificaciones de tareas específicas. Por ejemplo, el siguiente JSON activa las notificaciones de todas las tareas que tienen el prefijo ARN especificado antes del carácter*****:

{  
  "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"]  
  }  
}

Nota: Sustituye ** REGION ** por tu región, ACCOUNT-ID con el ID de cuenta y TASK-ID por el ID de tu tarea.

Para recibir notificaciones únicamente de un par de tareas, usa el siguiente JSON:

{  
  "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"]  
  }  
}

Nota: Sustituye TASK1-ID y TASK2-ID por los ID de tus tareas.

Información relacionada

Supervisión de eventos mediante Amazon EventBridge

Creación de reglas que reaccionen a los eventos en Amazon EventBridge