Skip to content

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