Add is_hidden parameter for create or update alias API

[gaobinlong]

Description

In this PR, we fix the bug of create or update alias API doesn't throw exception for unsupported parameters, and also add the missing request body parameter is_hidden, so we need to update the api specification.

By submitting this pull request, I confirm that my contribution is made under the terms of the Apache 2.0 license.
For more information on following Developer Certificate of Origin and signing off your commits, please check here.

[github-actions]

Changes Analysis

Commit SHA: f60bfdc
Comparing To SHA: 82c000f

API Changes

Summary

└─┬Paths
  ├─┬/{index}/_aliases/{name}
  │ ├─┬PUT
  │ │ └─┬Requestbody
  │ │   └─┬application/json
  │ │     └─┬Schema
  │ │       └──[➕] properties (21954:15)
  │ └─┬POST
  │   └─┬Requestbody
  │     └─┬application/json
  │       └─┬Schema
  │         └──[➕] properties (21954:15)
  └─┬/{index}/_alias/{name}
    ├─┬PUT
    │ └─┬Requestbody
    │   └─┬application/json
    │     └─┬Schema
    │       └──[➕] properties (21954:15)
    └─┬POST
      └─┬Requestbody
        └─┬application/json
          └─┬Schema
            └──[➕] properties (21954:15)

Document Element	Total Changes	Breaking Changes
paths	4	0

• Total Changes: 4
• Additions: 4

Report

The full API changes report is available at: https://github.com/opensearch-project/opensearch-api-specification/actions/runs/9985179729/artifacts/1713469909

API Coverage

	Before	After	Δ
Covered (%)	483 (47.31 %)	483 (47.31 %)	0 (0 %)
Uncovered (%)	538 (52.69 %)	538 (52.69 %)	0 (0 %)
Unknown	24	24	0

[dblock]

Thanks! See below.

So the tests for <= 2.15 pass because we weren't checking parameters? Do update them to have the correct version if there are fields used in tests against a version that doesn't support them, so we don't imply they can work.

[dblock]

Make it look like the rest of the lines.

"Added is_hidden to /{index}/_alias/ (#...)"

[dblock]

Add default: false, and no need to say "defaults to ..." in the text. We're going to clean these up at some point.

[dblock]

We already have alias.yaml that has a lot of similar tests. Either add one more test for is_hidden there, or create a folder called tests/indices/alias/is_hidden.yaml and include only functionality related to this new is_hidden into it. I think the former seems simpler.

You also need to add version: '>= 2.16' into the test so it doesn't run with older OpenSearch (I expect it to fail).

[gaobinlong]

Thanks @dblock , please help to take a look at the new change.

Requested changes have been made