---
title: "Domain 생성  "
slug: "analytics-cloudsearch-createdomain"
tags: ["Cloud Search"]
updated: 2026-10-22T10:46:51Z
published: 2026-10-22T10:46:51Z
canonical: "api-gov.ncloud-docs.com/analytics-cloudsearch-createdomain"
---

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

# Domain 생성  

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

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

## 요청

### 요청 바디

| 필드명 | 필수 여부 | 타입 | 제약사항 | 설명 |
| --- | --- | --- | --- | --- |
| name | Yes | string | 영문, "_"로 시작, 영문, 숫자, "_", "-" 허용 최소 3자 최대 20자까지 입력 | 생성할 Domain 이름 |
| type | Yes | string | small, medium, large, xlarge, xxlarge, xxxlarge 중 하나를 선택(Default:small) | 컨테이너 규모 설정 small: Standard - 4: 메모리 4GB / 스토리지 30GB / 권장 최대 문서수 100만 개 / 권장 색인 2개medium: Standard - 8: 메모리 8GB / 스토리지 50GB / 권장 최대 문서수 200만 개 / 권장 색인 3개large: Standard - 16: 메모리 16GB / 스토리지 100GB / 권장 최대 문서수 400만 개 / 권장 색인 4개xlarge: Standard - 32: 메모리 32GB / 스토리지 200GB / 권장 최대 문서수 800만 개 / 권장 색인 5개xxlarge: High Memory - 64: 메모리 64GB / 스토리지 400GB / 권장 최대 문서수 1600만 개 / 권장 색인 6개xxxlarge: High Memory - 128: 메모리 128GB / 스토리지 800GB / 권장 최대 문서수 3200만 개 / 권장 색인 7개 |
| 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)을 통해 확인 가능) | 생성할 도메인의 검색 설정 |

## 응답

### 응답 Status

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

## 예시

### 요청 예시

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

{
  "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"
            }
          ]
        }
      ]
    }
  }
}
```

### 응답 예시

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