调用DescribeLiveStreamsTotalCount接口获取天粒度累计直播流路数。
使用说明
- 最大查询时间跨度：15天。
- 最大查询时间范围：最长可查近1.5年的数据。
QPS限制
本接口的单用户QPS限制为100次/分钟。超过限制，API调用会被限流，这可能会影响您的业务，请合理调用。更多信息，请参见QPS限制。
调试
您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。
请求参数
|
名称 |
类型 |
是否必选 |
示例值 |
描述 |
| Action | String | 是 | DescribeLiveStreamsTotalCount | 系统规定参数。取值：DescribeLiveStreamsTotalCount。 |
| DomainName | String | 是 | example.com | 推流域名或播放域名，查域名级别数据时必传。最多支持10个域名批量查询，多个域名用半角逗号（,）分隔。 |
| Typ | String | 否 | aliuid | 不传，默认查域名级别的数据。传aliuid查UID维度的数据。 |
| StartTime | String | 是 | 2023-07-24T16:00:00Z | 起始时间。格式为：yyyy-MM-ddTHH:mm:ssZ（UTC时间）。 说明 支持最大的查询范围是最近1.5年。 |
| EndTime | String | 是 | 2023-07-25T16:00:00Z | 结束时间。需晚于开始时间。格式为：yyyy-MM-ddTHH:mm:ssZ（UTC时间）。 说明 StartTime和EndTime时间间隔在15天内，且EndTime不超过当前时间。当天数据第二天才查询。 |
返回数据
名称 |
类型 |
示例值 |
描述 |
| RequestId | String | String FCFFE4A4-F34F-4EEF-B401-36A01689AFBC | 请求ID。 |
| StreamCountList | Array of StreamCountInfos | 流信息统计内容。 |
|
| StreamCountInfos | |||
| Count | Integer | 934 | 累计直播流数量。 |
| Timestamp | String | 2023-07-24T16:00:00Z | 时间。 |
示例
请求示例
http(s)://live.aliyuncs.com/?Action=DescribeLiveStreamsTotalCount
&DomainName=example.com
&Typ=aliuid
&StartTime=2023-07-24T16:00:00Z
&EndTime=2023-07-25T16:00:00Z
&公共请求参数正常返回示例
XML格式
HTTP/1.1 200 OK
Content-Type:application/xml
<DescribeLiveStreamsTotalCountResponse>
<RequestId>String FCFFE4A4-F34F-4EEF-B401-36A01689AFBC</RequestId>
<StreamCountList>
<Count>934</Count>
<Timestamp>2023-07-24T16:00:00Z</Timestamp>
</StreamCountList>
</DescribeLiveStreamsTotalCountResponse>JSON格式
HTTP/1.1 200 OK
Content-Type:application/json
{
"RequestId" : "String\tFCFFE4A4-F34F-4EEF-B401-36A01689AFBC",
"StreamCountList" : [ {
"Count" : 934,
"Timestamp" : "2023-07-24T16:00:00Z"
} ]
}错误码
|
HttpCode |
错误码 |
错误信息 |
描述 |
| 400 | InvalidStartTime.Malformed | Specified StartTime is malformed. | StartTime参数错误，请您确认该StartTime参数是否正确。 |
| 400 | InvalidEndTime.Malformed | Specified EndTime is malformed. | 结束时间错误，请您确认结束时间是否正确。 |
访问错误中心查看更多错误码。
错误代码 |
描述 |
HTTP状态码 |
语义 |
InvalidStartTime.Malformed |
Specified StartTime is malformed. |
400 |
开始时间错误 |
InvalidEndTime.Malformed |
Specified EndTime is malformed. |
400 |
结束时间错误 |
MissingDomainName |
DomainName is mandatory for this action. |
400 |
缺少DomainName值 |
InvalidParam |
Parameter invalid. |
400 |
参数错误 |
Duration.Exceed |
Duration between StartTime and EndTime is too long. |
400 |
查询的时间段过长 |
InvalidDomain.NotFound |
The domain provided does not belong to you. |
404 |
域名不存在或不属于当前用户 |
InternalError |
The request processing has failed due to backend service exception. |
500 |
内部错误 |