feat(ske): add datasource to query provider options

Signed-off-by: Mauritz Uphoff <[email protected]>

Author: h3adex

docs/data-sources/image_v2.md

@@ -6,22 +6,22 @@ description: |-
   Image datasource schema. Must have a region specified in the provider configuration.
   ~> Important: When using the name, name_regex, or filter attributes to select images dynamically, be aware that image IDs may change frequently. Each OS patch or update results in a new unique image ID. If this data source is used to populate fields like boot_volume.source_id in a server resource, it may cause Terraform to detect changes and recreate the associated resource.
   To avoid unintended updates or resource replacements:
-  Prefer using a static image_id to pin a specific image version.If you accept automatic image updates but wish to suppress resource changes, use a lifecycle block to ignore relevant changes. For example:
-  
-  resource "stackit_server" "example" {
-    boot_volume = {
+   - Prefer using a static image_id to pin a specific image version.
+   - If you accept automatic image updates but wish to suppress resource changes, use a lifecycle block to ignore relevant changes. For example:
+  ```hcl
+  resource "stackitserver" "example" {
+    bootvolume = {
       size        = 64
-      source_type = "image"
-      source_id   = data.stackit_image.latest.id
+      sourcetype = "image"
+      sourceid   = data.stackit_image.latest.id
     }
-  
-    lifecycle {
-      ignore_changes = [boot_volume[0].source_id]
+  lifecycle {
+      ignorechanges = [bootvolume[0].source_id]
     }
   }
-  
+  ```
   You can also list available images using the STACKIT CLI https://github.com/stackitcloud/stackit-cli:
-  
+  bash
   stackit image list
   
   ~> This datasource 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.

docs/data-sources/resourcemanager_project.md

@@ -3,7 +3,7 @@
 page_title: "stackit_resourcemanager_project Data Source - stackit"
 subcategory: ""
 description: |-
-  Resource Manager project data source schema. To identify the project, you need to provider either project_id or container_id. If you provide both, project_id will be used.
+  Resource Manager project data source schema. To identify the project, you need to provider either projectid or containerid. If you provide both, project_id will be used.
 ---
 
 # stackit_resourcemanager_project (Data Source)

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/ephemeral-resources/access_token.md

@@ -5,35 +5,29 @@ subcategory: ""
 description: |-
   Affinity Group schema.
   Usage with server
-  
-  resource "stackit_affinity_group" "affinity-group" {
+  ```terraform
+  resource "stackitaffinitygroup" "affinity-group" {
     project_id = "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
     name       = "example-key-pair"
     policy     = "soft-affinity"
   }
-  
-  resource "stackit_server" "example-server" {
-    project_id = "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
+  resource "stackitserver" "example-server" {
+    projectid = "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
     name       = "example-server"
-    boot_volume = {
+    bootvolume = {
       size        = 64
-      source_type = "image"
-      source_id   = "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
+      sourcetype = "image"
+      sourceid   = "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
     }
-    affinity_group    = stackit_affinity_group.affinity-group.affinity_group_id
-    availability_zone = "eu01-1"
-    machine_type      = "g2i.1"
+    affinitygroup    = stackitaffinitygroup.affinity-group.affinitygroupid
+    availabilityzone = "eu01-1"
+    machinetype      = "g2i.1"
   }
-  
-  
+  ```
   Policies
-  
-  hard-affinity- All servers launched in this group will be hosted on the same compute node.
-  hard-anti-affinity- All servers launched in this group will be
-  hosted on different compute nodes.
-  soft-affinity- All servers launched in this group will be hosted
-  on the same compute node if possible, but if not possible they still will be scheduled instead of failure.
-  soft-anti-affinity- All servers launched in this group will be hosted on different compute nodes if possible,
+  hard-affinity- All servers launched in this group will be hosted on the same compute node.hard-anti-affinity- All servers launched in this group will be
+  hosted on different compute nodes.soft-affinity- All servers launched in this group will be hosted
+  on the same compute node if possible, but if not possible they still will be scheduled instead of failure.soft-anti-affinity- All servers launched in this group will be hosted on different compute nodes if possible,
   but if not possible they still will be scheduled instead of failure.
 ---
 

docs/resources/affinity_group.md

@@ -5,24 +5,24 @@ subcategory: ""
 description: |-
   Key pair resource schema. Must have a region specified in the provider configuration. Allows uploading an SSH public key to be used for server authentication.
   Usage with server
-  
-  resource "stackit_key_pair" "keypair" {
+  ```terraform
+  resource "stackitkeypair" "keypair" {
     name       = "example-key-pair"
-    public_key = chomp(file("path/to/id_rsa.pub"))
+    publickey = chomp(file("path/to/idrsa.pub"))
   }
-  
-  resource "stackit_server" "example-server" {
-    project_id = "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
+  resource "stackitserver" "example-server" {
+    projectid = "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
     name       = "example-server"
-    boot_volume = {
+    bootvolume = {
       size        = 64
-      source_type = "image"
-      source_id   = "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
+      sourcetype = "image"
+      sourceid   = "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
     }
-    availability_zone = "eu01-1"
-    machine_type      = "g2i.1"
-    keypair_name      = "example-key-pair"
+    availabilityzone = "eu01-1"
+    machinetype      = "g2i.1"
+    keypairname      = "example-key-pair"
   }
+  ```
 ---
 
 # stackit_key_pair (Resource)

docs/resources/key_pair.md

@@ -6,20 +6,19 @@ description: |-
   AI Model Serving Auth Token Resource schema.
   Example Usage
   Automatically rotate AI model serving token
-  
-  resource "time_rotating" "rotate" {
-      rotation_days = 80
+  ```terraform
+  resource "timerotating" "rotate" {
+      rotationdays = 80
   }
-  
-  resource "stackit_modelserving_token" "example" {
+  resource "stackitmodelservingtoken" "example" {
       project_id = "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
       name       = "Example token"
-      
-      rotate_when_changed = {
-          rotation = time_rotating.rotate.id
-      }
+  rotate_when_changed = {
+      rotation = time_rotating.rotate.id
+  }
   
   }
+  ```
 ---
 
 # stackit_modelserving_token (Resource)