Connections utrzymują credentials dostawcy poza Jobs i umożliwiają transfer server-to-server. Zewnętrzny import jest normalizowany do File należącego do ConverterHQ przed konwersją; output może trafić do dowolnego wspieranego providera.
Connections
Secrets są szyfrowane i nigdy nie są zwracane. Testuj POST /v1/connections/{id}/test przed produkcją i rotuj lub unieważniaj Connection zamiast kopiować sekrety do Jobs.
Kanoniczny input
import/s3, import/gcs, import/azure i import/sftp pobierają źródło i zapisują je jako ConverterHQ File. Tasks konwersji czytają ten owned File, ujednolicając retries, retencję, checksums i ownership.
Multi-cloud outputs
Wyniki są ConverterHQ Files eksportowanymi przez export/s3, export/gcs, export/azure lub export/sftp. Provider wejścia i wyjścia nie musi być ten sam.
Bezpieczeństwo S3
Dla S3 preferuj AssumeRole z ExternalId i ogranicz rolę do wymaganych bucketów i prefiksów.
Tasks import/export
Kontrakt DAG jest spójny: importy produkują Files, eksporty je konsumują. Zewnętrzne side effects są checkpointowane, aby nie powtarzać po cichu eksportu o niepewnym wyniku.
Obsługa błędów
Błędy uwierzytelnienia, brak obiektu i permissions są deterministyczne do zmiany stanu zewnętrznego. Sprawdź błąd Task i przetestuj Connection przed retry.