查询直播录制转点播配置 - 视频直播

使用说明

先获取播流域名，再调用本接口查询直播转点播配置列表。

QPS限制

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

调试

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

请求参数

名称	类型	是否必选	示例值	描述
Action	String	是	DescribeLiveRecordVodConfigs	系统规定参数。取值：DescribeLiveRecordVodConfigs。
DomainName	String	是	example.com	主播流域名。
AppName	String	否	liveApp****	播流所属应用名称。
StreamName	String	否	liveStream****	播流名称。
PageNum	Long	否	1	分页的页码。默认值：1。
PageSize	Long	否	10	每页大小。默认值为10，取值范围：5~100。

返回数据

名称	类型	示例值	描述
PageNum	Integer	1	分页页码。
RequestId	String	5056369B-D337-499E-B8B7-B761BD37B08A	请求ID。
PageSize	Integer	1	分页大小。
Total	String	100	总数。
LiveRecordVodConfigs	Array of LiveRecordVodConfig		配置信息列表。
LiveRecordVodConfig
StorageLocation	String	****-tjptr2vatm.oss-cn-shanghai.aliyuncs.com	存储地址。
AppName	String	liveApp****	直播流所属应用名称。
AutoCompose	String	ON	是否开启自动合并。取值： ON：开启 OFF：关闭
OnDemand	Integer	0	按需录制，取值： 0（默认值）：关闭。 1：通过HTTP回调方式。
StreamName	String	liveStream****	播流名称。
CreateTime	String	2015-12-01T17:37:00Z	创建时间。格式为：yyyy-MM-ddTHH:mm:ssZ（UTC时间）。
VodTranscodeGroupId	String	e2d796d3bb5fd8049d32bff62f94****	点播转码组模板ID。
CycleDuration	Integer	360	周期录制时长。单位：秒。默认值为3600，取值范围：300~21600。
DomainName	String	example.com	主播流域名。
ComposeVodTranscodeGroupId	String	dadfcaadde****	自动合并点播转码模板组ID。说明如果DescribeLiveRecordVodConfigs接口的AutoCompose设置为ON，则返回本参数。

示例

请求示例

http(s)://live.aliyuncs.com/?Action=DescribeLiveRecordVodConfigs
&DomainName=example.com
&AppName=liveApp****
&StreamName=liveStream****
&PageNum=1
&PageSize=10
&公共请求参数

正常返回示例

XML格式

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

<DescribeLiveRecordVodConfigsResponse>
    <PageNum>1</PageNum>
    <RequestId>5056369B-D337-499E-B8B7-B761BD37B08A</RequestId>
    <PageSize>1</PageSize>
    <Total>100</Total>
    <LiveRecordVodConfigs>
        <LiveRecordVodConfig>
            <StorageLocation>****-tjptr2vatm.oss-cn-shanghai.aliyuncs.com</StorageLocation>
            <AppName>liveApp****</AppName>
            <AutoCompose>ON</AutoCompose>
            <OnDemand>0</OnDemand>
            <StreamName>liveStream****</StreamName>
            <CreateTime>2015-12-01T17:37:00Z</CreateTime>
            <VodTranscodeGroupId>e2d796d3bb5fd8049d32bff62f94****</VodTranscodeGroupId>
            <CycleDuration>360</CycleDuration>
            <DomainName>example.com</DomainName>
            <ComposeVodTranscodeGroupId>dadfcaadde****</ComposeVodTranscodeGroupId>
        </LiveRecordVodConfig>
    </LiveRecordVodConfigs>
</DescribeLiveRecordVodConfigsResponse>

JSON格式

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

{
  "PageNum" : 1,
  "RequestId" : "5056369B-D337-499E-B8B7-B761BD37B08A",
  "PageSize" : 1,
  "Total" : 100,
  "LiveRecordVodConfigs" : {
    "LiveRecordVodConfig" : [ {
      "StorageLocation" : "****-tjptr2vatm.oss-cn-shanghai.aliyuncs.com",
      "AppName" : "liveApp****",
      "AutoCompose" : "ON",
      "OnDemand" : 0,
      "StreamName" : "liveStream****",
      "CreateTime" : "2015-12-01T17:37:00Z",
      "VodTranscodeGroupId" : "e2d796d3bb5fd8049d32bff62f94****",
      "CycleDuration" : 360,
      "DomainName" : "example.com",
      "ComposeVodTranscodeGroupId" : "dadfcaadde****"
    } ]
  }
}

错误码

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