Gerenciar eventos de host em todas as reservas

Neste documento, explicamos como usar os recursos de manutenção de host disponíveis no AI Hypercomputer. Ele explica como monitorar, planejar e realizar a manutenção programada nos seus blocos de capacidade reservada. Para gerenciar a manutenção nas instâncias do Compute Engine, consulte Gerenciar eventos de host em instâncias de computação.

É possível gerenciar proativamente os próximos eventos de manutenção de host nos blocos de capacidade reservados, estejam ou não instâncias em execução neles. Essa abordagem ajuda a minimizar interrupções e manter a performance ideal.

Antes de começar

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

Console

When you use the Google Cloud console to access Google Cloud services and APIs, you don't need to set up authentication.

gcloud

In the Google Cloud console, activate Cloud Shell.

Activate Cloud Shell

At the bottom of the Google Cloud console, a Cloud Shell session starts and displays a command-line prompt. Cloud Shell is a shell environment with the Google Cloud CLI already installed and with values already set for your current project. It can take a few seconds for the session to initialize.

REST

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

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

gcloud init

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

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

Funções exigidas

Para receber as permissões necessárias para gerenciar eventos de manutenção do host em todas as reservas, peça ao administrador para conceder a você os seguintes papéis do IAM:

Administrador do Compute (roles/compute.admin) no projeto
Para acesso somente leitura aos registros de auditoria de eventos do sistema: Visualizador de registros (roles/logging.viewer) no projeto

Para mais informações sobre a concessão de papéis, consulte Gerenciar o acesso a projetos, pastas e organizações.

Esses papéis predefinidos contêm as permissões necessárias para gerenciar eventos de manutenção do host em todas as reservas. Para acessar as permissões exatas necessárias, expanda a seção Permissões necessárias:

Permissões necessárias

As seguintes permissões são necessárias para gerenciar eventos de manutenção do host em todas as reservas:

Para iniciar a manutenção do host em uma reserva: compute.reservations.performMaintenance no projeto
Para iniciar a manutenção do host em um bloco de reserva: compute.reservationBlocks.performMaintenance no projeto
Para iniciar a manutenção do host em um sub-bloco de reserva: compute.reservationSubBlocks.performMaintenance no projeto
Para ver uma lista de reservas: compute.reservations.list no projeto
Para ver os detalhes de uma reserva: compute.reservations.get no projeto
Para ver uma lista de blocos em uma reserva: compute.reservationBlocks.list no projeto
Para ver uma lista de sub-blocos em um bloco de reserva: compute.reservationSubBlocks.list no projeto

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

Visão geral

Se ainda não tiver feito isso, leia Entender e lidar com a manutenção do host.

Para otimizar a manutenção dos seus blocos de capacidade reservados, siga estas etapas:

Configure alertas de notificação. Crie alertas com base em registros para receber notificações sobre eventos de manutenção programados, iniciados ou concluídos para uma reserva, um bloco ou um subbloco de reserva. Essa abordagem ajuda você a planejar suas atividades de forma proativa e evitar inatividade inesperada.
Gerenciar a manutenção em blocos de capacidade. Veja e, se necessário, inicie manualmente a manutenção em suas reservas, blocos de reserva ou sub-blocos de reserva. Esse processo ajuda a aumentar a resiliência das cargas de trabalho a erros de host, evitar inatividade e garantir que os aplicativos permaneçam disponíveis.

Configurar alertas de notificação para reservas

É possível receber notificações sobre eventos de manutenção programados, iniciados ou concluídos para uma reserva, um bloco de reserva ou um subbloco de reserva ao criar políticas de alertas com base em registros.

Para criar um alerta para os eventos de manutenção de uma reserva, um bloco de reserva ou um subbloco de reserva, siga este procedimento. Repita esse procedimento para cada alerta que você quiser criar.

No console do Google Cloud , acesse a página Análise de registros:
Acessar a Análise de registros

Se você usar a barra de pesquisa para encontrar essa página, selecione o resultado com o subtítulo Logging.
Clique no botão Mostrar consulta para a posição ativada.

No painel Consulta, crie uma das seguintes consultas. Essas consultas filtram entradas de registro para identificar eventos de manutenção específicos. Repita esse procedimento para cada consulta que você quiser criar.

Receber alertas de manutenção para uma reserva:

Para receber alertas quando uma manutenção for programada:

protoPayload.methodName="compute.reservations.upcomingGroupMaintenance" severity>=DEFAULT
protoPayload.status.message =~ "scheduled"

Para receber alertas quando a manutenção for concluída:

protoPayload.methodName="compute.reservations.completedGroupMaintenance" severity>=DEFAULT
protoPayload.status.message =~ "completed"

Receber alertas de manutenção para um bloco de reserva:

Para receber alertas quando uma manutenção for programada:

protoPayload.methodName="compute.reservations.block.upcomingGroupMaintenance" severity>=DEFAULT
protoPayload.status.message =~ "scheduled"

Para receber alertas quando a manutenção começar:

protoPayload.methodName="compute.reservations.block.startGroupMaintenance" severity>=DEFAULT
protoPayload.status.message =~ "started"

Para receber alertas quando a manutenção for concluída:

protoPayload.methodName="compute.reservations.block.completedGroupMaintenance" severity>=DEFAULT
protoPayload.status.message =~ "completed"

Receber alertas de manutenção para um sub-bloco de reserva de instâncias A4X Max ou A4X:

Para receber alertas quando uma manutenção for programada:

protoPayload.methodName="compute.reservations.subBlock.upcomingGroupMaintenance" severity>=DEFAULT
protoPayload.status.message =~ "scheduled"

Para receber alertas quando a manutenção começar:

protoPayload.methodName="compute.reservations.subBlock.startGroupMaintenance" severity>=DEFAULT
protoPayload.status.message =~ "started"

Para receber alertas quando a manutenção for concluída:

protoPayload.methodName="compute.reservations.subBlock.completedGroupMaintenance" severity>=DEFAULT
protoPayload.status.message =~ "completed"

Para receber alertas quando uma máquina A4X Max ou A4X encontrar um erro e o Compute Engine iniciar a manutenção:

protoPayload.methodName="compute.reservations.subblock.unusedmachinerepair" severity>=DEFAULT
protoPayload.status.message =~ "maintenance"

Para receber alertas quando a manutenção de uma máquina A4X Max ou A4X que encontrou um erro for concluída:

protoPayload.methodName="compute.reservations.subblock.unusedmachinerepaircomplete" severity>=DEFAULT
protoPayload.status.message =~ "repaired"

Para validar a consulta, clique em Executar consulta. Se a consulta for válida, o painel Resultados da consulta vai mostrar as entradas de registro que correspondem a ela.
Na barra de ferramentas de resultados da consulta, clique na lista Ações e selecione Criar alerta de registro. O painel Criar política de alertas baseada em registros aparece.
Na seção Detalhes do alerta, faça o seguinte:
1. No campo Nome da política de alertas, digite um nome para a política.
2. Na lista Nível de gravidade da política, selecione Aviso (ou uma gravidade maior).
3. Clique em Próxima.
Na seção Escolher registros a serem incluídos no alerta, clique em Próxima.
Na seção Definir a frequência da notificação e a duração do fechamento automático, especifique o seguinte:
1. Na lista Tempo entre notificações, selecione a frequência com que você quer receber notificações.
2. Na lista Duração do fechamento automático de incidentes, selecione após quanto tempo o Cloud Logging para de enviar notificações e fecha automaticamente o incidente.
3. Clique em Próxima.
Na seção Quem deve receber notificações?, especifique um canal de notificação para o Logging enviar notificações.
Clique em Salvar.

Gerenciar a manutenção em todas as reservas

É possível conferir e controlar a manutenção das suas reservas, blocos de reserva e sub-blocos de reserva da seguinte maneira:

Para verificar o estado e o horário programado da próxima manutenção das suas reservas, blocos de reserva ou sub-blocos de reserva, confira o estado da manutenção.
Para iniciar manualmente a manutenção em uma reserva, um bloco de reserva ou um sub-bloco de reserva, em vez de esperar a data e a hora programadas, inicie a manutenção manualmente.
Para gerenciar o tempo de antecedência com que você quer receber notificações quando o host de uma instância de computação exige manutenção de emergência não planejada após um erro ou relatório de host com falha, gerencie as notificações de manutenção de emergência de hardware.

Ver o estado de manutenção

Para conferir o estado da manutenção futura de uma reserva, um bloco de reserva ou um sub-bloco de reserva, verifique o valor do campo upcomingGroupMaintenance nos metadados. Se uma reserva não tiver o campo upcomingGroupMaintenance, nenhuma manutenção será programada para ela, para o bloco ou para o subbloco. Para mais informações sobre os campos em upcomingGroupMaintenance, consulte Definições de status de manutenção na documentação do Compute Engine.

Além disso, se a manutenção estiver programada para um bloco ou sub-bloco de reserva, o campo upcomingGroupMaintenance vai conter o campo maintenanceReasons. Este campo descreve por que a manutenção foi programada para seu bloco ou subbloco de reserva, conforme descrito na tabela a seguir:

Tipo de manutenção	Motivo da manutenção	Estado da instância de computação
Manutenção planejada após o relatório de host com falha	`FAILURE_GPU_CUSTOMER_REPORTED`	Isso se aplica apenas a instâncias em execução no host que você informou como com falha.
Manutenção planejada para manutenção regular	`PLANNED_UPDATE`: manutenção planejada da infraestrutura `PLANNED_NETWORK_UPDATE`: manutenção de rede planejada	Aplica-se a instâncias em execução, interrompidas ou suspensas.
Manutenção de emergência não planejada	`FAILURE_DISK`: manutenção não planejada programada devido a um erro com um disco anexado a uma instância. `FAILURE_GPU`: manutenção não planejada programada devido a um erro relacionado à GPU. `FAILURE_GPU_TEMPERATURE`: manutenção não planejada agendada devido a um erro relacionado à GPU depois que ela atingiu uma temperatura alta. `FAILURE_GPU_XID`: manutenção não planejada depois que você recebeu uma mensagem Xid devido a um erro relacionado à GPU. `FAILURE_INFRA`: manutenção não planejada programada devido a um erro na infraestrutura. `FAILURE_INTERFACE`: manutenção não planejada programada devido a um erro na NIC. `FAILURE_MEMORY`: manutenção não planejada programada devido a um erro na memória de uma instância. `FAILURE_NETWORK`: manutenção não planejada programada devido a um erro na rede. `FAILURE_NVLINK`: manutenção não planejada programada devido a um erro com o NVLink.	Aplicável apenas a instâncias em execução.

Para conferir o campo maintenanceReasons em um bloco ou sub-bloco de reserva ou o estado de manutenção de um sub-bloco, use a CLI gcloud ou a API REST. Caso contrário, selecione uma destas opções:

Console

No console do Google Cloud , acesse a página Reservas.

Acessar "Reservas"
Na coluna Status da manutenção, o Compute Engine mostra o estado de manutenção das suas reservas. Se essa coluna não aparecer na tabela Reservas sob demanda, clique em Opções de exibição de colunas, marque a caixa de seleção Status da manutenção e clique em OK.
Para conferir o estado de manutenção de um bloco de reserva, siga estas etapas:
1. Na coluna Nome, clique no nome da reserva. Uma página com os detalhes da reserva vai aparecer.
2. Na tabela Blocos, na coluna Manutenção, o Compute Engine mostra o estado de manutenção dos blocos na reserva.

gcloud

Para conferir o estado de manutenção de uma reserva, use o comando gcloud compute reservations describe com a flag --flatten definida como resourceStatus.reservationMaintenance:
```
gcloud compute reservations describe RESERVATION_NAME \
    --flatten=resourceStatus.reservationMaintenance \
    --zone=ZONE
```
Substitua:
- RESERVATION_NAME: o nome da reserva.
- ZONE: a zona em que a reserva existe.
A saída será semelhante a uma das seguintes:
- Se a manutenção estiver programada para sua reserva, a saída será semelhante a esta:
```
---
maintenanceOngoingCount: 0
maintenancePendingCount: 6
schedulingType: GROUPED
upcomingGroupMaintenance:
  canReschedule: true
  maintenanceStatus: PENDING
  type: UNSCHEDULED
  windowEndTime: '2025-11-13T14:00:00.000-08:00'
  windowStartTime: '2025-11-13T12:00:00.000-08:00'
```
  Se o campo schedulingType estiver definido como INDEPENDENT, o campo upcomingGroupMaintenance não vai conter os campos windowStartTime e windowEndTime. Para saber quando a manutenção está programada para uma instância executada em um host reservado, confira o estado de manutenção da instância.
- Se não houver manutenção programada para sua reserva, a saída será semelhante a esta:
```
---
schedulingType: GROUPED
```

Se a manutenção estiver programada para sua reserva, use o comando gcloud compute reservations blocks list para conferir o estado de manutenção dos blocos na reserva:

gcloud compute reservations blocks list RESERVATION_NAME \
    --zone=ZONE

Se houver uma manutenção programada ou em andamento para um bloco de reserva, a saída será semelhante a esta:

---
...
name: example-fr-a3u-dense-1-block-0001
...
reservationBlockMaintenance:
  maintenanceOngoingCount: 0
  maintenancePendingCount: 6
  schedulingType: GROUPED
  upcomingGroupMaintenance:
    canReschedule: true
    maintenanceReasons:
    - PLANNED_UPDATE
    - PLANNED_NETWORK_UPDATE
    maintenanceStatus: PENDING
    type: UNSCHEDULED
    windowEndTime: '2025-11-13T14:00:00.000-08:00'
    windowStartTime: '2025-11-13T12:00:00.000-08:00'
...
---
...
name: example-fr-a3u-dense-1-block-0002
...
schedulingType: GROUPED
...

Se a manutenção estiver programada para um bloco de reserva, use o comando gcloud compute reservations sub-blocks list para conferir o estado de manutenção dos sub-blocos dentro dele:

gcloud compute reservations sub-blocks list RESERVATION_NAME \
    --block-name=BLOCK_NAME \
    --zone=ZONE

Substitua BLOCK_NAME pelo nome de um bloco que existe na reserva.

Se houver uma manutenção programada ou em andamento para um subbloco de reserva, a saída será semelhante a esta:

...
reservationSubBlockMaintenance:
  instanceMaintenanceOngoingCount: 0
  instanceMaintenancePendingCount: 3
  maintenanceOngoingCount: 0
  maintenancePendingCount: 32
  schedulingType: GROUPED
  subblockInfraMaintenanceOngoingCount: 0
  subblockInfraMaintenancePendingCount: 0
  upcomingGroupMaintenance:
    canReschedule: true
    maintenanceReasons:
    - PLANNED_UPDATE
    - PLANNED_NETWORK_UPDATE
    maintenanceStatus: PENDING
    type: SCHEDULED
    windowEndTime: '2025-11-13T14:00:00.000-08:00'
    windowStartTime: '2025-11-13T12:00:00.000-08:00'
...

REST

Para conferir o estado de manutenção das suas reservas, faça uma solicitação GET para um dos seguintes métodos:
- Para ver as reservas em todas as zonas, use o método reservations.aggregatedList.
- Para conferir as reservas em uma zona específica, use o método reservations.list.
No URL da solicitação, inclua os seguintes parâmetros de consulta:
- Para mostrar apenas o nome, o tipo de máquina reservado e o status de manutenção de uma reserva, inclua o parâmetro de consulta fields definido como items.name,items.specificReservation.instanceProperties.machineType,items.resourceStatus.reservationMaintenance.
- Para filtrar apenas por reservas que especificam um tipo de máquina específico, inclua o parâmetro de consulta filter definido como specificReservation.instanceProperties.machineType:MACHINE_TYPE usando valores codificados por URL.
Por exemplo, para ver as reservas em todas as zonas, faça uma solicitação GET da seguinte maneira:
```
GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/aggregated/reservations?fields=items.name,items.specificReservation.instanceProperties.machineType,items.resourceStatus.reservationMaintenance&filter=specificReservation.instanceProperties.machineType%3AMACHINE_TYPE
```
Substitua:
- PROJECT_ID: o ID do projeto em que as reservas estão.
- MACHINE_TYPE: o tipo de máquina reservada que você quer usar para filtrar suas reservas.
Se houver uma manutenção programada ou em andamento para uma reserva, a saída será semelhante a esta:
```
{
  "items": [
    {
      "specificReservation": {
        "instanceProperties": {
          "machineType": "MACHINE_TYPE"
        }
      },
      "name": "example-reservation",
      "resourceStatus": {
        "reservationMaintenance": {
          maintenanceOngoingCount: 0,
          maintenancePendingCount: 6,
          "schedulingType": "GROUPED",
          "upcomingGroupMaintenance": {
            "type": "SCHEDULED",
            "canReschedule": true,
            "windowStartTime": "2025-11-13T12:00:00.000-08:00",
            "windowEndTime": "2025-11-13T14:00:00.000-08:00",
            "maintenanceStatus": "PENDING"
          }
        }
      }
    },
    ...
  ]
}
```
Para restringir ainda mais uma lista de instâncias de computação, defina o parâmetro de consulta filter como uma expressão de filtro diferente.

Se a manutenção estiver programada para sua reserva, faça uma solicitação GET ao método reservationBlocks.list para conferir o estado de manutenção dos blocos na reserva. No URL da solicitação, inclua o parâmetro de consulta fields definido como items.name,items.reservationMaintenance:

GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/reservations/RESERVATION_NAME/reservationBlocks?fields=items.name,items.reservationMaintenance

Substitua RESERVATION_NAME pelo nome da reserva.

Se houver uma manutenção programada ou em andamento para um bloco de reserva, a saída será semelhante a esta:

{
  "items": [
    {
      "name": "example-fr-a3u-dense-1-block-0001",
      "reservationBlockMaintenance": {
        "maintenanceOngoingCount": 0,
        "maintenancePendingCount": 6,
        "schedulingType": "GROUPED",
        "upcomingGroupMaintenance": {
          "type": "SCHEDULED",
          "canReschedule": true,
          "windowStartTime": "2025-11-13T12:00:00.000-08:00",
          "windowEndTime": "2025-11-13T14:00:00.000-08:00",
          "maintenanceStatus": "PENDING",
          "maintenanceReasons": [
            "PLANNED_UPDATE",
            "PLANNED_NETWORK_UPDATE"
          ]
        }
      }
    },
    ...
  ]
}

Se o campo schedulingType estiver definido como INDEPENDENT para um bloco, o campo upcomingGroupMaintenance não vai conter os campos windowStartTime e windowEndTime. Para saber quando a manutenção está programada para uma instância executada em um bloco reservado, consulte o estado de manutenção da instância.

Se a manutenção estiver programada para um bloco de reserva, faça uma solicitação GET para o método reservationSubBlocks.list e confira o estado de manutenção dos sub-blocos dentro do bloco de reserva:

GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/reservations/RESERVATION_NAME/reservationBlocks/BLOCK_NAME/reservationSubBlocks

Substitua BLOCK_NAME pelo nome de um bloco que existe na reserva.

Se houver uma manutenção programada ou em andamento para um subbloco de reserva, a saída será semelhante a esta:

{
  "items": [
    {
      "name": "example-fr-a3u-dense-1-block-0001",
      "reservationSubBlockMaintenance": {
        "instanceMaintenanceOngoingCount": 0,
        "instanceMaintenancePendingCount": 3,
        "maintenanceOngoingCount": 0,
        "maintenancePendingCount": 6,
        "schedulingType": "GROUPED",
        "subblockInfraMaintenanceOngoingCount": 0,
        "subblockInfraMaintenancePendingCount": 0,
        "upcomingGroupMaintenance": {
          "type": "SCHEDULED",
          "canReschedule": true,
          "windowStartTime": "2025-11-13T12:00:00.000-08:00",
          "windowEndTime": "2025-11-13T14:00:00.000-08:00",
          "maintenanceStatus": "PENDING",
          "maintenanceReasons": [
            "PLANNED_UPDATE",
            "PLANNED_NETWORK_UPDATE"
          ]
        }
      }
    },
    ...
  ]
}

Iniciar a manutenção manualmente

É possível iniciar manualmente a manutenção das suas reservas, blocos de reserva ou sub-blocos de reserva em vez de esperar o horário programado. Essa ação ajuda você a controlar de maneira mais proativa as interrupções nas suas cargas de trabalho.

Dependendo do estado de manutenção de uma reserva, bloco de reserva ou subbloco de reserva, o seguinte acontece:

Estado de manutenção	Descrição	O que você vê
Programado	O Compute Engine tem uma manutenção programada para a reserva. É possível iniciar a manutenção manualmente antes do horário programado.	No console Google Cloud , o estado da manutenção aparece como Pronto para execução - será executado em `DATE`. Na CLI gcloud ou na API REST, o Compute Engine define o campo `maintenanceStatus` como `PENDING`.
Em andamento	A manutenção está em andamento. Não é possível reagendar.	No console Google Cloud , o estado de manutenção aparece como Em execução. Na CLI gcloud ou na API REST, o Compute Engine define o campo `maintenanceStatus` como `ONGOING`.
Concluído	A manutenção foi concluída. O Compute Engine removeu todas as notificações de manutenção da instância.	No console Google Cloud , o estado de manutenção aparece como —. Na CLI gcloud ou na API REST, o campo `maintenanceStatus` não existe.

Para iniciar manualmente a manutenção em hosts específicos dentro de um bloco de reserva ou iniciar manualmente a manutenção em um subbloco de reserva, use a CLI gcloud ou a API REST. Caso contrário, selecione uma destas opções:

Console

No console do Google Cloud , acesse a página Reservas.

Acessar "Reservas"
Na coluna Nome, clique no nome de uma reserva. Uma página com os detalhes da reserva vai aparecer.
Clique em Executar manutenção e selecione uma das seguintes opções:
- Para iniciar a manutenção em todos os blocos, selecione Toda a capacidade.
- Para iniciar a manutenção apenas em blocos com instâncias em execução, selecione Capacidade em uso.
- Para iniciar a manutenção apenas em blocos não usados e blocos com instâncias interrompidas ou suspensas, selecione Capacidade não utilizada.
Para confirmar, clique em Ok.

gcloud

Para iniciar a manutenção em uma reserva, use o comando gcloud compute reservations perform-maintenance:

gcloud compute reservations perform-maintenance RESERVATION_NAME \
    --scope=RESERVATION_MAINTENANCE_SCOPE \
    --zone=ZONE

Para iniciar a manutenção em um bloco de reserva, use o comando gcloud compute reservations blocks perform-maintenance:

gcloud compute reservations blocks perform-maintenance RESERVATION_NAME \
    --block-name=BLOCK_NAME \
    --scope=BLOCK_MAINTENANCE_SCOPE \
    --zone=ZONE

Para iniciar a manutenção em um sub-bloco de reserva, use o comando gcloud compute reservations sub-blocks perform-maintenance:

gcloud compute reservations sub-blocks perform-maintenance RESERVATION_NAME \
    --block-name=BLOCK_NAME \
    --subblock-name=SUB_BLOCK_NAME \
    --zone=ZONE

Substitua:

RESERVATION_NAME: o nome da reserva.
RESERVATION_MAINTENANCE_SCOPE: o escopo de manutenção da reserva. Especifique um dos seguintes valores:
- Para iniciar a manutenção em todos os blocos: all
- Para iniciar a manutenção apenas em blocos com instâncias em execução: running
- Para iniciar a manutenção apenas em blocos não usados e blocos com instâncias interrompidas ou suspensas: unused
BLOCK_NAME: o nome de um bloco que existe na reserva.
SUB_BLOCK_NAME: o nome de um subbloco que existe no bloco de reserva.
BLOCK_MAINTENANCE_SCOPE: o escopo da manutenção para o bloco de reserva. Especifique um dos seguintes valores:
- Para iniciar a manutenção em todos os hosts: all
- Para iniciar a manutenção apenas em hosts com instâncias em execução: running
- Para iniciar a manutenção apenas em hosts não utilizados e hosts com instâncias interrompidas ou suspensas: unused
ZONE: a zona em que a reserva existe.

REST

Para iniciar a manutenção de uma reserva, faça uma solicitação POST para o método reservations.performMaintenance:

POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/reservations/RESERVATION_NAME/performMaintenance

{
  "maintenanceScope": "RESERVATION_MAINTENANCE_SCOPE"
}

Para iniciar a manutenção em um bloco de reserva, faça uma solicitação POST para o método reservationBlocks.performMaintenance:

POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/reservations/RESERVATION_NAME/reservationBlocks/BLOCK_NAME/performMaintenance

{
  "maintenanceScope": "BLOCK_MAINTENANCE_SCOPE"
}

Para iniciar a manutenção em um subbloco de reserva, faça uma solicitação POST para o método reservationSubBlocks.performMaintenance:

POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/reservations/RESERVATION_NAME/reservationBlocks/BLOCK_NAME/reservationSubBlocks/SUB_BLOCK_NAME/performMaintenance

{
  "maintenanceScope": "BLOCK_MAINTENANCE_SCOPE"
}

Substitua:

PROJECT_ID: o ID do projeto em que o Compute Engine criou automaticamente a reserva.
ZONE: a zona em que a reserva existe.
RESERVATION_NAME: o nome da reserva.
RESERVATION_MAINTENANCE_SCOPE: o escopo de manutenção da reserva. Especifique um dos seguintes valores:
- Para iniciar a manutenção em todos os blocos: ALL
- Para iniciar a manutenção apenas em blocos com instâncias em execução: RUNNING
- Para iniciar a manutenção apenas em blocos não usados e blocos com instâncias interrompidas ou suspensas: UNUSED
BLOCK_NAME: o nome de um bloco que existe na reserva.
SUB_BLOCK_NAME: o nome de um subbloco que existe no bloco de reserva.
BLOCK_MAINTENANCE_SCOPE: o escopo da manutenção para o bloco de reserva. Especifique um dos seguintes valores:
- Para iniciar a manutenção em todos os hosts: ALL
- Para iniciar a manutenção apenas em hosts com instâncias em execução: RUNNING
- Para iniciar a manutenção apenas em hosts não utilizados e hosts com instâncias interrompidas ou suspensas: UNUSED

Gerenciar notificações de manutenção de emergência de hardware

Depois que uma instância encontra um erro de host ou você informa que o host dela está com falha, ele precisa de manutenção de emergência e não planejada. Por padrão, o Compute Engine fornece algumas horas de aviso prévio ao programar esse tipo de manutenção. Para hosts reservados, é possível ativar as notificações de manutenção de emergência para aumentar esse período de aviso para pelo menos sete dias. Essa abordagem ajuda você a controlar de maneira mais proativa as interrupções nas suas cargas de trabalho.

Para ativar ou desativar as notificações de manutenção de emergência de hardware para uma reserva, selecione uma das seguintes opções:

gcloud

Para ativar as notificações de manutenção de emergência de hardware em uma reserva, use o comando gcloud compute reservations update com a flag --enable-emergent-maintenance:
```
gcloud compute reservations update RESERVATION_NAME \
    --enable-emergent-maintenance \
    --zone=ZONE
```
Para desativar as notificações de manutenção de emergência de hardware em uma reserva, use o comando gcloud compute reservations update com a flag --no-enable-emergent-maintenance:
```
gcloud compute reservations update RESERVATION_NAME \
    --no-enable-emergent-maintenance \
    --zone=ZONE
```

Substitua:

RESERVATION_NAME: o nome da reserva.
ZONE: a zona em que a reserva existe.

REST

Para ativar ou desativar as notificações de manutenção de emergência de hardware em uma reserva, faça uma solicitação PATCH para o método reservations.update. No URL da solicitação, inclua o parâmetro de consulta paths definido como enableEmergentMaintenance.

PATCH https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/reservations/RESERVATION_NAME?paths=enableEmergentMaintenance

{
  "name": "RESERVATION_NAME",
  "enableEmergentMaintenance": EMERGENCY_MAINTENANCE_NOTIFICATIONS
}

Substitua:

PROJECT_ID: o ID do projeto em que a reserva está.
ZONE: a zona em que a reserva existe.
RESERVATION_NAME: o nome da reserva.
EMERGENCY_MAINTENANCE_NOTIFICATIONS: especifique um dos seguintes valores:
- Para ativar as notificações: true
- Para desativar as notificações: false

A seguir

Para testar sua carga de trabalho após um evento de host, consulte Receitas de comparativo de mercado.
Para saber mais sobre o monitoramento de reservas, consulte Monitorar o consumo de reservas.

Gerenciar eventos de host em todas as reservas Mantenha tudo organizado com as coleções Salve e categorize o conteúdo com base nas suas preferências.

Antes de começar

Console

gcloud

REST

Funções exigidas

Permissões necessárias

Visão geral

Configurar alertas de notificação para reservas

Gerenciar a manutenção em todas as reservas

Ver o estado de manutenção

Console

gcloud

REST

Iniciar a manutenção manualmente

Console

gcloud

REST

Gerenciar notificações de manutenção de emergência de hardware

gcloud

REST

A seguir

Gerenciar eventos de host em todas as reservas