Create a Private Container Registry

Once you have fetched your required information, you can now create a new Private Container Registry. For the Private Container Registry, you can alter the days and time. You can also update the location based on the available Private Container Registry locations.

We assume the following prerequisites:

• A location for Private Container Registry
• An available name for the Private Container Registry

With the POST request, you can create a Private Container Registry.

Request

curl --location  \
--request POST 'https://api.ionos.com/containerregistries/registries' \
--header 'Authorization: Bearer ${TOKEN}' \
--header 'Content-Type: application/json' \
--data-raw '{
  "properties": {
    "garbageCollectionSchedule": {
      "days": [
        "Saturday",
        "Sunday"
      ],
      "time": "19:30:00+00:00"
    },
    "location": "de/fra",
    "name": "demo",
    "apiSubnetAllowList": ["198.51.100.0/24", "203.0.113.1/32"]
  }
}'

Input Parameters

You can update the limit value to get specific Private Container Registries based on the limit value being passed.

Field	Type	Description	Example
days	array	The days of the week selected.	Monday
time	string	The timestamp of creation of the Private Container Registry.	19:30:00+00:00
location	string	The location of the resource.	de/fra
name	string	The name of the Private Container Registry. It must be unique within the folder.	Demo
days	array	The days of the week selected.	Monday
apiSubnetAllowList	array	The list of IP subnets that can access the Private Container Registry. If this parameter is omitted, the Private Container Registry is reachable from any IP address.	198.51.100.0/24

Response

200 OK - Successfully showed the list of Private Container Registries.

{
   "id": "709y8e3c-d5c8-4359-8f85-c200fb89e87c",
   "type": "registry",
   "href": "",
   "metadata": {
       "createdBy": "[e-mail]",
       "createdByUserId": "a7af0375-1c1d-4387-9ef1-6eu95d30e74a",
       "createdDate": "2022-10-07T14:30:06Z",
       "state": "New"
   },
   "properties": {
       "name": "demo",
       "location": "de/fra",
       "garbageCollectionSchedule": {
           "days": [
               "Sunday",
               "Saturday"
           ],
           "time": "19:30:00+00:00"
       },
       "storageUsage": {
           "bytes": 0
       },
       "hostname": "",
       "apiSubnetAllowList": ["198.51.100.0/24", "203.0.113.1/32"]
   }
}

Response Fields

Field	Type	Description	Example
id	string	The ID of fetched output.	locations
type	string	The type of resource.	registry
createdBy	string	ID of the user or service account that initiated the operation.	[e-mail]
createdDate	string	The date when the operation was initiated.	h2022-10-07T14:30:06Z
days	array	The days of the week selected.	Sunday, Saturday
apiSubnetAllowList	array	The list of IP subnets in CIDR notation that can access the Private Container Registry. For single IPs a /32 mask can be used. Addresses without a mask will be assumed to carry a /32 mask.	198.51.100.0/24

Note:

• Your values will differ from those in the sample code. The Private Container Registry will be created as shown in the 201 response. Your response will have a different id, createdBy and createdDate.
• The output does not contain a hostname because the host has not been allocated yet.

400 Bad Request - The request made is invalid or corrupted

{
 "httpStatus": 400,
 "messages": [
   {
     "errorCode": "123",
     "message": "ad velit dolor dolore laboris"
   },
   {
     "errorCode": "123",
     "message": "tempo
   }
 ]
}