Etiqueta de recurso - AWS CloudFormation
SintaxisPropiedadesEjemploVéase también

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

La propagación de etiquetas de pila a recursos, incluidas las creadas automáticamente, puede variar según el recurso. Por ejemplo, las etiquetas no se propagan a volúmenes de Amazon EBS creados a partir de asignaciones de dispositivos de bloques.

Sintaxis

JSON

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

YAML

Key: String
Value: String

Propiedades

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 usar cualquiera de los siguientes caracteres: el conjunto de letras Unicode, dígitos, espacios en blanco, _, ., :, /, =, +, @, - y ".

Obligatorio: sí

Tipo: cadena

Value

El valor de la etiqueta. Puede especificar un valor de entre 1 y 256 caracteres de longitud. Puede utilizar cualquiera de los siguientes caracteres: el conjunto de letras Unicode, dígitos, espacio en blanco, _, ., /, =, + y -.

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