All Products
Search
Document Center

Drive and Photo Service:ListMyGroupDrive

Last Updated:Feb 26, 2026

Lists 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

body

object

No

Request body parameters.

limit

integer

No

Limit the number of resources returned. If not set, the default is 100. The maximum is 100.

100

marker

string

No

After setting this field, data continues from the last returned position. If not set, data returns from the beginning. Default value: None.

NWQ1Yjk4YmI1ZDRlYmU1Y2E0YWE0NmJhYWJmODBhNDQ2NzhlMTRhMg

drive_name

string

No

Response elements

Element

Type

Description

Example

object

Returns the struct.

items

array

List of returned drive information.

Drive

Returned drive information.

next_marker

string

Identifier for the starting resource of the next page. This value is empty on the last page.

NWQ1Yjk4YmI1ZDRlYmU1Y2E0YWE0NmJhYWJmODBhNDQ2NzhlMTRhMg

root_group_drive Drive

Enterprise drive information.

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.