更新时间:2025-09-12 GMT+08:00
分享

获取当前桶的文件信息

功能介绍

获取指定OBS桶中的文件列表。

调用方法

请参见如何调用API

URI

GET /v1/{project_id}/sdg/watermark/bucket-files

表1 路径参数

参数

是否必选

参数类型

描述

project_id

String

项目ID

表2 Query参数

参数

是否必选

参数类型

描述

bucket_name

String

桶名称

limit

Integer

每页显示的数量

marker

String

分页标记

only_folder

Boolean

是否仅显示文件夹

prefix

String

文件前缀

请求参数

响应参数

状态码:200

表3 响应Body参数

参数

参数类型

描述

files

Array of ObsFile objects

文件列表

is_truncated

Boolean

是否分页截断

next_marker

String

下一页标记

表4 ObsFile

参数

参数类型

描述

file_name

String

文件名称

is_folder

Boolean

是否为文件夹

请求示例

响应示例

状态码

状态码

描述

200

获取成功

401

未授权

403

禁止访问

404

桶未找到

错误码

请参见错误码

相关文档