Commit graph

49 commits

Author SHA1 Message Date
Lisa Cawley
a811538ee8
[OAS] Add Elasticsearch query rule parameters (#162001) 2023-07-19 10:46:39 -07:00
Alexi Doak
622d994584
[ResponseOps][Alerting] Add missing rule.params descriptions for Stack rules (#161807)
Resolves https://github.com/elastic/kibana/issues/161710

## Summary

Related to this issue: https://github.com/elastic/kibana/issues/161126

Added missing descriptions for the index threshold rule params.


### Checklist

- [x] Any text added follows [EUI's writing
guidelines](https://elastic.github.io/eui/#/guidelines/writing), uses
sentence case text and includes [i18n
support](https://github.com/elastic/kibana/blob/main/packages/kbn-i18n/README.md)
- [x] [Unit or functional
tests](https://www.elastic.co/guide/en/kibana/master/development-tests.html)
were updated or added to match the most common scenarios

---------

Co-authored-by: lcawl <lcawley@elastic.co>
Co-authored-by: Ying Mao <ying.mao@elastic.co>
2023-07-19 08:15:17 -04:00
Lisa Cawley
3a0c90d934
[DOCS] Clarify API key authorization for alerting (#161717) 2023-07-17 09:41:23 -07:00
Antonio
f43601d294
[Cases] Validate page and perPage parameters in find APIs (#161111)
Connected to https://github.com/elastic/kibana/issues/146945

## Summary

| Description  | Limit | Done? | Documented?
| ------------- | ---- | :---: | ---- |
| Total number of cases/user actions/comments per page | 100 |
 | No | N/A |
| Maximum number of cases/user actions/comments returned from the API |
10.000 |  | No | N/A |

### Checklist

Delete any items that are not applicable to this PR.

- [x] Any text added follows [EUI's writing
guidelines](https://elastic.github.io/eui/#/guidelines/writing), uses
sentence case text and includes [i18n
support](https://github.com/elastic/kibana/blob/main/packages/kbn-i18n/README.md)
- [x]
[Documentation](https://www.elastic.co/guide/en/kibana/master/development-documentation.html)
was added for features that require explanation or tutorials
- [x] [Unit or functional
tests](https://www.elastic.co/guide/en/kibana/master/development-tests.html)
were updated or added to match the most common scenarios

### Release Notes

Max value for perPage parameter in find Cases API is now 100.
Max value for perPage parameter in find User Actions API is now 100.
Max value for perPage parameter in find Comments API is now 100.

---------

Co-authored-by: kibanamachine <42973632+kibanamachine@users.noreply.github.com>
Co-authored-by: lcawl <lcawley@elastic.co>
2023-07-05 13:33:09 +02:00
Lisa Cawley
8a1902c66e
[OAS] Add default spaces to case paths (#160831) 2023-06-29 08:41:58 -07:00
Lisa Cawley
418fbb1aa6
[Security solution] Generative AI Connector API specification (#158423)
Co-authored-by: Steph Milovic <stephanie.milovic@elastic.co>
2023-06-27 15:03:36 -07:00
Lisa Cawley
e38d08c91a
[DOCS] Fix create rule open API specification (#157950) 2023-06-26 07:39:11 -07:00
Janki Salvi
de3f8fca00
[Cases] Limit perPage param in findComments API (#160042)
## Summary

This PR limits `perPage` param to 100 in `findComments`  API.

### Checklist

- [x]
[Documentation](https://www.elastic.co/guide/en/kibana/master/development-documentation.html)
was added for features that require explanation or tutorials
- [x] [Unit or functional
tests](https://www.elastic.co/guide/en/kibana/master/development-tests.html)
were updated or added to match the most common scenarios

---------

Co-authored-by: lcawl <lcawley@elastic.co>
Co-authored-by: kibanamachine <42973632+kibanamachine@users.noreply.github.com>
2023-06-21 15:00:25 +02:00
Antonio
599e2311a6
[Cases] Limit category filter in find cases API (#159989)
## Summary

This PR limits the number of categories by which we can filter calls to
the find cases API.

The limit is now 100.

---------

Co-authored-by: lcawl <lcawley@elastic.co>
2023-06-21 09:09:07 +02:00
Julian Gernun
53465943b0
[RAM] [Docs] Add rule type param references (#159186)
## Summary

Links param parameter OAS to alerting rules documentation

---------

Co-authored-by: lcawl <lcawley@elastic.co>
2023-06-19 12:37:01 +02:00
Lisa Cawley
b6a2611361
[DOCS] Conditional actions in rule open API specifications (#157951) 2023-06-09 08:33:43 -07:00
Lisa Cawley
2795ac894b
[DOCS] Add revision to alerts schema (#157938) 2023-05-18 11:42:14 -07:00
Lisa Cawley
1cb0ee6d72
[DOCS] Add UUID to rule actions (#157942) 2023-05-17 18:43:20 -07:00
Lisa Cawley
60513d3fe9
[DOCS] Add api_key_created_by_user to alerting API specification (#158018) 2023-05-17 15:02:40 -07:00
Antonio
927743ae52
[Cases] Restrict the Find Comment API query params (#156863)
Fixes #155983

## Summary

This PR changes the accepted params for the Find Comments API to be only
`perPage`, `page` and `sort_order`.

---------

Co-authored-by: kibanamachine <42973632+kibanamachine@users.noreply.github.com>
Co-authored-by: lcawl <lcawley@elastic.co>
2023-05-16 09:25:54 -07:00
Antonio
2e0ba63e31
[Cases] Limit searchFields in the Find Case API query params (#156495)
Fixes #155978

## Summary

- Remove the `fields` parameter from the find cases API 
- Limit the `searchFields` parameter in the find cases API

One of the FTR tests was actually successfully calling the find_cases
API while passing the fields parameter but only certain combinations of
fields would actually work.

Passing single fields would not work.

I just removed the test as we won't support the `fields` param anymore.

---------

Co-authored-by: lcawl <lcawley@elastic.co>
2023-05-11 11:04:10 -04:00
Lisa Cawley
f7a3462808
[DOCS] Fix optional create connector id (#157031) 2023-05-09 07:20:30 -07:00
Lisa Cawley
d14ba925dd
[DOCS] Fix Slack connector open API specifications (#157026) 2023-05-08 11:50:32 -07:00
Julia
4dd6d1a277
[RAM] Docs for slack improvements (#153885)
## Summary

Docs for new Slack connector

### Preview


https://kibana_153885.docs-preview.app.elstc.co/guide/en/kibana/master/slack-action-type.html

---------

Co-authored-by: lcawl <lcawley@elastic.co>
Co-authored-by: kibanamachine <42973632+kibanamachine@users.noreply.github.com>
2023-05-05 09:32:45 +02:00
Mike Côté
5a4dd3fccd
Remove alerting_framework_heath from the alerting framework health API response (#154276)
Resolves https://github.com/elastic/kibana/issues/135035.

In this PR, I'm removing the deprecated attribute
`alerting_framework_heath` from the alerting framework health API.

## To verify

1. Start Kibana.
2. Call `/api/alerting/_health`.
3. Notice `alerting_framework_heath` is no longer part of the HTTP API
response.

---------

Co-authored-by: Kibana Machine <42973632+kibanamachine@users.noreply.github.com>
Co-authored-by: lcawl <lcawley@elastic.co>
2023-04-20 07:16:27 -04:00
Lisa Cawley
782a3d5e42
[DOCS] Add responses components in connector open API specification (#153136) 2023-03-28 19:28:43 -07:00
Lisa Cawley
b75b272a88
[DOCS] Add deprecation details to case APIs (#152033) 2023-02-28 18:17:02 +01:00
Lisa Cawley
903173dff1
[DOCS] Add summary capabilities to the open API specification (#149998) 2023-02-08 08:30:14 -08:00
Lisa Cawley
83c382b088
[DOCS] Add specifications for deprecated connector APIs (#149637) 2023-02-02 07:22:32 -08:00
Lisa Cawley
59488afa5d
[DOCS] Add specifications for deprecated alert APIs (#149655) 2023-02-02 07:21:43 -08:00
Lisa Cawley
502fb009cf
[DOCS] Lint case API specifications (#149641) 2023-01-31 12:01:00 -08:00
Lisa Cawley
7421a9737d
[DOCS] Create open API specification for create rule (#149565) 2023-01-26 18:07:23 -08:00
Lisa Cawley
f78236a2e4
[DOCS] Create open API specification for run connector (#149274) 2023-01-26 08:53:47 -08:00
Jonathan Buttner
a78fece18b
[Cases] Adding _find API for user actions (#148861)
This PR adds a new find API for retrieving a subset of the user actions
for a case.

Issue: https://github.com/elastic/kibana/issues/134344

```
GET /api/cases/<case_id>/user_actions/_find
Query Paramaters
{
  types?: Array of "assignees" | "comment" | "connector" | "description" | "pushed" | "tags" | "title" | "status" | "settings" | "severity" | "create_case" | "delete_case" | "action" | "alert" | "user" | "attachment"
  sortOrder?: "asc" | "desc"
  page?: number as a string
  perPage?: number as a string
}
```

<details><summary>Example request and response</summary>

Request
```
curl --location --request GET 'http://localhost:5601/api/cases/8df5fe00-96b1-11ed-9341-471c9630b5ec/user_actions/_find?types=create_case&sortOrder=asc' \
--header 'kbn-xsrf: hello' \
--header 'Authorization: Basic ZWxhc3RpYzpjaGFuZ2VtZQ==' \
--data-raw ''
```


Response
```
{
    "userActions": [
        {
            "created_at": "2023-01-17T21:54:45.527Z",
            "created_by": {
                "username": "elastic",
                "full_name": null,
                "email": null,
                "profile_uid": "u_mGBROF_q5bmFCATbLXAcCwKa0k8JvONAwSruelyKA5E_0"
            },
            "owner": "cases",
            "action": "create",
            "payload": {
                "title": "Awesome case",
                "tags": [],
                "severity": "low",
                "description": "super",
                "assignees": [],
                "connector": {
                    "name": "none",
                    "type": ".none",
                    "fields": null,
                    "id": "none"
                },
                "settings": {
                    "syncAlerts": false
                },
                "owner": "cases",
                "status": "open"
            },
            "type": "create_case",
            "id": "8e121180-96b1-11ed-9341-471c9630b5ec",
            "case_id": "8df5fe00-96b1-11ed-9341-471c9630b5ec",
            "comment_id": null
        }
    ],
    "page": 1,
    "perPage": 20,
    "total": 1
}
```

</details>

## Notable Changes
- Created the new `_find` route
- Created a new `UserActionFinder` class and moved the find* methods
from the `index.ts` file into there as well as the new find logic
- Extracted the transform logic to its own file since its shared between
multiple files now
- Extracted the user action related integration test functions to the
`user_action.ts` utility file

Co-authored-by: kibanamachine <42973632+kibanamachine@users.noreply.github.com>
Co-authored-by: lcawl <lcawley@elastic.co>
2023-01-23 13:25:41 -05:00
Lisa Cawley
fa68cb432b
[DOCS] Create OAS for get rule types and get alerting framework health (#148774) 2023-01-17 10:53:48 -07:00
Lisa Cawley
4f6d0dff28
[DOCS] Create open API specification for create/update connector (#148691) 2023-01-17 10:31:48 -07:00
Lisa Cawley
9e837b80dc
[DOCS] Add 401 responses to case API specifications (#148857) 2023-01-17 09:20:51 -07:00
Lisa Cawley
b174b1908f
[DOCS] Lint ML sync API specification (#148841) 2023-01-13 08:44:07 -08:00
Lisa Cawley
b254abaf08
[DOCS] Create open API specification for disable/enable rule and mute/unmute all alerts #148360 (#148494) 2023-01-10 17:01:16 -07:00
Lisa Cawley
a077a1d468
[DOCS] Create open API specification for delete/get connectors (#148360) 2023-01-10 10:58:58 -08:00
Lisa Cawley
d35296ea3b
[DOCS] Create open API specification for update rule (#147407) 2023-01-10 10:27:58 -07:00
Lisa Cawley
d862f46c2a
[DOCS] Create open API specification for find rules (#147061) 2022-12-12 11:36:44 -08:00
Lisa Cawley
e1227a3fe9
[DOCS] Add assignees query parameter to find cases API (#146087) 2022-11-29 08:46:49 -08:00
Lisa Cawley
94b67781e8
Add open API specification for list connector types (#145951) 2022-11-24 11:30:51 -07:00
Lisa Cawley
876f1b9ac8
[DOCS] Alert limit for cases (#145950) 2022-11-24 17:56:45 +01:00
Lisa Cawley
74198264e1
[DOCS] Clarify alertId and index in add comment API (#145189) 2022-11-18 17:56:37 +01:00
Lisa Cawley
5348e39a36
[DOCS] Automate final case APIs (#145007) 2022-11-14 19:19:40 -07:00
Lisa Cawley
6804cffc5f
[DOCS] Automate docs for get case APIs (#144950) 2022-11-10 08:27:33 -08:00
Lisa Cawley
9bf262dd1c
[DOCS] Automate docs for push case and case case config APIs (#144657) 2022-11-08 09:34:52 -08:00
Lisa Cawley
6eb02d096f
[DOCS] Add assignees to case APIs (#143610) 2022-10-20 11:32:10 -07:00
Lisa Cawley
f92c76c86f
[DOCS] Automate docs for create/update/delete case APIs (#142929) 2022-10-18 16:09:57 -07:00
Lisa Cawley
2d8b29ed5a
[DOCS] Automate output for 4 case APIs (#142173) 2022-10-05 09:24:04 -07:00
Lisa Cawley
1be987e66a
[DOCS] Link to open API specification from ML sync API (#142136) 2022-09-29 08:29:07 -07:00
Lisa Cawley
74d39d87d8
[DOCS] Add ML open API output to appendix (#141556) 2022-09-26 11:00:00 -07:00