UpcomingMaintenance

JSON representation
MaintenanceType
MaintenanceStatus
MaintenanceReason

Upcoming Maintenance notification information.

JSON representation

JSON representation
{ "type": enum (`MaintenanceType`), "canReschedule": boolean, "windowStartTime": string, "windowEndTime": string, "latestWindowStartTime": string, "maintenanceStatus": enum (`MaintenanceStatus`), "maintenanceOnShutdown": boolean, "maintenanceReasons": [ enum (`MaintenanceReason`) ] }

{
  "type": enum (MaintenanceType),
  "canReschedule": boolean,
  "windowStartTime": string,
  "windowEndTime": string,
  "latestWindowStartTime": string,
  "maintenanceStatus": enum (MaintenanceStatus),
  "maintenanceOnShutdown": boolean,
  "maintenanceReasons": [
    enum (MaintenanceReason)
  ]
}

Fields
`type`	`enum (MaintenanceType)` Defines the type of maintenance. Available from 2026-03-01..
`canReschedule`	`boolean` Indicates if the maintenance can be customer triggered. Available from 2026-03-01..
`windowStartTime`	`string` The current start time of the maintenance window. This timestamp value is in RFC3339 text format. Available from 2026-03-01..
`windowEndTime`	`string` The time by which the maintenance disruption will be completed. This timestamp value is in RFC3339 text format. Available from 2026-03-01..
`latestWindowStartTime`	`string` The latest time for the planned maintenance window to start. This timestamp value is in RFC3339 text format. Available from 2026-03-01..
`maintenanceStatus`	`enum (MaintenanceStatus)` Available from 2026-03-01..
`maintenanceOnShutdown`	`boolean` Indicates whether the UpcomingMaintenance will be triggered on VM shutdown. Available from 2026-03-01..
`maintenanceReasons[]`	`enum (MaintenanceReason)` The reasons for the maintenance. Only valid for vms. Available from 2026-03-01..

MaintenanceType

Enums
`UNKNOWN_TYPE`	No type specified. Do not use this value. Available from 2026-03-01..
`SCHEDULED`	Scheduled maintenance (e.g. maintenance after uptime guarantee is complete). Available from 2026-03-01..
`UNSCHEDULED`	Unscheduled maintenance (e.g. emergency maintenance during uptime guarantee). Available from 2026-03-01..
`MULTIPLE`	Multiple maintenance types in one window. This is only intended to be used for groups. Available from 2026-03-01..

MaintenanceStatus

Enums

Enums
`UNKNOWN`	Unknown maintenance status. Do not use this value. Available from 2026-03-01..
`PENDING`	There is pending maintenance. Available from 2026-03-01..
`ONGOING`	There is ongoing maintenance on this VM. Available from 2026-03-01..

UNKNOWN

Unknown maintenance status. Do not use this value.

Available from 2026-03-01..

PENDING

There is pending maintenance.

Available from 2026-03-01..

ONGOING

There is ongoing maintenance on this VM.

Available from 2026-03-01..

MaintenanceReason

Enums
`MAINTENANCE_REASON_UNKNOWN`	Unknown maintenance reason. Do not use this value. Available from 2026-03-01..
`FAILURE_GPU_XID`	Maintenance due to GPU xid failure. Available from 2026-03-01..
`FAILURE_NVLINK`	Maintenance due to NVLink failure. Available from 2026-03-01..
`FAILURE_GPU_TEMPERATURE`	Maintenance due to high GPU temperature. Available from 2026-03-01..
`INFRASTRUCTURE_RELOCATION`	Maintenance due to infrastructure relocation. Available from 2026-03-01..
`FAILURE_MEMORY`	Maintenance due to memory errors. Available from 2026-03-01..
`FAILURE_NETWORK`	Maintenance due to network errors. Available from 2026-03-01..
`FAILURE_GPU`	Maintenance due to GPU errors. Available from 2026-03-01..
`FAILURE_DISK`	Maintenance due to disk errors. Available from 2026-03-01..
`FAILURE_INFRA`	Maintenance due to infrastructure errors. Available from 2026-03-01..
`FAILURE_INTERFACE`	Maintenance due to interface errors. Available from 2026-03-01..
`PLANNED_NETWORK_UPDATE`	Maintenance due to planned network update. Available from 2026-03-01..
`PLANNED_UPDATE`	Maintenance due to planned update to the instance. Available from 2026-03-01..
`FAILURE_REDUNDANT_HARDWARE_FAULT`	Maintenance due to redundant hardware fault. Available from 2026-03-01..
`FAILURE_TPU`	Maintenance due to TPU errors. Available from 2026-03-01..
`FAILURE_GPU_NVLINK_SWITCH_CUSTOMER_REPORTED`	Maintenance due to customer reported NVLink switch failure via R&R Subblock API. Available from 2026-03-01..
`FAILURE_GPU_MULTIPLE_FAULTY_HOSTS_CUSTOMER_REPORTED`	Maintenance due to customer reported multiple faulty hosts via R&R Subblock API. Available from 2026-03-01..