Added missing verbs to /_opendistro/_ism/explain.

Signed-off-by: dblock <[email protected]>

Author: dblock

spec/_superseded_operations.yaml

@@ -189,10 +189,12 @@ $schema: ./json_schemas/_superseded_operations.schema.yaml
   superseded_by: /_plugins/_ism/explain
   operations:
     - GET
+    - POST
 /_opendistro/_ism/explain/{index}:
   superseded_by: /_plugins/_ism/explain/{index}
   operations:
     - GET
+    - POST
 /_opendistro/_ism/policies:
   superseded_by: /_plugins/_ism/policies
   operations:

spec/namespaces/ism.yaml

@@ -169,6 +169,8 @@ paths:
       description: Gets the currently applied policy on all indices.
       externalDocs:
         url: https://opensearch.org/docs/latest/im-plugin/ism/api/#explain-index
+      requestBody:
+        $ref: '#/components/requestBodies/ism.explain'
       responses:
         '200':
           $ref: '#/components/responses/ism.explain@200'
@@ -178,6 +180,8 @@ paths:
       description: Gets the currently applied policy on all indices.
       externalDocs:
         url: https://opensearch.org/docs/latest/im-plugin/ism/api/#explain-index
+      requestBody:
+        $ref: '#/components/requestBodies/ism.explain'
       responses:
         '200':
           $ref: '#/components/responses/ism.explain@200'
@@ -190,6 +194,21 @@ paths:
         url: https://opensearch.org/docs/latest/im-plugin/ism/api/#explain-index
       parameters:
         - $ref: '#/components/parameters/ism.explain_policy::path.index'
+      requestBody:
+        $ref: '#/components/requestBodies/ism.explain_policy'
+      responses:
+        '200':
+          $ref: '#/components/responses/ism.explain_policy@200'
+    post:
+      operationId: ism.explain_policy.1
+      x-operation-group: ism.explain_policy
+      description: Gets the currently applied policy on an index.
+      externalDocs:
+        url: https://opensearch.org/docs/latest/im-plugin/ism/api/#explain-index
+      parameters:
+        - $ref: '#/components/parameters/ism.explain_policy::path.index'
+      requestBody:
+        $ref: '#/components/requestBodies/ism.explain_policy'
       responses:
         '200':
           $ref: '#/components/responses/ism.explain_policy@200'
@@ -275,6 +294,14 @@ components:
         application/json:
           schema:
             $ref: '../schemas/ism._common.yaml#/components/schemas/RetryIndexRequest'
+    ism.explain:
+      content:
+        application/json:
+          schema: {}
+    ism.explain_policy:
+      content:
+        application/json:
+          schema: {}
   responses:
     ism.exists_policy@200:
       content:
@@ -348,7 +375,7 @@ components:
       content:
         application/json:
           schema:
-            $ref: '../schemas/ism._common.yaml#/components/schemas/ExplainResponse'
+            $ref: '../schemas/ism._common.yaml#/components/schemas/ExplainIndexResponse'
     ism.explain_policy@200:
       content:
         application/json:

spec/schemas/ism._common.yaml

@@ -300,11 +300,6 @@ components:
       properties:
         state:
           type: string
-    ExplainResponse:
-      type: object
-      properties:
-        total_managed_indices:
-          type: number
     ExplainIndexResponse:
       type: object
       properties:

tests/default/ism/explain.yaml

@@ -26,14 +26,28 @@ prologues:
       payload:
         policy_id: ${policy.id}
 chapters:
-  - synopsis: Get the total managed indices count.
+  - synopsis: Get the total managed indices count (GET).
     path: /_plugins/_ism/explain
     method: GET
-  - synopsis: Get the current policy for an index.
+  - synopsis: Get the total managed indices count (POST).
+    version: '>= 2.12'
+    path: /_plugins/_ism/explain
+    method: POST
+    request:
+      payload: {}
+  - synopsis: Get the current policy for an index (GET).
     path: /_plugins/_ism/explain/{index}
     method: GET
     parameters:
       index: books
+  - synopsis: Get the current policy for an index (POST).
+    version: '>= 2.12'
+    path: /_plugins/_ism/explain/{index}
+    method: POST
+    parameters:
+      index: books
+    request:
+      payload: {}
 epilogues:
   - path: /_plugins/_ism/policies/rollover
     method: DELETE