Jenis respons gateway - Amazon API Gateway

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. DEFAULT_4XX

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. DEFAULT_5XX

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. DEFAULT_5XX

AUTHORIZER_FAILURE 500

Respons gateway saat otorisasi khusus atau Amazon Cognito gagal mengautentikasi pemanggil. Jika tipe respons tidak ditentukan, respons ini default ke tipe. DEFAULT_5XX

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. DEFAULT_4XX

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

DEFAULT_4XX Null

Respons gateway default untuk jenis respons yang tidak ditentukan dengan kode status. 4XX Mengubah kode status respons gateway fallback ini mengubah kode status semua 4XX respons lain ke nilai baru. Menyetel ulang kode status ini ke null mengembalikan kode status semua 4XX respons lain ke nilai aslinya.

catatan

AWS WAF tanggapan khusus lebih diutamakan daripada respons gateway khusus.

DEFAULT_5XX Null

Respons gateway default untuk jenis respons yang tidak ditentukan dengan kode status. 5XX Mengubah kode status respons gateway fallback ini mengubah kode status semua 5XX respons lain ke nilai baru. Menyetel ulang kode status ini ke null mengembalikan kode status semua 5XX respons lain ke nilai aslinya.

EXPIRED_TOKEN 403

Respons gateway untuk kesalahan kedaluwarsa token AWS otentikasi. Jika tipe respons tidak ditentukan, respons ini default ke tipe. DEFAULT_4XX

INTEGRATION_FAILURE 504

Respons gateway untuk kesalahan integrasi gagal. Jika tipe respons tidak ditentukan, respons ini default ke tipe. DEFAULT_5XX

INTEGRATION_TIMEOUT 504

Respons gateway untuk kesalahan waktu integrasi habis. Jika tipe respons tidak ditentukan, respons ini default ke tipe. DEFAULT_5XX

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. DEFAULT_4XX

INVALID_SIGNATURE 403

Respons gateway untuk kesalahan AWS tanda tangan yang tidak valid. Jika tipe respons tidak ditentukan, respons ini default ke tipe. DEFAULT_4XX

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. DEFAULT_4XX

QUOTA_EXCEEDED 429

Respons gateway untuk kuota paket penggunaan melebihi kesalahan. Jika tipe respons tidak ditentukan, respons ini default ke tipe. DEFAULT_4XX

REQUEST_TOO_LARGE 413

Respons gateway untuk permintaan kesalahan terlalu besar. Jika jenis respons tidak ditentukan, respons ini default ke:. HTTP content length exceeded 10485760 bytes

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. DEFAULT_4XX

THROTTLED 429

Respons gateway saat batas pembatasan tingkat rencana, metode, tahap, atau akun terlampaui. Jika tipe respons tidak ditentukan, respons ini default ke tipe. DEFAULT_4XX

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. DEFAULT_4XX

WAF_FILTERED 403

Respons gateway saat permintaan diblokir oleh AWS WAF. Jika tipe respons tidak ditentukan, respons ini default ke tipe. DEFAULT_4XX

catatan

AWS WAF tanggapan khusus lebih diutamakan daripada respons gateway khusus.