# 分页查询云存储文件

分页列出云存储文件。
- **副作用**：无。只读。可带退避安全重试。
- **可见性**：**只列出已确认上传完成的文件**——拿了预签名 URL 但从未完成登记的文件不会出现。没有全量数据权限的成员只能看到自己上传的文件。
- **筛选**：`fileName` 为模糊匹配；`tagIds` 为「命中任一即返回」；结果按创建时间倒序，顺序不可更改。
- **注意**：如果某个标签在仍挂在文件上时被删除，`tagInfo` 里会出现 null 元素。

Endpoint: POST /api/cloudstorage/file/page
Version: 2026-09-05

## Request fields (application/json):

  - `pageNo` (integer)
    当前页码，从 1 开始，默认 1。
    Example: 1

  - `pageSize` (integer)
    每页条数，默认 10。
    Example: 20

  - `fileName` (string)
    用于模糊搜索的文件名关键字。
    Example: report

  - `tagIds` (array)
    按标签 ID 筛选。
    Example: ["1800000000000101"]

  - `fileType` (integer)
    文件类型筛选：0 = 图片，1 = 视频，2 = 应用，3 = 音频，4 = 文档，5 = 其他。
    Example: 0

  - `fileIds` (array)
    按文件 ID 筛选。
    Example: ["1800000000001001"]

## Response 200 fields (application/json):

  - `code` (integer, required)
    返回结果码。`0` 表示成功；其他值表示异常。
    Example: 0

  - `msg` (string | null, required)
    错误信息。
    Example: null

  - `requestId` (string)
    操作请求 ID。请求经过 API 网关时可能返回该字段。
    Example: 1d4f3ea968664593860b94b35d4ebf5e

  - `data` (object, required)

  - `data.current` (string, required)
    Example: 1

  - `data.pages` (string, required)
    Example: 7

  - `data.total` (string, required)
    Example: 128

  - `data.dataList` (array, required)

  - `data.dataList.id` (string)
    云存储文件 ID。
    Example: 1800000000001001

  - `data.dataList.fileName` (string)
    文件名（不含扩展名）。
    Example: example

  - `data.dataList.fileExt` (string)
    文件扩展名。
    Example: jpg

  - `data.dataList.fileSize` (string)
    文件大小，单位字节。
    Example: 204800

  - `data.dataList.fileType` (integer)
    文件类型：0 = 图片，1 = 视频，2 = 应用，3 = 音频，4 = 文档，5 = 其他。
    Example: 0

  - `data.dataList.tagInfo` (array)
    文件上的标签详情。

  - `data.dataList.tagInfo.id` (string)
    标签 ID。
    Example: 1800000000000101

  - `data.dataList.tagInfo.tagSource` (string)
    标签来源，如 ENV、PROXY。
    Example: ENV

  - `data.dataList.tagInfo.tagName` (string)
    标签名称。
    Example: Invoice

  - `data.dataList.tagInfo.tagType` (string)
    标签类型：TAG 或 GROUP。
    Example: TAG

  - `data.dataList.tagInfo.tagIcon` (string)
    标签图标。

  - `data.dataList.createDate` (string)
    上传时间。

  - `data.dataList.updateDate` (string)
    更新时间。