Etiqueta de recurso - AWS CloudFormation

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.

Etiqueta de recurso

Puede utilizar las etiquetas de recursos para aplicar etiquetas a los recursos, lo que puede ayudarle a identificar y categorizar esos recursos. Puede etiquetar solo los recursos para los que AWS CloudFormation admite el etiquetado. Para obtener información sobre qué recursos puede etiquetar con AWS CloudFormation, consulte los recursos individuales en Referencia de tipos de recursos y propiedades de AWS.

nota

El etiquetado de las implementaciones puede variar por recurso. Por ejemplo, AWS::AutoScaling::AutoScalingGroup proporciona una propiedad adicional necesaria, PropagateAtLaunch, como parte de su esquema de etiquetado.

Además de las etiquetas que defina usted, AWS CloudFormation crea automáticamente las siguientes etiquetas en el nivel de pila con el prefijo aws::

  • aws:cloudformation:logical-id

  • aws:cloudformation:stack-id

  • aws:cloudformation:stack-name

El prefijo aws: se reserva para uso de AWS. Este prefijo no distingue entre mayúsculas y minúsculas Si utiliza este prefijo en la propiedad Key o Value no puede actualizar ni eliminar la etiqueta. Las etiquetas con este prefijo no cuentan para el número de etiquetas por recurso.

Todas las etiquetas a nivel de pila, incluidas las creadas automáticamente, se propagan a recursos compatibles con AWS CloudFormation. En la actualidad, las etiquetas no se propagan a volúmenes de Amazon EBS creados a partir de mapeos de dispositivos de bloques.

Sintaxis

JSON

{ "Key" : String, "Value" : String }

YAML

Key: String Value: String

Properties

Key

El nombre de clave de la etiqueta. Puede especificar un valor comprendido entre 1 y 128 caracteres Unicode y no se le puede añadir el prefijo aws:. Puede utilizar cualquiera de los siguientes caracteres: el conjunto de letras Unicode, dígitos, espacio en blanco, _, ., /, =, + y -.

Obligatorio: sí

Tipo: cadena

Value

El valor de la etiqueta. Puede especificar un valor de entre 0 y 256 caracteres de longitud.

Obligatorio: sí

Tipo: cadena

Ejemplo

En este ejemplo se muestra una propiedad Tags. Puede especificar esta propiedad dentro de la sección Properties de un recurso que la admita. Cuando se crea el recurso, se etiqueta con las etiquetas que usted declare.

JSON

"Tags" : [ { "Key" : "keyname1", "Value" : "value1" }, { "Key" : "keyname2", "Value" : "value2" } ]

YAML

Tags: - Key: "keyname1" Value: "value1" - Key: "keyname2" Value: "value2"

Véase también