Create Container Registry

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

We assume the following prerequisites:

• A location for container registry

• An available name for the registry

With the POST request, you can create a container registry.

Request

curl --location  \
--request POST 'https://api.ionos.com/containerregistries/registries' \
--header 'Authorization: Basic am9obkBleGFtcGxlLmNvbTphYmMxMjM=' \
--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 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 registry	19:30:00+00:00
location	string	The location of the resource.	de/fra
name	string	The name of the 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 registry. If this parameter is omitted, the registry will be accessible from any IP address.	198.51.100.0/24

Response

200 OK - Successfully showed the list of 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 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 container registry will be created as shown in the 201 response. Your response will have a different id, createdBy and createdDate.

• Here, we do not get a hostname in the output because the host has not be 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
   }
 ]
}