**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:** APIs relacionados a SMS, voz, push móvel, OTP e validação de número de telefone não são afetados por essa alteração e são compatíveis com o 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á. # Gerenciar tags de recursos do Amazon Pinpoint Uma *tag* é um rótulo que você opcionalmente define e associa a AWS recursos, incluindo certos tipos de recursos do Amazon Pinpoint. As tags podem ajudar a categorizar e gerenciar recursos de diferentes maneiras, como por finalidade, proprietário, ambiente ou outros critérios. Por exemplo, você pode usar tags para aplicar políticas ou automação ou para identificar recursos sujeitos a determinados requisitos de conformidade. Você pode adicionar tags aos seguintes tipos de recurso do Amazon Pinpoint: + Campanhas + Modelos de mensagens + Projetos (aplicativos) + Segmentos Um recurso pode ter até 50 tags. Cada tag consiste em uma *chave de tag* obrigatória e um *valor de tag* opcional, ambos definidos por você. *Uma chave de tag* é um rótulo geral que atua como uma categoria para valores de tags mais específicos. Um *valor de tag* atua como um descritor de uma chave de tag. Uma chave de tag pode ter até 128 caracteres. Um valor de tag pode conter até 256 caracteres. Os caracteres podem ser letras Unicode, números, espaços em branco ou um dos seguintes símbolos: \$1 . : / = \$1 -. As seguintes restrições adicionais se aplicam às tags: + As chaves e valores das tags diferenciam maiúsculas de minúsculas. + Para cada recurso associado, cada chave de tag deve ser exclusiva e pode ter apenas um valor. + O `aws:` prefixo é reservado para uso por AWS; você não pode usá-lo em nenhuma chave ou valor de tag definido por você. Além disso, você não pode editar ou remover chaves de tag ou valores que usam esse prefixo. As tags que usam esse prefixo não adicionam à cota de 50 tags por recurso. + Você não pode atualizar ou excluir um recurso com base apenas em suas tags. Você também deve especificar o nome do recurso da Amazon (ARN) ou o ID do recurso, dependendo da operação usada. + Você pode associar tags a recursos públicos ou compartilhados. No entanto, as tags estão disponíveis somente para sua AWS conta, não para qualquer outra conta que compartilhe o recurso. Além disso, as tags estão disponíveis somente para recursos localizados na AWS região especificada da sua AWS conta. Para adicionar, exibir, atualizar e remover chaves e valores de tag dos recursos do Amazon Pinpoint, você pode usar o AWS Command Line Interface (AWS CLI), a API do Amazon Pinpoint, a API de marcação ou um SDK. AWS Resource Groups AWS Para gerenciar chaves e valores de tags em todos os AWS recursos que estão localizados em uma AWS região específica para sua AWS conta (incluindo recursos do Amazon Pinpoint), use a API de [AWS Resource Groups marcação](https://docs.aws.amazon.com/resourcegroupstagging/latest/APIReference/overview.html). Para obter mais informações sobre os comandos da CLI que você pode usar para gerenciar os recursos do Amazon Pinpoint, consulte a seção do Amazon Pinpoint da [Referência de comandos da AWS CLI](https://docs.aws.amazon.com/cli/latest/reference/pinpoint/). Para obter mais informações sobre recursos na API do Amazon Pinpoint, incluindo suporte de métodos HTTP(S), parâmetros e esquemas, consulte a [Referência da API do Amazon Pinpoint](https://docs.aws.amazon.com/pinpoint/latest/apireference/). # Usar as tags do Amazon Pinpoint em políticas do IAM e operações de API Depois de começar a implementar as tags, você pode aplicar permissões baseadas em tags em nível de recurso às políticas AWS Identity and Access Management (IAM) e às operações de API. Isto inclui operações que são compatíveis com acrescentar tags a recursos quando estes são criados. Ao usar tags dessa forma, você pode implementar um controle granular de quais grupos e usuários da sua AWS conta têm permissão para criar e marcar recursos e quais grupos e usuários têm permissão para criar, atualizar e remover tags de forma mais geral. Por exemplo, é possível criar uma política que permita que um usuário tenha acesso completo a todos os recursos do Amazon Pinpoint, no qual o nome é um valor na tag `Owner` do recurso: ------ #### [ JSON ] **** ``` { "Version":"2012-10-17", "Statement": [ { "Sid": "ModifyResourceIfOwner", "Effect": "Allow", "Action": "mobiletargeting:*", "Resource": "*", "Condition": { "StringEqualsIgnoreCase": { "aws:ResourceTag/Owner": "${aws:username}" } } } ] } ``` ------ Se você definir permissões em nível de recurso e baseadas em tag, elas entrarão em vigor imediatamente. Isso significa que seus recursos ficam mais seguros assim que são criados, e que você pode começar a aplicar rapidamente o uso de tags em novos recursos. Também é possível usar permissões em nível de recurso para controlar quais valores e chaves de tag podem ser associados a recursos novos e existentes. Para obter mais informações, consulte [Controlling Access Using Tags](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_tags.html) no *Guia do usuário do IAM da AWS *. # Adicionar tags a recursos do Amazon Pinpoint de forma programática Os exemplos a seguir mostram como adicionar uma tag a 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 adicionar uma tag a um recurso. [Para adicionar uma tag a vários recursos do Amazon Pinpoint em uma única operação, use as operações de marcação de grupos de recursos AWS CLI ou a AWS Resource Groups API de marcação.](https://docs.aws.amazon.com/resourcegroupstagging/latest/APIReference/Welcome.html) ## Adicionar tags usando a API Para criar um recurso e adicionar uma tag a ele usando a API REST do Amazon Pinpoint, envie uma solicitação POST ao URI do recurso apropriado. No corpo da solicitação, inclua o parâmetro `tags` e os valores. O exemplo a seguir mostra como especificar uma tag ao criar um novo projeto. ``` POST /v1/apps HTTP/1.1 Host: pinpoint.us-east-1.amazonaws.com Content-Type: application/x-www-form-urlencoded Accept: application/json Cache-Control: no-cache { "Name":"MyProject", "tags":{ "key1":"value1" } } ``` Para adicionar uma tag a um recurso existente, envie uma solicitação POST ao URI de [Tags](https://docs.aws.amazon.com/pinpoint/latest/apireference/tags-resource-arn.html). Inclua o nome de recurso da Amazon (ARN) do recurso no URI. O ARN deve ser codificado por URL. No corpo da solicitação, inclua o parâmetro `tags` e os valores, conforme mostrado no exemplo a seguir. ``` POST /v1/tags/resource-arn HTTP/1.1 Host: pinpoint.us-east-1.amazonaws.com Content-Type: application/json Accept: application/json Cache-Control: no-cache { "tags":{ "key1":"value1" } } ``` ## Adicione tags usando o AWS CLI Para criar um novo recurso e adicionar uma tag a ele usando o AWS CLI, use o `create` comando apropriado para o recurso. Inclua o parâmetro `tags` e os valores. O exemplo a seguir mostra como especificar tags ao criar um novo projeto. ------ #### [ Linux, macOS, or Unix ] ``` $ aws pinpoint create-app \ --create-application-request '{ "Name":"MyProject", "tags": { "key1":"value1", "key2":"value2" } }' ``` ------ #### [ Windows Command prompt ] ``` C:\> aws pinpoint create-app ^ --create-application-request Name=MyProject,tags={key1=value1,key2=value2} ``` ------ No exemplo anterior, faça o seguinte: + *MyProject*Substitua pelo nome que você deseja dar ao projeto. + *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. Para obter informações sobre os comandos que podem ser usados para criar um recurso do Amazon Pinpoint, consulte a [Referência de comandos da AWS CLI](https://docs.aws.amazon.com/cli/latest/reference/pinpoint/). Para adicionar uma tag a um recurso existente, empregue o comando `tag-resource` e especifique os valores apropriados para os parâmetros necessários: ------ #### [ Linux, macOS, or Unix ] ``` $ aws pinpoint tag-resource \ --resource-arn resource-arn \ --tags-model '{ "tags": { "key1":"value1", "key2":"value2" } }' ``` ------ #### [ Windows Command Prompt ] ``` C:\> aws pinpoint tag-resource ^ --resource-arn resource-arn ^ --tags-model tags={key1=value1,key2=value2} ``` ------ No exemplo anterior, faça o seguinte: + *resource-arn*Substitua pelo Amazon Resource Name (ARN) do recurso ao qual você deseja adicionar uma tag. + *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. # Exibir tags para recursos do Amazon Pinpoint de forma programática Os exemplos a seguir mostram como usar o [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/) para exibir uma lista de todas as tags (chaves e valores) que estão associadas a um recurso do Amazon Pinpoint. Você também pode usar qualquer AWS SDK compatível para exibir as tags associadas a um recurso. ## Exibir tags usando a API Para usar a API REST do Amazon Pinpoint para exibir todas as tags que estão associadas a um recurso específico, envie uma solicitação GET ao URI de [Tags](https://docs.aws.amazon.com/pinpoint/latest/apireference/rest-api-tags.html), incluindo o nome do recurso da Amazon (ARN) do recurso no URI. O ARN deve ser codificado por URL. Por exemplo, a solicitação a seguir recupera todas as tags associadas a uma campanha especificada (*resource-arn*): ``` GET /v1/tags/resource-arn HTTP/1.1 Host: pinpoint.us-east-1.amazonaws.com Content-Type: application/json Accept: application/json Cache-Control: no-cache ``` A resposta JSON à solicitação inclui um objeto `tags`. O objeto `tags` lista todas as chaves de tag e valores que estão associados à campanha. Para exibir todas as tags que estão associadas a mais de um recurso do mesmo tipo, envie uma solicitação GET ao URI apropriado para aquele tipo de recurso. Por exemplo, a solicitação a seguir recupera informações sobre todas as campanhas no projeto especificado (*application-id*): ``` GET /v1/apps/application-id/campaigns HTTP/1.1 Host: pinpoint.us-east-1.amazonaws.com Content-Type: application/json Accept: application/json Cache-Control: no-cache ``` A resposta JSON à solicitação lista todas as campanhas no projeto. O objeto `tags` de cada campanha lista todas as chaves e valores de tag associados à campanha. ## Exibir tags usando o AWS CLI Para usar o AWS CLI para exibir uma lista das tags associadas a um recurso específico, execute o `list-tags-for-resource` comando e especifique o Amazon Resource Name (ARN) do recurso para o `resource-arn` parâmetro, conforme mostrado no exemplo a seguir. ------ #### [ Linux, macOS, or Unix ] ``` $ aws pinpoint list-tags-for-resource \ --resource-arn resource-arn ``` ------ #### [ Windows Command Prompt ] ``` C:\> aws pinpoint list-tags-for-resource ^ --resource-arn resource-arn ``` ------ Para exibir uma lista de todos os recursos do Amazon Pinpoint que têm tags e todas as tags associadas a cada um desses recursos, use o comando [get-resources](https://docs.aws.amazon.com/resourcegroupstagging/latest/APIReference/API_GetResources.html) da API de marcação. AWS Resource Groups Defina o parâmetro `resource-type-filters` como `mobiletargeting`, conforme mostrado no exemplo a seguir. ------ #### [ Linux, macOS, or Unix ] ``` $ aws resourcegroupstaggingapi get-resources \ --resource-type-filters "mobiletargeting" ``` ------ #### [ Windows Command Prompt ] ``` C:\> aws resourcegroupstaggingapi get-resources ^ --resource-type-filters "mobiletargeting" ``` ------ A saída do comando é uma lista de todos ARNs os recursos do Amazon Pinpoint que têm tags. A lista inclui todas as chaves de tag e valores associados a cada recurso. # Atualizar ou sobrescrever tags para recursos do Amazon Pinpoint de forma programática Há várias formas de atualizar (substituir) uma tag para um recurso do Amazon Pinpoint. A melhor maneira de atualizar uma tag depende de: + O tipo de recurso para o qual você deseja atualizar tags. + Isto se aplica tanto se você quiser atualizar uma tag para um recurso quanto para vários recursos ao mesmo tempo. + Se você quiser atualizar uma chave de tag e um valor de tag, ou ambos. [Para atualizar uma tag para um projeto do Amazon Pinpoint ou para vários recursos ao mesmo tempo, 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) Atualmente, a API do Amazon Pinpoint não oferece suporte direto a nenhuma dessas tarefas. Para atualizar uma chave de tag para um recurso, você pode [remover a tag atual](tags-remove.md) e [adicionar uma nova tag](tags-add.md) usando a API do Amazon Pinpoint. # Remover tags dos recursos do Amazon Pinpoint de forma programática 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 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 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.