GET Locations

To create a container registry, you should be aware of available locations where you can create your container registry.

Note: The retrieved locations are read-only and cannot be changed.

Request

curl --location \
    --request GET \
    'https://api.ionos.com/containerregistries/locations' \
--header 'Authorization: Basic am9obkBleGFtcGxlLmNvbTphYmMxMjM=' \
--data-raw ''

Response

200 OK - Successfully received the locations of a registry

{
   "id": "locations",
   "type": "collection",
   "href": "",
   "items": [
       {
           "id": "de/fra"
       }
   ]
}

Response Fields

Field
Type
Description
Example

id

string

The id of the object that has been retrieved.

locations

type

string

The type of the resource that has been retrieved.

collection

ref

URL (string)

URL to the object representation (absolute path)

https://api.ionos.com/cloudapi/v6/locations

items

array

The location of the container registry

"id": "de/fra"

Note:

  • Your values will differ from those in the sample code. Your response will have different locations.

  • A location is identified by a combination of the following characters:

    • a two-character value in Id represents a country (example: de)

    • a three-character value in Id represents a city. The locationId is typically based on the IATA code of the city's airport (example: fra).

Last updated

Revision created

Minor update from the comments