CAT PIT 세그먼트 API

CAT PIT 세그먼트 API (CAT Pit Segments API)

2.4 버전에서 도입되었어요. CAT Point in Time(PIT) 세그먼트 작업은 Lucene 세그먼트를 설명해서 PIT의 디스크 사용량에 대한 저수준 정보를 제공해요. PIT Segments API는 특정 PIT를 ID로 지정하거나 모든 PIT의 세그먼트 정보를 한 번에 나열하는 것을 지원해요.

출처: 문서

본문

엔드포인트 (Endpoints)

GET /_cat/pit_segments

GET /_cat/pit_segments/_all

쿼리 파라미터 (Query parameters)

아래 표는 사용 가능한 쿼리 파라미터를 정리한 거예요. 모든 쿼리 파라미터는 선택 사항이에요.

파라미터	데이터 타입	설명	기본값
`bytes`	String	바이트 값을 표시하는 데 사용하는 단위. 유효한 값은 `b`, `kb`, `k`, `mb`, `m`, `gb`, `g`, `tb`, `t`, `pb`, `p`예요.	N/A
`format`	String	`json` 또는 `yaml` 같은 Accept 헤더의 짧은 버전.	N/A
`h`	List	표시할 열 이름의 쉼표로 구분된 목록.	N/A
`help`	Boolean	도움말 정보를 반환해요.	false
`s`	List	정렬 기준이 될 열 이름 또는 열 별칭의 쉼표로 구분된 목록.	N/A
`v`	Boolean	열 머리글을 표시하는 자세한(verbose) 모드를 활성화해요.	false

요청 본문 필드 (Request body fields)

필드	데이터 타입	설명
`pit_id`	Base64로 인코딩된 바이너리 또는 바이너리 배열	세그먼트를 나열할 PIT의 PIT ID들. 필수.

예제 요청: 모든 PIT의 PIT 세그먼트 (PIT segments for all PITs)

GET /_cat/pit_segments/_all

세그먼트가 없다면(저장된 데이터가 없다면) API는 어떤 정보도 반환하지 않아요.

예제 요청: ID로 PIT의 세그먼트 조회 (PIT segments for PITs by ID)

하나 또는 여러 PIT의 세그먼트를 나열하려면 요청 본문에 PIT ID를 지정하세요:

GET /_cat/pit_segments
{
  "pit_id": [
    "o463QQEPbXktaW5kZXgtMDAwMDAxFkhGN09fMVlPUkVPLXh6MUExZ1hpaEEAFjBGbmVEZHdGU1EtaFhhUFc4ZkR5cWcAAAAAAAAAAAEWaXBPNVJtZEhTZDZXTWFFR05waXdWZwEWSEY3T18xWU9SRU8teHoxQTFnWGloQQAA",
    "o463QQEPbXktaW5kZXgtMDAwMDAxFkhGN09fMVlPUkVPLXh6MUExZ1hpaEEAFjBGbmVEZHdGU1EtaFhhUFc4ZkR5cWcAAAAAAAAAAAIWaXBPNVJtZEhTZDZXTWFFR05waXdWZwEWSEY3T18xWU9SRU8teHoxQTFnWGloQQAA"
  ]
}

예제 응답 (Example response)

index  shard prirep ip            segment generation docs.count docs.deleted  size size.memory committed searchable version compound
index1 0     r      10.212.36.190 _0               0          4            0 3.8kb        1364 false     true       8.8.2   true
index1 1     p      10.212.36.190 _0               0          3            0 3.7kb        1364 false     true       8.8.2   true
index1 2     r      10.212.74.139 _0               0          2            0 3.6kb        1364 false     true       8.8.2   true