feat(kms): add example

Author: bahkauv70

examples/kms/go.mod

@@ -0,0 +1,10 @@
+module github.com/stackitcloud/stackit-sdk-go/examples/kms
+
+go 1.24.2
+
+require (
+	github.com/golang-jwt/jwt/v5 v5.2.2 // indirect
+	github.com/google/uuid v1.6.0 // indirect
+	github.com/stackitcloud/stackit-sdk-go/core v0.17.1 // indirect
+	github.com/stackitcloud/stackit-sdk-go/services/kms v0.0.0-20250428090914-306285b22343 // indirect
+)

examples/kms/go.sum

@@ -0,0 +1,10 @@
+github.com/golang-jwt/jwt/v5 v5.2.2 h1:Rl4B7itRWVtYIHFrSNd7vhTiz9UpLdi6gZhZ3wEeDy8=
+github.com/golang-jwt/jwt/v5 v5.2.2/go.mod h1:pqrtFR0X4osieyHYxtmOUWsAWrfe1Q5UVIyoH402zdk=
+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.17.1 h1:TTrVoB1lERd/qfWzpe6HpwCJSjtaGnUI7UE7ITb5IT0=
+github.com/stackitcloud/stackit-sdk-go/core v0.17.1/go.mod h1:8KIw3czdNJ9sdil9QQimxjR6vHjeINFrRv0iZ67wfn0=
+github.com/stackitcloud/stackit-sdk-go/services/kms v0.0.0-20250423063416-f75de618b724 h1:ni5aBQWbUqasgwOEd9tMrmHcSOum6htKJlNteDL/a/Y=
+github.com/stackitcloud/stackit-sdk-go/services/kms v0.0.0-20250423063416-f75de618b724/go.mod h1:PkEENcXnz+G3MIX7CsRXAD2ITqwzdNVacBq42qNRlwA=
+github.com/stackitcloud/stackit-sdk-go/services/kms v0.0.0-20250428090914-306285b22343 h1:AA0EkaVGUvlVSTFWimKVlFXAoSwb+5p6BoP4LLt9V0U=
+github.com/stackitcloud/stackit-sdk-go/services/kms v0.0.0-20250428090914-306285b22343/go.mod h1:eDyjUgidB+JYtE78aYLd1d/v/ijzm+FrWAzaaZxenso=

examples/kms/kms.go

@@ -0,0 +1,75 @@
+package main
+
+import (
+	"context"
+	"fmt"
+	"log"
+	"os"
+	"time"
+
+	"github.com/stackitcloud/stackit-sdk-go/core/utils"
+	"github.com/stackitcloud/stackit-sdk-go/services/kms"
+)
+
+func main() {
+	// Specify the project ID
+	projectId := "66b03760-125b-4c63-9624-741e8a418c02"
+	region := "eu01"
+
+	// 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)
+		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()
+	if err != nil {
+		log.Fatalf("cannot create keyring: %v", err)
+	}
+
+	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 {
+		log.Fatalf("cannot create key: %v", err)
+	}
+	log.Printf("created key %v", key.Id)
+
+	keyRings, err := kmsClient.ListKeyRingsExecute(ctx, projectId, region)
+	if err != nil {
+		log.Fatalf("cannot list keyrings: %v", err)
+	}
+	if keyrings := keyRings.KeyRings; keyrings != nil {
+		if len(*keyrings) == 0 {
+			log.Printf("no keyrings defined")
+		} else {
+			for _, keyring := range *keyrings {
+				log.Printf("id=%s displayname=%s status=%s", *keyring.Id, *keyring.DisplayName, *keyring.State)
+				keylist, err := kmsClient.ListKeysExecute(ctx, projectId, region, *key.KeyRingId)
+				if err != nil {
+					log.Fatalf("cannot list keys: %v", err)
+				}
+				if keys := keylist.Keys; keys != nil {
+					if len(*keys) == 0 {
+						log.Printf("no keys")
+					} else {
+						for _, key := range *keys {
+							log.Printf("key id=%s key name=%s key status=%s", *key.Id, *key.DisplayName, *key.State)
+						}
+					}
+				}
+			}
+		}
+	}
+
+}