Contact UsTry it for free
© 2026 Direct Cursus Technology L.L.C.

Managing maintenance of GPU VMs

Written by
Updated at February 10, 2026

Note

This feature is in the Preview stage. To get access, contact tech support or your account manager.

Compute Cloud performs occasional maintenance of GPU VMs and notifies users of the scheduled date and time. You can view the list of maintenance tasks scheduled for your VMs and reschedule them as needed.

Viewing VM maintenance tasks

  1. In the management console, select the folder where you want to view VM maintenance tasks.

  2. Go to Compute Cloud.

  3. In the left-hand panel, select Maintenance.

    The window that opens displays a list of all maintenance tasks for GPU VMs, which includes:

    • ID: Task ID.
    • Task: Action performed during maintenance affecting the VM availability, e.g., Restart.
    • Status: Task status.
    • Resource: Name of the VM to undergo maintenance.
    • Start date: Start date and time of the scheduled VM maintenance if the task is pending; otherwise, the actual maintenance start date and time.
    • Completed: Maintenance completion date and time.

    To view details of a maintenance task, click the relevant row in the task list. Use the top-of-page filter to quickly find the task you need in the list.

    Dates and times displayed in the task details match the time zone selected in the user’s management console settings.

Tip

You can also view details of a scheduled VM maintenance task in a note within the Name field in the list of VMs under Virtual machines and on the relevant VM page.

If you do not have the Yandex Cloud CLI installed yet, install and initialize it.

By default, the CLI uses the folder specified when creating the profile. To change the default folder, use the yc config set folder-id <folder_ID> command. You can also set a different folder for any specific command using the --folder-name or --folder-id parameter.

  1. To view the list of VM maintenance tasks, run the following command:

    yc compute maintenance list \
  --cloud-id <cloud_ID> \
  --folder-id <folder_ID> \
  --resource-id <VM_ID> \
  --filter <filter> \
  --order <sorting_order>

    Where:

    • --cloud-id: ID of the cloud where you want to view tasks.

    • --folder-id: ID of the folder where you want to view tasks.

    • --resource-id: ID of the VM to view tasks for.

      Note

      --cloud-id, --folder-id, and --resource-id are mutually exclusive: you can use only one of them.

      If none of these parameters is set, the command will output the list of maintenance tasks in the default folder.

    • --filter: Filter to apply to the task list you obtained. This is an optional parameter. By default, the command outputs the full list of maintenance tasks.

      You can filter the list by task status (status) or by VM ID (resource_id). For example: --filter 'status = "SCHEDULED"' or --filter 'resource_id = "a7loutvf73vg********"'.

    • sort_order: Task list sorting order. This is an optional parameter. Possible values:

      • created_at: By the task creation time.
      • start_scheduled_at: By the scheduled time of the task.
      • started_at: By the task start time.

      By default, tasks are sorted in ascending order. To sort tasks in descending order, use the DESC setting, e.g., --order 'created_at DESC'.

    Result:

    +----------------------+----------------------+----------------------+------------------+----------------------+-----------+---------------------+---------------------+---------------------+
|          ID          |       CLOUD ID       |      FOLDER ID       |  RESOURCE TYPE   |     RESOURCE ID      |  STATUS   |     CREATED AT      | START SCHEDULED AT  |     STARTED AT      |
+----------------------+----------------------+----------------------+------------------+----------------------+-----------+---------------------+---------------------+---------------------+
| a7l0b4nkle3b******** | a7lia87mbaom******** | a7lt6g8ht345******** | compute.instance | a7loutvf73vg******** | SUCCEEDED | 2025-09-03 11:08:15 | 2025-09-03 11:15:39 | 2025-09-03 11:15:52 |
| a7l742uljpl3******** | a7lia87mbaom******** | a7lt6g8ht345******** | compute.instance | a7l7f7n9dbfq******** | SCHEDULED | 2025-09-03 11:58:59 | 2025-09-08 07:00:00 |                     |
+----------------------+----------------------+----------------------+------------------+----------------------+-----------+---------------------+---------------------+---------------------+

    The ID field contains the task ID.

  2. To view information about a specific task, run the following command with the ID of your task:

    yc compute maintenance get <task_ID>

    Result:

    id: a7l742uljpl3********
resource_path:
  - id: a7l7f7n9dbfq********
    type: compute.instance
  - id: aoepotm5k3oa********
    type: resource-manager.folder
  - id: a7lia87mbaom********
    type: resource-manager.cloud
status: SCHEDULED
created_at: "2025-09-03T11:58:59Z"
start_scheduled_at: "2025-09-08T07:00:00Z"
completion_scheduled_at: "2025-09-08T15:00:00Z"
max_start_scheduled_at: "2025-09-08T07:00:00Z"
user_controllable: true

Rescheduling VM maintenance tasks

You can reschedule a task to an earlier or later date and time:

  1. In the management console, select the folder containing the VM to reschedule a maintenance task for.

  2. Go to Compute Cloud.

  3. In the left-hand panel, select Maintenance.

  4. In the list that opens, click next to the task in question and select Reschedule. In the window that opens:

    1. Select a new date and time window for the task.

      To see how far you can postpone the maintenance task, click the task row in the list. In the window that opens, the Can be postponed until field shows the latest possible date and time.

    2. Click Reschedule.

Tip

You can also reschedule a VM maintenance task by clicking in the Name field in the VM list under Virtual machines, and on the relevant VM page.

If you do not have the Yandex Cloud CLI installed yet, install and initialize it.

By default, the CLI uses the folder specified when creating the profile. To change the default folder, use the yc config set folder-id <folder_ID> command. You can also set a different folder for any specific command using the --folder-name or --folder-id parameter.

  1. Get the ID of the maintenance task you need.

  2. To reschedule the VM maintenance task, run this command:

    yc compute maintenance reschedule <task_ID> \
  --time "<new_scheduled_date_and_time>"

    Where:

    • <task_ID>: ID of the task to reschedule, obtained in the previous step.

    • <new_scheduled_date_and_time>: New date and time for the task, e.g., 2025-09-07T07:00:00Z.

      Provide the time in ISO 8601 UTC format with zero offset. For Moscow time, add +03:00 instead of Z at the end of the line: 2025-09-07T07:00:00+03:00.

    Result:

    id: a7l742uljpl3********
resource_path:
  - id: a7l7f7n9dbfq********
    type: compute.instance
  - id: aoepotm5k3oa********
    type: resource-manager.folder
  - id: a7lia87mbaom********
    type: resource-manager.cloud
status: SCHEDULED
created_at: "2025-09-03T11:58:59Z"
start_scheduled_at: "2025-09-07T07:00:00Z"
completion_scheduled_at: "2025-09-07T15:00:00Z"
max_start_scheduled_at: "2025-09-08T07:00:00Z"
user_controllable: true

Instant start of scheduled maintenance tasks

You can instantly start a scheduled VM maintenance task.

  1. In the management console, select the folder containing the VM to start a maintenance task for.
  2. Go to Compute Cloud.
  3. In the left-hand panel, select Maintenance.
  4. In the list that opens, click next to the task in question and select Perform now.
  5. In the window that opens, confirm that you want to instantly start the task.

Tip

You can also instantly start a VM maintenance task by clicking in the Name field in the VM list under Virtual machines, and on the relevant VM page.

If you do not have the Yandex Cloud CLI installed yet, install and initialize it.

By default, the CLI uses the folder specified when creating the profile. To change the default folder, use the yc config set folder-id <folder_ID> command. You can also set a different folder for any specific command using the --folder-name or --folder-id parameter.

  1. Get the ID of the maintenance task you need.

  2. To instantly start a task, run the following command with the task ID you obtained in the previous step:

    yc compute maintenance reschedule <task_ID> \
  --immediate

    Result:

    id: a7l742uljpl3********
resource_path:
  - id: a7l7f7n9dbfq********
    type: compute.instance
  - id: aoepotm5k3oa********
    type: resource-manager.folder
  - id: a7lia87mbaom********
    type: resource-manager.cloud
status: RUNNING
created_at: "2025-09-03T11:58:59Z"
start_scheduled_at: "2025-09-03T13:07:13.136955876Z"
completion_scheduled_at: "2025-09-04T21:07:13.136955876Z"
max_start_scheduled_at: "2025-09-08T07:00:00Z"
user_controllable: true

See also

Previous
Linking a service account to a VM
Next
Deleting a VM