Gérer les événements hôtes pour plusieurs réservations

Ce document explique comment utiliser les fonctionnalités de maintenance de l'hôte disponibles dans AI Hypercomputer. Il explique comment surveiller, planifier et effectuer la maintenance programmée de vos blocs de capacité réservés. Pour gérer la maintenance de vos instances Compute Engine, consultez plutôt Gérer les événements hôtes sur les instances de calcul.

Vous pouvez gérer de manière proactive les événements de maintenance de l'hôte à venir sur vos blocs de capacité réservés, que des instances y soient exécutées ou non. Cette approche vous permet de minimiser les perturbations et de maintenir des performances optimales.

Avant de commencer

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

Pour utiliser les exemples API REST de cette page dans un environnement de développement local, vous devez utiliser les identifiants que vous fournissez à la gcloud CLI.

Installez la Google Cloud CLI. Une fois que la Google Cloud CLI est installée, initialisez-la en exécutant la commande suivante :

gcloud init

Si vous utilisez un fournisseur d'identité (IdP) externe, vous devez d'abord vous connecter à la gcloud CLI avec votre identité fédérée.

Pour en savoir plus, consultez la section S'authentifier pour utiliser REST dans la documentation sur l'authentification Google Cloud .

Rôles requis

Pour obtenir les autorisations nécessaires pour gérer les événements de maintenance de l'hôte dans les réservations, demandez à votre administrateur de vous accorder les rôles IAM suivants :

Administrateur Compute (roles/compute.admin) sur le projet
Pour accéder en lecture seule aux journaux d'audit des événements système : Lecteur de journaux (roles/logging.viewer) sur le projet

Pour en savoir plus sur l'attribution de rôles, consultez Gérer l'accès aux projets, aux dossiers et aux organisations.

Ces rôles prédéfinis contiennent les autorisations requises pour gérer les événements de maintenance de l'hôte dans les réservations. Pour connaître les autorisations exactes requises, développez la section Autorisations requises :

Autorisations requises

Les autorisations suivantes sont requises pour gérer les événements de maintenance de l'hôte pour plusieurs réservations :

Pour démarrer la maintenance de l'hôte pour une réservation : compute.reservations.performMaintenance sur le projet
Pour démarrer la maintenance de l'hôte pour un bloc de réservation : compute.reservationBlocks.performMaintenance sur le projet
Pour démarrer la maintenance de l'hôte pour un sous-bloc de réservation : compute.reservationSubBlocks.performMaintenance sur le projet
Pour afficher la liste des réservations : compute.reservations.list sur le projet
Pour afficher les détails d'une réservation : compute.reservations.get sur le projet
Pour afficher la liste des blocs d'une réservation : compute.reservationBlocks.list sur le projet
Pour afficher la liste des sous-blocs d'un bloc de réservation : compute.reservationSubBlocks.list sur le projet

Vous pouvez également obtenir ces autorisations avec des rôles personnalisés ou d'autres rôles prédéfinis.

Présentation

Si vous ne l'avez pas déjà fait, consultez Comprendre et gérer la maintenance de l'hôte.

Pour optimiser la maintenance de vos blocs de capacité réservés, procédez comme suit :

Configurez des alertes de notification. Créez des alertes basées sur les journaux pour recevoir des notifications concernant les événements de maintenance planifiés, commencés ou terminés pour une réservation, un bloc de réservation ou un sous-bloc de réservation. Cette approche vous aide à planifier vos activités de manière proactive et à éviter les temps d'arrêt inattendus.
Gérez la maintenance sur des blocs de capacité. Affichez et, si nécessaire, démarrez manuellement la maintenance de vos réservations, blocs de réservation ou sous-blocs de réservation. Ce processus vous aide à accroître la résilience de vos charges de travail face aux erreurs d'hôte, à éviter les temps d'arrêt et à garantir la disponibilité de vos applications.

Configurer des alertes de notification pour les réservations

Vous pouvez recevoir des notifications concernant les événements de maintenance planifiés, en cours ou terminés pour une réservation, un bloc de réservation ou un sous-bloc de réservation en créant des règles d'alerte basées sur les journaux.

Pour créer une alerte pour les événements de maintenance d'une réservation, d'un bloc de réservation ou d'un sous-bloc de réservation, suivez la procédure ci-dessous. Répétez cette procédure pour chaque alerte que vous souhaitez créer.

Dans la console Google Cloud , accédez à la pageExplorateur de journaux :
Accéder à l'explorateur de journaux

Si vous utilisez la barre de recherche pour trouver cette page, sélectionnez le résultat dont le sous-titre est Logging.
Cliquez sur le bouton Afficher la requête pour l'activer.

Dans le volet Requête, créez l'une des requêtes suivantes. Ces requêtes filtrent les entrées de journaux pour identifier des événements de maintenance spécifiques. Répétez cette procédure pour chaque requête que vous souhaitez créer.

Recevoir des alertes de maintenance pour une réservation :

Pour recevoir des alertes lorsqu'une maintenance est prévue :

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

Pour recevoir des alertes lorsque la maintenance est terminée :

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

Recevoir des alertes de maintenance pour un bloc de réservation :

Pour recevoir des alertes lorsqu'une maintenance est prévue :

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

Pour recevoir des alertes lorsque la maintenance a commencé :

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

Pour recevoir des alertes lorsque la maintenance est terminée :

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

Recevoir des alertes de maintenance pour un sous-bloc de réservation d'instances A4X Max ou A4X :

Pour recevoir des alertes lorsqu'une maintenance est prévue :

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

Pour recevoir des alertes lorsque la maintenance a commencé :

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

Pour recevoir des alertes lorsque la maintenance est terminée :

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

Pour recevoir des alertes lorsqu'une machine A4X Max ou A4X rencontre une erreur et que Compute Engine lance la maintenance :

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

Pour recevoir des alertes lorsque la maintenance d'une machine A4X Max ou A4X ayant rencontré une erreur est terminée :

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

Pour valider la requête, cliquez sur Exécuter la requête. Si la requête est valide, le volet Résultats de la requête affiche les entrées de journal correspondant à la requête.
Dans la barre d'outils des résultats de la requête, cliquez sur la liste Actions, puis sélectionnez Créer une alerte de journal. Le volet Créer une règle d'alerte basée sur les journaux s'affiche.
Dans la section Détails de l'alerte, procédez comme suit :
1. Dans le champ Nom de la règle d'alerte, saisissez un nom pour la règle.
2. Dans la liste Niveau de gravité de la règle, sélectionnez Avertissement (ou un niveau de gravité supérieur).
3. Cliquez sur Suivant.
Dans la section Sélectionner les journaux à inclure dans l'alerte, cliquez sur Suivant.
Dans la section Définir la fréquence des notifications et le délai pour la fermeture automatique, spécifiez les éléments suivants :
1. Dans la liste Délai entre les notifications, sélectionnez la fréquence à laquelle vous souhaitez recevoir des notifications.
2. Dans la liste Durée de fermeture automatique des incidents, sélectionnez la durée au bout de laquelle Cloud Logging cesse d'envoyer des notifications et ferme automatiquement l'incident.
3. Cliquez sur Suivant.
Dans la section Qui doit être informé ?, spécifiez un canal de notification pour la journalisation afin d'envoyer des notifications.
Cliquez sur Enregistrer.

Gérer la maintenance des réservations

Vous pouvez afficher et contrôler la maintenance de vos réservations, blocs de réservation et sous-blocs de réservation comme suit :

Pour vérifier l'état et l'heure prévue de la maintenance à venir pour vos réservations, blocs de réservation ou sous-blocs de réservation, consultez l'état de la maintenance.
Pour démarrer manuellement la maintenance d'une réservation, d'un bloc de réservation ou d'un sous-bloc de réservation, au lieu d'attendre la date et l'heure de maintenance planifiées, démarrez manuellement la maintenance.
Pour gérer le délai de réception des notifications lorsqu'un hôte d'instance de calcul nécessite une maintenance d'urgence et non planifiée après une erreur d'hôte ou un rapport d'hôte défectueux, gérez les notifications de maintenance d'urgence du matériel.

Afficher l'état de maintenance

Vous pouvez afficher l'état de maintenance à venir d'une réservation, d'un bloc de réservation ou d'un sous-bloc de réservation en vérifiant la valeur du champ upcomingGroupMaintenance dans leurs métadonnées. Si une réservation ne comporte pas le champ upcomingGroupMaintenance, aucune maintenance n'est planifiée pour la réservation, le bloc de réservation ou le sous-bloc de réservation. Pour en savoir plus sur les champs de upcomingGroupMaintenance, consultez Définitions de l'état de maintenance dans la documentation Compute Engine.

De plus, si une maintenance est prévue pour un bloc ou un sous-bloc de réservation, le champ upcomingGroupMaintenance contient le champ maintenanceReasons. Ce champ décrit la raison pour laquelle une maintenance a été planifiée pour votre bloc ou sous-bloc de réservation, comme décrit dans le tableau suivant :

Type de maintenance	Motif de la maintenance	État de l'instance de calcul
Maintenance planifiée après signalement d'un hôte défectueux	`FAILURE_GPU_CUSTOMER_REPORTED`	Ne s'applique qu'aux instances qui s'exécutent sur l'hôte que vous avez signalé comme défectueux.
Maintenance planifiée pour la maintenance régulière	`PLANNED_UPDATE` : maintenance planifiée de l'infrastructure `PLANNED_NETWORK_UPDATE` : maintenance réseau planifiée	S'applique aux instances en cours d'exécution, arrêtées ou suspendues.
Maintenance d'urgence non planifiée	`FAILURE_DISK` : maintenance non planifiée prévue en raison d'une erreur avec un disque associé à une instance. `FAILURE_GPU` : maintenance non planifiée prévue en raison d'une erreur liée au GPU. `FAILURE_GPU_TEMPERATURE` : maintenance non planifiée prévue en raison d'une erreur liée au GPU après que celui-ci a atteint une température élevée. `FAILURE_GPU_XID` : maintenance non planifiée après avoir reçu un message Xid en raison d'une erreur liée au GPU. `FAILURE_INFRA` : maintenance non planifiée prévue en raison d'une erreur liée à l'infrastructure. `FAILURE_INTERFACE` : maintenance non planifiée prévue en raison d'une erreur avec la carte d'interface réseau. `FAILURE_MEMORY` : maintenance non planifiée prévue en raison d'une erreur de mémoire d'une instance. `FAILURE_NETWORK` : maintenance non planifiée prévue en raison d'une erreur avec le réseau. `FAILURE_NVLINK` : maintenance non planifiée prévue en raison d'une erreur avec NVLink.	Ne s'applique qu'aux instances en cours d'exécution.

Pour afficher le champ maintenanceReasons dans un bloc ou un sous-bloc de réservation, ou l'état de maintenance d'un sous-bloc, vous devez utiliser la gcloud CLI ou l'API REST. Sinon, sélectionnez l'une des options suivantes :

Console

Dans la console Google Cloud , accédez à la page Réservations.

Accéder à la page "Réservations"
Dans la colonne État de maintenance, Compute Engine affiche l'état de maintenance de vos réservations. Si cette colonne ne s'affiche pas dans le tableau Réservations à la demande, cliquez sur Options d'affichage des colonnes, cochez la case État de maintenance, puis cliquez sur OK.
Pour afficher l'état de maintenance d'un bloc de réservation, procédez comme suit :
1. Dans la colonne Nom, cliquez sur le nom de la réservation. Une page indiquant les détails de la réservation s'affiche.
2. Dans le tableau Blocs, dans la colonne Maintenance, Compute Engine affiche l'état de maintenance des blocs de la réservation.

gcloud

Pour afficher l'état de maintenance d'une réservation, utilisez la commande gcloud compute reservations describe avec l'option --flatten définie sur resourceStatus.reservationMaintenance :
```
gcloud compute reservations describe RESERVATION_NAME \
    --flatten=resourceStatus.reservationMaintenance \
    --zone=ZONE
```
Remplacez les éléments suivants :
- RESERVATION_NAME : nom de la réservation.
- ZONE : zone où se trouve la réservation.
Le résultat ressemble à l'un des exemples suivants :
- Si une maintenance est prévue pour votre réservation, le résultat est semblable à ce qui suit :
```
---
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 le champ schedulingType est défini sur INDEPENDENT, le champ upcomingGroupMaintenance ne contient pas les champs windowStartTime et windowEndTime. Pour savoir quand une opération de maintenance est prévue pour une instance exécutée sur un hôte réservé, affichez l'état de maintenance de l'instance.
- Si aucune maintenance n'est prévue pour votre réservation, le résultat ressemble à ce qui suit :
```
---
schedulingType: GROUPED
```

Si une maintenance est prévue pour votre réservation, utilisez la commande gcloud compute reservations blocks list pour afficher l'état de maintenance des blocs de la réservation :

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

Si une maintenance est planifiée ou en cours pour un bloc de réservation, le résultat ressemble à ce qui suit :

---
...
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 une maintenance est prévue pour un bloc de réservation, utilisez la commande gcloud compute reservations sub-blocks list pour afficher l'état de maintenance des sous-blocs du bloc de réservation :

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

Remplacez BLOCK_NAME par le nom d'un bloc existant dans la réservation.

Si une maintenance est planifiée ou en cours pour un sous-bloc de réservation, le résultat ressemble à ce qui suit :

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

Pour afficher l'état de maintenance de vos réservations, envoyez une requête GET à l'une des méthodes suivantes :
- Pour afficher les réservations dans toutes les zones, utilisez la méthode reservations.aggregatedList.
- Pour afficher les réservations dans une zone spécifique, utilisez la méthode reservations.list.
Dans l'URL de la requête, incluez les paramètres de requête suivants :
- Pour n'afficher que le nom, le type de machine réservé et l'état de maintenance d'une réservation, incluez le paramètre de requête fields défini sur items.name,items.specificReservation.instanceProperties.machineType,items.resourceStatus.reservationMaintenance.
- Pour filtrer uniquement les réservations qui spécifient un type de machine spécifique, incluez le paramètre de requête filter défini sur specificReservation.instanceProperties.machineType:MACHINE_TYPE en utilisant des valeurs encodées au format URL.
Par exemple, pour afficher les réservations dans toutes les zones, envoyez une requête GET comme suit :
```
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
```
Remplacez les éléments suivants :
- PROJECT_ID : ID du projet dans lequel se trouvent les réservations.
- MACHINE_TYPE : type de machine réservé selon lequel vous souhaitez filtrer vos réservations.
Si une maintenance est planifiée ou en cours pour une réservation, le résultat ressemble à ce qui suit :
```
{
  "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"
          }
        }
      }
    },
    ...
  ]
}
```
Vous pouvez également affiner une liste d'instances de calcul en définissant le paramètre de requête filter sur une autre expression de filtre.

Si une opération de maintenance est prévue pour votre réservation, envoyez une requête GET à la méthode reservationBlocks.list pour afficher l'état de maintenance des blocs de la réservation. Dans l'URL de la requête, incluez le paramètre de requête fields défini sur 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

Remplacez RESERVATION_NAME par le nom de la réservation.

Si une maintenance est planifiée ou en cours pour un bloc de réservation, le résultat ressemble à ce qui suit :

{
  "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 le champ schedulingType est défini sur INDEPENDENT pour un bloc, le champ upcomingGroupMaintenance ne contient pas les champs windowStartTime et windowEndTime. Pour savoir quand une opération de maintenance est prévue pour une instance qui s'exécute sur un bloc réservé, affichez l'état de maintenance de l'instance.

Si une maintenance est prévue pour un bloc de réservation, envoyez une requête GET à la méthode reservationSubBlocks.list pour afficher l'état de maintenance des sous-blocs du bloc de réservation :

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

Remplacez BLOCK_NAME par le nom d'un bloc existant dans la réservation.

Si une maintenance est planifiée ou en cours pour un sous-bloc de réservation, le résultat ressemble à ce qui suit :

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

Démarrer manuellement la maintenance

Vous pouvez démarrer manuellement la maintenance de vos réservations, blocs de réservations ou sous-blocs de réservations au lieu d'attendre l'heure programmée. Cette action vous permet de contrôler plus proactivement les perturbations de vos charges de travail.

Selon l'état de maintenance d'une réservation, d'un bloc de réservation ou d'un sous-bloc de réservation, les événements suivants se produisent :

État de maintenance	Description	Ce que vous voyez
Planifié	Compute Engine a planifié une maintenance pour la réservation. Vous pouvez démarrer manuellement la maintenance avant l'heure prévue.	Dans la console Google Cloud , l'état de maintenance s'affiche comme suit : Prêt à l'exécution – s'exécutera sur `DATE`. Dans gcloud CLI ou l'API REST, Compute Engine définit le champ `maintenanceStatus` sur `PENDING`.
En cours	Une opération de maintenance est en cours. Vous ne pouvez pas la reprogrammer.	Dans la console Google Cloud , l'état de maintenance est En cours d'exécution. Dans gcloud CLI ou l'API REST, Compute Engine définit le champ `maintenanceStatus` sur `ONGOING`.
Terminé	La maintenance est terminée. Compute Engine a supprimé toutes les notifications de maintenance de l'instance.	Dans la console Google Cloud , l'état de maintenance est indiqué par —. Dans gcloud CLI ou l'API REST, le champ `maintenanceStatus` n'existe pas.

Pour démarrer manuellement la maintenance sur des hôtes spécifiques d'un bloc de réservation ou sur un sous-bloc de réservation, utilisez la gcloud CLI ou l'API REST. Sinon, sélectionnez l'une des options suivantes :

Console

Dans la console Google Cloud , accédez à la page Réservations.

Accéder à la page "Réservations"
Dans la colonne Nom, cliquez sur le nom d'une réservation. Une page indiquant les détails de la réservation s'affiche.
Cliquez sur Exécuter la maintenance, puis sélectionnez l'une des options suivantes :
- Pour lancer la maintenance sur tous les blocs, sélectionnez Toute la capacité.
- Pour démarrer la maintenance uniquement sur les blocs avec des instances en cours d'exécution, sélectionnez Capacité utilisée.
- Pour lancer la maintenance uniquement sur les blocs inutilisés et ceux dont les instances sont arrêtées ou suspendues, sélectionnez Capacité inutilisée.
Pour confirmer, cliquez sur OK.

gcloud

Pour démarrer la maintenance d'une réservation, utilisez la commande gcloud compute reservations perform-maintenance :

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

Pour démarrer la maintenance d'un bloc de réservation, utilisez la commande gcloud compute reservations blocks perform-maintenance :

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

Pour démarrer la maintenance d'un sous-bloc de réservation, utilisez la commande 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

Remplacez les éléments suivants :

RESERVATION_NAME : nom de la réservation.
RESERVATION_MAINTENANCE_SCOPE : champ d'application de la maintenance pour la réservation. Spécifiez une des valeurs suivantes :
- Pour démarrer la maintenance sur tous les blocs : all
- Pour démarrer la maintenance uniquement sur les blocs avec des instances en cours d'exécution : running
- Pour lancer la maintenance uniquement sur les blocs inutilisés et ceux dont les instances sont arrêtées ou suspendues : unused
BLOCK_NAME : nom d'un bloc existant dans la réservation.
SUB_BLOCK_NAME : nom d'un sous-bloc existant dans le bloc de réservation.
BLOCK_MAINTENANCE_SCOPE : champ d'application de la maintenance pour le bloc de réservation. Spécifiez une des valeurs suivantes :
- Pour démarrer la maintenance sur tous les hôtes : all
- Pour démarrer la maintenance uniquement sur les hôtes avec des instances en cours d'exécution : running
- Pour démarrer la maintenance uniquement sur les hôtes inutilisés et ceux dont les instances sont arrêtées ou suspendues : unused
ZONE : zone où se trouve la réservation.

REST

Pour démarrer la maintenance d'une réservation, envoyez une requête POST à la méthode reservations.performMaintenance :

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

{
  "maintenanceScope": "RESERVATION_MAINTENANCE_SCOPE"
}

Pour démarrer la maintenance d'un bloc de réservation, envoyez une requête POST à la méthode 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"
}

Pour démarrer la maintenance d'un sous-bloc de réservation, envoyez une requête POST à la méthode 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"
}

Remplacez les éléments suivants :

PROJECT_ID : ID du projet dans lequel Compute Engine a créé automatiquement la réservation.
ZONE : zone où se trouve la réservation.
RESERVATION_NAME : nom de la réservation.
RESERVATION_MAINTENANCE_SCOPE : champ d'application de la maintenance pour la réservation. Spécifiez une des valeurs suivantes :
- Pour démarrer la maintenance sur tous les blocs : ALL
- Pour démarrer la maintenance uniquement sur les blocs avec des instances en cours d'exécution : RUNNING
- Pour lancer la maintenance uniquement sur les blocs inutilisés et ceux dont les instances sont arrêtées ou suspendues : UNUSED
BLOCK_NAME : nom d'un bloc existant dans la réservation.
SUB_BLOCK_NAME : nom d'un sous-bloc existant dans le bloc de réservation.
BLOCK_MAINTENANCE_SCOPE : champ d'application de la maintenance pour le bloc de réservation. Spécifiez une des valeurs suivantes :
- Pour démarrer la maintenance sur tous les hôtes : ALL
- Pour démarrer la maintenance uniquement sur les hôtes avec des instances en cours d'exécution : RUNNING
- Pour démarrer la maintenance uniquement sur les hôtes inutilisés et ceux dont les instances sont arrêtées ou suspendues : UNUSED

Gérer les notifications de maintenance d'urgence du matériel

Lorsqu'une instance rencontre une erreur d'hôte ou que vous signalez que son hôte est défectueux, l'hôte de l'instance nécessite une maintenance d'urgence et non planifiée. Par défaut, Compute Engine envoie un avis préalable de quelques heures lorsqu'il planifie ce type de maintenance. Pour les hôtes réservés, vous pouvez activer les notifications de maintenance d'urgence afin de porter ce délai à au moins sept jours. Cette approche vous permet de contrôler de manière plus proactive les perturbations de vos charges de travail.

Pour activer ou désactiver les notifications de maintenance d'urgence du matériel pour une réservation, sélectionnez l'une des options suivantes :

gcloud

Pour activer les notifications de maintenance d'urgence du matériel pour une réservation, utilisez la commande gcloud compute reservations update avec l'option --enable-emergent-maintenance :
```
gcloud compute reservations update RESERVATION_NAME \
    --enable-emergent-maintenance \
    --zone=ZONE
```
Pour désactiver les notifications de maintenance d'urgence du matériel pour une réservation, utilisez la commande gcloud compute reservations update avec l'option --no-enable-emergent-maintenance :
```
gcloud compute reservations update RESERVATION_NAME \
    --no-enable-emergent-maintenance \
    --zone=ZONE
```

Remplacez les éléments suivants :

RESERVATION_NAME : nom de la réservation.
ZONE : zone où se trouve la réservation.

REST

Pour activer ou désactiver les notifications de maintenance d'urgence du matériel pour une réservation, envoyez une requête PATCH à la méthode reservations.update. Dans l'URL de la requête, incluez le paramètre de requête paths défini sur 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
}

Remplacez les éléments suivants :

PROJECT_ID : ID du projet dans lequel se trouve la réservation.
ZONE : zone où se trouve la réservation.
RESERVATION_NAME : nom de la réservation.
EMERGENCY_MAINTENANCE_NOTIFICATIONS : spécifiez l'une des valeurs suivantes :
- Pour activer les notifications : true
- Pour désactiver les notifications : false

Étapes suivantes

Pour tester votre charge de travail après un événement hôte, consultez Recettes de benchmarking.
Pour en savoir plus sur la surveillance des réservations, consultez Surveiller la consommation des réservations.

Gérer les événements hôtes pour plusieurs réservations Restez organisé à l'aide des collections Enregistrez et classez les contenus selon vos préférences.

Avant de commencer

Console

gcloud

REST

Rôles requis

Autorisations requises

Présentation

Configurer des alertes de notification pour les réservations

Gérer la maintenance des réservations

Afficher l'état de maintenance

Console

gcloud

REST

Démarrer manuellement la maintenance

Console

gcloud

REST

Gérer les notifications de maintenance d'urgence du matériel

gcloud

REST

Étapes suivantes

Gérer les événements hôtes pour plusieurs réservations