创建空间。
接口说明
创建空间前确保操作对应用户/团队未被分配空间。
调试
您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。
调试
授权信息
请求语法
POST /v2/drive/create HTTP/1.1请求参数
|
名称 |
类型 |
必填 |
描述 |
示例值 |
| domain_id |
string |
是 |
||
| body |
object |
否 |
请求体。 |
|
| drive_name |
string |
是 |
空间名称，最长 128 字符 |
我的个人空间 |
| owner |
string |
是 |
归属者 ID |
3b3d7245c159488da17d081ad6c64687 |
| owner_type |
string |
是 |
归属者类型，可选值如下： user：用户 group：团队 枚举值：
|
user |
| description |
string |
否 |
描述信息，最长 1024 字符 |
vip空间 |
| drive_type |
string |
否 |
空间类型，当前只支持 normal 枚举值：
|
normal |
| status |
string |
否 |
状态，可选值如下： enabled：可用 disabled：禁用 默认为 enabled 枚举值：
|
enabled |
| total_size |
integer |
否 |
总大小，单位为字节，默认不限大小 |
1024 |
| default |
boolean |
否 |
是否是默认空间，默认为 false |
true |
返回参数
|
名称 |
类型 |
描述 |
示例值 |
|
object |
返回信息 |
||
| domain_id |
string |
域 id |
bj1 |
| drive_id |
string |
空间 id |
1 |
| drive_name |
string |
空间名称 |
我的个人空间 |
| description |
string |
描述信息 |
vip空间 |
| owner |
string |
归属者 ID |
3b3d7245c159488da17d081ad6c64687 |
| owner_type |
string |
归属者类型 |
user |
| drive_type |
string |
空间类型 |
normal |
| used_size |
integer |
使用空间大小，单位为字节 |
1024 |
| total_size |
integer |
总空间大小，单位为字节 |
1024 |
| creator |
string |
创建者 ID。 |
c9b7a5aa04d14ae3867fdc886fa01da4 |
| created_at |
string |
创建时间 |
2024-08-14T03:14:28.109Z |
| status |
string |
状态 |
enabled |
示例
正常返回示例
JSON格式
{
"domain_id": "bj1",
"drive_id": "1",
"drive_name": "我的个人空间\n",
"description": "vip空间\n",
"owner": "3b3d7245c159488da17d081ad6c64687\n",
"owner_type": "user",
"drive_type": "normal",
"used_size": 1024,
"total_size": 1024,
"creator": "c9b7a5aa04d14ae3867fdc886fa01da4",
"created_at": "2024-08-14T03:14:28.109Z",
"status": "enabled"
}错误码
访问错误中心查看更多错误码。
变更历史
更多信息，参考变更详情。