Iniciar manualmente un evento de mantenimiento del host

Organízate con las colecciones Guarda y clasifica el contenido según tus preferencias.

Esta página explica cómo iniciar manualmente un evento de mantenimiento del host en instancias compatibles de Compute Engine. Esta característica le permite iniciar un evento de mantenimiento para controlar el momento del mantenimiento de su instancia. Esto es útil para cargas de trabajo que podrían verse afectadas por un rendimiento degradado o tiempo de inactividad, para las cuales necesita que la ventana de mantenimiento comience en un momento específico.

Cuando inicia manualmente un evento de mantenimiento, el mantenimiento del host comienza inmediatamente. No puede especificar una fecha u hora para que comience el evento de mantenimiento. Si no utiliza esta función, el evento de mantenimiento se producirá a la hora indicada en la próxima notificación de mantenimiento .

Si desea probar primero cómo sus aplicaciones manejarán un evento de mantenimiento, puede simular un evento de mantenimiento .

Limitaciones

Puede iniciar manualmente un evento de mantenimiento del host para instancias que utilizan los siguientes tipos de máquinas:

• Familias de máquinas optimizadas para aceleradores :

  • Tipos de máquinas A3 Ultra con 8 GPU

  • Tipos de máquinas A3 Mega con 8 GPU

  • Tipos de máquinas A3 High con 8 GPU

  • Tipos de máquinas A3 Edge con 8 GPU

  • Tipos de máquinas A2 Ultra con 8 GPU

  • A2 Tipos de máquinas estándar con 8 o 16 GPU

  • Tipos de máquinas G2 con 8 GPU

• Familias de máquinas optimizadas para computación :

  • Tipos de máquinas H3 con 88 vCPUS

• Familias de máquinas de uso general :

  • Tipos de máquinas C4 con 192 vCPUS

  • Tipos de máquinas C4A con discos SSD locales conectados

  • Tipos de máquinas C3D con 360 vCPU o con discos SSD locales conectados

  • Tipos de máquinas C3 con 176 vCPUS o con discos SSD locales conectados

  • Instancias C3 bare metal con 192 vCPUS

• Familias de máquinas con memoria optimizada :

  • 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

• Familias de máquinas con almacenamiento optimizado :

  • Tipos de máquinas Z3 con 176 vCPU

Antes de comenzar

• Si aún no lo has hecho, configura la autenticación. La autenticación es el proceso mediante el cual se verifica su identidad para acceder a Google Cloud servicios y API. Para ejecutar código o muestras desde un entorno de desarrollo local, puedes autenticarte en Compute Engine seleccionando una de las siguientes opciones:
  

  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 las muestras de la API de REST en esta página en un entorno de desarrollo local, debes usar las credenciales que proporcionas a la CLI de gcloud.

  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 obtener más información, consulta Autentica para usar REST en la documentación de autenticación de Google Cloud .

Roles requeridos

Para obtener los permisos que necesita para administrar el mantenimiento de la máquina virtual, solicite a su administrador que le otorgue el rol de IAM de Administrador de instancia informática (v1) ( roles/compute.instanceAdmin.v1 ) en el proyecto. Para obtener más información sobre cómo otorgar roles, consulte Administrar el acceso a proyectos, carpetas y organizaciones .

Esta función predefinida contiene los permisos necesarios para gestionar el mantenimiento de la máquina virtual. Para ver los permisos exactos que se requieren, expanda la sección Permisos requeridos :

Es posible que también pueda obtener estos permisos con roles personalizados u otros roles predefinidos .

Iniciar manualmente un evento de mantenimiento del host

Compute Engine envía notificaciones sobre próximos eventos de mantenimiento mediante múltiples métodos. Utilizando la información de las notificaciones, puede determinar el período de tiempo durante el cual puede iniciar manualmente un evento de mantenimiento.

Consulta la información de notificación.

Puede encontrar las notificaciones de eventos de mantenimiento de la siguiente manera:

• Consultar sus instancias informáticas o servidor de metadatos
• Usando el registro en la nube

Si la notificación sobre un evento de mantenimiento del host contiene canReschedule=True y maintenanceStatus=Pending , entonces tiene la opción de iniciar el mantenimiento en el momento que elija o esperar a que el evento de mantenimiento tenga lugar a la hora especificada por windowStartTime .

Si no hay ninguna notificación e intenta iniciar manualmente un evento de mantenimiento, se muestra el siguiente mensaje:

There is no reschedulable upcoming maintenance.

Esto indica que no se ha programado ningún evento de mantenimiento y que no es necesario tomar ninguna medida.

Iniciar el evento de mantenimiento

Puede iniciar el mantenimiento del host en el momento que elija, en lugar de esperar la hora programada. Utilice Google Cloud CLI o REST para activar el evento de mantenimiento, que luego comienza inmediatamente.

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

¿Qué sigue?

• Aprenda a simular un evento de mantenimiento del host .
• Aprenda cómo recibir avisos de migración en vivo .
• Aprenda a configurar alertas para notificaciones de mantenimiento del host .