Added ML Model APIs

[nathaliellenaa]

Description

Added missing ML Model APIs.

Issues Resolved

Part of opensearch-project/opensearch-py#867.

ML Model APIs to add

• GET /_plugins/_ml/models/{model_id}
• POST /_plugins/_ml/models/meta
• POST /_plugins/_ml/models/_register_meta
• POST /_plugins/_ml/models/_search
• POST /_plugins/_ml/models/_undeploy
• POST /_plugins/_ml/models/_unload
• POST /_plugins/_ml/models/{model_id}/_unload
• POST /_plugins/_ml/models/_upload
• POST /_plugins/_ml/models/{model_id}/_load
• POST /_plugins/_ml/models/{model_id}/_predict
• POST /_plugins/_ml/models/{model_id}/chunk/{chunk_number}
• POST /_plugins/_ml/models/{model_id}/upload_chunk/{chunk_number}
• POST /_plugins/_ml/models/{model_id}/{version}/_register
• POST /_plugins/_ml/models/{model_id}/{version}/_upload
• PUT /_plugins/_ml/models/{model_id}

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: 33aab02
Comparing To SHA: a2afe56

API Changes

Summary

├─┬Paths
│ ├──[➕] path (4802:3)
│ ├──[➕] path (4968:3)
│ ├──[➕] path (4916:3)
│ ├──[➕] path (4818:3)
│ ├──[➕] path (4934:3)
│ ├──[➕] path (4755:3)
│ ├──[➕] path (5026:3)
│ ├──[➕] path (4988:3)
│ ├──[➕] path (5008:3)
│ ├──[➕] path (4837:3)
│ ├─┬/_plugins/_ml/models/{model_id}
│ │ ├──[➕] get (4872:7)
│ │ └──[➕] put (4886:7)
│ ├─┬/_plugins/_ml/models/_search
│ │ └──[➕] post (4788:7)
│ ├─┬/_plugins/_ml/models/_register
│ │ └─┬POST
│ │   └─┬Requestbody
│ │     └─┬application/json
│ │       └─┬Schema
│ │         ├──[➖] required (27143:17)❌ 
│ │         ├─┬model_format
│ │         │ └──[🔀] $ref (33660:13)❌ 
│ │         ├─┬model_group_id
│ │         │ └──[🔀] $ref (33450:13)❌ 
│ │         └─┬version
│ │           └──[🔀] $ref (34958:13)❌ 
│ └─┬/_plugins/_ml/models/{model_id}/_undeploy
│   └─┬POST
│     └──[➕] requestBody (27569:7)❌ 
└─┬Components
  ├──[➕] requestBodies (27585:7)
  ├──[➕] requestBodies (27642:7)
  ├──[➕] requestBodies (27569:7)
  ├──[➕] requestBodies (27517:7)
  ├──[➕] requestBodies (27424:7)
  ├──[➕] requestBodies (27601:7)
  ├──[➕] requestBodies (27387:7)
  ├──[➕] requestBodies (27344:7)
  ├──[➕] requestBodies (27631:7)
  ├──[➕] responses (30812:7)
  ├──[➕] responses (30725:7)
  ├──[➕] responses (30836:7)
  ├──[➕] responses (30772:7)
  ├──[➕] responses (30818:7)
  ├──[➕] responses (30751:7)
  ├──[➕] responses (30626:7)
  ├──[➕] responses (30824:7)
  ├──[➕] responses (30647:7)
  ├──[➕] responses (30713:7)
  ├──[➕] parameters (23147:7)
  ├──[➕] parameters (23123:7)
  ├──[➕] parameters (23057:7)
  ├──[➕] parameters (23154:7)
  ├──[➕] parameters (23141:7)
  ├──[➕] parameters (23050:7)
  ├──[➕] parameters (23135:7)
  ├──[➕] parameters (23105:7)
  ├──[➕] parameters (23117:7)
  ├──[➕] schemas (33660:7)
  ├──[➕] schemas (54271:7)
  ├──[➕] schemas (54422:7)
  ├──[➕] schemas (54436:7)
  ├──[➕] schemas (54231:7)
  ├──[➕] schemas (54429:7)
  ├──[➕] schemas (54677:7)
  ├──[➕] schemas (54680:7)
  ├──[➕] schemas (54161:7)
  ├──[➕] schemas (54685:7)
  ├──[➕] schemas (54200:7)
  ├──[➕] schemas (54672:7)
  ├──[➕] schemas (54386:7)
  └─┬ml._common___Source
    ├─┬model_format
    │ └──[🔀] $ref (33660:13)❌ 
    └─┬model_state
      └──[➕] enum (54552:15)

Document Element	Total Changes	Breaking Changes
paths	18	5
components	43	1

• ❌ BREAKING Changes: 6 out of 61
• Modifications: 4
• Removals: 1
• Additions: 56
• Breaking Removals: 1
• Breaking Modifications: 4
• Breaking Additions: 1

Report

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

API Coverage

	Before	After	Δ
Covered (%)	606 (59.35 %)	619 (60.63 %)	13 (1.28 %)
Uncovered (%)	415 (40.65 %)	402 (39.37 %)	-13 (-1.28 %)
Unknown	43	43	0

[github-actions]

Spec Test Coverage Analysis

Total	Tested
546	547 (100.18 %)

[dblock]

Looking good. I have some smallish nits. Iterate to green (validation is failing, etc.)

[dblock]

Btw, there's a whole bunch of others missing per #168. They don't all need to be done at the same time.

[nathaliellenaa]

Yes, I'm planning to create some small PRs based on the APIs category (model, model groups, connector, agents, etc.) I will also add more missing Model APIs to this PR.

[dhrubo-os]

DCO is missing @nathaliellenaa

[dblock]

Looking good. Some nits below.

In tests try to get rid of multiple-paths-detected: false as much as possible by moving setup into prologues and teardown into epilogues. You should only need that set if there's a need to call an unrelated API (e.g. wait on a task) to complete the test. Otherwise chapters should only have chapters for the API being tested.