Documentación de Oracle Cloud Infrastructure

Adición de etiquetas en la creación de recursos (IAM en OCI)

En Compute Cloud@Customer, los valores por defecto de etiqueta que se definen en un compartimento se agregan automáticamente a todos los recursos que se crean en ese compartimento o a cualquier compartimento secundario de ese compartimento, después de definir el valor por defecto de etiqueta. Un valor por defecto de etiqueta puede requerir que introduzca un valor para la etiqueta para crear el recurso.

Nota

Para aplicar etiquetas definidas y espacios de nombres de etiquetas durante la creación de recursos, deben configurarse en su arrendamiento de OCI con antelación. Consulte Etiquetas definidas.

Las etiquetas de formato libre se pueden crear y aplicar durante la creación del recurso. Consulte Etiquetas de formato libre

    1. En el cuadro de diálogo Crear del recurso, desplácese a la sección Etiquetado.

    2. Seleccione el espacio de nombres de etiqueta o seleccione Ninguno (para aplicar una etiqueta de formato libre).

      • Si ha seleccionado un espacio de nombres de etiqueta, seleccione la clave de etiqueta e introduzca un valor o seleccione un valor de la lista.

      • Si ha seleccionado Ninguno (aplicar una etiqueta de formato libre), introduzca una clave de etiqueta e introduzca un valor.

    3. Para aplicar otra etiqueta, seleccione el botón Etiqueta adicional.

      No puede especificar más de una etiqueta con el mismo espacio de nombres de etiqueta y la misma clave de etiqueta para una etiqueta definida, ni más de una etiqueta con la misma clave de etiqueta para una etiqueta de formato libre.

    4. Para revisar las etiquetas del recurso, vaya a la página de detalles del nuevo recurso.

      En la página de detalles del recurso, seleccione el separador Etiquetas para mostrar las etiquetas que se aplican a este recurso.

  • Para agregar una etiqueta a un recurso al crear el recurso, utilice el comando create o launch del recurso.

    1. Obtenga la información de cada etiqueta que desee agregar al recurso.

      • Obtenga el espacio de nombres, la clave y el valor de cada etiqueta definida que desee agregar al recurso.

        Cree un argumento para la opción --defined-tags. Especifique cada espacio de nombres de etiqueta y par de claves de etiqueta solo una vez.

      • Obtenga la clave y el valor de cada etiqueta de formato libre que desee agregar al recurso.

        Cree un argumento para la opción --freeform-tags. Especifique cada clave de etiqueta solo una vez.

      El valor del argumento de opción --defined-tags y el argumento de opción --freeform-tags es una definición de JSON de las etiquetas. Esta definición de JSON se puede proporcionar como una cadena en la línea de comandos o en un archivo.

      Puede generar una plantilla del JSON correcto que proporcionar mediante la opción --generate-param-json-input con el comando base que utilizará para etiquetar el recurso. El argumento para la opción --generate-param-json-input es el nombre de la opción que se utiliza para especificar las etiquetas (--defined-tags en este ejemplo) sin el indicador de opción (--), como se muestra en el siguiente ejemplo:

      $ oci service resource create --generate-param-json-input defined-tags > defined_tags.json

      El contenido del archivo defined_tags.json de salida es:

      {
  "tagNamespace1": {
    "tagKey1": "tagValue1",
    "tagKey2": "tagValue2"
  },
  "tagNamespace2": {
    "tagKey1": "tagValue1",
    "tagKey2": "tagValue2"
  }
}

      Si especifica freeform-tags en lugar de defined-tags en el comando anterior, obtendrá la siguiente salida:

      {
  "tagKey1": "tagValue1",
  "tagKey2": "tagValue2"
}

      Edite estas plantillas para proporcionar las etiquetas adecuadas. Especifique el resultado en el comando final como se muestra en el siguiente paso.

    2. Ejecute el comando create o launch del recurso.

      Para agregar una o más etiquetas definidas, utilice la opción --defined-tags. Para agregar una o más etiquetas de formato libre, utilice la opción --freeform-tags.

      Sintaxis:

      oci <service> <resource> create --compartment-id <compartment_OCID> --defined-tags <defined_tags_json> --freeform-tags <freeform_tags_json> <other_resource_create_options>

      Ejemplo:

      En el siguiente ejemplo, una o más etiquetas definidas se agregan mediante un archivo y una etiqueta de formato libre se agrega mediante un argumento de cadena. Utilice la sintaxis file:// para especificar un archivo como argumento de opción.

      oci <service> <resource> create --compartment-id <compartment_OCID> --defined-tags file://defined_tags.json --freeform-tags '{"MyTag":"val-u"}' <other_resource_create_options>

      La salida del comando create o launch del recurso es la misma que la salida del comando get del recurso. La salida muestra las etiquetas definidas y de formato libre.

    Para obtener una lista completa de los comandos, indicadores y opciones de CLI, consulte la Referencia de línea de comando.

  • Para agregar una etiqueta a un recurso al crear el recurso, utilice los comandos create<resource> o launch<resource>.

    Para obtener más información sobre el uso de la API y la firma de solicitudes, consulte API de REST y Credenciales de seguridad. Para obtener información sobre los SDK, consulte Software development kits e interfaz de línea de comandos.