Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.
# Agregación de etiquetas a recursos en Amazon Connect
Una *etiqueta* es una designación de metadatos personalizada que puede agregar a un recurso para facilitar su identificación, organización y búsqueda. Las etiquetas se componen de dos partes individuales: una clave de etiqueta y un valor de etiqueta. Esto se denomina par *key:value*.
Una *clave de etiqueta* normalmente representa una categoría más grande, mientras que un valor de etiqueta representa un subconjunto de esa categoría. Por ejemplo, puede tener la *etiqueta Key=Color* y la *etiqueta Value=Blue*, lo que generaría el par clave:valor `Color:Blue`. Tenga en cuenta de que puede establecer el valor de una etiqueta como una cadena vacía, pero no puede asignarle un valor nulo. Omitir el valor de etiqueta es lo mismo que utilizar una cadena vacía.
Las claves de etiqueta pueden tener una longitud de hasta 128 caracteres y los valores de etiqueta pueden tener una longitud de hasta 256 caracteres; ambas distinguen entre mayúsculas y minúsculas. Para obtener más información, consulte lo siguiente:
+ [Amazon Connect TagResource](https://docs.aws.amazon.com/connect/latest/APIReference/API_TagResource.html)
+ [Perfiles de clientes de Amazon Connect 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): puedes añadir etiquetas al dominio de Voice ID.
+ [Amazon AppIntegrations TagResource](https://docs.aws.amazon.com/appintegrations/latest/APIReference/API_TagResource.html)
Los servicios de Amazon Connect admiten hasta 50 etiquetas por recurso. Para cada recurso, cada clave de etiqueta debe ser única y sólo puede tener un valor.
**nota**
Tus etiquetas no pueden empezar `aws:` por él porque AWS reserva este prefijo para las etiquetas generadas por el sistema. No puedes añadir, modificar ni eliminar `aws:*` etiquetas, y no se tienen en cuenta para tu límite. tags-per-resource
En la siguiente tabla se describen los recursos de Amazon Connect que se pueden etiquetar mediante el AWS CLI o un AWS SDK.
**Compatibilidad con el etiquetado de recursos de Amazon Connect**
| Recurso | Admite el etiquetado mediante el sitio web de Amazon Connect administración | Admite el etiquetado mediante la CLI o el SDK | Admite el etiquetado durante la creación |
| --- | --- | --- | --- |
| Agente | Sí | Sí | Sí |
| Grupo de agentes | No | Sí | Sí |
| Nivel de grupo de agentes | No | No | Sí |
| Estado de agente | No | Sí | Sí |
| Caso | Sí | Sí | Sí |
| Contacto | No | No | No |
| Evaluaciones de contacto | No | Sí | Sí |
| Direcciones de correo electrónico | Sí | Sí | Sí |
| Formularios de evaluación | Sí | Sí | Sí |
| Flujo | Sí | Sí | Sí |
| Módulo de flujo | Sí | Sí | Sí |
| Horas de funcionamiento | Sí | Sí | Sí |
| Instancia | Sí | Sí | Sí |
| Asociación de integración | No | Sí | Sí |
| Campaña externa | No | Sí | Sí |
| Número de teléfono | No | Sí | Sí |
| Mensajes | Sí | Sí | Sí |
| Agente de cola | No | No | Sí |
| Colas | Sí | Sí | Sí |
| Conexiones rápidas | No | Sí | Sí |
| Perfil de enrutamiento | Sí | Sí | Sí |
| Perfil de seguridad | Sí | Sí | Sí |
| Plantilla de etiquetas | No | No | Sí |
| Grupo de distribución de tráfico | No | Sí | Sí |
| Destino de transferencia | No | Sí | Sí |
| Caso de uso | No | Sí | Sí |
| Vocabulario | No | Sí | Sí |
*Para obtener más información sobre el etiquetado, incluidas las prácticas recomendadas, consulta [AWS los recursos de etiquetado](https://docs.aws.amazon.com/general/latest/gr/aws_tagging.html) en la AWS Referencia general.*
## Los metadatos de las etiquetas se eliminan solo cuando se borra la instancia de Amazon Connect
Amazon Connect conserva los metadatos de las etiquetas de los recursos incluso después de eliminarlos. Los metadatos se conservan mientras la instancia de Amazon Connect esté activa.
Este diseño admite casos de uso de informes históricos y control de acceso (TBAC). Concretamente, Amazon Connect utiliza un control de acceso basado en etiquetas para obtener métricas históricas. Si las etiquetas se eliminaran inmediatamente después de eliminar un recurso, los usuarios que anteriormente no tenían acceso a esos recursos podrían acceder por equivocación a las métricas históricas relacionadas con ellos. Al conservar las etiquetas se garantiza que los límites de acceso se mantengan constantes a lo largo del tiempo.
Las etiquetas se eliminan después de suprimir toda la instancia de Amazon Connect, momento en el que no se podrá acceder a los datos históricos.
## Control de acceso basado en etiquetas
Si quieres usar etiquetas para controlar el acceso a los recursos de tus AWS cuentas, debes proporcionar la información de las etiquetas como condición de una política de IAM. Por ejemplo, para controlar el acceso a su dominio de Voice ID en función de las etiquetas que le haya asignado, utilice la clave de condición `aws:ResourceTag/key-name` para especificar qué par clave:valor de etiqueta debe asociarse al dominio, con el fin de permitir determinadas acciones para él.
Para obtener más información sobre el control de acceso basado en etiquetas en la consola de Amazon Connect, consulte [Aplicación de controles de acceso basado en etiquetas en Amazon Connect](tag-based-access-control.md).
*Para obtener información más detallada sobre el control de acceso basado en etiquetas en IAM, consulte [Controlar el acceso a AWS los recursos mediante etiquetas](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_tags.html) en la Guía del usuario de IAM*