Penanganan error dan kesalahan

Dalam Integrasi Apigee, 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, serta dapat diklasifikasikan secara luas 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 ditemukan 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 akan 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 lihat, lihat Kode error.

Metode penanganan error

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

  • Eksekusi sinkron: Dalam mode sinkron, hasil eksekusi integrasi akan segera tersedia setelah integrasi berjalan. Mode sinkron berguna dalam skenario saat Anda menginginkan hasil eksekusi segera setelah integrasi berjalan. Pemicu menjalankan integrasi dalam mode sinkron mencakup hal berikut:
  • Eksekusi asinkron: Eksekusi asinkron menggunakan model aktif dan lupakan. Mode asinkron berguna dalam skenario di mana integrasi dapat membutuhkan waktu lama untuk dijalankan, atau hasil eksekusi tidak diperlukan segera setelah integrasi berjalan. Pemicu yang menjalankan integrasi dalam mode asinkron mencakup hal berikut:

Integrasi Apigee mendukung metode penanganan error berikut untuk menampilkan, menangkap, mencoba ulang, dan menyesuaikan error yang ditemukan dalam integrasi Anda:

Kode error

Tabel berikut menjelaskan error yang mungkin Anda alami, dan penyebab error terkait. Integrasi Apigee menggunakan kode error kanonis yang ditentukan di google.rpc.Code.

Untuk mengetahui informasi tentang error Integrasi Apigee dan strategi penanganan error yang berbeda, lihat Error dan penanganan 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 berupa {i>bug<i} server. Hal ini dapat terjadi jika ada tugas atau pemicu yang tidak dikonfigurasi dengan benar.
UnimplementedException UNIMPLEMENTED 501 Metode API tidak diimplementasikan oleh server.
ServiceUnavailableException UNAVAILABLE 503 Layanan tidak tersedia. Biasanya server mati.
AbortedException ABORTED 409 Ukuran respons terlalu besar.