调用CreateDrive创建空间_网盘与相册服务(PDS)-阿里云帮助中心

创建空间。

接口说明

创建空间前确保操作对应用户/团队未被分配空间。

调试

您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。

调试

授权信息

当前API暂无授权信息透出。

请求语法

POST /v2/drive/create HTTP/1.1

请求参数

名称	类型	必填	描述	示例值
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	long	否	总大小，单位为字节，默认不限大小	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	long	使用空间大小，单位为字节	1024
total_size	long	总空间大小，单位为字节	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"
}

错误码

访问错误中心查看更多错误码。