实时查询单路流状态。
接口说明
先获取直播域名，再调用本接口实时查询单路流状态。关于不在线状态（offline）的详细信息，请根据推流回调返回的数据获取，本接口不做细分。
QPS 限制
本接口的单用户 QPS 限制为 100 次/秒。超过限制，API 调用会被限流，这可能会影响您的业务，请合理调用。
调试
您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。
调试
授权信息
|
操作 |
访问级别 |
资源类型 |
条件关键字 |
关联操作 |
|
live:DescribeLiveStreamState |
get |
*全部资源
|
无 | 无 |
请求参数
|
名称 |
类型 |
必填 |
描述 |
示例值 |
| RegionId |
string |
否 |
地域 ID。 |
cn-shanghai |
| DomainName |
string |
是 |
直播推流域名或播流域名。 |
demo.aliyundoc.com |
| AppName |
string |
是 |
直播流所属应用名称。您可在流管理页面查看 AppName。 |
liveApp**** |
| StreamName |
string |
是 |
直播流名称。您可在流管理页面查看 StreamName。 |
liveStream**** |
返回参数
|
名称 |
类型 |
描述 |
示例值 |
|
object |
|||
| Type |
string |
推流接入的类型。取值：
|
push |
| RequestId |
string |
请求 ID。 |
CE6CD79D-0A98-1F22-A15F-FADA74DF2729 |
| StreamState |
string |
流状态。取值：
|
online |
示例
正常返回示例
JSON格式
{
"Type": "push",
"RequestId": "CE6CD79D-0A98-1F22-A15F-FADA74DF2729",
"StreamState": "online"
}错误码
|
HTTP status code |
错误码 |
错误信息 |
描述 |
|---|---|---|---|
| 400 | InvalidParam | Parameter invalid. | 输入参数不合法 |
| 500 | InternalError | The request processing has failed due to backend service exception. |
访问错误中心查看更多错误码。
变更历史
更多信息，参考变更详情。