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

Статья создана

Yandex Cloud

Улучшена

Обновлена 21 апреля 2025 г.

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

Вы можете получить идентификатор или другую информацию о публичном образе.

Получить идентификатор публичного образа

Консоль управления

CLI

Terraform

API

В консоли управления перейдите в каталог, в котором хотите создать виртуальную машину.
Выберите сервис Compute Cloud.
Справа сверху нажмите кнопку Создать ресурс.
В открывшемся списке выберите Виртуальная машина.
В блоке Образ загрузочного диска нажмите рядом с нужным публичным образом.
В блоке Идентификаторы продукта отобразится image_id — идентификатор публичного образа.

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

По умолчанию используется каталог, указанный при создании профиля CLI. Чтобы изменить каталог по умолчанию, используйте команду yc config set folder-id <идентификатор_каталога>. Также для любой команды вы можете указать другой каталог с помощью параметров --folder-name или --folder-id.

Посмотрите описание команды CLI для получения информации о публичном образе диска:
```
yc compute image get --help
```
Получите идентификатор публичного образа, указав название семейства операционных систем:
```
yc compute image get-latest-from-family <имя_семейства> --folder-id standard-images
```
Чтобы узнать название семейства образа, получите список образов в каталоге.

Результат:
```
id: fd85u0rct32prepgjlv0
folder_id: standard-images
created_at: "2024-03-11T10:57:40Z"
name: ubuntu-22-04-lts-v20240311
description: ubuntu 22.04 lts
family: ubuntu-2204-lts
storage_size: "7633633280"
min_disk_size: "8589934592"
product_ids:
  - f2ef01lju2nsansfdahf
status: READY
os:
  type: LINUX
pooled: true
```
Идентификатор публичного образа отобразится в строке 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 блоки data и output:
```
data "yandex_compute_image" "my_image" {
  family = "<имя_семейства>"
}

output "image" {
  value = data.yandex_compute_image.my_image.image_id
}
```
Где:
- data "yandex_compute_image" — описание публичного образа в качестве источника данных:
  - family — название семейства операционных систем публичного образа. Чтобы узнать название семейства образа, получите список образов в каталоге.
- output "image" — выходная переменная, которая содержит идентификатор публичного образа:
  - value — возвращаемое значение.
Более подробно о параметрах источника данных yandex_compute_image см. в документации провайдера.
Создайте ресурсы:
1. В терминале перейдите в папку, где вы отредактировали конфигурационный файл.
2. Проверьте корректность конфигурационного файла с помощью команды:
```
terraform validate
```
  Если конфигурация является корректной, появится сообщение:
```
Success! The configuration is valid.
```
3. Выполните команду:
```
terraform plan
```
  В терминале будет выведен список ресурсов с параметрами. На этом этапе изменения не будут внесены. Если в конфигурации есть ошибки, Terraform на них укажет.
4. Примените изменения конфигурации:
```
terraform apply
```
5. Подтвердите изменения: введите в терминале слово yes и нажмите Enter.
Terraform создаст все требуемые ресурсы и отобразит значения выходных переменных в терминале. Чтобы проверить результат, выполните команду:
```
terraform output
```
Результат:
```
image = "fd85u0rct32prepgjlv0"
```

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