文档中心>日志服务

获取投递任务列表

最近更新时间:2020-08-10 15:43:09

我的收藏

功能描述

本接口可用于获取投递任务信息列表。

请求

请求示例

GET /tasks?shipper_id=xx-xx-xx-xxxx&start_time=2017-10-10+00%3A00%3A00&end_time=2017-10-10+23%3A59%3A59 HTTP/1.1
Host: <Region>.cls.tencentyun.com
Authorization: <AuthorizationString>

请求行

GET /tasks

请求头

除公共头部外,无特殊请求头部。

请求参数

字段名
类型
位置
必须
含义
shipper_id
string
query
查询的投递规则 ID
start_time
string
query
查询的开始时间,支持最近3天的查询
end_time
string
query
查询的结束时间

响应

响应示例

HTTP/1.1 200 OK
Content-Type: application/json
Content-Length: 123

{
"tasks": [
{
"task_id": "xxxxx-xx-xx-xx",
"shipper_id": "xxxxx-xx-xx-xx",
"topic_id": "xxxxx-xx-xx-xx",
"range_start": "2017-10-17 10:10:10",
"range_end": "2017-10-17 10:10:10",
"start_time": "2017-10-17 10:10:10",
"end_time": "2017-10-17 10:10:10",
"status": "success",
"message": "success",
}
]
}

响应头

除公共响应头部外,无特殊响应头部。

响应参数

字段名
类型
必有
含义
tasks
JsonArray
投递任务信息数组
TaskInfo 格式如下:
字段名
类型
必有
含义
task_id
string
投递任务的 ID
shipper_id
string
投递规则的 ID
topic_id
string
日志主题的 ID
range_start
string
本批投递的日志的开始时间
range_end
string
本批投递的日志的结束时间
start_time
string
本次投递任务的开始时间
end_time
string
本次投递任务的结束时间
status
string
本次投递的结果,"success","running","failed","wait"
message
string
结果的详细信息

错误码

参见 错误码