terraform-provider-stackitprivatepreview/docs/resources/kms_keyring.md

page_title	subcategory	description
stackit_kms_keyring Resource - stackit		KMS Keyring resource schema. Uses the default_region specified in the provider configuration as a fallback in case no region is defined on resource level. ~> Keyrings will not be destroyed by terraform during a terraform destroy. They will just be thrown out of the Terraform state and not deleted on API side. This way we can ensure no keyring setups are deleted by accident and it gives you the option to recover your keys within the grace period.

stackit_kms_keyring (Resource)

KMS Keyring resource schema. Uses the default_region specified in the provider configuration as a fallback in case no region is defined on resource level.

~> Keyrings will not be destroyed by terraform during a terraform destroy. They will just be thrown out of the Terraform state and not deleted on API side. This way we can ensure no keyring setups are deleted by accident and it gives you the option to recover your keys within the grace period.

Example Usage

resource "stackit_kms_keyring" "example" {
  project_id   = "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
  display_name = "example name"
  description  = "example description"
}

Schema

Required

• display_name (String) The display name to distinguish multiple keyrings.
• project_id (String) STACKIT project ID to which the keyring is associated.

Optional

• description (String) A user chosen description to distinguish multiple keyrings.
• region (String) The resource region. If not defined, the provider region is used.

Read-Only

• id (String) Terraform's internal resource ID. It is structured as "project_id,region,keyring_id".
• keyring_id (String) An auto generated unique id which identifies the keyring.