---
title: "Containerリスト照会"
slug: "analytics-cloudsearch-getcontainerlist"
updated: 2026-09-17T09:57:29Z
published: 2026-09-17T09:57:29Z
canonical: "api.ncloud-docs.com/analytics-cloudsearch-getcontainerlist"
---

> ## 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リスト照会

該当Domainのコンテナリストを照会します。

```
GET https://cloudsearch.apigw.ntruss.com/CloudSearch/real/v1/domain/{name}/container
```

## リクエスト

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

| パラメータ名 | 必須 | タイプ | 制約事項 | 説明 |
| --- | --- | --- | --- | --- |
| name | Yes | string |  | 作成されているDomain名 |

## レスポンス

| フィールド名 | タイプ | 説明 | 備考 |
| --- | --- | --- | --- |
| type | string | indexer, searcher | コンテナ種類 |
| containerStatus | number | created, warmup, running, clous_exiting, failed, unknown | コンテナのステータスcreated: 只今、コンテナが作成されたステータスwarmup: コンテナが実行されてデーモン実行及び検索ボリュームをメモリに積載しているステータスrunning: コンテナが正常的に動作中であるステータスclous_exitingコンテナの終了作業が進行中であるステータスfailed: コンテナの起動や終了作業が失敗された時に設定されるステータスunknown: checkerがコンテナステータスを確認してないステータス |
| memoryUsageBytes | number |  | コンテナのメモリ使用量(バイト単位) |

### レスポンスStatus

| HTTP Status | Desc |
| --- | --- |
| 200 | OK(照会完了) |
| 400 | Bad Request |
| 401 | Unauthorized |
| 401 | there is no such service |
| 403 | Forbidden |
| 404 | Not Found |
| 500 | Internal Server Error |

## 例示

### リクエスト例示

```
GET /CloudSearch/real/v1/domain/car_beta/container HTTP/1.1
Host:cloudsearch.apigw.ntruss.com
accept:application/json
x-ncp-apigw-signature-v2: tmD1qimgMww+v6rxPp8sWYuNjyAx5BHTDfx3D7cFGT0=
x-ncp-apigw-timestamp: 1551459012579
x-ncp-iam-access-key: teGTwtcSEGA7fu28BGGi
```

### レスポンス例示

```
[
  {
    "type": "indexer",
    "containerStatus": "running",
    "memoryUsageByte": 300716032
  },
  {
    "type": "searcher",
    "containerStatus": "running",
    "memoryUsageByte": 258715648
  }
]
```