Démarrer manuellement un événement de maintenance de l'hôte

Cette page explique comment démarrer manuellement un événement de maintenance de l'hôte sur les instances Compute Engine prises en charge. Cette fonctionnalité vous permet de démarrer un événement de maintenance afin de contrôler la périodicité de la maintenance de votre instance. Cela s'avère utile pour les charges de travail susceptibles de subir une dégradation des performances ou un temps d'arrêt, et pour lesquelles vous avez besoin que l'intervalle de maintenance commence à une heure spécifique.

Lorsque vous démarrez manuellement un événement de maintenance, l'événement de maintenance de l'hôte commence immédiatement. Vous ne pouvez pas spécifier de date ni d'heure de début pour cet événement de maintenance. Si vous n'utilisez pas cette fonctionnalité, l'événement de maintenance se produit à l'heure indiquée dans la notification de maintenance à venir.

Si vous souhaitez d'abord tester la façon dont vos applications gèrent un événement de maintenance, vous pouvez simuler un événement de maintenance.

Limites

Vous pouvez démarrer manuellement un événement de maintenance de l'hôte pour les instances qui utilisent les types de machines suivants :

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 :

    Select the tab for how you plan to use the samples on this page:

    gcloud

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

    2. Set a default region and zone.

    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 la maintenance des VM, demandez à votre administrateur de vous attribuer le rôle IAM Administrateur d'instances Compute (v1) (roles/compute.instanceAdmin.v1) 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.

Ce rôle prédéfini contient les autorisations requises pour gérer la maintenance des VM. Pour connaître les autorisations exactes requises, développez la section Autorisations requises :

Autorisations requises

Les autorisations suivantes sont requises pour gérer la maintenance des VM :

  • Pour obtenir des informations sur une instance de calcul : compute.instances.get

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

Démarrer manuellement un événement de maintenance de l'hôte

Compute Engine envoie des notifications pour les événements de maintenance à venir de différentes façons. À l'aide des informations contenues dans ces notifications, vous pouvez déterminer la période pendant laquelle vous pouvez démarrer manuellement un événement de maintenance.

Passer en revue les informations contenues dans les notifications

Vous pouvez trouver vos notifications d'événement de maintenance :

Si la notification concernant un événement de maintenance de l'hôte contient canReschedule=True et maintenanceStatus=Pending, vous avez la possibilité de démarrer la maintenance à l'heure de votre choix ou d'attendre que l'événement de maintenance ait lieu à l'heure spécifiée par windowStartTime.

Si vous ne recevez aucune notification et que vous essayez de démarrer manuellement un événement de maintenance, le message suivant s'affiche :

There is no reschedulable upcoming maintenance.

Ce message indique qu'aucun événement de maintenance n'a été planifié et qu'aucune action n'est censée être entreprise.

Démarrer l'événement de maintenance

Vous pouvez démarrer la maintenance de l'hôte à l'heure de votre choix, plutôt que d'attendre l'heure programmée. Utilisez la Google Cloud CLI ou REST pour déclencher l'événement de maintenance, qui démarre alors immédiatement.

gcloud

Pour démarrer un événement de maintenance, utilisez la commande compute instances perform-maintenance. La maintenance de l'hôte commence immédiatement après la saisie de la commande.

gcloud compute instances perform-maintenance INSTANCE_NAME \
    --zone=ZONE

Remplacez les éléments suivants :

  • INSTANCE_NAME : nom de l'instance de calcul
  • ZONE : zone dans laquelle se trouve l'instance

La réponse ressemble à ce qui suit :

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'

Dans la réponse, canReschedule est défini sur false et maintenanceStatus sur ONGOING, ce qui indique que l'opération de maintenance de l'hôte est en cours.

REST

Pour démarrer un événement de maintenance, envoyez une requête POST à l'aide de la méthode instances.performMaintenance.

POST: https://compute.googleapis.com/compute/v1/projects/PROJECT_NAME/zones/ZONE/instances/INSTANCE_NAME/performMaintenance

Remplacez les éléments suivants :

  • PROJECT_NAME : nom du projet
  • ZONE : zone dans laquelle réside l'instance de calcul
  • INSTANCE_NAME : nom de l'instance

La réponse ressemble à ce qui suit :

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

Dans la réponse, canReschedule est défini sur false et maintenanceStatus sur ONGOING, ce qui indique que l'opération de maintenance de l'hôte est en cours.

Étapes suivantes