Gestionar etiquetas de recursos

Consola

Los pasos exactos pueden variar en función del tipo de recurso. Por ejemplo, los siguientes pasos asocian una etiqueta a una VM:

1. En la consola de Google Cloud , ve a la página Instancias de VM.

   Ir a instancias de VM

2. Selecciona el proyecto y haz clic en Continuar.

3. En la columna Nombre, haz clic en el nombre de la VM a la que quieras añadir etiquetas.

4. En la página de detalles de la instancia de VM, sigue estos pasos:

   1. Haz clic en Editar.
   2. En la sección Información básica, haga clic en Gestionar etiquetas y añada las etiquetas que quiera para la instancia.
   3. Haz clic en Guardar.

gcloud

Para obtener información sobre cómo usar estas marcas, consulta el artículo Asignar etiquetas a recursos de la documentación de Resource Manager.

Por ejemplo, el siguiente comando adjunta una etiqueta a una VM:

gcloud resource-manager tags bindings create \
    --location LOCATION_NAME \
    --tag-value=tagValues/TAGVALUE_ID \
    --parent=//compute.googleapis.com/projects/PROJECT_NUMBER/zones/ZONE/instances/VM_ID

Haz los cambios siguientes:

• LOCATION_NAME: la región que contiene el recurso de destino. En este ejemplo, la región de la instancia de máquina virtual.
• TAGVALUE_ID: el ID numérico del valor de la etiqueta.
• PROJECT_NUMBER: el ID numérico de tu proyecto que contiene el recurso de destino.
• ZONE: la zona que contiene el recurso de destino. En este ejemplo, la zona de la instancia de VM.
• VM_ID: el ID de la instancia de VM

REST

Para adjuntar una etiqueta a un recurso, primero debe crear una representación JSON de un enlace de etiqueta que incluya el ID permanente o el nombre del espacio de nombres del valor de la etiqueta y el ID permanente del recurso. Para obtener más información sobre el formato de un enlace de etiqueta, consulta la referencia de tagBindings.

Para asociar la etiqueta a un recurso zonal, como una instancia de VM, usa el método tagBindings.create con el endpoint regional en el que se encuentre el recurso. Por ejemplo:

POST https://LOCATION_NAME-cloudresourcemanager.googleapis.com/v3/tagBindings

El cuerpo de la solicitud puede ser una de las dos opciones siguientes:

{
  "parent": "//compute.googleapis.com/projects/PROJECT_NUMBER/zones/ZONE/instances/VM_ID",
  "tagValue": "tagValue/TAGVALUE_ID"
}

{
  "parent": "//compute.googleapis.com/projects/PROJECT_NUMBER/zones/ZONE/instances/VM_ID",
  "tagValueNamespacedName": TAGVALUE_NAMESPACED_NAME
}

Haz los cambios siguientes:

• LOCATION_NAME: la región que contiene el recurso de destino. En este ejemplo, la región de la instancia de VM.
• PROJECT_NUMBER: el ID numérico de tu proyecto que contiene el recurso de destino.
• ZONE: la zona que contiene el recurso de destino. En este ejemplo, la zona de la instancia de VM.
• VM_ID: el ID de la instancia de VM
• TAGVALUE_ID: el ID permanente del valor de la etiqueta que se ha adjuntado. Por ejemplo: 4567890123
• TAGVALUE_NAMESPACED_NAME: el nombre del espacio de nombres de la etiqueta valor que se adjunta y tiene el siguiente formato: parentNamespace/tagKeyShortName/tagValueShortName

Consola

Los pasos exactos pueden variar en función del tipo de recurso. Sigue estos pasos para una máquina virtual:

1. En la consola de Google Cloud , ve a la página Instancias de VM.

   Ir a instancias de VM

2. Selecciona el proyecto y haz clic en Continuar.

3. Haz clic en Crear instancia. Aparecerá la página Crear una instancia y se mostrará el panel Configuración de la máquina.

4. En el menú de navegación, haz clic en Opciones avanzadas. En el panel Avanzado que aparece, haz lo siguiente:

   1. Despliega la sección expand_moreGestionar etiquetas
   2. Haz clic en addAñadir etiquetas.
   3. En el panel Etiquetas que se abre, siga las instrucciones para añadir una etiqueta a la instancia.
   4. Haz clic en Guardar.

5. Especifica otras opciones de configuración para tu instancia. Para obtener más información, consulta Opciones de configuración durante la creación de instancias.

6. Para crear e iniciar la VM, haz clic en Crear.

gcloud

Para adjuntar una etiqueta a un recurso durante la creación del recurso, añade la marca --resource-manager-tags con el comando create correspondiente. Por ejemplo, para adjuntar una etiqueta a una máquina virtual, usa el siguiente comando:

  gcloud compute instances create INSTANCE_NAME \
      --zone=ZONE \
      --resource-manager-tags=tagKeys/TAGKEY_ID=tagValues/TAGVALUE_ID

Haz los cambios siguientes:

• INSTANCE_NAME: el nombre de tu instancia de VM
• ZONE: la zona que contiene la instancia de VM
• TAGKEY_ID: el ID numérico de la clave de la etiqueta
• TAGVALUE_ID: el ID numérico permanente del valor de la etiqueta que se ha adjuntado. Por ejemplo: 4567890123.

Para especificar varias etiquetas, sepáralas con comas. Por ejemplo, TAGKEY1=TAGVALUE1,TAGKEY2=TAGVALUE2.

REST

Envía una solicitud POST a la siguiente URL:

POST https://compute.googleapis.com/compute/v1/projects/PROJECT/zones/ZONE/instances

Incluye el siguiente cuerpo JSON de la solicitud:

{
  "name": INSTANCE_NAME,
  "params": {
    "resourceManagerTags": {
      "tagKeys/TAGKEY_ID": "tagValues/TAGVALUE_ID",
    },
  }
  // other fields omitted
}

Haz los cambios siguientes:

• INSTANCE_NAME: el nombre de tu instancia de VM
• TAGKEY_ID: el ID numérico de la clave de la etiqueta
• TAGVALUE_ID: el ID numérico permanente del valor de la etiqueta que se ha adjuntado. Por ejemplo: 4567890123.

Consola

Los pasos exactos pueden variar en función del tipo de recurso. Por ejemplo, sigue estos pasos para separar una etiqueta de una VM:

1. En la consola de Google Cloud , ve a la página Instancias de VM.

   Ir a instancias de VM

2. Selecciona el proyecto y haz clic en Continuar.

3. En la columna Nombre, haz clic en el nombre de la instancia de la que quieras quitar etiquetas.

4. En la página de detalles de la instancia de VM, sigue estos pasos:

   1. Haz clic en Editar.
   2. En el caso de las etiquetas del gestor de recursos, en la sección Información básica, haga clic en Gestionar etiquetas. Quita las etiquetas que quieras de la instancia. Solo puedes quitar las etiquetas que se hayan añadido directamente a la instancia.
   3. En el caso de las etiquetas de red, vaya a la sección Redes y quite la etiqueta de la lista Etiquetas de red.
   4. Haz clic en Guardar.

gcloud

Para desvincular una etiqueta de una instancia de computación, usa el comando resource-manager tags bindings delete:

gcloud resource-manager tags bindings delete \
    --location LOCATION_NAME \
    --tag-value=tagValues/TAGVALUE_ID \
    --parent //compute.googleapis.com/projects/PROJECT_NUMBER/zones/ZONE/instances/INSTANCE_ID

Haz los cambios siguientes:

• LOCATION_NAME: la zona del recurso de destino, como us-central1-a
• TAGVALUE_ID: el ID numérico de la clave de etiqueta
• PROJECT_NUMBER: el ID numérico de tu proyecto que contiene el recurso de destino.
• ZONE: el nombre de la zona, como us-central1-a
• INSTANCE_ID: ID numérico de la instancia de proceso

Para actualizar o sustituir un enlace de etiqueta por otro, desvincula el antiguo y vincula el nuevo.

REST

Para eliminar un enlace de etiqueta asociado a un recurso, como una instancia de computación, usa el método tagBindings.delete con el endpoint regional en el que se encuentre el recurso.

DELETE https://LOCATION-cloudresourcemanager.googleapis.com/v3/{name=TAGBINDINGS_NAME}

Haz los cambios siguientes:

• LOCATION: el endpoint regional de tu recurso. Por ejemplo, us-central1
• TAGBINDINGS_NAME: el ID permanente de TagBinding; por ejemplo: tagBindings/%2F%2Fcloudresourcemanager.googleapis.com%2Fprojects%2F1234567890/tagValues/567890123456

Consola

Los pasos exactos pueden variar en función del tipo de recurso. Por ejemplo, en los siguientes pasos se muestra cómo ver las etiquetas de una máquina virtual:

1. En la consola de Google Cloud , ve a la página Instancias de VM.

   Ir a instancias de VM

2. Selecciona el proyecto y haz clic en Continuar.

3. En la columna Nombre, haz clic en el nombre de la VM cuyas etiquetas quieras ver.

4. En la página de detalles de la instancia de VM, busca las etiquetas en la sección Etiquetas.

gcloud

Para obtener una lista de enlaces de etiquetas directamente asociados a un recurso, usa el comando gcloud resource-manager tags bindings list. Si añade la marca --effective, también se devolverá una lista de etiquetas heredadas por este recurso. Por ejemplo:

gcloud resource-manager tags bindings list \
    --location=LOCATION_NAME \
    --parent //compute.googleapis.com/projects/PROJECT_NUMBER/zones/ZONE/instances/VM_ID

Haz los cambios siguientes:

• LOCATION_NAME: la zona del recurso de destino, como us-central1-a
• PROJECT_NUMBER: el ID numérico de tu proyecto que contiene el recurso de destino
• ZONE: el nombre de la zona, como us-central1-a
• VM_ID: ID numérico de la instancia de VM

Si añade la marca --effective al comando tags bindings list, también se devolverá una lista de todas las etiquetas heredadas por este recurso.

El resultado debería ser similar al siguiente:

namespacedTagKey: 961309089256/environment
namespacedTagValue: 961309089256/environment/production
tagKey: tagKeys/417628178507
tagValue: tagValues/247197504380
inherited: true

Si todas las etiquetas evaluadas en un recurso están asociadas directamente, el campo inherited tiene el valor false y se omite.

REST

Para enumerar las vinculaciones de etiquetas asociadas a un recurso regional, como las instancias de Compute Engine, usa el método tagBindings.list con el endpoint regional en el que se encuentra el recurso. Por ejemplo:

GET https://LOCATION_NAME-cloudresourcemanager.googleapis.com/v3/tagBindings

{
    "parent": "//compute.googleapis.com/projects/PROJECT_NUMBER/zones/ZONE/instances/VM_ID"
}

Haz los cambios siguientes:

• LOCATION_NAME: la región del recurso de destino, como us-central1
• PROJECT_NUMBER: el ID numérico de tu proyecto que contiene el recurso de destino.
• ZONE: el nombre de la zona, como us-central1-a
• VM_ID: ID numérico de la instancia de VM