terraform-provider-stackitp.../docs/data-sources/image.md
João Palet 700bdc90d0
Implement new stackit_image resource and datasource (#609)
* feat: Implement image resource and datasource

* feat: Add remaining config options

* feat: Make protected field only computed

* feat: Update dependency to use IaaS beta API

* fix: Minor fix in acc test

---------

Co-authored-by: Vicente Pinto <vicente.pinto@freiheit.com>
2025-01-09 11:57:25 +00:00

3.1 KiB

page_title subcategory description
stackit_image Data Source - stackit Image datasource schema. Must have a region specified in the provider configuration. ~> This resource is in beta and may be subject to breaking changes in the future. Use with caution. See our guide https://registry.terraform.io/providers/stackitcloud/stackit/latest/docs/guides/opting_into_beta_resources for how to opt-in to use beta resources.

stackit_image (Data Source)

Image datasource schema. Must have a region specified in the provider configuration.

~> This resource is in beta and may be subject to breaking changes in the future. Use with caution. See our guide for how to opt-in to use beta resources.

Example Usage

data "stackit_image" "example" {
  project_id = "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
  image_id   = "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
}

Schema

Required

  • image_id (String) The image ID.
  • project_id (String) STACKIT project ID to which the image is associated.

Read-Only

  • checksum (Attributes) Representation of an image checksum. (see below for nested schema)
  • config (Attributes) Properties to set hardware and scheduling settings for an image. (see below for nested schema)
  • disk_format (String) The disk format of the image.
  • id (String) Terraform's internal resource ID. It is structured as "project_id,image_id".
  • labels (Map of String) Labels are key-value string pairs which can be attached to a resource container
  • min_disk_size (Number) The minimum disk size of the image in GB.
  • min_ram (Number) The minimum RAM of the image in MB.
  • name (String) The name of the image.
  • protected (Boolean) Whether the image is protected.
  • scope (String) The scope of the image.

Nested Schema for checksum

Read-Only:

  • algorithm (String) Algorithm for the checksum of the image data.
  • digest (String) Hexdigest of the checksum of the image data.

Nested Schema for config

Read-Only:

  • boot_menu (Boolean) Enables the BIOS bootmenu.
  • cdrom_bus (String) Sets CDROM bus controller type.
  • disk_bus (String) Sets Disk bus controller type.
  • nic_model (String) Sets virtual network interface model.
  • operating_system (String) Enables operating system specific optimizations.
  • operating_system_distro (String) Operating system distribution.
  • operating_system_version (String) Version of the operating system.
  • rescue_bus (String) Sets the device bus when the image is used as a rescue image.
  • rescue_device (String) Sets the device when the image is used as a rescue image.
  • secure_boot (Boolean) Enables Secure Boot.
  • uefi (Boolean) Enables UEFI boot.
  • video_model (String) Sets Graphic device model.
  • virtio_scsi (Boolean) Enables the use of VirtIO SCSI to provide block device access. By default instances use VirtIO Block.