查询下载文件列表 - ShowFiles

功能介绍

查询下载文件列表。

授权信息

账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限。

如果使用角色与策略授权，具体权限要求请参见权限和授权项。
如果使用身份策略授权，当前API调用无需身份策略权限。

URI

GET /v5/{project_id}/files

表1 路径参数
参数	是否必选	参数类型	描述
project_id	是	String	参数解释：租户在某一Region下的Project ID。获取方法请参见获取项目ID。约束限制：不涉及。取值范围：不涉及。默认取值：不涉及。

表2 Query参数
参数	是否必选	参数类型	描述
offset	否	Integer	参数解释：偏移量，表示查询该偏移量后面的记录。约束限制：不涉及取值范围：不涉及默认取值： 0
limit	否	Integer	参数解释：查询返回记录的数量限制。约束限制：不涉及取值范围：不涉及默认取值： 10

请求参数

表3 请求Header参数
参数	是否必选	参数类型	描述
Content-Type	否	String	参数解释：发送的实体的MIME类型。推荐用户默认使用application/json，如果API是对象、镜像上传等接口，媒体类型可按照流类型的不同进行确定。约束限制：不涉及。取值范围： application/json 默认取值： application/json
X-Auth-Token	是	String	参数解释：从IAM服务获取的用户Token。用户Token也就是调用获取用户Token接口的响应值，该接口是唯一不需要认证的接口。请求响应成功后在响应消息头中包含的“X-Subject-Token”的值即为Token值。约束限制：不涉及。取值范围：不涉及。默认取值：不涉及。
X-Language	否	String	参数解释：请求语言类型。约束限制：请根据语言环境，参考支持的范围指定请求语言类型。取值范围： en-us：英语 zh-cn：中文 es-us：西班牙语 pt-br：葡萄牙语默认取值： en-us

响应参数

状态码：200

表4 响应Body参数
参数	参数类型	描述
total_count	Long	参数解释：下载文件总数。约束限制：不涉及。取值范围：不涉及。
files	Array of objects	参数解释：下载的文件列表。详情请参见表5。

表5 FileInfo
参数	参数类型	描述
file_name	String	参数解释：文件名。约束限制：不涉及。取值范围：不涉及。
last_modified	String	参数解释：文件修改时间。约束限制：不涉及。取值范围：不涉及。

请求示例

查询下载文件列表

https://{endpoint}/v5/5237e10fe9aa4ad5b16b6a5245248314/files?offset=0&limit=10

响应示例

状态码：200

{ 
  "count" : 1, 
  "files" : [ { 
    "file_name" : "2e69ebb1-f06d-4eb2-a789-2883629jb204_postgresql_20250703094510.xlsx", 
    "last_modified" : "2025-07-03T09:44:12Z" 
  } ] 
}