Documentación de Oracle Cloud Infrastructure

Etiquetas de recurso

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.

Cualquier usuario con permisos en el recurso puede aplicar etiquetas de formato libre.

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

Consejo

Vea un vídeo para conocer los conceptos y las funciones del etiquetado: Introduction to Tagging.
Atención

Evite introducir información confidencial al asignar descripciones, etiquetas o nombres fáciles de recordar a los recursos de la nube mediante la consola, la API o la CLI de Oracle Cloud Infrastructure.

Trabajar con etiquetas de recurso

Para agregar de forma masiva las etiquetas definidas

Cómo agregar varias etiquetas definidas a los recursos existentes. Para aplicar etiquetas definidas, debe tener permiso para utilizar el espacio de nombres.

  1. Abra el menú de navegación y haga clic en Gobernanza y administración. En Gestión de arrendamiento, haga clic en Explorador del arrendamiento.

  2. Seleccione los recursos a los que desee agregar etiquetas. También puede utilizar el menú desplegable Filtrar por tipo de recurso para acotar la lista de recursos.

  3. En el menú Acciones, haga clic en Gestionar etiquetas.

    Se abrirá la página Gestionar etiquetas. La primera tabla muestra las etiquetas aplicadas actualmente a los recursos seleccionados. La segunda tabla muestra los recursos seleccionados.

  4. En la lista de etiquetas existentes, haga clic en + Agregar nuevo.
    1. Seleccione el Espacio de nombres de etiqueta.
    2. Seleccione la Clave de etiqueta.
    3. Introduzca un valor en Valor.
  5. Para aplicar otra etiqueta, repita el paso anterior. Para eliminar una fila, haga clic en el botón Eliminar (x).

  6. Cuando haya agregado todas las etiquetas que desee, haga clic en Siguiente.

    Se abrirá una página de confirmación que muestra las acciones que se deben realizar y los recursos a los que se aplican las acciones.

  7. Haga clic en Enviar.

Se iniciará la página Solicitud de trabajo que muestra el estado de la solicitud de trabajo para agregar etiquetas a los recursos.

Para agregar etiquetas definidas a un recurso existente

Para aplicar una etiqueta definida, debe tener permiso para utilizar el espacio de nombres.

  1. Abra la consola y vaya a la página de detalles del recurso que desea etiquetar.

    Por ejemplo, para etiquetar una instancia informática: abra el menú de navegación y haga clic en Recursos informáticos. En Recursos informáticos, haga clic en Instancias. Se muestra una lista de instancias en su compartimento actual. Busque la instancia que desea etiquetar y haga clic en su nombre para ver la página de detalles.

  2. Haga clic en Aplicar etiquetas. Dependiendo del recurso, esta opción puede aparecer en el menú Más acciones.

  3. En el cuadro de diálogo Aplicar etiquetas al recurso:

    1. Seleccione el Espacio de nombres de etiqueta.
    2. Seleccione la Clave de etiqueta.
    3. En Valor, introduzca un valor o seleccione uno de la lista.
    4. Para aplicar otra etiqueta, haga clic en + Etiqueta adicional.
    5. Cuando termine de agregar etiquetas, haga clic en Aplicar etiqueta(s).
Para agregar una etiqueta de formato libre a un recurso existente

  1. Abra la consola y vaya a la página de detalles del recurso que desea etiquetar.

    Por ejemplo, para etiquetar una instancia informática: abra el menú de navegación y haga clic en Recursos informáticos. En Recursos informáticos, haga clic en Instancias. Se muestra una lista de instancias en su compartimento actual. Busque la instancia que desea etiquetar y haga clic en su nombre para ver la página de detalles.

  2. Haga clic en Aplicar etiquetas. Dependiendo del recurso, esta opción puede aparecer en el menú Más acciones.

  3. En el cuadro de diálogo Aplicar etiquetas al recurso:

    1. Seleccione Ninguna (aplicar etiqueta de formato libre).
    2. Introduzca la Clave de etiqueta.
    3. Introduzca unvalor.
    4. Para aplicar otra etiqueta, haga clic en + Etiqueta adicional.
    5. Cuando termine de agregar etiquetas, haga clic en Aplicar etiqueta(s).
Para agregar una etiqueta durante la creación del recurso

Puede aplicar etiquetas durante la creación de recursos. La ubicación de la opción Aplicar etiqueta(s) en el cuadro de diálogo varía según el recurso. Los pasos generales son los siguientes:

  1. En el cuadro de diálogo Crear del recurso, haga clic en Aplicar etiquetas.

    En algunos recursos, tiene que hacer clic en Mostrar opciones avanzadas para aplicar una etiqueta.

  2. En el cuadro de diálogo Aplicar etiquetas al recurso:

    1. Seleccione el Espacio de nombres de etiqueta o seleccione Ninguno para aplicar una etiqueta de formato libre.
    2. Seleccione o introduzca la Clave de etiqueta.
    3. En Valor, introduzca un valor o seleccione uno de la lista.
    4. Para aplicar otra etiqueta, haga clic en + Etiqueta adicional.
    5. Haga clic en Aplicar etiqueta(s).
Para filtrar una lista de recursos por etiqueta

Abra la consola, haga clic en el nombre del servicio y, a continuación, en el recurso que desea ver. La parte izquierda de la página muestra todos los filtros aplicados actualmente a la lista.

Por ejemplo, para ver instancias informáticas: haga clic en Recursos informáticos y, a continuación, en Instancias para ver la lista de instancias en el compartimento actual.

Para filtrar una lista de recursos por etiqueta definida
  1. Haga clic en Agregar junto a Filtros de etiquetas.
  2. En el cuadro de diálogo Agregar un filtro de etiqueta, introduzca lo siguiente:
    1. espacio de nombres de etiqueta: seleccione el espacio de nombres de etiqueta.
    2. Clave de etiqueta: seleccione la clave.
    3. Valor de etiqueta: seleccione una de las siguientes opciones:
      • Hacer coincidir con cualquier valor: muestra todos los recursos etiquetados con el espacio de nombres y la clave seleccionados, independientemente del valor de etiqueta.
      • Especificar valores coincidentes: devuelve recursos con el valor de etiqueta introducido en el cuadro de texto. Introduzca un valor en el cuadro de texto. Si desea especificar varios valores para el mismo espacio de nombres y clave, haga clic en + para mostrar otro cuadro de texto. Introduzca un valor por cuadro de texto.
    4. Haga clic en Aplicar filtro.
Para filtrar una lista de recursos por etiqueta de formato libre
  1. Haga clic en Agregar junto a Filtros de etiquetas.
  2. En el cuadro de diálogo Agregar un filtro de etiqueta, introduzca lo siguiente:
    1. Tag namespace: seleccione None (Ninguna) (etiqueta de formato libre).
    2. Clave de etiqueta: introduzca la clave.
    3. Valor de etiqueta: seleccione una de las siguientes opciones:
      • Hacer coincidir con cualquier valor: muestra todos los recursos etiquetados con el espacio de nombres y la clave seleccionados, independientemente del valor de etiqueta.
      • Especificar valores coincidentes: devuelve recursos con el valor de etiqueta introducido en el cuadro de texto. Introduzca un valor en el cuadro de texto. Si desea especificar varios valores para el mismo espacio de nombres y clave, haga clic en + para mostrar otro cuadro de texto. Introduzca un valor por cuadro de texto.
    4. Haga clic en Aplicar filtro.
Para actualizar de forma masiva las etiquetas definidas

Cómo actualizar las etiquetas definidas aplicadas a uno o más recursos.

  1. Abra el menú de navegación y haga clic en Gobernanza y administración. En Gestión de arrendamiento, haga clic en Explorador del arrendamiento.

  2. Seleccione los recursos cuyas etiquetas desea actualizar. También puede utilizar el menú desplegable Filtrar por tipo de recurso para acotar la lista de recursos.

  3. En el menú Acciones, haga clic en Gestionar etiquetas.

    Se abrirá la página Gestionar etiquetas. La primera tabla muestra las etiquetas aplicadas actualmente a los recursos seleccionados. La segunda tabla muestra los recursos seleccionados.

  4. En la lista de etiquetas, busque la etiqueta que desea actualizar e introduzca un nuevo valor. Para revertir el cambio, haga clic en el botón Deshacer.
  5. En Acción, seleccione Aplicar etiqueta a todos los recursos seleccionados.

  6. Si lo desea, actualice más valores de etiqueta. A continuación, haga clic en Siguiente.

    Se abrirá una página de confirmación que muestra las acciones que se deben realizar y los recursos a los que se aplican las acciones.

  7. Haga clic en Enviar.

Se iniciará la página Solicitud de trabajo que muestra el estado de la solicitud de trabajo para actualizar etiquetas en los recursos.

Para actualizar una etiqueta aplicada a un único recurso

  1. Abra la consola, haga clic en el nombre del servicio y, a continuación, haga clic en el recurso que desea ver.

    Por ejemplo, para ver las instancias informáticas: abra el menú de navegación y haga clic en Recursos informáticos. En Recursos informáticos, haga clic en Instancias. Se muestra una lista de instancias en su compartimento actual. Busque la instancia que desea actualizar y haga clic en su nombre para ver la página de detalles.

  2. Haga clic en Etiquetas.

    Se muestra la lista de etiquetas aplicadas al recurso.

  3. Busque la etiqueta que desea actualizar y haga clic en el icono de lápiz ubicado junto a ella.
  4. Introduzca o seleccione un nuevo valor.
  5. Haga clic en Guardar.
Para eliminar de forma masiva las etiquetas definidas

Cómo eliminar varias etiquetas definidas de los recursos.

  1. Abra el menú de navegación y haga clic en Gobernanza y administración. En Gestión de arrendamiento, haga clic en Explorador del arrendamiento.

  2. Seleccione los recursos de los que desea eliminar etiquetas. También puede utilizar el menú desplegable Filtrar por tipo de recurso para acotar la lista de recursos.

  3. En el menú Acciones, haga clic en Gestionar etiquetas.

    Se abrirá la página Gestionar etiquetas. La primera tabla muestra las etiquetas aplicadas actualmente a los recursos seleccionados. La segunda tabla muestra los recursos seleccionados.

  4. En la lista de etiquetas, busque la etiqueta que desea eliminar. En Acción, seleccione Eliminar etiqueta de todos los recursos seleccionados.
  5. Para eliminar otra etiqueta, repita el paso anterior.

  6. Haga clic en Siguiente.

    Se abrirá una página de confirmación que muestra las acciones que se deben realizar y los recursos a los que se aplican las acciones.

  7. Haga clic en Enviar.

Se iniciará la página Solicitud de trabajo que muestra el estado de la solicitud de trabajo para eliminar etiquetas de los recursos.

Para eliminar una etiqueta de un único recurso

  1. Abra la consola, haga clic en el nombre del servicio y, a continuación, en el recurso que desea ver.

    Por ejemplo, para ver una instancia informática: abra el menú de navegación y haga clic en Recursos informáticos. En Recursos informáticos, haga clic en Instancias. Se muestra una lista de instancias en su compartimento actual. Busque la instancia para la que desea eliminar la etiqueta y haga clic en su nombre para ver la página de detalles.

  2. Haga clic en Etiquetas.

    Se muestra la lista de etiquetas aplicadas al recurso.

  3. Busque la etiqueta que desea eliminar y haga clic en el icono de lápiz ubicado junto a ella.
  4. Haga clic en Eliminar etiqueta.

Uso de la API

Para obtener más información sobre el uso de la API y la firma de solicitudes, consulte la documentación de la API de REST y Credenciales de seguridad. Para obtener información sobre los SDK, consulte Los SDK y la CLI.

  • Para aplicar una etiqueta a un recurso individual utilizando la API, utilice la operación create o update correspondiente del recurso.
  • BulkEditTags: agrega, actualiza y elimina varias definiciones de clave de etiqueta en los recursos seleccionados
  • ListBulkEditTagsResourceTypes: muestra los tipos de recursos que soportan la edición masiva de etiquetas