Memahami konektor

Alur kerja 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.

Autentikasi

Konektor menggunakan autentikasi Identity and Access Management bawaan untuk berinteraksi dengan produk Google Cloud lainnya. Perhatikan bahwa alur kerja yang menggunakan konektor masih perlu memiliki izin yang sesuai 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 mengautentikasi ke produk Google Cloud lainnya, lihat Memberikan izin alur kerja untuk mengakses resource Google Cloud.

Upaya coba lagi

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

  • Alur kerja menggunakan kebijakan percobaan ulang idempoten untuk permintaan GET.

  • Alur kerja menggunakan kebijakan percobaan ulang non-idempotent 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 setiap permintaan (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 melakukan operasi yang berjalan lama, perilaku berikut berlaku:

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

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

  • Konektor melakukan polling operasi yang berjalan lama secara berkala. Secara default, Alur Kerja menggunakan backoff eksponensial 1,25 saat melakukan polling, dimulai dengan 1 detik dan melambat menjadi 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.

  • Jika error terjadi selama operasi yang berjalan lama, Alur Kerja akan menampilkan error OperationError. Error menyertakan atribut tambahan, error, yang berisi detail khusus 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 ini mencakup OperationError.
  • operation: Objek operasi yang berjalan lama dan gagal.

Untuk mengetahui daftar mendetail tentang jenis operasi yang berjalan lama dan didukung, lihat Referensi konektor.

Langkah selanjutnya