Yandex Cloud
Search
Contact UsTry it for free
  • Customer Stories
  • Documentation
  • Blog
  • All Services
  • System Status
  • Marketplace
    • Featured
    • Infrastructure & Network
    • Data Platform
    • AI for business
    • Security
    • DevOps tools
    • Serverless
    • Monitoring & Resources
  • All Solutions
    • By industry
    • By use case
    • Economics and Pricing
    • Security
    • Technical Support
    • Start testing with double trial credits
    • Cloud credits to scale your IT product
    • Gateway to Russia
    • Cloud for Startups
    • Center for Technologies and Society
    • Yandex Cloud Partner program
    • Price calculator
    • Pricing plans
  • Customer Stories
  • Documentation
  • Blog
© 2026 Direct Cursus Technology L.L.C.
Terraform in Yandex Cloud
  • Getting started
  • Solution library
    • Overview
    • Release notes
          • compute_disk
          • compute_disk_placement_group
          • compute_filesystem
          • compute_gpu_cluster
          • compute_image
          • compute_instance
          • compute_instance_group
          • compute_placement_group
          • compute_snapshot
          • compute_snapshot_schedule
          • loadtesting_agent

In this article:

  • Example usage
  • Arguments & Attributes Reference
  1. Terraform reference
  2. Resources
  3. Compute Cloud
  4. Data Sources
  5. compute_image

yandex_compute_image (DataSource)

Written by
Yandex Cloud
Updated at February 9, 2026
  • Example usage
  • Arguments & Attributes Reference

Get information about a Yandex Compute image. For more information, see the official documentation.

Warning

Either image_id, family or name must be specified.

Warning

If you specify family without folder_id then lookup takes place in the 'standard-images' folder.

Example usageExample usage

//
// Get information about existing Compute Image
//
data "yandex_compute_image" "my_image" {
  family = "ubuntu-1804-lts"
}

// You can use "data.yandex_compute_image.my_image.id" identifier 
// as reference to existing resource.
resource "yandex_compute_instance" "default" {
  # ...
  boot_disk {
    initialize_params {
      image_id = data.yandex_compute_image.my_image.id
    }
  }
  # ...
  lifecycle {
    ignore_changes = [boot_disk[0].initialize_params[0].image_id]
  }
}

Arguments & Attributes ReferenceArguments & Attributes Reference

  • created_at (Read-Only) (String). The creation timestamp of the resource.
  • description (String). The resource description.
  • family (String). The name of the image family to which this image belongs.
  • folder_id (String). The folder identifier that resource belongs to. If it is not provided, the default provider folder-id is used.
  • hardware_generation [Block]. Hardware generation and its features, which will be applied to the instance when this image is used for creating a boot disk. Provide this property if you wish to override this value, which otherwise is inherited from the source.
    • generation2_features [Block]. A newer hardware generation, which always uses PCI_TOPOLOGY_V2 and UEFI boot.
    • legacy_features [Block]. Defines the first known hardware generation and its features.
      • pci_topology (String). A variant of PCI topology, one of PCI_TOPOLOGY_V1 or PCI_TOPOLOGY_V2.
  • id (String).
  • image_id (String). The ID of a specific image.
  • kms_key_id (Read-Only) (String). ID of KMS symmetric key used to encrypt image.
  • labels (Map Of String). A set of key/value label pairs which assigned to resource.
  • min_disk_size (Number). Minimum size in GB of the disk that will be created from this image.
  • name (String). The resource name.
  • os_type (String). Operating system type that is contained in the image. Possible values: LINUX, WINDOWS.
  • pooled (Bool). Optimize the image to create a disk.
  • product_ids (Set Of String). License IDs that indicate which licenses are attached to this image.
  • size (Read-Only) (Number). The size of the image, specified in GB.
  • status (Read-Only) (String). The status of the image.

Was the article helpful?

Previous
compute_gpu_cluster
Next
compute_instance
© 2026 Direct Cursus Technology L.L.C.