Le Connections tengono le credenziali del provider fuori dai Jobs e consentono trasferimenti server-to-server. Gli import esterni vengono normalizzati in un File di ConverterHQ prima della conversione; gli output possono essere consegnati a qualsiasi provider supportato.
Connections
I secret sono cifrati e non vengono mai restituiti. Testa POST /v1/connections/{id}/test prima della produzione e ruota o revoca una Connection invece di copiare secret nei Jobs.
Input canonico
import/s3, import/gcs, import/azure e import/sftp recuperano la sorgente e la persistono come File ConverterHQ. Le Tasks di conversione leggono questo File per uniformare retry, retention, checksum e ownership.
Output multi-cloud
I risultati sono Files ConverterHQ esportabili con export/s3, export/gcs, export/azure o export/sftp. Provider di input e output possono essere diversi.
Sicurezza S3
Per S3 preferisci AssumeRole con ExternalId e limita il ruolo ai bucket e prefissi necessari.
Tasks import/export
Il contratto DAG resta coerente: gli import producono Files e gli export consumano Files. Gli effetti esterni vengono checkpointed per evitare di ripetere in silenzio un export dal risultato incerto.
Gestione errori
Errori di autenticazione, oggetti mancanti e permessi sono deterministici finché lo stato esterno non cambia. Ispeziona l’errore Task e testa la Connection prima del retry.