Added schema for /_plugins/_knn/stats, /_plugins/_knn/models/{model_id}, _train and _search.

[dblock]

Description

Added schema for /_plugins/_knn/stats, /_plugins/_knn/models/{model_id}, _train and _search.

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: af5f033
Comparing To SHA: 807fa8f

API Changes

Summary

├─┬Paths
│ ├─┬/_plugins/_knn/{node_id}/stats/{stat}
│ │ └─┬GET
│ │   ├─┬Parameters
│ │   │ └─┬Schema
│ │   │   └─┬Schema
│ │   │     ├──[➕] enum (22422:15)
│ │   │     ├──[➕] enum (22428:15)
│ │   │     ├──[➕] enum (22417:15)
│ │   │     ├──[➕] enum (22427:15)
│ │   │     ├──[➕] enum (22429:15)
│ │   │     ├──[➕] enum (22426:15)
│ │   │     └──[➕] enum (22425:15)
│ │   └─┬Responses
│ │     └─┬200
│ │       └──[➕] content (29926:11)
│ ├─┬/_opendistro/_knn/{node_id}/stats/{stat}
│ │ └─┬GET
│ │   ├─┬Parameters
│ │   │ └─┬Schema
│ │   │   └─┬Schema
│ │   │     ├──[➕] enum (22426:15)
│ │   │     ├──[➕] enum (22427:15)
│ │   │     ├──[➕] enum (22422:15)
│ │   │     ├──[➕] enum (22428:15)
│ │   │     ├──[➕] enum (22425:15)
│ │   │     ├──[➕] enum (22417:15)
│ │   │     └──[➕] enum (22429:15)
│ │   └─┬Responses
│ │     └─┬200
│ │       └──[➕] content (29926:11)
│ ├─┬/_plugins/_knn/stats
│ │ └─┬GET
│ │   └─┬Responses
│ │     └─┬200
│ │       └──[➕] content (29926:11)
│ ├─┬/_plugins/_knn/models/{model_id}
│ │ └─┬DELETE
│ │   └─┬Responses
│ │     └─┬200
│ │       └──[➕] content (29908:11)
│ ├─┬/_plugins/_knn/{node_id}/stats
│ │ └─┬GET
│ │   └─┬Responses
│ │     └─┬200
│ │       └──[➕] content (29926:11)
│ ├─┬/_plugins/_knn/models/_search
│ │ ├─┬GET
│ │ │ └─┬Responses
│ │ │   └─┬200
│ │ │     └──[➕] content (29920:11)
│ │ └─┬POST
│ │   └─┬Responses
│ │     └─┬200
│ │       └──[➕] content (29920:11)
│ ├─┬/_plugins/_knn/stats/{stat}
│ │ └─┬GET
│ │   ├─┬Parameters
│ │   │ └─┬Schema
│ │   │   └─┬Schema
│ │   │     ├──[➕] enum (22422:15)
│ │   │     ├──[➕] enum (22417:15)
│ │   │     ├──[➕] enum (22427:15)
│ │   │     ├──[➕] enum (22428:15)
│ │   │     ├──[➕] enum (22429:15)
│ │   │     ├──[➕] enum (22425:15)
│ │   │     └──[➕] enum (22426:15)
│ │   └─┬Responses
│ │     └─┬200
│ │       └──[➕] content (29926:11)
│ ├─┬/_plugins/_knn/models/{model_id}/_train
│ │ └─┬POST
│ │   └─┬Requestbody
│ │     ├──[➖] required (27052:17)❌ 
│ │     └──application/json
│ ├─┬/_opendistro/_knn/stats/{stat}
│ │ └─┬GET
│ │   ├─┬Parameters
│ │   │ └─┬Schema
│ │   │   └─┬Schema
│ │   │     ├──[➕] enum (22422:15)
│ │   │     ├──[➕] enum (22425:15)
│ │   │     ├──[➕] enum (22417:15)
│ │   │     ├──[➕] enum (22426:15)
│ │   │     ├──[➕] enum (22428:15)
│ │   │     ├──[➕] enum (22427:15)
│ │   │     └──[➕] enum (22429:15)
│ │   └─┬Responses
│ │     └─┬200
│ │       └──[➕] content (29926:11)
│ └─┬/_plugins/_knn/models/_train
│   └─┬POST
│     └─┬Requestbody
│       ├──[➖] required (27052:17)❌ 
│       └──application/json
└─┬Components
  ├──[➕] schemas (53277:7)
  ├──[➕] schemas (53240:7)
  ├──[➕] schemas (53284:7)
  ├──[➕] schemas (53270:7)
  ├──[➕] schemas (53384:7)
  ├──[➕] schemas (53253:7)
  └──[➕] schemas (53360:7)

Document Element	Total Changes	Breaking Changes
paths	39	2
components	7	0

• ❌ BREAKING Changes: 2 out of 46
• Removals: 2
• Additions: 44
• Breaking Removals: 2

Report

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

API Coverage

	Before	After	Δ
Covered (%)	606 (59.35 %)	606 (59.35 %)	0 (0 %)
Uncovered (%)	415 (40.65 %)	415 (40.65 %)	0 (0 %)
Unknown	43	43	0

[github-actions]

Spec Test Coverage Analysis

Total	Tested
536	452 (84.33 %)

[Tokesh]

Hi everyone! I wanted to review a PR in Opensearch for the first time. Everything looks great, but I noticed a couple of things that I have encountered in my PRs.