Iniciar manualmente um evento de manutenção de host

Nesta página, explicamos como iniciar manualmente um evento de manutenção de host em instâncias do Compute Engine. Esse recurso permite iniciar um evento de manutenção para controlar o tempo de manutenção da instância. Isso é útil para cargas de trabalho que podem ser afetadas por desempenho degradado ou inatividade e para as quais você precisa que a janela de manutenção comece em um horário específico.

Quando você inicia manualmente um evento de manutenção, a manutenção do host começa imediatamente. Não é possível especificar uma data ou hora para o início do evento de manutenção. Se você não usar esse recurso, o evento de manutenção vai ocorrer no horário indicado na notificação de manutenção futura.

Se você quiser testar como seus aplicativos vão lidar com um evento de manutenção, você pode simular um evento de manutenção.

Limitações

É possível iniciar manualmente um evento de manutenção de host para instâncias que usam os seguintes tipos de máquina:

Antes de começar

Funções exigidas

Para receber as permissões necessárias para gerenciar a manutenção da VM, peça ao administrador para conceder a você o papel do IAM de Administrador da instância do Compute (v1) (roles/compute.instanceAdmin.v1) no projeto. Para mais informações sobre a concessão de papéis, consulte Gerenciar o acesso a projetos, pastas e organizações.

Esse papel predefinido contém as permissões necessárias para gerenciar a manutenção da VM. Para acessar as permissões exatas que são necessárias, expanda a seção Permissões necessárias:

Permissões necessárias

As permissões a seguir são necessárias para gerenciar a manutenção da VM:

  • Para receber informações sobre uma instância de computação: compute.instances.get

Essas permissões também podem ser concedidas com funções personalizadas ou outros papéis predefinidos.

Iniciar manualmente um evento de manutenção de host

O Compute Engine envia notificações sobre os próximos eventos de manutenção usando vários métodos. Com as informações nas notificações, é possível determinar o período em que você pode iniciar manualmente um evento de manutenção.

Verificar as informações da notificação

É possível encontrar as notificações de eventos de manutenção de uma das seguintes maneiras:

Se a notificação sobre um evento de manutenção do host contiver canReschedule=True e maintenanceStatus=Pending, você terá a opção de iniciar a manutenção no horário que escolher ou aguardar que o evento de manutenção ocorra no horário especificado por windowStartTime.

Se não houver notificação e você tentar iniciar manualmente um evento de manutenção, a seguinte mensagem será exibida:

There is no reschedulable upcoming maintenance.

Essa mensagem indica que nenhum evento de manutenção foi programado e que nenhuma ação precisa ser tomada.

Iniciar o evento de manutenção

É possível iniciar a manutenção do host no horário que escolher, em vez de aguardar o horário programado. Use a Google Cloud CLI ou o REST para acionar o evento de manutenção, que será iniciado imediatamente.

gcloud

Para iniciar um evento de manutenção, use o compute instances perform-maintenance comando. A manutenção do host começa imediatamente após a inserção do comando.

gcloud compute instances perform-maintenance INSTANCE_NAME \
    --zone=ZONE

Substitua:

  • INSTANCE_NAME: o nome da instância de computação.
  • ZONE: a zona em que a instância reside.

A resposta é semelhante a:

resourceStatus:
  upcomingMaintenance:
    canReschedule: false
    latestWindowStartTime: '2025-01-15T19:57:17Z'
    maintenanceStatus: ONGOING
    type: SCHEDULED
    windowEndTime: '2025-01-15T23:57:11Z'
    windowStartTime: '2025-01-15T19:57:16Z'

Na resposta, canReschedule está definido como false e maintenanceStatus está definido como ONGOING, o que indica que a operação de manutenção do host está em andamento.

REST

Para iniciar um evento de manutenção, crie uma solicitação POST usando o instances.performMaintenance método.

POST: https://compute.s3nsapis.fr/compute/v1/projects/PROJECT_NAME/zones/ZONE/instances/INSTANCE_NAME/performMaintenance

Substitua:

  • PROJECT_NAME: o nome do projeto
  • ZONE: a zona em que a instância de computação reside
  • INSTANCE_NAME: o nome da instância

A resposta será assim:

upcomingMaintenance:{
  "canReschedule":false
  "latestWindowStartTime": "2023-12-01T19:00:01Z"
  "maintenanceStatus":"ONGOING"
  "type":"SCHEDULED"
  "windowEndTime": "2023-12-01T22:00:00Z"
  "windowStartTime": "2023-12-01T19:00:00Z"
}

Na resposta, canReschedule está definido como false e maintenanceStatus está definido como ONGOING, o que indica que a operação de manutenção do host está em andamento.

A seguir