# Marcar uma distribuição
<a name="tagging"></a>

Tags são palavras ou frases que podem ser usadas para identificar e organizar seus recursos da AWS. É possível adicionar várias tags a cada recurso, e cada tag inclui uma chave e um valor definidos por você. Por exemplo, a chave pode ser "domínio" e o valor pode ser "exemplo.com". Você pode pesquisar e filtrar seus recursos de acordo com as tags que adicionar. 

É possível usar tags com o CloudFront, como estes exemplos: 
+ Aplique permissões baseadas em tags a distribuições do CloudFront. Para obter mais informações, consulte [ABAC com o CloudFront](security_iam_service-with-iam.md#security_iam_service-with-iam-tags).
+ Monitore as informações de faturamento em categorias diferentes. Quando você aplica tags a distribuições do CloudFront ou a outros recursos da AWS (como instâncias do Amazon EC2 ou buckets do Amazon S3) e as ativa, a AWS gera um relatório de alocação de custos como um arquivo CSV (valores separado por vírgula) com seu uso e custos agregados por tags ativas. 

  É possível aplicar tags que representem categorias de negócios (como centros de custos, nomes de aplicativos ou proprietários) para organizar seus custos de vários serviços. Para obter mais informações sobre como usar tags para alocação de custos, consulte [Como usar tags de alocação de custo](https://docs.aws.amazon.com/awsaccountbilling/latest/aboutv2/cost-alloc-tags.html) no *Manual do usuário do AWS Billing*.

**Observações**  
Você pode marcar distribuições com tags, mas não pode marcar origin access identities ou invalidações com tags.
O [Editor de tags](https://docs.aws.amazon.com/ARG/latest/userguide/tag-editor.html) e os [Grupos de recursos](https://docs.aws.amazon.com/ARG/latest/userguide/resource-groups.html) não são compatíveis com o CloudFront no momento.
Para saber o número máximo atual de tags que podem ser adicionadas a uma distribuição, consulte [Cotas gerais](cloudfront-limits.md#limits-general). 

**Contents**
+ [Restrições de tags](#tagging-restrictions)
+ [Adicionar, editar e excluir tags para distribuições](#tagging-add-edit-delete)
+ [Marcação programática](#tagging-related-information)

## Restrições de tags
<a name="tagging-restrictions"></a>

As restrições básicas a seguir se aplicam a tags:
+ Consulte o número máximo de tags por distribuição em [Cotas gerais](cloudfront-limits.md#limits-general).
+ Comprimento máximo da chave: 128 caracteres Unicode
+ Comprimento máximo do valor: 256 caracteres Unicode
+ Valores válidos de chave e valor: a-z, A-Z, 0-9, espaço e os seguintes caracteres: \$1 . : / = \$1 - e @
+ As chaves e os valores de tags diferenciam maiúsculas de minúsculas
+ Não use `aws:` como prefixo para chaves do. O uso deste prefixo é reservado para a AWS.

## Adicionar, editar e excluir tags para distribuições
<a name="tagging-add-edit-delete"></a>

É possível usar o console do CloudFront para gerenciar tags para suas distribuições.<a name="tagging-add-edit-delete-procedure"></a>

**Para adicionar, editar ou excluir tags de uma distribuição**

1. Faça login no Console de gerenciamento da AWS e abra o console do CloudFront em [https://console.aws.amazon.com/cloudfront/v4/home](https://console.aws.amazon.com/cloudfront/v4/home).

1. Escolha o ID da distribuição que você deseja atualizar.

1. Escolha a guia **Tags**.

1. Selecione **Gerenciar tags**.

1. Na página **Gerenciar tags** é possível fazer o seguinte:
   + Para adicionar uma tag, insira uma chave e, se desejar, um valor para ela. Selecione **Adicionar nova tag** para adicionar mais tags.
   + Para editar uma etiqueta, modifique sua chave e/ou seu valor. Você pode excluir o valor de uma etiqueta, mas a chave é obrigatória.
   + Para excluir uma tag, escolha **Remove** (Remover).

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

## Marcação programática
<a name="tagging-related-information"></a>

Também é possível usar a API do CloudFront, a AWS Command Line Interface (AWS CLI), SDKs da AWS e o AWS Tools for Windows PowerShell para aplicar tags. Para saber mais, consulte os seguintes tópicos:
+ Operações da API do CloudFront:
  + [ListTagsForResource](https://docs.aws.amazon.com/cloudfront/latest/APIReference/API_ListTagsForResource.html) 
  + [TagResource](https://docs.aws.amazon.com/cloudfront/latest/APIReference/API_TagResource.html) 
  + [UntagResource](https://docs.aws.amazon.com/cloudfront/latest/APIReference/API_UntagResource.html) 
+ AWS CLI: consulte [cloudfront](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudfront/index.html) na *Referência de comandos da AWS CLI*.
+ SDKs da AWS: consulte a documentação do SDK aplicável na página [Documentação da AWS](https://docs.aws.amazon.com/index.html).
+ Tools for Windows PowerShell: consulte [Amazon CloudFront](https://docs.aws.amazon.com/powershell/latest/reference/items/CloudFront_cmdlets.html) na [Referência de Cmdlet do Ferramentas da AWS para PowerShell](https://docs.aws.amazon.com/powershell/latest/reference/)