GET Registry by ID

You can get the information for a particular container registry. At this point, a hostname will be allocated to your registry. The registry hostname becomes a part of your image or your manifest or the repository name.
With the GET request, you can fetch the registry information by ID. The registryId must be provided. You can get it through GET Registries API call.
Note: The sample requestID is 789f8e3c-d5c8-4359-8f85-c200fb89e97c
Request
curl --location  \
    --request GET 'https://api.ionos.com/containerregistries/registries/:789f8e3c-d5c8-4359-8f85-c200fb89e97c' \
    --header 'Authorization: Basic am9obkBleGFtcGxlLmNvbTphYmMxMjM=' \
--data-raw ''
Path parameters:
Field
Type
Description
Example
registryId
string
The ID of the registry to return. This is required.
789f8e3c-d5c8-4359-8f85-c200fb89e97
Response
200 OK - Successful operation
{
   "id": "8fb59000-494c-11ed-0242ac120002,
   "type": "registry",
   "href": "",
   "metadata": {
       "createdBy": "[email protected]",
       "createdByUserId": "a5af0375-1c1d-4387-9ef1-6ee95d30e54a",
       "createdDate": "2022-10-07T14:30:06Z",
       "state": "Running"
   },
   "properties": {
       "name": "demo",
       "location": "de/fra",
       "garbageCollectionSchedule": {
           "days": [
               "Sunday",
               "Saturday"
           ],
           "time": "19:30:00+00:00"
       },
       "storageUsage": {
           "bytes": 0,
           "updatedAt": "2022-10-07T14:40:20Z"
       },
       "hostname": "demo.cr.de-fra.test.com"
   }
}
 
Response Fields
Field
Type
Description
Example
createdBy
string
The user who created the token.
[email protected]
type
string
The type of resource.
registry
createdByUserId
string
The ID of the user or service account that initiated the operation.
8fb59000-494c-11ed-0242ac120002
createdDate
string
The date when the operation was initiated.
2022-10-07T14:30:06Z
state
string
The status of the registry.
Running
hostname
string
The allocated hostname for the particular registry.
demo.cr.de-fra.test.com
Note:
Your values will differ from those in the sample code. Your response will have a different id and a hostname.
Save the hostname in the reponse sample for using the Docker commands.
400 Bad Request - The request made is invalid or corrupted
{
 "httpStatus": 400,
 "messages": [
   {
     "errorCode": "123",
     "message": "ad velit dolor dolore laboris"
   },
   {
     "errorCode": "123",
     "message": "tempor"
   }
 ]
}
404 Not Found - The server did not find anything matching the request
{
 "httpStatus": 400,
 "messages": [
   {
     "errorCode": "123",
     "message": "ad velit dolor dolore laboris"
   },
   {
     "errorCode": "123",
     "message": "tempor"
   }
 ]
}
​

Field	Type	Description	Example
registryId	string	The ID of the registry to return. This is required.	`789f8e3c-d5c8-4359-8f85-c200fb89e97`

Field	Type	Description	Example
createdBy	string	The user who created the token.	`[email protected]`
type	string	The type of resource.	`registry`
createdByUserId	string	The ID of the user or service account that initiated the operation.	`8fb59000-494c-11ed-0242ac120002`
createdDate	string	The date when the operation was initiated.	`2022-10-07T14:30:06Z`
state	string	The status of the registry.	`Running`
hostname	string	The allocated hostname for the particular registry.	`demo.cr.de-fra.test.com`

Create Container Registry

Create Registry Token

Last modified 11mo ago