All Products
Search
Document Center

Drive and Photo Service:File

Last Updated:Feb 26, 2026

Parameter

Type

Description

Example

object

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 time when the file was created.

2019-08-20T06:51:27.292Z

updated_at

string

The time when the file was last modified.

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

Indicates whether the file is hidden.

false

size

integer

If the object is a file, this parameter indicates the file size.

If the object is a folder, this parameter indicates the total size of all files within it. The size is calculated recursively. Note: The folder size is returned only when you include dir_size in the fields parameter of a list file or get file request.

1024

starred

boolean

Indicates whether the file is starred.

false

status

string

The status. 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 the file.

available

labels

array

The tags.

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

string

The tag.

["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

The CRC-64 hash.

3574582125365864471

content_hash

string

The content hash.

EA4942AA8761213890A5C386F88E6464D2C31CA3

content_hash_name

string

The name of the content hash algorithm. Currently, only sha1 is supported.

sha1

download_url

string

The download URL. The URL is valid for 15 minutes by default. If the URL expires, call the GetFile operation to obtain a new one.

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

thumbnail

string

The thumbnail URL. This parameter is deprecated. Use thumbnail_urls instead.

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

category

string

The category. The service categorizes files based on their file name extensions and MIME types. The main categories are doc, image, audio, and video.

image

local_created_at

string

The local creation time of the file. This is the local time on the client at the moment of upload, 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 on the client at the moment of 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 overwritten.

5d5b846942cf94fa72324c14a4bda34e81da635d

thumbnail_urls

object

The returned thumbnail information. The keys in this object correspond to the keys passed in the thumbnail_processes request parameter.

string

The returned thumbnail information. The keys in this object correspond to the keys passed in the thumbnail_processes request parameter.

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

image_media_metadata ImageMediaMetadata

The image information. This parameter is returned only if the image processing value-added service is enabled.

user_tags

object

The custom tags.

string

The custom tag.

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

video_media_metadata VideoMediaMetadata

The audio and video information.

id_path

string

The path of file IDs.

id1/id2

name_path

string

The file path.

root/f1/f2

dir_size_info

object

The statistics information of the folder. This parameter is returned when you call the list file or get file operation and include dir_size in the fields parameter.

dir_count

integer

The total number of subfolders in the folder, calculated recursively.

1

file_count

integer

The total number of files in the folder, calculated recursively.

10

action_list

array

The list of permissions.

string

auto_delete_left_sec

integer

The remaining time in seconds before the file is automatically deleted from the recycle bin.