---
title: "Schema 조회"
slug: "analytics-cloudsearch-getschema"
tags: ["Cloud Search"]
updated: 2026-10-22T10:46:51Z
published: 2026-10-22T10:46:51Z
canonical: "api-gov.ncloud-docs.com/analytics-cloudsearch-getschema"
---

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

# Schema 조회

해당 도메인에 설정된 검색 설정(Schema)를 조회합니다. 해당 요청을 수행하기 이전에 [Domain 생성](/docs/analytics-cloudsearch-createdomain)이 되어져 있어야 합니다.

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

## 요청

### 요청 파라미터

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

## 응답

| 필드명 | 타입 | 설명 | 비고 |
| --- | --- | --- | --- |
| document | [Schema](/docs/common-apidatatype-csschema) | 검색 설정 |  |

### 응답 Status

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

## 예시

### 요청 예시

```
GET https://cloudsearch.apigw.gov-ntruss.com/CloudSearch/real/v1/domain/car_dev/schema
```

### 응답 예시

```
{
  "document": {
    "primarySectionName": "docid",
    "sections": [
      {
        "docProperties": [
          {
            "type": "string",
            "name": "dp_docid"
          }
        ],
        "name": "docid"
      },
      {
        "docProperties": [
          {
            "type": "string",
            "name": "dp_brand"
          }
        ],
        "name": "brand"
      },
      {
        "docProperties": [
          {
            "type": "string",
            "name": "dp_name"
          }
        ],
        "name": "name"
      },
      {
        "docProperties": [
          {
            "type": "string",
            "name": "dp_price"
          }
        ],
        "name": "price"
      },
      {
        "docProperties": [
          {
            "type": "float",
            "name": "dp_name2"
          }
        ],
        "name": "name2"
      }
    ],
    "indexes": [
      {
        "documentTermWeight": "sum_wgt",
        "buildInfos": [
          {
            "sections": [
              "brand"
            ],
            "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"
          },
          {
            "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_1"
          }
        ],
        "name": "brand_name"
      },
      {
        "documentTermWeight": "sum_wgt",
        "buildInfos": [
          {
            "sections": [
              "price"
            ],
            "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": "price"
      }
    ]
  }
}
```