UpdateFile_网盘与相册服务_API文档

插件下载了解更多
VS Code 插件
安装插件之前,确保已安装 VS Code安装插件之前,确保已安装 VS Code
Alibaba Cloud Developer Toolkit is a collection of extensions that can help access Alibaba Cloud services in Visual Studio Code.
JetBrains 插件
安装插件之前,确保已安装 JetBrains IDE安装插件之前,确保已安装 JetBrains IDE
The Alibaba Cloud Developer Toolkit for JetBrains makes it easier to access Alibaba Cloud services.

流控信息

当前云产品API请求速率暂未透出。

授权信息

当前云产品暂无权限信息透出。

请求语法

POST /v2/file/update HTTP/1.1

请求参数

字段名称字段详情
domain_idstring
bodyobject

请求体参数。

返回参数

字段名称字段详情
domain_idstring

域 id

示例值:bj1
drive_idstring

空间 id

示例值:1
file_idstring

文件 id

示例值:5d79206586bb5dd69fb34c349282718146c55da7
namestring

名称

示例值:1.mov
typestring

类型

示例值:file枚举值:filefolder
content_typestring

内容类型

示例值:application/json
created_atstring

创建时间

示例值:2019-08-20T06:51:27.292Z
updated_atstring

修改时间

示例值:2019-08-20T06:51:27.292Z
descriptionstring

描述

示例值:image file
trashed_atstring

放入回收站时间

示例值:2019-08-20T06:51:27.292Z
file_extensionstring

文件扩展名

示例值:txt
hiddenboolean

是否隐藏

示例值:false
sizeinteger<int64>

如果是文件,表示文件大小展开详情

注意 请注意,该值为 Long 类型,在某些语言中可能存在精度丢失的风险,请小心使用。
示例值:1024
starredboolean

是否收藏

示例值:false
statusstring

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

示例值:available枚举值:availableuploading
labelsarray<string>

标签

示例值:["label1:1", "label2:2"]
upload_idstring

上传 id

示例值:C9DCFE5A82644AC7A02DB74C30C934A6
parent_file_idstring

父文件夹 id

示例值:3d5b846942cf94fa72324c8a4bda34e81da635a
crc64_hashstring

crc64

示例值:3574582125365864471
content_hashstring

内容 hash

示例值:EA4942AA8761213890A5C386F88E6464D2C31CA3
content_hash_namestring

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

示例值:sha1枚举值:sha1
download_urlstring

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

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

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

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

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

示例值:image枚举值:imagedocaudiovideo
local_created_atstring

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

示例值:2019-08-20T06:51:27.292Z
local_modified_atstring

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

示例值:2019-08-20T06:51:27.292Z
revision_idstring

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

示例值:5d5b846942cf94fa72324c14a4bda34e81da635d
thumbnail_urlsmap<string>

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

image_media_metadataImageMediaMetadata

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

user_tagsmap<string>

用户自定义标签

video_media_metadataVideoMediaMetadata

音视频信息

id_pathstring

文件 id 路径

示例值:id1/id2
name_pathstring

文件路径

示例值:root/f1/f2
dir_size_infoobject

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

action_listarray<string>

权限列表

auto_delete_left_secinteger<int64>

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

注意 请注意,该值为 Long 类型,在某些语言中可能存在精度丢失的风险,请小心使用。

返回示例

变更历史

暂无变更历史

相关示例