全部產品
Search
文件中心

ApsaraVideo Live:DescribeLiveRecordConfig - 查詢網域名稱下所有App錄製配置

更新時間:Dec 13, 2025

查詢直播網域名稱下所有APP錄製配置。

介面說明

先擷取主播流網域名稱,再調用本介面查詢直播網域名稱下所有 APP 錄製配置。

QPS 限制

本介面的單使用者 QPS 限制為 100 次/秒。超過限制,API 呼叫會被限流,這可能會影響您的業務,請合理調用。

調試

您可以在OpenAPI Explorer中直接運行該介面,免去您計算簽名的困擾。運行成功後,OpenAPI Explorer可以自動產生SDK程式碼範例。

調試

授權資訊

下表是API對應的授權資訊,可以在RAM權限原則語句的Action元素中使用,用來給RAM使用者或RAM角色授予調用此API的許可權。具體說明如下:

  • 操作:是指具體的許可權點。

  • 存取層級:是指每個操作的存取層級,取值為寫入(Write)、讀取(Read)或列出(List)。

  • 資源類型:是指操作中支援授權的資源類型。具體說明如下:

    • 對於必選的資源類型,用前面加 * 表示。

    • 對於不支援資源級授權的操作,用全部資源表示。

  • 條件關鍵字:是指雲產品自身定義的條件關鍵字。

  • 關聯操作:是指成功執行操作所需要的其他許可權。操作者必須同時具備關聯操作的許可權,操作才能成功。

操作

存取層級

資源類型

條件關鍵字

關聯操作

live:DescribeLiveRecordConfig

get

*全部資源

*

請求參數

名稱

類型

必填

描述

樣本值

DomainName

string

主播流網域名稱。

example.com

AppName

string

播流所屬應用程式名稱。

liveApp****

StreamName

string

播流名稱。

liveStream****

PageNum

integer

當前頁碼。預設值:1

1

PageSize

integer

每頁大小。預設值:10,取值範圍:5~30

5

Order

string

按建立時間排序。取值:

  • asc(預設值):升序。

  • desc:降序。

asc

返回參數

名稱

類型

描述

樣本值

object

PageNum

integer

分頁的頁碼。

5

RequestId

string

請求 ID。

5056369B-D337-499E-B8B7-B761BD37B08A

Order

string

排序。

desc

TotalPage

integer

總頁數。

20

PageSize

integer

每頁大小。

10

TotalNum

integer

合格總個數。

12

LiveAppRecordList

object

LiveAppRecord

array<object>

錄製配置列表。

array<object>

錄製配置列表。

EndTime

string

計劃錄製結束時間。格式為:yyyy-MM-ddTHH:mm:ssZ(UTC 時間)。

2018-11-08T03:49:18Z

StartTime

string

計劃錄製開始時間。格式為:yyyy-MM-ddTHH:mm:ssZ(UTC 時間)。

2018-11-08T02:49:18Z

AppName

string

播流所屬應用程式名稱。

liveApp****

StreamName

string

直播流名稱。

liveStream****

DelayTime

integer

斷流拼接時間長度。 直播斷流時間長度超過設定的拼接時間長度後,將會產生新檔案,斷流拼接時間長度支援 15~21600 秒。

180

CreateTime

string

建立時間。格式為:yyyy-MM-ddTHH:mm:ssZ(UTC 時間)。

2016-05-20T09:33:38Z

OnDemond

integer

按需錄製。取值:

  • 0:關閉。

  • 1:通過 HTTP 回調方式。

  • 2:通過推流參數方式。

  • 7:預設不錄製,可以通過 RealTimeRecordCommand 介面手動控制錄製開啟或停止。

說明

當 OnDemand 取值為 1 時,需要先通過 AddLiveRecordNotifyConfig 介面配置 OnDemandUrl,否則預設不錄製。

0

OssBucket

string

OSS 儲存 Bucket 名稱。

liveBucket****

DomainName

string

主播流網域名稱。

example.com

OssEndpoint

string

OSS 儲存的 Endpoint 名稱。

cn-oss-****.aliyuncs.com

RecordFormatList

object

RecordFormat

array<object>

格式列表。

object

格式列表。

SliceDuration

integer

轉碼流錄製單個切片時間長度。單位:秒。

30

CycleDuration

integer

周期錄製時間。單位:秒。

3600

SliceOssObjectPrefix

string

切片名稱。

record/{liveApp****}/{liveStream****}/{UnixTimestamp}

OssObjectPrefix

string

錄製檔案名稱。

record/{liveApp****}/{liveStream****}

Format

string

格式。

M3U8

TranscodeRecordFormatList

object

RecordFormat

array<object>

轉碼流錄製格式列表。

object

錄製設定檔格式列表。

SliceDuration

integer

轉碼流錄製單個切片時間長度。單位:秒。

30

CycleDuration

integer

周期錄製時間。單位:秒。

3600

SliceOssObjectPrefix

string

轉碼流錄製切片名稱。

record/{liveApp****}/{liveStream****}/{UnixTimestamp}

OssObjectPrefix

string

轉碼流錄製檔案名稱。

record/{liveApp****}/{liveStream****}

Format

string

轉碼流錄製格式。

M3U8

TranscodeTemplates

object

Templates

array

轉碼模板。

string

轉碼流錄製的轉碼模板。設定了錄製所有轉碼流,則返回為["*"]。

["sd","hd"]

樣本

正常返回樣本

JSON格式

{
  "PageNum": 5,
  "RequestId": "5056369B-D337-499E-B8B7-B761BD37B08A",
  "Order": "desc",
  "TotalPage": 20,
  "PageSize": 10,
  "TotalNum": 12,
  "LiveAppRecordList": {
    "LiveAppRecord": [
      {
        "EndTime": "2018-11-08T03:49:18Z",
        "StartTime": "2018-11-08T02:49:18Z",
        "AppName": "liveApp****",
        "StreamName": "liveStream****",
        "DelayTime": 180,
        "CreateTime": "2016-05-20T09:33:38Z",
        "OnDemond": 0,
        "OssBucket": "liveBucket****",
        "DomainName": "example.com",
        "OssEndpoint": "cn-oss-****.aliyuncs.com",
        "RecordFormatList": {
          "RecordFormat": [
            {
              "SliceDuration": 30,
              "CycleDuration": 3600,
              "SliceOssObjectPrefix": "record/{liveApp****}/{liveStream****}/{UnixTimestamp}",
              "OssObjectPrefix": "record/{liveApp****}/{liveStream****}",
              "Format": "M3U8"
            }
          ]
        },
        "TranscodeRecordFormatList": {
          "RecordFormat": [
            {
              "SliceDuration": 30,
              "CycleDuration": 3600,
              "SliceOssObjectPrefix": "record/{liveApp****}/{liveStream****}/{UnixTimestamp}",
              "OssObjectPrefix": "record/{liveApp****}/{liveStream****}",
              "Format": "M3U8"
            }
          ]
        },
        "TranscodeTemplates": {
          "Templates": [
            "[\"sd\",\"hd\"]"
          ]
        }
      }
    ]
  }
}

錯誤碼

訪問錯誤中心查看更多錯誤碼。

變更歷史

更多資訊,參考變更詳情