스케일 API
스케일 API (Scale API)
3.0부터 도입되었어요.
스케일(Scale) API는 인덱스의 search_only 모드를 켜거나 끌 수 있게 해 줘요. 인덱스가 search_only 모드일 때는 검색 복제본만 유지하고 프라이머리와 일반 복제본 샤드를 축소해요. 이 최적화는 쓰기 활동이 적은 기간 동안 리소스 소비를 줄이면서 검색 기능은 유지해 줘요.
이 기능은 스케일-투-제로(scale-to-zero) 배포와 리더/라이터 분리(reader/writer separation) 패턴 같은 시나리오를 지원하며, 프로덕션 환경에서 리소스 활용도를 크게 개선하고 비용을 줄일 수 있어요.
보안 플러그인을 사용한다면 manage index 권한이 있어야 해요.
출처: 문서
본문
엔드포인트
POST /{index}/_scale
경로 파라미터
사용할 수 있는 경로 파라미터는 아래 표와 같아요.
| 파라미터 | 필수 | 데이터 타입 | 설명 |
|---|---|---|---|
index |
필수 | String | 스케일할 인덱스의 이름이에요. 와일드카드를 지원하지 않아요. |
요청 본문 필드
사용할 수 있는 요청 본문 필드는 아래 표와 같아요.
| 필드 | 필수 | 데이터 타입 | 설명 |
|---|---|---|---|
search_only |
필수 | Boolean | true이면 인덱스에서 검색 전용 모드를 켜요. false이면 검색 전용 모드를 끄고 인덱스를 정상 작업으로 복원해요. |
요청 예시: 검색 전용 모드 켜기
다음 요청은 my-index라는 인덱스의 검색 전용 모드를 켜요:
POST /my-index/_scale
{
"search_only": true
}
요청 예시: 검색 전용 모드 끄기
다음 요청은 검색 전용 모드를 끄고 인덱스를 정상 작업으로 되돌려요:
POST /my-index/_scale
{
"search_only": false
}
응답 예시
API는 다음 응답을 반환해요:
{
"acknowledged": true
}