# 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:

* [<mark style="color:blue;">A location for container registry</mark>](https://docs.ionos.com/sections-test/guides/containers/private-container-registry/api-howtos/locations)
* [<mark style="color:blue;">An available name for the registry</mark>](https://docs.ionos.com/sections-test/guides/containers/private-container-registry/api-howtos/registries)

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

## Request

```bash
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 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**

```json
{
   "id": "709y8e3c-d5c8-4359-8f85-c200fb89e87c",
   "type": "registry",
   "href": "",
   "metadata": {
       "createdBy": "sample@ionos.com",
       "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.                                                         | `sample@ionos.com`      |
| **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`       |

{% hint style="info" %}
**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.
  {% endhint %}

**400 Bad Request - The request made is invalid or corrupted**

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