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-c200fb89e97ccurl --location \
--request GET 'https://api.ionos.com/containerregistries/registries/:789f8e3c-d5c8-4359-8f85-c200fb89e97c' \
--header 'Authorization: Basic am9obkBleGFtcGxlLmNvbTphYmMxMjM=' \
--data-raw ''
Field | Type | Description | Example |
---|---|---|---|
registryId | string | The ID of the registry to return. This is required. | 789f8e3c-d5c8-4359-8f85-c200fb89e97 |
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"
}
}
Field | Type | Description | Example |
---|---|---|---|
createdBy | string | The user who created the token. | |
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 ahostname
.
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"
}
]
}
Last modified 11mo ago