---
title: "Container Registry overview"
slug: "compute-containerregistry"
tags: ["Container Registry", "overview"]
updated: 2026-09-17T10:05:54Z
published: 2026-09-17T10:05:54Z
canonical: "api.ncloud-docs.com/compute-containerregistry"
---

> ## Documentation Index
> Fetch the complete documentation index at: https://api.ncloud-docs.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Container Registry overview

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:

```
https://ncr.apigw.ntruss.com
```

#### 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. - Request is considered invalid if the timestamp differs from the current time by more than 5 minutes. - Unix timestamp format |
| `x-ncp-iam-access-key` | Required | Access key issued on NAVER Cloud Platform - Issue and check access key: See [Create authentication key](/docs/en/common-ncpapi#1%EC%9D%B8%EC%A6%9D%ED%82%A4%EC%83%9D%EC%84%B1). - Issue and check access key for sub account: See [Create sub account](https://guide.ncloud-docs.com/docs/en/subaccount-use#%EC%84%9C%EB%B8%8C-%EA%B3%84%EC%A0%95-%EC%83%9D%EC%84%B1). |
| `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). - Issue and check secret key: See [Create authentication key](/docs/en/common-ncpapi#1%EC%9D%B8%EC%A6%9D%ED%82%A4%EC%83%9D%EC%84%B1). - Create signature: See [Create signature](/docs/en/common-ncpapi#%EC%8B%9C%EA%B7%B8%EB%8B%88%EC%B2%98%EC%83%9D%EC%84%B1). |
| `Content-Type` | Required | Request data format - `application/json` |

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

Note

For response status codes common to NAVER Cloud Platform, see [Ncloud API response status codes](/docs/en/common-ncpapi#3%EC%9D%91%EB%8B%B5%EC%83%81%ED%83%9C%EC%BD%94%EB%93%9C).

## Container Registry API

The following describes the APIs provided by the Container Registry service.

| API | Description |
| --- | --- |
| [Get registry list](/docs/en/containerregistry-getregistry) | Get the list of registries registered in Container Registry. |
| [Register new registry](/docs/en/containerregistry-postregistry) | Register a new registry integrated with an Object Storage bucket. |
| [Delete registry](/docs/en/containerregistry-deleteregistry) | Delete a registry registered in Container Registry. |
| [Get image list](/docs/en/containerregistry-getimages) | Get the list of images registered in the registry of Container Registry. |
| [Get image details](/docs/en/containerregistry-getimagedetail) | Get details of an image registered in the registry of Container Registry. |
| [Edit image information](/docs/en/containerregistry-patchimage) | Edit the description of an image registered in the registry of Container Registry. |
| [Delete image](/docs/en/containerregistry-deleteimage) | Delete an image registered in the registry of Container Registry. |
| [Get image tag list](/docs/en/containerregistry-getimagetags) | Get the list of tags for an image registered in the registry of Container Registry. |
| [Get image tag details](/docs/en/containerregistry-getimagetagdetail) | Get the tag information for an image registered in the registry of Container Registry. |
| [Delete image tag](/docs/en/containerregistry-deleteimagetag) | 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](/docs/en/common-ncpapi#%EC%8B%9C%EA%B7%B8%EB%8B%88%EC%B2%98%EC%83%9D%EC%84%B1): how to create a signature to add to the request header
  - [Sub Account User Guide](https://guide.ncloud-docs.com/docs/en/subaccount-overview): how to issue the access key to be added to the request header
  - [Common Ncloud response status codes](/docs/en/common-ncpapi#3%EC%9D%91%EB%8B%B5%EC%83%81%ED%83%9C%EC%BD%94%EB%93%9C): 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](https://guide.ncloud-docs.com/docs/en/containerregistry-overview): how to use Container Registry in the NAVER Cloud Platform console
  - [Ncloud use environment guide](https://guide.ncloud-docs.com/docs/en/environment-environment-1-1): guide on VPC and Classic environments and supported features
  - [Introduction to pricing, characteristics, and detailed features](https://www.ncloud.com/product/containers/containerRegistry): the summary of pricing system, characteristics, and detailed features of Container Registry
  - [Latest service news](https://www.ncloud.com/intro/news?categoryCode=CNTR&serviceCode=SV_0099): the latest news on the Container Registry service
  - [FAQ](https://www.ncloud.com/support/faq/prod?categoryCode2=CNTR&categoryCode3=SV_0099&page=1): frequently asked questions from the Container Registry service users
  - [Contact us](https://www.ncloud.com/support/question/general): Send direct inquiries for unresolved questions that aren't answered by the API guide.