# Paginar archivos de almacenamiento en la nube

Lista los archivos de Cloud Storage, página a página.
- **Efecto**: ninguno. Solo lectura. Es seguro reintentar con retroceso acotado.
- **Visibilidad**: **solo se listan los archivos cuya subida se confirmó**: un archivo con una URL prefirmada que nunca se completó no aparece. Los miembros sin el permiso de todos los datos solo ven los archivos que subieron ellos.
- **Filtrado**: `fileName` admite coincidencia parcial; `tagIds` es una coincidencia OR; los resultados se ordenan de más nuevo a más antiguo y ese orden no se puede cambiar.
- **Advertencia**: una entrada de `tagInfo` puede ser null cuando una etiqueta se eliminó mientras seguía asignada al archivo.

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

## Request fields (application/json):

  - `pageNo` (integer)
    Número de la página actual, empezando por 1. Por defecto es 1.
    Example: 1

  - `pageSize` (integer)
    Número de elementos por página. Por defecto es 10.
    Example: 20

  - `fileName` (string)
    Palabra clave del nombre de archivo para búsqueda difusa.
    Example: report

  - `tagIds` (array)
    Filtra los archivos por ID de etiqueta.
    Example: ["1800000000000101"]

  - `fileType` (integer)
    Filtro por tipo de archivo: 0 = imagen, 1 = vídeo, 2 = aplicación, 3 = audio, 4 = documento, 5 = otro.
    Example: 0

  - `fileIds` (array)
    Filtra los archivos por ID de archivo.
    Example: ["1800000000001001"]

## Response 200 fields (application/json):

  - `code` (integer, required)
    Código de resultado. `0` significa correcto; otros códigos indican excepciones.
    Example: 0

  - `msg` (string | null, required)
    Mensaje de error.
    Example: null

  - `requestId` (string)
    ID de la petición de la operación. Este campo puede estar presente cuando la petición pasa por la puerta de enlace de la 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 del archivo de almacenamiento en la nube.
    Example: 1800000000001001

  - `data.dataList.fileName` (string)
    Nombre del archivo (sin extensión).
    Example: example

  - `data.dataList.fileExt` (string)
    Extensión del archivo.
    Example: jpg

  - `data.dataList.fileSize` (string)
    Tamaño del archivo en bytes.
    Example: 204800

  - `data.dataList.fileType` (integer)
    Tipo de archivo: 0 = imagen, 1 = vídeo, 2 = aplicación, 3 = audio, 4 = documento, 5 = otro.
    Example: 0

  - `data.dataList.tagInfo` (array)
    Detalles de las etiquetas asociadas al archivo.

  - `data.dataList.tagInfo.id` (string)
    ID de la etiqueta.
    Example: 1800000000000101

  - `data.dataList.tagInfo.tagSource` (string)
    Origen de la etiqueta, por ejemplo ENV, PROXY.
    Example: ENV

  - `data.dataList.tagInfo.tagName` (string)
    Nombre de la etiqueta.
    Example: Invoice

  - `data.dataList.tagInfo.tagType` (string)
    Tipo de etiqueta: TAG o GROUP.
    Example: TAG

  - `data.dataList.tagInfo.tagIcon` (string)
    Icono de la etiqueta.

  - `data.dataList.createDate` (string)
    Fecha de subida.

  - `data.dataList.updateDate` (string)
    Fecha de actualización.