[ResponseOps][Rules] Removal of deprecated Rules APIs

[cnasikas]

In 7.13 we deprecate the following APIs:

Create rule: POST /api/alerts/alert/
Get rule: GET /api/alerts/alert/
Update rule: PUT /api/alerts/alert/
Delete rule: DELETE: /api/alerts/alert/
Disable rule: POST /api/alerts/alert//_disable
Enable rule: POST /api/alerts/alert//_enable
Find rules: GET /api/alerts/_find
Get Alerting framework health: GET /api/alerts/_health
Get alert instance summary: GET /api/alerts//_instance_summary
Get alert state: GET /api/alerts//state
List rule types: GET /api/alerts/list_alert_types
Mute alert: POST /api/alerts/alert/<alert_id>/alert_instance/<alert_instance_id>/_mute
Unmute alert: POST /api/alerts/alert/<alert_id>/alert_instance/<alert_instance_id>/_unmute
Mute all alerts: POST /api/alerts/alert//_mute_all
Unmute all alerts: POST /api/alerts/alert//_unmute_all
Update API key: POST /api/alerts/alert//_update_api_key

In 9.0 we should remove the deprecated APIs. Alternatives can be found here.

[elasticmachine]

Pinging @elastic/response-ops (Team:ResponseOps)

[jcger]

I've seen also this issue mentioning adding a deprecated object #196095. Should we add deprecated info or delete them?

[cnasikas]

Good point @jcger! We should add the deprecated object in 8.17/8.18 so users are being informed.

[cnasikas]

Could you please create an issue about it and add it as a sub-issue here? Same for the Cases APIs here #194266.

[jcger]

Done, here are the links:
for rules: #196556
for cases: #196557

[jcger]

It's POST _update_api_key instead of PUT _update_api_key, right? https://github.com/elastic/kibana/blob/main/x-pack/plugins/alerting/server/routes/legacy/update_api_key.ts#L28

[cnasikas]

Correct, my mistake. I corrected it.

[lcawl]

The API documentation is affected by this issue and I believe those endpoints are all manually-maintained in https://github.com/elastic/kibana/blob/main/x-pack/plugins/alerting/docs/openapi/entrypoint.yaml

... so it'll just be a matter of removing the appropriate endpoints from that file (or removing individual operations from the files it points to) then re-generating the bundle per the readme. If there are none left in the bundle (hooray) we can delete that whole folder and remove it from https://github.com/elastic/kibana/blob/main/oas_docs/scripts/merge_ess_oas.js