Создание и удаление сетевого диска

1. В процессе создания или изменения ВМ перейдите к добавлению дополнительного сетевого диска.

2. В открывшемся окне выберите опцию Зависимый.

3. Укажите параметры зависимого диска:

   • (опционально) Имя — измените автоматически сгенерированное имя диска в рамках виртуальной машины. Позже его нельзя изменить.
   • Источник — выберите тип источника и источник для создания диска.
   • Тип диска — выберите тип диска.
   • Размер диска — укажите нужный размер диска.
     Если диск создается из источника, будет предложено создать диск аналогичного размера. Вы можете указать размер больше.
   • IOPS — укажите значение IOPS (Input/Output Operations Per Second).
   • (опционально) Параметры подключения → Device Name — измените автоматически сгенерированное имя диска, которое будет отображаться в /dev/disk/by-id/mws-* и использоваться для обращения к диску внутри ВМ. Позже его нельзя изменить.

4. Нажмите кнопку Создать.

1. Если у вас нет утилиты MWS CLI:

   1. Установите утилиту.

   2. Инициализируйте профиль.

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

   Внимание

   Неупомянутые в команде или переименованные диски будут удалены. Чтобы избежать потери данных:

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

   Пример изменения конфигурации существующей ВМ:

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

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

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

1. Если у вас не установлен Terraform, установите его.

2. Опишите в конфигурационном файле параметры зависимого сетевого диска, который нужно создать:

   1
   resource "mws_compute_disk" "disk" {
   2
     disk       = "<имя диска>"
   3
     disk_type  = "diskTypes/nbs-pl2"
   4
     iops       = <пропускная способность диска, iops>
   5
     size       = "<размер диска>"
   6
     source = {
   7
       image = <id образа>
   8
     }
   9
   }

   Здесь:

   • disk — имя диска;
   • type — тип диска;
   • iops — пропускная способность диска (количество операций ввода-вывода в секунду);
   • size — размер диска;
   • source — ссылка на образ, из которого создается диск.

   Подробнее о параметрах диска и особенностях их использования см. в спецификации.

3. Проверьте конфигурационный файл на наличие синтаксических ошибок:

   1
   terraform validate

   Если ошибок нет, вы получите следующее сообщение:

   1
   Success! The configuration is valid.

4. Выполните команду:

   1
   terraform plan

   Terraform проверит конфигурационные файлы, сопоставит описание желаемого состояния облачной инфраструктуры с фактическим и укажет, какие операции с ресурсами будут выполнены.

5. Примените конфигурацию:

   1
   terraform apply

   Подтвердите выполнение операций: введите слово yes и нажмите Enter.

   Во время создания ресурсов Terraform будет выводить краткие сообщения о выполняемых операциях. Проверить, что ресурсы созданы и настроены корректно, можно в веб-консоли.

   При создании виртуальной машины ссылка на диск должна быть указана в спецификации, например:

   1
    storage = {
   2
      disks = [
   3
        {
   4
          name = "boot"
   5
          boot = true
   6
          disk = {
   7
            ref = mws_compute_disk.boot_disk.metadata.id
   8
          }
   9
        }
   10
      ]
   11
    }

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

2. Опишите конфигурацию ВМ с новым зависимым сетевым диском в виде 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
           }
   36
       }
   37
   }

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

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

3. Сохраните JSON-объект в отдельном файле.

4. Выполните запрос на создание или изменение ВМ.

   Пример запроса на изменение ВМ:

   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. В ответе будут выведены параметры ВМ с новым зависимым диском.

1. В веб-консоли выберите нужный проект.

2. В списке сервисов выберите Compute → Сетевые диски и нажмите кнопку Создать.

3. Укажите параметры независимого сетевого диска:

   • (опционально) Имя — измените автоматически сгенерированное имя диска. Позже это имя (name) и созданный из него идентификатор (ID) нельзя изменить, меняется только отображаемое имя (display name) диска.
   • Зона доступности — выберите зону доступности.
   • Источник — выберите тип источника и источник для создания диска.
   • Тип диска — выберите тип диска.
   • Размер диска — укажите нужный размер диска.
     Если диск создается из источника, будет предложено создать диск аналогичного размера. Вы можете указать размер больше.
   • IOPS — укажите значение IOPS (Input/Output Operations Per Second).
   • (опционально) Описание — добавьте описание.

4. Нажмите кнопку Создать.

Также эту операцию вы можете выполнить на страницах снимка или образа, которые являются источником для создания диска.

1. Если у вас нет утилиты MWS CLI:

   1. Установите утилиту.

   2. Инициализируйте профиль.

2. Выполните команду:

   1
   mws compute disk create <имя диска> <набор флагов>

   Полный список флагов вы можете получить с помощью команды:

   1
   mws compute disk create --help

   Пример создания независимого сетевого диска:

   1
   mws compute disk create <имя диска> \
   2
     --disk-type nbs-pl2 \
   3
     --iops 1000 \
   4
     --size 10GB \
   5
     --zone ru-central1-a

   Вывод команды

   1
   metadata:
   2
       createTime: "2025-06-24T03:27:40Z"
   3
       etag: 37d65a33398f40c4ab12ac0107f42aa3
   4
       id: projects/<имя проекта>/disks/<имя диска>
   5
       name: <имя диска>
   6
       updateTime: "2025-06-24T03:27:40Z"
   7
       usages: []
   8
   spec:
   9
       diskType: nbs-pl2
   10
       iops: 1000
   11
       size: 10GB
   12
       zone: ru-central1-a
   13
   status:
   14
       blockSize: 4096 B
   15
       diskType: compute/diskTypes/nbs-pl2
   16
       iops:
   17
           base: 1000
   18
           extra: 0
   19
           total: 1000
   20
       linkedVms: []
   21
       ready:
   22
           state: PROCESSING
   23
       size: 10GB
   24
       throughput: 33554432 Bps

1. Если у вас не установлен Terraform, установите его.

2. Опишите в конфигурационном файле параметры независимого сетевого диска, который нужно создать:

   1
   resource "mws_compute_disk" "disk" {
   2
     disk      = "<имя диска>"
   3
     disk_type = "diskTypes/nbs-pl2"
   4
     iops      = <пропускная способность диска, iops>
   5
     size      = "<размер диска>"
   6
   }

   Здесь:

   • disk — имя диска;
   • type — тип диска;
   • iops — пропускная способность диска (количество операций ввода-вывода в секунду);
   • size — размер диска.

3. Проверьте конфигурационный файл на наличие синтаксических ошибок:

   1
   terraform validate

   Если ошибок нет, вы получите следующее сообщение:

   1
   Success! The configuration is valid.

4. Выполните команду:

   1
   terraform plan

   Terraform проверит конфигурационные файлы, сопоставит описание желаемого состояния облачной инфраструктуры с фактическим и укажет, какие операции с ресурсами будут выполнены.

5. Примените конфигурацию:

   1
   terraform apply

   Подтвердите выполнение операций: введите слово yes и нажмите Enter.

   Во время создания ресурсов Terraform будет выводить краткие сообщения о выполняемых операциях. Проверить, что ресурсы созданы и настроены корректно, можно в веб-консоли.

   При создании виртуальной машины ссылка на диск должна быть указана в спецификации, например:

   1
    storage = {
   2
      disks = [
   3
        {
   4
          name = "disk"
   5
          boot = false
   6
          disk = {
   7
            ref = mws_compute_disk.disk.metadata.id
   8
          }
   9
        }
   10
      ]
   11
    }

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

2. Опишите характеристики независимого сетевого диска в виде JSON-объекта:

   1
   {
   2
     "metadata": {
   3
       "name": "<уникальное имя диска>",
   4
       "displayName": "<отображаемое имя диска>",
   5
       "description": "<описание диска>"
   6
     },
   7
     "spec": {
   8
       "zone": "<зона доступности>",
   9
       "size": "<размер диска в гигабайтах — например, 10GB>",
   10
       "source": {
   11
         "image": "<путь к образу диска>",
   12
         "snapshot": "<путь к снимку диска>"
   13
       },
   14
       "diskType": "nbs-pl2",
   15
       "iops": <количество iops>
   16
     }
   17
   }

3. Сохраните JSON-объект в отдельном файле.

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

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

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

1. Если диск автоматически монтируется при запуске ВМ (добавлен в /etc/fstab), отключите автоматическое монтирование этого диска.
2. В веб-консоли выберите нужный проект.
3. В списке сервисов выберите Compute → Виртуальные машины.
4. Выберите нужную ВМ и перейдите на вкладку Диски.
5. Выберите опцию Сетевые.
6. Нажмите на значок ... для удаляемого диска и выберите Удалить.
7. Подтвердите удаление.

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

2. Если у вас нет утилиты MWS CLI:

   1. Установите утилиту.

   2. Инициализируйте профиль.

3. Выполните команду mws compute vm update, исключив описание зависимого сетевого диска.

   Внимание

   Неупомянутые в команде или переименованные диски будут удалены. Чтобы избежать потери данных:

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

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

   1. В спецификации ВМ описаны три сетевых диска:

   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
     '

   1. Вы хотите удалить зависимый диск. Для этого исключите описание зависимого диска из списка параметров ВМ --storage-disks:

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

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

   • загрузочный диск;
   • независимый диск projects/<имя проекта>/disks/<имя независимого диска>.

   Зависимый диск будет удален.

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

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

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

   Внимание

   Неупомянутые в запросе или переименованные диски будут удалены. Чтобы избежать потери данных:

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

4. Сохраните JSON-объект в отдельном файле.

5. Выполните запрос на изменение ВМ:

   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. В ответе будут выведены обновленные параметры параметры ВМ.

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

   1. В спецификации ВМ описаны три сетевых диска:

      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
      }

   2. Вы хотите удалить зависимый диск. Чтобы сделать это, удалите его описание из спецификации ВМ:

      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
      }

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

   • загрузочный диск;
   • независимый диск projects/<имя проекта>/disks/<имя независимого диска>.

   Зависимый диск будет удален.

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

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

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

2. Если у вас нет утилиты MWS CLI:

   1. Установите утилиту.

   2. Инициализируйте профиль.

3. Если диск подключен к ВМ, отключите его.

4. Выполните команду:

   1
   mws compute disk delete <имя диска>

   В случае успешного удаления на экран будет выведен ответ success.

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

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

3. Если диск подключен к ВМ, отключите его.

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

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

   Если диск был успешно удален, вы получите ответ с кодом 204 No Content.