Domain 생성

Prev Next

도메인을 생성합니다.
자동 완성 설정 및 수정은 도메인 생성 이 후 가능합니다.
색인(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"}