Connections mantêm credenciais do provedor fora de Jobs e permitem transferências servidor a servidor. Imports externos são normalizados em um File do ConverterHQ antes da conversão; outputs podem ser entregues a qualquer provedor compatível.
Connections
Segredos são criptografados e nunca retornados. Teste POST /v1/connections/{id}/test antes da produção e rotacione ou revogue a Connection em vez de copiar segredos para Jobs.
Entrada canônica
import/s3, import/gcs, import/azure e import/sftp obtêm a fonte e persistem um File do ConverterHQ. Tasks de conversão leem esse File, unificando retries, retenção, checksums e ownership.
Outputs multi-cloud
Resultados são Files do ConverterHQ e podem ser exportados com export/s3, export/gcs, export/azure ou export/sftp. O provedor de entrada e saída pode ser diferente.
Segurança S3
Para S3, prefira AssumeRole com ExternalId e limite a role aos buckets e prefixos necessários.
Tasks de import/export
O contrato DAG é consistente: imports produzem Files e exports consomem Files. Efeitos externos são checkpointados para não repetir silenciosamente um export incerto.
Tratamento de falhas
Falhas de autenticação, objetos ausentes e permissões são determinísticos até o estado externo mudar. Inspecione o erro da Task e teste a Connection antes de tentar novamente.