feat(resourcemanager): add multi API version support (#5123)

relates to STACKITSDK-351

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

Author: stackit-pipeline

CHANGELOG.md

@@ -8,6 +8,12 @@
   - **Breaking change:** Renamed `TargetPoolTlsConfig` to `TlsConfig`
 - `loadbalancer`: [v1.8.0](services/loadbalancer/CHANGELOG.md#v180)
   - **Feature:** Add new fields `AltPort` and `HttpHealthCheck` to `ActiveHealthCheck`
+- `resourcemanager`: [v0.19.0](services/resourcemanager/CHANGELOG.md#v0190)
+  - **Feature:** Introduction of multi API version support for the resourcemanager SDK module. For more details please see the announcement on GitHub: https://github.com/stackitcloud/stackit-sdk-go/discussions/5062
+  - `v0api`: New package which should be used for communication with the STACKIT Resourcemanager API in the future
+  - **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 `v0api` package instead.
+  - **Dependencies:** Bump STACKIT SDK core module from `v0.21.1` to `v0.22.0`
+  - **Breaking Change:** Removal of deprecated constants `ActiveState` and `CreatingState` in `wait` package
 
 ## Release (2026-02-20)
 - `core`: [v0.21.1](core/CHANGELOG.md#v0211) 

examples/resourcemanager/go.mod

@@ -2,12 +2,13 @@ module github.com/stackitcloud/stackit-sdk-go/examples/resourcemanager
 
 go 1.21
 
-require (
-	github.com/stackitcloud/stackit-sdk-go/core v0.21.1
-	github.com/stackitcloud/stackit-sdk-go/services/resourcemanager v0.18.5
-)
+// 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/resourcemanager => ../../services/resourcemanager
+
+require github.com/stackitcloud/stackit-sdk-go/services/resourcemanager v0.0.0-00010101000000-000000000000
 
 require (
 	github.com/golang-jwt/jwt/v5 v5.3.1 // indirect
 	github.com/google/uuid v1.6.0 // indirect
+	github.com/stackitcloud/stackit-sdk-go/core v0.22.0 // indirect
 )

examples/resourcemanager/go.sum

@@ -4,7 +4,5 @@ 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/resourcemanager v0.18.5 h1:MZ5aTO2NQ1Jecmi67ByGskve5nKXHl91fE+z+vFjxt4=
-github.com/stackitcloud/stackit-sdk-go/services/resourcemanager v0.18.5/go.mod h1:CJLmdqWvJm5/3+lXPDKu8k4WXs2UG8euGoqQX5xE79k=
+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=

examples/resourcemanager/resourcemanager.go

@@ -5,8 +5,7 @@ import (
 	"fmt"
 	"os"
 
-	"github.com/stackitcloud/stackit-sdk-go/core/utils"
-	"github.com/stackitcloud/stackit-sdk-go/services/resourcemanager"
+	resourcemanager "github.com/stackitcloud/stackit-sdk-go/services/resourcemanager/v0api"
 )
 
 func main() {
@@ -21,28 +20,28 @@ func main() {
 	}
 
 	// Get the projects under a specific resource (organization)
-	getProjectsResp, err := client.ListProjects(context.Background()).ContainerParentId(parentOrganizationId).Execute()
+	getProjectsResp, err := client.DefaultAPI.ListProjects(context.Background()).ContainerParentId(parentOrganizationId).Execute()
 	if err != nil {
 		fmt.Fprintf(os.Stderr, "Error when calling `GetProjects`: %v\n", err)
 	} else {
-		fmt.Printf("Number of projects: %v\n", len(*getProjectsResp.Items))
+		fmt.Printf("Number of projects: %v\n", len(getProjectsResp.Items))
 	}
 
 	// Create a project
 	createProjectPayload := resourcemanager.CreateProjectPayload{
-		ContainerParentId: utils.Ptr(parentOrganizationId),
-		Name:              utils.Ptr("my-project"),
-		Members: &[]resourcemanager.Member{
+		ContainerParentId: parentOrganizationId,
+		Name:              "my-project",
+		Members: []resourcemanager.Member{
 			{
-				Role:    utils.Ptr("project.owner"),
-				Subject: utils.Ptr("owner-email@example.com"),
+				Role:    "project.owner",
+				Subject: "owner-email@example.com",
 			},
 		},
 	}
-	createProjectResp, err := client.CreateProject(context.Background()).CreateProjectPayload(createProjectPayload).Execute()
+	createProjectResp, err := client.DefaultAPI.CreateProject(context.Background()).CreateProjectPayload(createProjectPayload).Execute()
 	if err != nil {
 		fmt.Fprintf(os.Stderr, "Error when calling `CreateProject`: %v\n", err)
 	} else {
-		fmt.Printf("Created project with id \"%s\".\n", *createProjectResp.ProjectId)
+		fmt.Printf("Created project with id \"%s\".\n", createProjectResp.ProjectId)
 	}
 }

golang-ci.yaml

@@ -93,4 +93,10 @@ linters:
     - unparam # false positives
 issues:
   exclude-use-default: false
+  exclude-rules:
+    # This ignores all deprecation warnings in the old wait packages while we have the compatibilty layer in place
+    - path: ^wait/[^/]+\.go$
+      linters:
+        - staticcheck
+      text: "SA1019:" 
 go: 1.21

services/resourcemanager/CHANGELOG.md

@@ -1,3 +1,10 @@
+## v0.19.0
+- **Feature:** Introduction of multi API version support for the resourcemanager SDK module. For more details please see the announcement on GitHub: https://github.com/stackitcloud/stackit-sdk-go/discussions/5062
+- `v0api`: New package which should be used for communication with the STACKIT Resourcemanager API in the future
+- **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 `v0api` package instead.
+- **Dependencies:** Bump STACKIT SDK core module from `v0.21.1` to `v0.22.0`
+- **Breaking Change:** Removal of deprecated constants `ActiveState` and `CreatingState` in `wait` package
+
 ## v0.18.5
 - Bump STACKIT SDK core module from `v0.21.0` to `v0.21.1`
 

services/resourcemanager/VERSION

@@ -1 +1 @@
-v0.18.5
+v0.19.0