

# Marcar recursos do API Gateway
<a name="apigateway-tagging"></a>

Uma *tag* é um rótulo de metadados que você ou a AWS atribui a um recurso da AWS. Cada tag tem duas partes:
+ Uma *chave de tag* (por exemplo `CostCenter`, `Environment` ou `Project`). Chaves de tag fazem distinção entre maiúsculas e minúsculas.
+ Um campo opcional conhecido como um *valor de tag* (por exemplo, `111122223333` ou `Production`). Omitir o valor da tag é o mesmo que usar uma string vazia. Como as chaves de tag, os valores das tags diferenciam maiúsculas de minúsculas.

As tags ajudam você a fazer o seguinte:
+ Controlar o acesso aos recursos de acordo com as tags atribuídas a eles. Você controla o acesso especificando chaves e valores de tags nas condições para uma política do AWS Identity and Access Management (IAM). Para obter mais informações sobre o controle de acesso baseado em tags, consulte [Controlar o acesso usando tags](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_tags.html) no *Guia do usuário do IAM*.
+ Monitorar seus custos da AWS. Você pode ativar essas tags no painel Gerenciamento de Faturamento e Custos da AWS. AWS usa tags para categorizar seus custos e entregar um relatório mensal de alocação de custos a você. Para obter mais informações, consulte [ Usar tags de alocação de custos ](https://docs.aws.amazon.com/awsaccountbilling/latest/aboutv2/cost-alloc-tags.html) no [Guia do usuário do AWS Billing](https://docs.aws.amazon.com/awsaccountbilling/latest/aboutv2/).
+ Identificar e organizar seus recursos da AWS. Muitos serviços da AWS oferecem suporte à marcação para que você possa atribuir a mesma tag a recursos de diferentes serviços para indicar que os recursos estão relacionados. Por exemplo, é possível atribuir a mesma tag a um estágio do API Gateway que você atribui a uma regra do CloudWatch Events.

Para conferir dicas sobre como usar as etiquetas, consulte o whitepaper [AWS Tagging Strategies](https://docs.aws.amazon.com/whitepapers/latest/tagging-best-practices/tagging-best-practices.html). 

As próximas seções contêm mais informações sobre tags para o Amazon API Gateway.

**Topics**
+ [Recursos do API Gateway que podem ser marcados](apigateway-tagging-supported-resources.md)
+ [Usar tags para controlar o acesso aos recursos da API REST do API Gateway](apigateway-tagging-iam-policy.md)