add reusable UWS job list params to openapi/uws

Author: pdowler

openapi/uws/uws-after-param.yaml

@@ -0,0 +1,8 @@
+name: AFTER
+in: query
+description: list jobs with creationTime after the specified value
+required: false
+schema:
+  type: string
+  format: date-time
+  example: "2017-07-21T17:32:28Z"

openapi/uws/uws-last-param.yaml

@@ -0,0 +1,11 @@
+name: LAST
+in: query
+description: |
+  limit the number of jobs listed to the specified value; use of LAST
+  also causes the server to return jobs in order of creationTime (descending)
+  with the most recent jobs first
+required: false
+schema:
+  type: integer
+  minimum: 0
+  example: 10

openapi/uws/uws-phase-param.yaml

@@ -0,0 +1,7 @@
+name: PHASE
+in: query
+description: list jobs in this execution phase
+required: false
+schema:
+  type: string
+  example: "EXECUTING"

openapi/uws/uws-responses.yaml

@@ -31,7 +31,7 @@ job-listing:
                         <uws:creationTime>2024-07-16T16:38:33.090Z</uws:creationTime>
                     </uws:jobref>
                     ...
-                </uws:job>
+                </uws:jobs>
         
 job:
     description: a single UWS Job

openapi/vosi/vosi-table-ops.yaml

@@ -5,6 +5,9 @@ get:
     summary: list async table update jobs
     description: async job listing
     parameters:
+        - $ref: ../uws/uws-phase-param.yaml
+        - $ref: ../uws/uws-after-param.yaml
+        - $ref: ../uws/uws-last-param.yaml
     responses:
         '200':
             $ref: ../uws/uws-responses.yaml#/job-listing