查詢直播域名下所有APP錄制配置。
QPS限制
本接口的單用戶QPS限制為100次/秒。超過限制,API調用會被限流,這可能會影響您的業務,請合理調用。更多信息,請參見QPS限制。
調試
您可以在OpenAPI Explorer中直接運行該接口,免去您計算簽名的困擾。運行成功后,OpenAPI Explorer可以自動生成SDK代碼示例。
請求參數
名稱 |
類型 |
是否必選 |
示例值 |
描述 |
Action | String | 是 | DescribeLiveRecordConfig | 系統規定參數。取值:DescribeLiveRecordConfig。 |
DomainName | String | 是 | example.com | 主播流域名。 |
AppName | String | 否 | liveApp**** | 播流所屬應用名稱。 |
StreamName | String | 否 | liveStream**** | 播流名稱。 |
PageNum | Integer | 否 | 1 | 當前頁碼。默認值:1。 |
PageSize | Integer | 否 | 5 | 每頁大小。默認值:10,取值范圍:5~30。 |
Order | String | 否 | asc | 按創建時間排序。取值:
|
返回數據
名稱 |
類型 |
示例值 |
描述 |
PageNum | Integer | 5 | 分頁的頁碼。 |
RequestId | String | 5056369B-D337-499E-B8B7-B761BD37B08A | 請求ID。 |
Order | String | desc | 排序。 |
TotalPage | Integer | 20 | 總頁數。 |
PageSize | Integer | 10 | 每頁大小。 |
TotalNum | Integer | 12 | 符合條件的總個數。 |
LiveAppRecordList | Array of LiveAppRecord | 錄制配置列表。 |
|
LiveAppRecord | |||
EndTime | String | 2018-11-08T03:49:18Z | 計劃錄制結束時間。格式為:yyyy-MM-ddTHH:mm:ssZ(UTC時間)。 |
StartTime | String | 2018-11-08T02:49:18Z | 計劃錄制開始時間。格式為:yyyy-MM-ddTHH:mm:ssZ(UTC時間)。 |
AppName | String | liveApp**** | 播流所屬應用名稱。 |
StreamName | String | liveStream**** | 直播流名稱。 |
DelayTime | Integer | 180 | 斷流拼接時長。 直播斷流時長超過設定的拼接時長后,將會生成新文件,斷流拼接時長支持15~21600秒。 |
CreateTime | String | 2016-05-20T09:33:38Z | 創建時間。格式為:yyyy-MM-ddTHH:mm:ssZ(UTC時間)。 |
OnDemond | Integer | 0 | 按需錄制。取值:
說明 當OnDemand取值為1時,需要先通過AddLiveRecordNotifyConfig接口配置OnDemandUrl,否則默認不錄制。 |
OssBucket | String | liveBucket**** | OSS存儲Bucket名稱。 |
DomainName | String | example.com | 主播流域名。 |
OssEndpoint | String | cn-oss-****.aliyuncs.com | OSS存儲的Endpoint名稱。 |
RecordFormatList | Array of RecordFormat | 格式列表。 |
|
RecordFormat | |||
SliceDuration | Integer | 30 | 轉碼流錄制單個切片時長。單位:秒。 |
CycleDuration | Integer | 3600 | 周期錄制時間。單位:秒。 |
SliceOssObjectPrefix | String | record/{liveApp****}/{liveStream****}/{UnixTimestamp} | 切片名稱。 |
OssObjectPrefix | String | record/{liveApp****}/{liveStream****} | 錄制文件名稱。 |
Format | String | M3U8 | 格式。 |
TranscodeRecordFormatList | Array of RecordFormat | 轉碼流錄制格式列表。 |
|
RecordFormat | |||
SliceDuration | Integer | 30 | 轉碼流錄制單個切片時長。單位:秒。 |
CycleDuration | Integer | 3600 | 周期錄制時間。單位:秒。 |
SliceOssObjectPrefix | String | record/{liveApp****}/{liveStream****}/{UnixTimestamp} | 轉碼流錄制切片名稱。 |
OssObjectPrefix | String | record/{liveApp****}/{liveStream****} | 轉碼流錄制文件名稱。 |
Format | String | M3U8 | 轉碼流錄制格式。 |
TranscodeTemplates | Array of String | ["sd","hd"] | 轉碼流錄制的轉碼模板。設置了錄制所有轉碼流,則返回為["*"]。 |
示例
請求示例
http(s)://live.aliyuncs.com/?Action=DescribeLiveRecordConfig
&DomainName=example.com
&<公共請求參數>
正常返回示例
XML
格式
HTTP/1.1 200 OK
Content-Type:application/xml
<?xml version="1.0" encoding="UTF-8" ?>
<DescribeLiveRecordConfigResponse>
<Order>desc</Order>
<TotalNum>12</TotalNum>
<TotalPage>20</TotalPage>
<PageSize>10</PageSize>
<PageNum>5</PageNum>
<RequestId>5056369B-D337-499E-B8B7-B761BD37B08A</RequestId>
<LiveAppRecordList>
<LiveAppRecord>
<StreamName>liveStream****</StreamName>
<EndTime>2018-11-08T03:49:18Z</EndTime>
<OssEndpoint>cn-oss-****.aliyuncs.com</OssEndpoint>
<DomainName>example.com</DomainName>
<CreateTime>2016-05-20T09:33:38Z</CreateTime>
<StartTime>2018-11-08T02:49:18Z</StartTime>
<OssBucket>liveBucket****</OssBucket>
<OnDemond>0</OnDemond>
<AppName>liveApp****</AppName>
<RecordFormatList>
<RecordFormat>
<Format>M3U8</Format>
<SliceOssObjectPrefix>record/{liveApp****}/{liveStream****}/{UnixTimestamp}</SliceOssObjectPrefix>
<CycleDuration>3600</CycleDuration>
<SliceDuration>30</SliceDuration>
<OssObjectPrefix>record/{liveApp****}/{liveStream****}</OssObjectPrefix>
</RecordFormat>
</RecordFormatList>
<TranscodeRecordFormatList>
<RecordFormat>
<Format>M3U8</Format>
<SliceOssObjectPrefix>record/{liveApp****}/{liveStream****}/{UnixTimestamp}</SliceOssObjectPrefix>
<CycleDuration>3600</CycleDuration>
<SliceDuration>30</SliceDuration>
<OssObjectPrefix>record/{liveApp****}/{liveStream****}</OssObjectPrefix>
</RecordFormat>
</TranscodeRecordFormatList>
<TranscodeTemplates>
<Templates>["sd","hd"]</Templates>
</TranscodeTemplates>
</LiveAppRecord>
</LiveAppRecordList>
</DescribeLiveRecordConfigResponse>
JSON
格式
HTTP/1.1 200 OK
Content-Type:application/json
{
"DescribeLiveRecordConfigResponse" : {
"Order" : "desc",
"TotalNum" : 12,
"TotalPage" : 20,
"PageSize" : 10,
"PageNum" : 5,
"RequestId" : "5056369B-D337-499E-B8B7-B761BD37B08A",
"LiveAppRecordList" : {
"LiveAppRecord" : {
"StreamName" : "liveStream****",
"EndTime" : "2018-11-08T03:49:18Z",
"OssEndpoint" : "cn-oss-****.aliyuncs.com",
"DomainName" : "example.com",
"CreateTime" : "2016-05-20T09:33:38Z",
"StartTime" : "2018-11-08T02:49:18Z",
"OssBucket" : "liveBucket****",
"OnDemond" : 0,
"AppName" : "liveApp****",
"RecordFormatList" : {
"RecordFormat" : {
"Format" : "M3U8",
"SliceOssObjectPrefix" : "record/{liveApp****}/{liveStream****}/{UnixTimestamp}",
"CycleDuration" : 3600,
"SliceDuration" : 30,
"OssObjectPrefix" : "record/{liveApp****}/{liveStream****}"
}
},
"TranscodeRecordFormatList" : {
"RecordFormat" : {
"Format" : "M3U8",
"SliceOssObjectPrefix" : "record/{liveApp****}/{liveStream****}/{UnixTimestamp}",
"CycleDuration" : 3600,
"SliceDuration" : 30,
"OssObjectPrefix" : "record/{liveApp****}/{liveStream****}"
}
},
"TranscodeTemplates" : {
"Templates" : "[\"sd\",\"hd\"]"
}
}
}
}
}
錯誤碼
訪問錯誤中心查看更多錯誤碼。