Создание и удаление образа

Создать образ

Вы можете создать новый образ:

из сетевого диска;
из другого образа;
из файла в Object Storage.

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

В веб-консоли выберите нужный проект.
В списке сервисов выберите Compute → Образы и нажмите кнопку Создать.
(опционально) Измените автоматически сгенерированное имя образа. Позже это имя (name) и созданный из него идентификатор (ID) нельзя изменить, меняется только отображаемое имя (display name) образа.
Выберите источник образа:
- Диск — создание образа из сетевого диска. Выберите сетевой диск, из которого хотите создать образ.
- Образ — создание образа из другого образа. Выберите образ из списка.
  
  Для просмотра образов из других проектов, к которым у вас есть доступ, нажмите Образы другого проекта и введите идентификатор нужного проекта.
- По ссылке — создание образа из файла в Object Storage. Введите ссылку на образ в бакете Object Storage.
При создании образа из Object Storage выберите тип ОС.
(опционально) Укажите семейство, к которому будет относиться образ.
(опционально) Измените минимальный размер диска, который можно будет создать из образа. По умолчанию он равен размеру диска-источника, но его можно увеличить.
(опционально) Добавьте описание.
Нажмите кнопку Создать.

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

Если у вас нет утилиты MWS CLI:
1. Установите утилиту.
2. Инициализируйте профиль.
Узнайте нужные данные:
- Для создания образа из сетевого диска — идентификатор диска-источника. Выполните команду:
  bash
  1 mws compute disk get <имя диска>
- Для создания образа из другого образа — идентификатор образа-источника. Выполните команду:
  bash
  1 mws compute image get <имя образа> \ 2 --project <(опционально) имя проекта>
- Для создания образа из файла в Object Storage — ссылку на образ в бакете. Установите и настройте утилиту AWS CLI, а затем выполните команду:
  bash
  1 aws s3 presign s3://<имя бакета>/<путь к образу> \ 2 --expires-in 60480 \ 3 --endpoint-url https://storage.mwsapis.ru
  Пример успешного выполнения запроса:
  1 https://storage.mwsapis.ru/test-bucket/jammy-server-cloudimg-amd64.qcow2?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Credential=rNw605bp9MIQXFEe-QJF%2F20250812%2Fru-central1%2Fs3%2Faws4_request&X-Amz-Date=20250812T033321Z&X-Amz-Expires=60480&X-Amz-SignedHeaders=host&X-Amz-Signature=3a30dd9402a69b6573cd8f72571faf683eb6fe660b8f4de256dfdfe91e8297b3

Выполните нужную команду в зависимости от источника образа:

Сетевой диск
Другой образ
Файл в Object Storage

1
mws compute image create <имя образа> \
2
  --source-disk-id <идентификатор диска-источника> \
3
  --family <(опционально) имя семейства ОС — например, ubuntu-2204-lts> \
4
  --min-disk-size <(опционально) минимальный допустимый размер диска, создаваемого из образа>

1
mws compute image create <имя образа> \
2
  --source-image-id <идентификатор образа-источника> \
3
  --family <(опционально) имя семейства ОС — например, ubuntu-2204-lts> \
4
  --min-disk-size <(опционально) минимальный допустимый размер диска, создаваемого из образа>

1
mws compute image create <имя образа> \
2
  --external-url <ссылка на образ в Object Storage> \
3
  --os-type <тип ОС — LINUX или WINDOWS> \
4
  --family <(опционально) имя семейства ОС — например, ubuntu-2204-lts> \
5
  --min-disk-size <(опционально) минимальный допустимый размер диска, создаваемого из образа>

1
kind: compute/v1/image
2
metadata:
3
  id: compute/projects/<имя проекта>/images/<имя образа>
4
  name: <имя образа>
5
  createTime: "2026-03-12T07:56:05Z"
6
  updateTime: "2026-03-12T07:56:16Z"
7
  etag: 6cab03e1100f4b8f885bb35aaac0d41c4
8
spec:
9
  source:
10
    diskId: compute/projects/<имя проекта/disks/<имя диска>
11
  minDiskSize: 20GB
12
status:
13
  ready:
14
    state: OK
15
  storageSize: 0 B
16
  sourceExists: true
17
  activity: ACTUAL
18
  minDiskSize: 20GB

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

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

Сетевой диск
Другой образ
Файл в Object Storage

1
resource "mws_compute_image" "image" {
2
  image  = "<имя образа>"
3
  family = "<(опционально) имя семейства ОС — например, ubuntu-2204-lts>"
4
  min_disk_size = "<(опционально) минимальный допустимый размер диска, создаваемого из образа>"
5
  source = {
6
    disk_id = "<идентификатор диска-источника>"
7
  }
8
}

1
resource "mws_compute_image" "image" {
2
  image  = "<имя образа>"
3
  family = "<(опционально) имя семейства ОС — например, ubuntu-2204-lts>"
4
  min_disk_size = "<(опционально) минимальный допустимый размер диска, создаваемого из образа>"
5
  source = {
6
    image_id = "<идентификатор образа-источника>"
7
  }
8
}

1
resource "mws_compute_image" "image" {
2
  image  = "<имя образа>"
3
  family = "<(опционально) имя семейства ОС — например, ubuntu-2204-lts>"
4
  min_disk_size = "<(опционально) минимальный допустимый размер диска, создаваемого из образа>"
5
  source = {
6
    external_url = "<ссылка на образ в Object Storage>"
7
  }
8
  os_type = "<тип ОС — LINUX или WINDOWS>"
9
}

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

Проверьте конфигурационный файл на наличие синтаксических ошибок:
bash
```
1
terraform validate
```
Если ошибок нет, вы получите следующее сообщение:
bash
```
1
Success! The configuration is valid.
```
Выполните команду:
bash
```
1
terraform plan
```
Terraform проверит конфигурационные файлы, сопоставит описание желаемого состояния облачной инфраструктуры с фактическим и укажет, какие операции с ресурсами будут выполнены.
Примените конфигурацию:
bash
```
1
terraform apply
```
Подтвердите выполнение операций: введите слово yes и нажмите Enter.

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

Убедитесь, что у вас есть IAM-токен для авторизации запроса. Если нет, получите его.
Узнайте нужные данные:
- Для создания образа из сетевого диска — идентификатор диска-источника. Выполните запрос:
  bash
  1 curl -X GET https://compute.mwsapis.ru/compute/v1/projects/<имя проекта>/disks/<имя диска> \ 2 -H "Authorization: Bearer <IAM-токен>"
- Для создания образа из другого образа — идентификатор образа-источника. Выполните запрос:
  bash
  1 curl -X GET https://compute.mwsapis.ru/compute/v1/projects/<имя проекта>/images/<имя образа> \ 2 -H "Authorization: Bearer <IAM-токен>"
- Для создания образа из файла в Object Storage — ссылку на образ в бакете. Установите и настройте утилиту AWS CLI, а затем выполните команду:
  bash
  1 aws s3 presign s3://<имя бакета>/<путь к образу> \ 2 --expires-in 60480 \ 3 --endpoint-url https://storage.mwsapis.ru

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

Сетевой диск
Другой образ
Файл в Object Storage

1
{
2
  "metadata": {
3
    "name": "<уникальное имя образа>",
4
    "displayName": "<(опционально) отображаемое имя образа>",
5
    "description": "<(опционально) описание образа>"
6
  },
7
  "spec": {
8
    "family": "<(опционально) имя семейства ОС — например, ubuntu-2204-lts>",
9
    "source": {
10
      "diskId": "<идентификатор диска-источника>"
11
    },
12
    "minDiskSize": "<(опционально) минимальный размер диска, который можно создать из образа>"
13
  }
14
}

1
{
2
  "metadata": {
3
    "name": "<уникальное имя образа>",
4
    "displayName": "<(опционально) отображаемое имя образа>",
5
    "description": "<(опционально) описание образа>"
6
  },
7
  "spec": {
8
    "family": "<(опционально) имя семейства ОС — например, ubuntu-2204-lts>",
9
    "source": {
10
      "imageId": "<идентификатор образа-источника>"
11
    },
12
    "minDiskSize": "<(опционально) минимальный размер диска, который можно создать из образа>"
13
  }
14
}

1
{
2
  "metadata": {
3
    "name": "<уникальное имя образа>",
4
    "displayName": "<(опционально) отображаемое имя образа>",
5
    "description": "<(опционально) описание образа>"
6
  },
7
  "spec": {
8
    "family": "<(опционально) имя семейства ОС — например, ubuntu-2204-lts>",
9
    "source": {
10
      "externalUrl": "<ссылка на образ в Object Storage>"
11
    },
12
    "osType": "<тип ОС — LINUX или WINDOWS>",
13
    "minDiskSize": "<(опционально) минимальный размер диска, который можно создать из образа>"
14
  }
15
}

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

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

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

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

Удалить образ

Вы можете удалить образ, если больше не планируете его использовать.

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

В веб-консоли выберите нужный проект.
В списке сервисов выберите Compute → Образы. Откроется список образов.
Нажмите на значок ... для удаляемого образа и выберите Удалить.
Подтвердите удаление.

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

Если у вас нет утилиты MWS CLI:
1. Установите утилиту.
2. Инициализируйте профиль.
Выполните команду:
bash
```
1
mws compute image delete <имя образа>
```
В случае успешного удаления на экран будет выведен ответ success.

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

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

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

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