Cuando llamas a una API de Compute Engine que muta un recurso, Compute Engine agrega una entrada a la lista de operaciones. Por ejemplo, cuando realizas una actualización en una VM que muta (modifica) datos o cuando ocurre 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 con la consola de Google Cloud, Google Cloud CLI o REST.
Recuerda que las operaciones pueden tomar un tiempo en completarse, por lo que es posible que encuentres operaciones incompletas mientras se visualizan. Cuando quieras ver el estado final de las operaciones incompletas, no se recomienda ver las operaciones repetidas; en su lugar, debes esperar a que se realicen las operaciones.
Antes de comenzar
-
Configura la autenticación si aún no lo hiciste.
La autenticación es el proceso mediante el cual se verifica tu identidad para acceder a los servicios y las API de Google Cloud.
Para ejecutar código o muestras desde un entorno de desarrollo local, puedes autenticarte en Compute Engine de la siguiente manera.
Selecciona la pestaña para saber cómo planeas usar las muestras en esta página:
Consola
Cuando usas la consola de Google Cloud para acceder a los servicios y las APIs de Google Cloud, no necesitas configurar la autenticación.
gcloud
-
Instala Google Cloud CLI y, luego, inicializa la ejecución del siguiente comando:
gcloud init
- Configura una región y una zona predeterminadas.
REST
Para usar las muestras de la API de REST en esta página en un entorno de desarrollo local, debes usar las credenciales que proporcionas a la CLI de gcloud.
Instala Google Cloud CLI y, luego, inicializa la ejecución del siguiente comando:
gcloud init
-
Período de retención de operaciones
Mientras consultas las operaciones, ten en cuenta que las operaciones completadas se quitan automáticamente de la base de datos después de un período determinado.
Compute Engine conserva las operaciones completadas por al menos el período de retención mínimo de 1 hora y hasta el período máximo de retención de 14 días. Aunque los proyectos a menudo observan un período de retención para las operaciones completadas que duran más de 1 hora, según el período de retención adicional, no se recomienda.
Ten en cuenta que los períodos de retención no se aplican a las operaciones que borran los usuarios a través del método Operations.delete.
Visualizar operaciones
Para ver una lista de operaciones de tu proyecto, realiza los siguientes pasos:
Console
En la consola de Google Cloud, ve a la página Operaciones.
Para obtener más detalles sobre una operación, haz clic en el resumen de la operación. Por ejemplo, para ver los detalles de migración de la VM
my-instance, haz clic en la operación Migrar una instancia de forma automática.
gcloud
Si deseas ver una lista de operaciones para tu proyecto con gcloud compute, usa el subcomando operations list.
Para ver la lista de operaciones en una zona específica, agrega la marca --filter.
gcloud compute operations list --filter="zone:(ZONE)"
Reemplaza ZONE por la zona en la que deseas ver una lista de operaciones. Por ejemplo, si quieres ver la lista de operaciones en us-cental1-c, ejecuta el siguiente comando:
gcloud compute operations list --filter="zone:(us-central1-c)"
El resultado es similar a este:
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 a la API para las operaciones deben especificarse a nivel global, regional o zonal. La migración en vivo, la detención de VM y los reinicios automáticos son todas operaciones a nivel zonal.
Para las operaciones zonales, haz una solicitud GET al método zoneOperations.list.
GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/operations
Reemplaza lo siguiente:
PROJECT_ID: Es el ID del proyecto de esta solicitud.ZONE: Es la zona para esta solicitud.
Deja el cuerpo de la solicitud vacío.
El siguiente es un resultado de muestra 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"
}