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

错误码

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