Connections halten Provider-Credentials aus Job-Payloads heraus und ermöglichen Server-zu-Server-Transfers. Externe Imports werden vor der Konvertierung in ein ConverterHQ-eigenes File normalisiert; Outputs können an jeden unterstützten Provider geliefert werden.
Connections
Secrets werden verschlüsselt und nie von der API zurückgegeben. Testen Sie POST /v1/connections/{id}/test vor Produktions-Workflows und rotieren oder widerrufen Sie Connections statt Secrets in Jobs zu kopieren.
Kanonisches Input-Staging
import/s3, import/gcs, import/azure und import/sftp laden die Quelle zunächst und speichern sie als eigenes ConverterHQ-File. Konvertierungs-Tasks lesen dieses File, damit Retries, Retention, Checksums und Ownership einheitlich bleiben.
Multi-Cloud-Outputs
Ergebnisse sind ConverterHQ-Files und lassen sich mit export/s3, export/gcs, export/azure oder export/sftp ausliefern. Input- und Output-Provider müssen nicht übereinstimmen.
S3-Sicherheit
Für S3 bevorzugen Sie AssumeRole mit ExternalId und beschränken die Rolle auf benötigte Buckets und Präfixe.
Import-/Export-Tasks
Der DAG-Vertrag bleibt providerübergreifend gleich: Imports erzeugen Files, Exports konsumieren Files. Externe Export-Effekte werden checkpointed, damit ein unsicheres Ergebnis nicht unbemerkt wiederholt wird.
Fehlerbehandlung
Authentifizierungsfehler, fehlende Objekte und Berechtigungsfehler bleiben deterministisch, bis sich der externe Zustand ändert. Prüfen Sie den Task-Fehler und testen Sie die Connection vor einem Retry.