API How-Tos

The IONOS Cloud Container Registry service allows you to manage Docker and OCI compatible registries for use by your managed Kubernetes clusters. Use a container registry to make sure you have a private registry to effectively support pulling images.

Quick Links

GET Locations

Learn how to retrieve a container registry location.

GET Registries

Learn how to retrieve existing registries.

GET Registry by ID

Learn how to fetch registry information by ID.

Create Container Registry

Learn how to create a new registry.

Create Registry Token

Learn how to create a registry token.

Delete Repository

Learn how to delete a repository.

Delete Token

Learn how to delete a registry token.

Delete Registry

Learn how to delete your container registry.

ContainerRegistry API - OpenAPI Specification

Container Registry serviceapi.ionos.com

Click here for the OpenAPI Specification File

Endpoint: https://api.ionos.com/containerregistries

To make authenticated requests to the API, you must include a few fields in the request headers. Please find relevant descriptions below:

Request parameter headers

Header	Required	Type	Description
Authorization	yes	string	HTTP Basic authorization. A base64 encoded string of a username and password separated by a colon. [email protected]:password
X-Contract-Number	no	integer	Users with more than one contract may apply this header to indicate the applicable contract.
Content-Type	yes	string	Set this to application/json.

Examples

We use curl in our examples, as this tool is available on Windows 10, Linux, and macOS. If you encounter any problems, refer to our blog post about curl on Windows:

Linux cURL - How to use the Curl Command in LinuxIONOS Digital Guide

Getting started with cURL in WindowsIONOS Digital Guide