인덱스 존재 확인 API
인덱스 존재 확인 API (Index Exists API)
1.0에서 도입되었어요. index exists API 작업은 인덱스가 이미 존재하는지 여부를 반환해요.
출처: 문서
본문
엔드포인트 (Endpoints)
HEAD /{index-name}
쿼리 파라미터 (Query parameters)
모든 파라미터는 선택 사항이에요.
| 파라미터 | 타입 | 설명 |
|---|---|---|
| allow_no_indices | Boolean | 어떤 인덱스와도 일치하지 않는 와일드카드를 무시할지 여부예요. 기본값은 true예요. |
| expand_wildcards | String | 와일드카드 표현을 서로 다른 인덱스로 확장해요. 여러 값을 쉼표로 조합할 수 있어요. 사용 가능한 값은 all(모든 인덱스 일치), open(열린 인덱스 일치), closed(닫힌 인덱스 일치), hidden(숨겨진 인덱스 일치), none(와일드카드 표현 허용 안 함)이에요. 기본값은 open이에요. |
| flat_settings | Boolean | 설정을 평면(flat) 형태로 반환할지 여부예요. 특히 깊게 중첩된 설정을 읽을 때 가독성이 좋아져요. 예를 들어 index.creation_date 같은 설정은 indexcreation_date123456789처럼 평면 형태가 돼요. |
| include_defaults | Boolean | 응답에 기본 설정을 포함할지 여부예요. 이 파라미터는 업데이트하려는 설정의 이름과 현재 값을 확인할 때 유용해요. |
| ignore_unavailable | Boolean | true이면 OpenSearch가 없거나 닫힌 인덱스를 찾지 않아요. 기본값은 false예요. |
| local | Boolean | 클러스터 매니저 노드 대신 로컬 노드에서만 정보를 반환할지 여부예요. 기본값은 false예요. |
예제 요청 (Example request)
예제 응답 (Example response)
index exists API 작업은 두 가지 응답 코드 중 하나만 반환해요. 200은 인덱스가 존재한다는 뜻이고, 404는 인덱스가 존재하지 않는다는 뜻이에요.
필요한 권한 (Required permissions)
Security plugin을 사용한다면 indices:admin/exists 권한이 있는지 확인하세요.