Las Connections mantienen credenciales del proveedor fuera de los Jobs y permiten transferencias servidor a servidor. Los imports externos se normalizan en un File propiedad de ConverterHQ antes de convertir; los outputs pueden entregarse a cualquier proveedor compatible.
Connections
Los secretos se cifran y nunca se devuelven. Prueba POST /v1/connections/{id}/test antes de producción y rota o revoca una Connection en vez de copiar secretos a Jobs.
Entrada canónica
import/s3, import/gcs, import/azure e import/sftp obtienen la fuente y la guardan como File de ConverterHQ. Las Tasks de conversión leen ese File para mantener coherentes retries, retención, checksums y ownership.
Outputs multi-cloud
Los resultados son Files de ConverterHQ y pueden exportarse con export/s3, export/gcs, export/azure o export/sftp. El proveedor de entrada y salida no tiene que coincidir.
Seguridad S3
Para S3, prefiere AssumeRole con ExternalId y limita el rol a los buckets y prefijos necesarios.
Tasks de import/export
El contrato DAG es consistente: los imports producen Files y los exports consumen Files. Los efectos externos se checkpointan para evitar repetir silenciosamente un export incierto.
Gestión de fallos
Errores de autenticación, objetos ausentes y permisos son deterministas hasta que cambie el estado externo. Inspecciona el error de Task y prueba la Connection antes de reintentar.