Ver operaciones de Compute Engine

Cuando llamas a una API de Compute Engine que muta un recurso, Compute Engine añade una entrada a la lista de operaciones. Por ejemplo, cuando actualizas una VM que muta (modifica) datos o cuando se produce un evento de host que cambia el estado de una VM, se crean operaciones. En esta página se describe cómo puedes ver una lista de operaciones de Compute Engine mediante la consola, la CLI de Google Cloud o REST.Google Cloud

Recuerda que las operaciones pueden tardar un tiempo en completarse, por lo que es posible que veas operaciones incompletas. Si quieres ver el estado final de las operaciones incompletas, no te recomendamos que consultes las operaciones repetidamente, sino que esperes a que se completen.

Antes de empezar

  • Si aún no lo has hecho, configura la autenticación. La autenticación verifica tu identidad para acceder a Google Cloud servicios y APIs. Para ejecutar código o ejemplos desde un entorno de desarrollo local, puedes autenticarte en Compute Engine seleccionando una de las siguientes opciones:

    Select the tab for how you plan to use the samples on this page:

    Console

    When you use the Google Cloud console to access Google Cloud services and APIs, you don't need to set up authentication.

    gcloud

    1. Instala Google Cloud CLI. Después de la instalación, inicializa la CLI de Google Cloud ejecutando el siguiente comando: 

      gcloud init

      Si utilizas un proveedor de identidades (IdP) externo, primero debes iniciar sesión en la CLI de gcloud con tu identidad federada.

    2. Set a default region and zone.

    REST

    Para usar las muestras de la API REST de esta página en un entorno de desarrollo local, debes usar las credenciales que proporciones a la CLI de gcloud.

      Instala Google Cloud CLI. Después de la instalación, inicializa la CLI de Google Cloud ejecutando el siguiente comando: 

      gcloud init

      Si utilizas un proveedor de identidades (IdP) externo, primero debes iniciar sesión en la CLI de gcloud con tu identidad federada.

    Para obtener más información, consulta el artículo Autenticarse para usar REST de la documentación sobre autenticación de Google Cloud .

Periodo de conservación de la operación

Cuando consultes operaciones, ten en cuenta que las operaciones completadas se eliminan automáticamente de la base de datos al cabo de un periodo determinado.

Compute Engine conserva las operaciones completadas durante al menos el periodo de conservación mínimo de 1 hora y hasta el periodo de conservación máximo de 14 días. Aunque los proyectos suelen observar un periodo de conservación de las operaciones completadas que es superior al mínimo de 1 hora, no se recomienda depender del periodo de conservación adicional.

Ten en cuenta que los periodos de conservación no se aplican a las operaciones eliminadas por los usuarios mediante el método Operations.delete.

Ver operaciones

Para ver una lista de las operaciones de tu proyecto, sigue estos pasos:

Consola

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

    Ir a Operaciones

  2. Para obtener más información sobre una operación, haz clic en el resumen de la operación. Por ejemplo, para ver los detalles de la migración de la máquina virtual my-instance, haz clic en la operación Migrar una instancia automáticamente.

La página de operaciones muestra una migración en directo. Detalles de la migración en tiempo real.

gcloud

Para ver una lista de las operaciones de tu proyecto con gcloud compute, usa el subcomando operations list.

Para ver la lista de operaciones de una zona específica, añade la marca --filter.

gcloud compute operations list --filter="zone:(ZONE)"

Sustituye ZONE por la zona en la que quieras ver una lista de operaciones. Por ejemplo, para ver la lista de operaciones de us-cental1-c, ejecuta el siguiente comando:

gcloud compute operations list --filter="zone:(us-central1-c)"

El resultado debería ser similar al siguiente: 

NAME                            TYPE                                        TARGET                                HTTP_STATUS  STATUS  TIMESTAMP
systemevent-1543845145000...    compute.instances.migrateOnHostMaintenance  us-central1-c/instances/my-instance   200          DONE    2018-12-03T05:52:25.000-08:00

REST

Las solicitudes de API de operaciones deben especificarse a nivel global, de región o de zona. La migración en directo, la detención de VMs y los reinicios automáticos son operaciones a nivel de zona.

Para las operaciones de zona, haz una solicitud GET al método zoneOperations.list.

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

Haz los cambios siguientes:

  • PROJECT_ID: el ID de proyecto de esta solicitud
  • ZONE: la zona de esta solicitud

Deje el cuerpo de la solicitud vacío.

A continuación, se muestra un ejemplo de salida de una solicitud de operación de zona. En este resultado, se muestran los detalles de una migración de host.

{
 "kind": "compute#operation",
 "id": "3216798767364213712",
 "name": "systemevent-1543845145000-57c1e7574b840-a195b637-5ff74d9b",
 "zone": "https://www.googleapis.com/compute/v1/projects/my-project/zones/us-central1-c",
 "operationType": "compute.instances.migrateOnHostMaintenance",
 "targetLink": "https://www.googleapis.com/compute/v1/projects/my-project/zones/us-central1-c/instances/my-instance",
 "targetId": "3070988523247098025",
 "status": "DONE",
 "statusMessage": "Instance migrated during Compute Engine maintenance.",
 "user": "system",
 "progress": 100,
 "insertTime": "2018-12-03T05:52:25.000-08:00",
 "startTime": "2018-12-03T05:52:25.000-08:00",
 "endTime": "2018-12-03T05:52:25.000-08:00",
 "selfLink": "https://www.googleapis.com/compute/v1/projects/my-project/zones/us-central1-c/operations/systemevent-1543845145000-57c1e7574b840-a195b637-5ff74d9b"
}