[Yandex Cloud documentation](../../../index.md) > [Yandex Compute Cloud](../../index.md) > [Step-by-step guides](../index.md) > Images with pre-installed software > Getting a list of public images

# Getting a list of public images

When creating a virtual machine, you need to select an [image](../../concepts/image.md) with the software that you want to use.

{% list tabs group=instructions %}

- Management console {#console}

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

  1. In the [management console](https://console.yandex.cloud), open the folder where you want to create your VM.
  1. At the top right, click **Create resource**.
  1. Select **Virtual machine instance** from the list that opens.
  1. Under **Boot disk image**, click **Show all Marketplace products**. You will see a list of all available public images.

  To [view information](get-info.md) about a specific image, click ![image](../../../_assets/console-icons/circle-info.svg).

- CLI {#cli}

  If you do not have the Yandex Cloud CLI yet, [install and initialize it](../../../cli/quickstart.md#install).

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

  * To get a list of available images using the CLI, run this command:
    
    ```bash
    yc compute image list --folder-id standard-images
    ```
    
    Result:
    
    ```text
    +----------------------+-------------------------------------+--------------------------+----------------------+--------+
    |          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](../../concepts/image.md#family) the image belongs to.
    * `PRODUCT IDS`: IDs of Yandex Cloud Marketplace [products](../../../marketplace/concepts/product.md) 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 info %}

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

      {% endnote %}

  * To get a list of IDs of available [image families](../../concepts/image.md#family), run the following command:

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

      Result:

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

  * To get a list of available public images belonging to a particular family, run this command:

      ```bash
      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:

      ```text
      ...
      | 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](../../../cli/cli-ref/compute/cli-ref/image/list.md).

- API {#api}

  1. Get an [IAM token](../../../iam/concepts/authorization/iam-token.md) used for authentication in these examples:
     * [Guide](../../../iam/operations/iam-token/create.md) for a Yandex account user.
     * [Guide](../../../iam/operations/iam-token/create-for-sa.md) for service accounts.
     * [Guide](../../../iam/operations/iam-token/create-for-federation.md) for a federated account.
     * [Guide](../../../iam/operations/iam-token/create-for-local.md) for a local account.
  1. Get a list of public images from Yandex Cloud using the [list](../../api-ref/Image/list.md) REST API method for the [Image](../../api-ref/Image/index.md) resource or the [ImageService/List](../../api-ref/grpc/Image/list.md) 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`:

    ```bash
    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
    ```

{% endlist %}

You can also view information about all available public images in [Cloud Marketplace](https://yandex.cloud/en/marketplace).