Conceptos de Espacios de Nombres de Etiquetas y Etiquetas

Oracle Cloud Infrastructure soporta dos tipos de etiquetas: etiquetas de formato libre y etiquetas definidas.

Consejo

Vea un vídeo donde se explican los conceptos y las funciones del etiquetado: Introducción a Oracle Cloud Infrastructure Tagging.

Política de IAM necesaria

Si es miembro del grupo Administradores, tendrá el acceso necesario para gestionar espacios de nombres de etiquetas y etiquetas.

Para obtener más ejemplos de políticas específicos para trabajar con etiquetas y espacios de nombres de etiquetas, consulte Permisos necesarios para trabajar con etiquetas definidas.

Si no está familiarizado con las políticas, consulte Introducción a las políticas y Políticas comunes. Si desea obtener más información sobre la escritura de políticas para grupos u otros componentes de IAM, consulte Detalles de IAM sin dominios de identidad.

Visión general de las etiquetas y los espacios de nombres de etiquetas

Las etiquetas definidas proporcionan más funciones y control que las etiquetas de formato libre. Para crear una clave de etiqueta definida, primero debe configurar un espacio de nombres de etiqueta para ella. Puede pensar en el espacio de nombres de una etiqueta como un contenedor para un conjunto de claves de etiquetas.

Al crear la definición de clave de etiqueta, debe elegir el tipo de valor (que también determina cómo el usuario que aplica la etiqueta agrega el valor): 

  • Puede dejarlo vacío para que un usuario pueda rellenar el valor.
  • Puede crear una lista de valores para que el usuario tenga que seleccionar entre esos valores.
Nota

Los caracteres permitidos para los espacios de nombres de etiqueta y las claves son ASCII imprimible, excepto el espacio U+0020 (" "), y U+002E full stop ("."). Los nombres de clave y espacio de nombres no pueden estar vacíos.

Evite introducir información confidencial.

Para aplicar una etiqueta definida a un recurso, el usuario selecciona primero el espacio de nombres de la etiqueta, la clave de la etiqueta en el espacio de nombres y, a continuación, puede asignar el valor. Si la clave de etiqueta contiene un valor en blanco, el usuario puede escribir un valor o dejarlo en blanco. Si la clave de etiqueta contiene una lista, el usuario debe seleccionar un valor en la lista.

Las etiquetas definidas soportan una política para permitirle controlar quién puede aplicar las etiquetas definidas. El espacio de nombres de la etiqueta es la entidad a la que puede aplicar la política. Los administradores pueden controlar qué grupos de usuarios pueden utilizar cada espacio de nombres.

En los siguientes diagramas se muestran las etiquetas definidas. Se han configurado dos espacios de nombres de etiqueta: Operations y HumanResources. Las claves de etiqueta se definen en los espacios de nombres. Dentro de cada espacio de nombres, las claves de etiquetas deben ser únicas, pero un nombre de clave de etiqueta se puede repetir en los distintos espacios de nombres. En el ejemplo, ambos espacios de nombres incluyen una clave denominada "Environment".

En esta imagen se muestran dos espacios de nombres con definiciones de claves de etiquetas

La primera instancia está etiquetada con dos etiquetas del espacio de nombres de la etiqueta Operations, lo que indica que pertenece al entorno de producción Operations y al proyecto "Alpha" de Operations. La segunda instancia está etiquetada con etiquetas tanto del espacio de nombres de etiqueta HumanResources como del espacio de nombres de etiqueta Operations, lo que indica que pertenece al entorno "Production" de HumanResources, al centro de costos HumanResources "42" y también al proyecto "Beta" de Operations.

En esta imagen se muestran las etiquetas definidas aplicadas a las instancias y se resalta el concepto de espacio de nombres

Trabajar con etiquetas estándar

Para reducir las complejidades de la creación y gestión de etiquetas, Oracle Cloud Infrastructure Tagging proporciona plantillas de espacios de nombres de etiquetas estándar y definiciones de etiquetas.

Puede utilizar esta plantilla para crear un espacio de nombres de etiqueta y aportar coherencia en su arrendamiento.

Para obtener más información, consulte Descripción de etiquetas estándar. Para saber cómo importar etiquetas estándar mediante la consola, consulte Importar etiquetas estándar.

Trabajar con etiquetas definidas

Debe configurar el espacio de nombres de etiqueta y las claves de etiqueta de su arrendamiento para que los usuarios puedan aplicar una etiqueta definida a un recurso. Como parte del proceso de configuración, también debe otorgar permisos a los grupos de usuarios que necesitan utilizar el espacio de nombres.

Nota

Los espacios de nombres de etiquetas y las definiciones de clave de etiqueta que empiezan por "oci" y "orcl" están reservados para uso interno.

Entre las características de las etiquetas definidas se incluyen:

  • Constan de un espacio de nombres de etiqueta, una clave y un valor.
  • El espacio de nombres de la etiqueta y la definición de la clave de la etiqueta se deben haber configurado previamente en el arrendamiento para que los usuarios puedan aplicar una etiqueta definida a un recurso.
  • Puede crear la clave de etiqueta con un tipo de valor de etiqueta de cadena (para que el usuario agregue un valor o lo deje en blanco) o una lista de valores (de la que debe seleccionar el usuario).
  • Al aplicar una etiqueta definida, los usuarios realizan la selección en la lista de claves de etiqueta.
  • Los usuarios pueden aplicar una etiqueta definida durante la creación de recursos o a un recurso existente.
  • Las claves de etiquetas definidas no son sensibles a mayúsculas/minúsculas.
  • Los valores de etiquetas definidas son sensibles a mayúsculas/minúsculas. Por ejemplo, "alfa" y"Alfa" son valores distintos.
  • Puede utilizar variables de etiqueta.
  • Puede crear una lista de variables predefinidas para asociarlas a una clave de etiqueta. Los usuarios que aplican la etiqueta a un recurso deben seleccionar un valor de la lista que cree.

Los administradores de etiquetas crean y gestionan las etiquetas definidas, que los usuarios aplican a los recursos. Utilice la política de IAM para seleccionar los administradores de etiquetas que puedan crear etiquetas. Al resto de usuarios del arrendamiento otórgueles únicamente la capacidad de aplicar etiquetas.

Permisos necesarios para trabajar con etiquetas definidas

Para aplicar, actualizar o eliminar etiquetas definidas para un recurso, se debe otorgar a un usuario permisos sobre el recurso y permisos para utilizar el espacio de nombres de etiquetas.

A los usuarios se les debe otorgar acceso use en el espacio de nombres de etiquetas para aplicar, actualizar o eliminar una etiqueta definida para un recurso.

Algunas políticas de ejemplo para los espacios de nombres de etiqueta:

Para permitir que un grupo vea simplemente los espacios de nombres de etiquetas en el arrendamiento (o en un compartimento) se requiere acceso inspect:

Allow group GroupA to inspect tag-namespaces in tenancy
Importante

Para aplicar etiquetas a un recurso al utilizar la consola, un usuario debe tener permisos de tipo inspect tag-namespaces in tenancy. Si el usuario no tiene este permiso, la lista de espacios de nombres de etiquetas no se puede presentar al usuario en el menú del cuadro de diálogo.

Para permitir que un grupo lea las definiciones de etiquetas incluidas en los espacios de nombres de etiquetas, se necesita acceso read:

Allow group GroupA to read tag-namespaces in tenancy

Para permitir que un grupo aplique, actualice o elimine una etiqueta definida para un recurso es necesario el acceso use en el espacio de nombres de la etiqueta:

Allow group GroupA to use tag-namespaces in tenancy

Para permitir el uso de uno o varios espacios de nombres de etiquetas específicos, utilice una cláusula where con la variable target.tag-namespace.name. Por ejemplo:

Allow group GroupA to use tag-namespaces in tenancy where target.tag-namespace.name='Operations'

o para especificar varios espacios de nombres de etiquetas:

Allow group GroupA to use tag-namespaces in tenancy where any {target.tag-namespace.name='Operations', target.tag-namespace.name='HumanResources'}

Para gestionar los espacios de nombres de etiquetas y las definiciones de etiquetas en ellos, se necesita acceso manage:

Allow group GroupA to manage tag-namespaces in tenancy

Además de los permisos para trabajar con el espacio de nombres de la etiqueta, para aplicar o eliminar etiquetas definidas en un recurso, debe tener el permiso de actualización para el recurso. En muchos recursos, el permiso de actualización se otorga con el verbo use. Por ejemplo, los usuarios que pueden utilizar instancias en CompartmentA también pueden aplicar, actualizar o eliminar etiquetas definidas para las instancias en CompartmentA.

Algunos recursos no incluyen el permiso de actualización con el verbo use. Para permitir que un grupo aplique, actualice o elimine etiquetas definidas para estos recursos sin otorgar permisos completos de tipo manage, puede agregar una sentencia de política para otorgar solo el permiso <RESOURCE>_UPDATE del verbo manage. Por ejemplo, para permitir que un grupo NetworkUsers utilice etiquetas definidas con VCN en CompartmentA, podría escribir una política como:


Allow group NetworkUsers to use vcns in compartment CompartmentA
Allow group NetworkUsers to manage vcns in compartment CompartmentA where request.permission='VCN_UDPATE'

El permiso inspect de un recurso otorga permisos para ver las etiquetas definidas de ese recurso. Por ejemplo, los usuarios que pueden utilizar inspect en las instancias también pueden ver cualquier etiqueta definida aplicada a la instancia.

Para obtener información sobre los permisos de recursos, consulte Referencia de políticas.

Escenario de ejemplo

Su compañía tiene un departamento de Operaciones. Dentro del departamento de Operaciones hay varios centros de costos. Quiere poder etiquetar los recursos que pertenecen al departamento de Operaciones con el centro de costos adecuado.

  1. Cree una definición de espacio de nombres de etiqueta denominada Operations (Operaciones).
  2. En el espacio de nombres Operations, cree una definición de clave de etiqueta denominada CostCenter (Centro de costos).

Alice ya pertenece al grupo InstanceLaunchers. Alice puede gestionar las instancias de CompartmentA. Quiere que Alice y otros miembros del grupo InstanceLaunchers puedan aplicar la etiqueta Operations.CostCenter a las instancias de CompartmentA.

Para otorgar acceso al grupo InstanceLaunchers al espacio de nombres de etiqueta Operations (y solo a ese espacio de nombres de etiqueta), agregue las siguientes sentencias a la política de InstanceLaunchers:

Allow group InstanceLaunchers to use tag-namespaces in compartment CompartmentA where target.tag-namespace.name='Operations'

Ahora, Alice puede aplicar la etiqueta Operations.CostCenter a los recursos de CompartmentA.

Herencia de etiquetas de compartimento

Los compartimentos secundarios y sus recursos en servicios de medición, como Análisis de costos, Informes de uso y Presupuesto, heredan las etiquetas definidas aplicadas a un compartimento. Sin embargo, si existe un conflicto entre las etiquetas heredadas y las etiquetas aplicadas directamente a los recursos o a los compartimentos secundarios, las etiquetas aplicadas a los recursos tienen prioridad sobre las etiquetas heredadas. Puede aplicar dinámicamente etiquetas definidas a recursos de un compartimento.

Por ejemplo, considere un arrendamiento denominado TenancyA con TagKey1=TagValueP y un compartimento denominado Compartimento P con TagKey3=TagValueQ y TagKey4=TagValueS. Tiene una instancia informática en el compartimento P con TagKey2=TagValueR, TagKey3=TagValueT. Cuando se aplica la lógica de herencia de etiquetas, se aplican las siguientes etiquetas a la instancia informática: TagKey2=TagValueR, TagKey3=TagValueT, TagKey4=TagValueS. El recurso ha heredado TagKey4=TagValueS del compartimento principal. Sin embargo, TagKey3 aplicado a la instancia informática sustituye el valor TagKey3 aplicado al compartimento principal.

Puede filtrar mediante etiquetas heredadas en Análisis de costos, crear presupuestos con etiquetas heredadas y ver estas etiquetas en los informes de uso.

Retirada de definiciones de clave y definiciones de espacio de nombres

Puede retirar una definición de clave de etiqueta o una definición de espacio de nombres de etiqueta.

Al retirar una definición de clave de etiqueta, ya no la puede aplicar a los recursos. Sin embargo, la etiqueta no se elimina de los recursos a los que se haya aplicado. La etiqueta aún existe como metadatos en esos recursos y aún puede llamar a la etiqueta retirada en operaciones (como listado, ordenación o generación de informes).

Importante

Al retirar una etiqueta se detiene el seguimiento de costos de la misma, pero si no desactiva la opción de seguimiento de costos en la definición de clave de la etiqueta, la etiqueta retirada se seguirá contando a la hora de llegar al máximo de 10 etiquetas de seguimiento de costos para su arrendamiento. Desactive el seguimiento de costos antes de retirar la definición de clave de etiqueta. Para desactivar el seguimiento de costos después de retirar una etiqueta, debe volver a activar la definición de clave de etiqueta. No puede actualizar las definiciones de clave de etiqueta que tengan el estado retirado.

Reactivación de definiciones de claves de etiquetas y definiciones de espacios de nombres

Puede reactivar las definiciones de claves de etiquetas retiradas y las definiciones de espacios de nombres de etiquetas.

  • Cuando vuelva a activar una clave de etiqueta, volverá a estar disponible para que la aplique a los recursos.
  • Al reactivar un espacio de nombres de etiqueta, puede crear definiciones de clave de etiqueta nuevas en ese espacio de nombres. Sin embargo, si desea utilizar cualquiera de las definiciones de clave de etiqueta retiradas con el espacio de nombres, debe volver a activar explícitamente cada definición de clave de etiqueta.

Movimiento de espacios de nombres de etiquetas a otro compartimento

Puede mover un espacio de nombres de etiqueta a otro compartimento. El espacio de nombres de etiqueta puede estar activo o retirado al moverlo. Al mover el espacio de nombres de la etiqueta, todas sus definiciones de clave de etiqueta se mueven junto con él.

Esta funcionalidad es útil si necesita reorganizar la jerarquía de compartimentos o suprimir un compartimento que contenga un espacio de nombres de etiqueta retirado. Recuerde que no puede suprimir un compartimento que contenga recursos. Un espacio de nombres de etiqueta retirado, aunque se haya retirado, aún es un recurso existente. Al mover el espacio de nombres de la etiqueta retirado a otro compartimento, puede permitirle suprimir su compartimento de contenido original.

Para mover un espacio de nombres de etiqueta, debe tener permiso manage tag-namespaces en ambos compartimentos.

Consulte el procedimiento Moving a Tag Namespace to a Different Compartment.

Supresión de espacios de nombres y definiciones de claves de etiquetas

Puede suprimir definiciones de clave de etiqueta y espacios de nombres de etiquetas.

Cuando suprime una definición de clave de etiqueta, inicia un proceso que elimina la etiqueta de todos los recursos de su arrendamiento. Esto sucede de inmediato: 

  • Si la etiqueta era una etiqueta de seguimiento de costos, ya no se cuenta para llegar al límite de 10 etiquetas de seguimiento de costos, tanto si la ha desactivado antes como si no.
  • Si la etiqueta se ha utilizado con grupos dinámicos, ninguna de las reglas que contengan la etiqueta se evaluará con respecto a la etiqueta.

La acción de supresión es asíncrona e inicia una solicitud de trabajo. Después de iniciar la operación de supresión, el estado de la etiqueta cambia a Suprimiendo y comienza la eliminación de la etiqueta de los recursos. Este proceso puede tardar hasta 48 horas según el número de recursos etiquetados, así como las regiones en las que residen dichos recursos. Una vez eliminadas todas las etiquetas, el estado cambia a Suprimida. Las etiquetas suprimidas no se pueden restaurar. Una vez que el estado de la etiqueta cambie a Suprimida, puede volver a utilizar el mismo nombre de etiqueta.

Para suprimir una definición de clave de etiqueta, primero debe retirarla. Para suprimir un espacio de nombres de etiqueta, primero debe retirarlo. Al retirar un espacio de nombres de etiqueta que contiene definiciones de clave de etiqueta, todas las claves de etiqueta del espacio de nombres se retiran, lo que le permite suprimir el espacio de nombres de etiqueta.