All Products
Search
Document Center

Drive and Photo Service:ListMyGroupDrive

Last Updated:May 26, 2026

Lists the authorized group drives.

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_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 next_marker from a previous response to retrieve the next page of results. If you do not set this parameter, the query starts from the beginning of the collection.

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.