Documentación de Oracle Cloud Infrastructure

Etiquetado de recursos

Utilice el etiquetado con el proveedor de Terraform de Oracle Cloud Infrastructure.

Cuando tiene muchos recursos (por ejemplo, instancias, VCN, equilibradores de carga y volúmenes en bloque) en varios compartimentos de su arrendamiento, puede ser difícil realizar un seguimiento de los recursos utilizados con fines específicos o agregarlos, informar sobre ellos o realizar acciones masivas relacionadas. El etiquetado permite definir claves y valores y asociarlos a recursos. A continuación, puede utilizar las etiquetas para organizar y mostrar los recursos según las necesidades de negocio.

Hay dos tipos de etiquetas:

Un administrador configura las etiquetas definidas en el arrendamiento. Solo los usuarios con permiso para trabajar con las etiquetas definidas pueden aplicarlas a los recursos. Las etiquetas definidas proporcionan una asignación de clave/valor y se organizan combinando los espacios de nombres de etiquetas con las claves de etiquetas mediante una notación de puntos. Por ejemplo, un espacio de nombres de etiqueta denominado HumanResources podría tener una clave denominada CostCenter. A continuación, asocie el espacio de nombres y la clave HumanResource.CostCenter y, después, asigne la etiqueta.

Cualquier usuario con permisos en el recurso puede aplicar etiquetas de formato libre. Las etiquetas de formato libre son asignaciones de clave/valor simples.

  • Consulte la referencia oci_identity_tag_namespace para obtener orientación sobre la gestión del ciclo de vida de los espacios de nombres de etiquetas.
  • Consulte la referencia oci_identity_tag para obtener instrucciones sobre la gestión de etiquetas.

El archivo de configuración tags.tf de nuestros ejemplos contiene varios recursos relacionados con el etiquetado.

La referencia completa de los recursos y orígenes de datos que soporta el proveedor de Terraform de OCI contiene detalles sobre el uso, los argumentos y los atributos. La referencia completa está disponible en docs.oracle.com y en Terraform Registry.

Para obtener más información sobre las etiquetas y sus funciones, consulte Visión general de Tagging.

Propagación del etiquetado en los recursos

Los servicios de OCI propagan todas las etiquetas de formato libre de un recurso principal y las etiquetas definidas en recursos secundarios cuando ambos recursos soportan el tipo de etiquetas. Por ejemplo, si la configuración de Terraform tiene una instancia informática como recurso principal y una VNIC como recurso secundario anidado, todas las etiquetas de la instancia informática se propagarán a la VNIC.

Esta propagación podría causar un cambio en el estado de Terraform que resultaría en una diferencia tras la aplicación. Para evitar un posible cambio, agregue explícitamente todas las etiquetas de formato libre y etiquetas definidas del recurso principal en los recursos secundarios como parte de la configuración.

Este mismo comportamiento se puede observar al utilizar las funciones de valor por defecto de etiqueta o etiquetas requeridas. Evite el cambio aplicando el Valor por defecto de etiqueta o las Etiquetas necesarias en todos los recursos (principales y secundarios, si los hay) en el arrendamiento donde existan el Valor por defecto de etiqueta o las Etiquetas necesarias.