Visualizar as operações do Compute Engine

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 Google Cloud console, a Google Cloud CLI, 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. Com isso, você confirma sua identidade para acesso a Google Cloud serviços e APIs do. Para executar código ou exemplos de um ambiente de desenvolvimento local, faça a autenticação no Compute Engine com uma destas opções:

    Selecione a guia para como planeja usar as amostras nesta página:

    Console

    Quando você usa o Google Cloud console para acessar Google Cloud serviços e APIs, não é necessário configurar a autenticação.

    gcloud

    1. Instale a Google Cloud CLI. Após a instalação, inicialize a Google Cloud CLI executando o seguinte comando: 

      gcloud init

      Ao usar um provedor de identidade (IdP) externo, primeiro faça login na CLI gcloud com sua identidade federada.

  • Defina uma região e uma zona padrão.

    • REST

    Para usar as amostras da API REST desta página em um ambiente de desenvolvimento local, use as credenciais fornecidas para a CLI gcloud.

      Instale a Google Cloud CLI.

      Ao usar um provedor de identidade (IdP) externo, primeiro faça login na CLI gcloud com sua identidade federada.

    Saiba mais em Autenticar para usar REST na documentação de autenticação do Google Cloud .

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

  1. No Google Cloud console, acesse a página Operações.

    Acessar "Operações"

  2. 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.

A página de operações que mostra uma migração em tempo real. Detalhes da migração em tempo real.

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. 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"
}