功能描述
查询 DNA 库内文件列表。
授权说明
服务开通
使用该功能需提前开通数据万象,并绑定存储桶。详情请参见 绑定存储桶。
使用该功能需提前通过控制台或接口开通媒体处理服务 。详情请参见 开通媒体处理服务。
使用限制
请求
请求示例
GET /dnadb_files HTTP/1.1Host: <BucketName-APPID>.ci.<Region>.myqcloud.comDate: <GMT Date>Authorization: <Auth String>
请求头
请求参数
参数的具体内容如下:
参数名称 | 描述 | 是否必选 |
object | 文件名 | 否 |
dnaDbId | DNA 库 ID | 否 |
pageNumber | 第几页,默认值:1 | 否 |
pageSize | 每页个数,默认值:10,最大值 100 | 否 |
请求体
该请求无请求体。
响应
响应头
响应体
该响应体返回为 application/xml 数据,包含完整节点数据的内容展示如下:
<Response><RequestId>NTk0MjdmODlfMjQ4OGY3XzYzYzhfMjc=</RequestId><TotalCount>2</TotalCount><PageNumber>1</PageNumber><PageSize>10</PageSize><DNADbFiles><BucketId>test-1234567890</BucketId><Region>ap-chongqing</Region><DNADbId>xxx1</DNADbId><VideoId>xxx</VideoId><Object>input/test1.mp4</Object><ETag>"3a64323ae8ed5633c02fc96def134b92-23"</ETag><CreateTime>2023-06-05T11:35:24+0800</CreateTime><UpdateTime>2023-06-31T16:15:20+0800</UpdateTime></DNADbFiles><DNADbFiles><BucketId>test-1234567890</BucketId><Region>ap-chongqing</Region><DNADbId>xxx1</DNADbId><VideoId>xxx</VideoId><Object>input/test2.mp4</Object><ETag>"234f8b0b58874328039ac66352820cc8"</ETag><CreateTime>2023-06-05T11:35:24+0800</CreateTime><UpdateTime>2023-06-31T16:15:20+0800</UpdateTime></DNADbFiles></Response>
具体的数据内容如下:
节点名称(关键字) | 父节点 | 描述 | 类型 |
Response | 无 | 保存结果的容器 | Container |
Container 节点 Response 的内容:
节点名称(关键字) | 父节点 | 描述 | 类型 |
RequestId | Response | 请求的唯一 ID | String |
TotalCount | Response | 文件总数 | Int |
PageNumber | Response | 当前页数,同请求中的 pageNumber | Int |
PageSize | Response | 每页个数,同请求中的 pageSize | Int |
DNADbFiles | Response | 文件的详细信息 | Container 数组 |
Container 节点 DNADbConfig 的内容:
节点名称(关键字) | 父节点 | 描述 | 类型 |
BucketId | Response.DNADbConfig | 存储桶 ID | String |
Region | Response.DNADbConfig | 存储桶所在园区 | String |
DNADbId | Response.DNADbConfig | DNA 库 ID | String |
VideoId | Response.DNADbConfig | 文件唯一标识符 | String |
Object | Response.DNADbConfig | 文件名 | String |
ETag | Response.DNADbConfig | 文件 ETag | String |
UpdateTime | Response.DNADbConfig | 文件更新时间 | String |
CreateTime | Response.DNADbConfig | 文件创建时间 | String |
错误码
实际案例
GET /dnadb_filesHTTP/1.1Accept: */*Authorization: q-sign-algorithm=sha1&q-ak=AKIDZfbOAo7cllgPvF9cXFrJD0a1ICvR****&q-sign-time=1497530202;1497610202&q-key-time=1497530202;1497610202&q-header-list=&q-url-param-list=&q-signature=28e9a4986df11bed0255e97ff90500557e0ea057Host: test-1234567890.ci.ap-chongqing.myqcloud.com
响应
HTTP/1.1 200 OKContent-Type: application/xmlContent-Length: 666Connection: keep-aliveDate: Mon, 28 Jun 2022 15:23:12 GMTServer: tencent-cix-ci-request-id: NjMxMDJhYTNfMThhYTk0MGFfYmU1OV8zZjc=<Response><RequestId>NTk0MjdmODlfMjQ4OGY3XzYzYzhfMjc=</RequestId><TotalCount>2</TotalCount><PageNumber>1</PageNumber><PageSize>10</PageSize><DNADbFiles><BucketId>test-1234567890</BucketId><Region>ap-chongqing</Region><DNADbId>xxx1</DNADbId><VideoId>xxx</VideoId><Object>input/test1.mp4</Object><ETag>"3a64323ae8ed5633c02fc96def134b92-23"</ETag><CreateTime>2023-06-05T11:35:24+0800</CreateTime><UpdateTime>2023-06-31T16:15:20+0800</UpdateTime></DNADbFiles><DNADbFiles><BucketId>test-1234567890</BucketId><Region>ap-chongqing</Region><DNADbId>xxx1</DNADbId><VideoId>xxx</VideoId><Object>input/test2.mp4</Object><ETag>"234f8b0b58874328039ac66352820cc8"</ETag><CreateTime>2023-06-05T11:35:24+0800</CreateTime><UpdateTime>2023-06-31T16:15:20+0800</UpdateTime></DNADbFiles></Response>