全部产品
Search
文档中心

网盘与相册服务:File

更新时间:Aug 27, 2026

名称

类型

描述

示例值

object

文件

domain_id

string

域 id

bj1

drive_id

string

空间 id

1

file_id

string

文件 id

5d79206586bb5dd69fb34c349282718146c55da7

name

string

名称

1.mov

type

string

类型

file

content_type

string

内容类型

application/json

created_at

string

创建时间

2019-08-20T06:51:27.292Z

updated_at

string

修改时间

2019-08-20T06:51:27.292Z

description

string

描述

image file

trashed_at

string

放入回收站时间

2019-08-20T06:51:27.292Z

file_extension

string

文件扩展名

txt

hidden

boolean

是否隐藏

false

size

integer

如果是文件,表示文件大小

如果是文件夹,表示文件夹的大小(递归计算所有子孙文件的大小) 备注:文件夹大小只有在 list file,get file 时设置 fields 包含 dir_size 时才会返回

1024

starred

boolean

是否收藏

false

status

string

状态,只有 available 的文件和目录才是可以被访问的,如果文件处于 uploading 状态,GetFile 会返回文件不存在, ListFile 也不会返回 uploading 状态的文件

available

labels

array

标签

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

string

标签

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

upload_id

string

上传 id

C9DCFE5A82644AC7A02DB74C30C934A6

parent_file_id

string

父文件夹 id

3d5b846942cf94fa72324c8a4bda34e81da635a

crc64_hash

string

crc64

3574582125365864471

content_hash

string

内容 hash

EA4942AA8761213890A5C386F88E6464D2C31CA3

content_hash_name

string

内容 hash 算法名,当前 hash 算法支持 sha1

sha1

download_url

string

下载链接, 下载链接默认有效期是 15 分钟,如果 URL 过期,可以通过 GetFile 进行获取

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

thumbnail

string

缩略图地址(已废弃,推荐使用 thumbnail_urls)

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

category

string

分类, pds 会根据文件的后缀名和 mime-type 对文件进行分类,主要分类有 doc, image, audio, video

image

local_created_at

string

文件本地创建时间, 本地创建时间是指文件在上传时刻的本地时间,主要帮助客户端识别本地上传时间

2019-08-20T06:51:27.292Z

local_modified_at

string

文件本地修改时间,文件本地更新时间, 本地更新时间是指文件在上传时刻的本地时间,主要帮助客户端识别本地更新时间

2019-08-20T06:51:27.292Z

revision_id

string

版本 id, 当相同 file-id 文件覆盖上传时, 会有新的 revision_id 产生

5d5b846942cf94fa72324c14a4bda34e81da635d

thumbnail_urls

object

返回的缩略图信息,与入参 thumbnail_processes 中传入的 key 对应。

string

返回的缩略图信息,与入参 thumbnail_processes 中传入的 key 对应。

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

image_media_metadata ImageMediaMetadata

图片信息。仅开启增值服务图片处理功能有效。

user_tags

object

用户自定义标签

string

用户自定义标签

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

video_media_metadata VideoMediaMetadata

音视频信息

id_path

string

文件 id 路径

id1/id2

name_path

string

文件路径

root/f1/f2

dir_size_info

object

list file,get file 时,如果 fields 设置了 dir_size,那么该字段会返回,表示文件夹的统计信息

dir_count

integer

该文件夹下所有子孙文件夹数量,递归计算。

1

file_count

integer

该文件夹下所有子孙文件数量,递归计算。

10

action_list

array

权限列表

string

auto_delete_left_sec

integer

回收站文件自动删除剩余时间