Подключение и отключение сетевого диска, изменение формата подключения сетевого диска к ВМ

Подключить сетевой диск к ВМ

Чтобы использовать сетевой диск, подключите его к виртуальной машине. Диск можно отключать от одной ВМ и подключать к другой. Подключить сетевой диск к ВМ можно как зависимый и независимый.

Подключить зависимый сетевой диск

Зависимый диск автоматически подключается к ВМ при его создании.

Подключить независимый сетевой диск

Веб-консоль
MWS CLI
API

В веб-консоли выберите нужный проект.
В списке сервисов выберите Compute → Сетевые диски.
Нажмите на значок ... для нужного диска и выберите Присоединить к ВМ.
Выберите, к какой виртуальной машине будет подключен диск.
В открывшемся окне:
1. Device Name — укажите имя диска, которое будет отображаться в /dev/disk/by-id/mws-* и использоваться для обращения к диску внутри ВМ, или оставьте имя по умолчанию.
2. Нажмите кнопку Присоединить.

Также эту операцию вы можете выполнить:

на странице этого диска;
при создании или изменении ВМ, добавив дополнительный существующий диск.

Если у вас нет утилиты MWS CLI:
1. Установите утилиту.
2. Инициализируйте профиль.
Узнайте имя независимого сетевого диска:
bash
```
1
mws compute disk list
```
Узнайте имя ВМ:
bash
```
1
mws compute vm list
```

Добавьте описание независимого сетевого диска во флаг --storage-disks.

Пример изменения конфигурации:

1
mws compute vm update <имя ВМ> \
2
  --storage-disks 'name: <имя загрузочного диска ВМ>' \
3
  --storage-disks '
4
    name: <имя зависимого диска>
5
    boot: false
6
    managed: true
7
    disk:
8
      spec:
9
        diskType: diskTypes/nbs-pl2
10
        iops: 1000
11
        size: 14GB
12
  ' \
13
  --storage-disks '
14
    name: <имя подключаемого независимого диска в рамках ВМ>
15
    disk:
16
      ref: projects/<имя проекта>/disks/<имя подключаемого независимого диска>
17
  '

В результате у ВМ станет три подключенных сетевых диска:

загрузочный диск;
зависимый диск nbs-pl2 размером 14 ГБ;
подключенный независимый диск projects/<имя проекта>/disks/<имя подключаемого независимого диска>.

1
kind: compute/v1/virtualMachine
2
metadata:
3
    createTime: "2025-06-04T09:52:34Z"
4
    description: <описание ВМ>
5
    etag: 942f0f1890a449d5b428cecb8242b199
6
    id: projects/<имя проекта>/virtualMachines/<имя ВМ>
7
    name: <имя ВМ>
8
spec:
9
    hardware:
10
        gracefulShutdownTimeout: 1m 30s
11
        power: "ON"
12
    network:
13
        networkInterfaces:
14
            - addresses:
15
                - address:
16
                    spec:
17
                        subnet: networks/<имя сети>/subnets/<имя подсети>
18
              name: <имя сети>
19
              primary: true
20
    os:
21
        metadata: {}
22
        standardDnsRecords: true
23
    storage:
24
        disks:
25
            - boot: true
26
              disk:
27
                spec:
28
                    diskType: diskTypes/nbs-pl2
29
                    iops: 1000
30
                    size: 10GB
31
                    source:
32
                        image: projects/mws-ubuntu/images/mws-ubuntu-2204-lts-v20250529
33
              name: boot
34
            - boot: false
35
              deviceName: <имя нового диска в рамках ВМ>
36
              name: <имя нового диска>
37
              ref: projects/<имя проекта>/disks/<имя нового диска>
38
            - boot: false
39
              deviceName: <имя подключаемого диска в рамках ВМ>
40
              name: <имя подключаемого диска>
41
              ref: projects/<имя проекта>/disks/<имя подключаемого диска>
42
    vmType: vmTypes/gen-2-8
43
    zone: ru-central1-a

Убедитесь, что у вас есть IAM-токен для авторизации запроса. Если нет, получите его.

Узнайте имя независимого сетевого диска:

1
curl -X GET https://compute.mwsapis.ru/compute/v1/projects/<имя проекта>/disks \
2
  -H "Authorization: Bearer <IAM-токен>"

Узнайте имя ВМ:

1
curl -X GET https://compute.mwsapis.ru/compute/v1/projects/<имя проекта>/virtualMachines \
2
  -H "Authorization: Bearer <IAM-токен>"

Опишите новую конфигурацию ВМ с подключаемым независимым сетевым диском в виде JSON-объекта.

Пример изменения конфигурации:

1
{
2
    "kind": "compute/v1/virtualMachine",
3
    "metadata": {
4
        "id": "projects/<имя проекта>/virtualMachines/<имя ВМ>"
5
    },
6
    "spec": {
7
        "storage": {
8
            "disks": [
9
                {
10
                    "name": "<имя загрузочного диска>",
11
                    "boot": true,
12
                    "disk": {
13
                        "spec": {
14
                            "size": "10GB",
15
                            "source": {
16
                                "image": "<путь к образу диска>"
17
                            },
18
                            "diskType": "diskTypes/nbs-pl2",
19
                            "iops": 1000
20
                        }
21
                    }
22
                },
23
                {
24
                    "name": "<имя зависимого диска>",
25
                    "boot": false,
26
                    "disk": {
27
                        "spec": {
28
                            "size": "14GB",
29
                            "diskType": "diskTypes/nbs-pl2",
30
                            "iops": 1000
31
                        }
32
                    }
33
                },
34
                {
35
                    "name": "<имя подключаемого независимого диска>",
36
                    "boot": false,
37
                    "disk": {
38
                        "ref": "projects/<имя проекта>/disks/<имя подключаемого независимого диска>"
39
                    }
40
                }
41
            ]
42
        }
43
    }
44
}

В результате у ВМ станет три подключенных сетевых диска:

загрузочный диск;
зависимый диск nbs-pl2 размером 14 ГБ;
подключенный независимый диск projects/<имя проекта>/disks/<имя подключаемого независимого диска>.

Сохраните JSON-объект в отдельном файле.
Выполните запрос:
bash
```
1
curl -X POST https://compute.mwsapis.ru/compute/v1/projects/<имя проекта>/virtualMachines/<имя ВМ>?updateOnly=true \
2
  -H "Authorization: Bearer <IAM-токен>" \
3
  -H "Content-Type: application/json" \
4
  -d '@<путь к файлу с JSON-объектом>'
```
Если запрос был успешно принят, вы получите ответ с кодом 200 OK. Если диск был подключен успешно, в ответе будут выведены обновленные параметры ВМ и статус ready.

После подключения смонтируйте диск к файловой системе ВМ. Способ монтирования зависит от того, как был создан диск: пустой или из образа или снимка.

Отключить сетевой диск от ВМ

Отключить зависимый сетевой диск

Отключить от ВМ можно только независимый диск. Чтобы отключить и использовать зависимый диск отдельно от ВМ, сделайте его независимым. После этого отключить этот диск можно как независимый.

Отключить независимый сетевой диск

Веб-консоль
MWS CLI
API

Если диск автоматически монтируется при запуске ВМ (добавлен в /etc/fstab), отключите автоматическое монтирование этого диска.
В веб-консоли выберите нужный проект.
В списке сервисов выберите Compute → Сетевые диски.
Нажмите на значок ... для нужного диска и выберите Отсоединить от ВМ.
Подтвердите действие.

Также эту операцию вы можете выполнить на странице этого диска и в списке дисков ВМ.

Если диск автоматически монтируется при запуске ВМ (добавлен в /etc/fstab), отключите автоматическое монтирование этого диска.
Если у вас нет утилиты MWS CLI:
1. Установите утилиту.
2. Инициализируйте профиль.
Узнайте имя независимого сетевого диска:
bash
```
1
mws compute disk list
```
Узнайте имя ВМ:
bash
```
1
mws compute vm list
```
Выполните команду mws compute vm update, исключив описание независимого сетевого диска.
Внимание
Неупомянутые в команде или переименованные диски будут удалены. Чтобы избежать потери данных:

Перечислите все диски, которые должны остаться на ВМ, в том числе существующие.

Не переименовывайте уже существующие диски.
Ранее вы подключали независимый диск с помощью этой команды:

bash
1 mws compute vm update <имя ВМ> \ 2 --storage-disks 'name: <имя загрузочного диска ВМ>' \ 3 --storage-disks ' 4 name: <имя зависимого диска> 5 boot: false 6 managed: true 7 disk: 8 spec: 9 diskType: diskTypes/nbs-pl2 10 iops: 1000 11 size: 14GB 12 ' \ 13 --storage-disks ' 14 name: <имя независимого диска в рамках ВМ> 15 disk: 16 ref: projects/<имя проекта>/disks/<имя независимого диска> 17 '

Сейчас вы хотите отключить от ВМ независимый диск projects/<имя проекта>/disks/<имя независимого диска>. Чтобы сделать это, исключите его описание из списка параметров ВМ --storage-disks:

bash
1 mws compute vm update <имя ВМ> \ 2 --storage-disks 'name: <имя загрузочного диска ВМ>' \ 3 --storage-disks ' 4 name: <имя зависимого диска> 5 boot: false 6 managed: true 7 disk: 8 spec: 9 diskType: diskTypes/nbs-pl2 10 iops: 1000 11 size: 14GB 12 '

В результате у ВМ останется два подключенных сетевых диска:

загрузочный диск;

зависимый диск nbs-pl2 размером 14 ГБ.

Диск projects/<имя проекта>/disks/<имя подключенного независимого диска> будет отключен от ВМ, но не удален.

Чтобы отключить диск от ВМ, удалите его из спецификации ВМ.

Если диск автоматически монтируется при запуске ВМ (добавлен в /etc/fstab), отключите автоматическое монтирование этого диска.
Убедитесь, что у вас есть IAM-токен для авторизации запроса. Если нет, получите его.

Узнайте имя ВМ:

1
curl -X GET https://compute.mwsapis.ru/compute/v1/projects/<имя проекта>/virtualMachines \
2
  -H "Authorization: Bearer <IAM-токен>"

Узнайте имя независимого сетевого диска:

1
curl -X GET https://compute.mwsapis.ru/compute/v1/projects/<имя проекта>/disks \
2
  -H "Authorization: Bearer <IAM-токен>"

Опишите новую конфигурацию ВМ без отключаемого независимого диска в виде JSON-объекта.
Внимание
Неупомянутые в запросе или переименованные диски будут удалены. Чтобы избежать потери данных:

Перечислите все диски, которые должны остаться на ВМ, в том числе существующие.

Не переименовывайте уже существующие диски.
Сохраните JSON-объект в отдельном файле.

Выполните запрос:

1
curl -X POST https://compute.mwsapis.ru/compute/v1/projects/<имя проекта>/virtualMachines/<имя ВМ>?updateOnly=true \
2
  -H "Authorization: Bearer <IAM-токен>" \
3
  -H "Content-Type: application/json" \
4
  -d '@<путь к файлу с JSON-объектом>'

Если запрос был успешно принят, вы получите ответ с кодом 200 OK. Если диск был отключен успешно, в ответе будут выведены обновленные параметры ВМ и статус ready.

Ранее вы подключали независимый диск с помощью этой команды:

1
{
2
    "kind": "compute/v1/virtualMachine",
3
    "metadata": {
4
        "id": "projects/<имя проекта>/virtualMachines/<имя ВМ>"
5
    },
6
    "spec": {
7
        "storage": {
8
            "disks": [
9
                {
10
                    "name": "<имя загрузочного диска>",
11
                    "boot": true,
12
                    "disk": {
13
                        "spec": {
14
                            "size": "10GB",
15
                            "source": {
16
                                "image": "<путь к образу диска>"
17
                            },
18
                            "diskType": "diskTypes/nbs-pl2",
19
                            "iops": 1000
20
                        }
21
                    }
22
                },
23
                {
24
                    "name": "<имя зависимого диска>",
25
                    "boot": false,
26
                    "disk": {
27
                        "spec": {
28
                            "size": "14GB",
29
                            "diskType": "diskTypes/nbs-pl2",
30
                            "iops": 1000
31
                        }
32
                    }
33
                },
34
                {
35
                    "name": "<имя подключаемого независимого диска>",
36
                    "boot": false,
37
                    "disk": {
38
                        "ref": "projects/<имя проекта>/disks/<имя подключаемого независимого диска>"
39
                    }
40
                }
41
            ]
42
        }
43
    }
44
}

Сейчас вы хотите отключить от ВМ независимый диск projects/<имя проекта>/disks/<имя подключенного независимого диска>. Чтобы сделать это, удалите его описание из значения параметра ВМ --body:

1
{
2
    "kind": "compute/v1/virtualMachine",
3
    "metadata": {
4
        "id": "projects/<имя проекта>/virtualMachines/<имя ВМ>"
5
    },
6
    "spec": {
7
        "storage": {
8
            "disks": [
9
                {
10
                    "name": "<имя загрузочного диска>",
11
                    "boot": true,
12
                    "disk": {
13
                        "spec": {
14
                            "size": "10GB",
15
                            "source": {
16
                                "image": "<путь к образу диска>"
17
                            },
18
                            "diskType": "diskTypes/nbs-pl2",
19
                            "iops": 1000
20
                        }
21
                    }
22
                },
23
                {
24
                    "name": "<имя зависимого диска>",
25
                    "boot": false,
26
                    "disk": {
27
                        "spec": {
28
                            "size": "14GB",
29
                            "diskType": "diskTypes/nbs-pl2",
30
                            "iops": 1000
31
                        }
32
                    }
33
                }
34
            ]
35
        }
36
    }
37
}

В результате у ВМ останется два подключенных сетевых диска:

загрузочный диск;
зависимый диск nbs-pl2 размером 14 ГБ.

Диск projects/<имя проекта>/disks/<имя подключенного независимого диска> будет отключен от ВМ, но не удален.

Изменить формат подключения сетевого диска к ВМ

Чтобы обеспечить сохранность сетевого диска и перемещать его между ВМ, вы можете изменить способ подключения диска к ВМ Spec на Ref. Изменение работает для уже присоединенных дисков.

MWS CLI
API

Если у вас нет утилиты MWS CLI:
1. Установите утилиту.
2. Инициализируйте профиль.
Узнайте имя ВМ:
bash
```
1
mws compute vm list
```
Узнайте имя сетевого диска:
bash
```
1
mws compute disk list
```

Добавьте ссылку на нужный сетевой диск в значении параметра ВМ --storage-disks, а также параметр managed: false.

Пример изменения конфигурации:

1
mws compute vm update <имя ВМ> \
2
  --storage-disks 'name: <имя загрузочного диска ВМ>' \
3
  --storage-disks '
4
    name: <имя диска>
5
    managed: false
6
    disk:
7
      ref: projects/<имя проекта>/disks/<имя диска>
8
  '

Было:

1
spec:
2
  ...
3
  storage:
4
    disks:
5
      - name: boot
6
        disk:
7
          spec:
8
            type: nbs-pl2
9
            size: 50 GB
10
...
11
status:
12
  storage:
13
    disks:
14
      - name: boot
15
        boot: true
16
        ref: disks/my-disk
17
        managed: true
18
        ready:
19
          state: OK
20
        iops: 1000
21
        size: 50 GB

Стало:

1
spec:
2
  ...
3
  storage:
4
    disks:
5
      - name: boot
6
        disk:
7
          ref: disks/my-disk
8
...
9
status:
10
  storage:
11
    disks:
12
      - name: boot
13
        boot: true
14
        ref: disks/my-disk
15
        managed: false
16
        ready:
17
          state: OK
18
        iops: 1000
19
        size: 50 GB

Убедитесь, что у вас есть IAM-токен для авторизации запроса. Если нет, получите его.

Узнайте имя сетевого диска:

1
curl -X GET https://compute.mwsapis.ru/compute/v1/projects/<имя проекта>/disks \
2
  -H "Authorization: Bearer <IAM-токен>"

Узнайте имя ВМ:

1
curl -X GET https://compute.mwsapis.ru/compute/v1/projects/<имя проекта>/virtualMachines \
2
  -H "Authorization: Bearer <IAM-токен>"

Опишите новую конфигурацию ВМ, заменив описание сетевого диска на его ссылку.
Внимание
Неупомянутые в запросе или переименованные диски будут удалены. Чтобы избежать потери данных:

Перечислите все диски, которые должны остаться на ВМ, в том числе существующие.

Не переименовывайте уже существующие диски.
Сохраните JSON-объект в отдельном файле.

Выполните запрос:

1
curl -X POST https://compute.mwsapis.ru/compute/v1/projects/<имя проекта>/virtualMachines/<имя ВМ>?updateOnly=true \
2
  -H "Authorization: Bearer <IAM-токен>" \
3
  -H "Content-Type: application/json" \
4
  -d '@<путь к файлу с JSON-объектом>'

Было:

1
{
2
    "kind": "compute/v1/virtualMachine",
3
    "metadata": {
4
        "id": "projects/<имя проекта>/virtualMachines/<имя ВМ>"
5
    },
6
    "spec": {
7
        "storage": {
8
            "disks": [
9
                {
10
                    "name": "<имя загрузочного диска>",
11
                    "boot": true,
12
                    "disk": {
13
                        "spec": {
14
                            "size": "10GB",
15
                            "source": {
16
                                "image": "<путь к образу диска>"
17
                            },
18
                            "diskType": "diskTypes/nbs-pl2",
19
                            "iops": 1000
20
                        }
21
                    }
22
                },
23
                {
24
                    "name": "<имя диска>",
25
                    "boot": false,
26
                    "disk": {
27
                        "spec": {
28
                            "size": "10GB",
29
                            "diskType": "diskTypes/nbs-pl2",
30
                            "iops": 1000
31
                        }
32
                    }
33
                }
34
            ]
35
        }
36
    }
37
}

Стало:

1
{
2
    "kind": "compute/v1/virtualMachine",
3
    "metadata": {
4
        "id": "projects/<имя проекта>/virtualMachines/<имя ВМ>"
5
    },
6
    "spec": {
7
        "storage": {
8
            "disks": [
9
                {
10
                    "name": "<имя загрузочного диска>",
11
                    "boot": true,
12
                    "disk": {
13
                        "spec": {
14
                            "size": "10GB",
15
                            "source": {
16
                                "image": "<путь к образу диска>"
17
                            },
18
                            "diskType": "diskTypes/nbs-pl2",
19
                            "iops": 1000
20
                        }
21
                    }
22
                },
23
                {
24
                    "name": "<имя диска>",
25
                    "boot": false,
26
                    "disk": {
27
                        "ref": "projects/<имя проекта>/disks/<имя диска>"
28
                    }
29
                }
30
            ]
31
        }
32
    }
33
}