updated the docs

Author: Jan Sternagel

docs/stackit_beta_kms_key.md

@@ -4,7 +4,7 @@ Manage KMS Keys
 
 ### Synopsis
 
-Provides functionality for Key operations inside the KMS
+Provides functionality for key operations inside the KMS
 
 ```
 stackit beta kms key [flags]
@@ -34,6 +34,6 @@ stackit beta kms key [flags]
 * [stackit beta kms key delete](./stackit_beta_kms_key_delete.md)	 - Deletes a KMS key
 * [stackit beta kms key import](./stackit_beta_kms_key_import.md)	 - Import a KMS key
 * [stackit beta kms key list](./stackit_beta_kms_key_list.md)	 - List all KMS keys
-* [stackit beta kms key restore](./stackit_beta_kms_key_restore.md)	 - Resotre a key
+* [stackit beta kms key restore](./stackit_beta_kms_key_restore.md)	 - Restore a key
 * [stackit beta kms key rotate](./stackit_beta_kms_key_rotate.md)	 - Rotate a key
 

docs/stackit_beta_kms_key_create.md

@@ -14,10 +14,10 @@ stackit beta kms key create [flags]
 
 ```
   Create a Symmetric KMS key
-  $ stackit beta kms key create --key-ring "my-keyring-id" --algorithm "rsa_2048_oaep_sha256" --name "my-key-name" --purpose "symmetric_encrypt_decrypt"
+  $ stackit beta kms key create --key-ring "my-keyring-id" --algorithm "rsa_2048_oaep_sha256" --name "my-key-name" --purpose "asymmetric_encrypt_decrypt" --protection "software"
 
   Create a Message Authentication KMS key
-  $ stackit beta kms key create --key-ring "my-keyring-id" --algorithm "hmac_sha512" --name "my-key-name" --purpose "message_authentication_code"
+  $ stackit beta kms key create --key-ring "my-keyring-id" --algorithm "hmac_sha512" --name "my-key-name" --purpose "message_authentication_code" --protection "software"
 ```
 
 ### Options
@@ -27,8 +27,9 @@ stackit beta kms key create [flags]
       --description string   Optional description of the key
   -h, --help                 Help for "stackit beta kms key create"
       --import-only          States whether versions can be created or only imported
-      --key-ring string      ID of the KMS key ring
+      --key-ring-id string   ID of the KMS key ring
       --name string          The display name to distinguish multiple keys
+      --protection string    The underlying system that is responsible for protecting the key material. Value: 'software'
       --purpose string       Purpose of the key. Enum: 'symmetric_encrypt_decrypt', 'asymmetric_encrypt_decrypt', 'message_authentication_code', 'asymmetric_sign_verify' 
 ```
 

docs/stackit_beta_kms_key_delete.md

@@ -7,22 +7,21 @@ Deletes a KMS key
 Deletes a KMS key inside a specific key ring.
 
 ```
-stackit beta kms key delete [flags]
+stackit beta kms key delete KEY_ID [flags]
 ```
 
 ### Examples
 
 ```
   Delete a KMS key "my-key-id" inside the key ring "my-key-ring-id"
-  $ stackit beta kms keyring delete --key-ring "my-key-ring-id" --key "my-key-id"
+  $ stackit beta kms keyring delete "my-key-id" --key-ring "my-key-ring-id"
 ```
 
 ### Options
 
 ```
-  -h, --help              Help for "stackit beta kms key delete"
-      --key string        ID of the actual Key
-      --key-ring string   ID of the KMS Key Ring where the Key is stored
+  -h, --help                 Help for "stackit beta kms key delete"
+      --key-ring-id string   ID of the KMS Key Ring where the Key is stored
 ```
 
 ### Options inherited from parent commands

docs/stackit_beta_kms_key_import.md

@@ -7,22 +7,21 @@ Import a KMS key
 Import a new version to the given KMS key.
 
 ```
-stackit beta kms key import [flags]
+stackit beta kms key import KEY_ID [flags]
 ```
 
 ### Examples
 
 ```
-  Import a new version for the given KMS key "my-key"
-  $ stakit beta kms key import --key-ring "my-keyring-id" --key "my-key-id" --wrapped-key "base64-encoded-wrapped-key-material" --wrapping-key-id "my-wrapping-key-id"
+  Import a new version for the given KMS key "my-key-id"
+  $ stackit beta kms key import "my-key-id" --key-ring "my-keyring-id" --wrapped-key "base64-encoded-wrapped-key-material" --wrapping-key-id "my-wrapping-key-id"
 ```
 
 ### Options
 
 ```
   -h, --help                     Help for "stackit beta kms key import"
-      --key string               ID of the KMS key
-      --key-ring string          ID of the KMS key ring
+      --key-ring-id string       ID of the KMS key ring
       --wrapped-key string       The wrapped key material that has to be imported. Encoded in base64
       --wrapping-key-id string   The unique id of the wrapping key the key material has been wrapped with
 ```

docs/stackit_beta_kms_key_list.md

@@ -7,23 +7,24 @@ List all KMS keys
 List all KMS keys inside a key ring.
 
 ```
-stackit beta kms key list KEYRING_ID [flags]
+stackit beta kms key list [flags]
 ```
 
 ### Examples
 
 ```
-  List all KMS keys for the key ring "xxx"
-  $ stackit beta kms key list xxx
+  List all KMS keys for the key ring "my-key-ring-id"
+  $ stackit beta kms key list --key-ring "my-key-ring-id"
 
   List all KMS keys in JSON format
-  $ stackit beta kms key list xxx --output-format json
+  $ stackit beta kms key list --key-ring "my-key-ring-id" --output-format json
 ```
 
 ### Options
 
 ```
-  -h, --help   Help for "stackit beta kms key list"
+  -h, --help                 Help for "stackit beta kms key list"
+      --key-ring-id string   ID of the KMS Key Ring where the Key is stored
 ```
 
 ### Options inherited from parent commands

docs/stackit_beta_kms_key_restore.md

@@ -1,28 +1,27 @@
 ## stackit beta kms key restore
 
-Resotre a key
+Restore a key
 
 ### Synopsis
 
 Restores the given key from being deleted.
 
 ```
-stackit beta kms key restore [flags]
+stackit beta kms key restore KEY_ID [flags]
 ```
 
 ### Examples
 
 ```
   Restore a KMS key "my-key-id" inside the key ring "my-key-ring-id" that was scheduled for deletion.
-  $ stackit beta kms keyring restore --key-ring "my-key-ring-id" --key "my-key-id"
+  $ stackit beta kms keyring restore "my-key-id" --key-ring "my-key-ring-id"
 ```
 
 ### Options
 
 ```
-  -h, --help              Help for "stackit beta kms key restore"
-      --key string        ID of the actual Key
-      --key-ring string   ID of the KMS Key Ring where the Key is stored
+  -h, --help                 Help for "stackit beta kms key restore"
+      --key-ring-id string   ID of the KMS Key Ring where the Key is stored
 ```
 
 ### Options inherited from parent commands

docs/stackit_beta_kms_key_rotate.md

@@ -7,22 +7,21 @@ Rotate a key
 Rotates the given key.
 
 ```
-stackit beta kms key rotate [flags]
+stackit beta kms key rotate KEY_ID [flags]
 ```
 
 ### Examples
 
 ```
   Rotate a KMS key "my-key-id" and increase it's version inside the key ring "my-key-ring-id".
-  $ stackit beta kms key rotate --key-ring "my-key-ring-id" --key "my-key-id"
+  $ stackit beta kms key rotate "my-key-id" --key-ring "my-key-ring-id"
 ```
 
 ### Options
 
 ```
-  -h, --help              Help for "stackit beta kms key rotate"
-      --key string        ID of the actual key
-      --key-ring string   ID of the KMS key Ring where the key is stored
+  -h, --help                 Help for "stackit beta kms key rotate"
+      --key-ring-id string   ID of the KMS key Ring where the key is stored
 ```
 
 ### Options inherited from parent commands

docs/stackit_beta_kms_keyring_create.md

@@ -14,10 +14,10 @@ stackit beta kms keyring create [flags]
 
 ```
   Create a KMS key ring
-  $ stakit beta kms keyring create --name my-keyring
+  $ stackit beta kms keyring create --name my-keyring
 
   Create a KMS key ring with a description
-  $ stakit beta kms keyring create --name my-keyring --description my-description
+  $ stackit beta kms keyring create --name my-keyring --description my-description
 ```
 
 ### Options

docs/stackit_beta_kms_keyring_delete.md

@@ -13,8 +13,8 @@ stackit beta kms keyring delete KEYRING_ID [flags]
 ### Examples
 
 ```
-  Delete a KMS key ring with ID "xxx"
-  $ stackit beta kms keyring delete xxx
+  Delete a KMS key ring with ID "my-key-ring-id"
+  $ stackit beta kms keyring delete "my-key-ring-id"
 ```
 
 ### Options

docs/stackit_beta_kms_version_destroy.md

@@ -7,23 +7,22 @@ Destroy a key version
 Removes the key material of a version.
 
 ```
-stackit beta kms version destroy [flags]
+stackit beta kms version destroy VERSION_NUMBER [flags]
 ```
 
 ### Examples
 
 ```
-  Destroy key version "0" for the key "my-key-id" inside the key ring "my-key-ring-id"
-  $ stackit beta kms version destroy --key "my-key-id" --key-ring "my-key-ring-id" --version 0
+  Destroy key version "42" for the key "my-key-id" inside the key ring "my-key-ring-id"
+  $ stackit beta kms version destroy 42 --key "my-key-id" --key-ring "my-key-ring-id"
 ```
 
 ### Options
 
 ```
-  -h, --help              Help for "stackit beta kms version destroy"
-      --key string        ID of the key
-      --key-ring string   ID of the KMS key ring
-      --version int       Version number of the key
+  -h, --help                 Help for "stackit beta kms version destroy"
+      --key-id string        ID of the key
+      --key-ring-id string   ID of the KMS key ring
 ```
 
 ### Options inherited from parent commands