Marcar recursos do Amazon Pinpoint - Amazon Pinpoint
Como gerenciar tagsUsar tags nas políticas do IAMAdicionar tags do a recursos do Exibir tags para recursosAtualizar tags para recursosRemoção de tags de recursosInformações relacionadas

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

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

Como gerenciar 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: _ . : / = + -. 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 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.

Usar tags nas políticas do IAM

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:

{
   "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 no Guia do usuário do IAM da AWS .

Adicionar tags do a recursos do

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"
   }
}

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

  • MyProjectSubstitua pelo nome que você deseja dar ao projeto.

  • Substitua key1 e key2 pelas chaves das tags que você deseja adicionar ao recurso.

  • Substitua value1 e value2 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.

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:

  • Substitua resource-arn pelo nome do recurso da Amazon (ARN) do recurso ao qual você deseja adicionar uma tag.

  • Substitua key1 e key2 pelas chaves das tags que você deseja adicionar ao recurso.

  • Substitua value1 e value2 pelos valores das tags que você deseja adicionar às respectivas chaves.

Exibir tags para recursos

Os exemplos a seguir mostram como usar o AWS CLI e a API REST do Amazon Pinpoint 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.

Exibição de 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, 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 que estão 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.

Exibindo 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 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 ARNs para todos os recursos do Amazon Pinpoint que possuem tags. A lista inclui todas as chaves de tag e valores associados a cada recurso.

Atualizar tags para recursos

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. 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 e adicionar uma nova tag usando a API do Amazon Pinpoint.

Remoção de tags de recursos

Os exemplos a seguir mostram como remover uma tag (a chave e o valor) de 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 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. 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.

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. 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 da Região da AWS 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.

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

  • Substitua resource-arn pelo ARN do recurso do qual você deseja remover as tags.

  • Substitua key1 e key2 pelas chaves das tags que você deseja remover do recurso.

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.

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.