Memahami konektor

Workflows memublikasikan konektor untuk mempermudah akses ke produk Google Cloud lainnya dalam alur kerja. Untuk referensi mendetail tentang konektor yang tersedia, lihat Referensi konektor.

Konektor dapat digunakan untuk terhubung ke Google Cloud API lainnya dalam alur kerja, dan untuk mengintegrasikan alur kerja Anda dengan produk Google Cloud tersebut. Misalnya, Anda dapat menggunakan konektor untuk memublikasikan pesan Pub/Sub, membaca atau menulis data ke database Firestore, atau mengambil kunci autentikasi dari Secret Manager. Pelajari cara menggunakan konektor.

Konektor menyederhanakan layanan panggilan karena menangani pemformatan permintaan untuk Anda, menyediakan metode dan argumen sehingga Anda tidak perlu mengetahui detail Google Cloud API.

Konektor memiliki perilaku bawaan untuk menangani percobaan ulang dan operasi yang berjalan lama.

Authentication

Konektor menggunakan autentikasi Identity and Access Management bawaan untuk berinteraksi dengan produk Google Cloud lainnya. Perhatikan bahwa alur kerja yang menggunakan konektor masih harus memiliki izin yang tepat yang ditetapkan ke akun layanannya untuk melakukan autentikasi dengan benar ke API tertentu. Misalnya, untuk memublikasikan pesan ke Pub/Sub, akun layanan yang terkait dengan alur kerja Anda harus diberi peran roles/pubsub.publisher. Untuk mempelajari lebih lanjut cara melakukan autentikasi ke produk Google Cloud lainnya, lihat Memberikan izin alur kerja untuk mengakses resource Google Cloud.

Upaya coba lagi

Semua konektor menerapkan kebijakan percobaan ulang berikut dan konfigurasi penanganan error:

  • Workflows menggunakan kebijakan percobaan ulang idempoten untuk permintaan GET.

  • Workflows menggunakan kebijakan percobaan ulang non-idempoten untuk semua metode HTTP lainnya.

  • Secara default, waktu tunggu permintaan habis setelah 30 menit. Perhatikan bahwa untuk operasi yang berjalan lama, hal ini berlaku untuk permintaan individual (misalnya, memulai operasi atau memeriksa statusnya) dalam operasi yang berjalan lama. Waktu tunggu untuk seluruh operasi dapat dikonfigurasi menggunakan kolom connector_params. Lihat Referensi konektor.

Operasi yang berjalan lama

Untuk panggilan yang menjalankan operasi yang berjalan lama, perilaku berikut berlaku:

  • Alur kerja memblokir eksekusi alur kerja hingga operasi selesai atau gagal.

  • Secara default, waktu tunggu panggilan habis setelah 30 menit. Waktu tunggu panggilan dapat diubah menggunakan kolom connector_params (maksimum satu tahun). Lihat Referensi konektor.

  • Konektor melakukan polling pada operasi yang berjalan lama secara berkala. Secara default, Workflow menggunakan backoff eksponensial 1,25 saat melakukan polling, dimulai dengan 1 detik dan melambat hingga 60 detik di antara polling. Setiap upaya polling dihitung sebagai langkah yang dapat ditagih. Parameter polling dapat diubah menggunakan kolom connector_params. Lihat Referensi konektor.

  • Mekanisme percobaan ulang sebelumnya berlaku untuk upaya polling yang gagal.

  • Respons polling diperiksa dan jika payload respons tidak valid, error ResponseTypeError akan ditampilkan.

  • Saat terjadi error selama operasi yang berjalan lama, Workflows akan memunculkan error OperationError. Error tersebut menyertakan atribut tambahan, error, yang berisi detail spesifik operasi.

Jika operasi yang berjalan lama gagal, panggilan konektor akan menampilkan pengecualian dengan atribut berikut:

  • message: Pesan error yang dapat dibaca manusia.
  • tags: Daftar tag. Untuk panggilan konektor operasi yang berjalan lama, daftar tersebut menyertakan OperationError.
  • operation: Objek operasi yang berjalan lama yang gagal.

Untuk mengetahui daftar mendetail tentang jenis operasi jangka panjang yang didukung, lihat Referensi konektor.

Langkah selanjutnya