Administra los eventos del host en todas las reservas

En este documento, se explica cómo usar las funciones de mantenimiento del host disponibles en AI Hypercomputer. En él, se explica cómo supervisar, planificar y realizar el mantenimiento programado de tus bloques de capacidad reservados. Para administrar el mantenimiento de tus instancias de Compute Engine, consulta Administra los eventos del host en todas las instancias de procesamiento.

Puedes administrar de forma proactiva los próximos eventos de mantenimiento del host en tus bloques de capacidad reservados, ya sea que las instancias se ejecuten en ellos o no. Este enfoque te ayuda a minimizar las interrupciones y mantener un rendimiento óptimo.

Antes de comenzar

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

Instala Google Cloud CLI. Después de la instalación, inicializa Google Cloud CLI con el siguiente comando:

gcloud init

Si usas un proveedor de identidad externo (IdP), primero debes acceder a la gcloud CLI con tu identidad federada.

Para obtener más información, consulta Autentícate para usar REST en la documentación de autenticación de Google Cloud .

Roles obligatorios

Para obtener los permisos que necesitas para administrar los eventos de mantenimiento del host en todas las reservas, pídele a tu administrador que te otorgue los siguientes roles de IAM:

Administrador de Compute (roles/compute.admin) en el proyecto
Para obtener acceso de solo lectura a los registros de auditoría de eventos del sistema: Visualizador de registros (roles/logging.viewer) en el proyecto

Para obtener más información sobre cómo otorgar roles, consulta Administra el acceso a proyectos, carpetas y organizaciones.

Estos roles predefinidos contienen los permisos necesarios para administrar los eventos de mantenimiento del host en todas las reservas. Para ver los permisos exactos que son necesarios, expande la sección Permisos requeridos:

Permisos necesarios

Se requieren los siguientes permisos para administrar los eventos de mantenimiento del host en todas las reservas:

Para iniciar el mantenimiento del host de una reserva, haz lo siguiente: compute.reservations.performMaintenance en el proyecto
Para iniciar el mantenimiento del host de un bloque de reserva, usa compute.reservationBlocks.performMaintenance en el proyecto.
Para iniciar el mantenimiento del host en un subbloque de reserva, usa compute.reservationSubBlocks.performMaintenance en el proyecto.
Para ver una lista de reservas: compute.reservations.list en el proyecto
Para ver los detalles de una reserva: compute.reservations.get en el proyecto
Para ver una lista de los bloques dentro de una reserva: compute.reservationBlocks.list en el proyecto
Para ver una lista de los subbloques dentro de un bloque de reserva: compute.reservationSubBlocks.list en el proyecto

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

Descripción general

Si aún no lo hiciste, consulta Cómo comprender y controlar el mantenimiento del host.

Para optimizar el mantenimiento de tus bloques de capacidad reservados, completa los siguientes pasos:

Configura alertas de notificación. Crea alertas basadas en registros para recibir notificaciones sobre eventos de mantenimiento programados, iniciados o completados de una reserva, un bloque de reserva o un subbloque de reserva. Este enfoque te ayuda a planificar tus actividades de forma proactiva y evitar tiempos de inactividad inesperados.
Administra el mantenimiento en todos los bloques de capacidad. Consulta y, si es necesario, inicia de forma manual el mantenimiento en tus reservas, bloques de reservas o subbloques de reservas. Este proceso te ayuda a aumentar la resiliencia de tus cargas de trabajo ante errores del host, evitar el tiempo de inactividad y garantizar que tus aplicaciones permanezcan disponibles.

Configura alertas de notificación para las reservaciones

Puedes recibir notificaciones sobre eventos de mantenimiento programados, iniciados o completados para una reserva, un bloque de reserva o un subbloque de reserva creando políticas de alertas basadas en registros.

Para crear una alerta sobre los eventos de mantenimiento de una reserva, un bloque de reserva o un subbloque de reserva, completa el siguiente procedimiento. Repite este procedimiento para cada alerta que desees crear.

En la consola de Google Cloud , ve a la página Explorador de registros del :
Ir al Explorador de registros

Si usas la barra de búsqueda para encontrar esta página, selecciona el resultado cuyo subtítulo es Logging.
Haz clic en el botón de activación Mostrar consulta.

En el panel Consulta, crea una de las siguientes consultas. Estas consultas filtran las entradas de registro para identificar eventos de mantenimiento específicos. Repite este procedimiento para cada búsqueda que quieras crear.

Recibe alertas de mantenimiento para una reserva:

Para recibir alertas cuando se programe el mantenimiento, haz lo siguiente:

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

Para recibir alertas cuando se complete el mantenimiento, sigue estos pasos:

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

Recibe alertas de mantenimiento para un bloque de reserva:

Para recibir alertas cuando se programe el mantenimiento, haz lo siguiente:

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

Para recibir alertas cuando comience el mantenimiento, haz lo siguiente:

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

Para recibir alertas cuando se complete el mantenimiento, sigue estos pasos:

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

Recibe alertas de mantenimiento para un subbloque de reserva de instancias A4X Max o A4X:

Para recibir alertas cuando se programe el mantenimiento, haz lo siguiente:

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

Para recibir alertas cuando comience el mantenimiento, haz lo siguiente:

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

Para recibir alertas cuando se complete el mantenimiento, sigue estos pasos:

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

Para recibir alertas cuando una máquina A4X Max o A4X encuentre un error y Compute Engine inicie el mantenimiento, haz lo siguiente:

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

Para recibir alertas cuando se complete el mantenimiento de una máquina A4X Max o A4X que tuvo un error, sigue estos pasos:

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

Para validar la consulta, haz clic en Ejecutar consulta. Si la consulta es válida, en el panel Resultados de la consulta, se muestran las entradas de registro que coinciden con la consulta.
En la barra de herramientas de Resultados de la consulta, haz clic en la lista Acciones y, luego, selecciona Crear alerta de registro. Aparecerá el panel Crear política de alertas basada en registros.
En la sección Detalles de la alerta, haz lo siguiente:
1. En el campo Nombre de la política de alertas, ingresa un nombre para la política.
2. En la lista Nivel de gravedad de la política, selecciona Advertencia (o un nivel de gravedad más alto).
3. Haz clic en Siguiente.
En la sección Elige registros para incluir en el alerta, haz clic en Siguiente.
En la sección Establecer la frecuencia de notificación y la duración del cierre automático, especifica lo siguiente:
1. En la lista Tiempo entre notificaciones, selecciona la frecuencia con la que deseas recibir notificaciones.
2. En la lista Duración del cierre automático de incidentes, selecciona después de cuánto tiempo Cloud Logging dejará de enviar notificaciones y cerrará automáticamente el incidente.
3. Haz clic en Siguiente.
En la sección ¿Quiénes deben recibir notificaciones?, especifica un canal de notificaciones para que Logging envíe notificaciones.
Haz clic en Guardar.

Administra el mantenimiento en todas las reservas

Puedes ver y controlar el mantenimiento de tus reservas, bloques de reserva y subbloques de reserva de la siguiente manera:

Para verificar el estado y la hora programada del próximo mantenimiento de tus reservas, bloques de reserva o subbloques de reserva, consulta el estado de mantenimiento.
Para iniciar de forma manual el mantenimiento en una reserva, un bloque de reserva o un subbloque de reserva, en lugar de esperar la fecha y hora programadas, inicia el mantenimiento de forma manual.
Para administrar con cuánta anticipación deseas recibir notificaciones cuando el host de una instancia de procesamiento requiere mantenimiento de emergencia no planificado después de un error de host o un informe de host defectuoso, administra las notificaciones de mantenimiento de emergencia del hardware.

Cómo ver el estado de mantenimiento

Puedes consultar el estado del próximo mantenimiento de una reserva, un bloque de reserva o un subbloque de reserva. Para ello, verifica el valor del campo upcomingGroupMaintenance en sus metadatos. Si una reserva no tiene el campo upcomingGroupMaintenance, no se programa mantenimiento para la reserva, el bloque de reserva o el subbloque de reserva. Para obtener más información sobre los campos en upcomingGroupMaintenance, consulta Definiciones de estado de mantenimiento en la documentación de Compute Engine.

Además, si se programa mantenimiento para un bloque o subbloque de reserva, el campo upcomingGroupMaintenance contiene el campo maintenanceReasons. En este campo, se describe por qué se programó el mantenimiento para tu bloque o subbloque de reserva, como se describe en la siguiente tabla:

Tipo de mantenimiento	Motivo del mantenimiento	Estado de la instancia de procesamiento
Mantenimiento planificado después de un informe de host defectuoso	`FAILURE_GPU_CUSTOMER_REPORTED`	Solo se aplica a las instancias que se ejecutan en el host que informaste como defectuoso.
Mantenimiento planificado para el mantenimiento habitual	`PLANNED_UPDATE`: Mantenimiento planificado de la infraestructura `PLANNED_NETWORK_UPDATE`: Mantenimiento de red planificado	Se aplica a las instancias en ejecución, detenidas o suspendidas.
Mantenimiento de emergencia imprevisto	`FAILURE_DISK`: Mantenimiento no planificado programado debido a un error con un disco conectado a una instancia. `FAILURE_GPU`: Mantenimiento no planificado programado debido a un error relacionado con la GPU. `FAILURE_GPU_TEMPERATURE`: Mantenimiento no planificado programado debido a un error relacionado con la GPU después de que esta alcanzara una temperatura alta. `FAILURE_GPU_XID`: Mantenimiento no planificado después de que recibiste un mensaje de Xid debido a un error relacionado con la GPU. `FAILURE_INFRA`: Mantenimiento no planificado programado debido a un error en la infraestructura. `FAILURE_INTERFACE`: Mantenimiento no planificado programado debido a un error con la NIC. `FAILURE_MEMORY`: Mantenimiento no planificado programado debido a un error con la memoria de una instancia. `FAILURE_NETWORK`: Mantenimiento no planificado programado debido a un error en la red. `FAILURE_NVLINK`: Mantenimiento no planificado programado debido a un error con NVLink.	Solo se aplica a las instancias en ejecución.

Para ver el campo maintenanceReasons en un bloque o subbloque de reserva, o bien para ver el estado de mantenimiento de un subbloque, debes usar gcloud CLI o la API de REST. De lo contrario, selecciona una de las siguientes opciones:

Console

En la consola de Google Cloud , ve a la página Reservas.

Ir a Reservas
En la columna Estado de mantenimiento, Compute Engine muestra el estado de mantenimiento de tus reservas. Si no ves esta columna en la tabla Reservaciones a pedido, haz clic en Opciones de visualización de columnas, selecciona la casilla de verificación Estado de mantenimiento y, luego, haz clic en Aceptar.
Para ver el estado de mantenimiento de un bloque de reserva, completa los siguientes pasos:
1. En la columna Nombre, haz clic en el nombre de la reserva. Aparecerá una página con los detalles de la reserva.
2. En la tabla Bloques, en la columna Mantenimiento, Compute Engine muestra el estado de mantenimiento de los bloques dentro de la reserva.

gcloud

Para ver el estado de mantenimiento de una reserva, usa el comando gcloud compute reservations describe con la marca --flatten establecida en resourceStatus.reservationMaintenance:
```
gcloud compute reservations describe RESERVATION_NAME \
    --flatten=resourceStatus.reservationMaintenance \
    --zone=ZONE
```
Reemplaza lo siguiente:
- RESERVATION_NAME por el nombre de la reserva.
- ZONE: Es la zona en la que existe la reserva.
El resultado es similar a uno de los siguientes:
- Si se programó mantenimiento para tu reserva, el resultado es similar al siguiente:
```
---
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'
```
  Si el campo schedulingType está establecido en INDEPENDENT, el campo upcomingGroupMaintenance no contiene los campos windowStartTime ni windowEndTime. Para ver cuándo está programado el mantenimiento de una instancia que se ejecuta en un host reservado, consulta el estado de mantenimiento de la instancia.
- Si no hay mantenimiento programado para tu reserva, el resultado es similar al siguiente:
```
---
schedulingType: GROUPED
```

Si se programó mantenimiento para tu reserva, usa el comando gcloud compute reservations blocks list para ver el estado de mantenimiento de los bloques dentro de la reserva:

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

Si se programó o está en curso el mantenimiento de un bloque de reserva, el resultado será similar al siguiente:

---
...
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
...

Si se programó mantenimiento para un bloque de reserva, usa el comando gcloud compute reservations sub-blocks list para ver el estado de mantenimiento de los subbloques dentro del bloque de reserva:

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

Reemplaza BLOCK_NAME por el nombre de un bloque que existe dentro de la reserva.

Si hay mantenimiento programado o en curso para un subbloque de reserva, el resultado es similar al siguiente:

...
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 ver el estado de mantenimiento de tus reservas, haz una solicitud GET a uno de los siguientes métodos:
- Para ver las reservas en todas las zonas, usa el método reservations.aggregatedList.
- Para ver las reservas en una zona específica, usa el método reservations.list.
En la URL de la solicitud, incluye los siguientes parámetros de consulta:
- Para mostrar solo el nombre, el tipo de máquina reservado y el estado de mantenimiento de una reserva, incluye el parámetro de consulta fields establecido en items.name,items.specificReservation.instanceProperties.machineType,items.resourceStatus.reservationMaintenance.
- Para filtrar solo por las reservas que especifican un tipo de máquina específico, incluye el parámetro de consulta filter establecido en specificReservation.instanceProperties.machineType:MACHINE_TYPE con valores codificados como URL.
Por ejemplo, para ver las reservas en todas las zonas, realiza una solicitud GET de la siguiente manera:
```
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
```
Reemplaza lo siguiente:
- PROJECT_ID: Es el ID del proyecto en el que existen las reservas.
- MACHINE_TYPE: Es el tipo de máquina reservada por el que deseas filtrar tus reservas.
Si hay mantenimiento programado o en curso para una reserva, el resultado es similar al siguiente:
```
{
  "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"
          }
        }
      }
    },
    ...
  ]
}
```
De forma opcional, para limitar aún más una lista de instancias de procesamiento, establece el parámetro de consulta filter en una expresión de filtro diferente.

Si se programó mantenimiento para tu reserva, para ver el estado de mantenimiento de los bloques dentro de la reserva, realiza una solicitud GET al método reservationBlocks.list. En la URL de la solicitud, incluye el parámetro de consulta fields configurado 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

Reemplaza RESERVATION_NAME por el nombre de la reserva.

Si se programó o está en curso el mantenimiento de un bloque de reserva, el resultado será similar al siguiente:

{
  "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"
          ]
        }
      }
    },
    ...
  ]
}

Si el campo schedulingType está establecido en INDEPENDENT para un bloque, el campo upcomingGroupMaintenance no contiene los campos windowStartTime ni windowEndTime. Para ver cuándo se programó el mantenimiento de una instancia que se ejecuta en un bloque reservado, consulta el estado de mantenimiento de la instancia.

Si se programó mantenimiento para un bloque de reserva, para ver el estado de mantenimiento de los subbloques dentro del bloque de reserva, realiza una solicitud GET al método reservationSubBlocks.list:

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

Reemplaza BLOCK_NAME por el nombre de un bloque que existe dentro de la reserva.

Si hay mantenimiento programado o en curso para un subbloque de reserva, el resultado es similar al siguiente:

{
  "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"
          ]
        }
      }
    },
    ...
  ]
}

Inicia el mantenimiento de forma manual

Puedes iniciar de forma manual el mantenimiento de tus reservas, bloques de reservas o subbloques de reservas en lugar de esperar la hora programada. Esta acción te ayuda a controlar de forma más proactiva las interrupciones en tus cargas de trabajo.

Según el estado de mantenimiento de una reserva, un bloque de reserva o un subbloque de reserva, sucede lo siguiente:

Estado de mantenimiento	Descripción	Lo que se muestra
Programado	Compute Engine tiene un mantenimiento programado para la reserva. Puedes iniciar el mantenimiento de forma manual antes de la hora programada.	En la consola de Google Cloud , el estado de mantenimiento se muestra como Listo para ejecutarse: Se ejecutará el `DATE`. En gcloud CLI o la API de REST, Compute Engine establece el campo `maintenanceStatus` en `PENDING`.
En curso	El mantenimiento está en curso. No puedes reprogramarlo.	En la consola de Google Cloud , el estado de mantenimiento se muestra comoEn ejecución. En gcloud CLI o la API de REST, Compute Engine establece el campo `maintenanceStatus` en `ONGOING`.
Completado	Se completó el mantenimiento. Compute Engine quitó todas las notificaciones de mantenimiento de la instancia.	En la consola de Google Cloud , el estado de mantenimiento se muestra como—. En gcloud CLI o la API de REST, no existe el campo `maintenanceStatus`.

Para iniciar el mantenimiento de forma manual en hosts específicos dentro de un bloque de reserva o iniciar el mantenimiento de forma manual en un subbloque de reserva, usa gcloud CLI o la API de REST. De lo contrario, selecciona una de las siguientes opciones:

Console

En la consola de Google Cloud , ve a la página Reservas.

Ir a Reservas
En la columna Nombre, haz clic en el nombre de una reserva. Aparecerá una página con los detalles de la reserva.
Haz clic en Ejecutar mantenimiento y, luego, selecciona una de las siguientes opciones:
- Para iniciar el mantenimiento en todos los bloques, selecciona Toda la capacidad.
- Para iniciar el mantenimiento solo en los bloques con instancias en ejecución, selecciona Capacidad en uso.
- Para iniciar el mantenimiento solo en los bloques sin usar y en los bloques con instancias detenidas o suspendidas, selecciona Capacidad sin usar.
Para confirmar, haz clic en Aceptar.

gcloud

Para iniciar el mantenimiento de una reserva, usa el comando gcloud compute reservations perform-maintenance:

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

Para iniciar el mantenimiento en un bloque de reserva, usa el 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 el mantenimiento en un subbloque de reserva, usa el 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

Reemplaza lo siguiente:

RESERVATION_NAME por el nombre de la reserva.
RESERVATION_MAINTENANCE_SCOPE: Es el alcance del mantenimiento de la reserva. Especifica uno de los siguientes valores:
- Para iniciar el mantenimiento en todos los bloques, ejecuta all.
- Para iniciar el mantenimiento solo en los bloques con instancias en ejecución: running
- Para iniciar el mantenimiento solo en los bloques sin usar y en los bloques con instancias detenidas o suspendidas, usa unused.
BLOCK_NAME: Es el nombre de un bloque que existe dentro de la reserva.
SUB_BLOCK_NAME: Es el nombre de un subbloque que existe dentro del bloque de reserva.
BLOCK_MAINTENANCE_SCOPE: Es el alcance del mantenimiento para el bloque de reserva. Especifica uno de los siguientes valores:
- Para iniciar el mantenimiento en todos los hosts, ejecuta el siguiente comando: all
- Para iniciar el mantenimiento solo en los hosts con instancias en ejecución, haz lo siguiente: running
- Para iniciar el mantenimiento solo en los hosts no utilizados y en los hosts con instancias detenidas o suspendidas, haz lo siguiente: unused
ZONE: Es la zona en la que existe la reserva.

REST

Para iniciar el mantenimiento de una reserva, realiza una solicitud POST al 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 el mantenimiento en un bloque de reserva, realiza una solicitud POST al 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 el mantenimiento en un subbloque de reserva, realiza una solicitud POST al 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"
}

Reemplaza lo siguiente:

PROJECT_ID: Es el ID del proyecto en el que Compute Engine creó automáticamente la reserva.
ZONE: Es la zona en la que existe la reserva.
RESERVATION_NAME por el nombre de la reserva.
RESERVATION_MAINTENANCE_SCOPE: Es el alcance del mantenimiento de la reserva. Especifica uno de los siguientes valores:
- Para iniciar el mantenimiento en todos los bloques, ejecuta ALL.
- Para iniciar el mantenimiento solo en los bloques con instancias en ejecución: RUNNING
- Para iniciar el mantenimiento solo en los bloques sin usar y en los bloques con instancias detenidas o suspendidas, usa UNUSED.
BLOCK_NAME: Es el nombre de un bloque que existe dentro de la reserva.
SUB_BLOCK_NAME: Es el nombre de un subbloque que existe dentro del bloque de reserva.
BLOCK_MAINTENANCE_SCOPE: Es el alcance del mantenimiento para el bloque de reserva. Especifica uno de los siguientes valores:
- Para iniciar el mantenimiento en todos los hosts, ejecuta el siguiente comando: ALL
- Para iniciar el mantenimiento solo en los hosts con instancias en ejecución, haz lo siguiente: RUNNING
- Para iniciar el mantenimiento solo en los hosts no utilizados y en los hosts con instancias detenidas o suspendidas, haz lo siguiente: UNUSED

Administra las notificaciones de mantenimiento de emergencia del hardware

Después de que una instancia encuentra un error de host o informas que su host es defectuoso, el host de la instancia requiere mantenimiento de emergencia no planificado. De forma predeterminada, Compute Engine proporciona un aviso con algunas horas de anticipación cuando programa este tipo de mantenimiento. En el caso de los hosts reservados, puedes habilitar las notificaciones de mantenimiento de emergencia para aumentar este período de aviso a al menos siete días. Este enfoque te ayuda a controlar de forma más proactiva las interrupciones en tus cargas de trabajo.

Para habilitar o inhabilitar las notificaciones de mantenimiento de emergencia del hardware para una reserva, selecciona una de las siguientes opciones:

gcloud

Para habilitar las notificaciones de mantenimiento de emergencia del hardware para una reserva, usa el comando gcloud compute reservations update con la marca --enable-emergent-maintenance:
```
gcloud compute reservations update RESERVATION_NAME \
    --enable-emergent-maintenance \
    --zone=ZONE
```
Para inhabilitar las notificaciones de mantenimiento de emergencia del hardware para una reserva, usa el comando gcloud compute reservations update con la marca --no-enable-emergent-maintenance:
```
gcloud compute reservations update RESERVATION_NAME \
    --no-enable-emergent-maintenance \
    --zone=ZONE
```

Reemplaza lo siguiente:

RESERVATION_NAME por el nombre de la reserva.
ZONE: Es la zona en la que existe la reserva.

REST

Para habilitar o inhabilitar las notificaciones de mantenimiento de emergencia del hardware para una reserva, haz una solicitud PATCH al método reservations.update. En la URL de la solicitud, incluye el parámetro de consulta paths configurado 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
}

Reemplaza lo siguiente:

PROJECT_ID: Es el ID del proyecto en el que existe la reserva.
ZONE: Es la zona en la que existe la reserva.
RESERVATION_NAME por el nombre de la reserva.
EMERGENCY_MAINTENANCE_NOTIFICATIONS: Especifica uno de los siguientes valores:
- Para habilitar las notificaciones, haz lo siguiente: true
- Para inhabilitar las notificaciones, sigue estos pasos: false

¿Qué sigue?

Para probar tu carga de trabajo después de un evento del host, consulta las recetas de comparativas.
Para obtener más información sobre la supervisión de reservas, consulta Supervisa el consumo de reservas.

Administra los eventos del host en todas las reservas Organiza tus páginas con colecciones Guarda y categoriza el contenido según tus preferencias.

Antes de comenzar

Console

gcloud

REST

Roles obligatorios

Permisos necesarios

Descripción general

Configura alertas de notificación para las reservaciones

Administra el mantenimiento en todas las reservas

Cómo ver el estado de mantenimiento

Console

gcloud

REST

Inicia el mantenimiento de forma manual

Console

gcloud

REST

Administra las notificaciones de mantenimiento de emergencia del hardware

gcloud

REST

¿Qué sigue?

Administra los eventos del host en todas las reservas