[Backport] [2.x] [BWC and API enforcement] Define the initial set of annotations, their meaning and relations between them (#9223)

[reta]

Backport of #9223 to 2.x

[opensearch-trigger-bot]

Compatibility status:

> Task :checkCompatibility
Incompatible components: [https://github.com/opensearch-project/alerting.git, https://github.com/opensearch-project/geospatial.git, https://github.com/opensearch-project/k-nn.git, https://github.com/opensearch-project/performance-analyzer.git]
Components skipped due to git failures: [https://github.com/opensearch-project/opensearch-oci-object-storage.git]
Compatible components: [https://github.com/opensearch-project/security.git, https://github.com/opensearch-project/anomaly-detection.git, https://github.com/opensearch-project/asynchronous-search.git, https://github.com/opensearch-project/index-management.git, https://github.com/opensearch-project/common-utils.git, https://github.com/opensearch-project/sql.git, https://github.com/opensearch-project/reporting.git, https://github.com/opensearch-project/observability.git, https://github.com/opensearch-project/job-scheduler.git, https://github.com/opensearch-project/notifications.git, https://github.com/opensearch-project/cross-cluster-replication.git, https://github.com/opensearch-project/neural-search.git, https://github.com/opensearch-project/security-analytics.git, https://github.com/opensearch-project/ml-commons.git, https://github.com/opensearch-project/performance-analyzer-rca.git]

BUILD SUCCESSFUL in 24m 43s

[github-actions]

Gradle Check (Jenkins) Run Completed with:

• RESULT: UNSTABLE ❕
• TEST FAILURES:

      1 org.opensearch.snapshots.DedicatedClusterSnapshotRestoreIT.testIndexDeletionDuringSnapshotCreationInQueue

• URL: https://build.ci.opensearch.org/job/gradle-check/22623/
• CommitID: 51492f2
  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]

Codecov Report

Merging #9296 (2eb57ab) into 2.x (d30199f) will increase coverage by 0.08%.
Report is 4 commits behind head on 2.x.
The diff coverage is 82.44%.

@@             Coverage Diff              @@
##                2.x    #9296      +/-   ##
============================================
+ Coverage     70.80%   70.89%   +0.08%     
- Complexity    57491    57543      +52     
============================================
  Files          4759     4761       +2     
  Lines        271848   271906      +58     
  Branches      40093    40094       +1     
============================================
+ Hits         192481   192757     +276     
+ Misses        62846    62626     -220     
- Partials      16521    16523       +2     

Files Changed	Coverage Δ
.../opensearch/telemetry/tracing/noop/NoopTracer.java	66.66% <0.00%> (-13.34%)	⬇️
...nsearch/script/mustache/SearchTemplateRequest.java	77.27% <0.00%> (-2.17%)	⬇️
...nsearch/index/shard/CheckpointRefreshListener.java	84.61% <ø> (+7.69%)	⬆️
...earch/index/store/RemoteSegmentStoreDirectory.java	87.70% <0.00%> (ø)
...index/shard/CloseableRetryableRefreshListener.java	76.78% <67.64%> (+3.45%)	⬆️
...rch/telemetry/tracing/OTelAttributesConverter.java	85.71% <85.71%> (ø)
...rch/index/remote/RemoteSegmentTransferTracker.java	89.56% <86.36%> (+0.36%)	⬆️
...search/index/shard/RemoteStoreRefreshListener.java	85.71% <95.45%> (+2.56%)	⬆️
...rg/opensearch/telemetry/tracing/DefaultTracer.java	92.59% <100.00%> (+0.28%)	⬆️
...earch/telemetry/tracing/attributes/Attributes.java	100.00% <100.00%> (ø)
... and 3 more

... and 493 files with indirect coverage changes

[github-actions]

Gradle Check (Jenkins) Run Completed with:

• RESULT: ❌
• URL: https://build.ci.opensearch.org/job/gradle-check/22657/
• CommitID: 2eb57ab
  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?

[opensearch-trigger-bot]

Compatibility status:

> Task :checkCompatibility
Incompatible components: [https://github.com/opensearch-project/alerting.git, https://github.com/opensearch-project/geospatial.git, https://github.com/opensearch-project/k-nn.git, https://github.com/opensearch-project/performance-analyzer.git]
Components skipped due to git failures: [https://github.com/opensearch-project/opensearch-oci-object-storage.git]
Compatible components: [https://github.com/opensearch-project/security.git, https://github.com/opensearch-project/anomaly-detection.git, https://github.com/opensearch-project/asynchronous-search.git, https://github.com/opensearch-project/index-management.git, https://github.com/opensearch-project/common-utils.git, https://github.com/opensearch-project/sql.git, https://github.com/opensearch-project/reporting.git, https://github.com/opensearch-project/observability.git, https://github.com/opensearch-project/job-scheduler.git, https://github.com/opensearch-project/cross-cluster-replication.git, https://github.com/opensearch-project/notifications.git, https://github.com/opensearch-project/neural-search.git, https://github.com/opensearch-project/security-analytics.git, https://github.com/opensearch-project/ml-commons.git, https://github.com/opensearch-project/performance-analyzer-rca.git]

BUILD SUCCESSFUL in 31m 16s

[github-actions]

Gradle Check (Jenkins) Run Completed with:

• RESULT: SUCCESS ✅
• URL: https://build.ci.opensearch.org/job/gradle-check/22663/
• CommitID: 2eb57ab