[Feedback]: Missing required cluster privileges

[andreabucci]

Hello, Team!

Our documentation mentions that HEAD /_template/{name} requires the cluster privilege manage_index_templates, but HEAD /_index_template/{name} does not list it:

https://www.elastic.co/docs/api/doc/elasticsearch/operation/operation-indices-exists-index-template
https://www.elastic.co/docs/api/doc/elasticsearch/operation/operation-indices-exists-template

However, lacking this permission throws a 403/Forbidden error.

Can we please update the _index_template page with the information below?

Required authorization
Cluster privileges: manage_index_templates

Steps to test/reproduce:

1. Create an index_template:

PUT _index_template/my_template
{
  "index_patterns": ["my-index-*"],
  "template": {
    "settings": {
      "number_of_shards": 1
    },
    "mappings": {
      "properties": {
        "timestamp": {
          "type": "date"
        },
        "mensagem": {
          "type": "text"
        }
      }
    }
  },
  "priority": 1
}

2. Execute HEAD _index_template/my_template with a different/unprivileged user. This will throw the 403 - Forbidden.

3. Add the cluster privilege manage_index_templates to a role attached to the user.

4. Execute HEAD _index_template/my_template again. It will now return 200 - OK.

Thank you!

[kilfoyle]

Thanks a lot for opening this @andreabucci!

@elastic/developer-docs I'm not sure if this should be Dev Docs or Admin Docs. Based on the related Slack thread I've opted for the former, but please feel free to re-assign if I've got it all wrong. :-)

I've removed the community label since that's for non-Elastic contributers.

[kosabogi]

Thanks a lot for opening this @andreabucci!

@elastic/developer-docs I'm not sure if this should be Dev Docs or Admin Docs. Based on the related Slack thread I've opted for the former, but please feel free to re-assign if I've got it all wrong. :-)

I've removed the community label since that's for non-Elastic contributers.

Hi David, I'll take care of this, thank you! 🍃