Lists the authorized group drives.
Try it now
Test
RAM authorization
Request syntax
POST /v2/drive/list_my_group_drive HTTP/1.1
Request parameters
|
Parameter |
Type |
Required |
Description |
Example |
| domain_id |
string |
No |
The ID of the domain. |
|
| body |
object |
No |
The request body. |
|
| limit |
integer |
No |
The maximum number of group drives to return. The maximum value is 100. If you do not specify this parameter, the default value is 100. |
100 |
| marker |
string |
No |
A pagination token. Set this parameter to the value of |
NWQ1Yjk4YmI1ZDRlYmU1Y2E0YWE0NmJhYWJmODBhNDQ2NzhlMTRhMg |
| drive_name |
string |
No |
The name of the drive. |
Response elements
|
Element |
Type |
Description |
Example |
|
object |
The response body. |
||
| items |
array |
A list of group drives. |
|
| Drive |
A group drive. |
||
| next_marker |
string |
The pagination token to retrieve the next page of results. If this parameter is empty, no more results are available. |
NWQ1Yjk4YmI1ZDRlYmU1Y2E0YWE0NmJhYWJmODBhNDQ2NzhlMTRhMg |
| root_group_drive | Drive |
The root group drive. |
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",
"root_group_drive": {
"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"
}
}
Error codes
See Error Codes for a complete list.
Release notes
See Release Notes for a complete list.