Quando você chama uma API Compute Engine que modifica um recurso, o Compute Engine adiciona uma entrada à lista de operações. Por exemplo, quando você faz uma atualização em uma VM que modifica (altera) dados ou quando ocorre um evento de host que muda o estado de uma VM, operações são criadas. Nesta página, descrevemos como visualizar uma lista de operações do Compute Engine usando o console do Google Cloud, a CLI do Google Cloud ou REST.
Lembre-se de que as operações podem levar algum tempo para serem concluídas. Por isso, é possível encontrar operações incompletas durante a visualização. Não é recomendável visualizar operações incompletas repetidamente para conferir o status final delas. Em vez disso, aguarde a conclusão das operações.
Antes de começar
-
Configure a autenticação, caso ainda não tenha feito isso.
A autenticação é
o processo de verificação da sua identidade para acesso a serviços e APIs do Google Cloud.
Para executar códigos ou amostras de um ambiente de desenvolvimento local, autentique-se no
Compute Engine da seguinte maneira.
Selecione a guia para como planeja usar as amostras nesta página:
Console
Quando você usa o console do Google Cloud para acessar os serviços e as APIs do Google Cloud, não é necessário configurar a autenticação.
gcloud
-
Instale a Google Cloud CLI e inicialize-a executando o seguinte comando:
gcloud init
- Defina uma região e uma zona padrão.
REST
Para usar as amostras da API REST nesta página em um ambiente de desenvolvimento local, use as credenciais fornecidas para a CLI gcloud.
Instale a Google Cloud CLI e inicialize-a executando o seguinte comando:
gcloud init
-
Período de armazenamento da operação
Ao realizar consultas, lembre-se de que as operações concluídas são removidas de modo automático do banco de dados após um determinado período.
O Compute Engine mantém as operações concluídas por pelo menos uma hora, que é o período de armazenamento mínimo, e por até 14 dias, que é o período de armazenamento máximo. Embora seja comum haver um período de armazenamento de operações concluídas maior do que o mínimo de uma hora nos projetos, não é recomendado depender do período de armazenamento adicional.
É importante ter em mente que os períodos de armazenamento não se aplicam a operações excluídas pelos usuários
com o método Operations.delete
.
Visualizar as operações
Para conferir uma lista das operações do projeto, siga estas etapas:
Console
No console do Google Cloud, abra a página Operações:
Para mais detalhes sobre uma operação, clique no respectivo resumo. Por exemplo, para visualizar os detalhes de migração da VM
my-instance
, clique na operação Migrar uma instância automaticamente.
gcloud
Para visualizar uma lista de operações do seu projeto
usando gcloud compute
, use o subcomando
operations list
.
Para visualizar a lista de operações em uma zona especificada, adicione a sinalização --filter
.
gcloud compute operations list --filter="zone:(ZONE)"
Substitua ZONE
pela zona em que você quer visualizar uma lista de
operações. Por exemplo, para visualizar a lista de operações em us-cental1-c
,
execute o seguinte comando:
gcloud compute operations list --filter="zone:(us-central1-c)"
O resultado será assim:
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
Solicitações de API para operações precisam ser especificadas no nível global, de região ou de zona. Migração em tempo real, interrupção de VM e reinicializações automáticas são todas operações no nível da zona.
Para operações de zona, crie uma solicitação GET
para o método zoneOperations.list
.
GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/operations
Substitua o seguinte:
PROJECT_ID
: o ID do projeto desta solicitação;ZONE
: a zona da solicitação.
Deixe o corpo da solicitação vazio.
A seguir, um exemplo de saída para uma solicitação de operação de zona. Nela, os detalhes de uma migração do host são exibidos.
{ "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" }