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

查询个人文件夹列表

功能介绍

查询个人文件夹列表。

调试

您可以在API Explorer中调试该接口,支持自动认证鉴权。API Explorer可以自动生成SDK代码示例,并提供SDK代码示例调试功能。

URI

GET /v1/{project_id}/cloud-storages/actions/list-folders

表1 路径参数

参数

是否必选

参数类型

描述

project_id

String

项目ID。

表2 Query参数

参数

是否必选

参数类型

描述

offset

Integer

查询的偏移量。

limit

Integer

单次查询的大小[1-100]。

storage_id

String

WKS存储ID。

claim_mode

String

存储声明的类型,目前只支持USER,后面可以拓展。

  • USER - 个人文件夹

  • SHARE - 共享文件夹

attach

String

被分配的个体或组的名称,当传attach_names时,本字段不生效。

attach_names

Array of strings

被分配的个体或组的名称。

capacity_filter

String

是否查询容量过滤:

  • true : 是。

  • false: 否。

请求参数

表3 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

String

用户Token。

通过调用IAM服务获取用户Token接口获取(响应消息头中X-Subject-Token的值)。

响应参数

状态码:200

表4 响应Body参数

参数

参数类型

描述

count

Integer

总数。

items

Array of CloudStorageAssignment objects

查询用户存储声明配置。

表5 CloudStorageAssignment

参数

参数类型

描述

cloud_storage_assignment_id

String

id。

attach_name

String

用户名称(单位/B)。

used_quota

Long

已用容量(单位/B)。

quota

Long

总容量(单位/B)。

create_time

DateTime

添加时间。

action_put

Boolean

云存储于本地设备的权限,上传:

true : 允许上传。

false: 不允许上传。

action_get

Boolean

云存储于本地设备的权限,下载:

true : 允许下载。

false: 不允许下载。

roam_action_put

Boolean

云存储于云桌面/云应用权限,上传:

true : 允许上传。

false: 不允许上传。

roam_action_get

Boolean

云存储于云桌面/云应用权限,下载:

true : 允许下载。

false: 不允许下载。

状态码:400

表6 响应Body参数

参数

参数类型

描述

error_code

String

错误码,失败时返回。

error_msg

String

错误描述。

状态码:401

表7 响应Body参数

参数

参数类型

描述

error_code

String

错误码,失败时返回。

error_msg

String

错误描述。

状态码:403

表8 响应Body参数

参数

参数类型

描述

error_code

String

错误码,失败时返回。

error_msg

String

错误描述。

状态码:404

表9 响应Body参数

参数

参数类型

描述

error_code

String

错误码,失败时返回。

error_msg

String

错误描述。

状态码:405

表10 响应Body参数

参数

参数类型

描述

error_code

String

错误码,失败时返回。

error_msg

String

错误描述。

状态码:500

表11 响应Body参数

参数

参数类型

描述

error_code

String

错误码,失败时返回。

error_msg

String

错误描述。

状态码:503

表12 响应Body参数

参数

参数类型

描述

error_code

String

错误码,失败时返回。

error_msg

String

错误描述。

请求示例

GET /v1/a4da8115c9d8464ead3a38309130523f/cloud-storages/actions/list-attachments?storage_id=544959151881584640&claim_mode=SHARE&limit=10&offset=0

响应示例

状态码:200

成功响应。

{
  "count" : 0,
  "items" : [ { } ]
}

状态码

状态码

描述

200

成功响应。

400

由于包含语法错误,当前请求无法被服务器理解。

401

鉴权失败。

403

没有操作权限。

404

找不到资源。

405

请求中指定的方法不被允许。

500

服务内部错误,具体返回错误码请参见错误码说明。

503

服务不可用。

错误码

请参见错误码

相关文档