创建个人文件夹
功能介绍
创建个人文件夹,已存在对应目录时,仅更新策略不会重复创建目录。
调试
您可以在API Explorer中调试该接口,支持自动认证鉴权。API Explorer可以自动生成SDK代码示例,并提供SDK代码示例调试功能。
URI
POST /v1/{project_id}/cloud-storages/{storage_id}/actions/create-folder
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
project_id |
是 |
String |
项目ID。 |
storage_id |
是 |
String |
WKS存储ID。 |
请求参数
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
X-Auth-Token |
否 |
String |
用户Token。 通过调用IAM服务获取用户Token接口获取(响应消息头中X-Subject-Token的值)。 |
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
items |
是 |
Array of CreateUserAssignmentInfo objects |
存储分配目标。 |
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
attach_id |
是 |
String |
目标用户id。 |
attach_name |
是 |
String |
目标用户。 |
file_system_quota |
否 |
Long |
配额。 |
action_put |
否 |
Boolean |
云存储于本地设备的权限,上传: true : 允许上传。 false: 不允许上传。 |
action_get |
否 |
Boolean |
云存储于本地设备的权限,下载: true : 允许下载。 false: 不允许下载。 |
roam_action_put |
否 |
Boolean |
云存储于云桌面/云应用权限,上传: true : 允许上传。 false: 不允许上传。 |
roam_action_get |
否 |
Boolean |
云存储于云桌面/云应用权限,下载: true : 允许下载。 false: 不允许下载。 |
响应参数
状态码:200
参数 |
参数类型 |
描述 |
---|---|---|
items |
Array of CloudStorageAssignmentCreateInfo objects |
创建文件夹返回信息。 |
参数 |
参数类型 |
描述 |
---|---|---|
id |
String |
存储分配的唯一标识符。 |
region_id |
String |
区域ID。 |
tenant_id |
String |
租户ID。 |
domain_id |
String |
域ID。 |
folder_name |
String |
文件夹名称。 |
attach |
String |
用户名称。 |
attach_id |
String |
用户ID。 |
attach_type |
String |
关联对象类型:
|
errorMessage |
String |
错误信息。 |
isSuccess |
Boolean |
是否创建成功。 |
状态码:400
参数 |
参数类型 |
描述 |
---|---|---|
error_code |
String |
错误码,失败时返回。 |
error_msg |
String |
错误描述。 |
状态码:401
参数 |
参数类型 |
描述 |
---|---|---|
error_code |
String |
错误码,失败时返回。 |
error_msg |
String |
错误描述。 |
状态码:403
参数 |
参数类型 |
描述 |
---|---|---|
error_code |
String |
错误码,失败时返回。 |
error_msg |
String |
错误描述。 |
状态码:404
参数 |
参数类型 |
描述 |
---|---|---|
error_code |
String |
错误码,失败时返回。 |
error_msg |
String |
错误描述。 |
状态码:405
参数 |
参数类型 |
描述 |
---|---|---|
error_code |
String |
错误码,失败时返回。 |
error_msg |
String |
错误描述。 |
状态码:500
参数 |
参数类型 |
描述 |
---|---|---|
error_code |
String |
错误码,失败时返回。 |
error_msg |
String |
错误描述。 |
状态码:503
参数 |
参数类型 |
描述 |
---|---|---|
error_code |
String |
错误码,失败时返回。 |
error_msg |
String |
错误描述。 |
请求示例
{ "items" : [ { "attach_id" : "e8be1ecbae8b49ac9ad30124dbe9d41e", "attach_name" : "psc", "file_system_quota" : 1073741824, "action_put" : false, "action_get" : false, "roam_action_put" : false, "roam_action_get" : false } ] }
响应示例
状态码:200
成功响应。
{ "items" : [ { "id" : "842486659197960192", "region_id" : "cn-north-7", "tenant_id" : "5be809d45f1a4bb39c6c9256efe00adf", "domain_id" : "06efbb8c1100d47c0f20c00d54efeba0", "folder_name" : "My Files1", "attach" : "psc", "attach_id" : "e8be1ecbae8b49ac9ad30124dbe9d41e", "attach_type" : "USER", "is_success" : true } ] }
状态码
状态码 |
描述 |
---|---|
200 |
成功响应。 |
400 |
由于包含语法错误,当前请求无法被服务器理解。 |
401 |
鉴权失败。 |
403 |
没有操作权限。 |
404 |
找不到资源。 |
405 |
请求中指定的方法不被允许。 |
500 |
服务内部错误,具体返回错误码请参见错误码说明。 |
503 |
服务不可用。 |
错误码
请参见错误码。