---
title: "Container 목록 조회 "
slug: "analytics-cloudsearch-getcontainerlist"
updated: 2026-04-23T08:56:09Z
published: 2026-04-23T09:02:33Z
---

> ## 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 목록 조회 

해당 도메인의 컨테이너 목록을 조회합니다

```http
GET https://cloudsearch.apigw.ntruss.com/CloudSearch/real/v1/domain/{name}/container
```
## 요청<a name="요청"></a>

### 요청 파라미터<a name="요청파라미터"></a>

| 파라미터명 | 필수 여부 | 타입   | 제약 사항 | 설명                                   |
|-------------|-----------|--------|----------|----------------------------------------|
| name      | Yes       | string | | 생성되어져 있는 Domain 이름 |

## 응답<a name="응답"></a>


| 필드명                 | 타입            | 설명                  | 비고           |
|------------------------|-----------------|-----------------------|----------------|
| type   | string | indexer, searcher | 컨테이너 종류 |
| containerStatus | number | created, warmup, running, clous_exiting, failed, unknown |  컨테이너 상태<li>created: 이제 막 컨테이너가 생성된 상태</li><li>warmup: 컨테이너가 실행되어 데몬 구동 및 검색 볼륨을 메모리에 적재하고 있는 상태</li><li>running: 컨테이너가 정상적으로 동작 중인 상태</li><li>clous_exiting 컨테이너의 종료작업이 진행중인 상태</li><li>failed: 컨테이너의 기동이나, 종료작업이 실패되었을때 설정되는 상태</li><li>unknown: checker가 컨테이너 상태를 확인하지 못한 상태</li>|
| memoryUsageBytes | number | | 컨테이너의 메모리 사용량(바이트 단위) |


### 응답 Status<a name="응답Status"></a>

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

## 예시<a name="예시"></a>


### 요청 예시<a name="요청예시"></a>


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

### 응답 예시<a name="응답예시"></a>


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