Códigos de error de almacenamiento de archivos (mpbx-files)

Códigos devueltos por la abstracción ObjectStore (compatible con S3, GCS o disco local). La capa de API asigna el tipo a un estado HTTP igual que para todos los valores de mpbx_common::Error. Los mensajes nunca contienen credenciales ni URL firmadas.

Código	Tipo	Significado	Qué hacer
MPBX-FILES-INVALID-KEY	invalid_argument	Una clave de objeto o un prefijo de listado está mal formado: vacío, de más de 1024 bytes, con un segmento vacío o de punto, con un carácter fuera de A-Z a-z 0-9 . _ - = @ + y /, o una clave del sistema que empieza con t/ (reservada para las empresas).	Construya las claves a partir de ids y nombres saneados; nunca ponga nombres de archivo proporcionados por el usuario en una clave.
MPBX-FILES-INVALID-TTL	invalid_argument	La vigencia de una URL firmada es cero o mayor a 7 días.	Use de 1 segundo a 7 días.
MPBX-FILES-NOT-FOUND	not_found	El objeto no existe (o está fuera del alcance de quien llama).	Revise la clave y la empresa.
MPBX-FILES-CONFLICT	conflict	Una carga solo de creación encontró un objeto existente.	Use una clave nueva, o sobrescriba a propósito.
MPBX-FILES-BACKEND	unavailable	El backend de almacenamiento rechazó la solicitud o no pudo completarla: error de red, credenciales, permisos, bucket faltante, limitación de velocidad. Se puede reintentar.	Revise la configuración de almacenamiento y mpbx selftest; el motivo del backend aparece en la línea del registro.
MPBX-FILES-NOT-SUPPORTED	internal	El backend activo no puede hacer la operación solicitada.	Repórtelo con la línea del registro.
MPBX-FILES-CONFIG	config	La configuración de almacenamiento no es utilizable: prefijo incorrecto, credenciales faltantes o incompletas, raíz local no escribible, configuración de bucket no válida.	Corrija la configuración [files] o el backend de almacenamiento en la interfaz de administración.
MPBX-FILES-TENANT-DENIED	permission_denied	Un manejador de archivos de empresa (TenantFiles) recibió una clave de otra empresa o del alcance de toda la instalación, por ejemplo una referencia almacenada que fue alterada (W1-PBX-10).	Un error o un ataque: revise de dónde salió la clave. Las claves de la empresa se construyen con TenantFiles::key o se aceptan con TenantFiles::parse_owned.
MPBX-FILES-MIGRATE-SIZE	unavailable	mpbx storage migrate copió un objeto pero el tamaño guardado no coincide con el origen (el origen cambió mientras se leía, o el destino perdió bytes). La copia parcial se eliminó.	Ejecute la migración de nuevo; reintentará ese objeto. Si se repite, revise el backend de destino y que nada escriba en el objeto mientras se copia.