Link Search Menu Expand Document Documentation Menu
Documentation

CAT Pit Segments API

Introduced 2.4

The CAT Point in Time (PIT) segments operation provides low-level information about the disk utilization of a PIT by describing its Lucene segments. The PIT Segments API supports listing segment information for a specific PIT by ID or for all PITs at once.

Endpoints

GET /_cat/pit_segments 
GET /_cat/pit_segments/_all

Query parameters

The following table lists the available query parameters. All query parameters are optional.

Parameter Data type Description Default
bytes String The units used to display byte values.
Valid values are: b, kb, k, mb, m, gb, g, tb, t, pb, and p.		 N/A
format String A short version of the Accept header, such as json or yaml. N/A
h List A comma-separated list of column names to display. N/A
help Boolean Returns help information. false
s List A comma-separated list of column names or column aliases to sort by. N/A
v Boolean Enables verbose mode, which displays column headers. false

Request body fields

Field Data type Description
pit_id Base64-encoded binary or an array of binaries The PIT IDs of the PITs whose segments are to be listed. Required.

Example request: PIT segments for all PITs

GET /_cat/pit_segments/_all
response = client.cat.all_pit_segments()

If there are no segments (there is no data stored), the API does not return any information.

Example request: PIT segments for PITs by ID

To list segments for one or several PITs, specify their PIT IDs in the request body:

GET /_cat/pit_segments { "pit_id": [ "o463QQEPbXktaW5kZXgtMDAwMDAxFkhGN09fMVlPUkVPLXh6MUExZ1hpaEEAFjBGbmVEZHdGU1EtaFhhUFc4ZkR5cWcAAAAAAAAAAAEWaXBPNVJtZEhTZDZXTWFFR05waXdWZwEWSEY3T18xWU9SRU8teHoxQTFnWGloQQAA", "o463QQEPbXktaW5kZXgtMDAwMDAxFkhGN09fMVlPUkVPLXh6MUExZ1hpaEEAFjBGbmVEZHdGU1EtaFhhUFc4ZkR5cWcAAAAAAAAAAAIWaXBPNVJtZEhTZDZXTWFFR05waXdWZwEWSEY3T18xWU9SRU8teHoxQTFnWGloQQAA" ] }
response = client.cat.pit_segments( body = { "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
350 characters left

Have a question? .

Want to contribute? or .