# Suscripción a notificaciones de eventos de Amazon RDS
<a name="USER_Events.Subscribing"></a>

La forma más sencilla de crear una suscripción es con la consola de RDS. Si decide crear las suscripciones de notificaciones de eventos a través de la CLI o la API, debe crear un tema de Amazon Simple Notification Service y suscribirse a dicho tema con la consola de Amazon SNS o la API de Amazon SNS. También deberá conservar el Nombre de recurso de Amazon (ARN) del tema, ya que este se utiliza al enviar los comandos de la CLI o las operaciones de la API. Para obtener información acerca de cómo crear un tema de SNS y suscribirse a él, consulte [Introducción a Amazon SNS](https://docs.aws.amazon.com/sns/latest/dg/GettingStarted.html) en la *Guía del desarrollador de Amazon Simple Notification Service*.

Puede especificar el tipo de origen sobre el que desea recibir notificaciones y el origen de Amazon RDS que inicia el evento:

**Source type (Tipo de origen)**  
Tipo de origen. Por ejemplo, **Source Type (Tipo de origen)** podría ser **Instances (Instancias)**. Debe elegir un tipo de origen.

***Resources* to include (Recursos a incluir)**  
Los recursos de Amazon RDS que están generando los eventos. Por ejemplo, es posible que tenga que elegir **Select specific instances (Seleccionar instancias específicas) ** y luego **myDBInstance1**. 

En la siguiente tabla se explica lo que ocurre si se especifica o no ***Resources* to include (Recursos a incluir)**.


|  Recursos a incluir  |  Descripción  |  Ejemplo  | 
| --- | --- | --- | 
|  Especificado  |  RDS le notifica todos los eventos relacionados únicamente con el recurso especificado.  | Si Source type (Tipo de origen) es Instances (Instancias) y tu recurso es myDBInstance1, RDS le notifica sobre todos los eventos de MyDBInstance1 únicamente. | 
|  No especificada  |  RDS le notifica los eventos del tipo de origen especificado para todos los recursos de Amazon RDS.   |  Si **Source type (Tipo de origen)** es **Instances (Instancias)**, RDS le notifica sobre todos los eventos relacionados con las instancias en su cuenta.  | 

Un suscriptor de temas de Amazon SNS recibe de forma predeterminada todos los mensajes publicados en el tema. Para recibir solo un subconjunto de los mensajes, el suscriptor debe asignar una política de filtrado a la suscripción del tema. Para obtener más información sobre el filtrado de mensajes SNS, consulte [Filtrado de mensajes en Amazon SNS](https://docs.aws.amazon.com/sns/latest/dg/sns-message-filtering.html) en la *Guía para desarrolladores de Amazon Simple Notification Service*.

## Consola
<a name="USER_Events.Subscribing.Console"></a>

**Para suscribirse a las notificaciones de eventos de RDS**

1. Inicie sesión en la Consola de administración de AWS y abra la consola de Amazon RDS en [https://console.aws.amazon.com/rds/](https://console.aws.amazon.com/rds/).

1. En el panel de navegación seleccione **Event Subscriptions (Suscripciones de eventos)**. 

1. En la página **Event Subscriptions (Suscripciones de eventos)** seleccione **Create Event Subscription (Crear suscripción de eventos)**. 

1. Introduzca los detalles de su suscripción de la siguiente manera:

   1. En **Name (Nombre)** escriba un nombre para la suscripción de notificación de evento.

   1. En **Send notification to (Enviar notificaciones a)**, realice una de las siguientes acciones:
      + Elija **New email topic (Nuevo tema de correo electrónico)**. Introduzca un nombre para su tema de correo electrónico y una lista de destinatarios. Le recomendamos que configure las suscripciones a los eventos con la misma dirección de correo electrónico que tiene el contacto principal de su cuenta. Las recomendaciones, los eventos de servicio y los mensajes sanitarios personales se envían a través de diferentes canales. Las suscripciones a la misma dirección de correo electrónico garantizan que todos los mensajes se consoliden en una sola ubicación.
      + Elija **Amazon Resource Name (ARN) [Nombre de recurso de Amazon (ARN)]**. A continuación, seleccione el ARN de Amazon SNS existente para un tema de Amazon SNS.

        Si desea utilizar un tema que se haya habilitado para el cifrado del servidor (SSE), conceda a Amazon RDS los permisos necesarios para acceder a la AWS KMS key. Para obtener más información, consulte [Habilitar la compatibilidad entre los orígenes de eventos de los servicios de AWS y los temas cifrados](https://docs.aws.amazon.com/sns/latest/dg/sns-key-management.html#compatibility-with-aws-services) en la *Guía para desarrolladores de Amazon Simple Notification Service*.

   1. En **Source type (Tipo de origen)** elija un tipo de origen. Por ejemplo, elija **Instances (Instancias)** o **Parameter groups(Grupos de parámetros)**.

   1. Elija las categorías y recursos del evento de las que desea recibir notificaciones.

      En el ejemplo siguiente se configuran las notificaciones de eventos de la instancia de base de datos denominada `testinst`.  
![\[Ingresar el tipo de origen\]](http://docs.aws.amazon.com/es_es/AmazonRDS/latest/UserGuide/images/event-source.png)

   1. Seleccione **Crear**.

La consola de Amazon RDS indica que se está creando la suscripción.

![\[Lista de suscripciones a notificaciones de eventos de base de datos\]](http://docs.aws.amazon.com/es_es/AmazonRDS/latest/UserGuide/images/EventNotification-Create2.png)


## AWS CLI
<a name="USER_Events.Subscribing.CLI"></a>

Para suscribirse a notificaciones de eventos de RDS, utilice el comando [AWS CLI](https://docs.aws.amazon.com/cli/latest/reference/rds/create-event-subscription.html) de la `create-event-subscription`. Incluya los siguientes parámetros obligatorios:
+ `--subscription-name`
+ `--sns-topic-arn`

**Example**  
Para Linux, macOS o:Unix  

```
aws rds create-event-subscription \
    --subscription-name myeventsubscription \
    --sns-topic-arn arn:aws:sns:us-east-1:123456789012:myawsuser-RDS \
    --enabled
```
En:Windows  

```
aws rds create-event-subscription ^
    --subscription-name myeventsubscription ^
    --sns-topic-arn arn:aws:sns:us-east-1:123456789012:myawsuser-RDS ^
    --enabled
```

## API
<a name="USER_Events.Subscribing.API"></a>

Para suscribirse a notificaciones de eventos de Amazon RDS, llame a la función [https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_CreateEventSubscription.html](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_CreateEventSubscription.html) de la API de Amazon RDS. Incluya los siguientes parámetros obligatorios: 
+ `SubscriptionName`
+ `SnsTopicArn`