Query Drives by Owner and Name via SearchDrive API - 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/search HTTP/1.1

Request parameters

Parameter	Type	Required	Description	Example
domain_id	string	Yes
body	object	No	The request body parameters.
drive_name	string	No	The drive name.	我的个人空间
limit	integer	No	The maximum number of drives to return. The value must be from 1 to 100. Default: 100.	100
marker	string	No	The pagination token. The server returns results alphabetically, starting from the entry after the marker. If this parameter is omitted, the query starts from the beginning of the list. Default: none	NWQ1Yjk4YmI1ZDRlYmU1Y2E0YWE0NmJhYWJmODBhNDQ2NzhlMTRhMg
owner	string	No	The ID of the owner.	c9b7a5aa04d14ae3867fdc886fa01da4
owner_type	string	No	The owner type. Valid values: `user`: An individual user. `group`: A group of users.	user

Response elements

Element	Type	Description	Example
	object	The response body.
items	array	The list of drives.
	Drive	The drive information.
next_marker	string	The token used to retrieve the next page of results. This parameter is not returned when all results have been retrieved.	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.