As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.
# Configurar um destino de evento do Amazon Data Firehose no AWS End User Messaging SMS
Amazon Data Firehose é um serviço totalmente gerenciado para fornecimento de transmissão de dados em tempo real a vários tipos de destino. O Amazon Data Firehose faz parte da plataforma de transmissão de dados Kinesis. Para saber mais sobre o Amazon Data Firehose, consulte o [Guia do desenvolvedor do Amazon Data Firehose](https://docs.aws.amazon.com/firehose/latest/dev/).
Alguns dos exemplos desta seção também pressupõem que você já instalou e configurou a AWS Command Line Interface. Para obter mais informações sobre como configurar o AWS CLI, consulte o [Guia AWS Command Line Interface do usuário](https://docs.aws.amazon.com/cli/latest/userguide/).
**Pré-requisitos**
1. Antes de criar um destino de evento do Amazon Data Firehose, você deve primeiro criar um fluxo de entrega do Amazon Data Firehose. Para obter mais informações sobre como [criar fluxos, consulte Criando um fluxo de entrega](https://docs.aws.amazon.com/firehose/latest/dev/basic-create.html) do *Amazon Data Firehose no Guia do desenvolvedor do Amazon Data Firehose*.
**Importante**
Você precisará do nome do recurso da Amazon (ARN) do fluxo de entrega do Amazon Data Firehose para criar o destino do evento.
1. Você precisa criar uma função do IAM que permita que o AWS End User Messaging SMS grave no stream de entrega, consulte[Política de IAM para o Amazon Data Firehose](configuration-sets-kinesis-creating-role.md).
**Importante**
Você precisará do nome do recurso da Amazon (ARN) do perfil do IAM para criar o destino do evento.
1. Você também configurou um conjunto de configurações para associar os destinos do evento, consulte [Crie um conjunto de configurações no AWS End User Messaging SMS](configuration-set-create.md).
**Topics**
+ [Política de IAM para o Amazon Data Firehose](configuration-sets-kinesis-creating-role.md)
+ [Crie um destino para eventos do Amazon Data Firehose](configuration-set-kinesis-add.md)
+ [Edite um destino de evento do Amazon Data Firehose](configuration-set-kinesis-edit.md)
+ [Excluir um destino de evento do Amazon Data Firehose](configuration-set-kinesis-delete.md)
# Política de IAM para o Amazon Data Firehose
Use o exemplo a seguir para criar uma política para enviar eventos para um fluxo do Amazon Data Firehose.
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Action": "firehose:PutRecord",
"Resource": "arn:aws:firehose:us-east-1:111122223333:deliverystream/DeliveryStreamName"
}
]
}
```
------
Para obter mais informações sobre as políticas do IAM, consulte [Políticas e permissões no IAM](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies.html) no *Guia do usuário do IAM*.
O exemplo de declaração a seguir usa as `SourceArn` condições opcionais, mas `SourceAccount` recomendadas, para verificar se somente a conta do proprietário do SMS do AWS End User Messaging tem acesso ao conjunto de configurações. Neste exemplo, *accountId* substitua pelo ID AWS da sua conta, *region* pelo Região da AWS nome e *ConfigSetName* pelo nome do Conjunto de Configurações.
Depois de criar a política, crie um perfil do IAM e anexe a política a ele. Ao criar o perfil, adicione também a seguinte política de confiança a ele:
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": {
"Effect": "Allow",
"Principal": {
"Service": "sms-voice.amazonaws.com"
},
"Action": "sts:AssumeRole",
"Condition": {
"StringEquals": {
"aws:SourceAccount": "111122223333"
},
"ArnLike": {
"aws:SourceArn": "arn:aws:sms-voice:us-east-1:111122223333:configuration-set/ConfigSetName"
}
}
}
}
```
------
Para obter mais informações sobre como criar perfis do IAM, consulte [Criar perfis do IAM](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_create.html) no *Guia do usuário do IAM*.
# Crie um destino de evento do Amazon Data Firehose em AWS End User Messaging SMS
Antes de criar um destino de evento do Amazon Data Firehose, você deve primeiro criar um stream do Amazon Data Firehose. Para obter mais informações sobre a criação de grupos de logs, consulte [Criação de um stream de entrega do Amazon Data Firehose](https://docs.aws.amazon.com/firehose/latest/dev/basic-create.html) no Guia do desenvolvedor do *Amazon Data Firehose*.
Você precisa criar uma função do IAM que permita que a API AWS End User Messaging SMS and Voice v2 envie dados para o stream. A seção a seguir contém informações sobre os requisitos para isso.
Você também já configurou um conjunto de configurações para associar os destinos do evento, consulte [Conjuntos de configurações no AWS End User Messaging SMS](configuration-sets.md).
------
#### [ Create Amazon Data Firehose event destination (Console) ]
Para criar um destino de evento do Amazon Data Firehose usando o console SMS do AWS End User Messaging, siga estas etapas:
1. Abra o console SMS do AWS End User Messaging em [https://console.aws.amazon.com/sms-voice/](https://console.aws.amazon.com/sms-voice/).
1. No painel de navegação, em **Configurações, escolha Conjuntos** de **configurações**.
1. Na página **Conjuntos de configurações**, escolha o conjunto de configurações ao qual adicionar um destino de evento.
1. Na página de **detalhes do conjunto de configurações**, escolha **Adicionar evento de destino**.
1. Na seção **Detalhes do evento**, insira um nome amigável para o nome do **destino do evento**.
1. No menu suspenso **Tipo de destino**, escolha Amazon Data Firehose.
1. Para a **função IAM arn**, insira o ARN da função IAM. Para obter mais informações sobre a função do IAM arn, consulte[Política de IAM para o Amazon Data Firehose](configuration-sets-kinesis-creating-role.md).
1. Em **Delivery stream arn**, insira o ARN do grupo de log do Amazon Data Firehose para o qual entregar os eventos.
1. Ative a **publicação de eventos**.
1. Em **Tipos de eventos**, escolha:
+ **Todos os eventos de SMS (recomendado)** — Escolha essa opção para enviar todos os eventos de SMS listados [Tipos de eventos](configuration-sets-event-types.md) para o Amazon Data Firehose.
+ **Eventos de SMS personalizados** — Escolha eventos de SMS específicos para enviar para o Amazon Data Firehose. Para editar a lista de eventos, escolha **Editar seleção de eventos por SMS**. Na **seleção Editar evento SMS**, marque somente os eventos que você deseja enviar para o Amazon Data Firehose. Escolha **Salvar seleção**.
+ **Todos os eventos de voz (recomendado)** — Escolha essa opção para enviar todos os eventos de voz listados [Tipos de eventos](configuration-sets-event-types.md) para o Amazon Data Firehose.
+ **Eventos de voz personalizados** — Escolha eventos de voz específicos para enviar para o Amazon Data Firehose. Para editar a lista de eventos, escolha **Editar seleção de eventos de voz**. Na **seleção Editar evento de voz**, marque somente os eventos que você deseja enviar para o Amazon Data Firehose. Escolha **Salvar seleção**.
+ **Todos os eventos MMS (recomendado)** — Escolha essa opção para enviar todos os eventos MMS listados para o [Tipos de eventos](configuration-sets-event-types.md) Amazon Data Firehose.
+ Eventos **MMS personalizados — Escolha dois eventos** MMS específicos para enviar para o Amazon Data Firehose. Para editar a lista de eventos, escolha **Editar seleção de eventos MMS**. Na **seleção de eventos Editar MMS**, marque somente os eventos que você deseja enviar para o Amazon Data Firehose. Escolha **Salvar seleção**.
1. Escolha **Create event (Criar evento)**.
------
#### [ Create Amazon Data Firehose event destination (AWS CLI) ]
Depois de criar a função do IAM e o stream de entrega do Amazon Data Firehose, você pode criar o destino do evento.
Você pode usar o [create-event-destination](https://docs.aws.amazon.com/cli/latest/reference/pinpoint-sms-voice-v2/create-event-destination.html)comando para criar um 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
```
No comando anterior, faça as seguintes alterações:
+ *eventDestinationName*Substitua por um nome que descreva o destino do evento.
+ *configurationSet*Substitua pelo nome do conjunto de configurações ao qual você deseja associar o destino do evento.
+ *eventTypes*Substitua por um ou mais dos tipos de eventos listados em[Tipos de evento para SMS, MMS e voz](configuration-sets-event-types.md).
+ Substitua o valor do `IamRoleArn` pelo nome do recurso da Amazon (ARN) de um perfil do IAM que tenha as políticas descritas em [Política de IAM para o Amazon Data Firehose](configuration-sets-kinesis-creating-role.md).
+ Substitua o valor `DeliveryStreamArn` de pelo ARN do stream do Amazon Data Firehose para o qual você deseja enviar eventos.
------
# Edite um destino de evento do Amazon Data Firehose em AWS End User Messaging SMS
Use o console AWS End User Messaging SMS ou AWS CLI edite um destino de evento do Amazon Data Firehose.
------
#### [ Update Amazon Data Firehose event destination (Console) ]
Para atualizar um destino de evento do Amazon Data Firehose usando o console SMS do AWS End User Messaging, siga estas etapas:
1. Abra o console SMS do AWS End User Messaging em [https://console.aws.amazon.com/sms-voice/](https://console.aws.amazon.com/sms-voice/).
1. No painel de navegação, em **Configurações, escolha Conjuntos** de **configurações**.
1. Na página **Conjuntos de configurações**, escolha o conjunto de configurações ao qual adicionar um destino de evento.
1. Na página **Conjuntos de configurações**, escolha o conjunto de configurações a ser editado.
1. **Na página de **detalhes do conjunto de configurações**, escolha um destino para o evento Amazon Data Firehose e, em seguida, Edite.**
1. Para a **função IAM arn**, insira o ARN da função IAM. Para obter mais informações sobre a função do IAM arn, consulte[Política de IAM para o Amazon Data Firehose](configuration-sets-kinesis-creating-role.md).
1. Em **Delivery stream arn**, insira o ARN do grupo de log do Amazon Data Firehose para o qual os eventos serão entregues.
1. Em **Tipos de eventos**, escolha:
+ **Todos os eventos de SMS (recomendado)** — Escolha essa opção para enviar todos os eventos de SMS listados [Tipos de eventos](configuration-sets-event-types.md) para o Amazon Data Firehose.
+ **Eventos de SMS personalizados** — Escolha esta opção e escolha eventos de SMS específicos para os quais enviar CloudWatch. Para editar a lista de eventos, escolha **Editar seleção de eventos por SMS**. Na **seleção Editar evento SMS**, marque somente os eventos que você deseja enviar para o Amazon Data Firehose. Escolha **Salvar seleção**.
+ **Todos os eventos de voz (recomendado)** — Escolha essa opção para enviar todos os eventos de voz listados [Tipos de eventos](configuration-sets-event-types.md) para o Amazon Data Firehose.
+ **Eventos de voz personalizados** — Escolha esta opção e escolha eventos de voz específicos para enviar para o Amazon Data Firehose. Para editar a lista de eventos, escolha **Editar seleção de eventos de voz**. Na **seleção Editar evento de voz**, marque somente os eventos que você deseja enviar para o Amazon Data Firehose. Escolha **Salvar seleção**.
+ **Todos os eventos MMS (recomendado)** — Escolha essa opção para enviar todos os eventos MMS listados para o [Tipos de eventos](configuration-sets-event-types.md) Amazon Data Firehose.
+ **Eventos MMS personalizados** — Escolha esta opção e escolha eventos MMS específicos para os quais enviar. CloudWatch Para editar a lista de eventos, escolha **Editar seleção de eventos MMS**. Na **seleção de eventos Editar MMS**, marque somente os eventos que você deseja enviar para o Amazon Data Firehose. Escolha **Salvar seleção**.
1. Escolha **Editar evento**.
------
#### [ Update Amazon Data Firehose event destination (AWS CLI) ]
Você pode usar o [update-event-destination](https://docs.aws.amazon.com/cli/latest/reference/pinpoint-sms-voice-v2/update-event-destination.html)comando para atualizar o destino de um evento.
O procedimento para atualizar um destino de evento do Amazon Data Firehose é semelhante ao processo de criação de um 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
```
No comando anterior, faça as seguintes alterações:
+ *eventDestinationName*Substitua por um nome do destino do evento que você deseja modificar.
+ *configurationSet*Substitua pelo nome do conjunto de configurações ao qual você deseja associar o destino do evento. Você pode associar o destino do evento a um conjunto de configurações diferente.
+ *eventTypes*Substitua por um dos tipos de eventos listados em[Tipos de evento para SMS, MMS e voz](configuration-sets-event-types.md).
+ Substitua o valor do `IamRoleArn` pelo nome do recurso da Amazon (ARN) de um perfil do IAM que tenha as políticas descritas em [Política de IAM para o Amazon Data Firehose](configuration-sets-kinesis-creating-role.md).
+ Substitua o valor `DeliveryStreamArn` de pelo ARN do stream do Amazon Data Firehose para o qual você deseja enviar eventos.
------
# Excluir um destino de evento do Amazon Data Firehose em AWS End User Messaging SMS
Use o console AWS End User Messaging SMS ou AWS CLI exclua um destino de evento do Amazon Data Firehose.
------
#### [ Delete an Amazon Data Firehose event destination (Console) ]
O processo para excluir um destino de evento é o mesmo, independentemente do tipo de destino do evento que você deseja excluir.
**Para excluir um destino de evento do Amazon Data Firehose no console**
1. Abra o console SMS do AWS End User Messaging em [https://console.aws.amazon.com/sms-voice/](https://console.aws.amazon.com/sms-voice/).
1. No painel de navegação, em **Configurações, escolha Conjuntos** de **configurações**.
1. Na página **Conjuntos de configuração**, escolha o conjunto de configurações do qual remover um destino de evento.
1. Na seção **Todos os destinos**, escolha um destino para o evento e escolha **Excluir**.
------
#### [ Delete an Amazon Data Firehose event destination (AWS CLI) ]
Você pode usar o [delete-event-destination](https://docs.aws.amazon.com/cli/latest/reference/pinpoint-sms-voice-v2/delete-event-destination.html)comando para excluir o destino de um evento.
O processo para excluir um destino de evento é o mesmo, independentemente do tipo de destino do evento que você deseja excluir.
**Para excluir um destino de evento do Amazon Data Firehose no AWS CLI**
+ Na linha de comando, execute o seguinte comando:
```
$ aws pinpoint-sms-voice-v2 delete-event-destination \
> --event-destination-name eventDestinationName \
> --configuration-set-name configurationSetName
```
No comando anterior, faça as seguintes alterações:
+ *eventDestinationName*Substitua pelo nome ou Amazon Resource Name (ARN) do destino do evento que você deseja excluir.
+ *configurationSetName*Substitua pelo nome ou ARN do conjunto de configurações ao qual o destino do evento está associado.
------