Help Center> DataArts Studio> API Reference> DataArts Factory APIs (V1)> Job Development APIs> Viewing a Job List
Updated on 2024-04-29 GMT+08:00
View PDF

Viewing a Job List

Function

This API is used to query a list of batch or real-time jobs. A maximum of 100 jobs can be returned for each query.

URI

  • URI format

    GET /v1/{project_id}/jobs?jobType={jobType}&offset={offset}&limit={limit}&jobName={jobName}&tags={tags}

  • Parameter description

    Parameter

    Mandatory

    Type

    Description

    project_id

    Yes

    String

    Project ID. For details about how to obtain a project ID, see Project ID and Account ID.

    jobType

    No

    String

    Job type.

    • REAL_TIME: real-time processing
    • BATCH: batch processing

    Default value: BATCH

    offset

    No

    Integer

    Number of pages of the paging list.

    Default value: 0

    The value must be greater than or equal to 0.

    limit

    No

    Integer

    The maximum number of records on each page. The value ranges from 1 to 1,000.

    Default value: 10

    jobName

    No

    String

    Job name.

    tags

    No

    String

    List of job tags. Separate multiple tags with commas (,), for example, tag1,tag2,tag3.

Request Parameters

Table 1 Request header parameter

Parameter

Mandatory

Type

Description

workspace

No

String

Workspace ID.

  • If this parameter is not set, data in the default workspace is queried by default.
  • To query data in other workspaces, this header must be carried.

Response Parameters

Table 2 Response parameters

Parameter

Mandatory

Type

Description

total

Yes

Integer

Number of jobs.

jobs

Yes

List<Job>

Job list. For details, see Table 3.
Table 3 Job data structure description

Parameter

Mandatory

Type

Description

name

Yes

String

Job name.

jobType

Yes

String

Job type.

  • REAL_TIME: real-time processing
  • BATCH: batch processing

owner

No

String

Job owner. The length cannot exceed 128 characters.

priority

No

int

Job priority. The value ranges from 0 to 2. The default value is 0. 0 indicates a top priority, 1 indicates a medium priority, and 2 indicates a low priority.

status

Yes

String

Job status.

When jobType is set to REAL_TIME, the status is as follows:

  • STARTING
  • NORMAL
  • EXCEPTION
  • STOPPING
  • STOPPED

When jobType is set to BATCH, the status is as follows:

  • SCHEDULING
  • STOPPED
  • PAUSED

createUser

Yes

String

Job creator.

createTime

Yes

Long

Time when the job is created.

startTime

No

Long

Time when the job starts running.

endTime

No

Long

Time when the job stops running.

lastInstanceStatus

No

String

Most recent running status of the job instance. This parameter is available only when jobType is set to BATCH.

lastInstanceEndTime

No

Long

Time when the most recent job instance stops to run. This parameter is available only when jobType is set to BATCH.

lastUpdateTime

No

Long

Time when the job was last updated

lastUpdateUser

No

String

User who last updated the job

path

No

String

Path of the job.

singleNodeJobFlag

No

boolean

Whether the job is a single-task job

Example Request

Query the job list.

GET /v1/ff6b627b9d7b45b48f773be511c1a2b8/jobs

Example Response

  • Success response
    {
    "jobs": [
        {
            "createTime": 1680783636000,
            "createUser": "test_user",
            "jobType": "BATCH",
            "lastInstanceEndTime": 1682519407000,
            "lastInstanceStatus": "success",
            "lastUpdateUser": "test_user",
            "name": "myJob",
            "owner": "test_user",
            "path": "/",
            "priority": 0,
            "singleNodeJobFlag": false,
            "status": "SCHEDULING"
        }
    ],
    "total": 1
}
  • Failure response

    HTTP status code 400

    {
    "error_code":"DLF.3051",
    "error_msg":"The request parameter is invalid."
}
Parent topic: Job Development APIs