调用DescribeLiveCenterTransfer查询直播中心转推配置。
QPS限制
本接口的单用户QPS限制为100次/秒。超过限制,API调用会被限流,这可能会影响您的业务,请合理调用。更多信息,请参见QPS限制。
调试
您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。
请求参数
名称 | 类型 | 是否必选 | 示例值 | 描述 |
---|---|---|---|---|
Action | String | 是 | DescribeLiveCenterTransfer |
系统规定参数。取值:DescribeLiveCenterTransfer。 |
DomainName | String | 是 | example.com |
播流域名。 |
AppName | String | 否 | testapp |
直播流应用名称。输入的AppName必须与需要转推的直播流AppName保持一致,方可生效。 |
StreamName | String | 否 | teststream |
直播流名称。 |
DstUrl | String | 否 | rtmp://push.example2.aliyunlive.com/testapp1/teststream2 |
转推的第三方直播地址。 |
返回数据
名称 | 类型 | 示例值 | 描述 |
---|---|---|---|
RequestId | String | C4865B85-664B-19D3-BB16-C62FB83C8226 |
请求ID。 |
LiveCenterTransferInfoList | Array of LiveCenterTransferInfo | ||
LiveCenterTransferInfo | |||
EndTime | String | 2022-04-29T15:16:00Z |
转推结束时间。 |
AppName | String | teststream |
直播流应用名称。 |
StartTime | String | 2022-04-28T15:16:00Z |
转推开始时间。 |
TransferArgs | String | time |
转推有效时间。取值:
|
StreamName | String | teststream |
直播流名称。 |
DstUrl | String | rtmp://push.example2.aliyunlive.com/testapp1/teststream2 |
转推的第三方直播地址。 |
DomainName | String | example.com |
播流域名。 |
示例
请求示例
http(s)://live.aliyuncs.com/?Action=DescribeLiveCenterTransfer
&DomainName=example.com
&公共请求参数
正常返回示例
XML
格式
HTTP/1.1 200 OK
Content-Type:application/xml
<DescribeLiveCenterTransferResponse>
<RequestId>C4865B85-664B-19D3-BB16-C62FB83C8226</RequestId>
<LiveCenterTransferInfoList>
<EndTime>2022-04-29T15:16:00Z</EndTime>
<AppName>teststream</AppName>
<StartTime>2022-04-28T15:16:00Z</StartTime>
<TransferArgs>time</TransferArgs>
<StreamName>teststream</StreamName>
<DstUrl>rtmp://push.example2.aliyunlive.com/testapp1/teststream2</DstUrl>
<DomainName>example.com</DomainName>
</LiveCenterTransferInfoList>
</DescribeLiveCenterTransferResponse>
JSON
格式
HTTP/1.1 200 OK
Content-Type:application/json
{
"RequestId" : "C4865B85-664B-19D3-BB16-C62FB83C8226",
"LiveCenterTransferInfoList" : [ {
"EndTime" : "2022-04-29T15:16:00Z",
"AppName" : "teststream",
"StartTime" : "2022-04-28T15:16:00Z",
"TransferArgs" : "time",
"StreamName" : "teststream",
"DstUrl" : "rtmp://push.example2.aliyunlive.com/testapp1/teststream2",
"DomainName" : "example.com"
} ]
}
错误码
访问错误中心查看更多错误码。