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

# Adicione tags aos recursos no Connect Customer
<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. No entanto, você não pode definir o valor de uma tag como 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:
+  [Connect Customer TagResource](https://docs.aws.amazon.com/connect/latest/APIReference/API_TagResource.html)
+  [Conecte perfis de clientes TagResource ](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_TagResource.html) 
+  [Conecte o ID de voz do cliente 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 de atendimento ao cliente do Connect oferecem suporte a até 50 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 com elas `aws:` porque AWS reservam esse prefixo para tags geradas pelo sistema. Não é possível adicionar, modificar ou excluir tags `aws:*`, e elas não são consideradas em relação ao seu limite de tags por recurso.

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


**Suporte de marcação para recursos do Connect Customer**  

| Recurso | Suporta marcação usando o site do Connect Customer administrador | Suporta marcação usando o 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 Connect Customer é excluída
<a name="tag-retention"></a>

O Connect Customer retém os metadados das tags dos recursos mesmo depois que o recurso é excluído. Os metadados são retidos enquanto a instância Connect Customer estiver ativa. 

Esse design oferece suporte a casos de uso de relatórios históricos e controle de acesso (TBAC). Especificamente, o Connect Customer 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 Connect Customer, momento em que o acesso aos dados históricos não é mais aplicável.

## Tag-based controle de acesso
<a name="tagging-access-control"></a>

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

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

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