Get a list of jobs for a specified workflow

This topic describes how to use an API to get the list of jobs for a specified workflow.

API path

api-open/v1/workflows/<workflow_id>/jobs

<workflow_id>: The workflow ID. See request parameters below.

Request parameters

Path parameters

Parameters	Type	If required	Default value	Example	Description
workflow_id	number	yes	-	4216617528	The workflow ID. The system instantiates a specified workflow as a job. The ID can be viewed in the upper left corner of the specified workflow page.

Headers parameters

Parameters	Type	If required	Default value	Example	Description
Content-Type	string	yes	-	application/json	The content type.
explorer_token	string	yes	-	eyJhbxxx	The authorization token that is used to verify account information. For details, see Workflow API overview.

Body parameters

Parameters	Type	If required	Default value	Example	Description
filter	object	no	-	-	The filter settings.
- name	string	no	-	workflow_q745a_20220715092236	The job name.
- status	number	no	-	2	The job status code. For details, see Workflow API overview.
- fromCreateTime	number	no	-	1657848036000	Start time stamp. Filtering based on the job creation time.
- toCreateTime	number	no	-	1657848157000	End time stamp. Filtering based on the job creation time.
- orderByCreateTime	string	no	desc	-	Sorting mode. The available value are desc and asc.
pageSize	number	no	10	-	The number of entries to return on each page.
page	number	no	1	-	The number of the page to return.

Request example

Note

The content after jobs? is the body parameter, and the content of filter is the result of URL encoding. The original content of filter was {"status": 2, "fromCreateTime": 1657874100000}.

curl -i -X GET -H "Content-Type: application/json" -H "Cookie: "explorer_token=eyJhbxxx"" http://192.168.8.145:7002/api-open/v1/workflows/4216617528/jobs?filter=%7B%22status%22%3A%202%2C%20%20%22fromCreateTime%22%3A%201657874100000%7D&pageSize=10&page=1

Response parameters

Parameters	Type	Example	Description
code	number	0	The result code of the request. Return 0 if the request is successful, and return an error code if the request is unsuccessful. For details, see Workflow API overview.
message	string	Success	The result information of the execution.
data	object	-	The list of returned data.
- total	number	2	The total number of records.
- Page	number	1	The number of the page to return.
- PageSize	number	10	The number of entries to return on each page.
- items	object	-	The list of record details.
- id	number	105	The job ID.
- name	string	workflow_q745a_20220715090915	The job name.
- workflowId	string	4216617528	The workflow ID.
- workflowName	string	workflow_q745a	The workflow name.
- status	number	2	The job status code. For details, see Workflow API overview.
- runBeginTime	number	1657847358000	The start time of the job execution.
- runEndTime	number	1657847364000	The end time of the job execution.
- createTime	number	1657847355906	The creation time of the job.

Response example

{
  "cookie": [],
  "Content-Type": "application/json",
  "Traceparent": "00-008c3056686dd3f3be38b8eda42a917e-b5616e30434cb803-00",
  "Date": "Fri, 15 Jul 2022 08:44:06 GMT",
  "Content-Length": "297"
}
{
  "code": 0,
  "data": {
    "items": [
      {
        "id": 115,
        "name": "workflow_q745a_20220715163650",
        "workflowId": "4216617528",
        "workflowName": "workflow_q745a",
        "status": 2,
        "runBeginTime": 1657874212000,
        "runEndTime": 1657874218000,
        "createTime": 1657874210088
      }
    ],
    "total": 1,
    "Page": 1,
    "PageSize": 10
  },
  "message": "Success"
}

---

Last update: February 19, 2024