Destinos de eventos de Amazon Data Firehose

Amazon Data Firehose es un servicio totalmente gestionado para entregar datos de streaming en tiempo real a varios tipos de destinos. Amazon Data Firehose forma parte de la plataforma de transmisión de datos Kinesis. Para obtener más información sobre Amazon Data Firehose, consulte la Guía para desarrolladores de Amazon Data Firehose.

En algunos de los ejemplos de esta sección se supone que ya ha instalado y configurado el. AWS Command Line Interface Para obtener más información sobre la configuración del AWS CLI, consulte la Guía del AWS Command Line Interface usuario.

Requisitos previos 

1. Antes de poder crear un destino de eventos de Amazon Data Firehose, primero debe crear una transmisión de entrega de Amazon Data Firehose. Para obtener más información sobre la creación de transmisiones, consulte Creación de una transmisión de entrega de Amazon Data Firehose en la Guía para desarrolladores de Amazon Data Firehose.

   importante

   Necesitará el nombre del recurso de Amazon (ARN) de la transmisión de entrega de Amazon Data Firehose para crear el destino del evento.

2. Debe crear un IAM rol que permita que los mensajes SMS del usuario AWS final escriban en el flujo de entrega, consulteIAMpolítica de Amazon Data Firehose.

   importante

   Necesitará el nombre del recurso de Amazon (ARN) del IAM rol para crear el destino del evento.

3. También ha configurado un conjunto de configuraciones al que asociar los destinos del evento, consulteAdministrar el conjunto de configuraciones.

Creación de destinos para eventos de Amazon Data Firehose

Antes de poder crear un destino de eventos de Amazon Data Firehose, primero debe crear una transmisión de Amazon Data Firehose. Para obtener más información sobre la creación de grupos de registros, consulte Creación de un flujo de entrega de Amazon Data Firehose en la Guía para desarrolladores de Amazon Data Firehose.

Debe crear un IAM rol que permita a AWS End User Messaging SMS and Voice v2 enviar datos API a la transmisión. La siguiente sección contiene información sobre los requisitos para este rol.

También ha configurado un conjunto de configuraciones al que asociar los destinos del evento, consulte Conjuntos de configuración.

IAMpolítica de Amazon Data Firehose

Utilice el siguiente ejemplo para crear una política para enviar eventos a una transmisión de Amazon Data Firehose.

{
    "Version": "2012-10-17",
    "Statement": [
        {
            "Effect": "Allow",
            "Action": "firehose:PutRecord",
            "Resource": "arn:aws:firehose:us-east-1:111122223333:deliverystream/DeliveryStreamName"
        }
    ]
}

Para obtener más información sobre IAM las políticas, consulte Políticas y permisos IAM en la Guía del IAM usuario.

La siguiente instrucción de ejemplo utiliza las SourceArn condiciones, opcionales pero recomendadas, SourceAccount para comprobar que solo la cuenta SMS propietaria de AWS End User Messaging tiene acceso al conjunto de configuraciones. En este ejemplo, sustituya accountId con tu identificador AWS de cuenta, region con el Región de AWS nombre y ConfigSetName con el nombre del conjunto de configuraciones.

Tras crear la política, cree una nueva IAM función y, a continuación, asígnele la política. Al crear el rol, agréguele también la siguiente política de confianza:

{
    "Version": "2012-10-17",
    "Statement": {
        "Effect": "Allow",
        "Principal": {
            "Service": "sms-voice.amazonaws.com"
        },
        "Action": "sts:AssumeRole",
        "Condition": {
            "StringEquals": {
               "aws:SourceAccount": "accountId"
             },
             "ArnLike": {
               "aws:SourceArn": "arn:aws:sms-voice:region:accountId:configuration-set/ConfigSetName"
              }
        }
    }
}

Para obtener más información sobre la creación de IAM funciones, consulte Creación de IAM funciones en la Guía del IAM usuario.

Gestión del destino del evento Amazon Data Firehose

Create Amazon Data Firehose event destination (Console)

Para crear un destino de eventos de Amazon Data Firehose mediante la SMS consola de mensajería para el usuario AWS final, siga estos pasos:

1. Abra la SMS consola de mensajería para el usuario AWS final en https://console.aws.amazon.com/sms-voice/.

2. En el panel de navegación, en Configuraciones, elija Conjuntos de configuraciones.

3. En la página Conjuntos de configuración, elija el conjunto de configuraciones al que desee añadir un destino de eventos.

4. En la página de detalles del conjunto de configuraciones, elija Agregar evento de destino.

5. En la sección Detalles del evento, introduzca un nombre descriptivo para el nombre del destino del evento.

6. En el menú desplegable Tipo de destino, selecciona Amazon Data Firehose.

7. Para el IAMrol arn, introduzca el ARN del rol. IAM Para obtener más información sobre el IAM rol arn, consulte. IAMpolítica de Amazon Data Firehose

8. En Delivery stream arn, introduzca el grupo ARN de registros de Amazon Data Firehose al que desea enviar los eventos.

9. Activa la publicación de eventos.

10. En Tipos de eventos, selecciona:

    • Todos los SMS eventos (recomendado): elija esta opción para enviar todos los SMS eventos de la lista Tipos de eventos para SMSMMS, y voz a Amazon Data Firehose.

    • SMSEventos personalizados: elija SMS eventos específicos para enviarlos a Amazon Data Firehose. Para editar la lista de eventos, seleccione Editar selección de SMS eventos. Al seleccionar Editar SMS eventos, marca solo los eventos que quieras enviar a Amazon Data Firehose. Seleccione Guardar selección.

    • Todos los eventos de voz (recomendado): elija esta opción para enviar todos los eventos de voz listados en Tipos de eventos para SMSMMS, y voz Amazon Data Firehose.

    • Eventos de voz personalizados: elija eventos de voz específicos para enviarlos a Amazon Data Firehose. Para editar la lista de eventos, seleccione Editar la selección de eventos de voz. Al seleccionar Editar eventos de voz, marque solo los eventos que desee enviar a Amazon Data Firehose. Seleccione Guardar selección.

    • Todos los MMS eventos (recomendado): elija esta opción para enviar todos los MMS eventos de la lista Tipos de eventos para SMSMMS, y voz a Amazon Data Firehose.

    • MMSEventos personalizados: elija entre 7 MMS eventos específicos para enviarlos a Amazon Data Firehose. Para editar la lista de eventos, seleccione Editar selección de MMS eventos. Al seleccionar Editar MMS eventos, marca solo los eventos que quieras enviar a Amazon Data Firehose. Seleccione Guardar selección.

11. Elija Create event (Crear evento).

Create Amazon Data Firehose event destination (AWS CLI)

Tras crear el IAM rol y la transmisión de entrega de Amazon Data Firehose, puede crear el destino del evento.

Puede usar el create-event-destinationcomando para crear un destino de evento.

$ aws pinpoint-sms-voice-v2 create-event-destination \
> --event-destination-name eventDestinationName \
> --configuration-set-name configurationSet \
> --matching-event-types eventTypes \
> --kinesis-firehose-destination IamRoleArn=arn:aws:iam::111122223333:role/AKFSMSRole,DeliveryStreamArn=arn:aws:firehose:us-east-1:111122223333:deliverystream/MyDeliveryStream

En el comando anterior, realice los siguientes cambios:

• Reemplazar eventDestinationName con un nombre que describa el destino del evento.

• Reemplazar configurationSet con el nombre del conjunto de configuraciones al que desea asociar el destino del evento.

• Reemplazar eventTypes con uno o más de los tipos de eventos que figuran enTipos de eventos para SMSMMS, y voz.

• Sustituya el valor IamRoleArn de por el nombre del recurso de Amazon (ARN) de un IAM rol que tenga las políticas descritas enIAMpolítica de Amazon Data Firehose.

• Sustituya el valor DeliveryStreamArn de por el ARN de la transmisión de Amazon Data Firehose a la que desee enviar los eventos.

Update Amazon Data Firehose event destination (Console)

Para actualizar el destino de un evento de Amazon Data Firehose mediante la SMS consola de mensajería para el usuario AWS final, siga estos pasos:

1. Abra la SMS consola de mensajería para el usuario AWS final en https://console.aws.amazon.com/sms-voice/.

2. En el panel de navegación, en Configuraciones, elija Conjuntos de configuraciones.

3. En la página Conjuntos de configuración, elija el conjunto de configuraciones al que desee añadir un destino de eventos.

4. En la página Conjuntos de configuración, elija el conjunto de configuraciones que desee editar.

5. En la página de detalles del conjunto de configuraciones, elija un destino para el evento Amazon Data Firehose y, a continuación, edítelo.

6. Para el IAMrol arn, introduzca el ARN del IAM rol. Para obtener más información sobre el IAM rol arn, consulte. IAMpolítica de Amazon Data Firehose

7. En Delivery stream arn, introduzca el grupo ARN de registros de Amazon Data Firehose al que desea enviar los eventos.

8. En Tipos de eventos, selecciona:

   • Todos los SMS eventos (recomendado): elija esta opción para enviar todos los SMS eventos de la lista Tipos de eventos para SMSMMS, y voz a Amazon Data Firehose.

   • SMSEventos personalizados: elija esta opción y elija SMS eventos específicos a los que enviar CloudWatch. Para editar la lista de eventos, selecciona Editar selección de SMS eventos. Al seleccionar Editar SMS eventos, marca solo los eventos que quieras enviar a Amazon Data Firehose. Seleccione Guardar selección.

   • Todos los eventos de voz (recomendado): elija esta opción para enviar todos los eventos de voz listados en Tipos de eventos para SMSMMS, y voz Amazon Data Firehose.

   • Eventos de voz personalizados: elija esta opción y elija eventos de voz específicos para enviarlos a Amazon Data Firehose. Para editar la lista de eventos, seleccione Editar la selección de eventos de voz. Al seleccionar Editar eventos de voz, marque solo los eventos que desee enviar a Amazon Data Firehose. Seleccione Guardar selección.

   • Todos los MMS eventos (recomendado): elija esta opción para enviar todos los MMS eventos de la lista Tipos de eventos para SMSMMS, y voz a Amazon Data Firehose.

   • MMSEventos personalizados: elija esta opción y elija MMS eventos específicos a los que enviar CloudWatch. Para editar la lista de eventos, selecciona Editar selección de MMS eventos. Al seleccionar Editar MMS eventos, marca solo los eventos que quieras enviar a Amazon Data Firehose. Seleccione Guardar selección.

9. Selecciona Editar evento.

Update Amazon Data Firehose event destination (AWS CLI)

Puede usar el update-event-destinationcomando para actualizar el destino de un evento.

El procedimiento para actualizar el destino de un evento de Amazon Data Firehose es similar al proceso para crear un destino de evento.

$ aws pinpoint-sms-voice-v2 create-event-destination \
> --event-destination-name eventDestinationName \
> --configuration-set-name configurationSet \
> --matching-event-types eventTypes \
> --kinesis-firehose-destination IamRoleArn=arn:aws:iam::111122223333:role/AKFSMSRole,DeliveryStreamArn=arn:aws:firehose:us-east-1:111122223333:deliverystream/MyDeliveryStream

En el comando anterior, realice los siguientes cambios:

• Reemplazar eventDestinationName con el nombre del destino del evento que desee modificar.

• Reemplazar configurationSet con el nombre del conjunto de configuraciones al que desea asociar el destino del evento. Puede asociar el destino del evento con un conjunto de configuraciones diferente.

• Reemplazar eventTypes con uno de los tipos de eventos que aparecen enTipos de eventos para SMSMMS, y voz.

• Sustituya el valor IamRoleArn de por el nombre del recurso de Amazon (ARN) de un IAM rol que tenga las políticas descritas enIAMpolítica de Amazon Data Firehose.

• Sustituya el valor DeliveryStreamArn de por el ARN de la transmisión de Amazon Data Firehose a la que desee enviar los eventos.

Delete an Amazon Data Firehose event destination (Console)

El proceso para eliminar un destino de evento es el mismo independientemente del tipo de destino de evento que desee eliminar.

Para eliminar un destino de evento de Amazon Data Firehose en la consola

1. Abra la SMS consola de mensajería para el usuario AWS final en https://console.aws.amazon.com/sms-voice/.

2. En el panel de navegación, en Configuraciones, elija Conjuntos de configuraciones.

3. En la página Conjuntos de configuración, elija el conjunto de configuraciones del que desee eliminar el destino de un evento.

4. En la sección Todos los destinos, elija un destino para el evento y, a continuación, elija Eliminar.

Delete an Amazon Data Firehose event destination (AWS CLI)

Puede usar el delete-event-destinationcomando para eliminar el destino de un evento.

El proceso para eliminar un destino de evento es el mismo independientemente del tipo de destino de evento que desee eliminar.

Para eliminar un destino de evento de Amazon Data Firehose en el AWS CLI

• En la línea de comandos, ejecute el comando siguiente:

  $ aws pinpoint-sms-voice-v2 delete-event-destination \
  > --event-destination-name eventDestinationName \
  > --configuration-set-name configurationSetName

  En el comando anterior, realice los siguientes cambios:

  • Reemplazar eventDestinationName con el nombre o el nombre del recurso de Amazon (ARN) del destino del evento que desea eliminar.

  • Reemplazar configurationSetName con el nombre o el conjunto ARN de configuraciones al que está asociado el destino del evento.