Feat/670192 security groups (#531)

* feature: add command and sub-commands for security groups

* feature: implement create command

* feature: add list command

* fixup: check name length

* fixup: added placeholder for client invocation

* feature: implement calling service and output of results

* feature: implement calling service and output of results for list

* feature: move command to beta package

* feature: removed duplicate invocation of API

* feature: completed delete command

* feature: renamed package to conform to standards

* feature: refactored tests to reused actual cobra  command

* feature: refactored flag initialization

* feature: implemented update command

* feature: implemented describe command

* feature: fixed parsing of global flags

* feature: fix list command

* feature: fixed describe command

* feature: fixed typo

* feature: updated  generated documentation

* feature: fix review comments

* feature: refresh documentation

* feature: fix a regression in list command

* feature: fix regressions

* feature: implemented review suggestions

* restructed security-group command

* feature: updated documentation

* feature: restructured sub commands to canonical structure

Author: bahkauv70

docs/stackit_beta.md

@@ -45,7 +45,7 @@ stackit beta [flags]
 * [stackit beta network-area](./stackit_beta_network-area.md)	 - Provides functionality for STACKIT Network Area (SNA)
 * [stackit beta network-interface](./stackit_beta_network-interface.md)	 - Provides functionality for network interfaces
 * [stackit beta public-ip](./stackit_beta_public-ip.md)	 - Provides functionality for public IPs
-* [stackit beta security-group](./stackit_beta_security-group.md)	 - Provides functionality for security groups
+* [stackit beta security-group](./stackit_beta_security-group.md)	 - Manage security groups
 * [stackit beta server](./stackit_beta_server.md)	 - Provides functionality for servers
 * [stackit beta sqlserverflex](./stackit_beta_sqlserverflex.md)	 - Provides functionality for SQLServer Flex
 * [stackit beta volume](./stackit_beta_volume.md)	 - Provides functionality for volumes

docs/stackit_beta_security-group.md

@@ -1,10 +1,10 @@
 ## stackit beta security-group
 
-Provides functionality for security groups
+Manage security groups
 
 ### Synopsis
 
-Provides functionality for security groups.
+Manage the lifecycle of security groups and rules.
 
 ```
 stackit beta security-group [flags]
@@ -29,5 +29,10 @@ stackit beta security-group [flags]
 ### SEE ALSO
 
 * [stackit beta](./stackit_beta.md)	 - Contains beta STACKIT CLI commands
+* [stackit beta security-group create](./stackit_beta_security-group_create.md)	 - Creates security groups
+* [stackit beta security-group delete](./stackit_beta_security-group_delete.md)	 - Deletes a security group
+* [stackit beta security-group describe](./stackit_beta_security-group_describe.md)	 - Describes security groups
+* [stackit beta security-group list](./stackit_beta_security-group_list.md)	 - Lists security groups
 * [stackit beta security-group rule](./stackit_beta_security-group_rule.md)	 - Provides functionality for security group rules
+* [stackit beta security-group update](./stackit_beta_security-group_update.md)	 - Updates a security group
 

docs/stackit_beta_security-group_create.md

@@ -0,0 +1,46 @@
+## stackit beta security-group create
+
+Creates security groups
+
+### Synopsis
+
+Creates security groups.
+
+```
+stackit beta security-group create [flags]
+```
+
+### Examples
+
+```
+  Create a named group
+  $ stackit beta security-group create --name my-new-group
+
+  Create a named group with labels
+  $ stackit beta security-group create --name my-new-group --labels label1=value1,label2=value2
+```
+
+### Options
+
+```
+      --description string      An optional description of the security group.
+  -h, --help                    Help for "stackit beta security-group create"
+      --labels stringToString   Labels are key-value string pairs which can be attached to a network-interface. E.g. '--labels key1=value1,key2=value2,...' (default [])
+      --name string             The name of the security group.
+      --stateful                Create a stateful or a stateless security group
+```
+
+### Options inherited from parent commands
+
+```
+  -y, --assume-yes             If set, skips all confirmation prompts
+      --async                  If set, runs the command asynchronously
+  -o, --output-format string   Output format, one of ["json" "pretty" "none" "yaml"]
+  -p, --project-id string      Project ID
+      --verbosity string       Verbosity of the CLI, one of ["debug" "info" "warning" "error"] (default "info")
+```
+
+### SEE ALSO
+
+* [stackit beta security-group](./stackit_beta_security-group.md)	 - Manage security groups
+

docs/stackit_beta_security-group_delete.md

@@ -0,0 +1,39 @@
+## stackit beta security-group delete
+
+Deletes a security group
+
+### Synopsis
+
+Deletes a security group by its internal ID.
+
+```
+stackit beta security-group delete [flags]
+```
+
+### Examples
+
+```
+  Delete a named group with ID "xxx"
+  $ stackit beta security-group delete xxx
+```
+
+### Options
+
+```
+  -h, --help   Help for "stackit beta security-group delete"
+```
+
+### Options inherited from parent commands
+
+```
+  -y, --assume-yes             If set, skips all confirmation prompts
+      --async                  If set, runs the command asynchronously
+  -o, --output-format string   Output format, one of ["json" "pretty" "none" "yaml"]
+  -p, --project-id string      Project ID
+      --verbosity string       Verbosity of the CLI, one of ["debug" "info" "warning" "error"] (default "info")
+```
+
+### SEE ALSO
+
+* [stackit beta security-group](./stackit_beta_security-group.md)	 - Manage security groups
+

docs/stackit_beta_security-group_describe.md

@@ -0,0 +1,39 @@
+## stackit beta security-group describe
+
+Describes security groups
+
+### Synopsis
+
+Describes security groups by its internal ID.
+
+```
+stackit beta security-group describe [flags]
+```
+
+### Examples
+
+```
+  Describe group "xxx"
+  $ stackit beta security-group describe xxx
+```
+
+### Options
+
+```
+  -h, --help   Help for "stackit beta security-group describe"
+```
+
+### Options inherited from parent commands
+
+```
+  -y, --assume-yes             If set, skips all confirmation prompts
+      --async                  If set, runs the command asynchronously
+  -o, --output-format string   Output format, one of ["json" "pretty" "none" "yaml"]
+  -p, --project-id string      Project ID
+      --verbosity string       Verbosity of the CLI, one of ["debug" "info" "warning" "error"] (default "info")
+```
+
+### SEE ALSO
+
+* [stackit beta security-group](./stackit_beta_security-group.md)	 - Manage security groups
+

docs/stackit_beta_security-group_list.md

@@ -0,0 +1,43 @@
+## stackit beta security-group list
+
+Lists security groups
+
+### Synopsis
+
+Lists security groups by its internal ID.
+
+```
+stackit beta security-group list [flags]
+```
+
+### Examples
+
+```
+  List all groups
+  $ stackit beta security-group list
+
+  List groups with labels
+  $ stackit beta security-group list --label-selector label1=value1,label2=value2
+```
+
+### Options
+
+```
+  -h, --help                    Help for "stackit beta security-group list"
+      --label-selector string   Filter by label
+```
+
+### Options inherited from parent commands
+
+```
+  -y, --assume-yes             If set, skips all confirmation prompts
+      --async                  If set, runs the command asynchronously
+  -o, --output-format string   Output format, one of ["json" "pretty" "none" "yaml"]
+  -p, --project-id string      Project ID
+      --verbosity string       Verbosity of the CLI, one of ["debug" "info" "warning" "error"] (default "info")
+```
+
+### SEE ALSO
+
+* [stackit beta security-group](./stackit_beta_security-group.md)	 - Manage security groups
+

docs/stackit_beta_security-group_rule.md

@@ -28,7 +28,7 @@ stackit beta security-group rule [flags]
 
 ### SEE ALSO
 
-* [stackit beta security-group](./stackit_beta_security-group.md)	 - Provides functionality for security groups
+* [stackit beta security-group](./stackit_beta_security-group.md)	 - Manage security groups
 * [stackit beta security-group rule create](./stackit_beta_security-group_rule_create.md)	 - Creates a security group rule
 * [stackit beta security-group rule delete](./stackit_beta_security-group_rule_delete.md)	 - Deletes a security group rule
 * [stackit beta security-group rule describe](./stackit_beta_security-group_rule_describe.md)	 - Shows details of a security group rule

docs/stackit_beta_security-group_update.md

@@ -0,0 +1,45 @@
+## stackit beta security-group update
+
+Updates a security group
+
+### Synopsis
+
+Updates a named security group
+
+```
+stackit beta security-group update [flags]
+```
+
+### Examples
+
+```
+  Update the name of group "xxx"
+  $ stackit beta security-group update xxx --name my-new-name
+
+  Update the labels of group "xxx"
+  $ stackit beta security-group update xxx --labels label1=value1,label2=value2
+```
+
+### Options
+
+```
+      --description string      An optional description of the security group.
+  -h, --help                    Help for "stackit beta security-group update"
+      --labels stringToString   Labels are key-value string pairs which can be attached to a network-interface. E.g. '--labels key1=value1,key2=value2,...' (default [])
+      --name string             The name of the security group.
+```
+
+### Options inherited from parent commands
+
+```
+  -y, --assume-yes             If set, skips all confirmation prompts
+      --async                  If set, runs the command asynchronously
+  -o, --output-format string   Output format, one of ["json" "pretty" "none" "yaml"]
+  -p, --project-id string      Project ID
+      --verbosity string       Verbosity of the CLI, one of ["debug" "info" "warning" "error"] (default "info")
+```
+
+### SEE ALSO
+
+* [stackit beta security-group](./stackit_beta_security-group.md)	 - Manage security groups
+