데이터 스트림 삭제 API
데이터 스트림 삭제 API (Delete Data Stream API)
더 이상 필요 없는 데이터 스트림을 정리하고 싶으시죠? 데이터 스트림 삭제 API가 데이터 스트림과 그 백킹 인덱스를 함께 삭제해요. 데이터 스트림을 통째로 없애야 할 때 사용해요.
출처: 문서
본문
1.0에서 도입
데이터 스트림 삭제 API는 데이터 스트림과 그 백킹 인덱스를 삭제해요.
엔드포인트
DELETE /_data_stream/{name}
경로 파라미터
다음 표는 사용 가능한 경로 파라미터예요.
| Parameter | Required | Data type | Description |
|---|---|---|---|
| name | Required | List or String | 삭제할 데이터 스트림의 쉼표로 구분된 목록이에요. 와일드카드(*) 표현식을 지원해요. |
쿼리 파라미터
다음 표는 사용 가능한 쿼리 파라미터예요. 모든 쿼리 파라미터는 선택적이에요.
| Parameter | Data type | Description | Default |
|---|---|---|---|
| error_trace | Boolean | 반환된 오류의 스택 트레이스를 포함할지 여부예요. | false |
| filter_path | List or String | 응답을 줄이는 데 사용돼요. 이 파라미터는 쉼표로 구분된 필터 목록을 받아요. 와일드카드로 필드나 필드 이름의 일부를 매칭할 수 있어요. -로 필드를 제외할 수도 있어요. |
N/A |
| human | Boolean | 통계에 대해 사람이 읽을 수 있는 값을 반환할지 여부예요. | false |
| pretty | Boolean | 반환된 JSON 응답을 pretty 형식으로 할지 여부예요. | false |
| source | String | URL 인코딩된 요청 정의예요. POST가 아닌 요청에 요청 본문을 받아들이지 않는 라이브러리에 유용해요. | N/A |
예시 요청
다음 예시 요청은 logs-app 데이터 스트림과 그 백킹 인덱스를 삭제해요.
DELETE /_data_stream/logs-app
예시 응답
{
"acknowledged": true
}
보안
Security 플러그인을 사용한다면 적절한 권한이 있는지 확인해야 해요: indices:admin/data_stream/delete.
관련 문서
- Data streams
- Create or update a data stream
더 알아보기 (Learn more)
- 삭제는 백킹 인덱스까지 포함하므로 되돌릴 수 없어요. 신중하게 실행해야 해요.
- 데이터 스트림을 남기고 인덱스만 정리하고 싶다면 Modify Data Stream API를 참고하세요.