# Etiquetado de los recursos de Amazon CloudWatch
Una *etiqueta* es un atributo personalizado que por su parte o AWS hayan asignado a un recurso de AWS.
Las etiquetas le ayudan a hacer lo siguiente:
+ Identificar y organizar sus recursos de AWS. Muchos servicios de AWS admiten el etiquetado. Puede asignar la misma etiqueta a los recursos de diferentes servicios para indicar que los recursos están relacionados. Por ejemplo, puede asignar a una instancia de EC2 la etiqueta que ha asignado a una regla de CloudWatch.
Las etiquetas se componen de dos partes:
+ Una *clave de etiqueta* (por ejemplo, `CostCenter`, `Environment` o `Project`). Las claves de etiqueta distinguen entre mayúsculas y minúsculas.
+ Un campo opcional denominado *valor de etiqueta* (por ejemplo, `111122223333` o `Production`). Omitir el valor de etiqueta es lo mismo que utilizar una cadena vacía. Al igual que las claves de etiqueta, los valores de etiqueta distinguen entre mayúsculas y minúsculas.
En las siguientes secciones, se ofrece más información acerca de las etiquetas de CloudWatch.
## Recursos admitidos en CloudWatch
Los siguientes recursos en CloudWatch admiten el etiquetado:
+ Alarmas: puede etiquetar las alarmas por medio del comando [tag-resource](https://docs.aws.amazon.com/cli/latest/reference/cloudwatch/tag-resource.html) de la AWS CLI y la API [TagResource](https://docs.aws.amazon.com/AmazonCloudWatch/latest/APIReference/API_TagResource.html). También puede ver y gestionar las etiquetas de alarma mediante la página de detalles de *Alarmas* de la consola CloudWatch.
+ Canaries: puede etiquetar canaries con la consola de CloudWatch. Para obtener más información, consulte [Creación de un valor controlado](CloudWatch_Synthetics_Canaries_Create.md).
+ Reglas de Contributor Insights: puede etiquetar las reglas de Contributor Insights cuando las cree por medio del comando [put-insight-rule](https://docs.aws.amazon.com/cli/latest/reference/cloudwatch/put-insight-rule.html) de la AWS CLI y la API [PutInsightRule](https://docs.aws.amazon.com/AmazonCloudWatch/latest/APIReference/API_PutInsightRule.html). Puede agregar etiquetas a las reglas existentes mediante el uso del comando [tag-resource](https://docs.aws.amazon.com/cli/latest/reference/cloudwatch/tag-resource.html) de la AWS CLI y la API [TagResource](https://docs.aws.amazon.com/AmazonCloudWatch/latest/APIReference/API_TagResource.html).
+ Secuencias métricas: puede etiquetar las secuencias métricas cuando las cree por medio del comando [put-metric-stream](https://docs.aws.amazon.com/cli/latest/reference/cloudwatch/put-metric-stream.html) de la AWS CLI y la API [PutMetricStream](https://docs.aws.amazon.com/AmazonCloudWatch/latest/APIReference/API_PutMetricStream.html). Puede agregar etiquetas a las secuencias métricas existentes mediante el uso del comando [tag-resource](https://docs.aws.amazon.com/cli/latest/reference/cloudwatch/tag-resource.html) de la AWS CLI y la API [TagResource](https://docs.aws.amazon.com/AmazonCloudWatch/latest/APIReference/API_TagResource.html).
Para obtener información acerca de cómo añadir y administrar etiquetas, consulte [Administrar etiquetas](#CloudWatch-tagging-add-edit-delete).
## Administrar etiquetas
Las etiquetas se componen de las propiedades `Value` y `Key` de un recurso. Puede utilizar la consola de CloudWatch, la AWS CLI o la API de CloudWatch para agregar, editar o eliminar los valores de estas propiedades. Para obtener información sobre cómo trabajar con etiquetas, consulte lo siguiente:
+ [TagResource](https://docs.aws.amazon.com/AmazonCloudWatch/latest/APIReference/API_TagResource.html),[UntagResource](https://docs.aws.amazon.com/AmazonCloudWatch/latest/APIReference/API_UntagResource.html), y [ListTagsForResource](https://docs.aws.amazon.com/AmazonCloudWatch/latest/APIReference/API_ListTagsForResource.html) en la *Referencia de la API de Amazon CloudWatch*
+ [tag-resource](https://docs.aws.amazon.com/cli/latest/reference/cloudwatch/tag-resource.html), [untag-resource](https://docs.aws.amazon.com/cli/latest/reference/cloudwatch/untag-resource.html), y [list-tags-for-resource](https://docs.aws.amazon.com/cli/latest/reference/cloudwatch/list-tags-for-resource.html) en la *Referencia de la CLI de Amazon CloudWatch*
+ [Working with Tag Editor](https://docs.aws.amazon.com/ARG/latest/userguide/tag-editor.html) (Uso del editor de etiquetas) en la *Guía del usuario de Resource Groups*
## Convenciones de nomenclatura y uso de las etiquetas
Las siguientes convenciones básicas de nomenclatura y uso se aplican al uso de etiquetas con recursos de CloudWatch:
+ Cada recurso puede tener un máximo de 50 etiquetas.
+ Para cada recurso, cada clave de etiqueta debe ser única y solo puede tener un valor.
+ La longitud máxima de la clave de etiqueta es de 128 caracteres Unicode en UTF-8.
+ La longitud máxima del valor de etiqueta es de 256 caracteres Unicode en UTF-8.
+ Los caracteres permitidos son letras, números y espacios representables en UTF-8, además de los siguientes caracteres: ***. : \$1 = @ \$1 / -*** (guion).
+ Las claves y los valores de las etiquetas distinguen entre mayúsculas y minúsculas. Como práctica recomendada, decida una estrategia de uso de mayúsculas y minúsculas en las etiquetas e implemente esa estrategia sistemáticamente en todos los tipos de recursos. Por ejemplo, decida si se va a utilizar `Costcenter`, `costcenter` o `CostCenter` y utilice la misma convención para todas las etiquetas. Procure no utilizar etiquetas similares con un tratamiento de mayúsculas y minúsculas incoherente.
+ El prefijo `aws:` está prohibido para las etiquetas, ya que está reservado para su uso por parte de AWS. Las claves y valores de etiquetas que tienen este prefijo no se pueden editar. Las etiquetas que tengan este prefijo no cuentan para el límite de etiquetas por recurso.