Memahami konektor

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

Konektor dapat digunakan untuk terhubung ke API Google Cloud lain dalam alur kerja, dan untuk mengintegrasikan alur kerja Anda dengan produk Google Cloudtersebut. 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 panggilan layanan 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 produkGoogle Cloud lainnya. Perhatikan bahwa alur kerja yang menggunakan konektor tetap harus memiliki izin yang tepat yang ditetapkan ke akun layanannya agar dapat mengautentikasi API tertentu dengan benar. 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 Memberi alur kerja izin untuk mengakses Google Cloud resource.

Upaya coba lagi

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

  • Workflows menggunakan kebijakan percobaan ulang idempoten untuk permintaan GET.

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

  • Secara default, permintaan akan mencapai waktu tunggu 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 (LRO), perilaku berikut berlaku:

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

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

  • Konektor mem-polling resource LRO secara berkala. Secara default, Workflows 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. Untuk mengetahui daftar jenis resource LRO yang didukung, lihat Referensi konektor.

  • Mekanisme coba lagi sebelumnya berlaku untuk upaya polling yang gagal.

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

  • Jika terjadi error selama operasi yang berjalan lama, Workflows akan memunculkan error OperationError. Error ini mencakup atribut tambahan, yaitu 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 mencakup OperationError.
  • operation: Objek operasi yang berjalan lama dan gagal.

Langkah berikutnya