feat(ske): add datasource to query provider options

docs/data-sources/ske_kubernetes_versions.md

@@ -0,0 +1,60 @@
+---
+# generated by https://github.com/hashicorp/terraform-plugin-docs
+page_title: "stackit_ske_kubernetes_versions Data Source - stackit"
+subcategory: ""
+description: |-
+  Returns Kubernetes versions as reported by the SKE provider options API for the given region.
+---
+
+# stackit_ske_kubernetes_versions (Data Source)
+
+Returns Kubernetes versions as reported by the SKE provider options API for the given region.
+
+## Example Usage
+
+```terraform
+data "stackit_ske_kubernetes_versions" "example" {
+  version_state = "SUPPORTED"
+}
+
+resource "stackit_ske_cluster" "example" {
+  project_id         = "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
+  name               = "example"
+  kubernetes_version = data.stackit_ske_kubernetes_versions.example.kubernetes_versions.0.version
+  node_pools = [
+    {
+      name               = "np-example"
+      machine_type       = "x.x"
+      os_version         = "x.x.x"
+      os_name            = "xxx"
+      minimum            = "2"
+      maximum            = "3"
+      availability_zones = ["eu01-1"]
+      volume_type        = "storage_premium_perf6"
+      volume_size        = "48"
+    }
+  ]
+}
+```
+
+<!-- schema generated by tfplugindocs -->
+## Schema
+
+### Optional
+
+- `region` (String) Region override. If omitted, the provider’s region will be used.
+- `version_state` (String) If specified, only returns Kubernetes versions with this version state. Possible values are: `UNSPECIFIED`, `SUPPORTED`.
+
+### Read-Only
+
+- `kubernetes_versions` (Attributes List) Kubernetes versions and their metadata. (see [below for nested schema](#nestedatt--kubernetes_versions))
+
+<a id="nestedatt--kubernetes_versions"></a>
+### Nested Schema for `kubernetes_versions`
+
+Read-Only:
+
+- `expiration_date` (String) Expiration date of the version in RFC3339 format.
+- `feature_gates` (Map of String) Map of available feature gates for this version.
+- `state` (String) State of the kubernetes version.
+- `version` (String) Kubernetes version string (e.g., `1.33.6`).

docs/data-sources/ske_machine_image_versions.md

@@ -0,0 +1,78 @@
+---
+# generated by https://github.com/hashicorp/terraform-plugin-docs
+page_title: "stackit_ske_machine_image_versions Data Source - stackit"
+subcategory: ""
+description: |-
+  Returns a list of supported Kubernetes machine image versions for the cluster nodes.
+---
+
+# stackit_ske_machine_image_versions (Data Source)
+
+Returns a list of supported Kubernetes machine image versions for the cluster nodes.
+
+## Example Usage
+
+```terraform
+data "stackit_ske_machine_image_versions" "example" {
+  version_state = "SUPPORTED"
+}
+
+locals {
+  flatcar_supported_version = one(flatten([
+    for mi in data.stackit_ske_machine_image_versions.example.machine_images : [
+      for v in mi.versions :
+      v.version
+      if mi.name == "flatcar" # or ubuntu
+    ]
+  ]))
+}
+
+resource "stackit_ske_cluster" "example" {
+  project_id         = "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
+  name               = "example"
+  kubernetes_version = "x.x"
+  node_pools = [
+    {
+      name               = "np-example"
+      machine_type       = "x.x"
+      os_version         = local.flatcar_supported_version
+      os_name            = "flatcar"
+      minimum            = "2"
+      maximum            = "3"
+      availability_zones = ["eu01-1"]
+      volume_type        = "storage_premium_perf6"
+      volume_size        = "48"
+    }
+  ]
+}
+```
+
+<!-- schema generated by tfplugindocs -->
+## Schema
+
+### Optional
+
+- `region` (String) Region override. If omitted, the provider’s region will be used.
+- `version_state` (String) Filter returned machine image versions by their state. Possible values are: `UNSPECIFIED`, `SUPPORTED`.
+
+### Read-Only
+
+- `machine_images` (Attributes List) Supported machine image types and versions. (see [below for nested schema](#nestedatt--machine_images))
+
+<a id="nestedatt--machine_images"></a>
+### Nested Schema for `machine_images`
+
+Read-Only:
+
+- `name` (String) Name of the OS image (e.g., `ubuntu` or `flatcar`).
+- `versions` (Attributes List) Supported versions of the image. (see [below for nested schema](#nestedatt--machine_images--versions))
+
+<a id="nestedatt--machine_images--versions"></a>
+### Nested Schema for `machine_images.versions`
+
+Read-Only:
+
+- `cri` (List of String) Container runtimes supported (e.g., `containerd`).
+- `expiration_date` (String) Expiration date of the version in RFC3339 format.
+- `state` (String) State of the image version.
+- `version` (String) Machine image version string.

docs/resources/ske_cluster.md

@@ -25,9 +25,12 @@ resource "stackit_ske_cluster" "example" {
       name               = "np-example"
       machine_type       = "x.x"
       os_version         = "x.x.x"
+      os_name            = "xxx"
       minimum            = "2"
       maximum            = "3"
       availability_zones = ["eu01-3"]
+      volume_type        = "storage_premium_perf6"
+      volume_size        = "48"
     }
   ]
   maintenance = {

examples/data-sources/stackit_ske_kubernetes_versions/data-source.tf

@@ -0,0 +1,22 @@
+data "stackit_ske_kubernetes_versions" "example" {
+  version_state = "SUPPORTED"
+}
+
+resource "stackit_ske_cluster" "example" {
+  project_id         = "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
+  name               = "example"
+  kubernetes_version = data.stackit_ske_kubernetes_versions.example.kubernetes_versions.0.version
+  node_pools = [
+    {
+      name               = "np-example"
+      machine_type       = "x.x"
+      os_version         = "x.x.x"
+      os_name            = "xxx"
+      minimum            = "2"
+      maximum            = "3"
+      availability_zones = ["eu01-1"]
+      volume_type        = "storage_premium_perf6"
+      volume_size        = "48"
+    }
+  ]
+}

examples/data-sources/stackit_ske_machine_image_versions/data-source.tf

@@ -0,0 +1,32 @@
+data "stackit_ske_machine_image_versions" "example" {
+  version_state = "SUPPORTED"
+}
+
+locals {
+  flatcar_supported_version = one(flatten([
+    for mi in data.stackit_ske_machine_image_versions.example.machine_images : [
+      for v in mi.versions :
+      v.version
+      if mi.name == "flatcar" # or ubuntu
+    ]
+  ]))
+}
+
+resource "stackit_ske_cluster" "example" {
+  project_id         = "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
+  name               = "example"
+  kubernetes_version = "x.x"
+  node_pools = [
+    {
+      name               = "np-example"
+      machine_type       = "x.x"
+      os_version         = local.flatcar_supported_version
+      os_name            = "flatcar"
+      minimum            = "2"
+      maximum            = "3"
+      availability_zones = ["eu01-1"]
+      volume_type        = "storage_premium_perf6"
+      volume_size        = "48"
+    }
+  ]
+}

examples/resources/stackit_ske_cluster/resource.tf

@@ -7,9 +7,12 @@ resource "stackit_ske_cluster" "example" {
       name               = "np-example"
       machine_type       = "x.x"
       os_version         = "x.x.x"
+      os_name            = "xxx"
       minimum            = "2"
       maximum            = "3"
       availability_zones = ["eu01-3"]
+      volume_type        = "storage_premium_perf6"
+      volume_size        = "48"
     }
   ]
   maintenance = {