文档首页/ 云空间服务 KooDrive/ API参考（运营商）/ API/ 获取文件列表/ 获取个人空间文件列表 - getPersonalFiles
更新时间：2026-04-16 GMT+08:00
查看PDF
分享

获取个人空间文件列表 - getPersonalFiles

功能介绍

获取个人空间文件列表。

授权信息

当前API调用无需身份策略权限。

URI

POST /koodrive/ose/v1/files/{type}

表1 路径参数

参数

是否必选

参数类型

描述

type

是

String

参数解释：

空间类型

约束限制：

不涉及

取值范围：

0：个人空间，1：个人回收站

默认取值：

不涉及

请求参数

表2 请求Header参数

参数

是否必选

参数类型

描述

Authorization

是

String

参数解释：

该字段存储的是Access Token。

调用KooDrive的API使用Token认证，拥有Token就代表拥有某种权限，在调用API的时候将Token加到请求消息头中，从而通过身份认证，获得操作API的权限。

约束限制：

格式参考：Bearer+{access_token}

取值范围：

Access Token的获取请参考对应的开发手册

默认取值：

不涉及

X-Traceid

否

String

参数解释：

消息日志跟踪标识（必须58位）

约束限制：

不涉及

取值范围：

不涉及

默认取值：

不涉及

language

否

String

参数解释：

国际化语言标识

约束限制：

符合i18n规范

取值范围：

zh-CN表示简体中文，en-US表示美式英语

默认取值：

默认美式英语

X-User-Id

是

String

参数解释：

koodrive侧用户id，用于app鉴权

约束限制：

不涉及

取值范围：

不涉及

默认取值：

不涉及

X-Date

是

String

参数解释：

日期，用于app鉴权

约束限制：

距当前时间15分钟以内，不能晚于当前时间

取值范围：

日期格式，yyyMMdd'T'HHmmss'Z'，例：20251103T070140Z

默认取值：

不涉及
表3 请求Body参数

参数

是否必选

参数类型

描述

pageInfo

否

PageInfo object

参数解释：

分页信息

约束限制：

不涉及

取值范围：

不涉及

默认取值：

不涉及

sortInfo

否

FileSortInfo object

参数解释：

分类信息

约束限制：

不涉及

取值范围：

不涉及

containerId

是

String

参数解释：

空间标识

约束限制：

长度限制64

取值范围：

不涉及

默认取值：

不涉及

parentFileId

是

String

参数解释：

文件父目录

约束限制：

长度限制64

取值范围：

根目录查询传root，其他目录下传父目录id

默认取值：

不涉及

fileType

否

String

参数解释：

文件类型

约束限制：

不涉及

取值范围：

10：文件夹 - 11：智能文件夹（该功能目前只有白名单用户使用）- 15：图片- 20：视频- 26：word - 27：excel - 28：ppt- 30：音频- 35：压缩文件- 40：应用 - 45：其他

默认取值：

不涉及

imageProcess

否

String

参数解释：

图片操作，可用于指定缩略图尺寸

约束限制：

长度限制300

取值范围：

具体取值参照https://support.huaweicloud.com/usermanual-obs/obs_01_0430.html

默认取值：

不涉及

hidden

否

Boolean

参数解释：是否查询隐藏文件（该功能目前只有白名单用户使用）

约束限制：

不涉及

取值范围：

不涉及

默认取值：

不涉及

fileName

否

String

参数解释：

文件名

约束限制：

长度限制80

取值范围：

不涉及

默认取值：

不涉及

usage

否

String

参数解释：

文档、视频缩略图格式

约束限制：

长度限制100

取值范围：

minThumbnail,midThumbnail,largeThumbnail,superLargeThumbnail

默认取值：

不涉及
表4 PageInfo

参数

是否必选

参数类型

描述

pageSize

否

Integer

参数解释：

每页文件数量，

约束限制：

不涉及

取值范围：

取值范围[1,100]

默认取值：

默认100

pageCursor

否

String

参数解释：

分页起始游标

约束限制：

不涉及

取值范围：

不涉及

默认取值：

不涉及
表5 FileSortInfo

参数

是否必选

参数类型

描述

sortType

否

Integer

参数解释：

排序字段

约束限制：

不涉及

取值范围：

枚举类型： - fileName：文件名 - size：文件大小 - type：文件格式 - updateTime：最后更新时间 - createTime：创建时间 - recycledTime：删除时间 - fileSuffix：文件格式小类

默认取值：

不涉及

sortDirection

否

Integer

参数解释：

排序顺序

约束限制：

不涉及

取值范围：

asc：升序 - desc：降序

默认取值：

不涉及

响应参数

状态码：200

表6 响应Body参数

参数

参数类型

描述

category

String

资源类型，固定值为drive#fileList

nextCursor

String

分页游标，如果不存在，代表已返回最后一个

searchCompleted

Boolean

是否是完整的搜索

files

Array of FileListMetadata objects

文件列表

code

String

返回码

msg

String

返回信息
表7 FileListMetadata

参数

参数类型

描述

id

String

文件id

fileName

String

文件名，最长250个字符

fileType

String

文件类型，外部输入

mimeType

String

内容类型

favorite

Boolean

文件是否被收藏

recycled

Boolean

文件是否被放入回收站

recycledTime

String

放入回收站的时间，文件被回收时返回

parentFolder

Array of strings

父目录ID列表，注意：当前只取第一个父目录Id

properties

Map<String,Object>

文件公共自定义属性。key-value个数不能超过30个；单个key-value长度不超过124字符

containers

Array of strings

空间标识

createdTime

String

文件创建时间，UTC时间。

editedTime

String

文件修改时间，UTC时间。

owners

Array of User objects

拥有者

lastEditor

User object

最后编辑者

fileSuffix

String

文件后缀，fullFileExtension最后一个字符串

size

Long

文件大小，单位：字节

attachments

Array of FileListAttachment objects

附件（用途，附件）

downloadLinks

Array of downLoadLinks objects

FileProxy文件列表下载地址

userProperties

Array of PrivateProperties objects

用户属性

sha256

String

文件256

userCapabilities

userCapabilities object

用户权限

hidden

Boolean

是否隐藏

directlyRecycled

Boolean

是否被直接回收

idPath

String

文件/文件夹的ID路径

creatingUser

String

创建者
表8 User

参数

参数类型

描述

category

String

类型，drive#user

userId

String

华为用户ID

displayName

String

用户显示名

me

Boolean

是否是我

permissionId

String

权限id
表9 FileListAttachment

参数

参数类型

描述

usage

String

用途默认：'content'-实体内容、'thumbnail'-缩略图，业务可以扩展该字段

hash

String

Asset关联的资源的hash

sha256

String

Asset关联的资源的sha256

asset

FileListAsset object

资产
表10 FileListAsset

参数

参数类型

描述

resource

FileListResource object

资源

mimeType

String

MIME type
表11 FileListResource

参数

参数类型

描述

object

FileListSliceObject object

分片对象，适用于type={0,3}
表12 FileListSliceObject

参数

参数类型

描述

id

String

分片ID

start

Integer

分片的起始位置，不适用于type={12}

downloadUrl

EndpointURLMetadata object

下载url

image

Array of Images objects

缩略图信息
表13 Images

参数

参数类型

描述

process

String

文件资源名称

downloadUrl

EndpointURLMetadata object

文件上传或下载的URL结构
表14 EndpointURLMetadata

参数

参数类型

描述

url

String

URL

method

String

http method
表15 downLoadLinks

参数

参数类型

描述

usage

String

用途，thumbnail缩略图，content内容

downloadLink

String

图片地址
表16 PrivateProperties

参数

参数类型

描述

attributes

Map<String,String>

类型属性（不限单个属性长度，限制总大小为16K以内）

properties

Map<String,String>

扩展属性（不限单个属性长度，限制总大小为16K以内）
表17 userCapabilities

参数

参数类型

描述

addChildNodePermission

Boolean

是否可以增加子目录/文件

copyPermission

Boolean

是否可以拷贝

deletePermission

Boolean

是否可以删除

downloadPermission

Boolean

是否可以下载内容

editPermission

Boolean

是否可以编辑

listChildNodePermission

Boolean

是否可以list子目录/文件

removeChildNodePermission

Boolean

是否可以移动子目录

renameFilePermission

Boolean

是否可以重命名

shareFilePermission

Boolean

是否可以共享

uploadPermission

Boolean

是否可以上传文件

viewPermission

Boolean

是否可以预览

状态码：400

表18 响应Body参数

参数

参数类型

描述

error

Error object

错误信息
表19 Error

参数

参数类型

描述

errorData

errorData object

异常时候返回给访问者的扩展数据

errorDetail

Array of ErrorMsg objects

错误链

code

Integer

http状态码

description

String

http状态信息
表20 errorData

参数

参数类型

描述

conflictFileId

String

冲突文件ID
表21 ErrorMsg

参数

参数类型

描述

domain

String

域

reason

String

错误原因

errorCode

String

系统内部错误编码，参见错误码规范

description

String

错误描述信息

errorPos

String

错误位置类型

errorParam

String

错误位置

请求示例

查看个人空间IAADfsBFCO6WtAtuAb7e92cde625843cfb7f4ceba802e0b根目录下的文件列表。

POST /koodrive/ose/v1/files/0

Authorization:Bearer+10f88*********4791e9ff

{
  "pageInfo": {
    "pageSize": "10",
    "pageCursor": ""
  },
  "sortInfo": {
    "sortType": "",
    "sortDirection": ""
  },
  "containerId": "IAADfsBFCO6WtAtuAb7e92cde625843cfb7f4ceba802e0b",
  "parentFileId": "root",
  "fileType": "",
  "fileName": ""
}

响应示例

状态码：200

返回文件列表

{
  "category" : "drive#fileList",
  "nextCursor" : "0|[9-1-0,11-0-1][JzIwMjMtMTItMTNUMDM6MzA6NTkuNTU4Wic=,J0ZpQk02VHhsS2JiSEx4LW54X3FaT2M1bFJBZXEwU0xZeCc=]",
  "searchCompleted" : false,
  "files" : [ {
    "id" : "Fk0n_I_3nVynIIlxGSUdLkYILxIZQ5Yyp",
    "fileName" : "AI测试-勿删",
    "mimeType" : "application/vnd.huawei-apps.folder",
    "fileSuffix" : "",
    "recycled" : false,
    "parentFolder" : [ "DEUI7pa0C24ArootIAADfsBFCO6WtAtuAb7e92cde625843cfb7f4ceba802e0b" ],
    "containers" : [ "IAADfsBFCO6WtAtuAb7e92cde625843cfb7f4ceba802e0b" ],
    "properties" : {
      "srcFileId" : "Fuyt9uELO9mny6vLWnWpIDqppRh3vzC3p",
      "createUser" : "369528171409614001",
      "lastEditUser" : "369528171409614001"
    },
    "owners" : [ {
      "category" : "drive#user",
      "me" : true,
      "permissionId" : "1243622029865966464",
      "userId" : "NDEzMDA4NjAwMDAwMjc0MTY2NS00MDA4NjAwMDAwNDg3MTY2Ng",
      "displayName" : "租户管理员"
    } ],
    "lastEditor" : {
      "category" : "drive#user",
      "me" : true,
      "permissionId" : "1243622029865966464",
      "userId" : "NDEzMDA4NjAwMDAwMjc0MTY2NS00MDA4NjAwMDAwNDg3MTY2Ng",
      "displayName" : "租户管理员"
    },
    "fileType" : "10",
    "createdTime" : "2023-12-11T09:17:25.529Z",
    "editedTime" : "2023-12-11T09:17:25.529Z",
    "favorite" : false
  } ],
  "code" : 0,
  "msg" : "成功"
}

状态码

状态码

描述

200

返回文件列表

400

Bad request
父主题： 获取文件列表