全部产品
Search
文档中心

API Gateway:Kode kesalahan untuk instance API Gateway tipe VPC

更新时间:Jun 28, 2025

Topik ini menjelaskan kode kesalahan yang mungkin ditemui saat menggunakan instance API Gateway tipe Virtual Private Cloud (VPC).

Kode kesalahan dalam bagian ini berlaku untuk instance tanpa server dan instance khusus dari tipe VPC.

  • Jika header X-Ca-Error-Code tidak kosong dalam respons yang diterima oleh klien, kode kesalahan tersebut dihasilkan oleh API Gateway. Kode kesalahan ini merupakan string enam karakter. Tabel berikut mencantumkan semua kemungkinan kode kesalahan yang dapat dihasilkan oleh API Gateway. Untuk pesan kesalahan terperinci, lihat header X-Ca-Error-Message.

  • Jika header X-Ca-Error-Code kosong, kode status HTTP dihasilkan oleh layanan backend. API Gateway meneruskan informasi kesalahan dari layanan backend.

Kode kesalahan

Kode kesalahan

Kode Status HTTP

Pesan

Deskripsi

I400HD

400

Header Tidak Valid `${HeaderName}` ${Reason}

Pesan kesalahan yang dikembalikan karena header permintaan HTTP tidak valid.

I400MH

400

Header `${HeaderName}` Diperlukan

Pesan kesalahan yang dikembalikan karena header permintaan HTTP tidak ada.

I400BD

400

Badan Permintaan Tidak Valid: ${Reason}

Pesan kesalahan yang dikembalikan karena badan permintaan HTTP tidak valid.

I400PA

400

Permintaan Path Tidak Valid `${Reason}`

Pesan kesalahan yang dikembalikan karena path permintaan HTTP tidak valid.

I405UM

405

Metode Tidak Didukung `${Reason}`

Pesan kesalahan yang dikembalikan karena metode permintaan HTTP tidak didukung.

I400RU

400

Permintaan Uri Tidak Valid `${Reason}`

Pesan kesalahan yang dikembalikan karena URL permintaan HTTP tidak valid.

I403PT

403

Protokol Tidak Valid ${Protocol} tidak didukung

Pesan kesalahan yang dikembalikan karena protokol tidak didukung berdasarkan konfigurasi API. Periksa konfigurasi API.

I413RL

413

Badan Permintaan Terlalu Besar

Pesan kesalahan yang dikembalikan karena badan permintaan terlalu besar. Untuk informasi lebih lanjut, lihat Batasan.

I413UL

413

URL Permintaan Terlalu Besar

Pesan kesalahan yang dikembalikan karena URL permintaan terlalu panjang. Untuk informasi lebih lanjut, lihat Batasan.

I400CT

400

Tipe Konten Tidak Valid: `${Reason}`

Pesan kesalahan yang dikembalikan karena nilai Content-Type tidak valid.

I404DO

404

Domain Tidak Valid `${DomainName}`

Pesan kesalahan yang dikembalikan karena nama domain yang tidak dikenal diminta. Gunakan nama domain terikat untuk pemanggilan.

I410GG

410

Instance grup tidak valid

Pesan kesalahan yang dikembalikan karena instance yang tidak valid diminta. Grup API mungkin tidak termasuk dalam instance saat ini.

I400SG

400

Tahap Tidak Valid

Pesan kesalahan yang dikembalikan karena lingkungan yang tidak dikenal diminta.

I404NF

404

API tidak ditemukan ${Reason}

Pesan kesalahan yang dikembalikan karena API tidak dapat ditemukan di lingkungan saat ini berdasarkan parameter path dan metode dalam permintaan. Untuk informasi lebih lanjut, lihat Apa yang harus saya lakukan jika kesalahan I404NF dilaporkan?

X400PM

400

Meta Plugin Tidak Valid ${PluginName} ${Reason}

Pesan kesalahan yang dikembalikan karena metadata plugin tidak valid.

X500ED

500

Definisi API kedaluwarsa

Pesan kesalahan yang dikembalikan karena metadata versi sebelumnya yang kedaluwarsa tidak lagi didukung oleh versi baru API Gateway. Untuk memodifikasi metadata versi sebelumnya, ajukan tiket.

X500AM

500

Meta API Tidak Valid, coba deploy ulang atau hubungi kami melalui tiket

Pesan kesalahan yang dikembalikan karena format metadata yang disimpan tidak valid. Untuk memperbaiki masalah ini, ajukan tiket.

X403DG

403

Domain atau Grup Buruk: ${Reason}

Pesan kesalahan yang dikembalikan karena data grup API tidak valid.

B451DO

451

Domain Tidak Tersedia karena Alasan Hukum

Pesan kesalahan yang dikembalikan karena nama domain tidak sesuai dengan persyaratan hukum atau peraturan yang relevan.

B451GO

451

Grup Tidak Tersedia karena Alasan Hukum

Pesan kesalahan yang dikembalikan karena grup API tidak sesuai dengan persyaratan hukum atau peraturan yang relevan.

B403OD

403

Akun Penyedia Terlambat Membayar

Pesan kesalahan yang dikembalikan karena penyedia API memiliki pembayaran yang terlambat. Jika API dibeli di Alibaba Cloud Marketplace, hubungi penyedia layanan.

A401AC

401

AppCode Tidak Valid ${Reason}

Pesan kesalahan yang dikembalikan karena AppCode digunakan tetapi AppCode tidak ditemukan. Periksa apakah aplikasi telah diotorisasi dan apakah AppCode benar.

A400IK

400

AppKey Tidak Valid

Pesan kesalahan yang dikembalikan karena AppKey tidak ditemukan saat Anda melakukan otorisasi menggunakan pasangan key-secret.

A403IS

403

Tanda tangan Tidak Valid, StringToSign Server:`${StringToSign}`

Pesan kesalahan ini muncul karena tanda tangan di sisi klien tidak sesuai dengan tanda tangan di sisi server. Untuk informasi lebih lanjut, lihat A403IS.

A403EP

403

Otorisasi Aplikasi Kedaluwarsa

Pesan kesalahan yang dikembalikan karena otorisasi telah kedaluwarsa. Berikan izin kembali.

A403PR

403

Otorisasi Plugin Diperlukan

Pesan kesalahan yang dikembalikan karena otorisasi plugin diperlukan.

A400MA

400

Diperlukan otorisasi, `X-Ca-Key` atau `Authorization: APPCODE ...` diperlukan

Pesan kesalahan yang dikembalikan karena otorisasi dalam mode AppCode atau menggunakan pasangan key-secret diperlukan.

I400I5

400

Content-MD5 Tidak Valid ${Reason}

Pesan kesalahan yang dikembalikan karena nilai Content-MD5 tidak valid.

I400NC

400

X-Ca-Nonce diperlukan

Pesan kesalahan yang dikembalikan karena header X-Ca-Nonce tidak disediakan setelah Anda memilih Force Nonce Check (Anti Replay by X-Ca-Nonce).

S403NU

403

Nonce Digunakan

Pesan kesalahan yang dikembalikan karena serangan replay terdeteksi. Header X-Ca-Nonce dalam permintaan telah digunakan.

S403TE

403

X-Ca-Timestamp telah kedaluwarsa

Pesan kesalahan yang dikembalikan karena timestamp yang diberikan dalam header X-Ca-Timestamp telah kedaluwarsa. Timestamp berlaku selama 15 menit.

I400MP

400

Parameter `${ParameterName}` diperlukan

Pesan kesalahan yang dikembalikan karena satu atau lebih parameter yang diperlukan dalam konfigurasi API dibiarkan kosong.

I400IP

400

Parameter tidak valid `${ParameterName}` ${Reason}

Pesan kesalahan yang dikembalikan karena nilai parameter dalam konfigurasi API tidak valid.

I400JR

400

JWT diperlukan

Pesan kesalahan yang dikembalikan karena parameter terkait JSON Web Token (JWT) tidak ditemukan.

S403JI

403

Klaim `jti` diperlukan ketika `preventJtiReplay:true`

Pesan kesalahan yang dikembalikan karena tidak ada klaim jti yang valid termasuk dalam permintaan ketika parameter preventJtiReplay diatur ke true dalam plugin otentikasi JWT.

A403SV

403

Klaim `jti` dalam JWT telah digunakan

Pesan kesalahan yang dikembalikan karena klaim jti yang termasuk dalam permintaan telah digunakan ketika parameter preventJtiReplay diatur ke true dalam plugin otentikasi JWT.

I400JD

400

JWT Deserialize Gagal: `${Token}`

Pesan kesalahan yang dikembalikan karena JWT dalam permintaan tidak dapat diselesaikan.

A403JT

403

JWT Tidak Valid: ${Reason}

Pesan kesalahan yang dikembalikan karena JWT dalam permintaan tidak valid.

A403JK

403

Tidak ada JWK yang cocok, `${kid}` tidak ditemukan

Pesan kesalahan yang dikembalikan karena tidak ada JWK yang cocok dengan kid yang dikonfigurasikan dalam JWT dalam permintaan.

A403JE

403

JWT kedaluwarsa pada `${Date}`

Pesan kesalahan yang dikembalikan karena JWT dalam permintaan telah kedaluwarsa.

I400JP

400

Konfigurasi Plugin JWT Tidak Valid: ${JWT}

Pesan kesalahan yang dikembalikan karena plugin otentikasi JWT salah dikonfigurasikan.

A403OL

403

Login OAuth2 gagal: ${Reason}

A403OU

403

Mendapatkan Informasi Pengguna OAuth2 gagal: ${Reason}

A401OT

401

OAuth2 Access Token Tidak Valid

A401OM

401

OAuth2 Access Token diperlukan

T429ID

429

Dibatasi oleh Kontrol Aliran DOMAIN INTERNAL, ${Domain} adalah domain uji, hanya 1.000 permintaan per hari

Pesan kesalahan yang dikembalikan karena batas panggilan API terlampaui. Jika Anda menggunakan nama domain tingkat kedua default, batasnya adalah 1.000 panggilan per hari untuk wilayah di Tiongkok Daratan dan 100 panggilan per hari untuk wilayah di luar Tiongkok Daratan.

T429IN

429

Dibatasi oleh Kontrol Aliran INSTANCE

Pesan kesalahan yang dikembalikan karena pembatasan dilakukan untuk instance saat ini. Tingkatkan spesifikasi instance.

T429GR

429

Dibatasi oleh Kontrol Aliran GROUP

Pesan kesalahan yang dikembalikan karena pembatasan dilakukan untuk grup API saat ini. Tingkatkan spesifikasi instance.

T429PA

429

Dibatasi oleh Kontrol Aliran API

Pesan kesalahan yang dikembalikan karena kebijakan pembatasan default tingkat API yang didefinisikan dalam plugin pembatasan dipicu.

T429PR

429

Dibatasi oleh Kontrol Aliran PLUGIN

Pesan kesalahan yang dikembalikan karena kebijakan pembatasan khusus yang didefinisikan dalam plugin pembatasan dipicu.

T429SR

429

Dibatasi oleh Kontrol Aliran SERVER

T429MR

429

Terlalu Banyak Permintaan, dibatasi oleh `${Description}`

A403IP

403

Akses ditolak oleh Kebijakan Kontrol IP

Pesan kesalahan yang dikembalikan karena akses ditolak oleh plugin kontrol akses berbasis alamat IP.

A403IN

403

Akses dari internet dinonaktifkan ${Reason}

API dan grup API tidak dapat dipanggil melalui Internet. Anda dapat memanggilnya melalui jaringan pribadi. Untuk informasi lebih lanjut, lihat Pemanggilan API Berbasis VPC.

A403VN

403

Akses dari VPC tidak valid dinonaktifkan

Pesan kesalahan yang dikembalikan karena akses melalui VPC tertentu ditolak.

A403AC

403

Akses Kontrol Dilarang oleh ${RuleName}

Pesan kesalahan yang dikembalikan karena akses ditolak oleh plugin kontrol akses.

A403CO

403

Sumber daya lintas asal dilarang ${Domain}

Pesan kesalahan yang dikembalikan karena akses ditolak oleh plugin Berbagi Sumber Daya Lintas Asal (CORS).

I404CO

404

Sumber daya lintas asal tidak ditemukan ${Method} - ${Path}

Pesan kesalahan yang dikembalikan karena definisi API tidak ditemukan berdasarkan path permintaan dan metode permintaan yang telah diperiksa sebelumnya oleh plugin CORS.

I404CH

404

Konten tidak di-cache, dengan `Cache-Control:only-if-cached`

I404NR

404

${Resource} tidak ditemukan

I404SR

404

Rute tahap hilang: ${Reason}

B403MO

403

Langganan Pasar API terlambat membayar

Pesan kesalahan yang dikembalikan karena penyedia API memiliki pembayaran yang terlambat. Hubungi penyedia layanan.

B403MQ

403

Kuota Langganan Pasar API habis

Pesan kesalahan yang dikembalikan karena kuota API yang dibeli di Alibaba Cloud Marketplace telah habis. Perbarui kuota.

B403ME

403

Langganan Pasar API kedaluwarsa

Pesan kesalahan yang dikembalikan karena langganan API telah kedaluwarsa. Buat langganan lain.

B403MI

403

Langganan Pasar API tidak valid

Pesan kesalahan yang dikembalikan karena layanan API yang dilanggan tidak valid.

D504RE

504

Resolusi domain backend `${Domain}` gagal

Pesan kesalahan yang dikembalikan karena nama domain backend gagal diselesaikan. Verifikasi nama domain backend.

D504IL

504

Resolusi domain backend `${Domain}` menghasilkan alamat ilegal `${Address}`

Pesan kesalahan yang dikembalikan karena hasil resolusi untuk nama domain layanan backend tidak valid.

D504CO

504

Koneksi layanan backend gagal `${Reason}`

Pesan kesalahan yang dikembalikan karena API Gateway gagal mengakses layanan backend. Dalam hal ini, Anda harus memeriksa pengaturan grup keamanan dan firewall atau status server backend. Untuk informasi lebih lanjut, lihat Memperbaiki Kesalahan D504CO.

504

Koneksi layanan backend gagal `Connection lease request time out`

Pesan kesalahan yang dikembalikan karena layanan backend gagal terhubung karena pool koneksi kosong. Tingkatkan spesifikasi instance.

D504CS

504

Koneksi ssl http backend gagal `${Reason}`

Pesan kesalahan yang dikembalikan karena layanan backend gagal terhubung melalui HTTPS. Periksa apakah protokol yang dikonfigurasikan untuk layanan backend sesuai dengan port.

D504TO

504

Permintaan layanan backend timeout

Pesan kesalahan yang dikembalikan karena permintaan ke layanan backend timeout. Tingkatkan periode timeout backend atau tingkatkan kemampuan penanganan layanan backend.

X504VE

504

Pemetaan VPC layanan backend gagal

Pesan kesalahan yang dikembalikan karena pemetaan VPC layanan backend gagal.

D503BB

503

Pemutus sirkuit backend sibuk

Pesan kesalahan yang dikembalikan karena API dilindungi oleh pemutus sirkuitnya.

D503CB

503

Pemutus sirkuit backend terbuka, ${Reason}

Pesan kesalahan yang dikembalikan karena pemutus sirkuit terbuka untuk API. Periksa performa layanan backend.

I508LD

508

Loop Terdeteksi

Pesan kesalahan yang dikembalikan karena panggilan loopback terdeteksi.

I404DD

404

ID Perangkat ${DeviceId} tidak ditemukan

Pesan kesalahan yang dikembalikan karena ID perangkat tidak ditemukan saat Anda memanggil API melalui WebSocket.

A403FC

403

Function Compute AssumeRole gagal ${RequestId}:${Reason}

Pesan kesalahan yang dikembalikan karena terjadi kesalahan otorisasi saat Function Compute digunakan sebagai layanan backend.

D502FC

502

Respons Function Compute tidak valid: ${Reason}

Pesan kesalahan yang dikembalikan karena respons dari layanan backend tidak valid saat Function Compute digunakan sebagai layanan backend.

N502RE

502

Mengirim Respons IO Exception: ${Reason}

Pesan kesalahan yang dikembalikan karena terjadi pengecualian saat server mengirim respons ke klien. Periksa apakah klien menutup koneksi terlebih dahulu atau terjadi kesalahan jaringan.

X500ER

500

Kesalahan Internal Layanan

Pesan kesalahan yang dikembalikan karena terjadi kesalahan pada server internal. Untuk memperbaiki masalah ini, ajukan tiket untuk menghubungi dukungan teknis API Gateway.

X503BZ

503

Layanan Sibuk

Pesan kesalahan yang dikembalikan karena layanan API Gateway sedang sibuk. Coba lagi nanti.

X504TO

504

Timeout Layanan

Pesan kesalahan yang dikembalikan karena terjadi kesalahan timeout di API Gateway. Untuk menghubungi dukungan teknis, ajukan tiket.

Kode kesalahan tertentu dapat berubah saat layanan diperbarui atau fitur baru ditambahkan.