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

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 e a API REST do Amazon Pinpoint. 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.

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

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.

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: