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

Если у вас еще нет интерфейса командной строки 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-2204-lts-vgpu-v13
  ...
  

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

  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.cloud.yandex.net/compute/v1/images?folderId=standard-images&pageSize=1000" > output.json