feat(serverupdate): add multi API version support (#534)

relates to STACKITSDK-423

Author: rubenhoenle

CHANGELOG.md

@@ -7,6 +7,8 @@
   - **Feature (breaking change):** Introduction of multi API version support. See the GitHub discussion post for more details: https://github.com/stackitcloud/stackit-sdk-java/discussions/530
 - `sfs`: [v0.3.1](services/sfs/CHANGELOG.md#v031)
   - Deprecate `getSchedule` and `listSchedules` methods in `SfsApi` class
+- `serverupdate`: [v0.2.0](services/serverupdate/CHANGELOG.md#v020)
+  - **Feature (breaking change):** Introduction of multi API version support. See the GitHub discussion post for more details: https://github.com/stackitcloud/stackit-sdk-java/discussions/530
 
 ## Release (2026-04-08)
 - `iaas`: 

examples/serverupdate/src/main/java/cloud/stackit/sdk/serverupdate/examples/ServerUpdateExample.java

@@ -3,8 +3,8 @@
 import cloud.stackit.sdk.core.KeyFlowAuthenticator;
 import cloud.stackit.sdk.core.config.CoreConfiguration;
 import cloud.stackit.sdk.core.exception.ApiException;
-import cloud.stackit.sdk.serverupdate.api.ServerUpdateApi;
-import cloud.stackit.sdk.serverupdate.model.*;
+import cloud.stackit.sdk.serverupdate.v2api.api.ServerUpdateApi;
+import cloud.stackit.sdk.serverupdate.v2api.model.*;
 import java.io.IOException;
 import java.net.HttpURLConnection;
 import java.time.Duration;

services/serverupdate/CHANGELOG.md

@@ -1,3 +1,6 @@
+## v0.2.0
+- **Feature (breaking change):** Introduction of multi API version support. See the GitHub discussion post for more details: https://github.com/stackitcloud/stackit-sdk-java/discussions/530
+
 ## v0.1.3
 - Bump dependency `org.apache.commons:commons-lang3` to `3.18.0`
 - Bump dependency `org.openapitools:jackson-databind-nullable` to `0.2.8`
@@ -9,4 +12,4 @@
 - Bump dependency `cloud.stackit.sdk.core` to v0.4.1
 
 ## v0.1.0
-- Initial onboarding of STACKIT Java SDK for Server Update service
+- Initial onboarding of STACKIT Java SDK for Server Update service

services/serverupdate/README.md

@@ -1,10 +1,5 @@
 # STACKIT Java SDK for STACKIT Server Update Management API
 
-- API version: 2.0
-
-API endpoints for Server Update Operations on STACKIT Servers.
-
-
 This package is part of the STACKIT Java SDK. For additional information, please visit the [GitHub repository](https://github.com/stackitcloud/stackit-sdk-java) of the SDK.
 
 ## Installation from Maven Central (recommended)

services/serverupdate/VERSION

@@ -1 +1 @@
-0.1.3
+0.2.0

services/serverupdate/src/main/java/cloud/stackit/sdk/serverupdate/v1api/ApiCallback.java

@@ -0,0 +1,60 @@
+/*
+ * STACKIT Server Update Management API
+ * API endpoints for Server Update Operations on STACKIT Servers.
+ *
+ * The version of the OpenAPI document: 1.0
+ * Contact: support@stackit.de
+ *
+ * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
+ * https://openapi-generator.tech
+ * Do not edit the class manually.
+ */
+
+package cloud.stackit.sdk.serverupdate.v1api;
+
+import cloud.stackit.sdk.core.exception.ApiException;
+import java.util.List;
+import java.util.Map;
+
+/**
+ * Callback for asynchronous API call.
+ *
+ * @param <T> The return type
+ */
+public interface ApiCallback<T> {
+	/**
+	 * This is called when the API call fails.
+	 *
+	 * @param e The exception causing the failure
+	 * @param statusCode Status code of the response if available, otherwise it would be 0
+	 * @param responseHeaders Headers of the response if available, otherwise it would be null
+	 */
+	void onFailure(ApiException e, int statusCode, Map<String, List<String>> responseHeaders);
+
+	/**
+	 * This is called when the API call succeeded.
+	 *
+	 * @param result The result deserialized from response
+	 * @param statusCode Status code of the response
+	 * @param responseHeaders Headers of the response
+	 */
+	void onSuccess(T result, int statusCode, Map<String, List<String>> responseHeaders);
+
+	/**
+	 * This is called when the API upload processing.
+	 *
+	 * @param bytesWritten bytes Written
+	 * @param contentLength content length of request body
+	 * @param done write end
+	 */
+	void onUploadProgress(long bytesWritten, long contentLength, boolean done);
+
+	/**
+	 * This is called when the API download processing.
+	 *
+	 * @param bytesRead bytes Read
+	 * @param contentLength content length of the response
+	 * @param done Read end
+	 */
+	void onDownloadProgress(long bytesRead, long contentLength, boolean done);
+}