인덱스 열기 API
인덱스 열기 API (Open Index API)
1.0부터 도입되었어요.
인덱스 열기(open index) API 작업은 닫힌 인덱스를 열어서 그 인덱스에 데이터를 추가하거나 검색할 수 있게 해 줘요.
출처: 문서
본문
엔드포인트
POST /{index}/_open
경로 파라미터
| 파라미터 | 타입 | 설명 |
|---|---|---|
<index> |
String | 열 인덱스예요. 여러 인덱스 이름을 쉼표로 구분한 목록일 수 있어요. 모든 인덱스를 열려면 _all 또는 *을 사용해요. |
쿼리 파라미터
모든 파라미터는 선택사항이에요.
| 파라미터 | 타입 | 설명 |
|---|---|---|
allow_no_indices |
Boolean | 어떤 인덱스와도 일치하지 않는 와일드카드를 무시할지 여부예요. 기본값은 true예요. |
expand_wildcards |
String | 와일드카드 표현식을 다양한 인덱스로 확장해요. 여러 값을 쉼표로 결합해요. 사용 가능한 값은 all(모든 인덱스 매치), open(열린 인덱스 매치), closed(닫힌 인덱스 매치), hidden(숨은 인덱스 매치), none(와일드카드 표현식을 받지 않음)이에요. 기본값은 open이에요. |
ignore_unavailable |
Boolean | true이면 OpenSearch가 누락되거나 닫힌 인덱스를 검색하지 않아요. 기본값은 false예요. |
wait_for_active_shards |
String | OpenSearch가 요청을 처리하기 전에 사용할 수 있어야 하는 활성 샤드 수를 지정해요. 기본값은 1(프라이머리 샤드만)이에요. all 또는 양의 정수로 설정해요. 1보다 큰 값은 복제본이 필요해요. 예를 들어 값을 3으로 지정하면 요청이 성공하려면 인덱스에 두 개의 추가 노드에 분산된 복제본 두 개가 있어야 해요. |
cluster_manager_timeout |
Time | 클러스터 매니저 노드에 연결될 때까지 기다리는 시간이에요. 기본값은 30s예요. |
timeout |
Time | 클러스터로부터 응답을 기다리는 시간이에요. 기본값은 30s예요. |
wait_for_completion |
Boolean | false로 설정하면 작업이 끝난 후가 아니라 즉시 요청이 반환돼요. 작업 상태를 모니터링하려면 요청이 반환한 작업 ID와 함께 Tasks API를 사용해요. 기본값은 true예요. |
task_execution_timeout |
Time | 명시적인 작업 실행 시간 초과예요. wait_for_completion이 false로 설정된 경우에만 유용해요. 기본값은 1h예요. |
요청 예시
POST /sample-index/_open
응답 예시
{
"acknowledged": true,
"shards_acknowledged": true
}
필요한 권한
보안 플러그인을 사용한다면 다음 권한이 필요해요: indices:admin/open.