[Alerting] adds Connectors APIs and deprecates old Actions APIs as per the new Alerting terminology

docs/api/actions-and-connectors.asciidoc

@@ -5,19 +5,21 @@ Manage Actions and Connectors.
 
 The following action APIs are available:
 
-* <<actions-and-connectors-api-get, Get action API>> to retrieve a single action by ID
+* <<actions-and-connectors-api-get, Get connector API>> to retrieve a single connector by ID
 
-* <<actions-and-connectors-api-get-all, Get all actions API>> to retrieve all actions
+* <<actions-and-connectors-api-get-all, Get all connectors API>> to retrieve all connectors
 
-* <<actions-and-connectors-api-list, List all action types API>> to retrieve a list of all action types
+* <<actions-and-connectors-api-list, List all connector types API>> to retrieve a list of all connector types
 
-* <<actions-and-connectors-api-create, Create action API>> to create actions
+* <<actions-and-connectors-api-create, Create connector API>> to create connectors
 
-* <<actions-and-connectors-api-update, Update action API>> to update the attributes for an existing action
+* <<actions-and-connectors-api-update, Update connector API>> to update the attributes for an existing connector
 
-* <<actions-and-connectors-api-execute, Execute action API>> to execute an action by ID
+* <<actions-and-connectors-api-execute, Execute connector API>> to execute an connector by ID
 
-* <<actions-and-connectors-api-delete, Delete action API>> to delete an action by ID
+* <<actions-and-connectors-api-delete, Delete connector API>> to delete an connector by ID
+
+For deprecated APIs, refer to <<actions-and-connectors-legacy-apis>>.
 
 For information about the actions and connectors that {kib} supports, refer to <<action-types,Action and connector types>>.
 
@@ -28,3 +30,11 @@ include::actions-and-connectors/create.asciidoc[]
 include::actions-and-connectors/update.asciidoc[]
 include::actions-and-connectors/execute.asciidoc[]
 include::actions-and-connectors/delete.asciidoc[]
+include::actions-and-connectors/legacy/index.asciidoc[]
+include::actions-and-connectors/legacy/get.asciidoc[]
+include::actions-and-connectors/legacy/get_all.asciidoc[]
+include::actions-and-connectors/legacy/list.asciidoc[]
+include::actions-and-connectors/legacy/create.asciidoc[]
+include::actions-and-connectors/legacy/update.asciidoc[]
+include::actions-and-connectors/legacy/execute.asciidoc[]
+include::actions-and-connectors/legacy/delete.asciidoc[]

docs/api/actions-and-connectors/create.asciidoc

@@ -1,17 +1,17 @@
 [[actions-and-connectors-api-create]]
-=== Create action API
+=== Create connector API
 ++++
-<titleabbrev>Create action API</titleabbrev>
+<titleabbrev>Create connector API</titleabbrev>
 ++++
 
-Creates an action.
+Creates a connector.
 
 [[actions-and-connectors-api-create-request]]
 ==== Request
 
-`POST <kibana host>:<port>/api/actions/action`
+`POST <kibana host>:<port>/api/actions/connector`
 
-`POST <kibana host>:<port>/s/<space_id>/api/actions/action`
+`POST <kibana host>:<port>/s/<space_id>/api/actions/connector`
 
 [[actions-and-connectors-api-create-path-params]]
 ==== Path parameters
@@ -23,18 +23,18 @@ Creates an action.
 ==== Request body
 
 `name`::
-  (Required, string) The display name for the action.
+  (Required, string) The display name for the connector.
 
-`actionTypeId`::
-  (Required, string) The action type ID for the action.
+`connector_type_id`::
+  (Required, string) The connector type ID for the connector.
 
 `config`::
-  (Required, object) The configuration for the action. Configuration properties vary depending on
-  the action type. For information about the configuration properties, refer to <<action-types,Action and connector types>>.
+  (Required, object) The configuration for the connector. Configuration properties vary depending on
+  the connector type. For information about the configuration properties, refer to <<action-types,Action and connector types>>.
 
 `secrets`::
-  (Required, object) The secrets configuration for the action. Secrets configuration properties vary
-  depending on the action type. For information about the secrets configuration properties, refer to <<action-types,Action and connector types>>.
+  (Required, object) The secrets configuration for the connector. Secrets configuration properties vary
+  depending on the connector type. For information about the secrets configuration properties, refer to <<action-types,Action and connector types>>.
 +
 WARNING: Remember these values. You must provide them each time you call the <<actions-and-connectors-api-update, update>> API.
 
@@ -49,10 +49,10 @@ WARNING: Remember these values. You must provide them each time you call the <<a
 
 [source,sh]
 --------------------------------------------------
-$ curl -X POST api/actions/action  -H 'kbn-xsrf: true' -H 'Content-Type: application/json' -d '
+$ curl -X POST api/actions/connector  -H 'kbn-xsrf: true' -H 'Content-Type: application/json' -d '
 {
-  "name": "my-action",
-  "actionTypeId": ".index",
+  "name": "my-connector",
+  "connector_type_id": ".index",
   "config": {
     "index": "test-index"
   }
@@ -66,13 +66,13 @@ The API returns the following:
 --------------------------------------------------
 {
   "id": "c55b6eb0-6bad-11eb-9f3b-611eebc6c3ad",
-  "actionTypeId": ".index",
-  "name": "my-action",
+  "connector_type_id": ".index",
+  "name": "my-connector",
   "config": {
     "index": "test-index",
     "refresh": false,
     "executionTimeField": null
   },
-  "isPreconfigured": false
+  "is_preconfigured": false
 }
 --------------------------------------------------

docs/api/actions-and-connectors/delete.asciidoc

@@ -1,25 +1,25 @@
 [[actions-and-connectors-api-delete]]
-=== Delete action API
+=== Delete connector API
 ++++
-<titleabbrev>Delete action API</titleabbrev>
+<titleabbrev>Delete connector API</titleabbrev>
 ++++
 
-Deletes an action by ID.
+Deletes an connector by ID.
 
-WARNING: When you delete an action, _it cannot be recovered_.
+WARNING: When you delete a connector, _it cannot be recovered_.
 
 [[actions-and-connectors-api-delete-request]]
 ==== Request
 
-`DELETE <kibana host>:<port>/api/actions/action/<id>`
+`DELETE <kibana host>:<port>/api/actions/connector/<id>`
 
-`DELETE <kibana host>:<port>/s/<space_id>/api/actions/action/<id>`
+`DELETE <kibana host>:<port>/s/<space_id>/api/actions/connector/<id>`
 
 [[actions-and-connectors-api-delete-path-params]]
 ==== Path parameters
 
 `id`::
-  (Required, string) The ID of the action.
+  (Required, string) The ID of the connector.
 
 `space_id`::
   (Optional, string) An identifier for the space. If `space_id` is not provided in the URL, the default space is used.
@@ -34,6 +34,6 @@ WARNING: When you delete an action, _it cannot be recovered_.
 
 [source,sh]
 --------------------------------------------------
-$ curl -X DELETE api/actions/action/c55b6eb0-6bad-11eb-9f3b-611eebc6c3ad
+$ curl -X DELETE api/actions/connector/c55b6eb0-6bad-11eb-9f3b-611eebc6c3ad
 --------------------------------------------------
 // KIBANA

docs/api/actions-and-connectors/execute.asciidoc

@@ -1,23 +1,23 @@
 [[actions-and-connectors-api-execute]]
-=== Execute action API
+=== Execute connector API
 ++++
-<titleabbrev>Execute action API</titleabbrev>
+<titleabbrev>Execute connector API</titleabbrev>
 ++++
 
-Executes an action by ID.
+Executes an connector by ID.
 
 [[actions-and-connectors-api-execute-request]]
 ==== Request
 
-`POST <kibana host>:<port>/api/actions/action/<id>/_execute`
+`POST <kibana host>:<port>/api/actions/connector/<id>/_execute`
 
-`POST <kibana host>:<port>/s/<space_id>/api/actions/action/<id>/_execute`
+`POST <kibana host>:<port>/s/<space_id>/api/actions/connector/<id>/_execute`
 
 [[actions-and-connectors-api-execute-params]]
 ==== Path parameters
 
 `id`::
-  (Required, string) The ID of the action.
+  (Required, string) The ID of the connector.
 
 `space_id`::
   (Optional, string) An identifier for the space. If `space_id` is not provided in the URL, the default space is used.
@@ -26,8 +26,8 @@ Executes an action by ID.
 ==== Request body
 
 `params`::
-  (Required, object) The parameters of the action. Parameter properties vary depending on
-  the action type. For information about the parameter properties, refer to <<action-types,Action and connector types>>.
+  (Required, object) The parameters of the connector. Parameter properties vary depending on
+  the connector type. For information about the parameter properties, refer to <<action-types,Action and connector types>>.
 
 [[actions-and-connectors-api-execute-codes]]
 ==== Response code
@@ -40,7 +40,7 @@ Executes an action by ID.
 
 [source,sh]
 --------------------------------------------------
-$ curl -X POST api/actions/action/c55b6eb0-6bad-11eb-9f3b-611eebc6c3ad/_execute  -H 'kbn-xsrf: true' -H 'Content-Type: application/json' -d '
+$ curl -X POST api/actions/connector/c55b6eb0-6bad-11eb-9f3b-611eebc6c3ad/_execute  -H 'kbn-xsrf: true' -H 'Content-Type: application/json' -d '
 {
   "params": {
     "documents": [
@@ -83,6 +83,6 @@ The API returns the following:
       }
     ]
   },
-  "actionId": "c55b6eb0-6bad-11eb-9f3b-611eebc6c3ad"
+  "connector_id": "c55b6eb0-6bad-11eb-9f3b-611eebc6c3ad"
 }
 --------------------------------------------------

docs/api/actions-and-connectors/get.asciidoc

@@ -1,23 +1,23 @@
 [[actions-and-connectors-api-get]]
-=== Get action API
+=== Get connector API
 ++++
-<titleabbrev>Get action API</titleabbrev>
+<titleabbrev>Get connector API</titleabbrev>
 ++++
 
-Retrieves an action by ID.
+Retrieves an connector by ID.
 
 [[actions-and-connectors-api-get-request]]
 ==== Request
 
-`GET <kibana host>:<port>/api/actions/action/<id>`
+`GET <kibana host>:<port>/api/actions/connector/<id>`
 
-`GET <kibana host>:<port>/s/<space_id>/api/actions/action/<id>`
+`GET <kibana host>:<port>/s/<space_id>/api/actions/connector/<id>`
 
 [[actions-and-connectors-api-get-params]]
 ==== Path parameters
 
 `id`::
-  (Required, string) The ID of the action.
+  (Required, string) The ID of the connector.
 
 `space_id`::
   (Optional, string) An identifier for the space. If `space_id` is not provided in the URL, the default space is used.
@@ -33,7 +33,7 @@ Retrieves an action by ID.
 
 [source,sh]
 --------------------------------------------------
-$ curl -X GET api/actions/action/c55b6eb0-6bad-11eb-9f3b-611eebc6c3ad
+$ curl -X GET api/actions/connector/c55b6eb0-6bad-11eb-9f3b-611eebc6c3ad
 --------------------------------------------------
 // KIBANA
 
@@ -43,13 +43,13 @@ The API returns the following:
 --------------------------------------------------
 {
   "id": "c55b6eb0-6bad-11eb-9f3b-611eebc6c3ad",
-  "actionTypeId": ".index",
-  "name": "my-action",
+  "connector_type_id": ".index",
+  "name": "my-connector",
   "config": {
     "index": "test-index",
     "refresh": false,
     "executionTimeField": null
   },
-  "isPreconfigured": false
+  "is_preconfigured": false
 }
 --------------------------------------------------

docs/api/actions-and-connectors/get_all.asciidoc

@@ -4,14 +4,14 @@
 <titleabbrev>Get all actions API</titleabbrev>
 ++++
 
-Retrieves all actions.
+Retrieves all connectors.
 
 [[actions-and-connectors-api-get-all-request]]
 ==== Request
 
-`GET <kibana host>:<port>/api/actions`
+`GET <kibana host>:<port>/api/actions/connectors`
 
-`GET <kibana host>:<port>/s/<space_id>/api/actions`
+`GET <kibana host>:<port>/s/<space_id>/api/actions/connectors`
 
 [[actions-and-connectors-api-get-all-path-params]]
 ==== Path parameters
@@ -30,7 +30,7 @@ Retrieves all actions.
 
 [source,sh]
 --------------------------------------------------
-$ curl -X GET api/actions
+$ curl -X GET api/actions/connectors
 --------------------------------------------------
 // KIBANA
 
@@ -40,21 +40,23 @@ The API returns the following:
 --------------------------------------------------
 [
   {
-    "id": "preconfigured-mail-action",
-    "actionTypeId": ".email",
-    "name": "email: preconfigured-mail-action",
-    "isPreconfigured": true
+    "id": "preconfigured-mail-connector",
+    "connector_type_id": ".email",
+    "name": "email: preconfigured-mail-connector",
+    "is_preconfigured": true,
+    "referenced_by_count": 1
   },
   {
     "id": "c55b6eb0-6bad-11eb-9f3b-611eebc6c3ad",
-    "actionTypeId": ".index",
-    "name": "my-action",
+    "connector_type_id": ".index",
+    "name": "my-connector",
     "config": {
       "index": "test-index",
       "refresh": false,
       "executionTimeField": null
     },
-    "isPreconfigured": false
+    "is_preconfigured": false,
+    "referenced_by_count": 3
   }
 ]
 --------------------------------------------------