2018-05-30 18:27:48 +02:00
|
|
|
[[api]]
|
|
|
|
= REST API
|
|
|
|
|
|
|
|
[partintro]
|
|
|
|
--
|
2019-09-18 17:54:28 +02:00
|
|
|
Some {kib} features are provided via a REST API, which is ideal for creating an
|
|
|
|
integration with {kib}, or automating certain aspects of configuring and
|
|
|
|
deploying {kib}.
|
2018-05-30 18:27:48 +02:00
|
|
|
|
2019-09-18 17:54:28 +02:00
|
|
|
Each API is experimental and can include breaking changes in any version of
|
2019-10-16 22:10:40 +02:00
|
|
|
{kib}, or might be entirely removed from {kib}.
|
2019-09-18 17:54:28 +02:00
|
|
|
|
|
|
|
////
|
2019-09-06 18:09:57 +02:00
|
|
|
Each API has one of the following labels:
|
2018-05-30 18:27:48 +02:00
|
|
|
|
|
|
|
* *Stable* APIs should be safe to use extensively in production. Any breaking
|
|
|
|
changes to these APIs should only occur in major versions and will be
|
|
|
|
clearly documented in the breaking changes documentation for that release.
|
2019-09-06 18:09:57 +02:00
|
|
|
|
|
|
|
* *Beta* APIs are on track to become stable, permanent features of {kib}.
|
2018-05-30 18:27:48 +02:00
|
|
|
Caution should be exercised in their use since it is possible we'd have to make
|
|
|
|
a breaking change to these APIs in a minor version, but we'll avoid this
|
|
|
|
wherever possible.
|
2019-09-06 18:09:57 +02:00
|
|
|
|
2018-05-30 18:27:48 +02:00
|
|
|
* *Experimental* APIs are just that - an experiment. An experimental API might
|
2019-09-06 18:09:57 +02:00
|
|
|
have breaking changes in any version of {kib}, or it might even be removed
|
2018-05-30 18:27:48 +02:00
|
|
|
entirely.
|
|
|
|
|
2019-09-06 18:09:57 +02:00
|
|
|
If a label is missing from an API, it is considered `experimental`.
|
2019-09-18 17:54:28 +02:00
|
|
|
////
|
2019-09-06 18:09:57 +02:00
|
|
|
|
2018-05-30 18:27:48 +02:00
|
|
|
--
|
|
|
|
|
2019-10-16 22:10:40 +02:00
|
|
|
include::{kib-repo-dir}/api/using-api.asciidoc[]
|
2019-09-11 21:59:38 +02:00
|
|
|
include::{kib-repo-dir}/api/features.asciidoc[]
|
|
|
|
include::{kib-repo-dir}/api/spaces-management.asciidoc[]
|
|
|
|
include::{kib-repo-dir}/api/role-management.asciidoc[]
|
|
|
|
include::{kib-repo-dir}/api/saved-objects.asciidoc[]
|
2021-02-18 21:36:25 +01:00
|
|
|
include::{kib-repo-dir}/api/alerts.asciidoc[]
|
2021-02-17 19:43:25 +01:00
|
|
|
include::{kib-repo-dir}/api/actions-and-connectors.asciidoc[]
|
2019-10-16 22:10:40 +02:00
|
|
|
include::{kib-repo-dir}/api/dashboard-api.asciidoc[]
|
2019-09-11 21:59:38 +02:00
|
|
|
include::{kib-repo-dir}/api/logstash-configuration-management.asciidoc[]
|
|
|
|
include::{kib-repo-dir}/api/url-shortening.asciidoc[]
|
|
|
|
include::{kib-repo-dir}/api/upgrade-assistant.asciidoc[]
|