All Products
Search
Document Center

Drive and Photo Service:ListMyDrives

Last Updated:Mar 23, 2026

Retrieves a list of Drives for the logged-in user.

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_drives HTTP/1.1

Request parameters

Parameter

Type

Required

Description

Example

body

object

No

limit

integer

No

The maximum number of results to return. Valid values: 1 to 100. Default: 100.

100

marker

string

No

The pagination token used to retrieve the next page of results. This parameter is not required for the first request. For subsequent requests, set this parameter to the next_marker value from the previous response. If this parameter is omitted, the query starts from the beginning.

NWQ1Yjk4YmI1ZDRlYmU1Y2E0YWE0NmJhYWJmODBhNDQ2NzhlMTRhMg

Response elements

Element

Type

Description

Example

object

The response body.

items

array

The list of Drives.

Drive

A Drive object.

next_marker

string

The pagination token to retrieve the next page of results. This parameter is empty when no more results are available.

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.