Added/fixed /_plugins/_rollup/jobs.

CHANGELOG.md

@@ -29,6 +29,7 @@ Inspired from [Keep a Changelog](https://keepachangelog.com/en/1.0.0/)
 - Added `sm` namespace API specifications ([#701](https://github.com/opensearch-project/opensearch-api-specification/pull/701))
 - Added schema for `/_plugins/_knn/stats`, `/_plugins/_knn/models/{model_id}`, `_train` and `_search` ([#704](https://github.com/opensearch-project/opensearch-api-specification/pull/704))
 - Added `retry` support in `prologues` and `epilogues` ([#713](https://github.com/opensearch-project/opensearch-api-specification/pull/713))
+- Added response schema for `DELETE /_plugins/_rollup/jobs/{id}`, `POST /_plugins/_rollup/jobs/{id}/_start` and `_stop` ([#716](https://github.com/opensearch-project/opensearch-api-specification/pull/716))
 
 ### Removed
 - Removed unsupported `_common.mapping:SourceField`'s `mode` field and associated `_common.mapping:SourceFieldMode` enum ([#652](https://github.com/opensearch-project/opensearch-api-specification/pull/652))
@@ -60,6 +61,7 @@ Inspired from [Keep a Changelog](https://keepachangelog.com/en/1.0.0/)
 - Fixed query DSL schemas ([#706](https://github.com/opensearch-project/opensearch-api-specification/pull/706))
 - Fixed content-type of `GET /_plugins/_observability/_local/stats` ([#711](https://github.com/opensearch-project/opensearch-api-specification/pull/711))
 - Fixed `tenant` in `ObservabilityObject` request body to not be required ([#711](https://github.com/opensearch-project/opensearch-api-specification/pull/711))
+- Fixed response code in `PUT /_plugins/_rollup/jobs/{id}` ([#716](https://github.com/opensearch-project/opensearch-api-specification/pull/716))
 
 ### Changed
 - Changed `tasks._common:TaskInfo` and `tasks._common:TaskGroup` to be composed of a `tasks._common:TaskInfoBase` ([#683](https://github.com/opensearch-project/opensearch-api-specification/pull/683))

spec/namespaces/rollups.yaml

@@ -25,8 +25,8 @@ paths:
       externalDocs:
         url: https://opensearch.org/docs/latest/im-plugin/index-rollups/rollup-api/#create-or-update-an-index-rollup-job
       responses:
-        '200':
-          $ref: '#/components/responses/rollups.put@200'
+        '201':
+          $ref: '#/components/responses/rollups.put@201'
       parameters:
         - $ref: '#/components/parameters/rollups.put::path.id'
         - $ref: '#/components/parameters/rollups.put::query.if_primary_term'
@@ -97,14 +97,26 @@ components:
         application/json:
           schema:
             $ref: '../schemas/rollups._common.yaml#/components/schemas/RollupEntity'
-    rollups.put@200:
+    rollups.put@201:
       content:
         application/json:
           schema:
             $ref: '../schemas/rollups._common.yaml#/components/schemas/RollupEntity'
-    rollups.delete@200: {}
-    rollups.start@200: {}
-    rollups.stop@200: {}
+    rollups.delete@200:
+      content:
+        application/json:
+          schema:
+            $ref: '../schemas/_common.yaml#/components/schemas/WriteResponseBase'
+    rollups.start@200:
+      content:
+        application/json:
+          schema:
+            $ref: '../schemas/_common.yaml#/components/schemas/AcknowledgedResponseBase'
+    rollups.stop@200:
+      content:
+        application/json:
+          schema:
+            $ref: '../schemas/_common.yaml#/components/schemas/AcknowledgedResponseBase'
     rollups.explain@200:
       content:
         application/json:

spec/schemas/rollups._common.yaml

@@ -10,11 +10,14 @@ components:
       type: object
       properties:
         _id:
-          type: string
-        _seqNo:
-          type: number
-        _primaryTerm:
-          type: number
+          $ref: '_common.yaml#/components/schemas/Id'
+        _seq_no:
+          $ref: '_common.yaml#/components/schemas/SequenceNumber'
+        _primary_term:
+          type: integer
+          format: int64
+        _version:
+          $ref: '_common.yaml#/components/schemas/VersionNumber'
         rollup:
           $ref: '#/components/schemas/Rollup'
     Rollup:
@@ -39,7 +42,7 @@ components:
         target_index:
           type: string
         metadata_id:
-          type: string
+          type: ['null', string]
         page_size:
           type: number
         delay:
@@ -59,18 +62,15 @@ components:
           description: 'Set up a Mustache message template for error notifications. For example, if an index rollup job fails, the system sends a message to a Slack channel.'
     ExplainEntities:
       type: object
-      properties:
-        item:
-          $ref: '#/components/schemas/Explain'
+      additionalProperties:
+        $ref: '#/components/schemas/Explain'
     Explain:
       type: object
       properties:
-        rollup_id:
-          type: string
-        last_updated_time:
-          type: number
-        continuous:
-          $ref: '#/components/schemas/Continuous'
+        metadata_id:
+          type: ['null', string]
+        rollup_metadata:
+          type: ['null', object]
     DimensionsConfigItem:
       type: object
       properties:
@@ -95,6 +95,8 @@ components:
           type: string
         target_field:
           type: string
+        format:
+          type: ['null', string]
     HistogramDimension:
       type: object
       properties:
@@ -166,30 +168,3 @@ components:
             - $ref: '#/components/schemas/Cron'
         schedule_delay:
           type: number
-    Continuous:
-      type: object
-      properties:
-        next_window_start_time:
-          type: number
-        next_window_end_time:
-          type: number
-        status:
-          type: string
-        failure_reason:
-          type: string
-        stats:
-          $ref: '#/components/schemas/Stats'
-    Stats:
-      type: object
-      properties:
-        pages_processed:
-          type: number
-        documents_processed:
-          type: number
-        rollups_indexed:
-          type: number
-        index_time_in_ms:
-          type: number
-        search_time_in_ms:
-          type: number
-

tests/default/rollups/jobs.yaml

@@ -0,0 +1,67 @@
+
+$schema: ../../../json_schemas/test_story.schema.yaml
+
+description: Test index rollups.
+
+prologues:
+  - path: /_bulk
+    method: POST
+    parameters:
+      refresh: true
+    request:
+      content_type: application/x-ndjson
+      payload:
+        - {create: {_index: books, _id: book_1392214}}
+        - {author: Harper Lee, title: To Kill a Mockingbird, order_date: '2021-02-27T03:56:10+00:00', pages: 285}
+        - {create: {_index: books, _id: book_1392215}}
+        - {author: Elizabeth Rudnick, title: Beauty and the Beast, order_date: '2024-12-09T04:37:10-05:00', pages: 275}
+epilogues:
+  - path: /_plugins/_rollup/jobs/books
+    method: DELETE
+    status: [200, 404]
+  - path: /books
+    method: DELETE
+    status: [200, 404]
+chapters:
+  - synopsis: Create an index rollup job.
+    path: /_plugins/_rollup/jobs/{id}
+    method: PUT
+    parameters:
+      id: books
+    request:
+      payload:
+        rollup:
+          enabled: true
+          description: Rollup books.
+          schedule:
+            interval: 
+              period: 1
+              unit: Minutes
+          source_index: books
+          target_index: books_by_order_date
+          page_size: 1
+          delay: 0
+          continuous: false
+          dimensions:
+            - date_histogram:
+                source_field: order_date
+                fixed_interval: 1h
+            - terms:
+                source_field: title
+          metrics:
+            - source_field: pages
+              metrics:
+                - sum: {}
+                - avg: {}
+    response:
+      status: 201
+      payload:
+        _id: books
+        rollup:
+          rollup_id: books
+          enabled: true
+  - synopsis: Delete an index rollup job.
+    path: /_plugins/_rollup/jobs/{id}
+    method: DELETE
+    parameters:
+      id: books

tests/default/rollups/jobs/explain.yaml

@@ -0,0 +1,59 @@
+
+$schema: ../../../../json_schemas/test_story.schema.yaml
+
+description: Test index rollups.
+
+prologues:
+  - path: /_bulk
+    method: POST
+    parameters:
+      refresh: true
+    request:
+      content_type: application/x-ndjson
+      payload:
+        - {create: {_index: books, _id: book_1392214}}
+        - {author: Harper Lee, title: To Kill a Mockingbird, order_date: '2021-02-27T03:56:10+00:00', pages: 285}
+        - {create: {_index: books, _id: book_1392215}}
+        - {author: Elizabeth Rudnick, title: Beauty and the Beast, order_date: '2024-12-09T04:37:10-05:00', pages: 275}
+  - path: /_plugins/_rollup/jobs/books_rollup_job
+    method: PUT
+    request:
+      payload:
+        rollup:
+          enabled: true
+          description: Rollup books.
+          schedule:
+            interval: 
+              period: 1
+              unit: Minutes
+          source_index: books
+          target_index: books_by_order_date
+          page_size: 1
+          delay: 0
+          continuous: false
+          dimensions:
+            - date_histogram:
+                source_field: order_date
+                fixed_interval: 1h
+            - terms:
+                source_field: title
+          metrics:
+            - source_field: pages
+              metrics:
+                - sum: {}
+                - avg: {}
+  - path: /_plugins/_rollup/jobs/books_rollup_job/_start
+    method: POST
+epilogues:
+  - path: /_plugins/_rollup/jobs/books_rollup_job
+    method: DELETE
+    status: [200, 404]
+  - path: /books
+    method: DELETE
+    status: [200, 404]
+chapters:
+  - synopsis: Explain an index rollup job.
+    path: /_plugins/_rollup/jobs/{id}/_explain
+    method: GET
+    parameters:
+      id: books_rollup_job

tests/default/rollups/jobs/start.yaml

@@ -0,0 +1,57 @@
+
+$schema: ../../../../json_schemas/test_story.schema.yaml
+
+description: Test index rollups.
+
+prologues:
+  - path: /_bulk
+    method: POST
+    parameters:
+      refresh: true
+    request:
+      content_type: application/x-ndjson
+      payload:
+        - {create: {_index: books, _id: book_1392214}}
+        - {author: Harper Lee, title: To Kill a Mockingbird, order_date: '2021-02-27T03:56:10+00:00', pages: 285}
+        - {create: {_index: books, _id: book_1392215}}
+        - {author: Elizabeth Rudnick, title: Beauty and the Beast, order_date: '2024-12-09T04:37:10-05:00', pages: 275}
+  - path: /_plugins/_rollup/jobs/books
+    method: PUT
+    request:
+      payload:
+        rollup:
+          enabled: true
+          description: Rollup books.
+          schedule:
+            interval: 
+              period: 1
+              unit: Minutes
+          source_index: books
+          target_index: books_by_order_date
+          page_size: 1
+          delay: 0
+          continuous: false
+          dimensions:
+            - date_histogram:
+                source_field: order_date
+                fixed_interval: 1h
+            - terms:
+                source_field: title
+          metrics:
+            - source_field: pages
+              metrics:
+                - sum: {}
+                - avg: {}
+epilogues:
+  - path: /_plugins/_rollup/jobs/books
+    method: DELETE
+    status: [200, 404]
+  - path: /books
+    method: DELETE
+    status: [200, 404]
+chapters:
+  - synopsis: Start an index rollup job.
+    path: /_plugins/_rollup/jobs/{id}/_start
+    method: POST
+    parameters:
+      id: books

tests/default/rollups/jobs/stop.yaml

@@ -0,0 +1,59 @@
+
+$schema: ../../../../json_schemas/test_story.schema.yaml
+
+description: Test index rollups.
+
+prologues:
+  - path: /_bulk
+    method: POST
+    parameters:
+      refresh: true
+    request:
+      content_type: application/x-ndjson
+      payload:
+        - {create: {_index: books, _id: book_1392214}}
+        - {author: Harper Lee, title: To Kill a Mockingbird, order_date: '2021-02-27T03:56:10+00:00', pages: 285}
+        - {create: {_index: books, _id: book_1392215}}
+        - {author: Elizabeth Rudnick, title: Beauty and the Beast, order_date: '2024-12-09T04:37:10-05:00', pages: 275}
+  - path: /_plugins/_rollup/jobs/books
+    method: PUT
+    request:
+      payload:
+        rollup:
+          enabled: true
+          description: Rollup books.
+          schedule:
+            interval: 
+              period: 1
+              unit: Minutes
+          source_index: books
+          target_index: books_by_order_date
+          page_size: 1
+          delay: 0
+          continuous: false
+          dimensions:
+            - date_histogram:
+                source_field: order_date
+                fixed_interval: 1h
+            - terms:
+                source_field: title
+          metrics:
+            - source_field: pages
+              metrics:
+                - sum: {}
+                - avg: {}    
+  - path: /_plugins/_rollup/jobs/books/_start
+    method: POST
+epilogues:
+  - path: /_plugins/_rollup/jobs/books
+    method: DELETE
+    status: [200, 404]
+  - path: /books
+    method: DELETE
+    status: [200, 404]
+chapters:
+  - synopsis: Stop an index rollup job.
+    path: /_plugins/_rollup/jobs/{id}/_stop
+    method: POST
+    parameters:
+      id: books