feat(kms): add multi API version support (#5507)

relates to STACKITSDK-337

Co-authored-by: Ruben Hoenle <Ruben.Hoenle@stackit.cloud>

Author: stackit-pipeline

CHANGELOG.md

@@ -93,6 +93,12 @@
   - `v1api`: New package which should be used for communication with the STACKIT redis API in the future
   - **Deprecation:** The contents in the root of this SDK module including the `wait` package are marked as deprecated and will be removed after 2026-09-30. Switch to the new `v0api` package instead.
   - **Dependencies:** Bump STACKIT SDK core module from `v0.21.1` to `v0.22.0`
+- `kms`: [v1.4.0](services/kms/CHANGELOG.md#v140)
+  - **Feature:** Introduction of multi API version support for the kms SDK module. For more details please see the announcement on GitHub: https://github.com/stackitcloud/stackit-sdk-go/discussions/5062
+  - `v1api`: New package which can be used for communication with the kms v1 API
+  - `v1betaapi`: New package which can be used for communication with the kms v1 beta API
+  - **Deprecation:** The contents in the root of this SDK module including the `wait` package are marked as deprecated and will be removed after 2026-09-30. Switch to the new packages for the available API versions instead.
+  - **Dependencies:** Bump STACKIT SDK core module from `v0.21.1` to `v0.22.0`
 
 ## Release (2026-02-20)
 - `core`: [v0.21.1](core/CHANGELOG.md#v0211) 

examples/kms/go.mod

@@ -2,8 +2,11 @@ module github.com/stackitcloud/stackit-sdk-go/examples/kms
 
 go 1.21
 
+// This is not needed in production. This is only here to point the golangci linter to the local version instead of the last release on GitHub.
+replace github.com/stackitcloud/stackit-sdk-go/services/kms => ../../services/kms
+
 require (
-	github.com/stackitcloud/stackit-sdk-go/core v0.21.1
+	github.com/stackitcloud/stackit-sdk-go/core v0.22.0
 	github.com/stackitcloud/stackit-sdk-go/services/kms v1.3.2
 )
 

examples/kms/go.sum

@@ -4,7 +4,5 @@ github.com/google/go-cmp v0.7.0 h1:wk8382ETsv4JYUZwIsn6YpYiWiBsYLSJiTsyBybVuN8=
 github.com/google/go-cmp v0.7.0/go.mod h1:pXiqmnSA92OHEEa9HXL2W4E7lf9JzCmGVUdgjX3N/iU=
 github.com/google/uuid v1.6.0 h1:NIvaJDMOsjHA8n1jAhLSgzrAzy1Hgr+hNrb57e+94F0=
 github.com/google/uuid v1.6.0/go.mod h1:TIyPZe4MgqvfeYDBFedMoGGpEw/LqOeaOT+nhxU+yHo=
-github.com/stackitcloud/stackit-sdk-go/core v0.21.1 h1:Y/PcAgM7DPYMNqum0MLv4n1mF9ieuevzcCIZYQfm3Ts=
-github.com/stackitcloud/stackit-sdk-go/core v0.21.1/go.mod h1:osMglDby4csGZ5sIfhNyYq1bS1TxIdPY88+skE/kkmI=
-github.com/stackitcloud/stackit-sdk-go/services/kms v1.3.2 h1:2ulSL2IkIAKND59eAjbEhVkOoBMyvm48ojwz1a3t0U0=
-github.com/stackitcloud/stackit-sdk-go/services/kms v1.3.2/go.mod h1:cuIaMMiHeHQsbvy7BOFMutoV3QtN+ZBx7Tg3GmYUw7s=
+github.com/stackitcloud/stackit-sdk-go/core v0.22.0 h1:6rViz7GnNwXSh51Lur5xuDzO8EWSZfN9J0HvEkBKq6c=
+github.com/stackitcloud/stackit-sdk-go/core v0.22.0/go.mod h1:osMglDby4csGZ5sIfhNyYq1bS1TxIdPY88+skE/kkmI=

examples/kms/kms.go

@@ -6,8 +6,8 @@ import (
 	"os"
 
 	"github.com/stackitcloud/stackit-sdk-go/core/utils"
-	"github.com/stackitcloud/stackit-sdk-go/services/kms"
-	"github.com/stackitcloud/stackit-sdk-go/services/kms/wait"
+	kms "github.com/stackitcloud/stackit-sdk-go/services/kms/v1api"
+	"github.com/stackitcloud/stackit-sdk-go/services/kms/v1api/wait"
 )
 
 func main() {
@@ -23,11 +23,11 @@ func main() {
 
 	ctx := context.Background()
 
-	keyRing, err := kmsClient.CreateKeyRing(ctx, projectId, region).
+	keyRing, err := kmsClient.DefaultAPI.CreateKeyRing(ctx, projectId, region).
 		CreateKeyRingPayload(
 			kms.CreateKeyRingPayload{
 				Description: utils.Ptr("a test keyring"),
-				DisplayName: utils.Ptr("test-keyring"),
+				DisplayName: "test-keyring",
 			},
 		).Execute()
 	if err != nil {
@@ -36,47 +36,47 @@ func main() {
 	}
 
 	// Create a key
-	key, err := kmsClient.CreateKey(ctx, projectId, region, *keyRing.Id).
+	key, err := kmsClient.DefaultAPI.CreateKey(ctx, projectId, region, keyRing.Id).
 		CreateKeyPayload(
 			kms.CreateKeyPayload{
-				Algorithm:   kms.ALGORITHM_AES_256_GCM.Ptr(),
+				Algorithm:   kms.ALGORITHM_AES_256_GCM,
 				Description: utils.Ptr("A test key"),
-				DisplayName: utils.Ptr("test-key"),
-				Purpose:     kms.PURPOSE_SYMMETRIC_ENCRYPT_DECRYPT.Ptr(),
+				DisplayName: "test-key",
+				Purpose:     kms.PURPOSE_SYMMETRIC_ENCRYPT_DECRYPT,
 			}).Execute()
 	if err != nil {
 		fmt.Fprintf(os.Stderr, "[kms API] Cannot create key: %v\n", err)
 		os.Exit(1)
 	}
-	fmt.Printf("[kms API] Triggered creation of key: %v\n", *key.Id)
+	fmt.Printf("[kms API] Triggered creation of key: %v\n", key.Id)
 
 	// Wait for creation of key
-	key, err = wait.CreateOrUpdateKeyWaitHandler(ctx, kmsClient, projectId, region, *key.KeyRingId, *key.Id).WaitWithContext(ctx)
+	key, err = wait.CreateOrUpdateKeyWaitHandler(ctx, kmsClient.DefaultAPI, projectId, region, key.KeyRingId, key.Id).WaitWithContext(ctx)
 	if err != nil {
 		fmt.Fprintf(os.Stderr, "[kms API] Error when waiting for creation: %v\n", err)
 		os.Exit(1)
 	}
-	fmt.Printf("[kms API] Created key %s\n", *key.Id)
+	fmt.Printf("[kms API] Created key %s\n", key.Id)
 
 	// List key rings
-	keyRings, err := kmsClient.ListKeyRingsExecute(ctx, projectId, region)
+	keyRings, err := kmsClient.DefaultAPI.ListKeyRings(ctx, projectId, region).Execute()
 	if err != nil {
 		fmt.Fprintf(os.Stderr, "[kms API] Cannot list keyrings: %v\n", err)
 		os.Exit(1)
 	}
 
 	if keyrings := keyRings.KeyRings; keyrings != nil {
-		fmt.Printf("[kms API] Number of keyrings: %v\n", len(*keyrings))
+		fmt.Printf("[kms API] Number of keyrings: %v\n", len(keyrings))
 
-		for _, keyring := range *keyrings {
-			keylist, err := kmsClient.ListKeysExecute(ctx, projectId, region, *keyring.Id)
+		for _, keyring := range keyrings {
+			keylist, err := kmsClient.DefaultAPI.ListKeys(ctx, projectId, region, keyring.Id).Execute()
 			if err != nil {
 				fmt.Fprintf(os.Stderr, "[kms API] Cannot list keys: %v\n", err)
 				os.Exit(1)
 			}
 
 			if keys := keylist.Keys; keys != nil {
-				fmt.Printf("[kms API] Keys in Keyring %s: %v\n", *keyring.Id, len(*keys))
+				fmt.Printf("[kms API] Keys in Keyring %s: %v\n", keyring.Id, len(keys))
 			}
 		}
 	}

services/kms/CHANGELOG.md

@@ -1,3 +1,10 @@
+## v1.4.0
+- **Feature:** Introduction of multi API version support for the kms SDK module. For more details please see the announcement on GitHub: https://github.com/stackitcloud/stackit-sdk-go/discussions/5062
+- `v1api`: New package which can be used for communication with the kms v1 API
+- `v1betaapi`: New package which can be used for communication with the kms v1 beta API
+- **Deprecation:** The contents in the root of this SDK module including the `wait` package are marked as deprecated and will be removed after 2026-09-30. Switch to the new packages for the available API versions instead.
+- **Dependencies:** Bump STACKIT SDK core module from `v0.21.1` to `v0.22.0`
+
 ## v1.3.2
 - Bump STACKIT SDK core module from `v0.21.0` to `v0.21.1`
 

services/kms/VERSION

@@ -1 +1 @@
-v1.3.2
+v1.4.0