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 service

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:

cURL in Linux: what you need to know to get startedIONOS Digitalguide

Getting started with cURL in WindowsIONOS Digitalguide