调用DescribeLiveGrtnDuration查询连麦通话时长用量数据。
接口说明
最大查询跨度:31 天。
最小查询粒度:5 分钟。
最大查询范围:最近 90 天的数据。
QPS 限制
本接口的单用户 QPS 限制为 10 次/秒。超过限制,API 调用会被限流,这可能会影响您的业务,请合理调用。
调试
您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。

授权信息
操作 |
访问级别 |
资源类型 |
条件关键字 |
关联操作 |
live:DescribeLiveGrtnDuration |
*Domain
|
无 | 无 |
请求参数
名称 |
类型 |
必填 |
描述 |
示例值 |
RegionId |
string |
否 |
||
StartTime |
string |
是 |
获取数据起始时间点,日期格式按照 ISO8601 表示法,并使用 UTC 时间,格式为:YYYY-MM-DDThh:mm:ssZ。 |
2022-10-10T20:00:00Z |
EndTime |
string |
是 |
结束时间需大于起始时间,查询粒度≥5 分钟且≤31 天;日期格式按照 ISO8601 表示法,并使用 UTC 时间,格式为:YYYY-MM-DDThh:mm:ssZ。 |
2022-10-10T21:00:00Z |
AppId |
string |
否 |
应用 ID,支持查询多个应用 ID,多个 ID 用逗号(半角)分隔,最多可查询 30 个 ID。默认返回所有应用合并后的数据。 |
4346289a-a790-4869-9e23-22766d5e**** |
Area |
string |
否 |
区域代号。支持:
不传值时默认为所有区域数据聚合输出。 |
CN |
Interval |
string |
否 |
查询数据的时间粒度。单位:秒。取值:
不传或传值不支持时,使用默认值 3600 秒。 |
3600 |
返回参数
名称 |
类型 |
描述 |
示例值 |
object |
返回数据。 |
||
RequestId |
string |
该条任务请求 ID。 |
4B460F8B-993C-4F48-B98A-910811DEBFEB |
StreamDetailData |
object |
||
StreamData |
array |
连麦用量数据明细。 |
|
object |
连麦用量数据明细。 |
||
AppId |
string |
应用 ID。 |
4346289a-a790-4869-9e23-22766d5e**** |
Duration |
integer |
连麦时长,单位:分钟。 |
30 |
MediaProfile |
string |
媒体规格,取值:
|
480P |
MediaType |
string |
媒体类型,取值:
|
audio |
TimeStamp |
string |
时间片起始时刻。 |
2022-12-10T20:00:00Z |
错误码
HTTP status code |
错误码 |
错误信息 |
描述 |
---|---|---|---|
400 | InvalidStartTime.Malformed | Specified StartTime is malformed. | |
400 | InvalidEndTime.Malformed | Specified EndTime is malformed. | |
400 | InvalidTime.Malformed | Specified StartTime or EndTime is malformed. | |
400 | InvalidAreaParameter | The specified Area parameter is invalid. | Area参数不正确,需要传入正确的大区简写。 |
400 | InvalidEndTime.Mismatch | Specified end time does not math the specified start time. | 结束时间与开始时间不匹配,请您确认时间的匹配度。 |
400 | InvalidTimeSpan | The time span exceeds the limit. | 时间跨度超过限制,请参照接口文档,配置合理查询跨度。 |
400 | InvalidAppIdParameter | The specified AppId parameter is invalid. | |
400 | InvalidInstanceIdParameter | The specified InstanceId parameter is invalid. | |
400 | InvalidTime.ValueNotSupported | Specified Time is malformed. | 指定的时间无效。 |
访问错误中心查看更多错误码。
变更历史
更多信息,参考变更详情。