템플릿 등록
템플릿 등록 (Put template)
1.0부터 도입되었어요.
Put Template API는 더 이상 권장되지 않아요(deprecated). 새 Create or Update Index Template API를 사용해 주세요.
put template API 작업은 인덱스 템플릿을 생성하거나 갱신하는 데 사용돼요. 템플릿은 일치하는 인덱스가 생성될 때 자동으로 적용되는 설정, 매핑, 별칭을 정의해요.
출처: 문서
본문
엔드포인트
PUT /_template/{template-name}
경로 파라미터
모든 경로 파라미터는 필수예요.
| 파라미터 | 타입 | 설명 |
|---|---|---|
template-name |
String | 생성하거나 갱신할 인덱스 템플릿의 이름이에요. |
쿼리 파라미터
모든 쿼리 파라미터는 선택사항이에요.
| 파라미터 | 타입 | 설명 |
|---|---|---|
order |
Integer | 여러 템플릿이 일치할 때 템플릿을 적용하는 순서예요. 값이 클수록 나중에 적용돼요. 기본값은 0이에요. |
create |
Boolean | true이면 같은 이름의 템플릿이 이미 존재할 때 작업이 실패해요. 기본값은 false예요. |
cluster_manager_timeout |
Time | 클러스터 매니저 노드에 연결될 때까지 기다리는 시간을 지정해요. 기본값은 30s예요. |
요청 본문
요청 본문은 다음 구성 요소 중 하나 이상을 정의해야 해요.
| 필드 | 타입 | 설명 |
|---|---|---|
index_patterns |
Array | 템플릿이 적용되는 인덱스 이름 패턴의 목록이에요. 필수예요. |
settings |
Object | 일치하는 인덱스에 적용할 인덱스 설정이에요. |
mappings |
Object | 인덱스 필드의 매핑이에요. |
aliases |
Object | 일치하는 인덱스에 할당할 별칭이에요. |
version |
Integer | 템플릿을 식별하는 데 사용하는 선택적 버전 번호예요. |
요청 예시
PUT /_template/logs_template
{
"index_patterns": [
"logs-*"
],
"settings": {
"number_of_shards": 1
},
"mappings": {
"properties": {
"@timestamp": {
"type": "date"
},
"message": {
"type": "text"
}
}
},
"aliases": {
"logs": {}
}
}
응답 예시
{
"acknowledged": true
}