---
title: "Schema 이력 조회"
slug: "analytics-cloudsearch-getschemahistory"
updated: 2026-07-23T09:04:32Z
published: 2026-07-23T09:04:32Z
canonical: "api.ncloud-docs.com/analytics-cloudsearch-getschemahistory"
---

> ## 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)의 이력을 조회합니다. 해당 요청을 수행하기 이전에 [Domain 생성](/docs/analytics-cloudsearch-createdomain)이 되어져 있어야 합니다. Schema 변경 이력이 있을 때에만 데이터가 출력됩니다.

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

## 요청

### 요청 파라미터

| 파라미터명 | 필수 여부 | 타입 | 제약 사항 | 설명 |
| --- | --- | --- | --- | --- |
| name | Yes | string | 생성되어져 있는 Domain 이름 | Schema 이력을 조회하고자 하는 Domain 이름 |
| limit | Yes | number | Min:1 MAX:30 | Pagination Limit |
| offset | Yes | number |  | Pagination Offset |
| order | Yes | string | DESC, ASC | 결과 정렬 기준 |

## 응답

### 응답 바디

| 필드명 | 필수 여부 | 타입 | 설명 | 비고 |
| --- | --- | --- | --- | --- |
| toBeSchema.document | No | [Schema](/docs/common-apidatatype-csschema) | 변경된 Schema |  |
| asIsSchema.document | No | [Schema](/docs/common-apidatatype-csschema) | 변경 전 Schema |  |
| createdDate | No | string | Schema 변경 시간 |  |

### 응답 Status

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

## 예시

### 요청 예시

```
GET /CloudSearch/real/v1/domain/car_beta/schema/history?limit=10&offset=0&order=DESC HTTP/1.1
GET /CloudSearch/real/v1/domain/car_dev/schema HTTP/1.1
Host: cloudsearch.apigw.ntruss.com

x-ncp-apigw-signature-v2: cDwtHuQeGmwWyNmwlN6XIGA66zge4iMXvfoDQNna05g=
x-ncp-apigw-timestamp: 1545817618751
x-ncp-iam-access-key: teGTwtcSEGA7fu28BGGi
```

### 응답 예시

```
[
  {
    "toBeSchema": {
      "document": {
        "autocomplete": {
          "indexName": "brand_name",
          "sectionName": "name"
        },
        "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"
          },
          {
            "name": "color",
            "documentTermWeight": "sum_wgt",
            "buildInfos": [
              {
                "name": "index_build_color",
                "sections": [
                  "color"
                ],
                "sectionTermWeight": "1.0 * stw_2p(tf, 0.5, 0.25, 0., length / 128.0)",
                "indexProcessors": [
                  {
                    "type": "hanaterm",
                    "method": "sgmt",
                    "option": "+korea +josacat +eomicat"
                  }
                ]
              }
            ]
          }
        ]
      }
    },
    "asIsSchema": {
      "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"
              }S
            ]
          }
        ]
      }
    },
    "createdDate": "2019-03-04T06:39:56.072Z"
  }
]
```