Connections provider kimlik bilgilerini Jobs dışında tutar ve server-to-server transfer sağlar. Harici import, dönüşümden önce ConverterHQ’nun sahip olduğu bir File’a normalize edilir; output desteklenen herhangi bir provider’a gönderilebilir.
Connections
Secret’lar şifrelenir ve API tarafından geri verilmez. Production öncesi POST /v1/connections/{id}/test kullanın; secret’ı Job’a kopyalamak yerine Connection’ı rotate veya revoke edin.
Kanonik input staging
import/s3, import/gcs, import/azure ve import/sftp kaynağı alır ve ConverterHQ File olarak saklar. Conversion Tasks bu owned File’ı okuyarak retry, retention, checksum ve ownership sınırını tutarlı hale getirir.
Multi-cloud outputs
Sonuçlar export/s3, export/gcs, export/azure veya export/sftp ile gönderilebilen ConverterHQ Files’dır. Input ve output provider aynı olmak zorunda değildir.
S3 güvenliği
S3 için uzun süreli key yerine ExternalId ile AssumeRole tercih edin ve role’ü yalnız gerekli bucket/prefix’lerle sınırlayın.
Import/export Tasks
DAG contract provider’lar arasında aynıdır: import Files üretir, export Files tüketir. Harici export side effect’leri checkpoint edilerek belirsiz sonuç sessizce tekrarlanmaz.
Hata yönetimi
Authentication, missing object ve permission hataları dış durum değişene kadar deterministiktir. Retry öncesi Task error’u inceleyin ve Connection’ı test edin.