日志服务的GetShipperStatus有什么用处？
请求参数
| 参数名称 | 类型 | 是否必须 | 描述 |
| logstoreName | string | 是 | 日志库名称，同一 project 下唯一 |
| shipperName | string | 是 | 日志投递规则名称，同一 logstore 下唯一 |
| from | integer | 是 | 日志投递任务创建时间区间 |
| to | integer | 是 | 日志投递任务创建时间区间 |
| status | string | 否 | 默认为空，表示返回所有状态的任务，目前支持 success/fail/running 等状态 |
| offset | integer | 否 | 返回指定时间区间内投递任务的起始数目，默认值为 0 |
| size | integer | 否 | 返回指定时间区间内投递任务的数目，默认值为 100，最大为 500 |
请求头
GetShipperStatus 接口无特有请求头。关于 Log Service API 的公共请求头，请参考 公共请求头。
响应头
GetShipperStatus 接口无特有响应头。关于 Log Service API 的公共响应头，请参考 公共响应头。
响应元素
请求成功，其响应 Body 会包括指定的日志投递任务列表：
| 名称 | 类型 | 描述 |
| count | integer | 返回的任务个数。 |
| total | integer | 指定范围内任务总数。 |
| statistics | json | 指定范围内任务汇总状态，具体请参考下表。 |
| tasks | array | 指定范围内投递任务具体详情，具体请参考下表。 |
[backcolor=transparent]statistics 内容：
| 名称 | 类型 | 描述 |
| running | integer | 指定范围内状态为 running 的任务个数。 |
| success | integer | 指定范围内状态为 success 的任务个数。 |
| fail | integer | 指定范围内状态为 fail 的任务个数。 |
[backcolor=transparent]tasks 内容：
| 名称 | 类型 | 描述 |
| id | string | 具体投递任务的任务唯一 ID。 |
| taskStatus | string | 投递任务的具体状态，可能为 running/success/fail 中的一种。 |
| taskMessage | string | 投递任务失败时的具体错误信息。 |
| taskCreateTime | integer | 投递任务创建时间。 |
| taskLastDataReceiveTime | integer | 投递任务中的最近一条日志到达服务端时间（非日志时间，是服务端接收时间）。 |
| taskFinishTime | integer | 投递任务结束时间。 |
错误码
除了返回 Log Service API 的 通用错误码，还可能返回如下特有错误码：
| HTTP 状态码 | ErrorCode | ErrorMessage |
| 404 | ProjectNotExist | Project {ProjectName} not exist |
| 404 | LogStoreNotExist | logstore {logstoreName} not exist |
| 400 | ShipperNotExist | shipper {logstoreName} not exist |
| 500 | InternalServerError | internal server error |
| 400 | ParameterInvalid | start time must litter than end time |
| 400 | ParameterInvalid | only support query last 48 hours task status |
| 400 | ParameterInvalid | status only contains success/running/fail |
细节描述
投递任务状态查询时间区间只能指定为最近 24 小时之内。
请求示例：
展开
收起
版权声明：本文内容由阿里云实名注册用户自发贡献，版权归原作者所有，阿里云开发者社区不拥有其著作权，亦不承担相应法律责任。具体规则请查看《阿里云开发者社区用户服务协议》和《阿里云开发者社区知识产权保护指引》。如果您发现本社区中有涉嫌抄袭的内容，填写侵权投诉表单进行举报，一经查实，本社区将立刻删除涉嫌侵权内容。
相关问答
问答排行榜
最热
最新
推荐问答
相关文章
相关电子书
更多
