云端录制用量查询。
接口说明
-
统计每日云端录制各规格下的录制时长。
-
支持到实时音视频应用粒度查询。
QPS 限制
本接口的单用户 QPS 限制为 10 次/秒。超过限制，API 调用会被限流，这可能会影响您的业务，请合理调用。
调试
您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。
调试
授权信息
|
操作 |
访问级别 |
资源类型 |
条件关键字 |
关联操作 |
|
live:DescribeLiveRtcRecordUsageData |
none |
*全部资源
|
无 | 无 |
请求语法
GET HTTP/1.1请求参数
|
名称 |
类型 |
必填 |
描述 |
示例值 |
| StartTime |
string |
是 |
获取数据起始时间。格式为：yyyy-MM-ddTHH:mm:ssZ（UTC 时间）。 |
2017-12-21T08:00:00Z |
| EndTime |
string |
是 |
结束时间。查询粒度≥5 分钟且≤31 天。格式为：yyyy-MM-ddTHH:mm:ssZ（UTC 时间）。 |
2022-10-10T21:00:00Z |
| AppId |
string |
是 |
实时音视频应用 ID。可在实时音视频应用管理中查看。 |
intl7f92-a5a8*************7ce4eb44a6 |
| RecordMode |
string |
是 |
录制模式：
|
0 |
| Interval |
string |
否 |
查询数据的时间粒度。单位：秒。取值：
|
3600 |
返回参数
|
名称 |
类型 |
描述 |
示例值 |
|
object |
Schema of Response |
||
| RequestId |
string |
Id of the request |
16A96B9A-F2*************B92E68F4CD8 |
| RecordMode |
string |
录制模式。
|
0 |
| AppId |
string |
需要查询的实时音视频应用 ID。 |
7fd341b3-c6fa-43e1-96b8-7295a1dd**** |
| TotalSummaryDuration |
number |
汇总时长，单位：秒。 |
150 |
| AudioSummaryDuration |
number |
纯音频汇总时长，单位：秒。 |
20 |
| V480SummaryDuration |
number |
480P 及以下视频汇总时长，单位：秒。 |
30 |
| V720SummaryDuration |
number |
720P 及以下视频汇总时长，单位：秒。 |
40 |
| V1080SummaryDuration |
number |
720P 以上（含 1080P）视频汇总时长，单位：秒。 |
10 |
| Data |
array<object> |
用量统计信息。 |
|
|
object |
用量统计信息。 |
||
| Timestamp |
string |
数据统计时刻。格式为：yyyy-MM-ddTHH:mm:ssZ（UTC 时间）。 |
2022-10-10T20:00:00Z |
| TotalDuration |
number |
全部时长，单位：秒。 |
150 |
| AudioDuration |
number |
纯音频时长，单位：秒。 |
20 |
| V480Duration |
number |
480P 及以下视频时长，单位：秒。 |
30 |
| V720Duration |
number |
720P 及以下视频时长，单位：秒。 |
40 |
| V1080Duration |
number |
720P 以上视频时长，单位：秒。 |
10 |
示例
正常返回示例
JSON格式
{
"RequestId": "16A96B9A-F2*************B92E68F4CD8",
"RecordMode": "0",
"AppId": "7fd341b3-c6fa-43e1-96b8-7295a1dd****",
"TotalSummaryDuration": 150,
"AudioSummaryDuration": 20,
"V480SummaryDuration": 30,
"V720SummaryDuration": 40,
"V1080SummaryDuration": 10,
"Data": [
{
"Timestamp": "2022-10-10T20:00:00Z",
"TotalDuration": 150,
"AudioDuration": 20,
"V480Duration": 30,
"V720Duration": 40,
"V1080Duration": 10
}
]
}错误码
|
HTTP status code |
错误码 |
错误信息 |
描述 |
|---|---|---|---|
| 400 | InvalidStartTime.ValueNotSupported | The specified value of parameter StartTime is not supported. | 传入的StartTime参数不支持。 |
| 400 | InvalidEndTime.Mismatch | Specified end time does not math the specified start time. | 结束时间与开始时间不匹配，请您确认时间的匹配度。 |
| 400 | InvalidRecordModeParameter | RecordMode parameter error. | RecordMode参数错误 |
| 400 | InvalidAppIdParameter | AppId parameter error. | AppId参数错误 |
| 400 | InvalidTimeSpan | The time span exceeds the limit. | 时间跨度超过限制，请参照接口文档，配置合理查询跨度。 |
访问错误中心查看更多错误码。
变更历史
更多信息，参考变更详情。