Discuss with expertTry it for free
© 2026 Direct Cursus Technology L.L.C.

Getting public image info

Written by
Updated at September 15, 2026
View in Markdown

When creating a VM instance, you need to select an image with the software you want to use.

Getting a list of public images

To get a list of public images in Yandex Compute Cloud:

You can view a list of public images when creating a virtual machine:

  1. In the management console, open the folder where you want to create your VM.
  2. Navigate to Compute Cloud.
  3. In the left-hand panel, select  Virtual machines and click Create virtual machine.
  4. Under Boot disk image, click Show all Marketplace products. You will see a list of all available public images.

If you do not have the Yandex Cloud CLI yet, install and initialize it.

A list of public images resides in the standard-images folder.

  • Get a list of all public images.

    To get a list of available images using the CLI, run this command:

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

    Result:

    +----------------------+-------------------------------------+--------------------------+----------------------+--------+
|          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  |
...
+----------------------+-------------------------------------+--------------------------+----------------------+--------+

    Where:

    • ID: Image ID.

    • NAME: Image name.

    • FAMILY: ID of the image family the image belongs to.

    • PRODUCT IDS: IDs of Yandex Cloud Marketplace products associated with the image.

    • STATUS: Current status of the image. It may take one of the following values:

      • STATUS_UNSPECIFIED: Image status is not defined.
      • CREATING: Image is being created.
      • READY: Image is ready to use.
      • ERROR: You cannot use the image due to an issue.
      • DELETING: Image is being deleted.

    Note

    By default, the command returns only the first 1,000 images. To view the full list of images, include the --limit 0 parameter.

  • Get a list of IDs of available image families:

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

    Result:

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

  • Get a list of available public images belonging to a particular family:

    yc compute image list \
  --folder-id standard-images \
  | grep <family_ID>

    Where <family_ID> is the image family ID, e.g., ubuntu-2204-lts-oslogin.

    Result:

    ...
| 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 |
...

For more information about the yc compute image list command, see the CLI reference.

  1. Get an IAM token used for authentication in these examples:

    • Guide for a Yandex account user.
    • Guide for a service account.
    • Guide for a federated account.
    • Guide for a local account.

  2. To get a list of Yandex Cloud public images, use the List REST API method for the Image resource or the ImageService/List gRPC API call. In your request, specify the following parameters:

    • Specify standard-images as the folder ID.
    • The folder contains many images, so specify pageSize=1000 or use the obtained value of nextPageToken to get the next page.
    • Write the result to a file, e.g., output.json.

    Request example:

    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

    Note

    To only write info about a specific image family to a file, use grep.

You can also view information about all available public images in Cloud Marketplace.

Getting detailed information about a public image

To get detailed information about a public image, including its ID:

  1. In the management console, select the folder.

  2. Navigate to Compute Cloud.

  3. In the left-hand panel, select  Virtual machines and click Create virtual machine.

  4. Under Boot disk image, click Show all Marketplace products.

    You will see a list of all available public images.

  5. In the list that opens, select the public image you need. If required, use the search bar or filter.

    The action will open a window with detailed information about the public image. The image ID is displayed at the bottom of the page under Product IDs in the VM Image field.

If you do not have the Yandex Cloud CLI yet, install and initialize it.

  1. See the description of the CLI command for getting information about a public image:

    yc compute image get --help

  2. Get image info by specifying its ID:

    yc compute image get <image_ID>

    Result:

    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

    The public image ID is specified in the id field.

  3. Get a list of IDs of available image families:

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

    Result:

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

  4. Get information about the latest public image within a specific image family by specifying the family ID you obtained in the previous step:

    yc compute image get-latest-from-family <family_ID> \
  --folder-id standard-images

    Result:

    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

    The public image ID is specified in the id field.

With Terraform, you can quickly create a cloud infrastructure in Yandex Cloud and manage it using configuration files. These files store the infrastructure description written in HashiCorp Configuration Language (HCL). If you change the configuration files, Terraform automatically detects which part of your configuration is already deployed, and what should be added or removed.

Terraform is distributed under the Business Source License. The Yandex Cloud provider for Terraform is distributed under the MPL-2.0 license.

For more information about the provider resources, see the guides on the Terraform website or its mirror.

If you do not have Terraform yet, install it and configure the Yandex Cloud provider.

To manage infrastructure using Terraform under a service account or user accounts (a Yandex account, a federated account, or a local user), authenticate using the appropriate method.

To get public image info using Terraform:

  1. Add the data and output sections to the Terraform configuration file:

    data "yandex_compute_image" "my_image" {
  family = "<family_name>"
}

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

    Where:

    • data "yandex_compute_image": Description of the public image as a data source:

    • output "instance_domain": Output variable that contains information about the latest public image in this family:

      • value: Return value.

    For more on the properties of the yandex_compute_image data source, see this provider guide.

  2. Create the resources:

    1. In the terminal, navigate to the configuration file directory.

    2. Make sure the configuration is correct using this command:

      terraform validate

      If the configuration is valid, you will get this message:

      Success! The configuration is valid.

    3. Run this command:

      terraform plan

      You will see a list of resources and their properties. No changes will be made at this step. Terraform will show any errors in the configuration.

    4. Apply the configuration changes:

      terraform apply

    5. Type yes and press Enter to confirm the changes.

    Terraform will create all required resources and display their output variables. To check the results, run this command:

    terraform output

    Result:

    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"
}

    The public image ID is specified in the image_id field.

To get detailed information about an image by its ID, use the Get REST API method for the Image resource or the ImageService/Get gRPC API call.

To get detailed information about the latest image within an image family, use the GetLatestByFamily REST API method for the Image resource or the ImageService/GetLatestByFamily gRPC API call.

Useful links

Previous
Running a VM from a public image
Next
Overview