Organiza volúmenes de almacenamiento con etiquetas

Para organizar tus volúmenes de almacenamiento, puedes usar etiquetas. Las etiquetas son pares clave-valor que puedes adjuntar a cada volumen de almacenamiento y, luego, filtrar los volúmenes de almacenamiento según sus etiquetas. Por ejemplo, con las etiquetas puedes agrupar volúmenes de almacenamiento por propósito, entorno, ubicación, departamento, etcétera. Las etiquetas son opcionales.

Agrega o actualiza etiquetas para volúmenes de almacenamiento

Puedes agregar o actualizar etiquetas para los volúmenes de almacenamiento existentes.

Console

  1. Ve a la página Compute Engine > Solución Bare Metal > Volúmenes.

  2. Para el volumen de almacenamiento que deseas etiquetar, haz clic en .

  3. Haz clic en Editar etiquetas.

  4. En la página Editor de etiquetas , haz lo siguiente:

    1. Haz clic en Agregar etiqueta y agrega el par clave-valor.
    2. Para actualizar las etiquetas, selecciona las etiquetas existentes y modifica sus valores.
    3. Haz clic en Enviar.

  5. Después de regresar a la página Volúmenes, actualiza la página para ver los cambios.

gcloud

Para agregar o actualizar etiquetas para un volumen de almacenamiento, usa el comando gcloud bms volumes update con la opción --update-labels.

El siguiente comando de muestra agrega las etiquetas entorno = dev y ubicación = rama:

gcloud bms volumes update VOLUME_NAME --project=PROJECT_ID --region=REGION --update-labels environment=dev,location=branch

Si proporcionas un valor nuevo para una etiqueta que ya existe, el sistema actualiza la etiqueta existente con el valor nuevo. Si proporcionas una etiqueta nueva, el sistema la agrega a la lista de etiquetas.

API

Para agregar o actualizar etiquetas para un volumen de almacenamiento, ingresa el ID del proyecto, la región, el nombre del volumen y una lista de etiquetas en el siguiente comando curl. Copia el comando, pégalo en la ventana de Cloud Shell y presiona la tecla Intro o Intro.

El siguiente comando de muestra asigna una etiqueta de entorno = prueba.

curl -X PATCH \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "X-Goog-User-Project: PROJECT_ID" \
-H "Content-Type: application/json" \
"https://baremetalsolution.googleapis.com/v2/projects/PROJECT_ID/locations/REGION/volumes/VOLUME_NAME?updateMask=labels"
 -d "{
  'labels' : {'environment': 'test'}
}"

Quita etiquetas de volúmenes de almacenamiento

Puedes quitar etiquetas de los volúmenes de almacenamiento.

Console

  1. Ve a la página Compute Engine > Solución Bare Metal > Volúmenes.

  2. Para un volumen de almacenamiento con etiquetas que deseas quitar, haz clic en .

  3. Haz clic en Editar etiquetas.

  4. En la página Editor de etiquetas , haz lo siguiente:

    1. Para borrar una etiqueta, haz clic en .
    2. Haz clic en Enviar.

  5. Después de regresar a la página Volúmenes, actualiza la página para ver los cambios.

gcloud

Para quitar etiquetas de un volumen de almacenamiento, usa el comando gcloud bms volumes update con las siguientes opciones:

  • --remove-labels: Quita la etiqueta especificada.
  • --clear-labels: Quita todas las etiquetas.

El siguiente comando de muestra quita la etiqueta departamento de un volumen de almacenamiento:

gcloud bms volumes update VOLUME_NAME --project=PROJECT_ID --region=REGION --remove-labels=department

El siguiente comando de muestra quita todas las etiquetas de un volumen de almacenamiento:

gcloud bms volumes update VOLUME_NAME --project=PROJECT_ID --region=REGION --clear-labels

API

Para quitar etiquetas de un volumen de almacenamiento, ingresa el ID del proyecto, la región y el nombre del volumen de almacenamiento en el siguiente comando curl. Proporciona una lista de etiquetas vacía para quitar todas las etiquetas, o brinda una lista de las etiquetas que deseas conservar (omite las etiquetas que deseas quitar). Copia el comando, pégalo en la ventana de Cloud Shell y presiona la tecla Intro o Intro.

El siguiente comando de muestra quita todas las etiquetas, excepto entorno = prueba.

curl -X PATCH \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "X-Goog-User-Project: PROJECT_ID" \
-H "Content-Type: application/json" \
"https://baremetalsolution.googleapis.com/v2/projects/PROJECT_ID/locations/REGION/volumes/VOLUME_NAME?updateMask=labels"
 -d "{
  'labels' : {'environment': 'test'}
}"

Filtra volúmenes de almacenamiento con etiquetas

Puedes buscar tus volúmenes de almacenamiento y filtrar los resultados con etiquetas.

Console

  1. Ve a la página Compute Engine > Solución Bare Metal > Volúmenes.

  2. Haz clic en la Filtrar barra que se encuentra sobre la lista de volúmenes de almacenamiento.

  3. En la lista Propiedades, selecciona Etiquetas.

  4. Ingresa la clave, el valor o el par clave-valor de tu etiqueta.

    Por ejemplo, para ver solo los volúmenes de almacenamiento con la etiqueta env:dev, puedes ingresar cualquiera de los siguientes elementos:

    • Ingresa la clave: env
    • Ingresa el valor: dev
    • Ingresa el par clave-valor: env:dev

  5. Para aplicar el filtro de etiquetas, haz clic en cualquier lugar fuera de la barra de filtros.

gcloud

Para filtrar volúmenes de almacenamiento con etiquetas, usa el comando gcloud bms volumes list con la opción --filter.

El valor de la opción --filter debe tener el labels.KEY=VALUE formato. Por ejemplo, si deseas usar una etiqueta con env como clave y dev como valor para el filtrado, ejecuta este comando:

gcloud bms volumes list --project=PROJECT_ID --region=REGION --filter labels.environment=dev

Para obtener más información sobre la sintaxis de filtro en gcloud CLI, consulta la gcloud topic filters documentación.

API

Para filtrar volúmenes de almacenamiento con etiquetas, ingresa el ID del proyecto y la región junto con filter=labels y una etiqueta de par clave-valor. Copia el comando, pégalo en la ventana de Cloud Shell y presiona la tecla Intro o Intro.

En el siguiente ejemplo, se limita el resultado para encontrar volúmenes de almacenamiento con la etiqueta de par clave-valor entorno = prueba.

curl -X GET \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "X-Goog-User-Project: PROJECT_ID" \
-H "Content-Type: application/json" \
"https://baremetalsolution.googleapis.com/v2/projects/PROJECT_ID/locations/REGION/volumes"?filter=labels.environment=test