데이터 스트림 생성 API

데이터 스트림 생성 API (Create Data Stream API)

로그 데이터를 시간 순으로 관리하고 싶을 때 데이터 스트림을 만들어 두면 편리해요. 데이터 스트림 생성 API로 데이터 스트림을 만들 수 있어요. 스트림을 만들기 전에, 먼저 인덱스 집합을 데이터 스트림으로 구성하는 인덱스 템플릿을 만들어야 한다는 점 기억해 두세요.

출처: 문서

1.0에서 도입

데이터 스트림 생성 API는 데이터 스트림을 만들어요. 데이터 스트림을 생성하기 전에 인덱스 집합을 데이터 스트림으로 구성하는 인덱스 템플릿을 먼저 만들어야 해요. 자세한 내용은 Index data streams를 참고하세요.

PUT /_data_stream/{name}

다음 표는 사용 가능한 경로 파라미터예요.

Parameter	Required	Data type	Description
name	Required	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 데이터 스트림을 만들어요.

PUT /_data_stream/logs-app
{}

{
  "acknowledged": true
}

Security 플러그인을 사용한다면 적절한 권한이 있는지 확인해야 해요: indices:admin/data_stream/create.