feat(automation): onboard automation service

Author: marceljk

services/alb/src/main/java/cloud/stackit/sdk/alb/v2api/model/LoadbalancerOptionAccessControl.java

@@ -31,14 +31,22 @@
 import java.util.Map;
 import java.util.Objects;
 
-/** Use this option to limit the IP ranges that can use the Application Load Balancer. */
+/**
+ * Use this option to limit the IP ranges that can use the Application Load Balancer. Only one of
+ * `allowed_source_ranges` or `ip_block_list_name` may be set at the same time.
+ */
 @javax.annotation.Generated(value = "JavaGenerator", comments = "Generator version: 7.19.0")
 public class LoadbalancerOptionAccessControl {
 	public static final String SERIALIZED_NAME_ALLOWED_SOURCE_RANGES = "allowedSourceRanges";
 
 	@SerializedName(SERIALIZED_NAME_ALLOWED_SOURCE_RANGES)
 	@javax.annotation.Nullable private List<String> allowedSourceRanges = new ArrayList<>();
 
+	public static final String SERIALIZED_NAME_IP_BLOCK_LIST_NAME = "ipBlockListName";
+
+	@SerializedName(SERIALIZED_NAME_IP_BLOCK_LIST_NAME)
+	@javax.annotation.Nullable private String ipBlockListName;
+
 	public LoadbalancerOptionAccessControl() {}
 
 	public LoadbalancerOptionAccessControl allowedSourceRanges(
@@ -57,7 +65,8 @@ public LoadbalancerOptionAccessControl addAllowedSourceRangesItem(
 	}
 
 	/**
-	 * Application Load Balancer is accessible only from an IP address in this range
+	 * Application Load Balancer is accessible only from an IP address in this range. Mutually
+	 * exclusive with &#x60;ipBlockListName&#x60;.
 	 *
 	 * @return allowedSourceRanges
 	 */
@@ -70,6 +79,27 @@ public void setAllowedSourceRanges(
 		this.allowedSourceRanges = allowedSourceRanges;
 	}
 
+	public LoadbalancerOptionAccessControl ipBlockListName(
+			@javax.annotation.Nullable String ipBlockListName) {
+		this.ipBlockListName = ipBlockListName;
+		return this;
+	}
+
+	/**
+	 * Reference to an IP block list by name. Traffic originating from any IP in the referenced list
+	 * is denied access to the Application Load Balancer. See \&quot;IP Lists API\&quot; for how to
+	 * manage IP block lists. Mutually exclusive with &#x60;allowedSourceRanges&#x60;.
+	 *
+	 * @return ipBlockListName
+	 */
+	@javax.annotation.Nullable public String getIpBlockListName() {
+		return ipBlockListName;
+	}
+
+	public void setIpBlockListName(@javax.annotation.Nullable String ipBlockListName) {
+		this.ipBlockListName = ipBlockListName;
+	}
+
 	/**
 	 * A container for additional, undeclared properties. This is a holder for any undeclared
 	 * properties as specified with the 'additionalProperties' keyword in the OAS document.
@@ -127,14 +157,16 @@ public boolean equals(Object o) {
 		return Objects.equals(
 						this.allowedSourceRanges,
 						loadbalancerOptionAccessControl.allowedSourceRanges)
+				&& Objects.equals(
+						this.ipBlockListName, loadbalancerOptionAccessControl.ipBlockListName)
 				&& Objects.equals(
 						this.additionalProperties,
 						loadbalancerOptionAccessControl.additionalProperties);
 	}
 
 	@Override
 	public int hashCode() {
-		return Objects.hash(allowedSourceRanges, additionalProperties);
+		return Objects.hash(allowedSourceRanges, ipBlockListName, additionalProperties);
 	}
 
 	@Override
@@ -144,6 +176,7 @@ public String toString() {
 		sb.append("    allowedSourceRanges: ")
 				.append(toIndentedString(allowedSourceRanges))
 				.append("\n");
+		sb.append("    ipBlockListName: ").append(toIndentedString(ipBlockListName)).append("\n");
 		sb.append("    additionalProperties: ")
 				.append(toIndentedString(additionalProperties))
 				.append("\n");
@@ -167,7 +200,8 @@ private String toIndentedString(Object o) {
 
 	static {
 		// a set of all properties/fields (JSON key names)
-		openapiFields = new HashSet<String>(Arrays.asList("allowedSourceRanges"));
+		openapiFields =
+				new HashSet<String>(Arrays.asList("allowedSourceRanges", "ipBlockListName"));
 
 		// a set of required properties/fields (JSON key names)
 		openapiRequiredFields = new HashSet<String>(0);
@@ -202,6 +236,14 @@ public static void validateJsonElement(JsonElement jsonElement) throws IOExcepti
 							"Expected the field `allowedSourceRanges` to be an array in the JSON string but got `%s`",
 							jsonObj.get("allowedSourceRanges").toString()));
 		}
+		if ((jsonObj.get("ipBlockListName") != null && !jsonObj.get("ipBlockListName").isJsonNull())
+				&& !jsonObj.get("ipBlockListName").isJsonPrimitive()) {
+			throw new IllegalArgumentException(
+					String.format(
+							java.util.Locale.ROOT,
+							"Expected the field `ipBlockListName` to be a primitive type in the JSON string but got `%s`",
+							jsonObj.get("ipBlockListName").toString()));
+		}
 	}
 
 	public static class CustomTypeAdapterFactory implements TypeAdapterFactory {

services/automation/README.md

@@ -0,0 +1,80 @@
+# STACKIT Java SDK for STACKIT Automation Service API
+
+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)
+
+The release artifacts for this SDK submodule are available on [Maven Central](https://central.sonatype.com/artifact/cloud.stackit.sdk/automation).
+
+### Maven users
+
+Add this dependency to your project's POM:
+
+```xml
+<dependency>
+  <groupId>cloud.stackit.sdk</groupId>
+  <artifactId>automation</artifactId>
+  <version><SDK_VERSION></version>
+  <scope>compile</scope>
+</dependency>
+```
+
+### Gradle users
+
+Add this dependency to your project's build file:
+
+```groovy
+  repositories {
+    mavenCentral()
+  }
+
+  dependencies {
+     implementation "cloud.stackit.sdk:automation:<SDK_VERSION>"
+  }
+```
+
+## Installation from local build
+
+Building the API client library requires:
+1. Java SDK (version 11 to 21 should be supported) installed on your system
+
+To install the API client library to your local Maven repository, simply execute:
+
+```shell
+./gradlew services:automation:publishToMavenLocal
+```
+
+### Maven users
+
+Add this dependency to your project's POM:
+
+```xml
+<dependency>
+  <groupId>cloud.stackit.sdk</groupId>
+  <artifactId>automation</artifactId>
+  <version><SDK_VERSION></version>
+  <scope>compile</scope>
+</dependency>
+```
+
+### Gradle users
+
+Add this dependency to your project's build file:
+
+```groovy
+  repositories {
+    mavenLocal()
+  }
+
+  dependencies {
+     implementation "cloud.stackit.sdk:automation:<SDK_VERSION>"
+  }
+```
+
+## Getting Started
+
+See the [automation examples](https://github.com/stackitcloud/stackit-sdk-java/tree/main/examples/automation/src/main/java/cloud/stackit/sdk/automation/examples).
+
+## Recommendation
+
+It's recommended to create an instance of `ApiClient` per thread in a multithreaded environment to avoid any potential issues.

services/automation/build.gradle

@@ -0,0 +1,19 @@
+
+ext {
+	jakarta_annotation_version = "1.3.5"
+}
+
+dependencies {
+	implementation "com.google.code.findbugs:jsr305:3.0.2"
+	implementation 'com.squareup.okhttp3:okhttp:4.12.0'
+	implementation 'com.squareup.okhttp3:logging-interceptor:4.12.0'
+	implementation 'com.google.code.gson:gson:2.9.1'
+	implementation 'io.gsonfire:gson-fire:1.9.0'
+	implementation 'jakarta.ws.rs:jakarta.ws.rs-api:2.1.6'
+	implementation 'org.openapitools:jackson-databind-nullable:0.2.8'
+	implementation group: 'org.apache.commons', name: 'commons-lang3', version: '3.18.0'
+	implementation "jakarta.annotation:jakarta.annotation-api:$jakarta_annotation_version"
+	testImplementation 'org.junit.jupiter:junit-jupiter-api:5.10.3'
+	testImplementation 'org.mockito:mockito-core:3.12.4'
+	testRuntimeOnly 'org.junit.jupiter:junit-jupiter-engine:5.10.3'
+}

services/automation/src/main/java/cloud/stackit/sdk/automation/v1betaapi/ApiCallback.java

@@ -0,0 +1,60 @@
+/*
+ * STACKIT Automation Service API
+ * API endpoints for automation management .
+ *
+ * The version of the OpenAPI document: 1beta.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.automation.v1betaapi;
+
+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);
+}