Maintenance
To protect the cloud platform and our customers, STACKIT is constantly securing its components with a wide variety of procedures and measures.
One procedure requires the live migration of virtual machines from their current hypervisor, typically for maintenance or upgrade purposes. These procedures most likely do not affect your workload.
Due to their inability to be live migrated, the following machine types require a maintenance with a disruption.
Machine types with maintenance
Section titled “Machine types with maintenance”Maintenance windows are scheduled for these machine types.
| Machine type variants | Description |
|---|---|
| m1a.*cd | Instances providing AMD SEV. |
| n1.d.g | Instances with NVIDIA A100 80 GB Tensor Core GPUs. |
| n2.d.g | Instances with NVIDIA L40S 48 GB GPUs. |
| n3.d.g | Instances with NVIDIA H100 GPUs. |
Check for a maintenance window
Section titled “Check for a maintenance window”A maintenance window is shown only when maintenance is scheduled. The time displayed is in UTC.
A maintenance window is announced at least one day in advance. The window is 24 hours long, and the virtual machine will have a downtime of up to 1 hour, depending on your configuration and operating system. For example, a machine with a fully utilized local disk will experience a longer downtime.
Check for a maintenance window via metadata
Section titled “Check for a maintenance window via metadata”To check for a maintenance window you can access the metadata API on the well-known URL
<http://169.254.169.254/stackit/v1/server-info>.
Metadata API
The URL <http://169.254.169.254/stackit/v1/server-info> is part of the server metadata API and is
only reachable from within a server.
If your server received a maintenance window:
{ "maintenanceWindow": { "endsAt": "2025-01-08T00:03:27Z", "startsAt": "2025-01-07T00:03:27Z" }, "projectID": "cbXXX-XXXX-XXXX-XXXX-XXXX", "serverID": "baXXX-XXXX-XXXX-XXXX-XXXX", "serverName": "ServerWithMaintenance" }Check for a maintenance window via IaaS API
Section titled “Check for a maintenance window via IaaS API”Prerequisites
Section titled “Prerequisites”- Switch over to where you have installed the STACKIT CLI.
- First use the CLI to authenticate to the API and set the project ID.
$ stackit auth login Successfully logged into STACKIT CLI. $ stackit config set --project-id xxx $ PROJECTID=xxxCheck for maintenance with STACKIT curl
Section titled “Check for maintenance with STACKIT curl”java stackit curl https://iaas.api.eu01.stackit.cloud/v1/projects//servers/
Output:
{ "availabilityZone": "eu01-1", "bootVolume": { "id": "62XX-XXXX-XXXX-XXXX-XXXX" }, "createdAt": "2024-05-06T12:58:34Z", "id": "baXXX-XXXX-XXXX-XXXX-XXXX", "keypairName": "keypair already deleted", "labels": { "key": "alabel" }, "launchedAt": "2024-12-08T00:48:21Z", "machineType": "m1a.4cd", "maintenanceWindow": { "endsAt": "2025-01-08T00:03:27Z", "startsAt": "2025-01-07T00:03:27Z", "status": "PLANNED" }, "name": "ServerWithMaintenance", "powerStatus": "RUNNING", "status": "ACTIVE", "updatedAt": "2024-12-17T12:36:27Z", "volumes": [ "62XX-XXXX-XXXX-XXXX-XXXX" ] }