list
Para ver la estructura de carpetas del almacenamiento, utilice el método file/list.
svc=file/list¶ms={"itemId":<long>,
"storageType":<uint>,
"path":<text>,
"mask":<text>,
"recursive":<bool>,
"fullPath":<bool>}
Parámetros
| Parámetro | Descripción |
|---|---|
| itemId | ID del elemento. |
| storageType | Tipo de almacenamiento: 1 - público (todos los usuarios pueden ver y descargar los archivos), 2 - protegido (solo los usuarios con el derecho de acceso Ver y descargar archivos al elemento pueden ver y descargar los archivos). |
| path | Ruta relativa desde la carpeta raíz hasta la carpeta. |
| mask | Máscara del nombre de archivo. Puede contener el asterisco (*), que reemplaza 0 o más caracteres, y el signo de interrogación (?), que reemplaza 1 carácter. Si indica varias máscaras, sepárelas con comas. |
| recursive | Flag que indica si el contenido debe mostrarse de forma recursiva, con las subcarpetas. |
| fullPath | Flag que indica si debe mostrarse la ruta completa de los elementos. |
Solo el creador del elemento puede colocar y eliminar archivos.
Respuesta
Si la solicitud se completa con éxito, se devuelve la estructura del almacenamiento. La firma n/c significa que el elemento de la jerarquía es una carpeta; la firma n/s, que es un archivo.
[
{
"n": <text>, /* nombre de la carpeta; si "fullPath":true, la ruta desde la carpeta raíz */
"c": [...] /* contenido de la carpeta, puede incluir archivos y/o carpetas; se devuelve si "recursive":true */
},
{
"n": <text>, /* nombre del archivo; si "fullPath":true, la ruta desde la carpeta raíz */
"s": <uint>, /* tamaño del archivo (bytes) */
"ct": <uint>, /* hora de creación del archivo, tiempo UNIX */
"mt": <uint> /* hora de la última modificación del archivo, tiempo UNIX */
},
...
]
Si la solicitud falla, se devuelve un código de error.
Códigos de error
| Código | Descripción |
|---|---|
| 1 | Usuario no autorizado. |
| 4 | Parámetros de entrada no válidos. |
| 5 | No se pudo obtener la lista de archivos en la ruta indicada. |
| 7 | No se encontró el elemento indicado en el parámetro itemId o usted no tiene el derecho de acceso Ver y descargar archivos a este elemento (para el almacenamiento protegido). |