Available in Classic and VPC
Container Registry is a NAVER Cloud Platform service that allows you to easily store, manage, and distribute container images as a private Docker container image repository based on the Docker Registry v2 specification.
The Container Registry service provides APIs for registry and Docker container image management features in RESTful form.
Common Container Registry settings
The following describes commonly used request and response formats in Container Registry APIs.
Request
The following describes the common request format.
API URL
The request API URL is as follows:
Korea Region: https://ncr.apigw.ntruss.com/ncr/api/v2
Singapore Region: https://ncr.apigw.ntruss.com/ncr/sgn-api/v2
Japan Region: https://ncr.apigw.ntruss.com/ncr/jpn-api/v2
Request headers
The following describes the request headers.
| Field | Required | Description |
|---|---|---|
x-ncp-apigw-timestamp |
Required | This is the number of milliseconds that have elapsed since January 1, 1970 00:00:00 UTC.
|
x-ncp-iam-access-key |
Required | Access key issued on NAVER Cloud Platform
|
x-ncp-apigw-signature-v2 |
Required | Base64-encoded signature that encrypts the request information with a secret key that maps to the access key issued on NAVER Cloud Platform, using the HMAC encryption algorithm (HmacSHA256).
|
Content-Type |
Required | Request data format
|
Response
The following describes the common response format.
Response status codes
The following describes the response status codes.
| HTTP status code | Code | Message | Description |
|---|---|---|---|
| 200 | - | OK | Request succeeded |
| 201 | - | OK | Request succeeded |
| 204 | - | OK | Request succeeded |
| 400 | - | Bad Request | Request error due to HTTPS protocol or UTF-8 encoding. |
| 401 | - | Unauthorized | Authentication information to use the requested resource was not provided or is invalid. |
| 403 | - | Forbidden | No permissions to the requested resource. |
| 404 | - | Not Found | Requested resource not found. |
| 409 | - | Conflict | A crash occurred while processing the request. |
| 500 | - | Internal Server Error | Server error |
For response status codes common to NAVER Cloud Platform, see Ncloud API response status codes.
Container Registry API
The following describes the APIs provided by the Container Registry service.
| API | Description |
|---|---|
| Get registry list | Get the list of registries registered in Container Registry. |
| Register new registry | Register a new registry integrated with an Object Storage bucket. |
| Delete registry | Delete a registry registered in Container Registry. |
| Get image list | Get the list of images registered in the registry of Container Registry. |
| Get image details | Get details of an image registered in the registry of Container Registry. |
| Edit image information | Edit the description of an image registered in the registry of Container Registry. |
| Delete image | Delete an image registered in the registry of Container Registry. |
| Get image tag list | Get the list of tags for an image registered in the registry of Container Registry. |
| Get image tag details | Get the tag information for an image registered in the registry of Container Registry. |
| Delete image tag | Delete a tag for an image registered in the registry of Container Registry. |
Container Registry related resources
NAVER Cloud Platform provides a variety of related resources to help users better understand Container Registry APIs.
- Container Registry API guides
- Create signature: how to create a signature to add to the request header
- Sub Account User Guide: how to issue the access key to be added to the request header
- Common Ncloud response status codes: information on common response status codes of NAVER Cloud Platform used by the Container Registry service
- How to use the Container Registry service
- Container Registry User Guide: how to use Container Registry in the NAVER Cloud Platform console
- Ncloud use environment guide: guide on VPC and Classic environments and supported features
- Introduction to pricing, characteristics, and detailed features: the summary of pricing system, characteristics, and detailed features of Container Registry
- Latest service news: the latest news on the Container Registry service
- FAQ: frequently asked questions from the Container Registry service users
- Contact us: Send direct inquiries for unresolved questions that aren't answered by the API guide.