---
title: "Schema 수정 "
slug: "analytics-cloudsearch-changeschema"
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.

# Schema 수정 

Schema 변경 시, 색인은 추가만 가능합니다.

```http
PUT https://cloudsearch.apigw.ntruss.com/CloudSearch/real/v1/domain/{name}/schema
```

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

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

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

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

|    필드명    | 필수 여부 | 타입    | 제약 사항                                                                | 설명                             |
|------------|-----------|---------|--------------------------------------------------------------------------|----------------------------------|
| 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>


### 요청 예시 - 기존에 생성한 schema에 name과 phone_number 섹션을 모두 검색하는 student 색인을 추가<a name="요청예시기존에생성한schema에name과phonenumber섹션을모두검색하는student색인을추가"></a>

```http
PUT https://cloudsearch.apigw.ntruss.com/CloudSearch/real/v1/domain/student/schema

PUT /CloudSearch/real/v1/domain/student/schema HTTP/1.1
Host:cloudsearch.apigw.ntruss.com
Content-Type: application/json

x-ncp-apigw-signature-v2: NR8ES668xeqaO4M6gvDfmHmJZB9lVHs7p/qbytdW1BI=
x-ncp-apigw-timestamp: 1545973892478
x-ncp-iam-access-key: teGTwtcSEGA7fu28BGGi

{
  "document": {
    "primarySectionName": "name",
    "sections": [
      {
        "docProperties": [
          {
            "type": "string",
            "name": "dp_name"
          }
        ],
        "name": "name"
      },
      {
        "docProperties": [
          {
            "type": "string",
            "name": "dp_phone_number"
          }
        ],
        "name": "phone_number"
      }
    ],
    "indexes": [
      {
        "documentTermWeight": "sum_wgt",
        "buildInfos": [
          {
            "sections": [
              "name"
            ],
            "sectionTermWeight": "1.0 * stw_2p(tf, 0.5, 0.25, 0., length / 128.0)",
            "indexProcessors": [
              {
                "type": "hanaterm",
                "method": "sgmt",
                "option": "+korea +josacat +eomicat"
              }
            ],
            "name": "index_build_0"
          }
        ],
        "name": "name"
      },
 {
        "documentTermWeight": "sum_wgt",
        "buildInfos": [
          {
            "sections": [
              "name",
              "phone_number"
            ],
            "sectionTermWeight": "1.0 * stw_2p(tf, 0.5, 0.25, 0., length / 128.0)",
            "indexProcessors": [
              {
                "type": "hanaterm",
                "method": "sgmt",
                "option": "+korea +josacat +eomicat"
              }
            ],
            "name": "index_build_0"
          }
        ],
        "name": "student"
      }
    ]
  }
}
```

### 응답 예시 (공통)

```json
{
  "result": "OK"
}
```