kibana/api_docs/data_enhanced.json
Mike Côté 3abb79a179
Create new alerting HTTP APIs that use the new terminology (#93977)
* Move current alert HTTP APIs to legacy folder (#93943)

* Move current HTTP APIs to legacy folder

* Rename BASE_ALERT_API_PATH to LEGACY_BASE_ALERT_API_PATH

* Fix failing tests and extra files

* Create new rule HTTP APIs (#93980)

* Move current HTTP APIs to legacy folder

* Rename BASE_ALERT_API_PATH to LEGACY_BASE_ALERT_API_PATH

* Fix failing tests and extra files

* Move current alert HTTP APIs to legacy folder (#93943)

* Move current HTTP APIs to legacy folder

* Rename BASE_ALERT_API_PATH to LEGACY_BASE_ALERT_API_PATH

* Fix failing tests and extra files

* Add necessary files

* Create rule route

* Get rule API

* Update rule API

* Delete rule route

* Aggregate rules API

* Disable rule API

* Enable rule API

* Find rules API

* Fix Update API

* Get rule alert summary API

* Get rule state API

* Health API

* Rule types API

* Mute all API

* Mute alert API

* Unmute all API

* Unmute alert route

* Update API key API

* corrected tpye by making it much more complicated

* removed unneeded cocde

* Fixes

* Add back health route

* mutedInstanceIds -> mutedAlertIds

* lastRun -> last_run

* alert_type_state -> rule_type_state & alert_instances -> alerts

Co-authored-by: Gidi Meir Morris <github@gidi.io>

* Create docs for new rule HTTP APIs, deprecate old docs (#94745)

* Create docs for new APIs, deprecate old docs

* Remove connector_type_id

* Update docs

* Add link to legacy APIs from rules API docs

* Remove connector_type_id references

* [DOCS] Add legacy APIs to index.asciidoc

* Fix camel case

Co-authored-by: lcawl <lcawley@elastic.co>

* Make alerting tests use new rules APIs (#95159)

* Make API integration tests use new HTTP APIs

* Fix end to end tests

* Fix test failures

* Fix more test failures

* Rename some files

* Add tests for legacy APIs (#95333)

* Initial commit (#95457)

* Move some new alerting APIs to /internal (#95461)

* Initial commit

* Update README.md

* Use internal API

* Merge deprecated warning w/ alternative solution

* Update API docs

Co-authored-by: Gidi Meir Morris <github@gidi.io>
Co-authored-by: Kibana Machine <42973632+kibanamachine@users.noreply.github.com>
Co-authored-by: lcawl <lcawley@elastic.co>
2021-03-30 08:27:28 -04:00

928 lines
28 KiB
JSON

{
"id": "dataEnhanced",
"client": {
"classes": [],
"functions": [],
"interfaces": [],
"enums": [],
"misc": [
{
"tags": [],
"id": "def-public.ENHANCED_ES_SEARCH_STRATEGY",
"type": "string",
"label": "ENHANCED_ES_SEARCH_STRATEGY",
"description": [],
"source": {
"path": "x-pack/plugins/data_enhanced/common/search/types.ts",
"lineNumber": 17
},
"signature": [
"\"ese\""
],
"initialIsOpen": false
},
{
"tags": [],
"id": "def-public.EQL_SEARCH_STRATEGY",
"type": "string",
"label": "EQL_SEARCH_STRATEGY",
"description": [],
"source": {
"path": "x-pack/plugins/data_enhanced/common/search/types.ts",
"lineNumber": 19
},
"signature": [
"\"eql\""
],
"initialIsOpen": false
}
],
"objects": [],
"start": {
"id": "def-public.DataEnhancedStart",
"type": "Type",
"label": "DataEnhancedStart",
"tags": [],
"description": [],
"source": {
"path": "x-pack/plugins/data_enhanced/public/plugin.ts",
"lineNumber": 38
},
"signature": [
"void"
],
"lifecycle": "start",
"initialIsOpen": true
}
},
"server": {
"classes": [
{
"id": "def-server.EnhancedDataServerPlugin",
"type": "Class",
"tags": [],
"label": "EnhancedDataServerPlugin",
"description": [],
"signature": [
{
"pluginId": "dataEnhanced",
"scope": "server",
"docId": "kibDataEnhancedPluginApi",
"section": "def-server.EnhancedDataServerPlugin",
"text": "EnhancedDataServerPlugin"
},
" implements ",
{
"pluginId": "core",
"scope": "server",
"docId": "kibCorePluginApi",
"section": "def-server.Plugin",
"text": "Plugin"
},
"<void, void, SetupDependencies, ",
"StartDependencies",
">"
],
"children": [
{
"id": "def-server.EnhancedDataServerPlugin.Unnamed",
"type": "Function",
"label": "Constructor",
"signature": [
"any"
],
"description": [],
"children": [
{
"type": "Object",
"label": "initializerContext",
"isRequired": true,
"signature": [
{
"pluginId": "core",
"scope": "server",
"docId": "kibCorePluginApi",
"section": "def-server.PluginInitializerContext",
"text": "PluginInitializerContext"
},
"<Readonly<{} & { search: Readonly<{} & { sessions: Readonly<{} & { enabled: boolean; management: Readonly<{} & { refreshInterval: moment.Duration; maxSessions: number; refreshTimeout: moment.Duration; expiresSoonWarning: moment.Duration; }>; pageSize: number; trackingInterval: moment.Duration; notTouchedTimeout: moment.Duration; notTouchedInProgressTimeout: moment.Duration; maxUpdateRetries: number; defaultExpiration: moment.Duration; }>; }>; }>>"
],
"description": [],
"source": {
"path": "x-pack/plugins/data_enhanced/server/plugin.ts",
"lineNumber": 48
}
}
],
"tags": [],
"returnComment": [],
"source": {
"path": "x-pack/plugins/data_enhanced/server/plugin.ts",
"lineNumber": 48
}
},
{
"id": "def-server.EnhancedDataServerPlugin.setup",
"type": "Function",
"label": "setup",
"signature": [
"(core: ",
{
"pluginId": "core",
"scope": "server",
"docId": "kibCorePluginApi",
"section": "def-server.CoreSetup",
"text": "CoreSetup"
},
"<",
{
"pluginId": "data",
"scope": "server",
"docId": "kibDataPluginApi",
"section": "def-server.DataPluginStart",
"text": "DataPluginStart"
},
", unknown>, deps: SetupDependencies) => void"
],
"description": [],
"children": [
{
"type": "Object",
"label": "core",
"isRequired": true,
"signature": [
{
"pluginId": "core",
"scope": "server",
"docId": "kibCorePluginApi",
"section": "def-server.CoreSetup",
"text": "CoreSetup"
},
"<",
{
"pluginId": "data",
"scope": "server",
"docId": "kibDataPluginApi",
"section": "def-server.DataPluginStart",
"text": "DataPluginStart"
},
", unknown>"
],
"description": [],
"source": {
"path": "x-pack/plugins/data_enhanced/server/plugin.ts",
"lineNumber": 53
}
},
{
"type": "Object",
"label": "deps",
"isRequired": true,
"signature": [
"SetupDependencies"
],
"description": [],
"source": {
"path": "x-pack/plugins/data_enhanced/server/plugin.ts",
"lineNumber": 53
}
}
],
"tags": [],
"returnComment": [],
"source": {
"path": "x-pack/plugins/data_enhanced/server/plugin.ts",
"lineNumber": 53
}
},
{
"id": "def-server.EnhancedDataServerPlugin.start",
"type": "Function",
"label": "start",
"signature": [
"(core: ",
{
"pluginId": "core",
"scope": "server",
"docId": "kibCorePluginApi",
"section": "def-server.CoreStart",
"text": "CoreStart"
},
", { taskManager }: ",
{
"pluginId": "dataEnhanced",
"scope": "server",
"docId": "kibDataEnhancedPluginApi",
"section": "def-server.StartDependencies",
"text": "StartDependencies"
},
") => void"
],
"description": [],
"children": [
{
"type": "Object",
"label": "core",
"isRequired": true,
"signature": [
{
"pluginId": "core",
"scope": "server",
"docId": "kibCorePluginApi",
"section": "def-server.CoreStart",
"text": "CoreStart"
}
],
"description": [],
"source": {
"path": "x-pack/plugins/data_enhanced/server/plugin.ts",
"lineNumber": 95
}
},
{
"type": "Object",
"label": "{ taskManager }",
"isRequired": true,
"signature": [
{
"pluginId": "dataEnhanced",
"scope": "server",
"docId": "kibDataEnhancedPluginApi",
"section": "def-server.StartDependencies",
"text": "StartDependencies"
}
],
"description": [],
"source": {
"path": "x-pack/plugins/data_enhanced/server/plugin.ts",
"lineNumber": 95
}
}
],
"tags": [],
"returnComment": [],
"source": {
"path": "x-pack/plugins/data_enhanced/server/plugin.ts",
"lineNumber": 95
}
},
{
"id": "def-server.EnhancedDataServerPlugin.stop",
"type": "Function",
"label": "stop",
"signature": [
"() => void"
],
"description": [],
"children": [],
"tags": [],
"returnComment": [],
"source": {
"path": "x-pack/plugins/data_enhanced/server/plugin.ts",
"lineNumber": 101
}
}
],
"source": {
"path": "x-pack/plugins/data_enhanced/server/plugin.ts",
"lineNumber": 42
},
"initialIsOpen": false
}
],
"functions": [],
"interfaces": [],
"enums": [],
"misc": [
{
"tags": [],
"id": "def-server.ENHANCED_ES_SEARCH_STRATEGY",
"type": "string",
"label": "ENHANCED_ES_SEARCH_STRATEGY",
"description": [],
"source": {
"path": "x-pack/plugins/data_enhanced/common/search/types.ts",
"lineNumber": 17
},
"signature": [
"\"ese\""
],
"initialIsOpen": false
},
{
"tags": [],
"id": "def-server.EQL_SEARCH_STRATEGY",
"type": "string",
"label": "EQL_SEARCH_STRATEGY",
"description": [],
"source": {
"path": "x-pack/plugins/data_enhanced/common/search/types.ts",
"lineNumber": 19
},
"signature": [
"\"eql\""
],
"initialIsOpen": false
}
],
"objects": []
},
"common": {
"classes": [],
"functions": [
{
"id": "def-common.pollSearch",
"type": "Function",
"children": [
{
"type": "Function",
"label": "search",
"isRequired": true,
"signature": [
"() => Promise<Response>"
],
"description": [],
"source": {
"path": "x-pack/plugins/data_enhanced/common/search/poll_search.ts",
"lineNumber": 16
}
},
{
"type": "Function",
"label": "cancel",
"isRequired": false,
"signature": [
"(() => void) | undefined"
],
"description": [],
"source": {
"path": "x-pack/plugins/data_enhanced/common/search/poll_search.ts",
"lineNumber": 17
}
},
{
"type": "Object",
"label": "{ pollInterval = 1000, abortSignal }",
"isRequired": true,
"signature": [
{
"pluginId": "dataEnhanced",
"scope": "common",
"docId": "kibDataEnhancedPluginApi",
"section": "def-common.IAsyncSearchOptions",
"text": "IAsyncSearchOptions"
}
],
"description": [],
"source": {
"path": "x-pack/plugins/data_enhanced/common/search/poll_search.ts",
"lineNumber": 18
}
}
],
"signature": [
"<Response extends ",
{
"pluginId": "data",
"scope": "common",
"docId": "kibDataSearchPluginApi",
"section": "def-common.IKibanaSearchResponse",
"text": "IKibanaSearchResponse"
},
"<any>>(search: () => Promise<Response>, cancel?: (() => void) | undefined, { pollInterval, abortSignal }?: ",
{
"pluginId": "dataEnhanced",
"scope": "common",
"docId": "kibDataEnhancedPluginApi",
"section": "def-common.IAsyncSearchOptions",
"text": "IAsyncSearchOptions"
},
") => ",
"Observable",
"<Response>"
],
"description": [],
"label": "pollSearch",
"source": {
"path": "x-pack/plugins/data_enhanced/common/search/poll_search.ts",
"lineNumber": 15
},
"tags": [],
"returnComment": [],
"initialIsOpen": false
}
],
"interfaces": [
{
"id": "def-common.EqlSearchStrategyRequest",
"type": "Interface",
"label": "EqlSearchStrategyRequest",
"signature": [
{
"pluginId": "dataEnhanced",
"scope": "common",
"docId": "kibDataEnhancedPluginApi",
"section": "def-common.EqlSearchStrategyRequest",
"text": "EqlSearchStrategyRequest"
},
" extends ",
{
"pluginId": "data",
"scope": "common",
"docId": "kibDataSearchPluginApi",
"section": "def-common.IKibanaSearchRequest",
"text": "IKibanaSearchRequest"
},
"<",
{
"pluginId": "dataEnhanced",
"scope": "common",
"docId": "kibDataEnhancedPluginApi",
"section": "def-common.EqlRequestParams",
"text": "EqlRequestParams"
},
">"
],
"description": [],
"tags": [],
"children": [
{
"tags": [],
"id": "def-common.EqlSearchStrategyRequest.options",
"type": "Object",
"label": "options",
"description": [],
"source": {
"path": "x-pack/plugins/data_enhanced/common/search/types.ts",
"lineNumber": 24
},
"signature": [
"TransportRequestOptions",
" | undefined"
]
}
],
"source": {
"path": "x-pack/plugins/data_enhanced/common/search/types.ts",
"lineNumber": 23
},
"initialIsOpen": false
},
{
"id": "def-common.IAsyncSearchOptions",
"type": "Interface",
"label": "IAsyncSearchOptions",
"signature": [
{
"pluginId": "dataEnhanced",
"scope": "common",
"docId": "kibDataEnhancedPluginApi",
"section": "def-common.IAsyncSearchOptions",
"text": "IAsyncSearchOptions"
},
" extends ",
{
"pluginId": "data",
"scope": "common",
"docId": "kibDataSearchPluginApi",
"section": "def-common.ISearchOptions",
"text": "ISearchOptions"
}
],
"description": [],
"tags": [],
"children": [
{
"tags": [],
"id": "def-common.IAsyncSearchOptions.pollInterval",
"type": "number",
"label": "pollInterval",
"description": [
"\nThe number of milliseconds to wait between receiving a response and sending another request"
],
"source": {
"path": "x-pack/plugins/data_enhanced/common/search/types.ts",
"lineNumber": 33
},
"signature": [
"number | undefined"
]
}
],
"source": {
"path": "x-pack/plugins/data_enhanced/common/search/types.ts",
"lineNumber": 29
},
"initialIsOpen": false
},
{
"id": "def-common.SearchSessionRequestInfo",
"type": "Interface",
"label": "SearchSessionRequestInfo",
"description": [],
"tags": [],
"children": [
{
"tags": [],
"id": "def-common.SearchSessionRequestInfo.id",
"type": "string",
"label": "id",
"description": [
"\nID of the async search request"
],
"source": {
"path": "src/plugins/data/common/search/session/types.ts",
"lineNumber": 73
}
},
{
"tags": [],
"id": "def-common.SearchSessionRequestInfo.strategy",
"type": "string",
"label": "strategy",
"description": [
"\nSearch strategy used to submit the search request"
],
"source": {
"path": "src/plugins/data/common/search/session/types.ts",
"lineNumber": 77
}
},
{
"tags": [],
"id": "def-common.SearchSessionRequestInfo.status",
"type": "string",
"label": "status",
"description": [
"\nstatus"
],
"source": {
"path": "src/plugins/data/common/search/session/types.ts",
"lineNumber": 81
}
},
{
"tags": [],
"id": "def-common.SearchSessionRequestInfo.error",
"type": "string",
"label": "error",
"description": [
"\nAn optional error. Set if status is set to error."
],
"source": {
"path": "src/plugins/data/common/search/session/types.ts",
"lineNumber": 85
},
"signature": [
"string | undefined"
]
}
],
"source": {
"path": "src/plugins/data/common/search/session/types.ts",
"lineNumber": 69
},
"initialIsOpen": false
},
{
"id": "def-common.SearchSessionSavedObjectAttributes",
"type": "Interface",
"label": "SearchSessionSavedObjectAttributes",
"description": [],
"tags": [],
"children": [
{
"tags": [],
"id": "def-common.SearchSessionSavedObjectAttributes.sessionId",
"type": "string",
"label": "sessionId",
"description": [],
"source": {
"path": "src/plugins/data/common/search/session/types.ts",
"lineNumber": 13
}
},
{
"tags": [],
"id": "def-common.SearchSessionSavedObjectAttributes.name",
"type": "string",
"label": "name",
"description": [
"\nUser-facing session name to be displayed in session management"
],
"source": {
"path": "src/plugins/data/common/search/session/types.ts",
"lineNumber": 17
},
"signature": [
"string | undefined"
]
},
{
"tags": [],
"id": "def-common.SearchSessionSavedObjectAttributes.appId",
"type": "string",
"label": "appId",
"description": [
"\nApp that created the session. e.g 'discover'"
],
"source": {
"path": "src/plugins/data/common/search/session/types.ts",
"lineNumber": 21
},
"signature": [
"string | undefined"
]
},
{
"tags": [],
"id": "def-common.SearchSessionSavedObjectAttributes.created",
"type": "string",
"label": "created",
"description": [
"\nCreation time of the session"
],
"source": {
"path": "src/plugins/data/common/search/session/types.ts",
"lineNumber": 25
}
},
{
"tags": [],
"id": "def-common.SearchSessionSavedObjectAttributes.touched",
"type": "string",
"label": "touched",
"description": [
"\nLast touch time of the session"
],
"source": {
"path": "src/plugins/data/common/search/session/types.ts",
"lineNumber": 29
}
},
{
"tags": [],
"id": "def-common.SearchSessionSavedObjectAttributes.expires",
"type": "string",
"label": "expires",
"description": [
"\nExpiration time of the session. Expiration itself is managed by Elasticsearch."
],
"source": {
"path": "src/plugins/data/common/search/session/types.ts",
"lineNumber": 33
}
},
{
"tags": [],
"id": "def-common.SearchSessionSavedObjectAttributes.status",
"type": "Enum",
"label": "status",
"description": [
"\nstatus"
],
"source": {
"path": "src/plugins/data/common/search/session/types.ts",
"lineNumber": 37
},
"signature": [
{
"pluginId": "data",
"scope": "common",
"docId": "kibDataSearchPluginApi",
"section": "def-common.SearchSessionStatus",
"text": "SearchSessionStatus"
}
]
},
{
"tags": [],
"id": "def-common.SearchSessionSavedObjectAttributes.urlGeneratorId",
"type": "string",
"label": "urlGeneratorId",
"description": [
"\nurlGeneratorId"
],
"source": {
"path": "src/plugins/data/common/search/session/types.ts",
"lineNumber": 41
},
"signature": [
"string | undefined"
]
},
{
"tags": [],
"id": "def-common.SearchSessionSavedObjectAttributes.initialState",
"type": "Object",
"label": "initialState",
"description": [
"\nThe application state that was used to create the session.\nShould be used, for example, to re-load an expired search session."
],
"source": {
"path": "src/plugins/data/common/search/session/types.ts",
"lineNumber": 46
},
"signature": [
"Record<string, unknown> | undefined"
]
},
{
"tags": [],
"id": "def-common.SearchSessionSavedObjectAttributes.restoreState",
"type": "Object",
"label": "restoreState",
"description": [
"\nApplication state that should be used to restore the session.\nFor example, relative dates are conveted to absolute ones."
],
"source": {
"path": "src/plugins/data/common/search/session/types.ts",
"lineNumber": 51
},
"signature": [
"Record<string, unknown> | undefined"
]
},
{
"tags": [],
"id": "def-common.SearchSessionSavedObjectAttributes.idMapping",
"type": "Object",
"label": "idMapping",
"description": [
"\nMapping of search request hashes to their corresponsing info (async search id, etc.)"
],
"source": {
"path": "src/plugins/data/common/search/session/types.ts",
"lineNumber": 55
},
"signature": [
"Record<string, ",
{
"pluginId": "data",
"scope": "common",
"docId": "kibDataSearchPluginApi",
"section": "def-common.SearchSessionRequestInfo",
"text": "SearchSessionRequestInfo"
},
">"
]
},
{
"tags": [],
"id": "def-common.SearchSessionSavedObjectAttributes.persisted",
"type": "boolean",
"label": "persisted",
"description": [
"\nThis value is true if the session was actively stored by the user. If it is false, the session may be purged by the system."
],
"source": {
"path": "src/plugins/data/common/search/session/types.ts",
"lineNumber": 60
}
},
{
"tags": [],
"id": "def-common.SearchSessionSavedObjectAttributes.realmType",
"type": "string",
"label": "realmType",
"description": [
"\nThe realm type/name & username uniquely identifies the user who created this search session"
],
"source": {
"path": "src/plugins/data/common/search/session/types.ts",
"lineNumber": 64
},
"signature": [
"string | undefined"
]
},
{
"tags": [],
"id": "def-common.SearchSessionSavedObjectAttributes.realmName",
"type": "string",
"label": "realmName",
"description": [],
"source": {
"path": "src/plugins/data/common/search/session/types.ts",
"lineNumber": 65
},
"signature": [
"string | undefined"
]
},
{
"tags": [],
"id": "def-common.SearchSessionSavedObjectAttributes.username",
"type": "string",
"label": "username",
"description": [],
"source": {
"path": "src/plugins/data/common/search/session/types.ts",
"lineNumber": 66
},
"signature": [
"string | undefined"
]
}
],
"source": {
"path": "src/plugins/data/common/search/session/types.ts",
"lineNumber": 12
},
"initialIsOpen": false
}
],
"enums": [
{
"id": "def-common.SearchSessionStatus",
"type": "Enum",
"label": "SearchSessionStatus",
"tags": [],
"description": [],
"source": {
"path": "src/plugins/data/common/search/session/status.ts",
"lineNumber": 9
},
"initialIsOpen": false
}
],
"misc": [
{
"tags": [],
"id": "def-common.ENHANCED_ES_SEARCH_STRATEGY",
"type": "string",
"label": "ENHANCED_ES_SEARCH_STRATEGY",
"description": [],
"source": {
"path": "x-pack/plugins/data_enhanced/common/search/types.ts",
"lineNumber": 17
},
"signature": [
"\"ese\""
],
"initialIsOpen": false
},
{
"tags": [],
"id": "def-common.EQL_SEARCH_STRATEGY",
"type": "string",
"label": "EQL_SEARCH_STRATEGY",
"description": [],
"source": {
"path": "x-pack/plugins/data_enhanced/common/search/types.ts",
"lineNumber": 19
},
"signature": [
"\"eql\""
],
"initialIsOpen": false
},
{
"id": "def-common.EqlRequestParams",
"type": "Type",
"label": "EqlRequestParams",
"tags": [],
"description": [],
"source": {
"path": "x-pack/plugins/data_enhanced/common/search/types.ts",
"lineNumber": 21
},
"signature": [
"EqlSearch<Record<string, unknown>>"
],
"initialIsOpen": false
},
{
"id": "def-common.EqlSearchStrategyResponse",
"type": "Type",
"label": "EqlSearchStrategyResponse",
"tags": [],
"description": [],
"source": {
"path": "x-pack/plugins/data_enhanced/common/search/types.ts",
"lineNumber": 27
},
"signature": [
"IKibanaSearchResponse<ApiResponse<T, unknown>>"
],
"initialIsOpen": false
},
{
"tags": [],
"id": "def-common.SEARCH_SESSION_TYPE",
"type": "string",
"label": "SEARCH_SESSION_TYPE",
"description": [],
"source": {
"path": "src/plugins/data/common/search/session/types.ts",
"lineNumber": 11
},
"signature": [
"\"search-session\""
],
"initialIsOpen": false
}
],
"objects": []
}
}