文档首页/ 媒体处理 MPC/ API参考/ 媒资转码接口/ 查询任务概览信息
更新时间：2024-04-30 GMT+08:00
在线调试
CLI示例
查看PDF
分享

查询任务概览信息

功能介绍

查询任务最近一周、最近一月或者自定义时间段的任务时长的统计概览信息。

调用方法

请参见如何调用API。

URI

GET /v1/{project_id}/transcodings/summaries

表1 路径参数

参数

是否必选

参数类型

描述

project_id

是

String

项目ID。获取方法请参考获取项目ID。
表2 Query参数

参数

是否必选

参数类型

描述

start_time

是

String

开始时间。格式为yyyymmdd。必须是与时区无关的UTC时间。

end_time

是

String

结束时间。格式为yyyymmdd。必须是与时区无关的UTC时间。

stat_type

是

String

统计类型。取值如下：

  • video_duration, 转码片源时长统计，单位：分钟。

  • remux_file_duration，转封装片源时长统计，单位：分钟。

  • transcode_task_number，转码次数统计，单位：次。

  • transcode_duration，转码耗时时长统计，单位：分钟。

请求参数

表3 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

否

String

用户Token。

通过调用IAM服务获取用户Token接口获取（响应消息头中X-Subject-Token的值）。

Authorization

否

String

使用AK/SK方式认证时必选，携带的鉴权信息。

X-Project_Id

否

String

使用AK/SK方式认证时必选，携带项目ID信息, 与路径参数中的项目ID相同。

X-Sdk-Date

否

String

使用AK/SK方式认证时必选，请求的发生时间。

响应参数

状态码： 200

表4 响应Body参数

参数

参数类型

描述

summary

Array of StatSummary objects

统计概览信息

total

Float

该指标的总值，精确到小数点后两位。

stat_type

String

统计类型。取值如下：

  • video_duration, 转码片源时长统计，单位：分钟。

  • remux_file_duration，转封装片源时长统计，单位：分钟。

  • transcode_task_number，转码次数统计，单位：次。

  • transcode_duration，转码耗时时长统计，单位：分钟。
表5 StatSummary

参数

参数类型

描述

value

Float

精确到小数点后两位。

date

String

日期，精确到天，格式样例：2018/03/01。

状态码： 400

表6 响应Body参数

参数

参数类型

描述

error_code

String

错误码。

error_msg

String

错误描述。

请求示例

GET https://{endpoint}/v1/{project_id}/transcodings/summaries?start_time=20221119&end_time=20221125&stat_type=transcode_task_number

响应示例

状态码： 200

查询转码概览信息成功。

{
  "stat_type" : "transcode_task_number",
  "total" : 5.0,
  "summary" : [ {
    "value" : "2.0",
    "date" : "2022/11/25"
  }, {
    "value" : "3.0",
    "date" : "2022/11/25"
  } ]
}

状态码： 400

查询转码概览信息失败。

{
  "error_code" : "MPC.10202",
  "error_msg" : "Invalid request parameter, start_time cannot be greater than end_time."
}

状态码

状态码

描述

200

查询转码概览信息成功。

400

查询转码概览信息失败。

错误码

请参见错误码。

父主题： 媒资转码接口

相关文档