ListJobs - API Reference| Alibaba Cloud Documentation Center

Description

Obtains a list of jobs.

Request syntax

GET /jobs?Marker={Marker}&MaxItemCount={MaxItemCount}

Attribute description

Attribute	Type	Required	Description
Marker	String	No	Start resource ID of the current page.Default value: Null string
MaxItemCount	int	No	Maximum number of actually returned resources.The default value is 50, and the maximum value is 100.

Response

Success

The 200 status code and the following job list information are returned:

{
    "NextMarker": "",
    "Items":[{
        "Name": "demoJob",
        "Id": "job-0000000058184218000008150000000D",
        "OwnerId": 123456,
        "CreationTime": "2016-11-01T15:25:02.837728Z",
        "State": "Running",
        "Message": "",
        "StartTime": "2016-11-01T15:25:03.837728Z",
        "EndTime": "2016-11-01T15:25:16.827737Z",
        "TaskMetrics": {
            "WaitingCount": 0,
            "RunningCount": 1,
            "FinishedCount": 0,
            "FailedCount": 0,
            "StoppedCount": 0
        },
        "InstanceMetrics": {
            "WaitingCount": 0,
            "RunningCount": 1,
            "FinishedCount": 0,
            "FailedCount": 0,
            "StoppedCount": 0
        }
    }]
}

Attribute description

Attribute	Type	Description
NextMarker	string	Start resource ID on the next page.The value is blank in the last page.
Items	array	List of resources.

Error codes

Error code	Error message	Status code	Syntax
InvalidMaxItemCount	Specified parameter MaxItemCount is not valid. Its type must be integer.	400	MaxItemCount must be an integer.
InvalidMaxItemCount	Specified parameter MaxItemCount is not valid. It must be in [0, 100].	400	The MaxItemCount value must be in the range of [0, 100].