使用DescribeLiveRecordVodConfigs查詢直播錄製轉點播配置-ApsaraVideo for Live-阿里雲 - ApsaraVideo Live

查詢直播轉點播配置列表。

介面說明

先擷取播流網域名稱，再調用本介面查詢直播轉點播配置列表。

QPS 限制

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

調試

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

調試

授權資訊

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

操作：是指具體的許可權點。
存取層級：是指每個操作的存取層級，取值為寫入（Write）、讀取（Read）或列出（List）。
資源類型：是指操作中支援授權的資源類型。具體說明如下：
- 對於必選的資源類型，用前面加 * 表示。
- 對於不支援資源級授權的操作，用全部資源表示。
條件關鍵字：是指雲產品自身定義的條件關鍵字。
關聯操作：是指成功執行操作所需要的其他許可權。操作者必須同時具備關聯操作的許可權，操作才能成功。

操作

存取層級

資源類型

條件關鍵字

關聯操作

live:DescribeLiveRecordVodConfigs

get

*全部資源

*

無

請求參數

名稱	類型	必填	描述	樣本值
RegionId	string	否	地區 ID。	cn-shanghai
DomainName	string	是	主播流網域名稱。	example.com
AppName	string	否	播流所屬應用程式名稱。	liveApp****
StreamName	string	否	播流名稱。	liveStream****
PageNum	integer	否	分頁的頁碼。預設值：1。	1
PageSize	integer	否	每頁大小。預設值為 10，取值範圍：5~100。	10

返回參數

名稱	類型	描述	樣本值
	object
PageNum	integer	分頁頁碼。	1
RequestId	string	請求 ID。	5056369B-D337-499E-B8B7-B761BD37B08A
PageSize	integer	分頁大小。	1
Total	string	總數。	100
LiveRecordVodConfigs	object
LiveRecordVodConfig	array<object>	配置資訊列表。
	array<object>	錄製到 vod 配置項
StorageLocation	string	儲存地址。	****-tjptr2vatm.oss-cn-shanghai.aliyuncs.com
AppName	string	直播流所屬應用程式名稱。	liveApp****
AutoCompose	string	是否開啟自動合并。取值： ON：開啟 OFF：關閉	ON
OnDemand	integer	按需錄製，取值： 0（預設值）：關閉。 1：通過 HTTP 回調方式。 2：按需錄製，通過解析推流參數。。 7：手動錄製，預設不錄製，可以通過 RealTimeRecordCommand 介面手動控制錄製開啟或停止。	0
StreamName	string	播流名稱。	liveStream****
CreateTime	string	建立時間。格式為：yyyy-MM-ddTHH:mm:ssZ（UTC 時間）。	2015-12-01T17:37:00Z
VodTranscodeGroupId	string	點播轉碼組模板 ID。	e2d796d3bb5fd8049d32bff62f94****
CycleDuration	integer	周期錄製時間長度。單位：秒。預設值為 3600，取值範圍：300~21600。	360
DomainName	string	主播流網域名稱。	example.com
ComposeVodTranscodeGroupId	string	自動合并點播轉碼模板組 ID。說明如果 DescribeLiveRecordVodConfigs 介面的 AutoCompose 設定為 ON，則返回本參數。	dadfcaadde****
RecordContent	string	錄製內容。取值： raw(預設值)，錄製源流 transcode，錄製轉碼流	raw
DelayTime	integer	斷流拼接時間長度	180
TranscodeTemplates	string	轉碼流錄製的轉碼模板。設定了錄製所有轉碼流，則返回為["*"]。	["sd","hd"]
FormatConfig	boolean	按格式配置點播視訊設定參數，無需傳入，預設為 true	true
SpaceId	string	點播應用空間 ID，通過點播控制台或應用資訊列表擷取，應用資訊查詢介面。未開啟應用空間時無需填寫；	app-1000000
RecordFormatList	object
RecordFormat	array<object>	錄製格式參數
	object	錄製格式列表
Format	string	錄製儲存格式	m3u8
SliceDuration	integer	單個切片時間長度，單位：秒	30
AutoCompose	string	自動合并，ON 表示開啟自動合并。取值： ON，開啟自動合并 OFF，關閉自動合并	ON
VideoProcess	string	視頻處理源。取值： origin，處理源視頻 compose，處理合并後視頻	origin
ProcessMethod	string	視頻處理方式。取值： transcode，使用轉碼模版組處理視頻 workflow，使用工作流程處理視頻	transcode
ProcessTemplateId	string	視頻處理轉碼模版或工作流程模版 Id	e2d796d3bb5fd8049d32bff62f94****
Tags	string	視頻分類標籤	sports

樣本

正常返回樣本

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****",
        "RecordContent": "raw",
        "DelayTime": 180,
        "TranscodeTemplates": "[\"sd\",\"hd\"]",
        "FormatConfig": true,
        "SpaceId": "app-1000000",
        "RecordFormatList": {
          "RecordFormat": [
            {
              "Format": "m3u8",
              "SliceDuration": 30,
              "AutoCompose": "ON",
              "VideoProcess": "origin",
              "ProcessMethod": "transcode",
              "ProcessTemplateId": "e2d796d3bb5fd8049d32bff62f94****",
              "Tags": "sports"
            }
          ]
        }
      }
    ]
  }
}

錯誤碼

HTTP status code	錯誤碼	錯誤資訊	描述
400	InternalError	The request processing has failed due to backend service exception.

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

變更歷史

更多資訊，參考變更詳情。