

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á.

# Usando configurações de proteção no SMS de mensagens de usuário AWS final
<a name="protect-configuration"></a>

Use configurações de proteção para controlar para quais países de destino o SMS de mensagens de usuário AWS final pode enviar suas mensagens. Ao controlar para quais países você permite o envio de mensagens, você pode evitar o envio para países com altos preços de mensagens ou países nos quais você não opera. Cada configuração de proteção contém regras individuais do país de permissão e bloqueio para SMS, MMS e voz. Crie configurações de proteção separadas para cada caso de uso de mensagens para melhorar a precisão da detecção. Separar casos de uso, como notificações de marketing, do login/inscrição permite uma avaliação de risco mais precisa. Além disso, quando um caso de uso enfrenta a AIT, outros casos de uso continuam entregando mensagens sem qualquer filtragem de mensagens.

Você pode usar configurações de proteção como *padrão da conta*, com um conjunto de configurações ou no *ProtectConfigurationId*parâmetro dos `SendVoiceMessage` comandos `SendMediaMessage``SendTextMessage`, ou. Quando definida como uma *conta padrão*, uma configuração de proteção também afetará as mensagens enviadas pelo Amazon SNS, Amazon Cognito e. `SendMessages`.

O processo de seleção para a configuração de proteção *efetiva* para uma solicitação de envio é o seguinte:

1. *ProtectConfigurationId*— Se uma configuração de proteção for especificada nos parâmetros de solicitação da API, ela será usada.

1. *ConfigurationSetName*— Se nenhuma configuração de proteção for especificada nos parâmetros de solicitação da API, mas um conjunto de configurações for especificado e tiver uma configuração de proteção associada, a configuração de proteção associada a esse conjunto de configurações será usada.

1. *Padrão da conta* – Se uma configuração de proteção não for especificada ou não estiver disponível nas opções 1 ou 2, será usada a configuração de proteção *padrão da conta*.
**nota**  
*Para usar uma configuração de proteção com outros AWS serviços para enviar mensagens, como Amazon SNS ou Amazon Pinpoint, você precisa definir sua configuração de proteção como padrão da conta.*

1. *Nenhuma* — A configuração de proteção só será usada se especificada em uma solicitação de `SendTextMessage` API.

Uma configuração de proteção pode ser associada a vários conjuntos de configurações, enquanto um conjunto de configurações só pode ser associado a uma configuração de proteção. Só pode haver uma configuração de proteção *padrão da conta* por vez.

O exemplo a seguir `SendMediaMessage` tem um conjunto de configurações e uma configuração de proteção especificadas no comando. A configuração de proteção especificada no *ProtectConfigurationId*parâmetro é usada independentemente de o conjunto de configurações ter uma configuração de proteção associada ou de haver uma configuração de proteção *padrão da conta*.

```
aws pinpoint-sms-voice-v2 --region 'us-east-1' send-media-message --destination-phone-number +12065550150 --origination-identity +14255550120 --message-body 'text body' --media-urls 's3://s3-bucket/media_file.jpg' --configuration-set-name ConfigSetName --protect-configuration-id ProtectConfigId
```

Dependendo do seu caso de uso, recomendamos o seguinte:
+ Se você precisar apenas de um conjunto de regras de país para todos os SMS, MMS e voz, crie uma configuração de proteção e associe-a à *conta padrão*.

  1. Crie uma configuração de proteção seguindo as instruções [Crie uma configuração de proteção no AWS End User Messaging SMS](protect-configuration-create.md) e defina a associação como *padrão da conta*. 

  1. Edite as regras de país de *Permitir*, *Bloquear*, *Monitorar* e *Filtrar* para SMS, MMS e voz seguindo as instruções em [Alterar uma configuração de proteção (regras de país) no AWS End User Messaging SMS](protect-configuration-edit-countries.md).

  1. A configuração de proteção *padrão da sua conta* agora é usada para qualquer mensagem que você enviar, a menos que seja substituída pelo *ConfigurationSetName*ou. *ProtectConfigurationId* 
+ Se seu caso de uso exigir mais controles granulares e registro de eventos, você poderá associar a configuração de proteção a um conjunto de configurações. 

  1. Se você ainda não tiver um conjunto de configurações criado, siga as instruções em [Crie um conjunto de configurações no AWS End User Messaging SMS](configuration-set-create.md). Também recomendamos que você configure um destino de evento para registrar eventos de SMS, MMS e voz. 

  1. Crie uma configuração de proteção seguindo as instruções [Crie uma configuração de proteção no AWS End User Messaging SMS](protect-configuration-create.md) e defina a associação como *conjunto de configurações* e escolha um ou mais conjuntos de configurações.

  1. Edite as regras de país de *Permitir*, *Bloquear*, *Monitorar* e *Filtrar* para SMS, MMS e voz seguindo as instruções em [Alterar uma configuração de proteção (regras de país) no AWS End User Messaging SMS](protect-configuration-edit-countries.md).

  1. Para usar a configuração de proteção, você precisa passar os *ConfigurationSetName*`SendVoiceMessage`comandos do `SendMediaMessage``SendTextMessage`, ou.
+ Se seu caso de uso exigir controles mais granulares, você pode criar a configuração de proteção e usar a configuração de proteção no parâmetro da *ProtectConfigurationId*API. 

  1. Crie uma configuração de proteção seguindo as instruções [Crie uma configuração de proteção no AWS End User Messaging SMS](protect-configuration-create.md) e defina a associação como *sem associação*.

  1. Edite as regras de país de *Permitir*, *Bloquear*, *Monitorar* e *Filtrar* para SMS, MMS e voz seguindo as instruções em [Alterar uma configuração de proteção (regras de país) no AWS End User Messaging SMS](protect-configuration-edit-countries.md).

  1. Para usar a configuração de proteção, você precisa passar os *ProtectConfigurationId*`SendVoiceMessage`comandos do `SendMediaMessage``SendTextMessage`, ou.

**Topics**
+ [Criar uma configuração de proteção](protect-configuration-create.md)
+ [Alterar as regras de país](protect-configuration-edit-countries.md)
+ [alterar associação](protect-configuration-edit-association.md)
+ [Excluir uma configuração de proteção.](protect-configuration-delete.md)
+ [Configurar proteção contra exclusão](protect-configuration-deletion-protection.md)
+ [Renomear uma configuração de proteção](protect-configuration-change-name.md)
+ [Gerenciar tags para uma configuração de proteção](protect-configuration-tags.md)

# Crie uma configuração de proteção no AWS End User Messaging SMS
<a name="protect-configuration-create"></a>

Para criar uma nova configuração de proteção, você pode usar o console AWS End User Messaging SMS, a `CreateProtectConfiguration` ação na API AWS End User Messaging SMS and voice v2 ou o `aws sms-voice create-protect-configuration` comando no. AWS CLI Esta seção mostra como criar configurações de proteção usando o console SMS do AWS End User Messaging e o. AWS CLI

Por padrão, você pode ter até 25 configurações de proteção em seu Conta da AWS.

Ao criar uma configuração de proteção, você pode criar regras que permitem, filtram ou bloqueiam países com base nas necessidades da sua empresa. Para saber mais sobre a edição das regras do país, consulte [Alterar uma configuração de proteção (regras de país) no AWS End User Messaging SMS](protect-configuration-edit-countries.md). 

**nota**  
O nome da sua configuração de proteção é salvo como um key/value par de tags. Se você não especificar uma tag “Nome”, o nome da configuração de proteção aparecerá como –.

------
#### [ Create a protect configuration (Console) ]

Para criar uma configuração de proteção usando o console AWS End User Messaging SMS, 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 **Proteger**, escolha **Proteger configuração** e, em seguida, **Criar configuração**.

1. Para **Nome da configuração de proteção**, insira um nome descritivo para a configuração de proteção.

1. Defina regras de país para *bloquear*, *filtrar* ou *permitir* o envio de mensagens com base nas necessidades da sua empresa. Você pode classificar e filtrar a lista de países com base no país, região e regra.

1. Em **Proteger associações de configuração** para o **tipo de associação**, escolha:
   + **Conta padrão** — Para usar a configuração de proteção como padrão da sua conta. Se você já tiver uma configuração de proteção **padrão da conta**, ela será substituída.
   + **Conjunto de configurações** — Para associar a configuração de proteção a um conjunto de configurações existente. Em **Conjuntos de configurações disponíveis para associação**, escolha um ou mais conjuntos de configurações aos quais associar a configuração de proteção. Isso substitui a associação de configuração de proteção existente.
   + **Sem associação** — A configuração de proteção não está associada à sua conta padrão ou a um conjunto de configurações.

1. Escolha **Criar configuração**.

Agora que você criou sua configuração de proteção, você deve editar a lista de regras do país para MMS e voz. Para saber mais sobre a edição das regras do país, consulte [Alterar uma configuração de proteção (regras de país) no AWS End User Messaging SMS](protect-configuration-edit-countries.md). 

------
#### [ Create a protect configuration (AWS CLI) ]

Você pode usar o create-protect-configuration comando para criar uma nova configuração de proteção. 

**Para criar uma configuração de proteção**
+ Na linha de comando, insira o seguinte comando:

  ```
  $ aws pinpoint-sms-voice-v2 create-protect-configuration --tags Key=Name,Value=ProtectConfigName
  ```

  No comando anterior, faça as seguintes alterações:
  + *ProtectConfigName*Substitua por um nome amigável para sua configuração de proteção.

Agora que você criou sua configuração de proteção, é necessário editar a lista de regras de país para SMS, MMS e voz. Para saber mais sobre a edição das regras do país, consulte [Alterar uma configuração de proteção (regras de país) no AWS End User Messaging SMS](protect-configuration-edit-countries.md). Opcionalmente, você pode associar a configuração de proteção à configuração de proteção *padrão da conta* ou a um conjunto de configurações.

------

# Alterar uma configuração de proteção (regras de país) no AWS End User Messaging SMS
<a name="protect-configuration-edit-countries"></a>

Proteja as regras do país de configuração *Permitir*, *Bloquear*, *Monitorar* ou *Filtrar* mensagens para cada país de destino. Para atualizar as regras de proteção do país de configuração, você pode usar o console SMS do AWS End User Messaging ou o `aws sms-voice update-protect-configuration-country-rule-set` comando no AWS CLI. Esta seção mostra como atualizar as regras do país de configuração de proteção usando o console SMS do AWS End User Messaging e AWS CLI o.

**nota**  
Você só pode alterar sua lista de regras de país do MMS por meio da API AWS End User Messaging SMS and Voice v2 ou. AWS CLI

------
#### [ Edit a protect configuration (Console) ]

Para editar uma configuração de proteção usando o console AWS End User Messaging SMS, 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 **Proteger**, selecione **Proteger configuração**.

1. Na página **Configuração de proteção**, escolha uma configuração de proteção e, em seguida, escolha **Editar**.

1. Na tabela de detalhes da configuração de proteção, escolha a guia **Regras de SMS** ou **Regras de voz**.

1. Na guia **Regras de país de SMS/Voz**, marque os países para os quais alterar as regras e escolha **Permitir**, **Bloquear**, **Monitorar** ou **Filtrar**. Para obter mais informações sobre os modos de regras de país, consulte [Modos de governo do país](filter-and-monitor-messages.md). Você pode classificar e filtrar a lista de países com base no **País**, **Região** e **Regra**.

1. Na janela de **confirmação da alteração de status**, revise suas alterações e escolha **Confirmar** para aplicá-las.

O novo conjunto de regras do país agora é usado para a configuração de proteção.

------
#### [ Edit a protect configuration (AWS CLI) ]

Você pode usar o comando update-protect-configuration-country -set para alterar as regras de país de uma configuração de proteção. Você pode alterar até 300 regras de país por vez.

**Para editar uma configuração de proteção**
+ Para editar duas regras de país na linha de comando, digite o seguinte:

  ```
  aws pinpoint-sms-voice-v2 update-protect-configuration-country-rule-set --protect-configuration-id ProtectConfigId --number-capability Capability --country-rule-set-updates '{"CountryISO1":{"ProtectStatus": "Rule1"}, "CountryISO2": {"ProtectStatus":"Rule2"}}'
  ```

  No comando anterior, faça as seguintes alterações:
  + *ProtectConfigId*Substitua pelo identificador exclusivo da configuração de proteção.
  + *Capability*Substitua `SMS` por`MMS`, ou`VOICE`.
  + *CountryISO1*Substitua pelo código de país ISO de duas letras. Para obter uma lista de códigos de país, consulte [Países e regiões com suporte para mensagens SMS com o AWS End User Messaging SMS](phone-numbers-sms-by-country.md).
  + Substitua *Rule1* por `ALLOW` ou `BLOCK`.
  + *CountryISO2*Substitua pelo código de país ISO de duas letras. Para obter uma lista de códigos de país, consulte [Países e regiões com suporte para mensagens SMS com o AWS End User Messaging SMS](phone-numbers-sms-by-country.md).
  + Substitua *Rule2* por `ALLOW` ou `BLOCK`.

------

# Alterar uma associação de configuração de proteção no AWS End User Messaging SMS
<a name="protect-configuration-edit-association"></a>

Para usar as regras de país contidas em uma configuração de proteção, você precisa associar a configuração de proteção como *padrão da conta* a um conjunto de configurações ou usá-la diretamente no envio de uma mensagem. Se você tiver apenas um caso de uso de envio de mensagens, usar uma *conta padrão* é a opção mais simples. Se você tiver vários casos de uso, poderá usar conjuntos de configurações para controlar para quais países o AWS End User Messaging SMS envia mensagens e, para obter maior controle, você pode associar uma configuração de proteção diretamente ao envio de uma mensagem. Para alterar a associação de uma configuração de proteção, você pode usar o console SMS do AWS End User Messaging, a `SetAccountDefaultProtectConfiguration` ação `AssociateProtectConfiguration` ou na API AWS End User Messaging SMS and voice v2 `aws sms-voice associate-protect-configuration` ou os `aws sms-voice set-account-default-protect-configuration` comandos or no AWS CLI. Esta seção mostra como alterar a associação de uma configuração de proteção usando o console SMS do AWS End User Messaging e AWS CLI o.

O processo de seleção para a configuração de proteção *efetiva* para uma solicitação de envio é o seguinte:

1. *ProtectConfigurationId*— Se uma configuração de proteção for especificada nos parâmetros de solicitação da API, ela será usada.

1. *ConfigurationSetName*— Se nenhuma configuração de proteção for especificada nos parâmetros de solicitação da API, mas um conjunto de configurações for especificado e tiver uma configuração de proteção associada, a configuração de proteção associada a esse conjunto de configurações será usada.

1. *Padrão da conta* – Se uma configuração de proteção não for especificada ou não estiver disponível nas opções 1 ou 2, será usada a configuração de proteção *padrão da conta*.

1. *Nenhuma* — A configuração de proteção só será usada se especificada em uma solicitação de `SendTextMessage` API.

Uma configuração de proteção pode ser associada a vários conjuntos de configurações, enquanto um conjunto de configurações só pode ser associado a uma configuração de proteção. Só pode haver uma configuração de proteção *padrão da conta*.

------
#### [ Edit a protect configuration association (Console) ]

Para editar uma configuração de proteção usando o console AWS End User Messaging SMS, 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 **Proteger**, selecione **Proteger configuração**.

1. Na página **Configurações de proteção**, escolha uma configuração de proteção.

1. Selecione a guia **Associações**.

1. Escolha **Edit Settings**.

1. Na página **Editar configuração**, escolha uma das seguintes opções:
   + **Padrão da conta** – Usar a configuração de proteção como a configuração de proteção *padrão da conta*. Isso substitui a configuração de proteção *padrão da conta* atual.
   + **Conjunto de configuração** – Associar a configuração de proteção a um ou mais conjuntos de configuração. 
     + Em **Conjuntos de configurações disponíveis para associação**, marque um ou mais conjuntos de configurações que ainda não tenham uma associação de configuração protegida. 
   + **Sem associação** – A configuração de proteção não está associada ao *padrão da conta* nem a um conjunto de configuração.

1. Escolha **Salvar alterações**.

------
#### [ Edit a protect configuration association (AWS CLI) ]

Você pode usar o associate-protect-configuration comando para associar a configuração de proteção a um conjunto de configurações. Para alterar a configuração de proteção *padrão da conta*, use o comando set-account-defult-protect -configuration.

Para alterar a associação de um conjunto de configurações a uma configuração de proteção na linha de comando, digite o seguinte:

```
$ aws pinpoint-sms-voice-v2 associate-protect-configuration --configuration-set-name ConfigurationSetName --protect-configuration-id ProtectConfigurationID
```

No comando anterior, faça as seguintes alterações:
+ Substitua *ConfigurationSetName* pelo nome do conjunto de configurações.
+ *ProtectConfigurationID*Substitua pelo identificador exclusivo da configuração de proteção.

Para alterar a configuração de proteção padrão da conta na linha de comando, digite o seguinte:

```
$ aws pinpoint-sms-voice-v2 set-account-default-protect-configuration --protect-configuration-id ProtectConfigurationID
```

No comando anterior, faça as seguintes alterações:
+ *ProtectConfigurationID*Substitua pelo identificador exclusivo da configuração de proteção.

------
#### [ Disassociate a protect configuration (AWS CLI) ]

Você pode usar o disassociate-protect-configuration comando para desassociar a configuração de proteção de um conjunto de configurações. Para remover a configuração de proteção *padrão da conta*, use o comando delete-account-defult-protect -configuration.

Para remover a associação de conjuntos de configuração a uma configuração de proteção na linha de comando, insira o seguinte comando:

```
$ aws pinpoint-sms-voice-v2 disassociate-protect-configuration --configuration-set-name ConfigurationSetName --protect-configuration-id ProtectConfigurationID
```

No comando anterior, faça as seguintes alterações:
+ Substitua *ConfigurationSetName* pelo nome do conjunto de configurações.
+ *ProtectConfigurationID*Substitua pelo identificador exclusivo da configuração de proteção.

Para remover a configuração de proteção *padrão da conta* na linha de comando, insira o seguinte comando:

```
$ aws pinpoint-sms-voice-v2 delete-account-default-protect-configuration
```

------

# Excluir uma configuração de proteção no AWS End User Messaging SMS
<a name="protect-configuration-delete"></a>

Para excluir uma configuração de proteção, você pode usar o console AWS End User Messaging SMS, a `DeleteProtectConfiguration` ação na API AWS End User Messaging SMS and voice v2 ou o `aws sms-voice delete-protect-configuration` comando no. AWS CLI Esta seção mostra como excluir uma configuração de proteção usando o console SMS do AWS End User Messaging e AWS CLI o.

**Importante**  
A proteção contra exclusão deve ser desativada para que você possa excluir uma configuração de proteção.  
A configuração de proteção deve ser desassociada de qualquer conjunto de configurações ou da configuração de proteção *padrão da conta* antes que você possa excluí-la.

------
#### [ Delete a protect configuration (Console) ]

Para excluir uma configuração de proteção usando o console AWS End User Messaging SMS, 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 **Proteger**, selecione **Proteger configuração**.

1. Escolha a configuração de proteção a ser excluída e, em seguida, escolha **Excluir**.

1. Em **Excluir configurações de proteção**, insira **confirm** e escolha **Excluir**.
**nota**  
Se sua configuração de proteção ainda estiver associada a um conjunto de configurações ou como padrão da conta, escolha **Remover associações**, insira **confirm** e escolha **Excluir**.

A configuração de proteção agora foi removida da sua conta.

------
#### [ Delete a protect configuration (AWS CLI) ]

Você pode usar o delete-protect-configuration comando para excluir uma configuração de proteção. 

**Para excluir uma configuração de proteção**
+ Na linha de comando, insira o seguinte comando:

  ```
  $ aws pinpoint-sms-voice-v2 delete-protect-configuration --protect-configuration-id ProtectConfigId
  ```

  No comando anterior, faça as seguintes alterações:
  + *ProtectConfigId*Substitua pelo identificador exclusivo da configuração de proteção.

------

# Configurar a proteção contra exclusão no AWS End User Messaging SMS
<a name="protect-configuration-deletion-protection"></a>

Ao ativar a proteção contra exclusão para uma configuração de proteção, você não poderá excluir a configuração de proteção até que a proteção contra exclusão seja desativada e a configuração de proteção não esteja mais associada a um conjunto de configurações ou à configuração de proteção *padrão da conta*. Por padrão, a proteção contra exclusão fica desabilitada.

Para habilitar a proteção contra exclusão de uma configuração protegida, você pode usar o console AWS End User Messaging SMS, a `DeleteProtectConfiguration` ação na API AWS End User Messaging SMS and voice v2 ou o `aws sms-voice delete-protect-configuration` comando no. AWS CLI Esta seção mostra como excluir uma configuração de proteção usando o console SMS do AWS End User Messaging e AWS CLI o.

------
#### [ Enable deletion protection (Console) ]

**Habilitar proteção contra exclusão**

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 **Proteger**, selecione **Proteger configuração**.

1. Na página **Proteger configurações**, escolha a configuração de proteção que terá a proteção contra exclusão ativada.

1. Na guia **Proteção contra exclusão**, escolha o botão **Editar configurações**.

1. Marque **Ativar proteção contra exclusão** e, em seguida, escolha **Salvar alterações**.

------
#### [ Enable or disable deletion protection (AWS CLI) ]

Você pode usar o update-protect-configuration comando para ativar a proteção contra exclusão. 

**Habilitar proteção contra exclusão**
+ Na linha de comando, insira o seguinte comando:

  ```
  $ update-protect-configuration --protect-configuration-id ProtectConfigurationId --deletion-protection-enabled Status
  ```

  No comando anterior, faça as seguintes alterações:
  + *ProtectConfigId*Substitua pelo identificador exclusivo da configuração de proteção.
  + *Status*Substitua por *verdadeiro* para ativar ou *falso* para desativar a proteção contra exclusão.

------
#### [ Disable deletion protection (Console) ]

**Desabilitar proteção contra exclusão**

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 **Proteger**, selecione **Proteger configuração**.

1. Na página **Configurações de proteção**, escolha a configuração de proteção que terá a proteção contra exclusão desativada.

1. Na guia **Proteção contra exclusão**, escolha o botão **Editar configurações**.

1. Desmarque **Ativar proteção contra exclusão** e, em seguida, escolha **Salvar alterações**.

------

# Renomear uma configuração de proteção no AWS End User Messaging SMS
<a name="protect-configuration-change-name"></a>

Para ajudar a gerenciar suas configurações de proteção, você deve dar a elas nomes descritivos. Você pode adicionar ou editar o nome de uma configuração de proteção a qualquer momento. Você precisa adicionar uma tag com a **chave** definida como **Name** e o **valor** definido como o nome a ser usado.

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 **Proteger**, selecione **Proteger configuração**.

1. Na página **Configuração de proteção**, escolha a configuração de proteção à qual deseja adicionar uma tag.

1. Na guia **Tags**, selecione **Gerenciar tags**. Em **Gerenciar** escolha **Adicionar nova tag**.

1. Em **Chave** insira **Name** e em **Valor**, insira um nome amigável.

1. Escolha **Salvar alterações**.

# Gerencie tags para uma configuração de proteção no AWS End User Messaging SMS
<a name="protect-configuration-tags"></a>

As tags são pares de chaves e valores que você pode aplicar opcionalmente aos seus AWS recursos para controlar o acesso ou o uso. Adicionar uma tag a um recurso pode ajudar a categorizar e gerenciar recursos de diferentes maneiras, como por finalidade, proprietário, ambiente ou outros critérios. Você pode usar tags para encontrar facilmente recursos existentes ou para controlar quais usuários podem acessar recursos específicos.

Para gerenciar tags para uma configuração protegida, você pode usar o console SMS do AWS End User Messaging, as `UnTagResource` ações `TagResource` e na API AWS End User Messaging SMS and voice v2 ou os `aws sms-voice untag-resource` comandos `aws sms-voice tag-resource` and no AWS CLI. Esta seção mostra como marcar e desmarcar uma configuração de proteção usando o console SMS do AWS End User Messaging e o. AWS CLI

------
#### [ Manage tags (Console) ]

Use o console AWS End User Messaging SMS para adicionar, editar ou excluir uma tag. 

**Gerenciamento de etiquetas (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 **Proteger**, selecione **Proteger configurações**.

1. Na página **Configurações de proteção**, escolha a configurações de proteção à qual deseja adicionar uma tag.

1. Na guia **Tags**, selecione **Gerenciar tags**.
   + **Adicionar uma tag** — Em **Gerenciar tags**, escolha **Adicionar nova tag** para criar um novo key/value par em branco.
   + **Excluir uma tag** — Em **Gerenciar tags**, escolha **Remover** ao lado do par chave/valor.
   + **Editar uma tag** — Em **Gerenciar tags**, escolha a **chave** ou o **valor** e edite o texto.

1. Escolha **Salvar alterações**.

------
#### [ Manage tags (AWS CLI) ]

Use o AWS CLI para adicionar ou editar uma tag. 

```
$ aws pinpoint-sms-voice-v2 tag-resource \
  --resource-arn resource-arn \
  --tags tags={key1=value1,key2=value2}
```

No exemplo anterior, faça o seguinte:
+ *resource-arn*Substitua pelo Amazon Resource Name (ARN) ao qual você deseja adicionar as tags.
+ *key2*Substitua *key1* e pelas chaves das tags que você deseja adicionar ao recurso.
+ *value2*Substitua *value1* e pelos valores das tags que você deseja adicionar às respectivas chaves.

Use o AWS CLI para excluir uma tag. 

```
$ aws pinpoint-sms-voice-v2 untag-resource \
  --resource-arn resource-arn \
  --tag-keys tags={key1=value1,key2=value2}
```

No exemplo anterior, faça o seguinte:
+ *resource-arn*Substitua pelo Amazon Resource Name (ARN) do qual você deseja remover a tag.
+ *key2*Substitua *key1* e pelas chaves das tags que você deseja remover.
+ *value2*Substitua *value1* e pelos valores das tags que você deseja remover.

------