Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
APIGateway mengekspos tanggapan gateway berikut untuk penyesuaian oleh API pengembang.
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 API konfigurasi 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 API kunci tidak valid yang dikirimkan untuk metode yang API membutuhkan kunci. 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 untuk memanggil API metode atau sumber daya 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 API permintaan melewati otentikasi dan otorisasi, kecuali untuk otentikasi API kunci dan otorisasi. Jika tipe respons tidak ditentukan, respons ini default ke tipe. |
THROTTLED |
429 |
Respons gateway saat batas pelambatan 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 saat 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. |