All Products
Search
Document Center

Drive and Photo Service:FileListPermission

Last Updated:May 26, 2026

Lists the permission records for a file.

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/file/list_permission HTTP/1.1

Request parameters

Parameter

Type

Required

Description

Example

domain_id

string

Yes

body

object

No

The request body.

drive_id

string

Yes

The drive ID.

1

file_id

string

Yes

The file ID.

4221bf6e6ab43a255edc4463bffa6f5f5d317401

Response elements

Element

Type

Description

Example

array

A list of file permission records.

FilePermissionMember

A file permission record.

Examples

Success response

JSON format

[
  {
    "identity": {
      "identity_type": "IT_User",
      "identity_id": "16435bdf934248b788b7b3771ee9a3dw"
    },
    "role_id": "SystemFileDownloader",
    "expire_time": 1633598085642,
    "disinherit_sub_group": false,
    "action_list": [
      "FILE.CREATE"
    ]
  }
]

Error codes

See Error Codes for a complete list.

Release notes

See Release Notes for a complete list.