---
title: "レジストリリストの照会"
slug: "containerregistry-getregistry"
updated: 2026-09-17T09:57:47Z
published: 2026-09-17T09:57:47Z
canonical: "api.ncloud-docs.com/containerregistry-getregistry"
---

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

# レジストリリストの照会

Classic/VPC環境で利用できます。

Container Registryに登録されているレジストリリストを照会します。

## リクエスト

リクエスト形式を説明します。リクエスト形式は次の通りです。

| メソッド | URI |
| --- | --- |
| GET | /ncr/api/v2/repositories (韓国リージョン) |
| GET | /ncr/sgn-api/v2/repositories (シンガポールリージョン) |
| GET | /ncr/jpn-api/v2/repositories (日本リージョン) |

### リクエストヘッダ

Container Registry APIで共通して使用されるヘッダの詳細は、[Container Registryのリクエストヘッダ](/docs/ja/compute-containerregistry#%EC%9A%94%EC%B2%AD%ED%97%A4%EB%8D%94)をご参照ください。

### リクエストクエリパラメータ

リクエストクエリパラメータの説明は次の通りです。

| フィールド | タイプ | 必須の有無 | 説明 |
| --- | --- | --- | --- |
| `page` | Number | Optional | 照会するページ番号 - ページ番号は0より大きい値を入力 |
| `pagesize` | Number | Optional | 照会するページサイズ - ページサイズは0より大きい値を入力 |

### リクエスト例

リクエストのサンプルコードは次の通りです。

```
curl -X GET 'https://ncr.apigw.ntruss.com/ncr/api/v2/repositories' \
--header 'Content-Type: application/json; charset=utf-8' \
--header 'x-ncp-apigw-timestamp: {Timestamp}' \
--header 'x-ncp-iam-access-key: {Sub Account Access Key}' \
--header 'x-ncp-apigw-signature-v2: {API Gateway Signature}'
```

## レスポンス

レスポンス形式を説明します。

### レスポンス構文

レスポンス構文は次の通りです。

```
{
    "count": "number",
    "next": "number",
    "previous": "number",
    "results": [
        {
            "bucket": "string",
            "created": "number",
            "end_point": "string",
            "end_point_enabled": "boolean",
            "name": "string",
            "private_end_point": "string",
            "private_id": "string",
            "public_reg_status": "boolean",
            "scan_on_push_enabled": "boolean",
            "status": "string",
            "storage_type": "string"
        }
    ]
}
```

### レスポンスボディ

レスポンスボディの説明は次の通りです。

| フィールド | タイプ | 必須の有無 | 説明 |
| --- | --- | --- | --- |
| `count` | Number | - | 登録されているレジストリの総数 |
| `next` | Number | - | 次のページの番号 - 次のページがない場合、`null`を返す |
| `previous` | Number | - | 以前のページの番号 - 以前のページがない場合、`null`を返す |
| `results` | Array | - | レスポンス結果: [results](/docs/ja/containerregistry-getregistry#results) |

#### `results`

`results`の説明は次の通りです。

| フィールド | タイプ | 必須の有無 | 説明 |
| --- | --- | --- | --- |
| `bucket` | String | - | レジストリと連携されているバケットの名前 |
| `created` | Number | - | レジストリの作成日 - 1970年1月1日 00:00:00協定世界時(UTC)からの経過時間をミリ秒(Millisecond)で返す |
| `end_point` | String | - | Dockerクライアントがレジストリにアクセスするためのエンドポイント |
| `end_point_enabled` | Boolean | - | エンドポイントにアクセス可能かどうか |
| `name` | String | - | レジストリ名 |
| `private_end_point` | String | - | Dockerクライアントがレジストリにアクセスするためのエンドポイント - NAVERクラウドプラットフォームの VPCネットワークでのみ使用可能 |
| `private_id` | String | - | Privateエンドポイントの ID |
| `public_reg_status` | Boolean | - | 認証なしでアクセスしたユーザーの Pull権限の有無 - `true` \| `false` |
| `scan_on_push_enabled` | Boolean | - | コンテナイメージのアップロード時に脆弱性を自動でスキャンするかどうか - `true` \| `false` |
| `status` | String | - | レジストリとストレージの連携状態 - `running` \| `disconnected` - `running`: 正常な状態 - `disconnected`: バケットが削除される |
| `storage_type` | String | - | レジストリと連携されているストレージタイプ |

### レスポンスステータスコード

Container Registry APIで共通して使用されるレスポンスステータスコードの詳細は、[Container Registryのレスポンスステータスコード](/docs/ja/compute-containerregistry#%EC%9D%91%EB%8B%B5%EC%83%81%ED%83%9C%EC%BD%94%EB%93%9C)をご参照ください。

### レスポンス例

レスポンスのサンプルコードは次の通りです。

```
{
    "count": 1,
    "next": null,
    "previous": null,
    "results": [
        {
            "bucket": "ncpdocker",
            "created": 1711695272000,
            "end_point": "ncpdocker.kr.ncr.ntruss.com",
            "end_point_enabled": true,
            "name": "ncpdocker",
            "private_end_point": "pdxxxnzd.kr.private-ncr.ntruss.com",
            "private_id": "pdxxxnzd",
            "public_reg_status": false,
            "scan_on_push_enabled": false,
            "status": "running",
            "storage_type": "objectStorage"
        }
    ]
}
```