Query a list of drives using ListDrive - Drive and Photo Service - Alibaba Cloud - Drive and Photo Service

Try it now

Try this API in OpenAPI Explorer, no manual signing needed. Successful calls auto-generate SDK code matching your parameters. Download it with built-in credential security for local usage.

Test

RAM authorization

No authorization for this operation. If you encounter issues with this operation, contact technical support.

Request syntax

POST /v2/drive/list HTTP/1.1

Request parameters

Parameter	Type	Required	Description	Example
domain_id	string	Yes
body	object	No	The request body.
limit	integer	No	The maximum number of drives to return. Valid values: 1 to 100. Default: 100.	100
marker	string	No	The pagination marker. If specified, the query starts from the drive that follows the marker in alphabetical order. If omitted, the query starts from the beginning of the list.	NWQ1Yjk4YmI1ZDRlYmU1Y2E0YWE0NmJhYWJmODBhNDQ2NzhlMTRhMg
owner	string	No	The ID of the owner. If omitted, drives of all owners are returned.	c9b7a5aa04d14ae3867fdc886fa01da4
owner_type	string	No	The owner type. Valid values: user: An individual user. group: A user group. If omitted, drives of all owner types are returned.	user

Response elements

Element	Type	Description	Example
	object	The response body.
items	array	A list of drives.
	Drive	Drive information.
next_marker	string	The marker for retrieving the next page of results. If no more results are available, this parameter is empty.	NWQ1Yjk4YmI1ZDRlYmU1Y2E0YWE0NmJhYWJmODBhNDQ2NzhlMTRhMg

Examples

Success response

JSON format

{
  "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"
}

Error codes

See Error Codes for a complete list.

Release notes

See Release Notes for a complete list.