Avvia manualmente un evento di manutenzione dell'host

In questa pagina viene spiegato come avviare manualmente un evento di manutenzione dell'host sulle istanze Compute Engine supportate. Questa funzionalità ti consente di avviare un evento di manutenzione per controllare le tempistiche di manutenzione dell'istanza. Questo è utile per i workload che potrebbero essere interessati da prestazioni ridotte o tempi di inattività, per i quali è necessario che il periodo di manutenzione inizi a un'ora specifica.

Quando avvii manualmente un evento di manutenzione, la manutenzione dell'host inizia immediatamente. Non puoi specificare una data o un'ora di inizio per l'evento di manutenzione. Se non utilizzi questa funzionalità, l'evento di manutenzione avviene all'ora indicata nella notifica relativa alla manutenzione imminente.

Se vuoi prima testare il modo in cui le tue applicazioni gestiranno un evento di manutenzione, puoi simulare un evento di manutenzione.

Limitazioni

Puoi avviare manualmente un evento di manutenzione dell'host per le istanze che utilizzano i seguenti tipi di macchine:

Prima di iniziare

  • Se non l'hai ancora fatto, configura l'autenticazione. L'autenticazione è il processo di verifica dell'identità per poter accedere a Google Cloud servizi e API. Per eseguire codice o esempi da un ambiente di sviluppo locale, puoi autenticarti su Compute Engine selezionando una delle seguenti opzioni:

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

    gcloud

      1. After installing the Google Cloud CLI, initialize it by running the following command: 

        gcloud init

        If you're using an external identity provider (IdP), you must first sign in to the gcloud CLI with your federated identity.

      2. Set a default region and zone.

        3. REST

        Per utilizzare gli esempi di API REST in questa pagina in un ambiente di sviluppo locale, utilizzi le credenziali che fornisci a gcloud CLI.

          After installing the Google Cloud CLI, initialize it by running the following command: 

          gcloud init

          If you're using an external identity provider (IdP), you must first sign in to the gcloud CLI with your federated identity.

        Per saperne di più, consulta la sezione Autenticarsi per l'utilizzo di REST nella documentazione sull'autenticazione di Google Cloud .

Ruoli obbligatori

Per ottenere le autorizzazioni necessarie per gestire la manutenzione delle VM, chiedi all'amministratore di concederti il ruolo IAM Compute Instance Admin (v1) (roles/compute.instanceAdmin.v1) nel progetto. Per saperne di più sulla concessione dei ruoli, consulta Gestisci l'accesso a progetti, cartelle e organizzazioni.

Questo ruolo predefinito contiene le autorizzazioni necessarie per gestire la manutenzione delle VM. Per visualizzare le autorizzazioni obbligatorie corrette, espandi l'omonima sezione:

Autorizzazioni obbligatorie

Per gestire la manutenzione delle VM sono necessarie le seguenti autorizzazioni:

  • Per ottenere informazioni su un'istanza di computing: compute.instances.get

Potresti anche ottenere queste autorizzazioni con ruoli personalizzati o altri ruoli predefiniti.

Avvia manualmente un evento di manutenzione dell'host

Compute Engine invia notifiche per gli eventi di manutenzione imminenti con diversi metodi. Utilizzando le informazioni contenute nelle notifiche, puoi determinare il periodo di tempo in cui puoi avviare manualmente un evento di manutenzione.

Controlla le informazioni sulla notifica

Per trovare le notifiche relative agli eventi di manutenzione:

Se la notifica relativa a un evento di manutenzione dell'host contiene canReschedule=True e maintenanceStatus=Pending, puoi avviare la manutenzione al momento che preferisci oppure attendere che l'evento di manutenzione si verifichi nel momento specificato da windowStartTime.

Se non viene visualizzata alcuna notifica e provi ad avviare manualmente un evento di manutenzione, viene visualizzato il seguente messaggio:

There is no reschedulable upcoming maintenance.

Ciò indica che non è stato pianificato alcun evento di manutenzione e che non è richiesta alcuna azione.

Avvia l'evento di manutenzione

Puoi avviare la manutenzione dell'host in un momento a tua scelta, anziché attendere l'ora pianificata. Utilizza Google Cloud CLI o REST per attivare l'evento di manutenzione, che si avvia immediatamente.

gcloud

Per avviare un evento di manutenzione, utilizza il comando compute instances perform-maintenance. La manutenzione dell'host inizia immediatamente dopo l'inserimento del comando.

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

Sostituisci quanto segue:

  • INSTANCE_NAME: il nome dell'istanza di computing.
  • ZONE: la zona in cui risiede l'istanza.

La risposta è simile alla seguente:

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'

Nella risposta, canReschedule è impostato su false e maintenanceStatus su ONGOING, il che indica che l'operazione di manutenzione dell'host è in corso.

REST

Per avviare un evento di manutenzione, crea una richiesta POST utilizzando il metodo instances.performMaintenance.

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

Sostituisci quanto segue:

  • PROJECT_NAME: il nome del progetto
  • ZONE: la zona in cui risiede l'istanza di computing
  • INSTANCE_NAME: il nome dell'istanza

La risposta è simile alla seguente:

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

Nella risposta, canReschedule è impostato su false e maintenanceStatus su ONGOING, il che indica che l'operazione di manutenzione dell'host è in corso.

Passaggi successivi