Lihat konektor yang didukung untuk Application Integration.

Penanganan error dan kesalahan

Dalam Application Integration, error dapat terjadi saat Anda menguji dan memublikasikan integrasi, atau selama menjalankan integrasi. Error ini dapat terjadi karena berbagai masalah sisi klien dan sisi server, dan secara luas diklasifikasikan sebagai berikut:

Error permanen: Semua error sisi klien seperti, kegagalan autentikasi, error validasi data, dianggap sebagai error permanen. Error permanen menyebabkan kegagalan tugas permanen.
Error sementara: Semua error sisi server seperti, HTTP 503 (layanan tidak tersedia), HTTP 400 (permintaan buruk), dianggap sebagai error sementara. Error sementara menyebabkan kegagalan tugas sementara.

Pesan error muncul di lokasi berikut:

Halaman log eksekusi: Menampilkan error yang terjadi selama eksekusi integrasi. Setiap eksekusi integrasi memiliki entri log terpisah. Untuk mengetahui informasi tentang halaman log eksekusi, lihat Log eksekusi.
Halaman editor integrasi: Menampilkan error yang ditemukan saat Anda memublikasikan integrasi. Error ditampilkan di bagian bawah halaman editor integrasi. Untuk informasi tentang halaman editor integrasi, lihat Editor integrasi.

Untuk mengetahui informasi tentang daftar kode error yang mungkin Anda alami, lihat Kode error.

Metode penanganan error

Application Integration menawarkan beberapa metode penanganan error untuk merespons dan memulihkan error yang dialami saat membuat, menguji, memublikasikan, atau menjalankan integrasi Anda. Anda dapat menggunakan metode penanganan error untuk mode eksekusi integrasi sinkron dan asinkron:

Eksekusi sinkron: Dalam mode sinkron, hasil eksekusi integrasi akan segera tersedia setelah integrasi berjalan. Mode sinkron berguna dalam skenario ketika Anda menginginkan hasil eksekusi segera setelah integrasi dijalankan. Pemicu menjalankan integrasi dalam mode sinkron meliputi hal berikut:
- Menguji atau memublikasikan integrasi
- Memanggil projects.locations.integrations.execute API
- Memanggil integrasi dari sub-integrasi dalam mode sinkron
Eksekusi asinkron: Eksekusi asinkron menggunakan model aktifkan dan lupakan. Mode asinkron sangat membantu dalam skenario saat integrasi dapat memerlukan waktu lama untuk dijalankan, atau hasil eksekusi tidak diperlukan segera setelah integrasi berjalan. Pemicu yang menjalankan integrasi dalam mode asinkron meliputi:
- Semua eksekusi yang tidak sinkron dijalankan dalam mode asinkron. Beberapa mode asinkron yang umum mencakup, tetapi tidak terbatas pada:
  - Menjadwalkan pemicu
  - Pemicu Cloud Scheduler
  - Pemicu Cloud Pub/Sub
  - Pemicu Salesforce
  - Memanggil projects.locations.integrations.schedule API
- Eksekusi yang dilanjutkan dari tugas penangguhan atau persetujuan juga dijalankan dalam mode aynchronous, meskipun eksekusi awal adalah mode sinkron.

Application Integration mendukung metode penanganan error berikut untuk menampilkan, menangkap, mencoba lagi, dan menyesuaikan error yang ditemukan dalam integrasi Anda:

Kode error

Tabel berikut menjelaskan error yang mungkin Anda alami, dan penyebab error yang sesuai. Application Integration menggunakan kode error kanonis yang ditentukan di google.rpc.Code.

Untuk informasi tentang error Application Integration dan strategi penanganan error yang berbeda, lihat Penanganan error dan error.

Jenis pengecualian standar	Kode kanonis	Kode HTTP	Deskripsi
FailedPreconditionException	`FAILED_PRECONDITION`	400	Permintaan tidak dapat dijalankan dalam status sistem saat ini.
BadRequestException	`INVALID_ARGUMENT`	400	Klien menentukan argumen yang tidak valid. Periksa pesan error dan detail error untuk mengetahui informasi selengkapnya.
UnauthenticatedException	`UNAUTHENTICATED`	401	Permintaan tidak diautentikasi karena token OAuth tidak ada, tidak valid, atau sudah tidak berlaku.
ForbiddenException	`PERMISSION_DENIED`	403	Klien tidak memiliki izin yang memadai. Hal ini dapat terjadi jika token OAuth tidak memiliki cakupan yang tepat, klien tidak memiliki izin yang diperlukan, atau API belum diaktifkan.
NotFoundException	`NOT_FOUND`	404	Resource yang ditentukan tidak ditemukan.
AlreadyExistsException	`ALREADY_EXISTS`	409	Resource yang klien coba buat sudah ada.
InternalError	`INTERNAL`	500	Error server internal. Biasanya bug server. Hal ini dapat terjadi jika salah satu tugas atau pemicu tidak dikonfigurasi dengan benar.
UnimplementedException	`UNIMPLEMENTED`	501	Metode API tidak diimplementasikan oleh server.
ServiceUnavailableException	`UNAVAILABLE`	503	Layanan tidak tersedia. Biasanya server sedang mati.
AbortedException	`ABORTED`	409	Ukuran respons terlalu besar.