매달린 인덱스 API
매달린 인덱스 API (Dangling Indexes API)
1.0에서 도입되었어요. 노드가 클러스터에 합류한 후, 노드의 로컬 디렉터리에 클러스터에 아직 존재하지 않는 샤드가 있다면 매달린 인덱스(dangling index)가 생겨요. 매달린 인덱스는 목록 조회, 삭제, 가져오기(import)를 할 수 있어요.
출처: 문서
본문
엔드포인트 (Endpoints)
매달린 인덱스 목록 조회:
GET /_dangling
매달린 인덱스 가져오기:
POST /_dangling/{index-uuid}
매달린 인덱스 삭제:
DELETE /_dangling/{index-uuid}
경로 파라미터 (Path parameters)
경로 파라미터는 필수예요.
| 경로 파라미터 | 설명 |
|---|---|
| index-uuid | 인덱스의 UUID예요. |
쿼리 파라미터 (Query parameters)
쿼리 파라미터는 선택 사항이에요.
| 쿼리 파라미터 | 데이터 타입 | 설명 |
|---|---|---|
| accept_data_loss | Boolean | 가져오기나 삭제를 할 때 반드시 true로 설정해야 해요. OpenSearch는 매달린 인덱스 데이터가 어디에서 왔는지 알 수 없기 때문이에요. |
| timeout | Time units | 응답을 기다리는 시간이에요. 정해진 시간 안에 응답이 없으면 오류가 반환돼요. 기본값은 30초예요. |
| cluster_manager_timeout | Time units | 클러스터 매니저에 연결하기 위해 기다리는 시간이에요. 정해진 시간 안에 응답이 없으면 오류가 반환돼요. 기본값은 30초예요. |
예제 요청: 매달린 인덱스 목록 조회
예제 요청: 매달린 인덱스 가져오기
예제 요청: 매달린 인덱스 삭제
예제 응답 (Example response)
{
"_nodes": {
"total": 1,
"successful": 1,
"failed": 0
},
"cluster_name": "opensearch-cluster",
"dangling_indices": [msdjernajxAT23RT-BupMB]
}