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 VM y soient exécutées ou non. Cette approche vous aide à minimiser les perturbations et à maintenir des performances optimales.
Avant de commencer
-
Si ce n'est pas déjà fait, configurez l'authentification.
L'authentification permet de valider votre identité pour accéder aux services et aux API Google Cloud . Pour exécuter du code ou des exemples depuis un environnement de développement local, vous pouvez vous authentifier auprès de Compute Engine en sélectionnant l'une des options suivantes :
Sélectionnez l'onglet correspondant à la façon dont vous prévoyez d'utiliser les exemples de cette page :
Console
Lorsque vous utilisez la console Google Cloud pour accéder aux services et aux API Google Cloud , vous n'avez pas besoin de configurer l'authentification.
gcloud
-
Installez la Google Cloud CLI. Une fois l'installation terminée, initialisez la Google Cloud CLI en exécutant la commande suivante :
gcloud initSi vous utilisez un fournisseur d'identité (IdP) externe, vous devez d'abord vous connecter à la gcloud CLI avec votre identité fédérée.
-
- Définissez une région et une zone par défaut.
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.
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 un accès en lecture seule aux journaux d'audit des événements système : Visionneuse 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.performMaintenancesur le projet -
Pour démarrer la maintenance de l'hôte pour un bloc de réservation :
compute.reservationBlocks.performMaintenancesur le projet- Pour afficher la liste des réservations :
Vous pouvez également obtenir ces autorisations avec des rôles personnalisés ou d'autres rôles prédéfinis.
Présentation
Pour optimiser la maintenance de vos blocs de capacité réservés, procédez comme suit :
Configurer des alertes de notification Créez des alertes basées sur les journaux pour être informé des événements de maintenance planifiés, démarrés ou terminés pour une réservation ou un 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érer la maintenance sur des blocs de capacité Affichez et, si nécessaire, démarrez manuellement la maintenance de vos réservations ou blocs de réservation. Ce processus vous aide à augmenter 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.
Pour en savoir plus sur la fréquence et le comportement de maintenance des types de machines H4D, consultez Expérience de maintenance pour les instances H4D.
Configurer des alertes de notification pour les réservations
Vous pouvez recevoir des notifications concernant les événements de maintenance planifiés, démarrés ou terminés pour une réservation ou un 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 ou d'un bloc de réservation, procédez comme suit. 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 journal 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 planifiée :
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 planifiée :
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"
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 qui correspondent à 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 :
Dans le champ Nom de la règle d'alerte, saisissez un nom pour la règle.
Dans la liste Niveau de gravité de la règle, sélectionnez Avertissement (ou un niveau de gravité plus élevé).
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 :
Dans la liste Délai entre les notifications, sélectionnez la fréquence à laquelle vous souhaitez être averti.
Dans la liste Durée de fermeture automatique des incidents, sélectionnez le délai après lequel Cloud Logging cesse d'envoyer des notifications et ferme automatiquement l'incident.
Cliquez sur Suivant.
Dans la section Qui doit être informé ?, spécifiez un canal de notification auquel Logging doit 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 et blocs de réservation comme suit :
Pour vérifier l'état et l'heure planifiée de la maintenance à venir pour vos réservations ou blocs de réservation, consultez l'état de maintenance.
Pour démarrer manuellement la maintenance d'une réservation ou d'un bloc de réservation, plutôt que 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 lorsque l'hôte d'une VM nécessite une maintenance d'urgence 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 ou d'un bloc de réservation en vérifiant la valeur du champ
upcomingGroupMaintenancedans les métadonnées de la réservation. Si une réservation ne comporte pas le champupcomingGroupMaintenance, aucune maintenance n'est planifiée pour la réservation ou le bloc de réservation. Pour en savoir plus sur les champs deupcomingGroupMaintenance, consultez Définitions des états de maintenance.De plus, si une maintenance est planifiée pour un bloc de réservation, le champ
upcomingGroupMaintenancecontient le champmaintenanceReasons. Ce champ décrit pourquoi la maintenance a été planifiée pour votre bloc de réservation, comme décrit dans le tableau suivant :Type de maintenance Motif de maintenance État des VM Maintenance planifiée pour la maintenance régulière PLANNED_UPDATE: maintenance planifiée de l'infrastructurePLANNED_NETWORK_UPDATE: maintenance planifiée du réseau
S'applique aux VM en cours d'exécution, arrêtées ou suspendues. Maintenance d'urgence non planifiée FAILURE_DISK: maintenance non planifiée programmée en raison d'une erreur sur un disque associé à une VM.FAILURE_INFRA: maintenance non planifiée programmée en raison d'une erreur au niveau de l'infrastructure.FAILURE_INTERFACE: maintenance non planifiée programmée en raison d'une erreur au niveau de la carte d'interface réseau.FAILURE_MEMORY: maintenance non planifiée programmée en raison d'une erreur liée à la mémoire d'une VM.FAILURE_NETWORK: maintenance non planifiée programmée en raison d'une erreur réseau.
S'applique uniquement aux VM en cours d'exécution. Pour afficher le champ
maintenanceReasonsdans un bloc ou un sous-bloc de réservation, 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.
Dans la colonne État de maintenance, Compute Engine affiche l'état de maintenance de vos réservations. Si vous ne voyez pas cette colonne 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 :
Dans la colonne Nom, cliquez sur le nom de la réservation. Une page indiquant les détails de la réservation s'affiche.
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 describeavec l'option--flattendéfinie surresourceStatus.reservationMaintenance:gcloud compute reservations describe RESERVATION_NAME \ --flatten=resourceStatus.reservationMaintenance \ --zone=ZONERemplacez 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 éléments suivants :
Si une maintenance est planifiée pour votre réservation, le résultat ressemble à 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
schedulingTypeest défini surINDEPENDENT, le champupcomingGroupMaintenancene contient pas les champswindowStartTimeetwindowEndTime.Si aucune maintenance n'est planifiée pour votre réservation, le résultat ressemble à ce qui suit :
--- schedulingType: GROUPED
Si une maintenance est planifiée pour votre réservation, utilisez la commande
gcloud compute reservations blocks listpour afficher l'état de maintenance des blocs de la réservation :gcloud compute reservations blocks list RESERVATION_NAME \ --zone=ZONESi une maintenance est planifiée ou en cours pour un bloc de réservation, le résultat ressemble à ce qui suit :
--- ... name: example-fr-h4d-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-h4d-dense-1-block-0002 ... schedulingType: GROUPED ...
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 d'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
fieldsdéfini suritems.name,items.specificReservation.instanceProperties.machineType,items.resourceStatus.reservationMaintenance.Pour filtrer uniquement par réservations qui spécifient un type de machine spécifique, incluez le paramètre de requête
filterdéfini surspecificReservation.instanceProperties.machineType:MACHINE_TYPEà l'aide de valeurs encodées au format URL.
Par exemple, pour afficher les réservations dans toutes les zones, envoyez une requête
GETcomme 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_TYPERemplacez les éléments suivants :
PROJECT_ID: ID du projet dans lequel se trouvent les réservations.MACHINE_TYPE: type de machine réservé par 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 davantage une liste de VM en définissant le paramètre de requête
filtersur une autre expression de filtre.Si une maintenance est planifiée pour votre réservation, envoyez une requête
GETà la méthodereservationBlocks.listpour afficher l'état de maintenance des blocs de la réservation. Dans l'URL de la requête, incluez le paramètre de requêtefieldsdéfini suritems.name,items.reservationMaintenance:GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/reservations/RESERVATION_NAME/reservationBlocks?fields=items.name,items.reservationMaintenanceRemplacez
RESERVATION_NAMEpar 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-h4d-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
schedulingTypeest défini surINDEPENDENTpour un bloc, le champupcomingGroupMaintenancene contient pas les champswindowStartTimeetwindowEndTime.
Démarrer manuellement la maintenance
Vous pouvez démarrer manuellement la maintenance de vos réservations ou blocs de réservation au lieu d'attendre l'heure programmée. Cette action vous aide à contrôler de manière plus proactive les interruptions de vos charges de travail.
Selon l'état de maintenance d'une réservation ou d'un bloc de réservation, les événements suivants se produisent :
État de maintenance Description Ce que vous voyez Programmée 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 est Prêt à s'exécuter : s'exécutera le DATE.
- Dans la gcloud CLI ou l'API REST, Compute Engine définit le champ
maintenanceStatussurPENDING.
En cours Cela signifie que l'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 la gcloud CLI ou l'API REST, Compute Engine définit le champ
maintenanceStatussurONGOING.
Terminé La maintenance est terminée. Compute Engine a supprimé toutes les notifications de maintenance de la VM. - Dans la console Google Cloud , l'état de maintenance est indiqué par —.
- Dans la gcloud CLI ou l'API REST, le champ
maintenanceStatusn'existe pas.
Pour démarrer manuellement la maintenance sur des hôtes spécifiques d'un 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.
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 démarrer la maintenance sur tous les blocs, sélectionnez Toute la capacité.
Pour démarrer la maintenance uniquement sur les blocs contenant des VM en cours d'exécution, sélectionnez Capacité utilisée.
Pour ne démarrer la maintenance que sur les blocs inutilisés et les blocs contenant des VM arrêtées ou suspendues, sélectionnez Capacité inutilisée.
Pour confirmer, cliquez sur OK.
gcloud
Pour démarrer la maintenance sur une réservation, utilisez la commande
gcloud compute reservations perform-maintenance:gcloud compute reservations perform-maintenance RESERVATION_NAME \ --scope=RESERVATION_MAINTENANCE_SCOPE \ --zone=ZONEPour démarrer la maintenance sur 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=ZONERemplacez 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 lancer la maintenance sur tous les blocs :
allPour démarrer la maintenance uniquement sur les blocs avec des VM en cours d'exécution :
runningPour démarrer la maintenance uniquement sur les blocs inutilisés et les blocs contenant des VM arrêtées ou suspendues :
unused
BLOCK_NAME: nom d'un bloc existant dans la 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 :
allPour démarrer la maintenance uniquement sur les hôtes avec des VM en cours d'exécution :
runningPour ne démarrer la maintenance que sur les hôtes inutilisés et les hôtes avec des VM 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éthodereservations.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 sur un bloc de réservation, envoyez une requête
POSTà la méthodereservationBlocks.performMaintenance:POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/reservations/RESERVATION_NAME/reservationBlocks/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 lancer la maintenance sur tous les blocs :
ALLPour démarrer la maintenance uniquement sur les blocs avec des VM en cours d'exécution :
RUNNINGPour démarrer la maintenance uniquement sur les blocs inutilisés et les blocs contenant des VM 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 :
ALLPour démarrer la maintenance uniquement sur les hôtes avec des VM en cours d'exécution :
RUNNINGPour ne démarrer la maintenance que sur les hôtes inutilisés et les hôtes avec des VM arrêtées ou suspendues :
UNUSED
Gérer les notifications de maintenance d'urgence du matériel
Lorsqu'une VM rencontre une erreur d'hôte ou que vous signalez son hôte comme défectueux, l'hôte de la VM nécessite une maintenance d'urgence non planifiée. Par défaut, Compute Engine envoie un avis préalable quelques heures avant de planifier 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 de préavis à au moins sept jours. Cette approche vous aide à contrôler de manière plus proactive les interruptions 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 updateavec le flag--enable-emergent-maintenance:gcloud compute reservations update RESERVATION_NAME \ --enable-emergent-maintenance \ --zone=ZONEPour désactiver les notifications de maintenance d'urgence du matériel pour une réservation, utilisez la commande
gcloud compute reservations updateavec 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éthodereservations.update. Dans l'URL de la requête, incluez le paramètre de requêtepathsdéfini surenableEmergentMaintenance.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 une des valeurs suivantes :Pour activer les notifications :
truePour désactiver les notifications :
false
Étapes suivantes
Découvrez la persistance des données des disques SSD locaux lors d'événements hôtes.
Découvrez comment effectuer une sauvegarde des données des disques SSD locaux pour les conserver.
Découvrez les définitions des états de maintenance lors de la surveillance des événements de maintenance de l'hôte.