Visión general del servicio Etiquetado

El servicio Tagging le proporciona dos métodos de agregar etiquetas a los recursos.

Cada uno de ellos ofrece un tipo de etiqueta diferente con el que trabajar:

• Etiquetas definidas: los administradores de etiquetas gestionan los metadatos de los recursos.
• Etiquetas de formato libre: los usuarios aplican metadatos no gestionados a los recursos.

En uno de los métodos, un administrador de etiquetas crea y gestiona todas las etiquetas 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. La ventaja de este método es que usted puede crear y gestionar las claves y los valores que se utilizan para etiquetar recursos. De esta forma, se evitan los errores tipográficos que afectan negativamente a la automatización basada en etiquetas, además de obtenerse una generación de informes mejorada basada en las etiquetas.

En el otro método los usuarios pueden agregar etiquetas a los recursos. Usted o el usuario que crea o modifica un recurso edita o aplica cada una de las etiquetas al recurso. Puede utilizar ambos tipos de etiquetas en su arrendamiento.

La mayoría de las funciones de Tagging requieren etiquetas definidas. Con "etiqueta" se hace referencia genérica a las etiquetas definidas. Si desea crear metadatos en los que pueda confiar para gestionar recursos y recopilar datos, utilice las etiquetas definidas. En el caso de las etiquetas definidas, se pueden dar los siguientes escenarios: 

• Cree etiquetas por defecto que se aplican a todos los recursos de los compartimentos. Consulte Gestión de valores por defecto de etiquetas.
• Especificar que los usuarios deben aplicar etiquetas a los recursos para crear correctamente recursos en compartimentos.
• Si comete un error tipográfico en las etiquetas definidas, corríjalo mediante la edición o incluso la supresión de la etiqueta. Cuando suprime una etiqueta definida, Oracle elimina la clave y cualquier valor de esa etiqueta de todos los recursos. Consulte Supresión de espacios de nombres y definiciones de claves de etiquetas.
• Asociar una lista de valores predefinidos para una etiqueta definida. Consulte Uso de valores predefinidos.
• Utilice variables del sistema para generar automáticamente valores para etiquetas definidas o valores por defecto de etiqueta. Consulte Uso de variables de etiqueta.
• Realice un seguimiento de los costos según las etiquetas. Se recomienda el uso de etiquetas definidas para este caso de uso.

Describe los conceptos básicos del etiquetado.

A continuación se muestra una lista de los conceptos básicos de etiquetado:

ESPACIO DE NOMBRES DE ETIQUETA

Puede pensar en el espacio de nombres de una etiqueta como un contenedor de las claves de su etiqueta. Consta de un nombre y cero o más definiciones de clave de etiqueta. Los espacios de nombres de etiquetas no distinguen entre mayúsculas/minúsculas y deben ser únicos en el arrendamiento. El espacio de nombres también es una agrupación natural a la que los administradores pueden aplicar una política. Una política del espacio de nombres de una etiqueta se aplica a todas las definiciones de etiquetas que incluya ese espacio de nombres.

Nota

• No puede utilizar OCID para asignar un nombre al espacio de nombres de etiqueta porque los OCID no siguen el formato necesario para asignar nombres a los espacios de nombres de etiquetas.
• No puede cambiar el nombre del espacio de nombres de su etiqueta. Sin embargo, puede retirarlo.

CLAVE DE ETIQUETA

Nombre que utiliza para hacer referencia a la etiqueta. Las claves de etiqueta no distinguen entre mayúsculas/minúsculas. Por ejemplo, mytagkey duplica MyTagKey. Las claves de etiqueta de las etiquetas definidas se deben crear en un espacio de nombres. Cada clave de etiqueta debe ser única en un espacio de nombres.

TIPO DE VALOR DE ETIQUETA

El tipo de valor de etiqueta especifica el tipo de dato permitido para el valor. Actualmente están soportados dos tipos de dato: cadena y lista de cadenas.

DEFINICIÓN DE CLAVE

Una definición de clave identifica el esquema de una etiqueta e incluye un espacio de nombres, una clave de etiqueta y un tipo de valor de etiqueta.

Nota

No puede cambiar el nombre de la definición de clave de etiqueta. Sin embargo, puede retirarlo

VALOR DE ETIQUETA

El valor de etiqueta es el valor que el usuario que aplica la etiqueta agrega a la clave de la etiqueta. Los valores de etiqueta soportan dos tipos de dato: cadenas y listas de cadenas. Puede definir una lista de valores entre los que puede seleccionar el usuario cuando defina la clave de etiqueta, o bien puede permitir al usuario introducir cualquier valor cuando se aplique la etiqueta al recurso. Si selecciona un valor de etiqueta de cadena al crear la clave, el usuario puede dejar el valor en blanco cuando aplique la clave.

En el ejemplo:

Operations.CostCenter="42"

Operations es el espacio de nombres, CostCenter es la clave de etiqueta y 42 es el valor de la etiqueta.

ETIQUETA (O ETIQUETA DEFINIDA)

Una etiqueta es la instancia de una definición de clave que se aplica a un recurso. Consta de un espacio de nombres, una clave y un valor. Con "etiqueta" se hace referencia genérica a las etiquetas definidas.

ETIQUETA DE FORMATO LIBRE

Asociación de metadatos básica que consta solo de una clave y un valor. Las etiquetas de formato libre tienen una funcionalidad limitada. Consulte Descripción de etiquetas de formato libre.

SEGUIMIENTO DE COSTOS

El seguimiento de costos es una función disponible con las etiquetas definidas. Para saber cuándo tiene que designar una etiqueta como etiqueta de seguimiento de costos, consulte Uso de etiquetas de seguimiento de costos.

VALOR POR DEFECTO DE ETIQUETA

Los valores por defecto de etiqueta le permiten especificar las etiquetas que se aplicarán automáticamente a todos los recursos de un compartimento específico en el momento de la creación, independientemente de los permisos del usuario que cree el recurso. Consulte Gestión de valores por defecto de etiquetas.

RETIRAR

Puede retirar una definición de clave de etiqueta o un espacio de nombres de etiqueta. Los espacios de nombres de etiqueta y las definiciones de clave retirados ya no se pueden aplicar a los recursos. Sin embargo, las etiquetas retiradas no se eliminan de los recursos a los que ya se hayan aplicado. Podrá seguir especificando las etiquetas retiradas al buscar, filtrar, generar informes, etc.

REACTIVAR

Puede reactivar un espacio de nombres de etiqueta o una definición de clave de etiqueta que se haya retirado para volver a instanciar su uso en el arrendamiento.

VARIABLE DE ETIQUETA

Puede utilizar una variable para definir el valor de una etiqueta. Al agregar o actualizar una etiqueta en un recurso, la variable se resuelve en los datos que representa. Consulte Uso de variables de etiqueta.

VALORES PREDEFINIDOS

Puede utilizar una variable para definir el valor de una etiqueta. Al agregar o actualizar una etiqueta en un recurso, la variable se resuelve en los datos que representa. Consulte Uso de valores predefinidos.

EJEMPLO DE ETIQUETA

{
  "compartmentId": "ocid.compartment.oc1..exampleuniquecompartmentID",
  "namespace": "ansh8lvru1zp",
  "objectEventsEnabled": true,
  "name": "my-test-1",
  "freeformTags": {"Department": "Finance"},
  "definedTags":
  {
    "MyTags":
    {
      "CostCenter": "42",
      "Project": "Stealth",
      "CreatedBy": "BillSmith",
      "CreatedDate": "9/21/2017T14:00"
    },
    "Audit":
    {
      "DataSensitivity": "PII",
      "CageSecurity": "High",
      "Simplicity": "complex"
    }
  }
}

Para administradores: utilice los siguientes temas para buscar un ejemplo de política de IAM para el servicio Etiquetado: 

• Permisos necesarios para trabajar con etiquetas definidas
• Permisos necesarios para trabajar con valores por defecto de etiquetas
• Permisos necesarios para trabajar con etiquetas de formato libre

El servicio Etiquetado está disponible actualmente en todas las regiones.

Obtenga información sobre los límites por recurso de las etiquetas y los caracteres soportados en las cadenas de etiquetas.

• Etiquetas por arrendamiento: ilimitadas
• Etiquetas por recurso: 10 etiquetas de formato libre y 64 etiquetas definidas
• Etiquetas activadas para seguimiento de costos: 10 por arrendamiento (incluye tanto etiquetas activas como retiradas)
• Tamaño total de los datos de la etiqueta: 5 K (JSON). El tamaño total de los datos de etiqueta incluye todos los datos de etiqueta de un solo recurso (todas las etiquetas y valores de etiqueta aplicados). El tamaño se ajusta por UTF-8.
• Número de valores predefinidos para una clave de etiqueta: 100 por lista

Proporciona la lista de recursos soportados por el etiquetado.

En la siguiente tabla, se muestran los recursos que soportan el etiquetado. Esta tabla se actualizará a medida que se agregue el soporte del etiquetado a más recursos.