Связаться с экспертомПопробовать бесплатно
Создавайте контент и получайте гранты!Готовы написать своё руководство? Участвуйте в контент-программе и получайте гранты на работу с облачными сервисами!
Подробнее о программе
Проект Яндекса
© 2026 ТОО «Облачные Сервисы Казахстан»

Получить информацию о публичном образе

Статья создана
Улучшена
Обновлена 31 августа 2026 г.
Открыть в Markdown

В процессе создания виртуальной машины вам необходимо выбрать образ машины с программным обеспечением, которое вы будете использовать.

Получить список публичных образов

Чтобы получить список публичных образов в Yandex Compute Cloud:

Список доступных публичных образов можно посмотреть при создании виртуальной машины:

  1. В консоли управления откройте каталог, в котором будет создана виртуальная машина.
  2. Перейдите в сервис Compute Cloud.
  3. На панели слева выберите Виртуальные машины и нажмите кнопку Создать виртуальную машину.
  4. В блоке Образ загрузочного диска нажмите кнопку Показать все продукты Marketplace. Отобразится список всех доступных публичных образов.

Если у вас еще нет интерфейса командной строки Yandex Cloud (CLI), установите и инициализируйте его.

Список публичных образов размещен в каталоге standard-images.

  • Получите полный список публичных образов.

    Чтобы получить список доступных образов с помощью CLI, выполните команду:

    yc compute image list \
  --folder-id standard-images

    Результат:

    +----------------------+-------------------------------------+--------------------------+----------------------+--------+
|          ID          |                NAME                 |          FAMILY          |     PRODUCT IDS      | STATUS |
+----------------------+-------------------------------------+--------------------------+----------------------+--------+
...
| fdvk34al8k5n******** | centos-7-1549279494                 | centos-7                 | dqni65lfhvv2******** | READY  |
| fdv7ooobjfl3******** | windows-2016-gvlk-1548913814        | windows-2016-gvlk        | dqnnc72gj2is******** | READY  |
| fdv4f5kv5cvf******** | ubuntu-1604-lts-1549457823          | ubuntu-1604-lts          | dqnnb6dc7640******** | READY  |
...
+----------------------+-------------------------------------+--------------------------+----------------------+--------+

    Где:

    • ID — идентификатор образа.

    • NAME — имя образа.

    • FAMILY — идентификатор семейства образов, к которому относится образ.

    • PRODUCT IDS — идентификаторы продуктов Yandex Cloud Marketplace, связанных с образом.

    • STATUS — текущий статус образа. Может принимать одно из значений:

      • STATUS_UNSPECIFIED — статус образа не определен.
      • CREATING — образ в процессе создания.
      • READY — образ готов к использованию.
      • ERROR — образ нельзя использовать из-за возникшей с ним проблемы.
      • DELETING — образ в процессе удаления.

    Примечание

    По умолчанию команда выводит лишь первые 1000 образов. Чтобы просмотреть полный список образов, задайте параметр --limit 0.

  • Получите список идентификаторов доступных семейств образов:

    yc compute image list \
  --folder-id standard-images \
  --limit 0 \
  --jq '.[].family' | sort | uniq

    Результат:

    ...
ubuntu-2204-lts
ubuntu-2204-lts-oslogin
ubuntu-2004-lts-gpu
...

  • Получите список доступных публичных образов определенного семейства:

    yc compute image list \
  --folder-id standard-images \
  | grep <идентификатор_семейства>

    Где <идентификатор_семейства> — идентификатор нужного семейства образов, например: ubuntu-2204-lts-oslogin.

    Результат:

    ...
| fd827n44qr0q******** | ubuntu-2204-lts-oslogin-v20240617 | ubuntu-2204-lts-oslogin | f2eofgd2cj0e******** | READY |
| fd827ukfjohd******** | ubuntu-2204-lts-oslogin-v20240701 | ubuntu-2204-lts-oslogin | f2evubhrcfsh******** | READY |
| fd82sdt0b96a******** | ubuntu-2204-lts-oslogin-v20240304 | ubuntu-2204-lts-oslogin | f2ecb2d55npl******** | READY |
...

Подробнее о команде yc compute image list читайте в справочнике CLI.

  1. Получите IAM-токен, используемый для аутентификации в примерах:

  2. Чтобы получить список публичных образов от Yandex Cloud, воспользуйтесь методом REST API List для ресурса Image или вызовом gRPC API ImageService/List. В запросе укажите следующие параметры:

    • В качестве идентификатора каталога укажите standard-images.
    • В каталоге много образов, поэтому укажите pageSize=1000 или используйте полученное значение nextPageToken, чтобы получить продолжение списка.
    • Результат запишите в файл, например, в output.json.

    Пример запроса:

    export IAM_TOKEN=CggaATEVAgA...
curl \
  --header "Authorization: Bearer ${IAM_TOKEN}" \
  "https://compute.api.yandexcloud.kz/compute/v1/images?folderId=standard-images&pageSize=1000" > output.json

    Примечание

    Чтобы записать в файл только информацию об образах определенного семейства образов, воспользуйтесь утилитой grep.

Посмотреть информацию обо всех доступных публичных образах также можно в Cloud Marketplace.

Получить подробную информацию о публичном образе

Чтобы получить подробную информацию о публичном образе, в том числе его идентификатор:

  1. В консоли управления выберите каталог.

  2. Перейдите в сервис Compute Cloud.

  3. На панели слева выберите Виртуальные машины и нажмите кнопку Создать виртуальную машину.

  4. В блоке Образ загрузочного диска нажмите кнопку Показать все продукты Marketplace.

    Отобразится список всех доступных публичных образов.

  5. В открывшемся списке выберите публичный образ, информацию о котором вы хотите получить. При необходимости воспользуйтесь строкой поиска или фильтром.

    В результате откроется окно с подробной информацией о публичном образе. Идентификатор образа отобразится внизу страницы с информацией в блоке Идентификаторы продукта в поле Образ ВМ.

Если у вас еще нет интерфейса командной строки Yandex Cloud (CLI), установите и инициализируйте его.

  1. Посмотрите описание команды CLI для получения информации о публичном образе:

    yc compute image get --help

  2. Получите информацию об образе, указав его идентификатор:

    yc compute image get <идентификатор_образа>

    Результат:

    id: fd8udtumfhpr********
folder_id: standard-images
created_at: "2026-08-10T18:33:51Z"
name: ubuntu-2404-lts-oslogin-v20260810
description: Ubuntu 24.04 lts with oslogin  v20260807040314
labels:
  version: "20260807040314"
  x-hopper-operation-id: d9pm50s8l14n********
  x-hopper-source-image-id: fd8go5if6b3c********
family: ubuntu-2404-lts-oslogin
size: "10737418240"
storage_size: "2969567232"
min_disk_size: "10737418240"
product_ids:
  - f2e00cd2gepc********
status: READY
os:
  type: LINUX
pooled: true
hardware_generation:
  legacy_features:
    pci_topology: PCI_TOPOLOGY_V2

    Идентификатор публичного образа указан в поле id.

  3. Получите список идентификаторов доступных семейств образов:

    yc compute image list \
  --folder-id standard-images \
  --limit 0 \
  --jq '.[].family' | sort | uniq

    Результат:

    ...
ubuntu-2204-lts
ubuntu-2204-lts-oslogin
ubuntu-2004-lts-gpu
...

  4. Получите подробную информацию о наиболее актуальном публичном образе семейства образов, указав полученный на предыдущем шаге идентификатор семейства:

    yc compute image get-latest-from-family <идентификатор_семейства> \
  --folder-id standard-images

    Результат:

    id: fd8udtumfhpr********
folder_id: standard-images
created_at: "2026-08-10T18:33:51Z"
name: ubuntu-2404-lts-oslogin-v20260810
description: Ubuntu 24.04 lts with oslogin  v20260807040314
labels:
  version: "20260807040314"
  x-hopper-operation-id: d9pm50s8l14n********
  x-hopper-source-image-id: fd8go5if6b3c********
family: ubuntu-2404-lts-oslogin
size: "10737418240"
storage_size: "2969567232"
min_disk_size: "10737418240"
product_ids:
  - f2e00cd2gepc********
status: READY
os:
  type: LINUX
pooled: true
hardware_generation:
  legacy_features:
    pci_topology: PCI_TOPOLOGY_V2

    Идентификатор публичного образа указан в поле id.

Terraform позволяет быстро создать облачную инфраструктуру в Yandex Cloud и управлять ею с помощью файлов конфигураций. В файлах конфигураций хранится описание инфраструктуры на языке HCL (HashiCorp Configuration Language). При изменении файлов конфигураций Terraform автоматически определяет, какая часть вашей конфигурации уже развернута, что следует добавить или удалить.

Terraform распространяется под лицензией Business Source License, а провайдер Yandex Cloud для Terraform — под лицензией MPL-2.0.

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

Если у вас еще нет Terraform, установите его и настройте провайдер Yandex Cloud.

Чтобы управлять инфраструктурой с помощью Terraform от имени сервисного аккаунта или пользовательских аккаунтов: аккаунта на Яндексе, федеративного аккаунта и локального пользователя, аутентифицируйтесь соответствующим способом.

Чтобы получить информацию о публичном образе с помощью Terraform:

  1. Добавьте в конфигурационный файл Terraform блоки data и output:

    data "yandex_compute_image" "my_image" {
  family = "<имя_семейства>"
}

output "image" {
  value = data.yandex_compute_image.my_image
}

    Где:

    • data "yandex_compute_image" — описание публичного образа в качестве источника данных:

    • output "image" — выходная переменная, которая содержит информацию о наиболее актуальном публичном образе выбранного семейства:

      • value — возвращаемое значение.

    Подробнее о параметрах источника данных yandex_compute_image читайте в документации провайдера.

  2. Создайте ресурсы:

    1. В терминале перейдите в директорию с конфигурационным файлом.

    2. Проверьте корректность конфигурации с помощью команды:

      terraform validate

      Если конфигурация является корректной, появится сообщение:

      Success! The configuration is valid.

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

      terraform plan

      В терминале будет выведен список ресурсов с параметрами. На этом этапе изменения не будут внесены. Если в конфигурации есть ошибки, Terraform на них укажет.

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

      terraform apply

    5. Подтвердите изменения: введите в терминале слово yes и нажмите Enter.

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

    terraform output

    Результат:

    image = {
  "created_at" = "2026-08-10T18:33:51Z"
  "description" = "Ubuntu 24.04 lts with oslogin  v20260807040314"
  "family" = "ubuntu-2404-lts-oslogin"
  "folder_id" = "standard-images"
  "hardware_generation" = tolist([
    {
      "generation2_features" = tolist([])
      "legacy_features" = tolist([
        {
          "pci_topology" = "PCI_TOPOLOGY_V2"
        },
      ])
    },
  ])
  "id" = "fd8udtumfhpr********"
  "image_id" = "fd8udtumfhpr********"
  "kms_key_id" = tostring(null)
  "labels" = tomap({
    "version" = "20260807040314"
    "x-hopper-operation-id" = "d9pm50s8l14n********"
    "x-hopper-source-image-id" = "fd8go5if6b3c********"
  })
  "min_disk_size" = 10
  "name" = "ubuntu-2404-lts-oslogin-v20260810"
  "os_type" = "linux"
  "pooled" = true
  "product_ids" = toset([
    "f2e00cd2gepc********",
  ])
  "size" = 2
  "status" = "ready"
}

    Идентификатор публичного образа указан в поле image_id.

Чтобы получить подробную информацию об образе по его идентификатору, воспользуйтесь методом REST API Get для ресурса Image или вызовом gRPC API ImageService/Get.

Чтобы получить подробную информацию о наиболее актуальном образе из семейства образов, воспользуйтесь методом REST API GetLatestByFamily для ресурса Image или вызовом gRPC API ImageService.GetLatestByFamily.

Полезные ссылки

Предыдущая
Работа с ВМ на базе публичного образа
Следующая
Обзор