Jika panggilan API gagal, server akan mengembalikan pesan kesalahan. Topik ini menjelaskan kode kesalahan dan solusinya.
Ikhtisar
Jika permintaan API gagal, server akan mengembalikan pesan kesalahan yang mencakup kode status HTTP dan badan respons berisi detail kesalahan spesifik. Format detail kesalahan dalam badan respons adalah sebagai berikut:
{
"errorCode" : <ErrorCode>,
"errorMessage" : <ErrorMessage>
}Topik ini memberikan panduan tentang cara menangani kesalahan. Anda juga dapat menemukan detail kode kesalahan di Pusat Kesalahan API. Untuk informasi selengkapnya, lihat Simple Log Service API Error Center.
Kode kesalahan spesifik operasi
Kode kesalahan spesifik operasi bersifat unik untuk setiap operasi API. Untuk kode kesalahan ini, lihat dokumentasi operasi API yang bersangkutan.
Kode kesalahan umum
Kode kesalahan umum berlaku untuk sebagian besar operasi API. Tabel berikut menjelaskan kode kesalahan umum yang mungkin dikembalikan dalam respons kesalahan API.
Simple Log Service menyediakan kesalahan umum untuk kueri dan analisis log guna membantu Anda memecahkan masalah. Untuk informasi selengkapnya, lihat Kesalahan umum untuk kueri dan analisis log.
Kode status HTTP | Kode kesalahan | Pesan kesalahan | Deskripsi | Tindakan yang disarankan |
400 | RequestTimeExpired | Waktu permintaan requestTime telah kedaluwarsa sedangkan waktu server adalah server time. | Selisih waktu antara permintaan dan server melebihi 15 menit. | Periksa waktu pada klien dan coba lagi permintaan tersebut nanti. |
400 | InvalidRequestTime | Waktu permintaan requestTime tidak mengikuti spesifikasi RFC822. | Nilai header Date dalam permintaan tidak sesuai dengan standar RFC 822. | Periksa header permintaan dan pastikan nilai header Date sesuai dengan standar RFC 822. |
400 | InvalidHost | Header Host Host tidak valid. | Header Host dalam permintaan tidak valid. | Periksa header permintaan dan pastikan format header Host benar. |
400 | ProjectAlreadyExist | Proyek ProjectName sudah ada. | Nama proyek sudah ada. | Nama proyek harus unik secara global dalam satu wilayah Alibaba Cloud. Ubah nama proyek dan coba lagi permintaan tersebut. |
400 | PostBodyInvalid | Badan permintaan bukan objek JSON yang valid. | Badan permintaan tidak dalam format JSON. | Sesuaikan badan permintaan dan kirim ulang permintaan tersebut. |
400 | InvalidContentType | Content-Type type tidak didukung. | Content-Type tidak didukung. | Pastikan Content-Type didefinisikan dengan benar. |
400 | ParameterInvalid | Pasangan otorisasi Http extend: authorization tidak valid. | Header permintaan otorisasi tidak valid. | Pastikan header permintaan otorisasi didefinisikan dengan benar. |
Pasangan x-log-bodyrawsize Http extend: x-log-bodyrawsize tidak valid. | Header permintaan x-log-bodyrawsize tidak valid. | Pastikan header permintaan x-log-bodyrawsize didefinisikan dengan benar. | ||
Pasangan x-log-compresstype Http extend: x-log-compresstype tidak valid. | Header permintaan x-log-compresstype tidak valid. | Pastikan header permintaan x-log-compresstype didefinisikan dengan benar. | ||
x-log-signaturemethod: pasangan x-log-signaturemethod tidak valid. | x-log-signaturemethod tidak valid. | Pastikan header permintaan x-log-signaturemethod benar. | ||
400 | MissingParameter | Kunci kueri tidak ada: parameter. | Parameter permintaan wajib tidak ada. | Tambahkan parameter permintaan yang hilang dan coba lagi permintaan tersebut. Untuk informasi selengkapnya tentang struktur dan proses pembuatan signature permintaan, lihat Request signature. |
Kunci header http extend tidak ada: authorization. | Header permintaan otorisasi tidak ada. | Tambahkan header permintaan otorisasi dan coba lagi permintaan tersebut. Untuk informasi selengkapnya tentang struktur dan proses pembuatan signature permintaan, lihat Request signature. | ||
Kunci header http extend tidak ada: x-log-bodyrawsize. | Header permintaan x-log-bodyrawsize tidak ada. | Tambahkan header permintaan x-log-bodyrawsize dan coba lagi permintaan tersebut. Untuk informasi selengkapnya tentang struktur dan proses pembuatan signature permintaan, lihat Request signature. | ||
Kunci header http extend tidak ada: x-log-date. | Header permintaan x-log-date tidak ada. | Tambahkan header permintaan x-log-date dan coba lagi permintaan tersebut. Untuk informasi selengkapnya tentang struktur dan proses pembuatan signature permintaan, lihat Request signature. | ||
Kunci header http extend tidak ada: x-log-signaturemethod. | Header permintaan x-log-signaturemethod tidak ada. | Tambahkan header permintaan x-log-signaturemethod dan coba lagi permintaan tersebut. Untuk informasi selengkapnya tentang struktur dan proses pembuatan signature permintaan, lihat Request signature. | ||
401 | SignatureNotMatch | Signature signature tidak cocok. | Signature digital permintaan tidak cocok. | Coba lagi permintaan tersebut. Jika kesalahan tetap terjadi, ganti AccessKey dan coba lagi. Kemungkinan penyebabnya meliputi hal-hal berikut:
Untuk informasi selengkapnya tentang struktur dan proses pembuatan signature permintaan, lihat Request signature. |
401 | Unauthorized | ID AccessKeyId tidak memiliki otorisasi. | ID AccessKey yang diberikan tidak memiliki otorisasi. | Pastikan ID AccessKey Anda memiliki izin untuk mengakses Simple Log Service. Untuk memberikan izin kepada Pengguna Resource Access Management (RAM) agar dapat melakukan operasi pada Simple Log Service, lihat Buat Pengguna RAM dan berikan izin. |
Token keamanan yang Anda berikan tidak valid. | Token STS tidak valid. | Periksa permintaan API STS Anda dan pastikan token STS valid. | ||
Token keamanan yang Anda berikan telah kedaluwarsa. | Token STS telah kedaluwarsa. | Minta token STS baru dan kirim ulang permintaan tersebut. | ||
ID AccessKeyId tidak ditemukan: AccessKey ID | ID AccessKey tidak ada. | Periksa ID AccessKey Anda. Ambil ID AccessKey yang benar dan kirim ulang permintaan tersebut. | ||
AccessKeyId dinonaktifkan: AccessKey ID | ID AccessKey dinonaktifkan. | Periksa ID AccessKey Anda, pastikan sudah diaktifkan, lalu kirim ulang permintaan tersebut. | ||
Layanan SLS Anda telah diblokir. | Simple Log Service telah dinonaktifkan. | Periksa status Simple Log Service Anda. Misalnya, periksa apakah akun Anda memiliki pembayaran tertunda. | ||
Proyek tersebut bukan milik Anda. | Proyek tersebut bukan milik pengguna saat ini. |
| ||
401 | InvalidAccessKeyId | ID access key yang Anda berikan tidak valid: AccessKey ID. | ID AccessKey tidak valid. | Periksa ID AccessKey Anda dan pastikan valid. |
Layanan SLS Anda belum diaktifkan. | Simple Log Service belum diaktifkan. | Login ke Konsol Simple Log Service atau panggil operasi API untuk mengaktifkan Simple Log Service. Lalu, kirim ulang permintaan tersebut. Untuk informasi selengkapnya, lihat Apa itu Simple Log Service?. | ||
403 | WriteQuotaExceed | Kuota penulisan telah terlampaui. | Kuota penulisan log telah terlampaui. | Optimalkan permintaan penulisan log untuk mengurangi jumlah log yang ditulis. Untuk informasi selengkapnya, lihat Batasan. |
403 | ReadQuotaExceed | Kuota pembacaan telah terlampaui. | Kuota pembacaan log telah terlampaui. | Optimalkan permintaan pembacaan log untuk mengurangi jumlah log yang dibaca. Untuk informasi selengkapnya, lihat Batasan. |
403 | MetaOperationQpsLimitExceeded | Batas QPS untuk operasi meta telah terlampaui. | Ambang batas permintaan per detik (QPS) default telah terlampaui. | Optimalkan permintaan operasi resource untuk mengurangi jumlah operasi. Kami menyarankan Anda mencoba lagi permintaan tersebut setelah beberapa detik. Simple Log Service membatasi QPS untuk operasi API management berikut:
Untuk informasi selengkapnya, lihat Batasan. |
403 | ProjectForbidden | Proyek ProjectName telah diblokir. | Proyek telah dinonaktifkan. | Periksa status proyek. Proyek Anda mungkin ditangguhkan karena adanya pembayaran tertunda. |
404 | ProjectNotExist | Proyek tidak ada: name | Proyek tidak ada. | Periksa nama proyek dan pastikan proyek tersebut ada serta wilayahnya benar. |
405 | InvalidMethod | Metode permintaan tidak valid: request URI | Metode permintaan tidak didukung untuk resource yang diminta. | Periksa nilai method dan coba lagi. |
413 | PostBodyTooLarge | Ukuran badan bodysize harus kurang dari 10485760. | Badan permintaan tidak boleh melebihi 10 MB. | Sesuaikan ukuran badan permintaan dan coba lagi permintaan tersebut. |
500 | InternalServerError | Pesan kesalahan internal server. | Terjadi kesalahan internal server. | Coba lagi permintaan tersebut nanti. |
500 | RequestTimeout | Permintaan melebihi batas waktu. Silakan coba lagi nanti. | Permintaan melebihi batas waktu. | Coba lagi permintaan tersebut nanti. |
503 | ServerBusy | Server sedang sibuk, silakan coba lagi nanti. | Server sedang sibuk. | Coba lagi permintaan tersebut nanti. |
Teks miring dalam pesan kesalahan menunjukkan informasi spesifik tentang kesalahan tersebut. Sebagai contoh, dalam pesan kesalahan ProjectNotExist, name diganti dengan nama proyek yang sebenarnya.