Cómo iniciar un evento de mantenimiento del host de forma manual

En esta página, se explica cómo iniciar de forma manual un evento de mantenimiento del host en instancias compatibles de Compute Engine. Esta función te permite iniciar un evento de mantenimiento para controlar el tiempo del mantenimiento de tu instancia. Esto es útil para las cargas de trabajo que podrían verse afectadas por la degradación del rendimiento o el tiempo de inactividad, para las que necesitas que el período de mantenimiento comience a una hora específica.

Cuando inicias manualmente un evento de mantenimiento, el mantenimiento del host comienza de inmediato. No puedes especificar una fecha ni una hora para que comience el evento de mantenimiento. Si no usas esta función, el evento de mantenimiento se produce en el momento indicado en la notificación de mantenimiento próximo.

Si primero quieres probar cómo tus aplicaciones controlarán un evento de mantenimiento, puedes simular un evento de mantenimiento.

Limitaciones

Puedes iniciar manualmente un evento de mantenimiento de host para las instancias que usan los siguientes tipos de máquinas:

• Familias de máquinas con optimización de acelerador:

  • Tipos de máquinas A3 Ultra con 8 GPUs

  • Tipos de máquinas A3 Mega con 8 GPUs

  • Tipos de máquinas A3 High con 8 GPUs

  • Tipos de máquinas A3 Edge con 8 GPUs

  • Tipos de máquinas A2 Ultra con 8 GPUs

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

  • Tipos de máquinas G2 con 8 GPUs

• Familias de máquinas optimizadas para procesamiento:

  • Tipos de máquinas H3 con 88 CPUs virtuales

• Familias de máquinas de uso general:

  • Tipos de máquinas C4 con 192 o 288 CPU virtuales, o con discos SSD locales conectados (versión preliminar)

  • Instancias de Bare Metal C4 con 288 CPUs virtuales (vista previa)

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

  • Tipos de máquinas C4D con 384 CPUs virtuales o con discos SSD locales conectados

  • Instancias de Bare Metal C4D con 384 CPUs virtuales (vista previa)

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

  • Instancias de Bare Metal C3 con 192 CPUs virtuales

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

• Familias de máquinas con optimización de memoria:

  • 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 optimizadas para el almacenamiento:

  • Tipos de máquinas Z3

Antes de comenzar

• Si aún no lo hiciste, configura la autenticación. La autenticación es el proceso mediante el cual se verifica tu identidad para acceder a los servicios y las APIs de Google Cloud . 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.

  Si deseas obtener más información, consulta Autentica para usar REST en la Google Cloud documentación de autenticación.

Roles obligatorios

Para obtener los permisos que necesitas para administrar el mantenimiento de VM, pídele a tu administrador que te otorgue el rol de IAM Administrador de instancias de Compute (v1) (roles/compute.instanceAdmin.v1) en el proyecto. Para obtener más información sobre cómo otorgar roles, consulta Administra el acceso a proyectos, carpetas y organizaciones.

Este rol predefinido contiene los permisos necesarios para administrar el mantenimiento de las VM. Para ver los permisos exactos que son necesarios, expande la sección Permisos requeridos:

También puedes obtener estos permisos con roles personalizados o con otros roles predefinidos.

Inicia manualmente un evento de mantenimiento del host

Compute Engine envía notificaciones sobre los próximos eventos de mantenimiento a través de varios métodos. Con la información de las notificaciones, puedes determinar el período en el que puedes iniciar manualmente un evento de mantenimiento.

Verifica la información de la notificación

Puedes encontrar las notificaciones de eventos de mantenimiento de una de las siguientes maneras:

• Consultar tus instancias de procesamiento o el servidor de metadatos
• Usa Cloud Logging

Si la notificación sobre un evento de mantenimiento del host contiene canReschedule=True y maintenanceStatus=Pending, tienes la opción de iniciar el mantenimiento en el momento que elijas o esperar a que se realice el evento de mantenimiento en el momento especificado por windowStartTime.

Si no hay una notificación y, luego, intentas iniciar manualmente un evento de mantenimiento, se mostrará el siguiente mensaje:

There is no reschedulable upcoming maintenance.

Este mensaje indica que no se programó ningún evento de mantenimiento y que no es necesario realizar ninguna acción.

Inicia el evento de mantenimiento

Puedes iniciar el mantenimiento del host en el momento que elijas, en lugar de esperar a la hora programada. Usa Google Cloud CLI o REST para activar el evento de mantenimiento, que se iniciará de inmediato.

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?

• Aprende a simular un evento de mantenimiento de host.
• Obtén información para obtener avisos de migración en vivo.
• Obtén más información para configurar alertas para las notificaciones de mantenimiento del host.