Project

General

Profile

Actions

action #95075

closed

Find jobs matching search parameters over /api/v1/jobs (especially documentation) size:S

Added by okurz about 3 years ago. Updated about 3 years ago.

Status:
Resolved
Priority:
Normal
Assignee:
Category:
Feature requests
Target version:
Start date:
2021-07-05
Due date:
2021-07-23
% Done:

0%

Estimated time:

Description

Motivation

As an application developer I want to find openQA job results matching search parameters over API so that I can integrate openQA test results into my application

Acceptance criteria

  • AC1: Application developers can find a place where they can learn how to use the openQA API to find openQA job results matching search parameters, at least "build" and "job group (id/name)"

Suggestions

  • Understand what is currently already possible to find tests based on parameters. E.g. curl -s "https://openqa.suse.de/api/v1/jobs?latest=1&scope=relevant&distri=sle&groupid=385&build=MR:244015:clamav" | jq . shows four jobs as example
  • Make sure that a user would be able to find this information, e.g. from openQA internal help as well as documentation

Out of scope

  • Actual implementation of any search parameters except for "build" and "job group (id/name)" which are mentioned here -> if you find any reasonable please report separately

Related issues 2 (1 open1 closed)

Related to QA - action #92125: Move "MR" on submission tests into a separate job groupResolvedosukup2021-05-042021-07-30

Actions
Related to openQA Project - action #95084: Create a data file with openQA API routes, parameters, docsNew2021-07-05

Actions
Actions #1

Updated by okurz about 3 years ago

  • Related to action #92125: Move "MR" on submission tests into a separate job group added
Actions #2

Updated by tinita about 3 years ago

Maybe we could take this opportunity to establish a data file with API routes and their parameters.
It would include the validation of the parameters as well as documentation and examples.

We aren't using OpenAPI, but we can still use a data file. Once we have the stuff in data instead of scattered through code and documentation, we can easily port the data format to a different one, should we ever use something like OpenAPI.
And we avoid having to update different places in our code/docs.

I created a new ticket: #95084

Actions #3

Updated by okurz about 3 years ago

  • Related to action #95084: Create a data file with openQA API routes, parameters, docs added
Actions #4

Updated by okurz about 3 years ago

I like the idea of such programming-language-agnostic definition of API routes and parameters. I suggest to take this ticket as one example which would need to be covered by such data file. We can still continue with this ticket in the non-structured documentation way and from then on continue in #95084 how it could be done in the way that you suggest.

Actions #6

Updated by livdywan about 3 years ago

  • Subject changed from Find jobs matching search parameters over /api/v1/jobs (especially documentation) to Find jobs matching search parameters over /api/v1/jobs (especially documentation) size:S
  • Status changed from New to Workable
Actions #7

Updated by mkittler about 3 years ago

  • Assignee set to mkittler
Actions #8

Updated by mkittler about 3 years ago

  • Status changed from Workable to In Progress
Actions #9

Updated by openqa_review about 3 years ago

  • Due date set to 2021-07-23

Setting due date based on mean cycle time of SUSE QE Tools

Actions #10

Updated by mkittler about 3 years ago

  • Status changed from In Progress to Feedback

The PR has been merged, waiting for the documentation to be updated.

Actions #11

Updated by mkittler about 3 years ago

  • Status changed from Feedback to Resolved

This should be good enough: https://open.qa/docs/#_finding_tests

Actions

Also available in: Atom PDF