jerryshao opened a new pull request, #12981:
URL: https://github.com/apache/gravitino/pull/12981

   ### What changes were proposed in this pull request?
   
   Clarify the `GET /metalakes/{metalake}/jobs/runs` query-parameter docs in
   `docs/open-api/jobs.yaml`:
   
   - `queuedAfter`, `startedAfter` and `finishedAfter` combine with AND 
semantics
     when more than one is supplied.
   - Jobs with no value for the selected `sortBy` timestamp always sort last, 
for
     both the `asc` and `desc` sort orders.
   
   ### Why are the changes needed?
   
   Clients need these rules to correctly construct requests and interpret sorted
   job-list responses. Both rules already match the server behaviour in
   `JobOperations`, but were not stated in the specification.
   
   ### Does this PR introduce _any_ user-facing change?
   
   No behaviour change; OpenAPI documentation only.
   
   ### How was this patch tested?
   
   `./gradlew :docs:build` (Redocly validation passes).
   


-- 
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.

To unsubscribe, e-mail: [email protected]

For queries about this service, please contact Infrastructure at:
[email protected]

Reply via email to