调用DescribeLiveGrtnDuration查询连麦通话时长用量数据。
使用说明
- 最大查询跨度:31天。
- 最小查询粒度:5分钟。
- 最大查询范围:最近90天的数据。
QPS限制
本接口的单用户QPS限制为10次/秒。超过限制,API调用会被限流,这可能会影响您的业务,请合理调用。更多信息,请参见QPS限制。
调试
您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。
请求参数
名称 |
类型 |
是否必选 |
示例值 |
描述 |
Action | String | 是 | DescribeLiveGrtnDuration | 系统规定参数。取值:DescribeLiveGrtnDuration。 |
StartTime | String | 是 | 2022-10-10T20:00:00Z | 获取数据起始时间点,日期格式按照ISO8601表示法,并使用UTC时间,格式为:YYYY-MM-DDThh:mm:ssZ。 |
EndTime | String | 是 | 2022-10-10T21:00:00Z | 结束时间需大于起始时间,查询粒度≥5分钟且≤31天;日期格式按照ISO8601表示法,并使用UTC时间,格式为:YYYY-MM-DDThh:mm:ssZ。 |
AppId | String | 否 | 4346289a-a790-4869-9e23-22766d5e**** | 应用ID,支持查询多个应用ID,多个ID用逗号(半角)分隔,最多可查询30个ID。默认返回所有应用合并后的数据。 |
Area | String | 否 | CN | 区域代号。支持:
不传值时默认为所有区域数据聚合输出。 |
Interval | String | 否 | 3600 | 查询数据的时间粒度。单位:秒。取值:
不传或传值不支持时,使用默认值3600秒。 |
返回数据
名称 |
类型 |
示例值 |
描述 |
RequestId | String | 4B460F8B-993C-4F48-B98A-910811DEBFEB | 该条任务请求ID。 |
StreamDetailData | Array of StreamData | 连麦用量数据明细。 |
|
StreamData | |||
AppId | String | 4346289a-a790-4869-9e23-22766d5e**** | 应用ID。 |
Duration | Long | 30 | 连麦时长,单位:分钟。 |
MediaProfile | String | 480P | 媒体规格,取值:
|
MediaType | String | audio | 媒体类型,取值:
|
TimeStamp | String | 2022-12-10T20:00:00Z | 时间片起始时刻。 |
示例
请求示例
http://live.aliyuncs.com?Action=DescribeLiveGrtnDuration&DomainName=example.com
&StartTime=2022-12-10T20:00:00Z
&EndTime=2022-12-10T22:00:00Z
&Area=CN,OverSeas
&<公共请求参数>
正常返回示例
XML
格式
HTTP/1.1 200 OK
Content-Type:application/xml
<DescribeLiveGrtnDurationResponse>
<StreamDetailData>
<StreamData>
<TimeStamp>2022-12-10T20:00:00Z</TimeStamp>
<MediaType>video</MediaType>
<MediaProfile>720P</MediaProfile>
<Duration>423304182</Duration>
</StreamData>
<StreamData>
<TimeStamp>2022-12-10T21:00:00Z</TimeStamp>
<MediaType>video</MediaType>
<MediaProfile>720P</MediaProfile>
<Duration>454680793</Duration>
</StreamData>
</StreamDetailData>
<RequestId>B955107D-E658-4E77-B913-E0AC3D31693E</RequestId>
</DescribeLiveGrtnDurationResponse>
JSON
格式
HTTP/1.1 200 OK
Content-Type:application/json
{
"StreamDetailData" : {
"StreamData" : [ {
"TimeStamp" : "2022-12-10T20:00:00Z",
"MediaType" : "video",
"MediaProfile" : "720P",
"Duration" : "423304182"
}, {
"TimeStamp" : "2022-12-10T21:00:00Z",
"MediaType" : "video",
"MediaProfile" : "720P",
"Duration" : "454680793"
} ]
},
"RequestId" : "B955107D-E658-4E77-B913-E0AC3D31693E"
}
错误码
HttpCode |
错误码 |
错误信息 |
描述 |
400 | InvalidStartTime.Malformed | Specified StartTime is malformed. | StartTime参数错误,请您确认该StartTime参数是否正确。 |
400 | InvalidEndTime.Malformed | Specified 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 | InvalidTime.ValueNotSupported | Specified Time is malformed. | 开始时间和结束时间不匹配。 |
访问错误中心查看更多错误码。
特殊错误码
错误代码 |
描述 |
HTTP状态码 |
语义 |
Throttling |
Request was denied due to request throttling. |
503 |
请求被流量控制限制。 |
IllegalOperation |
Illegal domain, operation is not permitted. |
403 |
非法域名,无法操作。 |
OperationDenied |
Your account does not open LIVE service yet. |
403 |
未开通LIVE服务。 |
OperationDenied |
Your LIVE service is suspended. |
403 |
LIVE服务已被停止。 |
InvalidStartTime.Malformed |
Specified StartTime is malformed. |
400 |
参数错误。 |
InvalidEndTime.Malformed |
Specified EndTime is malformed. |
400 |
时间格式错误。 |
InvalidTime.Malformed |
Specified StartTime or EndTime is malformed. |
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 |
AppID参数错误。 |
InvalidParameterInterval |
Invalid Parameter Interval. |
400 |
Interval参数错误。 |