DescribeLiveStreamRecordIndexFile - 查詢單個錄製索引檔案 - ApsaraVideo Live

查詢單個錄製索引檔案。

介面說明

建立好的 M3U8 索引檔案的資訊在ApsaraVideo for Live系統中僅儲存 6 個月，若要查詢僅能查詢 6 個月內建立的索引檔案的資訊。M3U8 索引檔案儲存體在 OSS 中，儲存時間由 OSS 的儲存配置決定。

QPS 限制

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

調試

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

調試

授權資訊

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

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

操作

存取層級

資源類型

條件關鍵字

關聯操作

live:DescribeLiveStreamRecordIndexFile

get

*全部資源

*

無

請求參數

名稱	類型	必填	描述	樣本值
DomainName	string	是	主播流網域名稱。	example.com
AppName	string	是	播流所屬應用程式名稱。	liveApp****
StreamName	string	是	播流名稱。	liveStream****
RecordId	string	是	索引檔案 ID。說明通過查詢所有錄製索引檔案介面查詢	c4d7f0a4-b506-43f9-8de3-07732c3f****

返回參數

名稱	類型	描述	樣本值
	object
RequestId	string	請求 ID。	5EBF2AC3-4B73-40A5-8B32-83F49D5F035E
RecordIndexInfo	object	錄製配置。
RecordUrl	string	索引檔案地址。	http://**/atestObject**.m3u8
StreamName	string	播流名稱。	liveStream****
CreateTime	string	建立時間。格式為：yyyy-MM-ddTHH:mm:ssZ（UTC 時間）。	2016-05-27T09:40:56Z
RecordId	string	索引檔案 ID。	c4d7f0a4-b506-43f9-8de3-07732c3f****
Height	integer	視頻高。	480
OssBucket	string	OSS 儲存的 Bucket 名稱。	liveBucket****
DomainName	string	主播流網域名稱。	example.com
OssObject	string	OSS 儲存的錄製檔案名稱。	liveObject****
EndTime	string	結束時間。格式為：yyyy-MM-ddTHH:mm:ssZ（UTC 時間）。	2016-05-25T05:47:11Z
AppName	string	流所屬應用程式名稱。	liveApp****
StartTime	string	開始時間。格式為：yyyy-MM-ddTHH:mm:ssZ（UTC 時間）。	2015-12-01T05:36:00Z
Width	integer	視頻寬。	640
Duration	number	錄製時間長度。單位：秒。	588.849
OssEndpoint	string	OSS 儲存的 Endpoint 名稱。	cn-oss-****.aliyuncs.com
Format	string	視頻格式。	mp4

樣本

正常返回樣本

JSON格式

{
  "RequestId": "5EBF2AC3-4B73-40A5-8B32-83F49D5F035E",
  "RecordIndexInfo": {
    "RecordUrl": "http://****/atestObject****.m3u8",
    "StreamName": "liveStream****",
    "CreateTime": "2016-05-27T09:40:56Z",
    "RecordId": "c4d7f0a4-b506-43f9-8de3-07732c3f****",
    "Height": 480,
    "OssBucket": "liveBucket****",
    "DomainName": "example.com",
    "OssObject": "liveObject****",
    "EndTime": "2016-05-25T05:47:11Z",
    "AppName": "liveApp****",
    "StartTime": "2015-12-01T05:36:00Z",
    "Width": 640,
    "Duration": 588.849,
    "OssEndpoint": "cn-oss-****.aliyuncs.com",
    "Format": "mp4"
  }
}

錯誤碼

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

變更歷史

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