feat: Update kms (#2994)

* generate kms

* adjusted waiters

* adjusted example

* Update CHANGELOG.md

Author: marceljk

CHANGELOG.md

@@ -70,6 +70,13 @@
   - Add `required:"true"` tags to model structs
 - `serviceaccount`: [v0.9.0](services/serviceaccount/CHANGELOG.md#v090)
   - Add `required:"true"` tags to model structs
+- `kms` [v0.3.0](services/kms/CHANGELOG.md#v030)
+  - **Feature:** New method `DeleteWrappingKey`
+  - **Breaking change:** Enum `KEYSTATE_VERSION_NOT_READY` removed. Use instead `KEYSTATE_CREATING`
+  - **Breaking change:** Enum `VERSIONSTATE_KEY_MATERIAL_NOT_READY` removed. Use instead `VERSIONSTATE_CREATING`
+  - **Breaking change:** Enum `WRAPPINGKEYSTATE_KEY_MATERIAL_NOT_READY` removed. Use instead `WRAPPINGKEYSTATE_CREATING`
+  - **Feature:** New enums for `KEYSTATE`, `KEYRINGSTATE`, `VERSIONSTATE` and `WRAPPINGKEYSTATE`
+  - **Feature:** Add `required:"true"` tags to model structs
 
 ## Release (2025-06-16)
 - `iaas`: 

examples/kms/kms.go

@@ -4,7 +4,6 @@ import (
 	"context"
 	"fmt"
 	"os"
-	"time"
 
 	"github.com/stackitcloud/stackit-sdk-go/core/utils"
 	"github.com/stackitcloud/stackit-sdk-go/services/kms"
@@ -19,63 +18,67 @@ func main() {
 	// Create a new API client, that uses default authentication and configuration
 	kmsClient, err := kms.NewAPIClient()
 	if err != nil {
-		fmt.Fprintf(os.Stderr, "Creating API client: %v\n", err)
+		fmt.Fprintf(os.Stderr, "[kms API] Creating API client: %v\n", err)
 		os.Exit(1)
 	}
-	ctx, cancel := context.WithTimeout(context.Background(), 30*time.Second)
-	defer cancel()
 
-	keyRing, err := kmsClient.CreateKeyRing(ctx, projectId, region).CreateKeyRingPayload(kms.CreateKeyRingPayload{
-		Description: utils.Ptr("a test keyring"),
-		DisplayName: utils.Ptr("test-keyring"),
-	}).Execute()
+	ctx := context.Background()
+
+	keyRing, err := kmsClient.CreateKeyRing(ctx, projectId, region).
+		CreateKeyRingPayload(
+			kms.CreateKeyRingPayload{
+				Description: utils.Ptr("a test keyring"),
+				DisplayName: utils.Ptr("test-keyring"),
+			},
+		).Execute()
 	if err != nil {
-		fmt.Fprintf(os.Stderr, "cannot create keyring: %v\n", err)
-		return
+		fmt.Fprintf(os.Stderr, "[kms API] Cannot create keyring: %v\n", err)
+		os.Exit(1)
 	}
 
-	key, err := kmsClient.CreateKey(ctx, projectId, region, *keyRing.Id).CreateKeyPayload(kms.CreateKeyPayload{
-		Algorithm:   kms.ALGORITHM_AES_256_GCM.Ptr(),
-		Backend:     kms.BACKEND_SOFTWARE.Ptr(),
-		Description: utils.Ptr("A test key"),
-		DisplayName: utils.Ptr("test-key"),
-		Purpose:     kms.PURPOSE_SYMMETRIC_ENCRYPT_DECRYPT.Ptr(),
-	}).Execute()
+	// Create a key
+	key, err := kmsClient.CreateKey(ctx, projectId, region, *keyRing.Id).
+		CreateKeyPayload(
+			kms.CreateKeyPayload{
+				Algorithm:   kms.ALGORITHM_AES_256_GCM.Ptr(),
+				Backend:     kms.BACKEND_SOFTWARE.Ptr(),
+				Description: utils.Ptr("A test key"),
+				DisplayName: utils.Ptr("test-key"),
+				Purpose:     kms.PURPOSE_SYMMETRIC_ENCRYPT_DECRYPT.Ptr(),
+			}).Execute()
 	if err != nil {
-		fmt.Fprintf(os.Stderr, "cannot create key: %v\n", err)
-		return
+		fmt.Fprintf(os.Stderr, "[kms API] Cannot create key: %v\n", err)
+		os.Exit(1)
 	}
-	if err := wait.CreateOrUpdateKeyWaitHandler(ctx, kmsClient, projectId, region, *key.KeyRingId, *key.Id); err != nil {
-		fmt.Fprintf(os.Stderr, "failed to create key: %v", err)
-		return
+	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)
+	if err != nil {
+		fmt.Fprintf(os.Stderr, "[kms API] Error when waiting for creation: %v\n", err)
+		os.Exit(1)
 	}
-	fmt.Printf("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)
 	if err != nil {
-		fmt.Fprintf(os.Stderr, "cannot list keyrings: %v\n", err)
-		return
+		fmt.Fprintf(os.Stderr, "[kms API] Cannot list keyrings: %v\n", err)
+		os.Exit(1)
 	}
+
 	if keyrings := keyRings.KeyRings; keyrings != nil {
-		if len(*keyrings) == 0 {
-			fmt.Printf("no keyrings defined\n")
-		} else {
-			for _, keyring := range *keyrings {
-				fmt.Printf("id=%s displayname=%s status=%s\n", *keyring.Id, *keyring.DisplayName, *keyring.State)
-				keylist, err := kmsClient.ListKeysExecute(ctx, projectId, region, *key.KeyRingId)
-				if err != nil {
-					fmt.Fprintf(os.Stderr, "cannot list keys: %v", err)
-					return
-				}
-				if keys := keylist.Keys; keys != nil {
-					if len(*keys) == 0 {
-						fmt.Printf("no keys\n")
-					} else {
-						for _, key := range *keys {
-							fmt.Printf("key id=%s key name=%s key status=%s\n", *key.Id, *key.DisplayName, *key.State)
-						}
-					}
-				}
+		fmt.Printf("[kms API] Number of keyrings: %v\n", len(*keyrings))
+
+		for _, keyring := range *keyrings {
+			keylist, err := kmsClient.ListKeysExecute(ctx, projectId, region, *keyring.Id)
+			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))
 			}
 		}
 	}

services/kms/CHANGELOG.md

@@ -1,3 +1,11 @@
+## v0.3.0
+- **Feature:** New method `DeleteWrappingKey`
+- **Breaking change:** Enum `KEYSTATE_VERSION_NOT_READY` removed. Use instead `KEYSTATE_CREATING`
+- **Breaking change:** Enum `VERSIONSTATE_KEY_MATERIAL_NOT_READY` removed. Use instead `VERSIONSTATE_CREATING`
+- **Breaking change:** Enum `WRAPPINGKEYSTATE_KEY_MATERIAL_NOT_READY` removed. Use instead `WRAPPINGKEYSTATE_CREATING`
+- **Feature:** New enums for `KEYSTATE`, `KEYRINGSTATE`, `VERSIONSTATE` and `WRAPPINGKEYSTATE`
+- **Feature:** Add `required:"true"` tags to model structs
+
 ## v0.2.0 (2025-05-15)
 - **Breaking change:** Introduce interfaces for `APIClient` and the request structs