terraform-provider-stackitp.../docs/resources/volume.md
Ruben Hönle 53a3697850
feat(iaas): support for v2 API (#1070)
relates to STACKITTPR-313
2025-12-17 15:40:46 +01:00

2.4 KiB

page_title subcategory description
stackit_volume Resource - stackit Volume resource schema. Must have a region specified in the provider configuration.

stackit_volume (Resource)

Volume resource schema. Must have a region specified in the provider configuration.

Example Usage

resource "stackit_volume" "example" {
  project_id        = "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
  name              = "my_volume"
  availability_zone = "eu01-1"
  size              = 64
  labels = {
    "key" = "value"
  }
}

# Only use the import statement, if you want to import an existing volume
import {
  to = stackit_volume.import-example
  id = "${var.project_id},${var.region},${var.volume_id}"
}

Schema

Required

  • availability_zone (String) The availability zone of the volume.
  • project_id (String) STACKIT project ID to which the volume is associated.

Optional

  • description (String) The description of the volume.
  • labels (Map of String) Labels are key-value string pairs which can be attached to a resource container
  • name (String) The name of the volume.
  • performance_class (String) The performance class of the volume. Possible values are documented in Service plans BlockStorage
  • region (String) The resource region. If not defined, the provider region is used.
  • size (Number) The size of the volume in GB. It can only be updated to a larger value than the current size. Either size or source must be provided
  • source (Attributes) The source of the volume. It can be either a volume, an image, a snapshot or a backup. Either size or source must be provided (see below for nested schema)

Read-Only

  • id (String) Terraform's internal resource ID. It is structured as "project_id,region,volume_id".
  • server_id (String) The server ID of the server to which the volume is attached to.
  • volume_id (String) The volume ID.

Nested Schema for source

Required:

  • id (String) The ID of the source, e.g. image ID
  • type (String) The type of the source. Possible values are: volume, image, snapshot, backup.