New Java client does not have all fields for CreateApiKeyRequest.RoleDescriptor

[synox]

Elasticsearch version (bin/elasticsearch --version):
7.16.2

Plugins installed: []

JVM version (java -version):
openjdk 17

OS version (uname -a if on a Unix-like system):
not relevant

Description of the problem including expected versus actual behavior:
The description in https://www.elastic.co/guide/en/elasticsearch/reference/current/security-api-put-role.html mentions fields like indices, global and run_as which are not defined in the Java client

They are also not defined in the service specification.

However, the are defined in the elasticsearch-rest-high-level-client.

I am using the wrong Java API to create an api key? Or should the spec and/or docs be updated?

Steps to reproduce:

Provide logs (if relevant):

[elasticmachine]

Pinging @elastic/es-data-management (Team:Data Management)

[synox]

I think this is actually a documentation error. The page https://www.elastic.co/guide/en/elasticsearch/reference/current/security-api-create-api-key.html describes the field role_descriptors with

The structure of role descriptor is the same as the request for create role API. For more details, see create or update roles API.

According to service specification the structure of those role descriptor are not the same. Also the example on the same page uses index and not indices.

[swallez]

The API specification is actually wrong, and these are the same structure. Elasticsearch accepts both index and indices, which led to this confusion.

elastic/elasticsearch-specification#1555 has been opened to solve this, and the Java client will be updated once it's fixed.

[swallez]

This has been fixed in PR #292, backported to version 8.2 in PR #293 and to version 7.17 in PR #294.