Java SDKs

Use the IONOS CLOUD Java SDKs to build Java apps on IONOS CLOUD. Each SDK is available on Maven Central.

Available Java SDKs

Core Infrastructure

Cloud API Java SDK

Manage compute, networking, and storage

Database

DBaaS Mongo Java SDK

Provision and manage MongoDB clusters

DBaaS Postgres Java SDK

Provision and manage PostgreSQL clusters

MariaDB SDK Java

Provision and manage MariaDB clusters

Containers

Container Registry Java SDK

Manage container registries and image repositories

Security

Certificate Manager Java SDK

Manage TLS/SSL certificates

Quick Start

Add the SDK to your Maven project:

<dependency>
    <groupId>com.ionoscloud</groupId>
    <artifactId>ionos-cloud-sdk</artifactId>
    <version>LATEST</version>
</dependency>

Or with Gradle:

implementation 'com.ionoscloud:ionos-cloud-sdk:LATEST'

Set up a client:

import com.ionoscloud.ApiClient;
import com.ionoscloud.Configuration;

ApiClient client = Configuration.getDefaultApiClient();
client.setUsername(System.getenv("IONOS_USERNAME"));
client.setPassword(System.getenv("IONOS_PASSWORD"));

Use a token instead:

HttpBearerAuth tokenAuth =
    (HttpBearerAuth) client.getAuthentication("Token Authentication");
tokenAuth.setBearerToken(System.getenv("IONOS_TOKEN"));

Authentication

All Java SDKs use the same credentials. Store them in environment variables and keep them out of your source code.

export IONOS_USERNAME=[e-mail]
export IONOS_PASSWORD=yourpassword

# Use a token for CI/CD:
export IONOS_TOKEN=your_api_token

GitHub Repositories

All Java SDKs are open source on GitHub under ionos-cloud. Product SDKs follow the pattern ionos-cloud-sdk-{service}.