查询DNA库文件列表 -

使用说明

本接口通过DNA库ID查询文件列表，支持分页查询。

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库的返回参数中获取。

返回数据


名称	类型	示例值	描述
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。

示例

请求示例

http(s)://mts.cn-hangzhou.aliyuncs.com/?Action=ListFpShotFiles
&NextPageToken=ae0fd49c0840e14daf0d66a75b83****
&PageSize=20
&FpDBId=2288c6ca184c0e47098a5b665e2a12****
&<公共请求参数>

正常返回示例

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>
    </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****"
  } ]
}

错误码


HttpCode	错误码	错误信息	描述
400	InvalidParameter.OutOfRange	The specified parameter %s is out of range.	参数无效超出指定范围
500	InternalError	The operation has failed due to some unknown error, exception or failure.	内部错误，偶发请重试。

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