Onboard Argus (plans and instance) (#158)

* Onboard Argus: plans command, config (set and unset) and client (#147)

* Onboard Argus (instance): create command and utils (#133)

* Onboard Argus instance: create command init

* create command: complete functionality and start testing

* create command: added testing for utils

* update utils error message

* Add custom Argus error and fix create command testing

* fix error formatting in utils

* fix error formatting

* Onboard Argus (instance): update command (#149)

* Onboard Argus Instance: update command

* update command: support no plan info provided

* update command: testing

* fix linting

* update command: handle empty instance name

* update documentation

* update command: handle empty name update and corner cases

* fix linting

* update command: improve error message

* address comments in PR

* Update internal/cmd/argus/instance/update/update.go

Co-authored-by: João Palet <joao.palet@outlook.com>

* fix linting

---------

Co-authored-by: João Palet <joao.palet@outlook.com>

* Onboard Argus (instance): delete command (#151)

* Onboard Argus Instance: delete command

* delete command: add docs

* Onboard Argus (instance): list and describe commands (#155)

* Onboard Argus Instance: list command

* Onboard Argus Instance: describe command

* describe command: dont display name if empty

* describe command: update output

* describe command: remove additional check

* describe command: add grafana url

* add docs and address comments

* update command: improve examples, add name shorthand flag (#160)

---------

Co-authored-by: João Palet <joao.palet@outlook.com>

Author: DiogoFerrao

docs/stackit.md

@@ -25,6 +25,7 @@ stackit [flags]
 
 ### SEE ALSO
 
+* [stackit argus](./stackit_argus.md)	 - Provides functionality for Argus
 * [stackit auth](./stackit_auth.md)	 - Provides authentication functionality
 * [stackit config](./stackit_config.md)	 - Provides functionality for CLI configuration options
 * [stackit curl](./stackit_curl.md)	 - Executes an authenticated HTTP request to an endpoint

docs/stackit_argus.md

@@ -0,0 +1,33 @@
+## stackit argus
+
+Provides functionality for Argus
+
+### Synopsis
+
+Provides functionality for Argus.
+
+```
+stackit argus [flags]
+```
+
+### Options
+
+```
+  -h, --help   Help for "stackit argus"
+```
+
+### 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"]
+  -p, --project-id string      Project ID
+```
+
+### SEE ALSO
+
+* [stackit](./stackit.md)	 - Manage STACKIT resources using the command line
+* [stackit argus instance](./stackit_argus_instance.md)	 - Provides functionality for Argus instances
+* [stackit argus plans](./stackit_argus_plans.md)	 - Lists all Argus service plans
+

docs/stackit_argus_instance.md

@@ -0,0 +1,36 @@
+## stackit argus instance
+
+Provides functionality for Argus instances
+
+### Synopsis
+
+Provides functionality for Argus instances.
+
+```
+stackit argus instance [flags]
+```
+
+### Options
+
+```
+  -h, --help   Help for "stackit argus instance"
+```
+
+### 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"]
+  -p, --project-id string      Project ID
+```
+
+### SEE ALSO
+
+* [stackit argus](./stackit_argus.md)	 - Provides functionality for Argus
+* [stackit argus instance create](./stackit_argus_instance_create.md)	 - Creates an Argus instance
+* [stackit argus instance delete](./stackit_argus_instance_delete.md)	 - Deletes an Argus instance
+* [stackit argus instance describe](./stackit_argus_instance_describe.md)	 - Shows details of an Argus instance
+* [stackit argus instance list](./stackit_argus_instance_list.md)	 - Lists all Argus instances
+* [stackit argus instance update](./stackit_argus_instance_update.md)	 - Updates an Argus instance
+

docs/stackit_argus_instance_create.md

@@ -0,0 +1,44 @@
+## stackit argus instance create
+
+Creates an Argus instance
+
+### Synopsis
+
+Creates an Argus instance.
+
+```
+stackit argus instance create [flags]
+```
+
+### Examples
+
+```
+  Create an Argus instance with name "my-instance" and specify plan by name
+  $ stackit argus instance create --name my-instance --plan-name Monitoring-Starter-EU01
+
+  Create an Argus instance with name "my-instance" and specify plan by ID
+  $ stackit argus instance create --name my-instance --plan-id xxx
+```
+
+### Options
+
+```
+  -h, --help               Help for "stackit argus instance create"
+  -n, --name string        Instance name
+      --plan-id string     Plan ID
+      --plan-name string   Plan name
+```
+
+### 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"]
+  -p, --project-id string      Project ID
+```
+
+### SEE ALSO
+
+* [stackit argus instance](./stackit_argus_instance.md)	 - Provides functionality for Argus instances
+

docs/stackit_argus_instance_delete.md

@@ -0,0 +1,38 @@
+## stackit argus instance delete
+
+Deletes an Argus instance
+
+### Synopsis
+
+Deletes an Argus instance.
+
+```
+stackit argus instance delete INSTANCE_ID [flags]
+```
+
+### Examples
+
+```
+  Delete an Argus instance with ID "xxx"
+  $ stackit argus instance delete xxx
+```
+
+### Options
+
+```
+  -h, --help   Help for "stackit argus instance 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"]
+  -p, --project-id string      Project ID
+```
+
+### SEE ALSO
+
+* [stackit argus instance](./stackit_argus_instance.md)	 - Provides functionality for Argus instances
+

docs/stackit_argus_instance_describe.md

@@ -0,0 +1,41 @@
+## stackit argus instance describe
+
+Shows details of an Argus instance
+
+### Synopsis
+
+Shows details of an Argus instance.
+
+```
+stackit argus instance describe INSTANCE_ID [flags]
+```
+
+### Examples
+
+```
+  Get details of an Argus instance with ID "xxx"
+  $ stackit argus instance describe xxx
+
+  Get details of an Argus instance with ID "xxx" in a table format
+  $ stackit argus instance describe xxx --output-format pretty
+```
+
+### Options
+
+```
+  -h, --help   Help for "stackit argus instance 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"]
+  -p, --project-id string      Project ID
+```
+
+### SEE ALSO
+
+* [stackit argus instance](./stackit_argus_instance.md)	 - Provides functionality for Argus instances
+

docs/stackit_argus_instance_list.md

@@ -0,0 +1,45 @@
+## stackit argus instance list
+
+Lists all Argus instances
+
+### Synopsis
+
+Lists all Argus instances.
+
+```
+stackit argus instance list [flags]
+```
+
+### Examples
+
+```
+  List all Argus instances
+  $ stackit argus instance list
+
+  List all Argus instances in JSON format
+  $ stackit argus instance list --output-format json
+
+  List up to 10 Argus instances
+  $ stackit argus instance list --limit 10
+```
+
+### Options
+
+```
+  -h, --help        Help for "stackit argus instance list"
+      --limit int   Maximum number of entries to list
+```
+
+### 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"]
+  -p, --project-id string      Project ID
+```
+
+### SEE ALSO
+
+* [stackit argus instance](./stackit_argus_instance.md)	 - Provides functionality for Argus instances
+

docs/stackit_argus_instance_update.md

@@ -0,0 +1,47 @@
+## stackit argus instance update
+
+Updates an Argus instance
+
+### Synopsis
+
+Updates an Argus instance.
+
+```
+stackit argus instance update INSTANCE_ID [flags]
+```
+
+### Examples
+
+```
+  Update the plan of an Argus instance with ID "xxx" by specifying the plan ID
+  $ stackit argus instance update xxx --plan-id yyy
+
+  Update the plan of an Argus instance with ID "xxx" by specifying the plan name
+  $ stackit argus instance update xxx --plan-name Frontend-Starter-EU01
+
+  Update the name of an Argus instance with ID "xxx"
+  $ stackit argus instance update xxx --name new-instance-name
+```
+
+### Options
+
+```
+  -h, --help               Help for "stackit argus instance update"
+  -n, --name string        Instance name
+      --plan-id string     Plan ID
+      --plan-name string   Plan name
+```
+
+### 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"]
+  -p, --project-id string      Project ID
+```
+
+### SEE ALSO
+
+* [stackit argus instance](./stackit_argus_instance.md)	 - Provides functionality for Argus instances
+

docs/stackit_argus_plans.md

@@ -0,0 +1,45 @@
+## stackit argus plans
+
+Lists all Argus service plans
+
+### Synopsis
+
+Lists all Argus service plans.
+
+```
+stackit argus plans [flags]
+```
+
+### Examples
+
+```
+  List all Argus service plans
+  $ stackit argus plans
+
+  List all Argus service plans in JSON format
+  $ stackit argus plans --output-format json
+
+  List up to 10 Argus service plans
+  $ stackit argus plans --limit 10
+```
+
+### Options
+
+```
+  -h, --help        Help for "stackit argus plans"
+      --limit int   Maximum number of entries to list
+```
+
+### 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"]
+  -p, --project-id string      Project ID
+```
+
+### SEE ALSO
+
+* [stackit argus](./stackit_argus.md)	 - Provides functionality for Argus
+

docs/stackit_config_set.md

@@ -29,6 +29,7 @@ stackit config set [flags]
 ### Options
 
 ```
+      --argus-custom-endpoint string              Argus API base URL, used in calls to this API
       --authorization-custom-endpoint string      Authorization API base URL, used in calls to this API
       --dns-custom-endpoint string                DNS API base URL, used in calls to this API
   -h, --help                                      Help for "stackit config set"