feat(edge): add multi API version support (#5395)

relates to STACKITSDK-334

Co-authored-by: Ruben Hoenle <Ruben.Hoenle@stackit.cloud>

Author: stackit-pipeline

CHANGELOG.md

@@ -39,6 +39,11 @@
   - `v3alpha1api`: New package which can be used for communication with the postgresflex v3 alpha1 API
   - **Deprecation:** The contents in the root of this SDK module including the `wait` package are marked as deprecated and will be removed after 2026-09-30. Switch to the new packages for the available API versions instead.
   - **Dependencies:** Bump STACKIT SDK core module from `v0.21.1` to `v0.22.0`
+- `edge`: [v0.5.0](services/edge/CHANGELOG.md#v050)
+  - **Feature:** Introduction of multi API version support for the edge SDK module. For more details please see the announcement on GitHub: https://github.com/stackitcloud/stackit-sdk-go/discussions/5062
+  - `v1beta1api`: New package which can be used for communication with the edge v1 beta1 API
+  - **Deprecation:** The contents in the root of this SDK module including the `wait` package are marked as deprecated and will be removed after 2026-09-30. Switch to the new packages for the available API versions instead.
+  - **Dependencies:** Bump STACKIT SDK core module from `v0.21.1` to `v0.22.0`
 
 ## Release (2026-02-20)
 - `core`: [v0.21.1](core/CHANGELOG.md#v0211) 

examples/edge/edge.go

@@ -7,8 +7,8 @@ import (
 	"time"
 
 	"github.com/stackitcloud/stackit-sdk-go/core/utils"
-	"github.com/stackitcloud/stackit-sdk-go/services/edge"
-	"github.com/stackitcloud/stackit-sdk-go/services/edge/wait"
+	edge "github.com/stackitcloud/stackit-sdk-go/services/edge/v1beta1api"
+	"github.com/stackitcloud/stackit-sdk-go/services/edge/v1beta1api/wait"
 	"gopkg.in/yaml.v3"
 )
 
@@ -30,8 +30,8 @@ func main() {
 		instance *edge.Instance
 		ctx      = context.Background()
 	)
-	payload.DisplayName = utils.Ptr("example")
-	instance, err = client.CreateInstance(ctx, projectId, region).CreateInstancePayload(*payload).Execute()
+	payload.DisplayName = "example"
+	instance, err = client.DefaultAPI.CreateInstance(ctx, projectId, region).CreateInstancePayload(*payload).Execute()
 	if err != nil {
 		fmt.Fprintf(os.Stderr, "[Edge API] Failed to create Instance: %v\n", err)
 		os.Exit(1)
@@ -41,7 +41,7 @@ func main() {
 	// Wait for Edge Instance to become active
 	waitResult, err := wait.CreateOrUpdateInstanceWaitHandler(
 		ctx,
-		client,
+		client.DefaultAPI,
 		projectId,
 		region,
 		instance.GetId(),
@@ -55,7 +55,7 @@ func main() {
 	// Create a service token to login to the instance UI and wait for the instance to become ready
 	token, err := wait.TokenWaitHandler(
 		ctx,
-		client,
+		client.DefaultAPI,
 		projectId,
 		region,
 		instance.GetId(),
@@ -65,14 +65,14 @@ func main() {
 		fmt.Fprintf(os.Stderr, "[Edge API] Failed wait for token creation: %v\n", err)
 		os.Exit(1)
 	}
-	if token != nil && token.Token != nil {
-		fmt.Printf("Token: %s\n", *token.Token)
+	if token != nil {
+		fmt.Printf("Token: %s\n", token.Token)
 	}
 
 	// Create a kubeconfig to interact with the instances kubernetes API and wait for the instance to become ready
 	kubeconfig, err := wait.KubeconfigWaitHandler(
 		ctx,
-		client,
+		client.DefaultAPI,
 		projectId,
 		region,
 		instance.GetId(),
@@ -94,15 +94,15 @@ func main() {
 	}
 
 	// Delete Edge Instance
-	err = client.DeleteInstance(ctx, projectId, region, instance.GetId()).Execute()
+	err = client.DefaultAPI.DeleteInstance(ctx, projectId, region, instance.GetId()).Execute()
 	if err != nil {
 		fmt.Fprintf(os.Stderr, "[Edge API] Failed to delete instance: %v\n", err)
 		os.Exit(1)
 	}
 	fmt.Printf("[Edge API] Instance deletion started, Id: %s\n", instance.GetId())
 
 	// Wait for Edge instance deletion
-	_, err = wait.DeleteInstanceWaitHandler(ctx, client, projectId, region, instance.GetId()).SetTimeout(10 * time.Minute).WaitWithContext(ctx)
+	_, err = wait.DeleteInstanceWaitHandler(ctx, client.DefaultAPI, projectId, region, instance.GetId()).SetTimeout(10 * time.Minute).WaitWithContext(ctx)
 	if err != nil {
 		fmt.Fprintf(os.Stderr, "[Edge API] Failed wait for Instance deletion: %v\n", err)
 		os.Exit(1)

examples/edge/go.mod

@@ -2,8 +2,11 @@ module github.com/stackitcloud/stackit-sdk-go/examples/edge
 
 go 1.21
 
+// This is not needed in production. This is only here to point the golangci linter to the local version instead of the last release on GitHub.
+replace github.com/stackitcloud/stackit-sdk-go/services/edge => ../../services/edge
+
 require (
-	github.com/stackitcloud/stackit-sdk-go/core v0.21.1
+	github.com/stackitcloud/stackit-sdk-go/core v0.22.0
 	github.com/stackitcloud/stackit-sdk-go/services/edge v0.4.3
 	gopkg.in/yaml.v3 v3.0.1
 )

examples/edge/go.sum

@@ -4,10 +4,8 @@ github.com/google/go-cmp v0.7.0 h1:wk8382ETsv4JYUZwIsn6YpYiWiBsYLSJiTsyBybVuN8=
 github.com/google/go-cmp v0.7.0/go.mod h1:pXiqmnSA92OHEEa9HXL2W4E7lf9JzCmGVUdgjX3N/iU=
 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.21.1 h1:Y/PcAgM7DPYMNqum0MLv4n1mF9ieuevzcCIZYQfm3Ts=
-github.com/stackitcloud/stackit-sdk-go/core v0.21.1/go.mod h1:osMglDby4csGZ5sIfhNyYq1bS1TxIdPY88+skE/kkmI=
-github.com/stackitcloud/stackit-sdk-go/services/edge v0.4.3 h1:TxChb2qbO82JiQEBYClSSD5HZxqKeKJ6dIvkEUCJmbs=
-github.com/stackitcloud/stackit-sdk-go/services/edge v0.4.3/go.mod h1:KVWvQHb7CQLD9DzA4Np3WmakiCCsrHaCXvFEnOQ7nPk=
+github.com/stackitcloud/stackit-sdk-go/core v0.22.0 h1:6rViz7GnNwXSh51Lur5xuDzO8EWSZfN9J0HvEkBKq6c=
+github.com/stackitcloud/stackit-sdk-go/core v0.22.0/go.mod h1:osMglDby4csGZ5sIfhNyYq1bS1TxIdPY88+skE/kkmI=
 gopkg.in/check.v1 v0.0.0-20161208181325-20d25e280405 h1:yhCVgyC4o1eVCa2tZl7eS0r+SDo693bJlVdllGtEeKM=
 gopkg.in/check.v1 v0.0.0-20161208181325-20d25e280405/go.mod h1:Co6ibVJAznAaIkqp8huTwlJQCZ016jof/cbN4VW5Yz0=
 gopkg.in/yaml.v3 v3.0.1 h1:fxVm/GzAzEWqLHuvctI91KS9hhNmmWOoWu0XTYJS7CA=

services/edge/CHANGELOG.md

@@ -1,3 +1,9 @@
+## v0.5.0
+- **Feature:** Introduction of multi API version support for the edge SDK module. For more details please see the announcement on GitHub: https://github.com/stackitcloud/stackit-sdk-go/discussions/5062
+- `v1beta1api`: New package which can be used for communication with the edge v1 beta1 API
+- **Deprecation:** The contents in the root of this SDK module including the `wait` package are marked as deprecated and will be removed after 2026-09-30. Switch to the new packages for the available API versions instead.
+- **Dependencies:** Bump STACKIT SDK core module from `v0.21.1` to `v0.22.0`
+
 ## v0.4.3
 - Bump STACKIT SDK core module from `v0.21.0` to `v0.21.1`
 

services/edge/VERSION

@@ -1 +1 @@
-v0.4.3
+v0.5.0