# Page Cloud Storage Files

List Cloud Storage files, page by page.
- **Effect**: none. Read-only. Safe to retry with bounded backoff.
- **Visibility**: **only files whose upload was confirmed are listed** — a file with a pre-signed URL that was never completed does not appear. Members without the all-data permission see only files they uploaded.
- **Filtering**: `fileName` matches partially; `tagIds` is an OR match; results are ordered newest first and the order cannot be changed.
- **Caveat**: an entry in `tagInfo` can be null when a tag was deleted while still attached to the file.

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

## Request fields (application/json):

  - `pageNo` (integer)
    Current page number, starting from 1. Default is 1.
    Example: 1

  - `pageSize` (integer)
    Number of items per page. Default is 10.
    Example: 20

  - `fileName` (string)
    File name keyword for fuzzy search.
    Example: report

  - `tagIds` (array)
    Filter files by tag IDs.
    Example: ["1800000000000101"]

  - `fileType` (integer)
    File type filter: 0 = image, 1 = video, 2 = application, 3 = audio, 4 = document, 5 = other.
    Example: 0

  - `fileIds` (array)
    Filter files by file IDs.
    Example: ["1800000000001001"]

## Response 200 fields (application/json):

  - `code` (integer, required)
    Return result code. `0` means success; other codes indicate exceptions.
    Example: 0

  - `msg` (string | null, required)
    Error message.
    Example: null

  - `requestId` (string)
    Operation request ID. This field may be present when the request passes through the API gateway.
    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)
    Cloud storage file ID.
    Example: 1800000000001001

  - `data.dataList.fileName` (string)
    File name (without extension).
    Example: example

  - `data.dataList.fileExt` (string)
    File extension.
    Example: jpg

  - `data.dataList.fileSize` (string)
    File size in bytes.
    Example: 204800

  - `data.dataList.fileType` (integer)
    File type: 0 = image, 1 = video, 2 = application, 3 = audio, 4 = document, 5 = other.
    Example: 0

  - `data.dataList.tagInfo` (array)
    Tag details attached to the file.

  - `data.dataList.tagInfo.id` (string)
    Tag ID.
    Example: 1800000000000101

  - `data.dataList.tagInfo.tagSource` (string)
    Tag source, e.g. ENV, PROXY.
    Example: ENV

  - `data.dataList.tagInfo.tagName` (string)
    Tag name.
    Example: Invoice

  - `data.dataList.tagInfo.tagType` (string)
    Tag type: TAG or GROUP.
    Example: TAG

  - `data.dataList.tagInfo.tagIcon` (string)
    Tag icon.

  - `data.dataList.createDate` (string)
    Upload time.

  - `data.dataList.updateDate` (string)
    Update time.