更新时间:2024-04-30 GMT+08:00

查询任务概览信息

功能介绍

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

调用方法

请参见如何调用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

查询转码概览信息失败。

错误码

请参见错误码