Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
Jenis respons gateway
API Gateway memaparkan respons gateway berikut untuk penyesuaian oleh pengembang API.
Jenis respons gateway | Kode status default | Deskripsi |
---|---|---|
ACCESS_DENIED |
403 |
Respons gateway untuk kegagalan otorisasi—misalnya, saat akses ditolak oleh otorisasi khusus atau Amazon Cognito. Jika tipe respons tidak ditentukan, respons ini default ke tipe. |
API_CONFIGURATION_ERROR |
500 |
Respons gateway untuk konfigurasi API yang tidak valid—termasuk saat alamat titik akhir yang tidak valid dikirimkan, saat decoding base64 gagal pada data biner saat dukungan biner diberlakukan, atau saat pemetaan respons integrasi tidak dapat cocok dengan templat apa pun dan tidak ada templat default yang dikonfigurasi. Jika tipe respons tidak ditentukan, respons ini default ke tipe. |
AUTHORIZER_CONFIGURATION_ERROR |
500 |
Respons gateway karena gagal terhubung ke otorisasi khusus atau Amazon Cognito. Jika tipe respons tidak ditentukan, respons ini default ke tipe. |
AUTHORIZER_FAILURE |
500 |
Respons gateway saat otorisasi khusus atau Amazon Cognito gagal mengautentikasi pemanggil. Jika tipe respons tidak ditentukan, respons ini default ke tipe. |
BAD_REQUEST_PARAMETERS |
400 |
Respons gateway ketika parameter permintaan tidak dapat divalidasi sesuai dengan validator permintaan yang diaktifkan. Jika tipe respons tidak ditentukan, respons ini default ke tipe. |
BAD_REQUEST_BODY |
400 |
Respons gateway saat badan permintaan tidak dapat divalidasi sesuai dengan validator permintaan yang diaktifkan. Jika tipe respons tidak ditentukan, respons ini default ke tipe. |
DEFAULT_4XX |
Null | Respons gateway default untuk jenis respons yang tidak ditentukan dengan kode status. catatanAWS WAF tanggapan khusus lebih diutamakan daripada respons gateway khusus. |
DEFAULT_5XX |
Null | Respons gateway default untuk jenis respons yang tidak ditentukan dengan kode status. |
EXPIRED_TOKEN |
403 |
Respons gateway untuk kesalahan kedaluwarsa token AWS otentikasi. Jika tipe respons tidak ditentukan, respons ini default ke tipe. |
INTEGRATION_FAILURE |
504 |
Respons gateway untuk kesalahan integrasi gagal. Jika tipe respons tidak ditentukan, respons ini default ke tipe. |
INTEGRATION_TIMEOUT |
504 |
Respons gateway untuk kesalahan waktu integrasi habis. Jika tipe respons tidak ditentukan, respons ini default ke tipe. |
INVALID_API_KEY |
403 |
Respons gateway untuk kunci API tidak valid yang dikirimkan untuk metode yang memerlukan kunci API. Jika tipe respons tidak ditentukan, respons ini default ke tipe. |
INVALID_SIGNATURE |
403 |
Respons gateway untuk kesalahan AWS tanda tangan yang tidak valid. Jika tipe respons tidak ditentukan, respons ini default ke tipe. |
MISSING_AUTHENTICATION_TOKEN |
403 |
Respons gateway untuk kesalahan token otentikasi yang hilang, termasuk kasus ketika klien mencoba memanggil metode atau sumber daya API yang tidak didukung. Jika tipe respons tidak ditentukan, respons ini default ke tipe. |
QUOTA_EXCEEDED |
429 |
Respons gateway untuk kuota paket penggunaan melebihi kesalahan. Jika tipe respons tidak ditentukan, respons ini default ke tipe. |
REQUEST_TOO_LARGE |
413 |
Respons gateway untuk permintaan kesalahan terlalu besar. Jika jenis respons tidak ditentukan, respons ini default ke:. |
RESOURCE_NOT_FOUND |
404 |
Respons gateway ketika API Gateway tidak dapat menemukan sumber daya yang ditentukan setelah permintaan API melewati otentikasi dan otorisasi, kecuali untuk autentikasi dan otorisasi kunci API. Jika tipe respons tidak ditentukan, respons ini default ke tipe. |
THROTTLED |
429 |
Respons gateway saat batas pembatasan tingkat rencana, metode, tahap, atau akun terlampaui. Jika tipe respons tidak ditentukan, respons ini default ke tipe. |
UNAUTHORIZED |
401 |
Respons gateway saat otorisasi khusus atau Amazon Cognito gagal mengautentikasi pemanggil. |
UNSUPPORTED_MEDIA_TYPE |
415 |
Respons gateway ketika payload adalah tipe media yang tidak didukung, jika perilaku passthrough yang ketat diaktifkan. Jika tipe respons tidak ditentukan, respons ini default ke tipe. |
WAF_FILTERED |
403 |
Respons gateway saat permintaan diblokir oleh AWS WAF. Jika tipe respons tidak ditentukan, respons ini default ke tipe. catatanAWS WAF tanggapan khusus lebih diutamakan daripada respons gateway khusus. |