调用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

转推有效时间。取值:

  • always:永久生效。
  • 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"
  } ]
}

错误码

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