Add filecache support in clear indices cache API

[kotwanikunal]

Description

• Adds a new parameter file support to clear out filecache for indices using the clear indices cache API
• This PR replaces Add API for clearing file cache on search nodes #7323

Related Issues

Resolves #6030

Check List

• New functionality includes testing.
  • All tests pass
• New functionality has been documented.
  • New functionality has javadoc added
• Commits are signed per the DCO using --signoff
• Commit changes are listed out in CHANGELOG.md file (See: Changelog)

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.

[kotwanikunal]

@andrross / @reta I created a new PR since there were a bunch of changes.

[github-actions]

Gradle Check (Jenkins) Run Completed with:

• RESULT: FAILURE ❌
• URL: https://build.ci.opensearch.org/job/gradle-check/15162/
• CommitID: f2058ab
  Please examine the workflow log, locate, and copy-paste the failure(s) below, then iterate to green.
  Is the failure a flaky test unrelated to your change?

[github-actions]

Gradle Check (Jenkins) Run Completed with:

• RESULT: UNSTABLE ❕
• TEST FAILURES:

      2 org.opensearch.common.util.concurrent.QueueResizableOpenSearchThreadPoolExecutorTests.classMethod
      1 org.opensearch.common.util.concurrent.QueueResizableOpenSearchThreadPoolExecutorTests.testResizeQueueDown

• URL: https://build.ci.opensearch.org/job/gradle-check/15163/
• CommitID: b004da9
  Please review all flaky tests that succeeded after retry and create an issue if one does not already exist to track the flaky failure.

[codecov-commenter]

Codecov Report

Merging #7498 (c829953) into main (804bef4) will decrease coverage by 0.04%.
The diff coverage is 53.84%.

❗ Current head c829953 differs from pull request most recent head d85292e. Consider uploading reports for the commit d85292e to get more accurate results

@@             Coverage Diff              @@
##               main    #7498      +/-   ##
============================================
- Coverage     70.61%   70.57%   -0.04%     
+ Complexity    59794    59776      -18     
============================================
  Files          4896     4897       +1     
  Lines        286899   286805      -94     
  Branches      41350    41336      -14     
============================================
- Hits         202585   202405     -180     
- Misses        67633    67737     +104     
+ Partials      16681    16663      -18     

Impacted Files	Coverage Δ
...s/cache/clear/ClearIndicesCacheRequestBuilder.java	16.66% <0.00%> (-3.34%)	⬇️
.../cache/clear/TransportClearIndicesCacheAction.java	27.27% <16.66%> (-3.98%)	⬇️
.../indices/cache/clear/ClearIndicesCacheRequest.java	55.26% <50.00%> (-1.41%)	⬇️
...earch/index/store/remote/utils/cache/LRUCache.java	91.87% <50.00%> (-0.54%)	⬇️
...rg/opensearch/client/IndicesRequestConverters.java	71.03% <100.00%> (+0.36%)	⬆️
...search/index/store/remote/filecache/FileCache.java	72.05% <100.00%> (+0.41%)	⬆️
...ndex/store/remote/utils/cache/RefCountedCache.java	100.00% <100.00%> (ø)
...index/store/remote/utils/cache/SegmentedCache.java	88.46% <100.00%> (+0.46%)	⬆️
...ion/admin/indices/RestClearIndicesCacheAction.java	60.00% <100.00%> (+2.85%)	⬆️

... and 502 files with indirect coverage changes

[github-actions]

Gradle Check (Jenkins) Run Completed with:

• RESULT: FAILURE ❌
• URL: https://build.ci.opensearch.org/job/gradle-check/15175/
• CommitID: 38dcb96
  Please examine the workflow log, locate, and copy-paste the failure(s) below, then iterate to green.
  Is the failure a flaky test unrelated to your change?

[github-actions]

Gradle Check (Jenkins) Run Completed with:

• RESULT: SUCCESS ✅
• URL: https://build.ci.opensearch.org/job/gradle-check/15177/
• CommitID: 38dcb96

[github-actions]

Gradle Check (Jenkins) Run Completed with:

• RESULT: FAILURE ❌
• URL: https://build.ci.opensearch.org/job/gradle-check/15347/
• CommitID: f60f09d
  Please examine the workflow log, locate, and copy-paste the failure(s) below, then iterate to green.
  Is the failure a flaky test unrelated to your change?

[github-actions]

Gradle Check (Jenkins) Run Completed with:

• RESULT: FAILURE ❌
• URL: https://build.ci.opensearch.org/job/gradle-check/15346/
• CommitID: 0a5478d
  Please examine the workflow log, locate, and copy-paste the failure(s) below, then iterate to green.
  Is the failure a flaky test unrelated to your change?

[github-actions]

Gradle Check (Jenkins) Run Completed with:

• RESULT: FAILURE ❌
• URL: https://build.ci.opensearch.org/job/gradle-check/15348/
• CommitID: f4edc94
  Please examine the workflow log, locate, and copy-paste the failure(s) below, then iterate to green.
  Is the failure a flaky test unrelated to your change?

[github-actions]

Gradle Check (Jenkins) Run Completed with:

• RESULT: SUCCESS ✅
• URL: https://build.ci.opensearch.org/job/gradle-check/15350/
• CommitID: c829953

[reta]

Could you please create a documentation issue [1] to update the existing Cache APIs with a new parameter, thank you.

[1] https://github.com/opensearch-project/documentation-website

[github-actions]

Gradle Check (Jenkins) Run Completed with:

• RESULT: FAILURE ❌
• URL: https://build.ci.opensearch.org/job/gradle-check/15519/
• CommitID: d88da42
  Please examine the workflow log, locate, and copy-paste the failure(s) below, then iterate to green.
  Is the failure a flaky test unrelated to your change?

[kotwanikunal]

Gradle Check (Jenkins) Run Completed with:

• RESULT: FAILURE ❌
• URL: https://build.ci.opensearch.org/job/gradle-check/15519/
• CommitID: d88da42
  Please examine the workflow log, locate, and copy-paste the failure(s) below, then iterate to green.
  Is the failure a flaky test unrelated to your change?

java.lang.IllegalStateException: FileSystem Cache per segment capacity is less than single IndexInput default block size
	at __randomizedtesting.SeedInfo.seed([B61AEFA7CE988126:B1C1FF36A1C9CA84]:0)
	at org.opensearch.index.store.remote.filecache.FileCacheFactory.createFileCache(FileCacheFactory.java:57)
	at org.opensearch.index.store.remote.filecache.FileCacheFactory.createConcurrentLRUFileCache(FileCacheFactory.java:42)
	at 

Will update the cache size based on CI node specs.

[kotwanikunal]

https://github.com/opensearch-project/documentation-website

Created a request here: opensearch-project/documentation-website#4092

[github-actions]

Gradle Check (Jenkins) Run Completed with:

• RESULT: FAILURE ❌
• URL: https://build.ci.opensearch.org/job/gradle-check/15525/
• CommitID: d85292e
  Please examine the workflow log, locate, and copy-paste the failure(s) below, then iterate to green.
  Is the failure a flaky test unrelated to your change?

[kotwanikunal]

Gradle Check (Jenkins) Run Completed with:

• RESULT: FAILURE ❌
• URL: https://build.ci.opensearch.org/job/gradle-check/15525/
• CommitID: d85292e
  Please examine the workflow log, locate, and copy-paste the failure(s) below, then iterate to green.
  Is the failure a flaky test unrelated to your change?

Unrelated to the changes. Created an issue - #7592

[github-actions]

Gradle Check (Jenkins) Run Completed with:

• RESULT: UNSTABLE ❕
• TEST FAILURES:

      1 org.opensearch.search.SearchWeightedRoutingIT.testSearchAggregationWithNetworkDisruption_FailOpenEnabled

• URL: https://build.ci.opensearch.org/job/gradle-check/15527/
• CommitID: d85292e
  Please review all flaky tests that succeeded after retry and create an issue if one does not already exist to track the flaky failure.

[opensearch-trigger-bot]

The backport to 2.x failed:

The process '/usr/bin/git' failed with exit code 128

To backport manually, run these commands in your terminal:

# Fetch latest updates from GitHub
git fetch
# Create a new working tree
git worktree add ../.worktrees/backport-2.x 2.x
# Navigate to the new working tree
pushd ../.worktrees/backport-2.x
# Create a new branch
git switch --create backport/backport-7498-to-2.x
# Cherry-pick the merged commit of this pull request and resolve the conflicts
git cherry-pick -x --mainline 1 a1e42b1131d5d807dc66d13dd960ebe707da3f09
# Push it to GitHub
git push --set-upstream origin backport/backport-7498-to-2.x
# Go back to the original working tree
popd
# Delete the working tree
git worktree remove ../.worktrees/backport-2.x

Then, create a pull request where the base branch is 2.x and the compare/head branch is backport/backport-7498-to-2.x.