---
title: "Domain 생성"
slug: "analytics-cloudsearch-createdomain"
updated: 2026-09-17T09:16:01Z
published: 2026-09-17T09:16:01Z
canonical: "api.ncloud-docs.com/analytics-cloudsearch-createdomain"
---

> ## 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 생성

도메인을 생성합니다
[자동 완성 설정 및 수정](/docs/analytics-cloudsearch-putautocomplete)은 도메인 생성 이 후 가능합니다.
색인(index)은 도메인 생성 이 후 추가는 가능하지만, 생성 후 삭제는 불가능합니다.<br />

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

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

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


|    필드명    | 필수 여부 | 타입    | 제약 사항                                                                | 설명                             |
|------------|-----------|---------|--------------------------------------------------------------------------|----------------------------------|
|     name     | Yes       | string  | 영문, "\_"로 시작, 영문, 숫자, "_", "-" 허용 최소 3자 최대 20자까지 입력 | 생성할 Domain 이름               |
|     type     | Yes       | string  | small, medium, large, xlarge, xxlarge, xxxlarge 중 하나를 선택(Default:small)| 컨테이너 규모 설정 <li>small: Standard - 4: 메모리 4GB / 스토리지 30GB / 권장 최대 문서수 100만 개 / 권장 색인 2개 </li><li>medium: Standard - 8: 메모리 8GB / 스토리지 50GB / 권장 최대 문서수 200만 개 / 권장 색인 3개</li><li>large: Standard - 16: 메모리 16GB / 스토리지 100GB / 권장 최대 문서수 400만 개 / 권장 색인 4개</li><li>xlarge: Standard - 32: 메모리 32GB / 스토리지 200GB / 권장 최대 문서수 800만 개 / 권장 색인 5개</li><li>xxlarge: High Memory - 64: 메모리 64GB / 스토리지 400GB / 권장 최대 문서수 1600만 개 / 권장 색인 6개</li><li>xxxlarge: High Memory - 128: 메모리 128GB / 스토리지 800GB / 권장 최대 문서수 3200만 개 / 권장 색인 7개</li>|
| indexerCount | Yes       | number | 현재는 1만 설정 가능 | 색인을 담당하는 컨테이너의 개수|
| searcherCount | Yes       | number | Min:1, Max:4 | 검색을 담당하는 컨테이너의 개수|
| description  | Yes        | string  | 0 ~ 100자까지 입력  | 생성할 도메인에 대한 설명        |
| schema.document | Yes | [Schema](/docs/common-apidatatype-csschema) | 유효한 Schema([Schema 검증](/docs/analytics-cloudsearch-checkschemavalidator)을 통해 확인 가능) | 생성할 도메인의 검색 설정 |



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


### 응답 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
POST /CloudSearch/real/v1/domain HTTP/1.1
Host: cloudsearch.apigw.ntruss.com
Content-Type: application/json
x-ncp-apigw-signature-v2: vuJdaypGE9ivNY3v/dRU/D96/HGmqgX1081UAjlOqbw=
x-ncp-apigw-timestamp: 1545800662952
x-ncp-iam-access-key: teGTwtcSEGA7fu28BGGi

{
  "name": "car_dev",
  "description": "",
  "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": [
        {
          "name": "brand_name",
          "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"
            }
          ]
        }
      ]
    }
  }
}
```

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


```json
{"result":"ok"}
```