

**Aviso de fim do suporte:** em 30 de outubro de 2026, AWS encerrará o suporte para o Amazon Pinpoint. Após 30 de outubro de 2026, você não poderá mais acessar o console do Amazon Pinpoint nem seus recursos (endpoints, segmentos, campanhas, jornadas e analytics). Para obter mais informações, consulte [Fim do suporte do Amazon Pinpoint](https://docs.aws.amazon.com/console/pinpoint/migration-guide). **Observação:** as APIs relacionadas a SMS, voz, push móvel, OTP e validação de número de telefone não são afetadas por essa alteração e são suportadas pelo AWS End User Messaging.

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

# Remover tags dos recursos do Amazon Pinpoint de forma programática
<a name="tags-remove"></a>

Os exemplos a seguir mostram como remover uma tag (a chave e o valor) de um recurso do Amazon Pinpoint usando a [AWS CLI](https://docs.aws.amazon.com/cli/latest/userguide/) e a [API REST do Amazon Pinpoint](https://docs.aws.amazon.com/pinpoint/latest/apireference/). Você também pode usar qualquer AWS SDK compatível para remover uma tag de um recurso.

[Para remover uma tag de vários recursos do Amazon Pinpoint em uma única operação, use as operações de marcação de grupos de recursos do AWS CLI ou da AWS Resource Groups API de marcação.](https://docs.aws.amazon.com/resourcegroupstagging/latest/APIReference/Welcome.html) Para remover apenas um valor de tag específico, e não uma chave de tag, de um recurso, [atualize a tag para o recurso](tags-update.md).

## Remover tags usando a API
<a name="tags-remove-api"></a>

Para remover uma tag de um recurso usando a API REST do Amazon Pinpoint, envie uma solicitação DELETE para o URI de [Tags](https://docs.aws.amazon.com/pinpoint/latest/apireference/rest-api-tags.html). No URI, inclua o nome de recurso da Amazon (ARN) do recurso do qual você deseja remover uma tag, seguido pelo parâmetro `tagKeys` e a tag a ser removida. Por exemplo:

```
https://{{endpoint}}/v1/tags/{{resource-arn}}?tagKeys={{key}}
```

 Em que:
+ {{endpoint}}é o endpoint do Amazon Pinpoint para a AWS região que hospeda o recurso.
+ {{resource-arn}}é o ARN do recurso do qual você deseja remover uma tag.
+ {{key}}é a tag que você deseja remover do recurso.

Todos os parâmetros devem ser codificados por URL.

Para remover várias chaves de tags e seus valores associados de um recurso, anexe o parâmetro e argumento de `tagKeys` para cada tag adicional a ser removida, separada por um E comercial (&). Por exemplo: 

```
https://{{endpoint}}/v1/tags/{{resource-arn}}?tagKeys={{key1}}&tagKeys={{key2}}
```

Todos os parâmetros devem ser codificados por URL.

## Remova as tags usando o AWS CLI
<a name="tags-remove-cli"></a>

Para remover uma tag de um recurso usando o AWS CLI, execute o `untag-resource` comando. Inclua o parâmetro e argumento `tag-keys`, conforme mostrado no exemplo a seguir.

------
#### [ Linux, macOS, or Unix ]

```
$ aws pinpoint untag-resource \
  --resource-arn {{resource-arn}} \
  --tag-keys {{key1}} {{key2}}
```

------
#### [ Windows Command Prompt ]

```
C:\> aws pinpoint untag-resource ^
     --resource-arn {{resource-arn}} ^
     --tag-keys {{key1}} {{key2}}
```

------

No exemplo anterior, faça as seguintes alterações:
+ {{resource-arn}}Substitua pelo ARN do recurso do qual você deseja remover as tags.
+ {{key2}}Substitua {{key1}} e pelas chaves das tags que você deseja remover do recurso.