All Products
Search
Document Center

Drive and Photo Service:File

Last Updated:Oct 21, 2026

Parameter

Type

Description

Example

object

The file.

domain_id

string

The domain ID.

bj1

drive_id

string

The drive ID.

1

file_id

string

The file ID.

5d79206586bb5dd69fb34c349282718146c55da7

name

string

The name.

1.mov

type

string

The type.

file

content_type

string

The content type.

application/json

created_at

string

The creation time.

2019-08-20T06:51:27.292Z

updated_at

string

The modification time.

2019-08-20T06:51:27.292Z

description

string

The description.

image file

trashed_at

string

The time when the file was moved to the recycle bin.

2019-08-20T06:51:27.292Z

file_extension

string

The file name extension.

txt

hidden

boolean

Specifies whether the file is hidden.

false

size

integer

The size of the file. If the object is a folder, this parameter indicates the size of the folder, which is calculated by recursively summing the sizes of all descendant files. Note: The folder size is returned only when the fields parameter includes dir_size in the ListFile or GetFile operation.

1024

starred

boolean

Specifies whether the file is starred.

false

status

string

The status of the file. Only files and folders in the available state can be accessed. If a file is in the uploading state, the GetFile operation returns a file not found error, and the ListFile operation does not return files in the uploading state.

available

labels

array

The labels.

["label1:1", "label2:2"]

string

The labels.

["label1:1", "label2:2"]

upload_id

string

The upload ID.

C9DCFE5A82644AC7A02DB74C30C934A6

parent_file_id

string

The ID of the parent folder.

3d5b846942cf94fa72324c8a4bda34e81da635a

crc64_hash

string

crc64

3574582125365864471

content_hash

string

The content hash.

EA4942AA8761213890A5C386F88E6464D2C31CA3

content_hash_name

string

The name of the content hash algorithm. Currently, only the SHA-1 algorithm is supported.

sha1

download_url

string

The download URL. The default validity period of the download URL is 15 minutes. If the URL expires, you can call the GetFile operation to obtain a new URL.

https://data.aliyunpds.com/hz22%2F5d5b986facbec311ef844c25954f96821497b383%2F5d5b986f955410dd991646bb87c6b4e899eff525?Expires=xxx&OSSAccessKeyId=xxx&Signature=xxx

thumbnail

string

[Deprecated] The thumbnail URL. Use thumbnail_urls instead.

https://data.aliyunpds.com/hz22%2F5d5b986facbec311ef844c25954f96821497b383%2F5d5b986f955410dd991646bb87c6b4e899eff525?Expires=xxx&OSSAccessKeyId=xxx&Signature=xxx

category

string

The category of the file. PDS categorizes files based on their file name extensions and MIME types. The main categories include doc, image, audio, and video.

image

local_created_at

string

The local creation time of the file. This is the local time when the file was uploaded, which helps the client identify the local upload time.

2019-08-20T06:51:27.292Z

local_modified_at

string

The local modification time of the file. This is the local time when the file was last modified before upload, which helps the client identify the local update time.

2019-08-20T06:51:27.292Z

revision_id

string

The revision ID. A new revision ID is generated when a file with the same file ID is uploaded to overwrite the existing file.

5d5b846942cf94fa72324c14a4bda34e81da635d

thumbnail_urls

object

The returned thumbnail information, which corresponds to the keys passed in the thumbnail_processes request parameter.

string

The returned thumbnail information, which corresponds to the keys passed in the thumbnail_processes request parameter.

"128X128": "https://url1", "800X800": "url2"

image_media_metadata ImageMediaMetadata

The image information. This field is valid only when the image processing value-added service is enabled.

user_tags

object

The user-defined labels.

string

The user-defined labels.

"k1":"v1", "k2","v2"

video_media_metadata VideoMediaMetadata

The audio and video information.

id_path

string

The file ID path.

id1/id2

name_path

string

The file path.

root/f1/f2

dir_size_info

object

The folder statistics information. This field is returned if the fields Settings include dir_size in the ListFile or GetFile operation.

dir_count

integer

The total number of descendant folders in this folder, calculated recursively.

1

file_count

integer

The total number of descendant files in this folder, calculated recursively.

10

action_list

array

The permission list.

string

The permission for a single file operation.

FILE.CREATE

auto_delete_left_sec

integer

The remaining time before files in the recycle bin are automatically deleted.

10000