调用DescribeLiveRecordConfig查询直播域名下所有APP录制配置。

调试

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

请求参数

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

系统规定参数。取值：DescribeLiveRecordConfig。

DomainName String 是 www.yourdomain.com

播流域名。
AppName String 否 testApp

播流所属应用名称。
StreamName String 否 myStreamName

播流名称。
PageNum Integer 否 1

当前页码。默认值：1。

PageSize Integer 否 5

每页大小。默认值：10，取值范围：5~30。

Order String 否 asc

排序。取值：

  • asc（默认值）：升序。
  • desc：降序。

返回数据

名称 类型 示例值 描述
RequestId String 5056369B-D337-499E-B8B7-B761BD37B08A

请求ID。
LiveAppRecordList Array of LiveAppRecord

录制配置列表。
LiveAppRecord
DomainName String www.yourdomain.com

播流域名。
AppName String testApp

播流所属应用名称。
OssEndpoint String oss-cn-shanghai.aliyuncs.com

OSS存储的Endpoint名称。
OssBucket String test123

OSS存储Bucket名称。
CreateTime String 2016-05-20T09:33:38Z

创建时间。格式为：yyyy-MM-ddTHH:mm:ssZ（UTC时间）。

RecordFormatList Array of RecordFormat

格式列表。
RecordFormat
Format String M3U8

格式。
OssObjectPrefix String record/{AppName}/{StreamName}

录制文件名称。
SliceOssObjectPrefix String record/{AppName}/{StreamName}/{UnixTimestamp}

切片名称。
CycleDuration Integer 3600

周期录制时间。单位：秒。
EndTime String 2018-11-08T03:49:18Z

计划录制结束时间。格式为：yyyy-MM-ddTHH:mm:ssZ（UTC时间）。

OnDemond Integer 0

按需录制。取值：

  • 0：关闭。
  • 1：通过HTTP回调方式。
  • 2：通过推流参数方式。

当取值为1时，需要设置OnDemandCallback, 否则默认不录制。

StartTime String 2018-11-08T02:49:18Z

计划录制开始时间。格式为：yyyy-MM-ddTHH:mm:ssZ（UTC时间）。

StreamName String myStreamName

直播流名称。
PageNum Integer 5

分页的页码。
PageSize Integer 10

每页大小。
Order String desc

排序。
TotalPage Integer 20

总页数。
TotalNum Integer 12

符合条件的总个数。

示例

请求示例

http(s)://live.aliyuncs.com/?Action=DescribeLiveRecordConfig
&DomainName=www.yourdomain.com
&<公共请求参数>

正常返回示例

XML 格式 

<DescribeLiveRecordConfigResponse>
	  <LiveAppRecordList>
		    <LiveAppRecord>
			      <AppName>aliyuntest</AppName>
			      <CreateTime>2016-05-20T09:33:38Z</CreateTime>
			      <DomainName>www.yourdomain.com</DomainName>
			      <FormatList>
				        <Format>
					          <Name>m3u8</Name>
					          <OssObjectPrefix>record/{AppName}/{StreamName}</OssObjectPrefix>
					          <SliceOssObjectPrefix>record/{AppName}/{StreamName}/{UnixTimestamp}</SliceOssObjectPrefix>
				        </Format>
			      </FormatList>
			      <OssBucket>chimang.bucket</OssBucket>
			      <OssEndpoint>oss-cn-hangzhou.aliyuncs.com</OssEndpoint>
		    </LiveAppRecord>
	  </LiveAppRecordList>
	  <RequestId>5056369B-D337-499E-B8B7-B761BD37B08A</RequestId>
</DescribeLiveRecordConfigResponse>

JSON 格式 

{
    "LiveAppRecordList":{
        "LiveAppRecord":[{
            "AppName":"aliyuntest",
            "CreateTime":"2016-05-20T09:33:38Z",
            "DomainName":"www.yourdomain.com",
            "FormatList":{
                "Format":[{
                    "Name":"m3u8",
                    "OssObjectPrefix":"record/{AppName}/{StreamName}",
                    "SliceOssObjectPrefix":"record/{AppName}/{StreamName}/{UnixTimestamp}"
                }]
            },
            "OssBucket":"chimang.bucket",
            "OssEndpoint":"oss-cn-hangzhou.aliyuncs.com"
        }]
    },
    "RequestId":"5056369B-D337-499E-B8B7-B761BD37B08A"
}

错误码

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