도메인을 생성합니다.
자동 완성 설정 및 수정은 도메인 생성 이 후 가능합니다.
색인(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 |
유효한 Schema(Schema 검증을 통해 확인 가능) |
생성할 도메인의 검색 설정 |
응답
응답 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"}