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	GET Registries	GET Registry by ID
Create Container Registry	Create Registry Token	Delete 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. Please refer to our blogpost about curl on Windows if you encounter any problems:

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

Getting started with cURL in WindowsIONOS Digital Guide