…97936) (#201154)
# Backport
This will backport the following commits from `main` to `8.x`:
- [Changes deprecated SO HTTP APIs deprecation field to object
(#197936)](#197936)
<!--- Backport version: 8.9.8 -->
### Questions ?
Please refer to the [Backport tool
documentation](https://github.com/sqren/backport)
<!--BACKPORT [{"author":{"name":"Christiane (Tina)
Heiligers","email":"christiane.heiligers@elastic.co"},"sourceCommit":{"committedDate":"2024-11-07T20:49:05Z","message":"Changes
deprecated SO HTTP APIs deprecation field to object (#197936)\n\nfix
https://github.com/elastic/kibana/issues/197721.\r\n\r\nThe route
deprecation field changed from a boolean to an object, where\r\nthe
object contains information that is used in deprecation issues
that\r\nthe Upgrade Assistant shows.\r\n\r\nThis PR makes the necessary
changes in the deprecated Saved Objects HTTP\r\nAPIs.\r\n\r\nThis PR
also includes a release notes entry for the API deprecations\r\nthat was
missing.\r\n\r\n\r\n###
Checklist\r\n\r\n- [x] Any text added follows [EUI's
writing\r\nguidelines](https://elastic.github.io/eui/#/guidelines/writing),
uses\r\nsentence case text and includes
[i18n\r\nsupport](https://github.com/elastic/kibana/blob/main/packages/kbn-i18n/README.md)\r\n-
[x]\r\n[Documentation](https://www.elastic.co/guide/en/kibana/master/development-documentation.html)\r\nwas
added for features that require explanation or tutorials\r\n- [x] [Unit
or
functional\r\ntests](https://www.elastic.co/guide/en/kibana/master/development-tests.html)\r\nwere
updated or added to match the most common scenarios\r\n\r\n\r\n### How
to test this:\r\n\r\n- Pull PR, run es against a trial license and start
kibana as usual.\r\n- Make a curl request to Kibana to get the config
saved object: \r\n\r\n```\r\ncurl --location
'localhost:5601/abc/api/saved_objects/config/9.0.0' \\\r\n--header
'Content-Type: application/json' \\\r\n--header 'Accept-Encoding: gzip,
deflate, br' \\\r\n--header 'kbn-xsrf: kibana' \\\r\n--header
'Kbn-Version: 9.0.0' \\\r\n--header 'Authorization: Basic
ZWxhc3RpYzpjaGFuZ2VtZQ=='\r\n```\r\n\r\n- Navigate to Upgrade Assistant
and observe Kibana has at least 1\r\ndeprecation warning.\r\n- View
Kibana's warnings, you should see a warning entry for `The
\"GET\r\n/api/saved_objects/{type}/{id}\" route is
deprecated`\r\n\r\n\r\n\r\n-
click on the deprecation and you should see more detail about
the\r\ndeprecated API that's been used in the
flyout:\r\n\r\n\r\n\r\n-
resolve the deprecation warning\r\n- Kibana should continue to issue
requests to the deprecated SO HTTP\r\nAPIs because these APIs have not
been removed yet.\r\n\r\n\r\n### Risk Matrix\r\n\r\n| Risk | Probability
| Severity | Mitigation/Notes
|\r\n\r\n|---------------------------|-------------|----------|-------------------------|\r\n|
End user concern from the deprecation warning that says the
routes\r\nhave been deprecated | Low | Low | The APIs have been
deprecated since\r\n8.7 and recommends using public APIs instead.
|\r\n\r\n### For maintainers\r\n\r\n- [x] This will appear in the
**Release Notes** and follow
the\r\n[guidelines](https://www.elastic.co/guide/en/kibana/master/contributing.html#kibana-release-notes-process)\r\n\r\n---------\r\n\r\nCo-authored-by:
Elastic Machine
<elasticmachine@users.noreply.github.com>\r\nCo-authored-by:
kibanamachine
<42973632+kibanamachine@users.noreply.github.com>","sha":"0df2e9838119d202eba0c6b2bcb7068b160f6005","branchLabelMapping":{"^v9.0.0$":"main","^v8.17.0$":"8.x","^v(\\d+).(\\d+).\\d+$":"$1.$2"}},"sourcePullRequest":{"labels":["release_note:deprecation","Team:Core","Feature:Saved
Objects","backport
missing","v9.0.0","docs","backport:prev-minor","Epic:Deprecations","Feature:OAS","v8.17.0"],"number":197936,"url":"https://github.com/elastic/kibana/pull/197936","mergeCommit":{"message":"Changes
deprecated SO HTTP APIs deprecation field to object (#197936)\n\nfix
https://github.com/elastic/kibana/issues/197721.\r\n\r\nThe route
deprecation field changed from a boolean to an object, where\r\nthe
object contains information that is used in deprecation issues
that\r\nthe Upgrade Assistant shows.\r\n\r\nThis PR makes the necessary
changes in the deprecated Saved Objects HTTP\r\nAPIs.\r\n\r\nThis PR
also includes a release notes entry for the API deprecations\r\nthat was
missing.\r\n\r\n\r\n###
Checklist\r\n\r\n- [x] Any text added follows [EUI's
writing\r\nguidelines](https://elastic.github.io/eui/#/guidelines/writing),
uses\r\nsentence case text and includes
[i18n\r\nsupport](https://github.com/elastic/kibana/blob/main/packages/kbn-i18n/README.md)\r\n-
[x]\r\n[Documentation](https://www.elastic.co/guide/en/kibana/master/development-documentation.html)\r\nwas
added for features that require explanation or tutorials\r\n- [x] [Unit
or
functional\r\ntests](https://www.elastic.co/guide/en/kibana/master/development-tests.html)\r\nwere
updated or added to match the most common scenarios\r\n\r\n\r\n### How
to test this:\r\n\r\n- Pull PR, run es against a trial license and start
kibana as usual.\r\n- Make a curl request to Kibana to get the config
saved object: \r\n\r\n```\r\ncurl --location
'localhost:5601/abc/api/saved_objects/config/9.0.0' \\\r\n--header
'Content-Type: application/json' \\\r\n--header 'Accept-Encoding: gzip,
deflate, br' \\\r\n--header 'kbn-xsrf: kibana' \\\r\n--header
'Kbn-Version: 9.0.0' \\\r\n--header 'Authorization: Basic
ZWxhc3RpYzpjaGFuZ2VtZQ=='\r\n```\r\n\r\n- Navigate to Upgrade Assistant
and observe Kibana has at least 1\r\ndeprecation warning.\r\n- View
Kibana's warnings, you should see a warning entry for `The
\"GET\r\n/api/saved_objects/{type}/{id}\" route is
deprecated`\r\n\r\n\r\n\r\n-
click on the deprecation and you should see more detail about
the\r\ndeprecated API that's been used in the
flyout:\r\n\r\n\r\n\r\n-
resolve the deprecation warning\r\n- Kibana should continue to issue
requests to the deprecated SO HTTP\r\nAPIs because these APIs have not
been removed yet.\r\n\r\n\r\n### Risk Matrix\r\n\r\n| Risk | Probability
| Severity | Mitigation/Notes
|\r\n\r\n|---------------------------|-------------|----------|-------------------------|\r\n|
End user concern from the deprecation warning that says the
routes\r\nhave been deprecated | Low | Low | The APIs have been
deprecated since\r\n8.7 and recommends using public APIs instead.
|\r\n\r\n### For maintainers\r\n\r\n- [x] This will appear in the
**Release Notes** and follow
the\r\n[guidelines](https://www.elastic.co/guide/en/kibana/master/contributing.html#kibana-release-notes-process)\r\n\r\n---------\r\n\r\nCo-authored-by:
Elastic Machine
<elasticmachine@users.noreply.github.com>\r\nCo-authored-by:
kibanamachine
<42973632+kibanamachine@users.noreply.github.com>","sha":"0df2e9838119d202eba0c6b2bcb7068b160f6005"}},"sourceBranch":"main","suggestedTargetBranches":["8.17"],"targetPullRequestStates":[{"branch":"main","label":"v9.0.0","labelRegex":"^v9.0.0$","isSourceBranch":true,"state":"MERGED","url":"https://github.com/elastic/kibana/pull/197936","number":197936,"mergeCommit":{"message":"Changes
deprecated SO HTTP APIs deprecation field to object (#197936)\n\nfix
https://github.com/elastic/kibana/issues/197721.\r\n\r\nThe route
deprecation field changed from a boolean to an object, where\r\nthe
object contains information that is used in deprecation issues
that\r\nthe Upgrade Assistant shows.\r\n\r\nThis PR makes the necessary
changes in the deprecated Saved Objects HTTP\r\nAPIs.\r\n\r\nThis PR
also includes a release notes entry for the API deprecations\r\nthat was
missing.\r\n\r\n\r\n###
Checklist\r\n\r\n- [x] Any text added follows [EUI's
writing\r\nguidelines](https://elastic.github.io/eui/#/guidelines/writing),
uses\r\nsentence case text and includes
[i18n\r\nsupport](https://github.com/elastic/kibana/blob/main/packages/kbn-i18n/README.md)\r\n-
[x]\r\n[Documentation](https://www.elastic.co/guide/en/kibana/master/development-documentation.html)\r\nwas
added for features that require explanation or tutorials\r\n- [x] [Unit
or
functional\r\ntests](https://www.elastic.co/guide/en/kibana/master/development-tests.html)\r\nwere
updated or added to match the most common scenarios\r\n\r\n\r\n### How
to test this:\r\n\r\n- Pull PR, run es against a trial license and start
kibana as usual.\r\n- Make a curl request to Kibana to get the config
saved object: \r\n\r\n```\r\ncurl --location
'localhost:5601/abc/api/saved_objects/config/9.0.0' \\\r\n--header
'Content-Type: application/json' \\\r\n--header 'Accept-Encoding: gzip,
deflate, br' \\\r\n--header 'kbn-xsrf: kibana' \\\r\n--header
'Kbn-Version: 9.0.0' \\\r\n--header 'Authorization: Basic
ZWxhc3RpYzpjaGFuZ2VtZQ=='\r\n```\r\n\r\n- Navigate to Upgrade Assistant
and observe Kibana has at least 1\r\ndeprecation warning.\r\n- View
Kibana's warnings, you should see a warning entry for `The
\"GET\r\n/api/saved_objects/{type}/{id}\" route is
deprecated`\r\n\r\n\r\n\r\n-
click on the deprecation and you should see more detail about
the\r\ndeprecated API that's been used in the
flyout:\r\n\r\n\r\n\r\n-
resolve the deprecation warning\r\n- Kibana should continue to issue
requests to the deprecated SO HTTP\r\nAPIs because these APIs have not
been removed yet.\r\n\r\n\r\n### Risk Matrix\r\n\r\n| Risk | Probability
| Severity | Mitigation/Notes
|\r\n\r\n|---------------------------|-------------|----------|-------------------------|\r\n|
End user concern from the deprecation warning that says the
routes\r\nhave been deprecated | Low | Low | The APIs have been
deprecated since\r\n8.7 and recommends using public APIs instead.
|\r\n\r\n### For maintainers\r\n\r\n- [x] This will appear in the
**Release Notes** and follow
the\r\n[guidelines](https://www.elastic.co/guide/en/kibana/master/contributing.html#kibana-release-notes-process)\r\n\r\n---------\r\n\r\nCo-authored-by:
Elastic Machine
<elasticmachine@users.noreply.github.com>\r\nCo-authored-by:
kibanamachine
<42973632+kibanamachine@users.noreply.github.com>","sha":"0df2e9838119d202eba0c6b2bcb7068b160f6005"}},{"branch":"8.x","label":"v8.17.0","labelRegex":"^v8.17.0$","isSourceBranch":false,"state":"NOT_CREATED"}]}]
BACKPORT-->
---------
Co-authored-by: Christiane (Tina) Heiligers <christiane.heiligers@elastic.co>
Co-authored-by: kibanamachine <42973632+kibanamachine@users.noreply.github.com>
fix #197721.
The route deprecation field changed from a boolean to an object, where the object contains information that is used in deprecation issues that the Upgrade Assistant shows.
This PR makes the necessary changes in the deprecated Saved Objects HTTP APIs.
This PR also includes a release notes entry for the API deprecations that was missing.

Checklist
How to test this:
The "GET /api/saved_objects/{type}/{id}" route is deprecatedRisk Matrix
For maintainers