Definir y eliminar metadatos personalizados

Consola

1. En la Google Cloud consola, ve a la página Metadatos.

   Ir a la página Metadatos personalizados

2. En la parte superior de la página, haz clic en edit Editar.

3. Para añadir nuevas entradas de metadatos de proyectos personalizados, haga lo siguiente:

   1. Desplázate hasta la parte inferior de la página y haz clic en add_box Añadir elemento.
   2. En el campo Clave, introduce el nombre de tu clave de metadatos personalizada.
   3. En el campo Valor, introduzca el valor de los metadatos del proyecto personalizado.
   4. Opcional. Para añadir más entradas de metadatos de proyecto personalizados, repite los pasos anteriores por cada entrada de metadatos que quieras añadir.
   5. Para terminar de añadir las entradas de metadatos de proyecto personalizados, haz clic en Guardar.

4. Para editar las entradas de metadatos de proyectos personalizados, siga estos pasos:

   1. Desplázate hasta la entrada de metadatos que quieras editar.
   2. Para actualizar el nombre de una clave de metadatos personalizada específica, en el campo Clave de esa entrada, introduzca el nuevo nombre.
   3. Para actualizar el valor de una entrada de metadatos de proyecto personalizada, en el campo Valor de esa entrada, introduzca el nuevo valor.
   4. Opcional. Para eliminar una entrada de metadatos de proyecto personalizada específica, haz clic en el delete icono de eliminar situado junto a la entrada de metadatos.
   5. Para editar varias entradas de metadatos de proyectos personalizados, repite los pasos anteriores con cada entrada de metadatos que quieras editar.
   6. Para terminar de editar las entradas de metadatos del proyecto personalizado, haz clic en Guardar.

gcloud

Usa el comando project-info add-metadata.

gcloud compute project-info add-metadata \
    --metadata=KEY=VALUE

Haz los cambios siguientes:

• KEY: el nombre de la clave de metadatos
• VALUE: el valor almacenado para esta clave

Ejemplo

Por ejemplo, para definir dos entradas nuevas, foo=bar y baz=bat, en un proyecto, ejecuta el siguiente comando:

gcloud compute project-info add-metadata \
    --metadata=foo=bar,baz=bat

También puedes especificar uno o varios archivos de los que leer los metadatos mediante la marca --metadata-from-file.

REST

1. Opcional. Para realizar un bloqueo optimista, puedes proporcionar una huella digital.

   Una huella digital es una cadena aleatoria de caracteres generada por Compute Engine. La huella digital cambia después de cada solicitud y, si proporcionas una huella digital que no coincide, se rechazará tu solicitud.

   Si no proporcionas una huella digital, no se realizará ninguna comprobación de coherencia y la solicitud projects().setCommonInstanceMetadata se completará correctamente. Este comportamiento es diferente de los métodos instances().setMetadata y instanceSettings().patch, en los que siempre se requiere una huella digital.

   Para obtener la huella digital actual de un proyecto, llama al método project().get.

   GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID
   

   El resultado debería ser similar al siguiente:

   {
     "name": "myproject",
     "commonInstanceMetadata": {
       "kind": "compute#metadata",
       "fingerprint": "FikclA7UBC0=",
       ...
     }
   }
   

2. Haz una solicitud al método projects().setCommonInstanceMetadata y define tus pares clave-valor de metadatos personalizados:

   POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/setCommonInstanceMetadata
   
   {
     "fingerprint": "FikclA7UBC0=",
     "items": [
       {
       "key": "foo",
       "value": "bar"
       }
     ]
   }
   

Sustituye PROJECT_ID por el ID de tu proyecto.

gcloud

• Para añadir o actualizar metadatos zonales personalizados, usa el comando gcloud compute project-zonal-metadata add.

  gcloud compute project-zonal-metadata add \
    --zone=ZONE \
    --project=PROJECT_ID  \
    --metadata=KEY1=VALUE1,KEY2=VALUE2,...

  Haz los cambios siguientes:

  • PROJECT_ID: tu ID de proyecto
  • ZONE: la zona en la que quieras añadir o actualizar los metadatos zonales.
  • KEY1, KEY2...: las claves de metadatos personalizadas para las que quiere añadir o actualizar valores de metadatos zonales.

  • VALUE1, VALUE2...: los valores de metadatos zonales que quieras definir para tus claves de metadatos personalizadas nuevas y actuales. En función de la clave y el valor de los metadatos personalizados, ocurrirá una de las siguientes acciones:

  • Si la clave de metadatos personalizada correspondiente es una clave que ya tiene metadatos del proyecto, en la zona especificada, Compute Engine sustituye el valor de los metadatos del proyecto de la clave por el valor de los metadatos zonales que hayas especificado. Todas las VMs de la zona especificada del proyecto heredarán los metadatos zonales recién especificados para esa clave, mientras que las VMs de otras zonas seguirán conservando los valores de los metadatos zonales o del proyecto que tuvieran. Si actualizas el valor de los metadatos del proyecto de esta clave, las VMs de esta zona del proyecto no se verán afectadas y seguirán usando el valor de los metadatos zonales de esta clave.

  • Si la clave de metadatos personalizada correspondiente es una clave de metadatos nueva que no se usa en los metadatos de proyecto o zonales, Compute Engine crea la clave de metadatos personalizada y define este valor como los metadatos zonales de la zona especificada.

  • Si la clave de metadatos personalizada correspondiente es una clave de metadatos que ya existe y tiene un valor de metadatos zonales en la zona especificada:

    • Si el valor de metadatos especificado es diferente del valor actual, Compute Engine actualiza la entrada de metadatos zonales con el nuevo valor.
    • Si el valor de metadatos especificado es el mismo que el valor actual, la entrada de metadatos zonales no cambia.

Ejemplo: Añadir una nueva entrada de metadatos zonales personalizados

Por ejemplo, supongamos que tienes un proyecto llamado my-project con los siguientes metadatos personalizados:

• Metadatos del proyecto: "key-1":"value-a", "key-2":"value-b" y "key-3":"value-c"
• Metadatos zonales de la zona us-central1-a: "key-1":"value-1" y "key-2":"value-2"

Para añadir "key-4":"value-4" como un nuevo par de metadatos zonales personalizados en la zona us-central1-a, ejecuta el siguiente comando:

gcloud compute project-zonal-metadata add \
    --metadata=key-4=value-4 \
    --project=my-project \
    --zone=us-central1-a

Ejemplo: Actualizar los valores de una entrada de metadatos zonales personalizada

Consideremos el mismo proyecto de ejemplo my-project, que ahora tiene los siguientes metadatos personalizados:

• Metadatos del proyecto: "key-1":"value-a", "key-2":"value-b" y "key-3":"value-c"
• Metadatos zonales de la zona us-central1-a: "key-1":"value-1", "key-2":"value-2" y "key-4":"value-4"

Para actualizar los valores de metadatos zonales de key-1 y key-4 en la zona us-cerntral1-a con valores nuevos, ejecuta el siguiente comando.

gcloud compute project-zonal-metadata add \
    --metadata=key-1=new-value-1,key-4=new-value-4 \
    --project=my-project \
    --zone=us-central1-a

Ejemplo: Anular el valor de metadatos del proyecto de una clave y usar un valor de metadatos zonales

Consideremos el mismo proyecto de ejemplo my-project, que ahora tiene los siguientes metadatos personalizados:

• Metadatos del proyecto: "key-1":"value-a", "key-2":"value-b" y "key-3":"value-c"
• Metadatos zonales de la zona us-central1-a: "key-1":"new-value-1", "key-2":"value-2" y "key-4":"new-value-4"

En este proyecto de ejemplo, considera key-3, que tiene un valor de metadatos de proyecto de value-c. Supongamos que quieres definir un valor de metadatos zonales value-3 para esta clave en todas las VMs de la zona us-central1-a. Cuando realices la operación, en todas las VMs de la zona us-central1-a, Compute Engine anulará los valores de los metadatos del proyecto y usará los valores de los metadatos zonales. Las máquinas virtuales de las demás zonas del proyecto conservan los valores de metadatos de proyecto o de zona vigentes para key-3.

Para anular el valor de metadatos del proyecto de key-3 y definir un valor de metadatos zonales, ejecuta el siguiente comando:

gcloud compute project-zonal-metadata add \
    --metadata=key-3=value-3 \
    --project=my-project \
    --zone=us-central1-a

REST

1. Obtén la huella digital actual y consulta los pares clave-valor del proyecto en esa zona.

   Para realizar un bloqueo optimista, debes proporcionar una huella digital. Una huella digital es una cadena aleatoria de caracteres generada por Compute Engine. La huella digital cambia cada vez que haces una solicitud para añadir, actualizar o eliminar metadatos zonales. Si proporcionas una huella digital que no coincide, Compute Engine rechazará tu solicitud.

   Si no proporcionas una huella digital, se realizará una comprobación de coherencia y tu solicitud de actualización no se completará. De esta forma, solo se puede hacer una solicitud a la vez, lo que evita colisiones. Este comportamiento coincide con instances().setMetadata, donde siempre se requiere una huella digital.

   Para obtener la huella digital actual de los metadatos zonales, haz una solicitud GET al método instanceSettings().get.

   GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instanceSettings
   

   Haz los cambios siguientes:

   • PROJECT_ID: tu ID de proyecto
   • ZONE: la zona en la que quieres definir los metadatos zonales.

   A continuación se muestra un ejemplo de resultado de esta solicitud:

       {
         "fingerprint": "VlRIl8dx9vk=",
         "metadata": {
           ...
         }
       }
   

2. Para añadir o actualizar los metadatos zonales, haz una solicitud PATCH al método instanceSettings().patch. Debes proporcionar lo siguiente con tu solicitud:

   • Una máscara de actualización. Usa el parámetro de consulta update_mask. La máscara de actualización debe contener las claves de metadatos de lo siguiente:

     • Los nuevos metadatos zonales personalizados que quieras añadir
     • Los metadatos zonales personalizados cuyos valores quieres actualizar

     Debes añadir la cadena metadata.items. como prefijo de cada clave. Por ejemplo, metadata.items.key1,metadata.items.key3.

   • En el cuerpo de la solicitud, proporciona lo siguiente:

     • Las claves y los valores de metadatos de la nueva zona personalizada que quieras añadir
     • Las claves y los valores de metadatos de zona personalizados que quiere actualizar
     • El valor de huella digital actual

   PATCH https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instanceSettings?update_mask=PREFIXED_METADATA_KEYS
   {
     "fingerprint": "FINGER_PRINT",
     "metadata": {
       "items": {
         "KEY1": "VALUE1",
         "KEY2": "VALUE2",
         ...
       }
     }
   }
   

   Haz los cambios siguientes:

   • PROJECT_ID: el ID del proyecto.
   • ZONE: la zona en la que quieres definir los metadatos zonales.

   • PREFIXED_METADATA_KEYS: la lista de claves de metadatos de lo siguiente, donde cada clave tiene el prefijo de la cadena metadata.items. :

     • Los nuevos metadatos zonales personalizados que quieras añadir
     • Los metadatos zonales personalizados que ya existen y cuyos valores quieres actualizar.

     Por ejemplo, supongamos que las claves de metadatos zonales actuales de una zona específica son key-1 y key-2. Si quiere añadir una clave nueva, key-3, para los metadatos zonales de esa zona y también actualizar los metadatos zonales de una de las claves, key-1, su máscara de actualización debe tener la siguiente cadena:

     metadata.items.key1,metadata.items.key3

   • FINGER_PRINT: el valor actual de la huella digital.

   • KEY1, KEY2...: las claves de metadatos zonales personalizadas a las que quieras añadir o actualizar valores. Especifica todas las claves de metadatos zonales personalizadas que hayas especificado en la máscara de actualización.

   • VALUE1, VALUE2...: los valores de metadatos zonales que quieras definir para tus claves de metadatos personalizadas nuevas y actuales. En función de la clave y el valor de los metadatos personalizados, ocurrirá una de las siguientes acciones:

     • Si la clave de metadatos personalizada correspondiente es una clave que ya tiene metadatos del proyecto, en la zona especificada, Compute Engine sustituye el valor de los metadatos del proyecto de la clave por el valor de los metadatos zonales que hayas especificado. Todas las VMs de la zona especificada del proyecto heredarán los metadatos zonales recién especificados para esa clave, mientras que las VMs de otras zonas seguirán conservando los valores de los metadatos zonales o del proyecto que tuvieran. Si actualizas el valor de los metadatos del proyecto de esta clave, las VMs de esta zona del proyecto no se verán afectadas y seguirán usando el valor de los metadatos zonales de esta clave.
     • Si la clave de metadatos personalizada correspondiente es una clave de metadatos nueva que no se usa en los metadatos de proyecto o zonales, Compute Engine crea la clave de metadatos personalizada y establece este valor como metadatos zonales en la zona especificada.

     • Si la clave de metadatos personalizada correspondiente es una clave de metadatos que ya existe y tiene un valor de metadatos zonales en la zona especificada:

     • Si el valor de metadatos especificado es diferente del valor actual, Compute Engine actualiza la entrada de metadatos zonales con el nuevo valor.

     • Si el valor de metadatos especificado es el mismo que el valor actual, la entrada de metadatos zonales no cambia.

Ejemplo: Añadir una nueva entrada de metadatos zonales personalizados

Por ejemplo, supongamos que tienes un proyecto llamado my-project con los siguientes metadatos personalizados:

• Metadatos del proyecto: "key-1":"value-a", "key-2":"value-b" y "key-3":"value-c"
• Metadatos zonales de la zona us-central1-a: "key-1":"value-1" y "key-2":"value-2"

Para añadir "key-4":"value-4" como un nuevo par de metadatos zonales personalizados en la zona us-central1-a, haz la siguiente solicitud PATCH:

PATCH https://compute.googleapis.com/compute/v1/projects/my-project/zones/us-central1-a/instanceSettings?update_mask=metadata.items.key-4
{
  "fingerprint": "VlRIl8dx9vk=",
  "metadata": {
  "items": {
    "key-4": "value-4"
    }
  }
}

Ejemplo: Actualizar los valores de una entrada de metadatos zonales personalizada

Consideremos el mismo proyecto de ejemplo my-project, que ahora tiene los siguientes metadatos personalizados:

• Metadatos del proyecto: "key-1":"value-a", "key-2":"value-b" y "key-3":"value-c"
• Metadatos zonales de la zona us-central1-a: "key-1":"value-1", "key-2":"value-2" y "key-4":"value-4"

Para actualizar los valores de metadatos zonales de key-1 y key-4 en la zona us-cerntral1-a con nuevos valores, haz la siguiente solicitud PATCH:

PATCH https://compute.googleapis.com/compute/v1/projects/my-project/zones/us-central1-a/instanceSettings?update_mask=metadata.items.key-1,metadata.items.key-4
{
  "fingerprint": "VlRIl8dx9vk=",
  "metadata": {
  "items": {
    "key-1": "new-value-1",
    "key-4": "new-value-4"
    }
  }
}

Ejemplo: Anular el valor de metadatos del proyecto de una clave y definir un valor de metadatos zonales

Consideremos el mismo proyecto de ejemplo my-project, que ahora tiene los siguientes metadatos personalizados:

• Metadatos del proyecto: "key-1":"value-a", "key-2":"value-b" y "key-3":"value-c"
• Metadatos zonales de la zona us-central1-a: "key-1":"new-value-1", "key-2":"value-2" y "key-4":"new-value-4"

En este proyecto de ejemplo, considera key-3, que tiene un valor de metadatos de proyecto de value-c. Supongamos que quieres definir un valor de metadatos zonales value-3 para esta clave en todas las VMs de la zona us-central1-a. Cuando realices la operación, en todas las VMs de la zona us-central1-a, Compute Engine anulará los valores de los metadatos del proyecto y usará los valores de los metadatos zonales. Las máquinas virtuales de las demás zonas del proyecto conservan los valores de metadatos de proyecto o de zona vigentes para key-3.

Para anular el valor de los metadatos del proyecto de key-3 y usar el valor de los metadatos zonales value-3, haz la siguiente solicitud PATCH:

PATCH https://compute.googleapis.com/compute/v1/projects/my-project/zones/us-central1-a/instanceSettings?update_mask=metadata.items.key-3
{
  "fingerprint": "VlRIl8dx9vk=",
  "metadata": {
  "items": {
    "key-3": "value-3"
    }
  }
}

Consola

1. En la Google Cloud consola, ve a la página Crear una instancia.

   Ir a Crear una instancia

2. Especifica los detalles de la VM.

3. Despliega la sección Opciones avanzadas y haz lo siguiente:

   1. Despliega la sección Gestión.
   2. Para añadir varios pares clave-valor a los metadatos personalizados, en la sección Metadatos, haga clic en Añadir elemento.

4. Para crear la VM, haz clic en Crear.

gcloud

Para definir metadatos personalizados, utilice el comando gcloud compute instances create con la marca --metadata.

gcloud compute instances create VM_NAME \
--zone=ZONE \
--image-project=IMAGE_PROJECT \
IMAGE_FLAG \
--metadata=KEY=VALUE

Haz los cambios siguientes:

• VM_NAME: el nombre de tu VM
• ZONE: la zona en la que se creará la VM
• IMAGE_PROJECT: el proyecto que contiene la imagen que se va a usar en la VM

• IMAGE_FLAG: especifica una de las siguientes opciones:

  • Usa la marca --image IMAGE_NAME para especificar una versión concreta de una imagen pública.

    Por ejemplo, --image debian-12-bookworm-v20241112.

  • Usa la marca --image-family IMAGE_FAMILY_NAME para especificar una familia de imágenes.

    De esta forma, se crea la VM a partir de la imagen de SO no obsoleta más reciente de la familia de imágenes. Por ejemplo, si especificas --image-family debian-12, Compute Engine usa la versión más reciente de la imagen del SO en la familia de imágenes de Debian 12.

• KEY: el nombre de la clave de metadatos

• VALUE: el valor almacenado para esta clave

Ejemplo

Por ejemplo, para definir una nueva clave env que tenga el valor test en una máquina virtual llamada example-instance, ejecuta el siguiente comando:

 gcloud compute instances create example-instance \
   --zone=us-central1-a --image-project=debian-cloud \
   --image-family=debian-12 \
   --metadata=env=test

REST

Usa el método instances.insert y proporciona los metadatos personalizados como parte de la propiedad metadata de tu solicitud:

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

{
  "machineType": "zones/MACHINE_TYPE_ZONE/machineTypes/MACHINE_TYPE",
  "name": "VM_NAME",
  "...": [
    {
    }
    ],
  "metadata": {
    "items": [
      {
        "key": "KEY",
        "value": "VALUE"
      }
    ]
  },
  ..
}

Haz los cambios siguientes:

• PROJECT_ID: tu ID de proyecto
• ZONE: zona en la que se creará la VM
• MACHINE_TYPE: tipo de máquina, predefinido o personalizado, para la nueva VM.
• VM_NAME: nombre de la nueva máquina virtual
• KEY: el nombre de la clave de metadatos
• VALUE: el valor almacenado para esta clave

Consola

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

   Ve a la página Instancias de VM.

2. Haga clic en la instancia de la que quiera actualizar los metadatos.
3. Haz clic en el botón Editar que se encuentra en la parte superior de la página.
4. En Metadatos personalizados, haga clic en Añadir elemento o edite las entradas de metadatos que ya haya.
5. Guarda los cambios.

gcloud

Actualizar los metadatos de una VM con la CLI de gcloud es una acción acumulativa. Especifique solo las claves de metadatos que quiera añadir o cambiar. Si ya existe una clave que has proporcionado, el valor de esa clave se actualizará con el nuevo valor.

Usa el comando instances add-metadata:

gcloud compute instances add-metadata VM_NAME \
    --metadata=KEY=VALUE,KEY=VALUE

Haz los cambios siguientes:

• VM_NAME: el nombre de tu VM
• KEY: el nombre de la clave de metadatos
• VALUE: el valor almacenado para esta clave

Ejemplos

Si quieres añadir la entrada foo=bar, usa:

gcloud compute instances add-metadata VM_NAME \
    --metadata=foo=bar

Si quieres cambiar la entrada foo=bar por foo=bat, usa lo siguiente:

gcloud compute instances add-metadata VM_NAME \
    --metadata=foo=bat

REST

1. Obtiene la huella digital actual y ve los pares clave-valor de la VM. Para ello, llama al método instances().get.

   Una huella digital es una cadena aleatoria de caracteres generada por Compute Engine que se usa para realizar un bloqueo optimista. Para actualizar la máquina virtual, debes proporcionar el valor de huella digital correspondiente. La huella digital cambia después de cada solicitud y, si proporcionas una huella digital que no coincide, tu solicitud se rechazará. De esta forma, solo se puede hacer una actualización a la vez, lo que evita colisiones.

   GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instances/VM_NAME
   

   Haz los cambios siguientes:

   • PROJECT_ID: tu ID de proyecto
   • ZONE: la zona en la que se encuentra tu VM
   • VM_NAME: nombre de tu VM

   El resultado debería ser similar al siguiente:

   {
     ...
     "name": "example-instance",
     "metadata": {
       "kind": "compute#metadata",
       "fingerprint": "zhma6O1w2l8="
       "items": [
         {
           "key": "foo",
           "value": "bar"
         }
       ]
       },
     ...
   }
   

2. Realiza una solicitud al método instances().setMetadata. Proporciona una lista de los nuevos valores de metadatos y el valor de fingerprint actual.

   Si la VM tiene pares clave-valor que quiere conservar, debe incluirlos en esta solicitud junto con los nuevos pares clave-valor.

   Ejemplo

   POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instances/VM_NAME/setMetadata
   
   {
   "fingerprint": "zhma6O1w2l8=",
   "items": [
     {
       "key": "foo",
       "value": "bar"
     },
     {
       "key": "baz",
       "value": "bat"
     }
   ]
   }
   

   Haz los cambios siguientes:

   • PROJECT_ID: tu ID de proyecto
   • ZONE: la zona en la que se encuentra tu VM
   • VM_NAME: nombre de tu VM

Consola

1. En la Google Cloud consola, ve a la página Metadatos.

   Ir a la página Metadatos

2. En la parte superior de la página, haz clic en edit Editar.

3. Desplázate hasta la entrada de metadatos que quieras quitar y haz clic en el botón de eliminación delete situado junto a esa entrada.

   Repite este paso con cada entrada de metadatos que quieras quitar.

4. Para terminar de quitar las entradas de metadatos del proyecto personalizado, haz clic en Guardar.

gcloud

Para quitar metadatos de proyecto personalizados, usa el comando gcloud compute project-info remove-metadata.

• Si quiere quitar las entradas de metadatos personalizados de claves específicas, especifique esas claves con la marca --keys y excluya los valores de esas claves.

gcloud compute project-info remove-metadata \
    --keys=KEY1,KEY2,...

• Si quieres quitar todos los metadatos personalizados de la VM, especifica la marca --all.

gcloud compute project-info remove-metadata \
    --all

Haz los cambios siguientes:

• KEY1, KEY2...: las claves de metadatos de instancia personalizadas que quieras quitar.

gcloud

Para quitar metadatos zonales personalizados, usa el comando gcloud compute project-zonal-metadata remove y especifica todas las claves de metadatos que quieras quitar con la marca --keys.

gcloud compute project-zonal-metadata remove \
    --project=PROJECT_ID  \
    --zone=ZONE \
    --keys=KEY1,KEY2,...

Haz los cambios siguientes:

• PROJECT_ID: tu ID de proyecto
• ZONE: la zona de la que quieres quitar los metadatos zonales.
• KEY1, KEY2...: las claves de metadatos zonales personalizados que quieras quitar.

Después de ejecutar el comando, si alguna de las claves especificadas tiene valores de metadatos del proyecto disponibles, las VMs de la zona especificada heredarán esos valores de metadatos del proyecto. Si la entrada de metadatos se ha definido solo a nivel de zona y no hay ningún valor de metadatos de proyecto correspondiente a esa clave, las VMs de esa zona perderán esa información de metadatos.

Ejemplo:

Supongamos que tienes un proyecto de ejemplo my-project con los siguientes metadatos de proyecto personalizados:

• Metadatos del proyecto: "key-1":"value-a", "key-2":"value-b" y "key-3":"value-c"
• Metadatos zonales de la zona us-central1-a: "key-1":"new-value-1", "key-2":"value-2", "key-3":"value-3" y "key-4":"new-value-4"

Para eliminar todos los metadatos zonales de la zona us-central1-a, ejecuta el siguiente comando.

gcloud compute project-zonal-metadata remove \
    --metadata=key-1,key-2,key-3,key-4 \
    --project=my-project \
    --zone=us-central1-a

Después de ejecutar el comando, las VMs de la zona us-central1-a tendrán las siguientes entradas de metadatos de proyecto personalizados:

• "key-1":"value-a"
• "key-2":"value-b"
• "key-3":"value-c"

REST

1. Obtén la huella digital actual y consulta los pares clave-valor del proyecto en esa zona.

   Para realizar un bloqueo optimista, debes proporcionar una huella digital. Una huella digital es una cadena aleatoria de caracteres generada por Compute Engine. La huella digital cambia cada vez que haces una solicitud para añadir, actualizar o eliminar metadatos zonales. Si proporcionas una huella digital que no coincide, Compute Engine rechazará tu solicitud.

   Si no proporcionas una huella digital, se realizará una comprobación de coherencia y tu solicitud de eliminación no se completará. De esta forma, solo se puede hacer una solicitud a la vez, lo que evita colisiones. Este comportamiento coincide con instances().setMetadata, donde siempre se requiere una huella digital.

   Para obtener la huella digital actual de un proyecto, llama al método instanceSettings().get.

   GET https://compute.googleapis.com/compute/beta/projects/PROJECT_ID/zones/ZONE/instanceSettings
   

   Haz los cambios siguientes:

   • PROJECT_ID: tu ID de proyecto
   • ZONE: la zona de la que quieres quitar los metadatos zonales.

   A continuación se muestra un ejemplo de resultado de esta solicitud:

       {
         "fingerprint": "FikclA7UBC0=",
         "metadata": {
           ...
         }
       }
   

2. Para quitar metadatos zonales personalizados, haz una solicitud PATCH al método instanceSettings().patch excluyendo del cuerpo de la solicitud las claves de metadatos de las que quieras quitar los metadatos zonales. Debes proporcionar la siguiente información con tu solicitud:

   • Una máscara de actualización. Usa el parámetro de consulta update_mask. La máscara de actualización debe contener todas las claves de metadatos personalizados que quieras eliminar de los metadatos zonales. Debe añadir la cadena metadata.items. como prefijo de cada clave; por ejemplo, metadata.items.key1,metadata.items.key3.

   • En el cuerpo de la solicitud, proporcione solo el valor de la huella digital actual. Excluye todas las claves de metadatos personalizados que hayas especificado en updateMask. Si incluye alguna de las claves de metadatos tanto en la máscara de actualización como en el cuerpo de la solicitud, Compute Engine no eliminará los metadatos zonales de esas claves.

   PATCH https://compute.googleapis.com/compute/beta/projects/PROJECT_ID/zones/ZONE/instanceSettings?update_mask=PREFIXED_METADATA_KEYS
   {
     "fingerprint": "FINGER_PRINT",
     "metadata": {
       "items": {
       }
     }
   }
   

   Haz los cambios siguientes:

   • PROJECT_ID: el ID del proyecto.
   • ZONE: la zona de la que quieres quitar los metadatos zonales.

   • PREFIXED_METADATA_KEYS: lista de todas las claves de metadatos personalizados que ya existen y de las que quieres quitar los metadatos zonales. Cada clave debe ir precedida de la cadena metadata.items. . Para que tu solicitud de eliminación se complete correctamente, excluye estas claves de metadatos del cuerpo de la solicitud. Si incluye alguna de las claves de metadatos tanto en la máscara de actualización como en el cuerpo de la solicitud, Compute Engine no eliminará los metadatos zonales de esas claves.

     Por ejemplo, supongamos que las claves de metadatos actuales con metadatos zonales son key-1, key-2, key-3 y key-4, y que quiere quitar las entradas de metadatos zonales de key-1 y key-2. En ese caso, la máscara de actualización debe tener la siguiente cadena:

     metadata.items.key1,metadata.items.key2

   • FINGER_PRINT: el valor actual de la huella digital.

Después de hacer la solicitud, si alguna de las claves especificadas tiene valores de metadatos del proyecto disponibles, las VMs de la zona especificada heredarán esos valores de metadatos del proyecto. Si la clave de metadatos se ha definido solo a nivel de zona y no hay ningún valor de metadatos de proyecto correspondiente a esa clave, las VMs de esa zona perderán esa información de metadatos.

Ejemplo:

Supongamos que tienes un proyecto de ejemplo my-project con los siguientes metadatos de proyecto personalizados:

• Metadatos del proyecto: "key-1":"value-a", "key-2":"value-b" y "key-3":"value-c"
• Metadatos zonales de la zona us-central1-a: "key-1":"new-value-1", "key-2":"value-2", "key-3":"value-3" y "key-4":"new-value-4"

Para quitar los metadatos zonales de key-1 y key-2 en la zona us-central1-a, haz la siguiente solicitud PATCH.

PATCH https://compute.googleapis.com/compute/beta/projects/my-project/zones/us-central1-a/instanceSettings?update_mask=metadata.items.key-1,metadata.items.key-2
{
  "fingerprint": "FikclA7UBC0=",
  "metadata": {
  "items": {
    }
  }
}

Una vez que se haya procesado esta solicitud, las VMs de la zona us-central1-a tendrán los siguientes metadatos personalizados. Las VMs heredan los valores de los metadatos del proyecto de key-1 y key-2, pero conservan los metadatos zonales de key-3 y key-4.

• Metadatos del proyecto: "key-1":"value-a" y "key-2":"value-b"
• Metadatos zonales de la zona us-central1-a: "key-3":"value-3" y "key-4":"new-value-4"

Consola

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

   Ve a la página Instancias de VM.

2. En la columna Nombre, haga clic en el nombre de la VM de la que quiera quitar metadatos.
3. En la parte superior de la página, haz clic en edit Editar.
4. En la sección Metadatos, haz clic en delete Eliminar elemento en cada una de las entradas de metadatos que quieras quitar.
5. Para confirmar los cambios y quitar los metadatos de instancia personalizados, haga clic en Guardar.

gcloud

Para quitar metadatos de instancia personalizados, usa el comando gcloud compute instances remove-metadata.

• Si quiere quitar las entradas de metadatos personalizados de claves específicas, especifique esas claves con la marca --keys y excluya los valores de esas claves.

gcloud compute instances remove-metadata VM_NAME \
    --zone=ZONE  \
    --keys=KEY1,KEY2,...

• Si quieres quitar todos los metadatos personalizados de la VM, especifica la marca --all.

gcloud compute instances remove-metadata VM_NAME \
    --zone=ZONE  \
    --all

Haz los cambios siguientes:

• PROJECT_ID: tu ID de proyecto.
• ZONE: la zona de tu VM.
• VM_NAME: nombre de tu VM
• KEY1, KEY2...: las claves de metadatos de instancia personalizadas que quieras quitar.

REST

1. Obtiene la huella digital actual y ve los pares clave-valor de la VM. Para ello, llama al método instances().get.

   Una huella digital es una cadena aleatoria de caracteres generada por Compute Engine que se usa para realizar un bloqueo optimista. Para actualizar la máquina virtual, debes proporcionar el valor de huella digital correspondiente. La huella digital cambia después de cada solicitud y, si proporcionas una huella digital que no coincide, tu solicitud se rechazará. De esta forma, solo se puede hacer una actualización a la vez, lo que evita colisiones.

   GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instances/VM_NAME
   

   Haz los cambios siguientes:

   • PROJECT_ID: tu ID de proyecto.
   • ZONE: la zona de tu VM.
   • VM_NAME: nombre de tu VM

   El resultado debería ser similar al siguiente:

   {
     ...
     "name": "example-instance",
     "metadata": {
       "kind": "compute#metadata",
       "fingerprint": "zhma6O1w2l8="
       "items": [
       {
         "key": "key-1",
         "value": "value-1"
       }
       {
         "key": "key-2",
         "value": "value-2"
       }
       ]
     },
     ...
   }
   

2. Realiza una solicitud al método instances().setMetadata. Debes incluir el valor de huella digital de metadatos actual para que tu solicitud se complete correctamente.

   • Para quitar todos los pares clave-valor de metadatos personalizados de una VM, en la propiedad items, excluya las claves de metadatos de las que quiera quitar los valores de metadatos.

     POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instances/VM_NAME/setMetadata
     
     {
     "fingerprint": "FINGER_PRINT"
     "items": [
       {
         "key": "KEY1"
         "value": "VALUE1"
       }
       {
         "key": "KEY2"
         "value": "VALUE2"
       }
       ...
     ]
     }
     

   • Para quitar todos los metadatos de instancia personalizados de la VM, excluye la propiedad items por completo.

     POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instances/VM_NAME/setMetadata
     
     {
     "fingerprint": FINGER_PRINT
     }
     

   Haz los cambios siguientes:

   • PROJECT_ID: tu ID de proyecto.
   • ZONE: la zona de tu VM.
   • VM_NAME: nombre de tu VM
   • FINGER_PRINT: el valor actual de la huella digital.
   • KEY1, KEY2...: las claves de metadatos de instancia personalizadas que quieras quitar.
   • VALUE1, VALUE2...: los valores de las claves de metadatos de instancia personalizadas que quieras quitar.