全部產品
Search
文件中心

Drive and Photo Service:File

更新時間:Feb 26, 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

資源回收筒檔案自動刪除剩餘時間