调用DescribeLiveEdgeTransfer查询直播边缘转推配置。

使用说明

先获取推流域名,再调用本接口查询直播边缘转推配置。

QPS限制

本接口的单用户QPS限制为100次/秒。超过限制,API调用会被限流,这可能会影响您的业务,请合理调用。更多信息,请参见QPS限制

调试

您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。

请求参数

名称 类型 是否必选 示例值 描述
Action String DescribeLiveEdgeTransfer

系统规定参数。取值:DescribeLiveEdgeTransfer

DomainName String demo.aliyundoc.com

推流域名。

返回数据

名称 类型 示例值 描述
HttpDns String http://developer.aliyundoc.com/****

获取转推目标地址的HTTPDNS接口。

AppName String liveApp****

直播流所属应用名称。

RequestId String 53FCB985-C67C-467B-B2B3-398430A21E14

请求ID。

TransferArgs String yes

推流参数是否透传。取值:

  • yes:推流参数透传。
  • no:推流参数不透传。
StreamName String liveStream****

推流名称。

TargetDomainList String learn.aliyundoc.com,guide.aliyundoc.com

转推域名列表,多个用英文逗号(,)分隔。

DomainName String demo.aliyundoc.com

推流域名。

示例

请求示例

http(s)://live.aliyuncs.com/?Action=DescribeLiveEdgeTransfer
&DomainName=demo.aliyundoc.com
&<公共请求参数>

正常返回示例

XML格式

HTTP/1.1 200 OK
Content-Type:application/xml

<?xml version="1.0" encoding="UTF-8" ?>
<DescribeLiveEdgeTransferResponse>
<StreamName>liveStream****</StreamName>
<RequestId>53FCB985-C67C-467B-B2B3-398430A21E14</RequestId>
<DomainName>demo.aliyundoc.com</DomainName>
<TransferArgs>yes</TransferArgs>
<HttpDns>http://developer.aliyundoc.com/****</HttpDns>
<TargetDomainList>learn.aliyundoc.com,guide.aliyundoc.com</TargetDomainList>
<AppName>liveApp****</AppName>
</DescribeLiveEdgeTransferResponse>

JSON格式

HTTP/1.1 200 OK
Content-Type:application/json

{
  "DescribeLiveEdgeTransferResponse" : {
    "StreamName" : "liveStream****",
    "RequestId" : "53FCB985-C67C-467B-B2B3-398430A21E14",
    "DomainName" : "demo.aliyundoc.com",
    "TransferArgs" : "yes",
    "HttpDns" : "http://developer.aliyundoc.com/****",
    "TargetDomainList" : "learn.aliyundoc.com,guide.aliyundoc.com",
    "AppName" : "liveApp****"
  }
}

错误码

访问错误中心查看更多错误码。