2020-11-26 00:16:06 +08:00
|
|
|
[role="xpack"]
|
|
|
|
|
[testenv="basic"]
|
|
|
|
|
[[rollup-apis]]
|
|
|
|
|
== Rollup APIs
|
|
|
|
|
|
|
|
|
|
ifdef::permanently-unreleased-branch[]
|
|
|
|
|
|
|
|
|
|
A rollup aggregates an index's time-series data and stores the results in
|
2020-11-26 06:29:02 +08:00
|
|
|
another index. For example, you can roll up hourly data into daily or weekly
|
|
|
|
|
summaries.
|
2020-11-26 00:16:06 +08:00
|
|
|
|
|
|
|
|
* <<rollup-api,Rollup API>>
|
|
|
|
|
|
|
|
|
|
[discrete]
|
|
|
|
|
[[legacy-rollup-apis]]
|
|
|
|
|
=== Legacy rollup APIs
|
|
|
|
|
|
|
|
|
|
Prior to {es} 7.x, you could only create rollups using periodic cron jobs.
|
|
|
|
|
Special APIs were required to manage the jobs and search the resulting rollup
|
|
|
|
|
indices. These rollup APIs are now deprecated and will be removed in a future
|
|
|
|
|
release.
|
|
|
|
|
|
|
|
|
|
[discrete]
|
|
|
|
|
[[rollup-jobs-endpoint]]
|
|
|
|
|
==== Jobs
|
|
|
|
|
|
|
|
|
|
* <<rollup-put-job,Create>> or <<rollup-delete-job,delete {rollup-jobs}>>
|
|
|
|
|
* <<rollup-start-job,Start>> or <<rollup-stop-job,stop {rollup-jobs}>>
|
|
|
|
|
* <<rollup-get-job,Get {rollup-jobs}>>
|
|
|
|
|
|
|
|
|
|
[discrete]
|
|
|
|
|
[[rollup-data-endpoint]]
|
|
|
|
|
==== Data
|
|
|
|
|
|
|
|
|
|
* <<rollup-get-rollup-caps,Get rollup capabilities>>
|
|
|
|
|
* <<rollup-get-rollup-index-caps,Get rollup index capabilities>>
|
|
|
|
|
|
|
|
|
|
[discrete]
|
|
|
|
|
[[rollup-search-endpoint]]
|
|
|
|
|
==== Search
|
|
|
|
|
|
|
|
|
|
* <<rollup-search,Rollup search>>
|
|
|
|
|
|
|
|
|
|
include::apis/rollup-api.asciidoc[]
|
|
|
|
|
include::apis/put-job.asciidoc[]
|
|
|
|
|
include::apis/delete-job.asciidoc[]
|
|
|
|
|
include::apis/get-job.asciidoc[]
|
|
|
|
|
include::apis/rollup-caps.asciidoc[]
|
|
|
|
|
include::apis/rollup-index-caps.asciidoc[]
|
|
|
|
|
include::apis/rollup-search.asciidoc[]
|
|
|
|
|
include::apis/start-job.asciidoc[]
|
|
|
|
|
include::apis/stop-job.asciidoc[]
|
|
|
|
|
|
|
|
|
|
endif::[]
|
|
|
|
|
ifndef::permanently-unreleased-branch[]
|
|
|
|
|
|
|
|
|
|
[discrete]
|
|
|
|
|
[[rollup-jobs-endpoint]]
|
|
|
|
|
=== Jobs
|
|
|
|
|
|
|
|
|
|
* <<rollup-put-job,Create>> or <<rollup-delete-job,delete {rollup-jobs}>>
|
|
|
|
|
* <<rollup-start-job,Start>> or <<rollup-stop-job,stop {rollup-jobs}>>
|
|
|
|
|
* <<rollup-get-job,Get {rollup-jobs}>>
|
|
|
|
|
|
|
|
|
|
[discrete]
|
|
|
|
|
[[rollup-data-endpoint]]
|
|
|
|
|
=== Data
|
|
|
|
|
|
|
|
|
|
* <<rollup-get-rollup-caps,Get rollup capabilities>>
|
|
|
|
|
* <<rollup-get-rollup-index-caps,Get rollup index capabilities>>
|
|
|
|
|
|
|
|
|
|
[discrete]
|
|
|
|
|
[[rollup-search-endpoint]]
|
|
|
|
|
=== Search
|
|
|
|
|
|
|
|
|
|
* <<rollup-search,Rollup search>>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
include::apis/put-job.asciidoc[]
|
|
|
|
|
include::apis/delete-job.asciidoc[]
|
|
|
|
|
include::apis/get-job.asciidoc[]
|
|
|
|
|
include::apis/rollup-caps.asciidoc[]
|
|
|
|
|
include::apis/rollup-index-caps.asciidoc[]
|
|
|
|
|
include::apis/rollup-search.asciidoc[]
|
|
|
|
|
include::apis/start-job.asciidoc[]
|
|
|
|
|
include::apis/stop-job.asciidoc[]
|
|
|
|
|
|
|
|
|
|
endif::[]
|
