Queries drives.
Try it now
Test
RAM authorization
Request syntax
POST /v2/drive/search HTTP/1.1Request parameters
|
Parameter |
Type |
Required |
Description |
Example |
| body |
object |
No |
The request parameters. |
|
| drive_name |
string |
No |
The drive name. |
My personal space |
| limit |
integer |
No |
The maximum number of asynchronous tasks to return. Valid values: 1 to 100. Default value: 100. |
100 |
| marker |
string |
No |
The pagination token that is used in the next request to retrieve a new page of results. You do not need to specify this parameter for the first request. You must specify the token that is obtained from the previous query as the value of marker. |
NWQ1Yjk4YmI1ZDRlYmU1Y2E0YWE0NmJhYWJmODBhNDQ2NzhlMTRhMg |
| owner |
string |
No |
The owner of the drive. |
c9b7a5aa04d14ae3867fdc886fa01da4 |
| owner_type |
string |
No |
The type of the owner. Valid values: user group |
user |
Response elements
|
Element |
Type |
Description |
Example |
|
object |
The response parameters. |
||
| items |
array |
The information about the drives. |
|
| Drive |
The information about a drive. |
||
| next_marker |
string |
A pagination token. It can be used in the next request to retrieve a new page of results. If next_marker is empty, no next page exists. |
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.