查詢DNA庫(kù)文件列表。
接口說(shuō)明
- 本接口通過(guò) DNA 庫(kù) ID 查詢文件列表，支持分頁(yè)查詢。
- 本接口目前支持使用的地域?yàn)槿A北 2（北京）、華東 1（杭州）、華東 2（上海）、亞太東南 1（新加坡）、沙特（利雅得）。
QPS 限制
本接口的單用戶 QPS 限制為 100 次/秒。超過(guò)限制，API 調(diào)用會(huì)被限流，這可能會(huì)影響您的業(yè)務(wù)，請(qǐng)合理調(diào)用。更多信息，請(qǐng)參見 QPS 限制。
調(diào)試
您可以在OpenAPI Explorer中直接運(yùn)行該接口，免去您計(jì)算簽名的困擾。運(yùn)行成功后，OpenAPI Explorer可以自動(dòng)生成SDK代碼示例。
授權(quán)信息
下表是API對(duì)應(yīng)的授權(quán)信息，可以在RAM權(quán)限策略語(yǔ)句的Action元素中使用，用來(lái)給RAM用戶或RAM角色授予調(diào)用此API的權(quán)限。具體說(shuō)明如下：
- 操作：是指具體的權(quán)限點(diǎn)。
- 訪問(wèn)級(jí)別：是指每個(gè)操作的訪問(wèn)級(jí)別，取值為寫入（Write）、讀取（Read）或列出（List）。
- 資源類型：是指操作中支持授權(quán)的資源類型。具體說(shuō)明如下：
- 對(duì)于必選的資源類型，用背景高亮的方式表示。
- 對(duì)于不支持資源級(jí)授權(quán)的操作，用
全部資源表示。
- 條件關(guān)鍵字：是指云產(chǎn)品自身定義的條件關(guān)鍵字。
- 關(guān)聯(lián)操作：是指成功執(zhí)行操作所需要的其他權(quán)限。操作者必須同時(shí)具備關(guān)聯(lián)操作的權(quán)限，操作才能成功。
| 操作 | 訪問(wèn)級(jí)別 | 資源類型 | 條件關(guān)鍵字 | 關(guān)聯(lián)操作 |
|---|---|---|---|---|
| mts:ListFpShotFiles | get |
|
| 無(wú) |
請(qǐng)求參數(shù)
| 名稱 | 類型 | 必填 | 描述 | 示例值 |
|---|---|---|---|---|
| NextPageToken | string | 否 | 分頁(yè)查詢。請(qǐng)求第一頁(yè)時(shí)，NextPageToken 為空；請(qǐng)求后續(xù)文件時(shí)需傳入前一頁(yè)查詢結(jié)果中的 NextPageToken 值。 | ae0fd49c0840e14daf0d66a75b83**** |
| PageSize | integer | 否 | 單頁(yè)數(shù)據(jù)個(gè)數(shù)，默認(rèn)為 20。 | 20 |
| FpDBId | string | 是 | 需要查詢的 DNA 庫(kù) ID。可以從提交新建 DNA 庫(kù)的返回參數(shù)中獲取。 | 2288c6ca184c0e47098a5b665e2a12**** |
| StartTime | string | 否 | 入庫(kù)時(shí)間范圍開始時(shí)間。日期格式按照 ISO8601 標(biāo)準(zhǔn)表示，并需要使用 UTC 時(shí)間。格式為 說(shuō)明
此參數(shù)支持使用的地域?yàn)槿A北 2（北京）、華東 1（杭州）、華東 2（上海），暫不支持亞太東南 1（新加坡）地域使用。
| 2022-09-01T00:00:28Z |
| EndTime | string | 否 | 入庫(kù)時(shí)間范圍結(jié)束時(shí)間。日期格式按照 ISO8601 標(biāo)準(zhǔn)表示，并需要使用 UTC 時(shí)間。格式為 說(shuō)明
此參數(shù)支持使用的地域?yàn)槿A北 2（北京）、華東 1（杭州）、華東 2（上海），暫不支持亞太東南 1（新加坡）地域使用。
| 2022-09-08T23:32:56Z |
返回參數(shù)
示例
正常返回示例
JSON格式
{
"RequestId": "25818875-5F78-4A13-BEF6-D7393642CA58",
"NextPageToken": "ae0fd49c0840e14daf0d66a75b83****",
"FpShotFileList": {
"FpShotFile": [
{
"PrimaryKey": "fb712a6890464059b1b2ea7c8647****",
"InputFile": {
"Object": "example-****.mp4",
"Location": "oss-cn-beijing",
"Bucket": "example-bucket-****"
},
"FileId": "41e6536e4f2250e2e9bf26cdea19****",
"StoreTime": "2022-09-08T23:32:56Z"
}
]
}
}錯(cuò)誤碼
| HTTP status code | 錯(cuò)誤碼 | 錯(cuò)誤信息 | 描述 |
|---|---|---|---|
| 400 | InvalidParameter.OutOfRange | The specified parameter %s is out of range. | 參數(shù)無(wú)效超出指定范圍 |
| 500 | InternalError | The operation has failed due to some unknown error, exception or failure. | - |
訪問(wèn)錯(cuò)誤中心查看更多錯(cuò)誤碼。