템플릿 조회

템플릿 조회 (Get template)

1.0부터 도입되었어요.

Get Template API는 더 이상 권장되지 않아요(deprecated). 새 Get Index Template API를 사용해 주세요.

get template API 작업은 레거시 /_template 엔드포인트로 생성된 하나 이상의 인덱스 템플릿을 가져오는 데 사용돼요.

출처: 문서

본문

엔드포인트

GET /_template
GET /_template/{template-name}

경로 파라미터

사용할 수 있는 경로 파라미터는 아래 표와 같아요. 모든 파라미터는 선택사항이에요.

파라미터 타입 설명
template-name String 가져올 인덱스 템플릿의 이름이에요. 와일드카드 표현식을 지원해요.

쿼리 파라미터

사용할 수 있는 쿼리 파라미터는 아래 표와 같아요. 모든 파라미터는 선택사항이에요.

파라미터 타입 설명
flat_settings Boolean true이면 설정을 평평한 형식으로 반환해요. 기본값은 false예요.
local Boolean true이면 클러스터 매니저 노드에서 상태를 가져오지 않아요. 기본값은 false예요.
cluster_manager_timeout Time 클러스터 매니저 노드에 연결될 때까지 기다리는 시간을 지정해요. 기본값은 30s예요.

요청 예시

GET /_template/sample-template

응답 예시

{
  "sample-template": {
    "order": 1,
    "index_patterns": [
      "sample-*"
    ],
    "settings": {
      "number_of_shards": "1"
    },
    "mappings": {
      "properties": {
        "timestamp": {
          "type": "date"
        }
      }
    },
    "aliases": {}
  }
}

응답 필드

응답 객체에는 다음 필드가 있어요.

필드 타입 설명
order Integer 여러 템플릿이 인덱스와 일치할 때 템플릿의 우선순위를 정하는 정수예요. order 값이 클수록 우선순위가 높아 더 낮은 order의 템플릿보다 나중에 적용되므로, 충돌하는 설정이나 매핑을 덮어쓸 수 있어요.
index_patterns Array of strings 템플릿이 적용되는 인덱스 이름 패턴의 목록이에요.
settings Object 템플릿에 정의된 인덱스 수준 설정이에요.
mappings Object 패턴과 일치하는 인덱스에 대해 정의된 필드 매핑이에요.
aliases Object 일치하는 인덱스와 연결할 별칭이에요.

더 알아보기 (Learn more)