2019-06-27 01:44:33 +08:00
|
|
|
[[rest-apis]]
|
|
|
|
= REST APIs
|
2018-06-06 07:43:55 +08:00
|
|
|
|
|
|
|
[partintro]
|
|
|
|
--
|
2019-06-27 01:44:33 +08:00
|
|
|
{es} exposes REST APIs that are used by the UI components and can be called
|
|
|
|
directly to configure and access {es} features.
|
|
|
|
|
|
|
|
[NOTE]
|
|
|
|
We are working on including more {es} APIs in this section. Some content might
|
|
|
|
not be included yet.
|
2018-06-06 07:43:55 +08:00
|
|
|
|
2019-07-20 02:35:36 +08:00
|
|
|
* <<api-conventions, API conventions>>
|
2021-07-01 00:24:42 +08:00
|
|
|
* <<common-options, Common Options>>
|
2022-02-05 06:32:22 +08:00
|
|
|
* <<rest-api-compatibility, REST API Compatibility>>
|
2020-04-02 03:43:44 +08:00
|
|
|
* <<autoscaling-apis, Autoscaling APIs>>
|
2023-04-04 17:36:13 +08:00
|
|
|
* <<behavioral-analytics-apis, Behavioral Analytics APIs>>
|
2019-07-20 02:35:36 +08:00
|
|
|
* <<cat, cat APIs>>
|
|
|
|
* <<cluster, Cluster APIs>>
|
2021-03-03 02:30:02 +08:00
|
|
|
* <<features-apis,Features APIs>>
|
2019-03-13 05:27:17 +08:00
|
|
|
* <<ccr-apis,{ccr-cap} APIs>>
|
2020-06-18 21:05:56 +08:00
|
|
|
* <<data-stream-apis,Data stream APIs>>
|
Introduce a _lifecycle/explain API for data stream backing indices (#94621)
This adds an {index}/_lifecycle/explain API to retrieve information
about an index's status within its lifecycle.
The response looks like so:
```
"indices" : {
".ds-metrics-foo-2023.03.22-000001" : {
"index" : ".ds-metrics-foo-2023.03.22-000001",
"managed_by_dlm" : true,
"index_creation_date_millis" : 1679475563571,
"time_since_index_creation" : "843ms",
"rollover_date_millis" : 1679475564293,
"time_since_rollover" : "121ms",
"lifecycle" : { },
"generation_time" : "121ms"
},
".ds-metrics-foo-2023.03.22-000002" : {
"index" : ".ds-metrics-foo-2023.03.22-000002",
"managed_by_dlm" : true,
"index_creation_date_millis" : 1679475564351,
"time_since_index_creation" : "63ms",
"lifecycle" : { }
}
}
}
```
2023-03-27 15:44:40 +08:00
|
|
|
* <<data-lifecycle-management-api, Data Lifecycle Management APIs>>
|
2019-07-20 02:35:36 +08:00
|
|
|
* <<docs, Document APIs>>
|
2019-09-05 02:11:52 +08:00
|
|
|
* <<enrich-apis,Enrich APIs>>
|
2021-07-02 01:59:35 +08:00
|
|
|
* <<eql-apis,EQL search APIs>>
|
2021-02-23 05:20:06 +08:00
|
|
|
* <<find-structure,Find structure API>>
|
2021-04-15 01:19:33 +08:00
|
|
|
* <<fleet-apis,Fleet APIs>>
|
2021-07-02 01:59:35 +08:00
|
|
|
* <<graph-explore-api,Graph explore API>>
|
2019-07-20 02:35:36 +08:00
|
|
|
* <<indices, Index APIs>>
|
2018-10-31 09:27:43 +08:00
|
|
|
* <<index-lifecycle-management-api,Index lifecycle management APIs>>
|
2019-08-23 23:54:40 +08:00
|
|
|
* <<ingest-apis,Ingest APIs>>
|
2019-07-20 02:35:36 +08:00
|
|
|
* <<info-api,Info API>>
|
2018-06-06 07:43:55 +08:00
|
|
|
* <<licensing-apis,Licensing APIs>>
|
2021-01-29 01:50:16 +08:00
|
|
|
* <<logstash-apis,Logstash APIs>>
|
2022-02-17 03:23:00 +08:00
|
|
|
* <<ml-apis,{ml-cap} APIs>>
|
|
|
|
* <<ml-ad-apis,{ml-cap} {anomaly-detect} APIs>>
|
2019-07-17 04:22:27 +08:00
|
|
|
* <<ml-df-analytics-apis,{ml-cap} {dfanalytics} APIs>>
|
2022-01-25 23:14:48 +08:00
|
|
|
* <<ml-df-trained-models-apis,{ml-cap} trained model APIs>>
|
2019-07-20 02:35:36 +08:00
|
|
|
* <<migration-api,Migration APIs>>
|
2021-08-20 00:42:27 +08:00
|
|
|
* <<node-lifecycle-api,Node lifecycle API>>
|
2021-02-23 05:20:06 +08:00
|
|
|
* <<indices-reload-analyzers,Reload search analyzers API>>
|
|
|
|
* <<repositories-metering-apis,Repositories metering APIs>>
|
2019-07-20 02:35:36 +08:00
|
|
|
* <<rollup-apis,Rollup APIs>>
|
2021-04-19 21:19:12 +08:00
|
|
|
* <<script-apis,Script APIs>>
|
2019-07-20 02:35:36 +08:00
|
|
|
* <<search, Search APIs>>
|
2023-04-04 17:36:13 +08:00
|
|
|
* <<search-application-apis, Search Application APIs>>
|
2020-04-06 21:51:05 +08:00
|
|
|
* <<searchable-snapshots-apis, Searchable snapshots APIs>>
|
2018-06-06 07:43:55 +08:00
|
|
|
* <<security-api,Security APIs>>
|
2020-05-12 20:56:29 +08:00
|
|
|
* <<snapshot-restore-apis,Snapshot and restore APIs>>
|
2019-07-20 02:35:36 +08:00
|
|
|
* <<snapshot-lifecycle-management-api,Snapshot lifecycle management APIs>>
|
2021-07-12 22:12:02 +08:00
|
|
|
* <<sql-apis,SQL APIs>>
|
2019-09-21 04:26:57 +08:00
|
|
|
* <<transform-apis,{transform-cap} APIs>>
|
2020-02-21 01:25:57 +08:00
|
|
|
* <<usage-api,Usage API>>
|
2018-06-06 07:43:55 +08:00
|
|
|
* <<watcher-api,Watcher APIs>>
|
|
|
|
--
|
|
|
|
|
2019-07-17 20:49:22 +08:00
|
|
|
include::{es-repo-dir}/api-conventions.asciidoc[]
|
2021-07-01 00:24:42 +08:00
|
|
|
include::{es-repo-dir}/rest-api/common-options.asciidoc[]
|
2022-02-05 06:32:22 +08:00
|
|
|
include::{es-repo-dir}/rest-api/rest-api-compatibility.asciidoc[]
|
2020-02-07 08:15:17 +08:00
|
|
|
include::{es-repo-dir}/autoscaling/apis/autoscaling-apis.asciidoc[]
|
2023-04-04 17:36:13 +08:00
|
|
|
include::{es-repo-dir}/behavioral-analytics/apis/index.asciidoc[]
|
2019-07-17 20:49:22 +08:00
|
|
|
include::{es-repo-dir}/cat.asciidoc[]
|
|
|
|
include::{es-repo-dir}/cluster.asciidoc[]
|
2018-10-26 23:23:35 +08:00
|
|
|
include::{es-repo-dir}/ccr/apis/ccr-apis.asciidoc[]
|
2020-06-11 23:17:21 +08:00
|
|
|
include::{es-repo-dir}/data-streams/data-stream-apis.asciidoc[]
|
2019-07-20 02:35:36 +08:00
|
|
|
include::{es-repo-dir}/docs.asciidoc[]
|
2019-09-05 02:11:52 +08:00
|
|
|
include::{es-repo-dir}/ingest/apis/enrich/index.asciidoc[]
|
2021-07-02 01:59:35 +08:00
|
|
|
include::{es-repo-dir}/eql/eql-apis.asciidoc[]
|
2021-03-03 02:30:02 +08:00
|
|
|
include::{es-repo-dir}/features/apis/features-apis.asciidoc[]
|
2021-04-15 01:19:33 +08:00
|
|
|
include::{es-repo-dir}/fleet/index.asciidoc[]
|
2021-01-13 03:59:45 +08:00
|
|
|
include::{es-repo-dir}/text-structure/apis/find-structure.asciidoc[leveloffset=+1]
|
2018-09-27 05:59:31 +08:00
|
|
|
include::{es-repo-dir}/graph/explore.asciidoc[]
|
2019-07-20 02:35:36 +08:00
|
|
|
include::{es-repo-dir}/indices.asciidoc[]
|
2018-10-31 09:27:43 +08:00
|
|
|
include::{es-repo-dir}/ilm/apis/ilm-api.asciidoc[]
|
2019-08-23 23:54:40 +08:00
|
|
|
include::{es-repo-dir}/ingest/apis/index.asciidoc[]
|
2019-07-20 02:35:36 +08:00
|
|
|
include::info.asciidoc[]
|
2018-06-20 23:17:11 +08:00
|
|
|
include::{es-repo-dir}/licensing/index.asciidoc[]
|
2021-01-29 01:50:16 +08:00
|
|
|
include::{xes-repo-dir}/rest-api/logstash/index.asciidoc[]
|
2022-02-17 03:23:00 +08:00
|
|
|
include::{es-repo-dir}/ml/common/apis/index.asciidoc[]
|
2020-07-21 03:38:09 +08:00
|
|
|
include::{es-repo-dir}/ml/anomaly-detection/apis/index.asciidoc[]
|
2019-07-17 04:22:27 +08:00
|
|
|
include::{es-repo-dir}/ml/df-analytics/apis/index.asciidoc[]
|
2021-12-04 01:21:09 +08:00
|
|
|
include::{es-repo-dir}/ml/trained-models/apis/index.asciidoc[]
|
2019-07-20 02:35:36 +08:00
|
|
|
include::{es-repo-dir}/migration/migration.asciidoc[]
|
2021-08-20 00:42:27 +08:00
|
|
|
include::{es-repo-dir}/shutdown/apis/shutdown-api.asciidoc[]
|
2019-07-20 02:35:36 +08:00
|
|
|
include::{es-repo-dir}/indices/apis/reload-analyzers.asciidoc[]
|
2020-09-08 16:44:54 +08:00
|
|
|
include::{es-repo-dir}/repositories-metering-api/repositories-metering-apis.asciidoc[]
|
2020-11-26 00:16:06 +08:00
|
|
|
include::{es-repo-dir}/rollup/rollup-apis.asciidoc[]
|
2021-04-19 21:19:12 +08:00
|
|
|
include::{es-repo-dir}/scripting/apis/script-apis.asciidoc[]
|
2019-07-20 02:35:36 +08:00
|
|
|
include::{es-repo-dir}/search.asciidoc[]
|
2023-04-04 17:36:13 +08:00
|
|
|
include::{es-repo-dir}/search-application/apis/index.asciidoc[]
|
2020-04-06 21:51:05 +08:00
|
|
|
include::{es-repo-dir}/searchable-snapshots/apis/searchable-snapshots-apis.asciidoc[]
|
2018-06-06 07:43:55 +08:00
|
|
|
include::{xes-repo-dir}/rest-api/security.asciidoc[]
|
2020-05-12 20:56:29 +08:00
|
|
|
include::{es-repo-dir}/snapshot-restore/apis/snapshot-restore-apis.asciidoc[]
|
2020-01-22 11:58:17 +08:00
|
|
|
include::{es-repo-dir}/slm/apis/slm-api.asciidoc[]
|
2021-07-12 22:12:02 +08:00
|
|
|
include::{es-repo-dir}/sql/apis/sql-apis.asciidoc[]
|
2019-09-17 01:23:46 +08:00
|
|
|
include::{es-repo-dir}/transform/apis/index.asciidoc[]
|
2020-02-21 01:25:57 +08:00
|
|
|
include::usage.asciidoc[]
|
2018-06-06 07:43:55 +08:00
|
|
|
include::{xes-repo-dir}/rest-api/watcher.asciidoc[]
|
2018-09-01 07:49:24 +08:00
|
|
|
include::defs.asciidoc[]
|
Introduce a _lifecycle/explain API for data stream backing indices (#94621)
This adds an {index}/_lifecycle/explain API to retrieve information
about an index's status within its lifecycle.
The response looks like so:
```
"indices" : {
".ds-metrics-foo-2023.03.22-000001" : {
"index" : ".ds-metrics-foo-2023.03.22-000001",
"managed_by_dlm" : true,
"index_creation_date_millis" : 1679475563571,
"time_since_index_creation" : "843ms",
"rollover_date_millis" : 1679475564293,
"time_since_rollover" : "121ms",
"lifecycle" : { },
"generation_time" : "121ms"
},
".ds-metrics-foo-2023.03.22-000002" : {
"index" : ".ds-metrics-foo-2023.03.22-000002",
"managed_by_dlm" : true,
"index_creation_date_millis" : 1679475564351,
"time_since_index_creation" : "63ms",
"lifecycle" : { }
}
}
}
```
2023-03-27 15:44:40 +08:00
|
|
|
include::{es-repo-dir}/dlm/apis/dlm-api.asciidoc[]
|