2021-03-26 19:55:39 +01:00
|
|
|
[[list-connector-types-api]]
|
2021-03-05 12:49:06 +01:00
|
|
|
=== List connector types API
|
2021-02-17 19:43:25 +01:00
|
|
|
++++
|
2021-03-26 19:55:39 +01:00
|
|
|
<titleabbrev>List all connector types</titleabbrev>
|
2021-02-17 19:43:25 +01:00
|
|
|
++++
|
|
|
|
|
2021-03-05 12:49:06 +01:00
|
|
|
Retrieves a list of all connector types.
|
2021-02-17 19:43:25 +01:00
|
|
|
|
2021-03-26 19:55:39 +01:00
|
|
|
[[list-connector-types-api-request]]
|
2021-02-17 19:43:25 +01:00
|
|
|
==== Request
|
|
|
|
|
2021-03-05 12:49:06 +01:00
|
|
|
`GET <kibana host>:<port>/api/actions/connector_types`
|
2021-02-17 19:43:25 +01:00
|
|
|
|
2021-03-05 12:49:06 +01:00
|
|
|
`GET <kibana host>:<port>/s/<space_id>/api/actions/connector_types`
|
2021-03-01 21:05:19 +01:00
|
|
|
|
2021-03-26 19:55:39 +01:00
|
|
|
[[list-connector-types-api-path-params]]
|
2021-03-01 21:05:19 +01:00
|
|
|
==== Path parameters
|
|
|
|
|
|
|
|
`space_id`::
|
|
|
|
(Optional, string) An identifier for the space. If `space_id` is not provided in the URL, the default space is used.
|
|
|
|
|
2021-03-26 19:55:39 +01:00
|
|
|
[[list-connector-types-api-codes]]
|
2021-02-17 19:43:25 +01:00
|
|
|
==== Response code
|
|
|
|
|
|
|
|
`200`::
|
|
|
|
Indicates a successful call.
|
|
|
|
|
2021-03-26 19:55:39 +01:00
|
|
|
[[list-connector-types-api-example]]
|
2021-02-17 19:43:25 +01:00
|
|
|
==== Example
|
|
|
|
|
|
|
|
[source,sh]
|
|
|
|
--------------------------------------------------
|
2021-03-05 12:49:06 +01:00
|
|
|
$ curl -X GET api/actions/connector_types
|
2021-02-17 19:43:25 +01:00
|
|
|
--------------------------------------------------
|
|
|
|
// KIBANA
|
|
|
|
|
|
|
|
The API returns the following:
|
|
|
|
|
|
|
|
[source,sh]
|
|
|
|
--------------------------------------------------
|
|
|
|
[
|
|
|
|
{
|
|
|
|
"id": ".email", <1>
|
|
|
|
"name": "Email", <2>
|
2021-03-05 12:49:06 +01:00
|
|
|
"minimum_license_required": "gold", <3>
|
2021-02-17 19:43:25 +01:00
|
|
|
"enabled": false, <4>
|
2021-03-05 12:49:06 +01:00
|
|
|
"enabled_in_config": true, <5>
|
|
|
|
"enabled_in_license": false <6>
|
2021-02-17 19:43:25 +01:00
|
|
|
},
|
|
|
|
{
|
|
|
|
"id": ".index",
|
|
|
|
"name": "Index",
|
2021-03-05 12:49:06 +01:00
|
|
|
"minimum_license_required": "basic",
|
2021-02-17 19:43:25 +01:00
|
|
|
"enabled": true,
|
2021-03-05 12:49:06 +01:00
|
|
|
"enabled_in_config": true,
|
|
|
|
"enabled_in_license": true
|
2021-02-17 19:43:25 +01:00
|
|
|
}
|
|
|
|
]
|
|
|
|
--------------------------------------------------
|
|
|
|
|
|
|
|
|
2021-03-05 12:49:06 +01:00
|
|
|
<1> `id` - The unique ID of the connector type.
|
|
|
|
<2> `name` - The name of the connector type.
|
|
|
|
<3> `minimum_license_required` - The license required to use the connector type.
|
|
|
|
<4> `enabled` - Specifies if the connector type is enabled or disabled in {kib}.
|
|
|
|
<5> `enabled_in_config` - Specifies if the connector type is enabled or enabled in the {kib} .yml file.
|
|
|
|
<6> `enabled_in_license` - Specifies if the connector type is enabled or disabled in the license.
|