Remote Folders
La pestaña Remote Folders de la sección External Storage cataloga los shares de red que C21 Live Control monta para respaldar grabaciones antes de que la retención borre el fichero local. La otra pestaña de External Storage es Target Folders — registros de credenciales que el Editor usa para entregar clips.
Qué es
Cuando un Destination tipo Record de una grabación lleva una ventana de retención delete_after, Live Control copia la grabación al Remote Folder enlazado antes de borrar el fichero local. El Remote Folder es la capa de preservación a largo plazo; sin uno, el fichero se borra de plano cuando expira la ventana.
Toda operación requiere el rol System Administrator.
Campos del formulario
| Etiqueta UI | Campo API | Notas |
|---|---|---|
| Name | name | Nombre visible reutilizado en UI, API y logs. |
| Host | host | Dirección IP o FQDN del servidor del share. |
| Folder | folder | Ruta del share (por ejemplo /exports/recordings). |
| Protocol | protocol | NFS o WEBDAV. |
| User | user | Usuario — solo WebDAV. |
| Password | password | Password — solo WebDAV. Solo escritura en la API — las respuestas GET devuelven has_password: true/false en lugar del valor almacenado. |
Columnas del listado
El listado de Remote Folders expone seis columnas: Name, Host, Folder, Protocol, User y Status (un badge que muestra Valid / Invalid / Unknown según el validation_status actual).
Estado de montaje
El daemon de montaje reporta uno de los siguientes códigos en status:
| Código | Significado |
|---|---|
MNTs000 | Montado correctamente. |
MNTs001 | No se puede resolver el punto de montaje — fallo de resolución DNS o hostname inválido. |
MNTs002 | La ruta del share no existe en el servidor. |
MNTs003 | Servidor inalcanzable. |
MNTs004 | El intento de montaje agotó el timeout. |
MNTs005 | Falló la autenticación (WebDAV). |
MNTs006 | Error de I/O en el montaje. |
MNTs099 | Error de montaje desconocido. |
Validate
La acción Validate Connection llama a POST /c21apiv2/crud/remotefolders/{id}/validate. La validación NFS consulta la lista de exports del servidor con timeout de 5 segundos; la validación WebDAV emite un HTTP HEAD contra el host con el mismo timeout. La respuesta actualiza validation_status, validation_date y (en caso de fallo) un validation_error saneado.
Referencia de API
| Acción | Método + path |
|---|---|
| List | GET /c21apiv2/crud/remotefolders |
| Read | GET /c21apiv2/crud/remotefolders/{id} |
| Create | POST /c21apiv2/crud/remotefolders |
| Update | PUT /c21apiv2/crud/remotefolders/{id} |
| Delete | DELETE /c21apiv2/crud/remotefolders/{id} |
| Validate Connection | POST /c21apiv2/crud/remotefolders/{id}/validate |
Cross-links
- Recordings — flujo de backup de retención que consume Remote Folders.
- Target Folders — la otra pestaña de External Storage, para entrega de clips desde el Editor.
FAQ
MNTs003 / MNTs004 según la causa). El siguiente intento de borrado contra esa carpeta se omite — el fichero local se preserva hasta que el share vuelva. Lanza Validate Connection para refrescar el estado cuando el share se haya restablecido.