---
title: "Container 목록 조회"
slug: "analytics-cloudsearch-getcontainerlist"
tags: ["Cloud Search"]
updated: 2026-10-22T10:46:51Z
published: 2026-10-22T10:46:51Z
canonical: "api-gov.ncloud-docs.com/analytics-cloudsearch-getcontainerlist"
---

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

# Container 목록 조회

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

```
GET https://cloudsearch.apigw.gov-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 https://cloudsearch.apigw.gov-ntruss.com/CloudSearch/real/v1/domain/car_beta/container
```

### 응답 예시

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