Iniciar manualmente um evento de manutenção do host

Mantenha tudo organizado com as coleções Salve e categorize o conteúdo com base nas suas preferências.

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

Ao iniciar manualmente um evento de manutenção, a manutenção do host é iniciada imediatamente. Você não pode 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 ocorrerá no horário indicado na próxima notificação de manutenção .

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

Limitações

Você pode iniciar manualmente um evento de manutenção de host para instâncias que usam os seguintes tipos de máquina:

• Famílias de máquinas otimizadas para acelerador :

  • Tipos de máquinas A3 Ultra com 8 GPUs

  • Tipos de máquinas A3 Mega com 8 GPUs

  • Tipos de máquinas A3 High com 8 GPUs

  • Tipos de máquina A3 Edge com 8 GPUs

  • Tipos de máquinas A2 Ultra com 8 GPUs

  • Tipos de máquinas padrão A2 com 8 ou 16 GPUs

  • Tipos de máquina G2 com 8 GPUs

• Famílias de máquinas otimizadas para computação :

  • Tipos de máquinas H3 com 88 vCPUS

• Famílias de máquinas de uso geral :

  • Tipos de máquinas C4 com 192 vCPUS

  • Tipos de máquinas C4A com discos SSD locais conectados

  • Tipos de máquinas C3D com vCPUs 360 ou com discos SSD locais conectados

  • Tipos de máquinas C3 com 176 vCPUS ou com discos SSD locais conectados

  • Instâncias bare metal C3 com 192 vCPUS

• Famílias de máquinas com otimização de memória :

  • Tipos de máquinas X4

  • Tipos de máquinas M4

  • Tipos de máquinas M3

  • Tipos de máquinas M2

  • Tipos de máquinas M1

• Famílias de máquinas otimizadas para armazenamento :

  • Tipos de máquinas Z3 com 176 vCPUs

Antes de começar

• Se ainda não o fez, configure a autenticação. Autenticação é o processo pelo qual sua identidade é verificada para acesso a Google Cloud serviços e APIs. Para executar códigos ou amostras em um ambiente de desenvolvimento local, você pode se autenticar no Compute Engine selecionando uma das seguintes opções:
  

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

  gcloud

  1. After installing the Google Cloud CLI, initialize it by running the following command:

     gcloud init

     If you're using an external identity provider (IdP), you must first sign in to the gcloud CLI with your federated identity.

  2. Set a default region and zone.

  REST

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

  After installing the Google Cloud CLI, initialize it by running the following command:

  gcloud init

  If you're using an external identity provider (IdP), you must first sign in to the gcloud CLI with your federated identity.

  Para mais informações, consulte Autenticar para usar REST na documentação de autenticação do Google Cloud.

Funções obrigatórias

Para obter as permissões necessárias para gerenciar a manutenção da VM, peça ao administrador para conceder a você a função do IAM Compute Instance Admin (v1) ( roles/compute.instanceAdmin.v1 ) no projeto. Para obter mais informações sobre a concessão de funções, consulte Gerenciar acesso a projetos, pastas e organizações .

Esta função predefinida contém as permissões necessárias para gerenciar a manutenção da VM. Para ver as permissões exatas necessárias, expanda a seção Permissões necessárias :

Você também poderá obter essas permissões com funções personalizadas ou outras funções predefinidas .

Iniciar manualmente um evento de manutenção do host

O Compute Engine envia notificações sobre eventos de manutenção futuros por vários métodos. Usando as informações nas notificações, você pode determinar o prazo para iniciar manualmente um evento de manutenção.

Verifique as informações da notificação

Você pode encontrar suas notificações de eventos de manutenção:

• Consultando suas instâncias de computação ou servidor de metadados
• Usando o Cloud Logging

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 de sua escolha 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.

Isto indica que nenhum evento de manutenção foi agendado e que nenhuma ação precisa ser tomada.

Iniciar o evento de manutenção

Você pode iniciar a manutenção do host no horário de sua escolha, em vez de esperar pelo horário agendado. Use a Google Cloud CLI ou REST para acionar o evento de manutenção, que começa imediatamente.

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

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'

POST: https://compute.googleapis.com/compute/v1/projects/PROJECT_NAME/zones/ZONE/instances/INSTANCE_NAME/performMaintenance

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

O que vem a seguir

• Aprenda como simular um evento de manutenção de host .
• Saiba como obter avisos de migração em tempo real .
• Aprenda como configurar alertas para notificações de manutenção do host .