调用ListFpShotFiles查询DNA库文件列表。

使用说明

  • 本接口通过DNA库ID查询文件列表,支持分页查询。
  • 本接口目前支持使用的地域为华北2(北京)、华东1(杭州)、华东2(上海)、亚太东南1(新加坡)。

QPS限制

本接口的单用户QPS限制为500次/秒。超过限制,API调用会被限流,这可能会影响您的业务,请合理调用。更多信息,请参见QPS限制

调试

您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。

请求参数

名称 类型 是否必选 示例值 描述
Action String ListFpShotFiles

操作接口名,系统规定参数,取值:ListFpShotFiles

NextPageToken String ae0fd49c0840e14daf0d66a75b83****

分页查询。请求第一页时,NextPageToken为空;请求后续文件时需传入前一页查询结果中的NextPageToken值。

PageSize Integer 20

单页数据个数,默认为20。

FpDBId String 2288c6ca184c0e47098a5b665e2a12****

需要查询的DNA库ID。可以从提交新建DNA库的返回参数中获取。

StartTime String 2022-09-01T00:00:28Z

入库时间范围开始时间。日期格式按照ISO8601标准表示,并需要使用UTC时间。格式为YYYY-MM-DDThh:mm:ssZ

说明 此参数支持使用的地域为华北2(北京)、华东1(杭州)、华东2(上海),暂不支持亚太东南1(新加坡)地域使用。
EndTime String 2022-09-08T23:32:56Z

入库时间范围结束时间。日期格式按照ISO8601标准表示,并需要使用UTC时间。格式为YYYY-MM-DDThh:mm:ssZ

说明 此参数支持使用的地域为华北2(北京)、华东1(杭州)、华东2(上海),暂不支持亚太东南1(新加坡)地域使用。

返回数据

名称 类型 示例值 描述
RequestId String 25818875-5F78-4A13-BEF6-D7393642CA58

请求ID。

NextPageToken String ae0fd49c0840e14daf0d66a75b83****

下一页Token。

FpShotFileList Array of FpShotFile

视频DNA文件列表。更多信息请参见数据类型FpShotFile

FpShotFile
PrimaryKey String fb712a6890464059b1b2ea7c8647****

视频唯一主键。

InputFile Object

作业输入。

Object String example-****.mp4

输入文件的OSS Object。

Location String oss-cn-beijing

输入文件的OSS Location。

Bucket String example-bucket-****

输入文件的OSS Bucket。

FileId String 41e6536e4f2250e2e9bf26cdea19****

视频文件ID。

StoreTime String 2022-09-08T23:32:56Z

入库时间。日期格式按照ISO8601标准表示,并需要使用UTC时间。格式为YYYY-MM-DDThh:mm:ssZ

说明 此参数支持使用的地域为华北2(北京)、华东1(杭州)、华东2(上海),暂不支持亚太东南1(新加坡)地域使用。

示例

请求示例

http(s)://mts.cn-hangzhou.aliyuncs.com/?Action=ListFpShotFiles
&NextPageToken=ae0fd49c0840e14daf0d66a75b83****
&PageSize=20
&FpDBId=2288c6ca184c0e47098a5b665e2a12****
&StartTime=2022-09-01T00:00:28Z
&EndTime=2022-09-08T23:32:56Z
&<公共请求参数>

正常返回示例

XML格式

HTTP/1.1 200 OK
Content-Type:application/xml

<ListFpShotFilesResponse>
    <RequestId>25818875-5F78-4A13-BEF6-D7393642CA58</RequestId>
    <NextPageToken>ae0fd49c0840e14daf0d66a75b83****</NextPageToken>
    <FpShotFileList>
        <PrimaryKey>fb712a6890464059b1b2ea7c8647****</PrimaryKey>
        <InputFile>
            <Object>example-****.mp4</Object>
            <Location>oss-cn-beijing</Location>
            <Bucket>example-bucket-****</Bucket>
        </InputFile>
        <FileId>41e6536e4f2250e2e9bf26cdea19****</FileId>
        <StoreTime>2022-09-08T23:32:56Z</StoreTime>
    </FpShotFileList>
</ListFpShotFilesResponse>

JSON格式

HTTP/1.1 200 OK
Content-Type:application/json

{
  "RequestId" : "25818875-5F78-4A13-BEF6-D7393642CA58",
  "NextPageToken" : "ae0fd49c0840e14daf0d66a75b83****",
  "FpShotFileList" : [ {
    "PrimaryKey" : "fb712a6890464059b1b2ea7c8647****",
    "InputFile" : {
      "Object" : "example-****.mp4",
      "Location" : "oss-cn-beijing",
      "Bucket" : "example-bucket-****"
    },
    "FileId" : "41e6536e4f2250e2e9bf26cdea19****",
    "StoreTime" : "2022-09-08T23:32:56Z"
  } ]
}

错误码

HttpCode 错误码 错误信息 描述
400 InvalidParameter.OutOfRange The specified parameter %s is out of range. 参数无效超出指定范围

访问错误中心查看更多错误码。