---
title: "Domain 목록 조회"
slug: "analytics-cloudsearch-getdomainlist"
tags: ["Cloud Search"]
updated: 2026-04-23T08:56:08Z
published: 2026-04-23T09:02:28Z
---

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

# Domain 목록 조회

전체 도메인 목록을 조회합니다.

```http
GET https://cloudsearch.apigw.ntruss.com/CloudSearch/real/v1/domain
```

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

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

| 파라미터명 | 필수 여부 | 타입   | 제약 사항 | 설명                                   |
|-------------|-----------|--------|----------|----------------------------------------|
| haveContainer      | Yes       | boolean |          | 컨테이너 정보 조회 여부 |
| haveUsage      | Yes       | boolean |          | 도메인 사용량 정보 조회 여부 |

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


| 필드명  | 필수 여부 | 타입            | 설명                  | 비고           |
|--------|--------|-----------------|-----------------------|----------------|
| [].autoCompleteChangeable | Yes | string      |  자동 완성 색인 변경 가능 여부 | ENABLE, DISABLE |
| [].autocompleteSchema | Yes | [AutoCompleteSchema](/docs/common-apidatatype-csautocompleteschema) |  자동 완성 설정  | |
| [].containerChangeable | Yes | string          | 검색용 컨테이너 변경 가능 여부  | ENABLE, DISABLE |
| [].containers | Yes | List<[Container](/docs/common-apidatatype-cscontainer)> |  컨테이너 정보    | |
| [].createdDate   | Yes| string    | 도메인 생성 시간   |
| [].description | Yes | string          | 도메인 설명           | |
| [].domainStatus | Yes | string          | 서비스 상태           | |
| [].domainUsage | Yes | [DomanUsage](/docs/common-apidatatype-csdomainusage)   |  도메인 사용량  | |
| [].indexerCount | Yes | number          | 색인용 컨테이너 수    | |
| [].name | Yes | string          |  도메인 이름           | |
| [].schema.document | Yes | [Schema](/docs/common-apidatatype-csschema) |  | 검색 설정 |
| [].schemaChangeable | Yes | string          | 스키마 수정 가능 여부 | ENABLE, DISABLE |
| [].searcherCount | Yes | number          | 검색용 컨테이너 수 | |
| [].type  | Yes | string  |  컨테이너 타입 | small, medium, large, xlarge, xxlarge, xxxlarge |
| [].updatedDate   | Yes | string    | 최종 업데이트 시간   |


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

|HTTP Status | Desc |
|-------- | ---------------------------- |
|200| OK(조회 완료) |
|400|  Bad Request |
| 401    | Unauthorized                                                   |
|403 | Forbidden                                          |                                                              |
|404 | Not Found                                       |                                                              |
| 500 | Internal Server Error                                                 |                                                              |

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


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


```HTTP
GET /CloudSearch/real/v1/domain

Host: cloudsearch.apigw.ntruss.com
haveContainer: false
haveUsage: false
x-ncp-iam-access-key: cPMl0CYGgRYvEa8sylCj
x-ncp-apigw-signature-v2: nn6HxvbYlXzuDBLYG8qNdz4Z7Y6qs+l5EX8BmGwI/EI=
x-ncp-apigw-timestamp: 1551436817715
```

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


```json
[
  {
    "name": "my_service",
    "description": "description",
    "domainStatus": "RUNNING",
    "containerChangeable": "ENABLE",
    "schemaChangeable": "ENABLE",
    "autoCompleteChangeable": "ENABLE",
    "type": "small",
    "indexerCount": 1,
    "searcherCount": 1,
    "schema": {
      "document": {
        "primarySectionName": "docid",
        "sections": [
          {
            "name": "docid"
          },
          {
            "name": "brand"
          },
          {
            "name": "name"
          },
          {
            "docProperties": [
              {
                "type": "string",
                "name": "dp_color"
              }
            ],
            "name": "color"
          },
          {
            "docProperties": [
              {
                "type": "uint32",
                "name": "dp_price"
              }
            ],
            "name": "price"
          },
          {
            "docProperties": [
              {
                "type": "string",
                "name": "dp_type"
              }
            ],
            "name": "type"
          },
          {
            "docProperties": [
              {
                "type": "uint32",
                "name": "dp_sell_cnt"
              }
            ],
            "name": "sell_cnt"
          },
          {
            "name": "image_url"
          }
        ],
        "indexes": [
          {
            "documentTermWeight": "sum_wgt",
            "buildInfos": [
              {
                "indexProcessors": [
                  {
                    "type": "hanaterm",
                    "method": "sgmt",
                    "option": "+korea +josacat +eomicat"
                  }
                ],
                "sectionTermWeight": "1.0 * stw_2p(tf, 0.5, 0.25, 0., length / 128.0)",
                "sections": [
                  "brand",
                  "name"
                ],
                "name": "index_build"
              }
            ],
            "name": "brand_name"
          }
        ]
      }
    },
    "autocompleteSchema": null,
    "createdDate": "2019-02-28T10:28:33.795Z",
    "updatedDate": "2019-02-28T10:28:39.000Z"
  }
]
```