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 Amazon Connect 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*