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

Maintenance windows are scheduled for these machine types.

Expand

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

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

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.

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

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=xxx

Check for maintenance with STACKIT curl

stackit curl https://iaas.api.eu01.stackit.cloud/v1/projects/<PROJECT_ID>/servers/<SERVER_ID>

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