ListLiveSnapshotFiles - Intelligent Media Services

呼叫ListLiveSnapshotFiles取得即時截圖檔案列表，可分頁取得。

調試

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

調試

授權資訊

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

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

操作

存取層級

資源類型

條件關鍵字

關聯操作

ice:ListLiveSnapshotFiles

*全部資源。

*

無

請求參數

名稱	類型	必填	描述	樣本值
JobId	string	是	截圖任務 ID。	**a046-263c-3560-978a-fb287782**
StartTime	string	是	開始時間。UTC 時間，格式：yyyy-MM-ddTHH:mm:ssZ。	2022-02-02T00:00:00Z
EndTime	string	是	結束時間。UTC 時間，格式：yyyy-MM-ddTHH:mm:ssZ。 EndTime 和 StartTime 之間的間隔不能超過 1 天。	2022-02-02T23:59:59Z
Limit	integer	否	每次獲取數量，[1, 100]，預設為 10。	10
SortBy	string	否	排序，預設為 asc。枚舉值： asc : 按時間升序。 desc : 按時間倒序。	desc

返回參數

名稱	類型	描述	樣本值
	object	回應資料。
FileList	array<object>	檔案列表。
	object
CreateTime	string	建立時間。時間格式為 ISO 8601，使用 UTC 時間（以 Z 結尾）。	2022-02-02T22:22:22Z
CreateTimestamp	integer	建立時間戳記，用於刪除介面傳參。	1619503516000
IsOverlay	boolean	是否覆蓋截圖。	true
OssBucket	string	OSS bucket。	testbucket
OssEndpoint	string	OSS 端點。	oss-cn-shanghai.aliyuncs.com
OssObject	string	OSS 儲存物件位置。	snapshot/**a046-263c-3560-978a-fb287782**/1660638613798.jpg
NextStartTime	string	下一頁的開始時間，未回傳則表示結束翻頁。時間格式為 ISO 8601，使用 UTC 時間（以 Z 結尾）。	2022-02-02T22:22:22Z
RequestId	string	請求 ID。	****11-DB8D-4A9A-875B-275798****

樣本

正常返回樣本

JSON格式

{
  "FileList": [
    {
      "CreateTime": "2022-02-02T22:22:22Z",
      "CreateTimestamp": 1619503516000,
      "IsOverlay": true,
      "OssBucket": "testbucket",
      "OssEndpoint": "oss-cn-shanghai.aliyuncs.com",
      "OssObject": "snapshot/****a046-263c-3560-978a-fb287782****/1660638613798.jpg"
    }
  ],
  "NextStartTime": "2022-02-02T22:22:22Z",
  "RequestId": "******11-DB8D-4A9A-875B-275798******"
}

錯誤碼

HTTP status code	錯誤碼	錯誤資訊
400	MissingParameter	%s
400	InvalidParameter	%s
400	MalformedStartTime	Specified parameter StartTime is not valid.
400	MalformedEndTime	Specified parameter EndTime is not valid.
400	EndTimeMismatch	Specified end time does not math the specified start time.
500	InternalError	The request processing has failed due to some unknown error.
403	UserDisable	User is disable.
403	Forbidden	User not authorized to operate on the specified resource.
403	OperationDenied	Your account has not enabled the ICE service.
404	JobNotFound	No such job.
404	NoValidSnapshot	No snapshots found with given parameters.

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

變更歷史

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