Add update command to network-area route

Support to update labels for a network-area route.

Signed-off-by: Alexander Dahmen <[email protected]>

Author: Fyusel

docs/stackit_beta_network-area_route.md

@@ -33,4 +33,5 @@ stackit beta network-area route [flags]
 * [stackit beta network-area route delete](./stackit_beta_network-area_route_delete.md)	 - Deletes a static route in a STACKIT Network Area (SNA)
 * [stackit beta network-area route describe](./stackit_beta_network-area_route_describe.md)	 - Shows details of a static route in a STACKIT Network Area (SNA)
 * [stackit beta network-area route list](./stackit_beta_network-area_route_list.md)	 - Lists all static routes in a STACKIT Network Area (SNA)
+* [stackit beta network-area route update](./stackit_beta_network-area_route_update.md)	 - Updates a static route in a STACKIT Network Area (SNA)
 

docs/stackit_beta_network-area_route_update.md

@@ -0,0 +1,44 @@
+## stackit beta network-area route update
+
+Updates a static route in a STACKIT Network Area (SNA)
+
+### Synopsis
+
+Updates a static route in a STACKIT Network Area (SNA).
+This command is currently asynchonous only due to limitations in the waiting functionality of the SDK. This will be updated in a future release.
+
+
+```
+stackit beta network-area route update [flags]
+```
+
+### Examples
+
+```
+  Updates the label(s) of a static route with ID "xxx" in a STACKIT Network Area with ID "yyy" in organization with ID "zzz"
+  $ stackit beta network-area route update xxx --label key=value,foo=bar --organization-id yyy --network-area-id zzz
+```
+
+### Options
+
+```
+  -h, --help                     Help for "stackit beta network-area route update"
+      --label stringToString     Labels are key-value string pairs which can be attached to a route. A label can be provided with the format key=value and the flag can be used multiple times to provide a list of labels (default [])
+      --network-area-id string   STACKIT Network Area ID
+      --organization-id string   Organization ID
+```
+
+### 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 network-area route](./stackit_beta_network-area_route.md)	 - Provides functionality for static routes in STACKIT Network Areas
+

internal/cmd/beta/network-area/route/describe/describe.go

@@ -4,6 +4,7 @@ import (
 	"context"
 	"encoding/json"
 	"fmt"
+	"strings"
 
 	"github.com/goccy/go-yaml"
 	"github.com/stackitcloud/stackit-cli/internal/pkg/args"
@@ -134,9 +135,18 @@ func outputResult(p *print.Printer, outputFormat string, route *iaas.Route) erro
 		table := tables.NewTable()
 		table.AddRow("ID", *route.RouteId)
 		table.AddSeparator()
-		table.AddRow("Prefix", *route.Prefix)
+		table.AddRow("PREFIX", *route.Prefix)
 		table.AddSeparator()
-		table.AddRow("Nexthop", *route.Nexthop)
+		table.AddRow("NEXTHOP", *route.Nexthop)
+		table.AddSeparator()
+		if route.Labels != nil && len(*route.Labels) > 0 {
+			labels := []string{}
+			for key, value := range *route.Labels {
+				labels = append(labels, fmt.Sprintf("%s: %s", key, value))
+			}
+			table.AddSeparator()
+			table.AddRow("LABELS", strings.Join(labels, "\n"))
+		}
 
 		err := table.Display(p)
 		if err != nil {

internal/cmd/beta/network-area/route/routes.go

@@ -5,6 +5,7 @@ import (
 	"github.com/stackitcloud/stackit-cli/internal/cmd/beta/network-area/route/delete"
 	"github.com/stackitcloud/stackit-cli/internal/cmd/beta/network-area/route/describe"
 	"github.com/stackitcloud/stackit-cli/internal/cmd/beta/network-area/route/list"
+	"github.com/stackitcloud/stackit-cli/internal/cmd/beta/network-area/route/update"
 	"github.com/stackitcloud/stackit-cli/internal/pkg/args"
 	"github.com/stackitcloud/stackit-cli/internal/pkg/print"
 	"github.com/stackitcloud/stackit-cli/internal/pkg/utils"
@@ -29,4 +30,5 @@ func addSubcommands(cmd *cobra.Command, p *print.Printer) {
 	cmd.AddCommand(delete.NewCmd(p))
 	cmd.AddCommand(describe.NewCmd(p))
 	cmd.AddCommand(list.NewCmd(p))
+	cmd.AddCommand(update.NewCmd(p))
 }

internal/cmd/beta/network-area/route/update/update.go

@@ -0,0 +1,166 @@
+package update
+
+import (
+	"context"
+	"encoding/json"
+	"fmt"
+
+	"github.com/goccy/go-yaml"
+	"github.com/spf13/cobra"
+	"github.com/stackitcloud/stackit-cli/internal/pkg/args"
+	"github.com/stackitcloud/stackit-cli/internal/pkg/errors"
+	"github.com/stackitcloud/stackit-cli/internal/pkg/examples"
+	"github.com/stackitcloud/stackit-cli/internal/pkg/flags"
+	"github.com/stackitcloud/stackit-cli/internal/pkg/globalflags"
+	"github.com/stackitcloud/stackit-cli/internal/pkg/print"
+	"github.com/stackitcloud/stackit-cli/internal/pkg/services/iaas/client"
+	iaasUtils "github.com/stackitcloud/stackit-cli/internal/pkg/services/iaas/utils"
+	"github.com/stackitcloud/stackit-cli/internal/pkg/utils"
+	"github.com/stackitcloud/stackit-sdk-go/services/iaas"
+)
+
+const (
+	routeIdArg = "ROUTE_ID"
+
+	organizationIdFlag = "organization-id"
+	networkAreaIdFlag  = "network-area-id"
+
+	labelFlag = "labels"
+)
+
+type inputModel struct {
+	*globalflags.GlobalFlagModel
+	OrganizationId *string
+	NetworkAreaId  *string
+	RouteId        string
+	Labels         *map[string]string
+}
+
+func NewCmd(p *print.Printer) *cobra.Command {
+	cmd := &cobra.Command{
+		Use:   "update",
+		Short: "Updates a static route in a STACKIT Network Area (SNA)",
+		Long: fmt.Sprintf("%s\n%s\n",
+			"Updates a static route in a STACKIT Network Area (SNA).",
+			"This command is currently asynchonous only due to limitations in the waiting functionality of the SDK. This will be updated in a future release.",
+		),
+		Args: args.SingleArg(routeIdArg, utils.ValidateUUID),
+		Example: examples.Build(
+			examples.NewExample(
+				`Updates the label(s) of a static route with ID "xxx" in a STACKIT Network Area with ID "yyy" in organization with ID "zzz"`,
+				"$ stackit beta network-area route update xxx --labels key=value,foo=bar --organization-id yyy --network-area-id zzz",
+			),
+		),
+		RunE: func(cmd *cobra.Command, args []string) error {
+			ctx := context.Background()
+			model, err := parseInput(p, cmd, args)
+			if err != nil {
+				return err
+			}
+
+			// Configure API client
+			apiClient, err := client.ConfigureClient(p)
+			if err != nil {
+				return err
+			}
+
+			// Get network area label
+			networkAreaLabel, err := iaasUtils.GetNetworkAreaName(ctx, apiClient, *model.OrganizationId, *model.NetworkAreaId)
+			if err != nil {
+				p.Debug(print.ErrorLevel, "get network area name: %v", err)
+				networkAreaLabel = *model.NetworkAreaId
+			}
+
+			// Call API
+			req := buildRequest(ctx, model, apiClient)
+			resp, err := req.Execute()
+			if err != nil {
+				return fmt.Errorf("create static route: %w", err)
+			}
+
+			return outputResult(p, model, networkAreaLabel, *resp)
+		},
+	}
+	configureFlags(cmd)
+	return cmd
+}
+
+func configureFlags(cmd *cobra.Command) {
+	cmd.Flags().Var(flags.UUIDFlag(), organizationIdFlag, "Organization ID")
+	cmd.Flags().Var(flags.UUIDFlag(), networkAreaIdFlag, "STACKIT Network Area ID")
+	cmd.Flags().StringToString(labelFlag, nil, "Labels are key-value string pairs which can be attached to a route. A label can be provided with the format key=value and the flag can be used multiple times to provide a list of labels")
+
+	err := flags.MarkFlagsRequired(cmd, organizationIdFlag, networkAreaIdFlag)
+	cobra.CheckErr(err)
+}
+
+func parseInput(p *print.Printer, cmd *cobra.Command, inputArgs []string) (*inputModel, error) {
+	routeId := inputArgs[0]
+	globalFlags := globalflags.Parse(p, cmd)
+
+	labels := flags.FlagToStringToStringPointer(p, cmd, labelFlag)
+
+	if labels == nil {
+		return nil, &errors.EmptyUpdateError{}
+	}
+
+	model := inputModel{
+		GlobalFlagModel: globalFlags,
+		OrganizationId:  flags.FlagToStringPointer(p, cmd, organizationIdFlag),
+		NetworkAreaId:   flags.FlagToStringPointer(p, cmd, networkAreaIdFlag),
+		RouteId:         routeId,
+		Labels:          labels,
+	}
+
+	if p.IsVerbosityDebug() {
+		modelStr, err := print.BuildDebugStrFromInputModel(model)
+		if err != nil {
+			p.Debug(print.ErrorLevel, "convert model to string for debugging: %v", err)
+		} else {
+			p.Debug(print.DebugLevel, "parsed input values: %s", modelStr)
+		}
+	}
+
+	return &model, nil
+}
+
+func buildRequest(ctx context.Context, model *inputModel, apiClient *iaas.APIClient) iaas.ApiUpdateNetworkAreaRouteRequest {
+	req := apiClient.UpdateNetworkAreaRoute(ctx, *model.OrganizationId, *model.NetworkAreaId, model.RouteId)
+
+	// convert map[string]string to map[string]interface{}
+	labelsMap := make(map[string]interface{})
+	for k, v := range *model.Labels {
+		labelsMap[k] = v
+	}
+
+	payload := iaas.UpdateNetworkAreaRoutePayload{
+		Labels: &labelsMap,
+	}
+	req = req.UpdateNetworkAreaRoutePayload(payload)
+
+	return req
+}
+
+func outputResult(p *print.Printer, model *inputModel, networkAreaLabel string, route iaas.Route) error {
+	switch model.OutputFormat {
+	case print.JSONOutputFormat:
+		details, err := json.MarshalIndent(route, "", "  ")
+		if err != nil {
+			return fmt.Errorf("marshal static route: %w", err)
+		}
+		p.Outputln(string(details))
+
+		return nil
+	case print.YAMLOutputFormat:
+		details, err := yaml.MarshalWithOptions(route, yaml.IndentSequence(true))
+		if err != nil {
+			return fmt.Errorf("marshal static route: %w", err)
+		}
+		p.Outputln(string(details))
+
+		return nil
+	default:
+		p.Outputf("Updated static route for SNA %q.\nStatic route ID: %s\n", networkAreaLabel, *route.RouteId)
+		return nil
+	}
+}