调用ListDrive列举空间_网盘与相册服务(PDS)-阿里云帮助中心

列举空间。

调试

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

授权信息

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

请求语法

POST /v2/drive/list HTTP/1.1

请求参数

名称	类型	必填	描述	示例值
body	object	否	请求体参数。
limit	integer	否	限定此次返回资源的数量，范围为 [1,100]，默认返回 100	100
marker	string	否	设定结果从 marker 之后按字母排序的第一个开始返回。如果不设定，则从头开始返回数据。默认值：无	NWQ1Yjk4YmI1ZDRlYmU1Y2E0YWE0NmJhYWJmODBhNDQ2NzhlMTRhMg
owner	string	否	归属者，不设置时返回所有 drive	c9b7a5aa04d14ae3867fdc886fa01da4
owner_type	string	否	归属者类型，可选值如下： user：用户 group：团队默认返回所有归属者类型的 drive	user

返回参数

名称	类型	描述	示例值
	object	Schema of Response
items	array	空间信息列表
	Drive	空间信息
next_marker	string	下一页起始资源标识符, 最后一页该值为空。	NWQ1Yjk4YmI1ZDRlYmU1Y2E0YWE0NmJhYWJmODBhNDQ2NzhlMTRhMg

示例

正常返回示例

JSON格式

{
  "items": [
    {
      "domain_id": "bj1",
      "drive_id": "1",
      "drive_name": "drv1",
      "description": "vipdrive",
      "owner": "c9b7a5aa04d14ae3867fdc886fa01da4",
      "owner_type": "user",
      "drive_type": "normal",
      "status": "enabled",
      "used_size": 20480,
      "total_size": 204800,
      "created_at": "2019-08-20T06:51:27.292Z",
      "creator": "c9b7a5aa04d14ae3867fdc886fa01da4"
    }
  ],
  "next_marker": "NWQ1Yjk4YmI1ZDRlYmU1Y2E0YWE0NmJhYWJmODBhNDQ2NzhlMTRhMg"
}

错误码

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