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 no Amazon Connect
<a name="tagging"></a>

*Tag* é um rótulo de metadados personalizado que você adiciona a um recurso para facilitar a identificação, organização e pesquisa de recursos. As tags são compostas de duas partes: uma chave e um valor de tag. Isso é conhecido como par de *chave:valor*.

Uma *chave de tag* normalmente representa uma categoria maior, enquanto um valor de tag representa um subconjunto dessa categoria. Por exemplo, você poderia ter a *tag key=Color *e a *tag value=Blue*, o que produziria o par de chave-valor `Color:Blue`. Observe que você pode definir o valor de uma tag como uma string vazia, mas não como um valor nulo. Omitir o valor da tag é o mesmo que usar uma string vazia.



Um chave de tag pode ter até 128 caracteres de extensão e os valores de tag podem ter até 256 caracteres de extensão. Para obter mais informações, consulte:
+  [Amazon Connect TagResource](https://docs.aws.amazon.com/connect/latest/APIReference/API_TagResource.html)
+  [Amazon Connect Customer Profiles TagResource](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_TagResource.html) 
+  [Amazon Connect Voice ID TagResource](https://docs.aws.amazon.com/voiceid/latest/APIReference/API_TagResource.html): você pode adicionar tags ao domínio do Voice ID. 
+  [Amazon AppIntegrationsTagResource](https://docs.aws.amazon.com/appintegrations/latest/APIReference/API_TagResource.html) 

Os serviços do Amazon Connect comportam até cinquenta tags por recurso. Para um determinado recurso, cada chave de tag precisa ser exclusiva e ter apenas um valor de tag. 

**nota**  
Suas tags não podem começar `aws:` porque AWS reservam esse prefixo para tags geradas pelo sistema. Você não pode adicionar, modificar ou excluir `aws:*` tags, e elas não contam para o seu tags-per-resource limite.

A tabela a seguir descreve os recursos do Amazon Connect que podem ser marcados usando o AWS CLI ou um AWS SDK.


**Suporte à marcação para recursos do Amazon Connect**  

| Recurso | Suporta marcação usando o site de Connect Customer administração | Oferece suporte à marcação usando a CLI/SDK | Oferece suporte à marcação na criação | 
| --- | --- | --- | --- | 
| Agente | Sim | Sim | Sim | 
| Grupo de atendentes | Não | Sim | Sim | 
| Nível do grupo de atendentes | Não | Não | Sim | 
| Estado do atendente | Não | Sim | Sim | 
| Caso | Sim | Sim | Sim | 
| Contato | Não | Não | Não | 
| Avaliações de contato | Não | Sim | Sim | 
| Endereços de e-mail | Sim | Sim | Sim | 
| Formulários de avaliação | Sim | Sim | Sim | 
| Fluxo | Sim | Sim | Sim | 
| Módulos de fluxo de fluxo | Sim | Sim | Sim | 
| Horas de operação | Sim | Sim | Sim | 
| Instância | Sim | Sim | Sim | 
| Associação de integração | Não | Sim | Sim | 
| Campanha externa | Não | Sim | Sim | 
| Número de telefone | Não | Sim | Sim | 
| Solicitações | Sim | Sim | Sim | 
| Atendente de fila | Não | Não | Sim | 
| Queues (Filas) | Sim | Sim | Sim | 
| Conexões rápidas | Não | Sim | Sim | 
| Perfil de roteamento | Sim | Sim | Sim | 
| Perfil de segurança | Sim | Sim | Sim | 
| Modelo de tarefa | Não | Não | Sim | 
| Grupo de distribuição de tráfego | Não | Sim | Sim | 
| Destino da transferência | Não | Sim | Sim | 
| Caso de uso | Não | Sim | Sim | 
| Vocabulário | Não | Sim | Sim | 

Para saber mais sobre marcação, incluindo as melhores práticas, consulte [AWS Recursos de marcação](https://docs.aws.amazon.com/general/latest/gr/aws_tagging.html) na Referência *AWS geral*. 

## Os metadados da tag são removidos somente quando a instância do Amazon Connect é excluída
<a name="tag-retention"></a>

O Amazon Connect retém os metadados da tag para os recursos mesmo depois que o recurso é excluído. Os metadados serão retidos enquanto a instância do Amazon Connect estiver ativa. 

Esse design oferece suporte a casos de uso de relatórios históricos e controle de acesso (TBAC). Especificamente, o Amazon Connect usa controle de acesso baseado em tags para métricas históricas. Se as tags fossem removidas imediatamente quando um recurso fosse excluído, os usuários que não tinham acesso a esses recursos anteriormente poderiam inadvertidamente obter acesso às métricas históricas que as envolviam. A retenção de tags garante que os limites de acesso permaneçam consistentes ao longo do tempo. 

As tags são removidas somente após a exclusão de toda a instância do Amazon Connect, momento em que o acesso aos dados históricos não é mais aplicável.

## Controle de acesso com base em tags
<a name="tagging-access-control"></a>

Para usar tags para controlar o acesso aos recursos em suas AWS contas, você precisa fornecer as informações da tag no elemento de condição de uma política do IAM. Por exemplo, para controlar o acesso ao seu domínio do Voice ID com base nas tags que você atribuiu a ele, use a chave de condição `aws:ResourceTag/key-name` para especificar qual par de chave-valor da tag deve ser anexado ao domínio, a fim de permitir determinadas ações para ele.

Para obter informações mais detalhadas sobre o controle de acesso baseado em tags no console do Amazon Connect, consulte [Aplicar controle de acesso baseado em tags no Amazon Connect](tag-based-access-control.md).

Para obter informações mais detalhadas sobre o controle de acesso baseado em tags no IAM, consulte Como [controlar o acesso a AWS recursos usando tags](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_tags.html) no Guia do *usuário do IAM*