Gestisci gli eventi sull'host nelle prenotazioni

Questo documento spiega come utilizzare le funzionalità di manutenzione dell'host disponibili in AI Hypercomputer. Spiega come monitorare, pianificare ed eseguire la manutenzione pianificata dei blocchi di capacità riservati. Per gestire la manutenzione delle istanze Compute Engine, consulta invece Gestire gli eventi host nelle istanze di calcolo.

Puoi gestire in modo proattivo i prossimi eventi di manutenzione dell'host sui blocchi di capacità riservati, indipendentemente dal fatto che le istanze siano in esecuzione o meno. Questo approccio ti aiuta a ridurre al minimo le interruzioni e a mantenere prestazioni ottimali.

Prima di iniziare

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

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

Installa Google Cloud CLI. Dopo l'installazione, inizializza Google Cloud CLI eseguendo il comando seguente:

gcloud init

Se utilizzi un provider di identità (IdP) esterno, devi prima accedere a gcloud CLI con la tua identità federata.

Per saperne di più, consulta Autenticati per usare REST nella documentazione sull'autenticazione di Google Cloud .

Ruoli obbligatori

Per ottenere le autorizzazioni necessarie per gestire gli eventi di manutenzione dell'host nelle prenotazioni, chiedi all'amministratore di concederti i seguenti ruoli IAM:

Compute Admin (roles/compute.admin) sul progetto
Per l'accesso di sola lettura agli audit log degli eventi di sistema: Logs Viewer (roles/logging.viewer) sul progetto

Per saperne di più sulla concessione dei ruoli, consulta Gestisci l'accesso a progetti, cartelle e organizzazioni.

Questi ruoli predefiniti contengono le autorizzazioni necessarie per gestire gli eventi di manutenzione degli host nelle prenotazioni. Per vedere quali sono esattamente le autorizzazioni richieste, espandi la sezione Autorizzazioni obbligatorie:

Autorizzazioni obbligatorie

Per gestire gli eventi di manutenzione dell'host nelle prenotazioni sono necessarie le seguenti autorizzazioni:

Per avviare la manutenzione dell'host per una prenotazione: compute.reservations.performMaintenance sul progetto
Per avviare la manutenzione dell'host per un blocco di prenotazione: compute.reservationBlocks.performMaintenance sul progetto
Per avviare la manutenzione dell'host per un blocco secondario di prenotazione: compute.reservationSubBlocks.performMaintenance sul progetto
Per visualizzare un elenco di prenotazioni: compute.reservations.list sul progetto
Per visualizzare i dettagli di una prenotazione: compute.reservations.get sul progetto
Per visualizzare un elenco di blocchi all'interno di una prenotazione: compute.reservationBlocks.list sul progetto
Per visualizzare un elenco di sottoblocchi all'interno di un blocco di prenotazione: compute.reservationSubBlocks.list sul progetto

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

Panoramica

Se non l'hai ancora fatto, consulta Comprendere e gestire la manutenzione dell'host.

Per ottimizzare la manutenzione dei blocchi di capacità riservata, completa i seguenti passaggi:

Configura gli avvisi di notifica. Crea avvisi basati su log per ricevere notifiche sugli eventi di manutenzione pianificati, avviati o completati per una prenotazione, un blocco di prenotazione o un sotto-blocco di prenotazione. Questo approccio ti aiuta a pianificare in modo proattivo le tue attività ed evitare tempi di inattività imprevisti.
Gestisci la manutenzione in blocchi di capacità. Visualizza e, se necessario, avvia manualmente la manutenzione per le prenotazioni, i blocchi di prenotazioni o i blocchi secondari di prenotazioni. Questo processo ti aiuta ad aumentare la resilienza dei tuoi workload agli errori dell'host, a prevenire i tempi di inattività e a garantire che le tue applicazioni rimangano disponibili.

Configurare gli avvisi di notifica per le prenotazioni

Puoi ricevere notifiche relative a eventi di manutenzione pianificati, avviati o completati per una prenotazione, un blocco di prenotazioni o un sotto-blocco di prenotazioni creando policy di avviso basate sui log.

Per creare un avviso per gli eventi di manutenzione di una prenotazione, un blocco di prenotazioni o un blocco secondario di prenotazioni, completa la seguente procedura. Ripeti questa procedura per ogni avviso che vuoi creare.

Nella console Google Cloud , vai alla pagina Esplora log:
Vai a Esplora log

Se utilizzi la barra di ricerca per trovare questa pagina, seleziona il risultato con il sottotitolo Logging.
Fai clic sul pulsante di attivazione/disattivazione Mostra query.

Nel riquadro Query, crea una delle seguenti query. Queste query filtrano le voci di log per identificare eventi di manutenzione specifici. Ripeti questa procedura per ogni query che vuoi creare.

Ricevere avvisi di manutenzione per una prenotazione:

Per ricevere avvisi quando è pianificata la manutenzione:

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

Per ricevere avvisi al termine della manutenzione:

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

Ricevere avvisi di manutenzione per un blocco di prenotazioni:

Per ricevere avvisi quando è pianificata la manutenzione:

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

Per ricevere avvisi all'inizio della manutenzione:

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

Per ricevere avvisi al termine della manutenzione:

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

Ricevere avvisi di manutenzione per un sottoblocco di prenotazione di istanze A4X Max o A4X:

Per ricevere avvisi quando è pianificata la manutenzione:

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

Per ricevere avvisi all'inizio della manutenzione:

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

Per ricevere avvisi al termine della manutenzione:

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

Per ricevere avvisi quando una macchina A4X Max o A4X rileva un errore e Compute Engine avvia la manutenzione:

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

Per ricevere avvisi al termine della manutenzione di una macchina A4X Max o A4X che ha riscontrato un errore:

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

Per convalidare la query, fai clic su Esegui query. Se la query è valida, il riquadro Risultati delle query mostra le voci di log che corrispondono alla query.
Nella barra degli strumenti dei risultati della query, fai clic sull'elenco Azioni e poi seleziona Crea avviso log. Viene visualizzato il riquadro Crea policy di avviso basata su log.
Nella sezione Dettagli avviso, segui questi passaggi:
1. Nel campo Nome criterio di avviso, inserisci un nome per il criterio.
2. Nell'elenco Livello di gravità della policy, seleziona Avviso (o un livello di gravità superiore).
3. Fai clic su Avanti.
Nella sezione Scegli i log da includere nell'avviso, fai clic su Avanti.
Nella sezione Imposta la frequenza delle notifiche e la durata della chiusura automatica, specifica quanto segue:
1. Nell'elenco Tempo tra le notifiche, seleziona la frequenza con cui vuoi ricevere le notifiche.
2. Nell'elenco Durata chiusura automatica incidenti, seleziona dopo quanto tempo Cloud Logging smette di inviare notifiche e chiude automaticamente l'incidente.
3. Fai clic su Avanti.
Nella sezione Chi dovrebbe ricevere le notifiche?, specifica un canale di notifica per Logging a cui inviare le notifiche.
Fai clic su Salva.

Gestire la manutenzione per le prenotazioni

Puoi visualizzare e controllare la manutenzione per le prenotazioni, i blocchi di prenotazioni e i sottoblocchi di prenotazioni nel seguente modo:

Per controllare lo stato e l'ora pianificata della manutenzione imminente per le tue prenotazioni, i blocchi di prenotazione o i sottoblocchi di prenotazione, visualizza lo stato della manutenzione.
Per avviare manualmente la manutenzione di una prenotazione, di un blocco di prenotazioni o di un blocco secondario di prenotazioni, anziché attendere la data e l'ora della manutenzione pianificata, avvia manualmente la manutenzione.
Per gestire l'anticipo con cui vuoi ricevere le notifiche quando l'host di un'istanza di computing richiede una manutenzione di emergenza non pianificata dopo un errore dell'host o un report dell'host difettoso, gestisci le notifiche di manutenzione di emergenza dell'hardware.

Visualizza lo stato di manutenzione

Puoi visualizzare lo stato della manutenzione imminente per una prenotazione, un blocco di prenotazioni o un sottoblocco di prenotazioni controllando il valore del campo upcomingGroupMaintenance nei relativi metadati. Se una prenotazione non ha il campo upcomingGroupMaintenance, non è pianificata alcuna manutenzione per la prenotazione, il blocco di prenotazioni o il blocco secondario di prenotazioni. Per saperne di più sui campi in upcomingGroupMaintenance, consulta Definizioni dello stato di manutenzione nella documentazione di Compute Engine.

Inoltre, se è prevista la manutenzione di un blocco o un sottoblocco di prenotazione, il campo upcomingGroupMaintenance contiene il campo maintenanceReasons. Questo campo descrive il motivo per cui è stata pianificata la manutenzione per il blocco o il sottoblocco di prenotazione, come descritto nella tabella seguente:

Tipo di manutenzione	Motivo della manutenzione	Stato dell'istanza di computing
Manutenzione pianificata dopo la segnalazione di un host difettoso	`FAILURE_GPU_CUSTOMER_REPORTED`	Si applica solo alle istanze in esecuzione sull'host che hai segnalato come difettoso.
Manutenzione pianificata per la manutenzione regolare	`PLANNED_UPDATE`: manutenzione pianificata dell'infrastruttura `PLANNED_NETWORK_UPDATE`: manutenzione di rete pianificata	Si applica alle istanze in esecuzione, arrestate o sospese.
Manutenzione di emergenza non pianificata	`FAILURE_DISK`: manutenzione non pianificata pianificata a causa di un errore con un disco collegato a un'istanza. `FAILURE_GPU`: manutenzione non pianificata pianificata a causa di un errore correlato alla GPU. `FAILURE_GPU_TEMPERATURE`: manutenzione non pianificata programmata a causa di un errore correlato alla GPU dopo che la GPU ha raggiunto una temperatura elevata. `FAILURE_GPU_XID`: manutenzione non pianificata dopo aver ricevuto un messaggio Xid a causa di un errore correlato alla GPU. `FAILURE_INFRA`: manutenzione non pianificata pianificata a causa di un errore dell'infrastruttura. `FAILURE_INTERFACE`: manutenzione non pianificata programmata a causa di un errore con la NIC. `FAILURE_MEMORY`: manutenzione non pianificata pianificata a causa di un errore nella memoria di un'istanza. `FAILURE_NETWORK`: manutenzione non pianificata programmata a causa di un errore di rete. `FAILURE_NVLINK`: manutenzione non pianificata programmata a causa di un errore con NVLink.	Si applica solo alle istanze in esecuzione.

Per visualizzare il campo maintenanceReasons in un blocco o un sottoblocco di prenotazione oppure per visualizzare lo stato di manutenzione di un sottoblocco, devi utilizzare gcloud CLI o l'API REST. Altrimenti, seleziona una delle seguenti opzioni:

Console

Nella console Google Cloud , vai alla pagina Prenotazioni.

Vai a Prenotazioni
Nella colonna Stato della manutenzione, Compute Engine mostra lo stato di manutenzione delle tue prenotazioni. Se non vedi questa colonna nella tabella Prenotazioni on demand, fai clic su Opzioni di visualizzazione delle colonne, seleziona la casella di controllo Stato manutenzione e poi fai clic su Ok.
Per visualizzare lo stato di manutenzione di un blocco di prenotazione, completa i seguenti passaggi:
1. Nella colonna Nome, fai clic sul nome della prenotazione. Viene visualizzata una pagina con i dettagli della prenotazione.
2. Nella tabella Blocchi, nella colonna Manutenzione, Compute Engine mostra lo stato di manutenzione dei blocchi all'interno della prenotazione.

gcloud

Per visualizzare lo stato di manutenzione di una prenotazione, utilizza il comando gcloud compute reservations describe con il flag --flatten impostato su resourceStatus.reservationMaintenance:
```
gcloud compute reservations describe RESERVATION_NAME \
    --flatten=resourceStatus.reservationMaintenance \
    --zone=ZONE
```
Sostituisci quanto segue:
- RESERVATION_NAME: il nome della prenotazione.
- ZONE: la zona in cui esiste la prenotazione.
L'output è simile a uno dei seguenti:
- Se per la prenotazione è pianificata la manutenzione, l'output è simile al seguente:
```
---
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'
```
  Se il campo schedulingType è impostato su INDEPENDENT, il campo upcomingGroupMaintenance non contiene i campi windowStartTime e windowEndTime. Per vedere quando è pianificata la manutenzione di un'istanza in esecuzione su un host riservato, visualizza lo stato di manutenzione dell'istanza.
- Se la manutenzione non è pianificata per la tua prenotazione, l'output è simile al seguente:
```
---
schedulingType: GROUPED
```

Se per la tua prenotazione è pianificata una manutenzione, per visualizzare lo stato di manutenzione dei blocchi all'interno della prenotazione, utilizza il comando gcloud compute reservations blocks list:

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

Se la manutenzione è pianificata o in corso per un blocco di prenotazione, l'output è simile al seguente:

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

Se è pianificata la manutenzione per un blocco di prenotazioni, per visualizzare lo stato di manutenzione dei sottoblocchi all'interno del blocco di prenotazioni, utilizza il comando gcloud compute reservations sub-blocks list:

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

Sostituisci BLOCK_NAME con il nome di un blocco esistente all'interno della prenotazione.

Se la manutenzione è pianificata o in corso per un sottoblocco di prenotazione, l'output è simile al seguente:

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

Per visualizzare lo stato di manutenzione delle tue prenotazioni, invia una richiesta GET a uno dei seguenti metodi:
- Per visualizzare le prenotazioni in tutte le zone, utilizza il metodo reservations.aggregatedList.
- Per visualizzare le prenotazioni in una zona specifica, utilizza il metodo reservations.list.
Nell'URL della richiesta, includi i seguenti parametri di ricerca:
- Per mostrare solo il nome, il tipo di macchina riservata e lo stato di manutenzione di una prenotazione, includi il parametro di query fields impostato su items.name,items.specificReservation.instanceProperties.machineType,items.resourceStatus.reservationMaintenance.
- Per filtrare solo in base alle prenotazioni che specificano un tipo di macchina specifico, includi il parametro di query filter impostato su specificReservation.instanceProperties.machineType:MACHINE_TYPE utilizzando valori codificati come URL.
Ad esempio, per visualizzare le prenotazioni in tutte le zone, invia una richiesta GET come segue:
```
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
```
Sostituisci quanto segue:
- PROJECT_ID: l'ID del progetto in cui esistono le prenotazioni.
- MACHINE_TYPE: il tipo di macchina riservata in base al quale vuoi filtrare le prenotazioni.
Se la manutenzione è pianificata o in corso per una prenotazione, l'output è simile al seguente:
```
{
  "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"
          }
        }
      }
    },
    ...
  ]
}
```
(Facoltativo) Per restringere ulteriormente un elenco di istanze di calcolo, imposta il parametro di query filter su un'espressione di filtro diversa.

Se è prevista la manutenzione della prenotazione, per visualizzare lo stato di manutenzione dei blocchi all'interno della prenotazione, invia una richiesta GET al metodo reservationBlocks.list. Nell'URL della richiesta, includi il parametro di query fields impostato su 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

Sostituisci RESERVATION_NAME con il nome della prenotazione.

Se la manutenzione è pianificata o in corso per un blocco di prenotazione, l'output è simile al seguente:

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

Se il campo schedulingType è impostato su INDEPENDENT per un blocco, il campo upcomingGroupMaintenance non contiene i campi windowStartTime e windowEndTime. Per vedere quando è pianificata la manutenzione per un'istanza in esecuzione su un blocco prenotato, visualizza lo stato di manutenzione dell'istanza.

Se è pianificata la manutenzione di un blocco di prenotazione, per visualizzare lo stato di manutenzione dei blocchi secondari all'interno del blocco di prenotazione, invia una richiesta GET al metodo reservationSubBlocks.list:

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

Sostituisci BLOCK_NAME con il nome di un blocco esistente all'interno della prenotazione.

Se la manutenzione è pianificata o in corso per un sottoblocco di prenotazione, l'output è simile al seguente:

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

Avviare manualmente la manutenzione

Puoi avviare manualmente la manutenzione per le prenotazioni, i blocchi di prenotazioni o i sottoblocchi di prenotazioni anziché attendere l'ora pianificata. Questa azione ti aiuta a controllare in modo più proattivo le interruzioni dei tuoi carichi di lavoro.

A seconda dello stato di manutenzione di una prenotazione, di un blocco di prenotazioni o di un blocco secondario di prenotazioni, si verifica quanto segue:

Stato di manutenzione	Descrizione	Cosa vedi
Pianificato	Compute Engine ha pianificato la manutenzione per la prenotazione. Puoi avviare manualmente la manutenzione prima dell'orario pianificato.	Nella console Google Cloud , lo stato della manutenzione viene visualizzato come Pronto per l'esecuzione - verrà eseguito il giorno `DATE`. In gcloud CLI o nell'API REST, Compute Engine imposta il campo `maintenanceStatus` su `PENDING`.
In corso	La manutenzione è in corso. Non puoi riprogrammarlo.	Nella console Google Cloud , lo stato della manutenzione viene visualizzato come In esecuzione. In gcloud CLI o nell'API REST, Compute Engine imposta il campo `maintenanceStatus` su `ONGOING`.
Completa	La manutenzione è terminata. Compute Engine ha rimosso tutte le notifiche di manutenzione dall'istanza.	Nella console Google Cloud , lo stato della manutenzione viene visualizzato come —. Nell'interfaccia alla gcloud CLI o nell'API REST, il campo `maintenanceStatus` non esiste.

Per avviare manualmente la manutenzione su host specifici all'interno di un blocco di prenotazione o avviare manualmente la manutenzione su un sottoblocco di prenotazione, utilizza gcloud CLI o l'API REST. Altrimenti, seleziona una delle seguenti opzioni:

Console

Nella console Google Cloud , vai alla pagina Prenotazioni.

Vai a Prenotazioni
Nella colonna Nome, fai clic sul nome di una prenotazione. Viene visualizzata una pagina con i dettagli della prenotazione.
Fai clic su Esegui manutenzione e seleziona una delle seguenti opzioni:
- Per avviare la manutenzione di tutti i blocchi, seleziona Tutta la capacità.
- Per avviare la manutenzione solo sui blocchi con istanze in esecuzione, seleziona Capacità in uso.
- Per avviare la manutenzione solo sui blocchi inutilizzati e sui blocchi con istanze arrestate o sospese, seleziona Capacità inutilizzata.
Per confermare, fai clic su Ok.

gcloud

Per avviare la manutenzione di una prenotazione, utilizza il comando gcloud compute reservations perform-maintenance:

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

Per avviare la manutenzione di un blocco di prenotazione, utilizza il 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

Per avviare la manutenzione di un sottoblocco di prenotazione, utilizza il 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

Sostituisci quanto segue:

RESERVATION_NAME: il nome della prenotazione.
RESERVATION_MAINTENANCE_SCOPE: l'ambito di manutenzione per la prenotazione. Specifica uno dei seguenti valori:
- Per avviare la manutenzione su tutti i blocchi: all
- Per avviare la manutenzione solo sui blocchi con istanze in esecuzione: running
- Per avviare la manutenzione solo sui blocchi inutilizzati e sui blocchi con istanze arrestate o sospese: unused
BLOCK_NAME: il nome di un blocco esistente all'interno della prenotazione.
SUB_BLOCK_NAME: il nome di un sottoblocco esistente all'interno del blocco di prenotazione.
BLOCK_MAINTENANCE_SCOPE: l'ambito di manutenzione per il blocco della prenotazione. Specifica uno dei seguenti valori:
- Per avviare la manutenzione su tutti gli host: all
- Per avviare la manutenzione solo sugli host con istanze in esecuzione: running
- Per avviare la manutenzione solo sugli host inutilizzati e sugli host con istanze arrestate o sospese: unused
ZONE: la zona in cui esiste la prenotazione.

REST

Per avviare la manutenzione di una prenotazione, invia una richiesta POST al metodo reservations.performMaintenance:

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

{
  "maintenanceScope": "RESERVATION_MAINTENANCE_SCOPE"
}

Per avviare la manutenzione di un blocco di prenotazioni, invia una richiesta POST al metodo 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"
}

Per avviare la manutenzione di un sottoblocco di prenotazione, invia una richiesta POST al metodo 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"
}

Sostituisci quanto segue:

PROJECT_ID: l'ID del progetto in cui Compute Engine ha creato automaticamente la prenotazione.
ZONE: la zona in cui esiste la prenotazione.
RESERVATION_NAME: il nome della prenotazione.
RESERVATION_MAINTENANCE_SCOPE: l'ambito di manutenzione per la prenotazione. Specifica uno dei seguenti valori:
- Per avviare la manutenzione su tutti i blocchi: ALL
- Per avviare la manutenzione solo sui blocchi con istanze in esecuzione: RUNNING
- Per avviare la manutenzione solo sui blocchi inutilizzati e sui blocchi con istanze arrestate o sospese: UNUSED
BLOCK_NAME: il nome di un blocco esistente all'interno della prenotazione.
SUB_BLOCK_NAME: il nome di un sottoblocco esistente all'interno del blocco di prenotazione.
BLOCK_MAINTENANCE_SCOPE: l'ambito di manutenzione per il blocco della prenotazione. Specifica uno dei seguenti valori:
- Per avviare la manutenzione su tutti gli host: ALL
- Per avviare la manutenzione solo sugli host con istanze in esecuzione: RUNNING
- Per avviare la manutenzione solo sugli host inutilizzati e sugli host con istanze arrestate o sospese: UNUSED

Gestire le notifiche di manutenzione di emergenza dell'hardware

Dopo che un'istanza rileva un errore host o che segnali il suo host come difettoso, l'host dell'istanza richiede una manutenzione di emergenza non pianificata. Per impostazione predefinita, Compute Engine fornisce un preavviso di alcune ore quando pianifica questo tipo di manutenzione. Per gli host riservati, puoi attivare le notifiche di manutenzione di emergenza per aumentare questo periodo di preavviso ad almeno sette giorni. Questo approccio ti aiuta a controllare in modo più proattivo le interruzioni dei tuoi carichi di lavoro.

Per attivare o disattivare le notifiche di manutenzione di emergenza hardware per una prenotazione, seleziona una delle seguenti opzioni:

gcloud

Per attivare le notifiche di manutenzione di emergenza dell'hardware per una prenotazione, utilizza il comando gcloud compute reservations update con il flag --enable-emergent-maintenance:
```
gcloud compute reservations update RESERVATION_NAME \
    --enable-emergent-maintenance \
    --zone=ZONE
```
Per disattivare le notifiche di manutenzione di emergenza dell'hardware per una prenotazione, utilizza il comando gcloud compute reservations update con il flag --no-enable-emergent-maintenance:
```
gcloud compute reservations update RESERVATION_NAME \
    --no-enable-emergent-maintenance \
    --zone=ZONE
```

Sostituisci quanto segue:

RESERVATION_NAME: il nome della prenotazione.
ZONE: la zona in cui esiste la prenotazione.

REST

Per attivare o disattivare le notifiche di manutenzione di emergenza hardware per una prenotazione, invia una richiesta PATCH al metodo reservations.update. Nell'URL della richiesta, includi il parametro di query paths impostato su 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
}

Sostituisci quanto segue:

PROJECT_ID: l'ID del progetto in cui esiste la prenotazione.
ZONE: la zona in cui esiste la prenotazione.
RESERVATION_NAME: il nome della prenotazione.
EMERGENCY_MAINTENANCE_NOTIFICATIONS: specifica uno dei seguenti valori:
- Per attivare le notifiche: true
- Per disattivare le notifiche: false

Passaggi successivi

Per testare il carico di lavoro dopo un evento host, consulta le ricette di benchmarking.
Per saperne di più sul monitoraggio delle prenotazioni, consulta Monitora l'utilizzo delle prenotazioni.

Gestisci gli eventi sull'host nelle prenotazioni Mantieni tutto organizzato con le raccolte Salva e classifica i contenuti in base alle tue preferenze.

Prima di iniziare

Console

gcloud

REST

Ruoli obbligatori

Autorizzazioni obbligatorie

Panoramica

Configurare gli avvisi di notifica per le prenotazioni

Gestire la manutenzione per le prenotazioni

Visualizza lo stato di manutenzione

Console

gcloud

REST

Avviare manualmente la manutenzione

Console

gcloud

REST

Gestire le notifiche di manutenzione di emergenza dell'hardware

gcloud

REST

Passaggi successivi

Gestisci gli eventi sull'host nelle prenotazioni