[8.x] "local" parameter only in compatible cat requests (#3096)

[pquentin]

Backport

This will backport the following commits from main to 8.x:

• "local" parameter only in compatible cat requests (#3096)

Questions ?

Please refer to the Backport tool documentation

[github-actions]

Following you can find the validation results for the APIs you have changed.

API	Status	Request	Response
cat.allocation	🟢	12/12	12/12
cat.component_templates	⚪	Missing test	Missing test
cat.master	🟢	1/1	1/1
cat.nodeattrs	🟢	5/5	5/5
cat.pending_tasks	🟢	1/1	1/1
cat.plugins	🟢	2/2	2/2
cat.segments	🟢	9/9	9/9
cat.templates	🟢	17/17	17/17
cat.thread_pool	🟢	9/9	9/9

You can validate these APIs yourself by using the make validate target.

[github-actions]

Following you can find the validation results for the APIs you have changed.

API	Status	Request	Response
cat.aliases	🟢	30/30	30/30
cat.allocation	🟢	12/12	12/12
cat.component_templates	⚪	Missing test	Missing test
cat.master	🟢	1/1	1/1
cat.nodeattrs	🟢	5/5	5/5
cat.pending_tasks	🟢	1/1	1/1
cat.plugins	🟢	2/2	2/2
cat.segments	🟢	9/9	9/9
cat.templates	🟢	17/17	17/17
cat.thread_pool	🟢	9/9	9/9

You can validate these APIs yourself by using the make validate target.

[pquentin]

Here's proof that this pull request applies to 8.x. I've also added local to cat aliases since it's supported in 8.x (but not in 9.0).

$ cd server/src/main/java/org/elasticsearch/rest/action/cat
$ grep 'paramAsBoolean("local"' *.java
RestAliasAction.java:            final var localParam = request.paramAsBoolean("local", false);
RestAllocationAction.java:        clusterStateRequest.local(request.paramAsBoolean("local", clusterStateRequest.local()));
RestCatComponentTemplateAction.java:        clusterStateRequest.local(request.paramAsBoolean("local", clusterStateRequest.local()));
RestMasterAction.java:        clusterStateRequest.local(request.paramAsBoolean("local", clusterStateRequest.local()));
RestNodeAttrsAction.java:        clusterStateRequest.local(request.paramAsBoolean("local", clusterStateRequest.local()));
RestPendingClusterTasksAction.java:        pendingClusterTasksRequest.local(request.paramAsBoolean("local", pendingClusterTasksRequest.local()));
RestPluginsAction.java:        clusterStateRequest.local(request.paramAsBoolean("local", clusterStateRequest.local()));
RestRepositoriesAction.java:        getRepositoriesRequest.local(request.paramAsBoolean("local", getRepositoriesRequest.local()));
RestSegmentsAction.java:        clusterStateRequest.local(request.paramAsBoolean("local", clusterStateRequest.local()));
RestTemplatesAction.java:        getIndexTemplatesRequest.local(request.paramAsBoolean("local", getIndexTemplatesRequest.local()));
RestTemplatesAction.java:        getComposableTemplatesRequest.local(request.paramAsBoolean("local", getComposableTemplatesRequest.local()));
RestThreadPoolAction.java:        clusterStateRequest.local(request.paramAsBoolean("local", clusterStateRequest.local()));