DescribeJobs
获取一个或多个操作日志
可根据日志ID,动作,状态来获取日志列表。 如果不指定任何过滤条件,默认返回你触发的所有操作日志。 如果指定不存在的日志ID,或非法状态值,则会返回错误信息。
Request Parameters
Parameter name | Type | Description | Required |
---|---|---|---|
jobs.n | String | 日志ID | No |
status.n | String | 日志状态: pending, working, failed, successful | No |
verbose | Integer | 是否返回冗长的信息,目前 verbose 只支持为 0。 | No |
offset | Integer | 数据偏移量,默认为0 | No |
limit | Integer | 返回数据长度,默认为20,最大100 | No |
zone | String | 区域 ID,注意要小写 | Yes |
Response Elements
Name | Type | Description |
---|---|---|
action | String | 响应动作 |
job_set | Array | JSON 格式的日志数据列表,每项参数可见下面 Response Item |
total_count | Integer | 根据过滤条件得到的日志总数 |
ret_code | Integer | 执行成功与否,0 表示成功,其他值则为错误代码 |
Response Item
Name | Type | Description |
---|---|---|
job_id | String | 日志ID |
job_action | String | 日志操作行为,对应着资源 API 文档中的 action 名 |
create_time | TimeStamp | 日志创建时间,为UTC时间,格式可参见 ISO8601. |
resource_ids | String | 此操作日志所涉及的资源信息,多个资源以空格分隔 |
owner | String | 日志提供者ID |
status | String | 日志状态,有效值为 pending, working, failed, successful pending:等待被执行 working:执行中 failed:执行失败 successful:执行成功 |
status_time | TimeStamp | 日志最近一次状态变更时间,为UTC时间,格式可参见 ISO8601. |
Example
Example Request:
https://api.shanhe.com/iaas/?action=DescribeJobs
&COMMON_PARAMS
Example Response:
{
"action":"DescribeJobsResponse",
"total_count":1,
"job_set":[
{
"job_id":"j-37amqany",
"create_time":"2013-08-07T18:16:32Z",
"resource_ids": "eip-1234abcd",
"owner":"usr-1234abcd",
"error_codes": "",
"status":"successful",
"status_time":"2013-08-17T08:16:33Z"
}
],
"ret_code":0
}