# クラウドストレージファイルをページ照会

クラウドストレージのファイルをページ単位で一覧します。
- **副作用**：なし。読み取り専用。バックオフを入れれば安全にリトライできます。
- **可視性**：**アップロードが確定したファイルのみが一覧されます** — 署名付き URL を発行したが完了しなかったファイルは現れません。全データ権限を持たないメンバーには、自分がアップロードしたファイルのみが見えます。
- **フィルタリング**：`fileName` は部分一致、`tagIds` は OR 一致です。結果は新しい順に並び、この順序は変更できません。
- **注意**：ファイルに紐付いたままタグが削除された場合、`tagInfo` の要素が null になることがあります。

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

## Request fields (application/json):

  - `pageNo` (integer)
    現在のページ番号。1 から始まります。デフォルトは 1 です。
    Example: 1

  - `pageSize` (integer)
    1 ページあたりの件数。デフォルトは 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)
    更新日時。