Jika terjadi kesalahan saat mengakses Simple Message Queue (SMQ, sebelumnya MNS), SMQ akan mengembalikan kode status HTTP seperti 3xx, 4xx, atau 5xx, serta badan pesan dalam format TEXT atau XML. Topik ini menjelaskan badan pesan dan kode kesalahan dari SMQ.
Kode Kesalahan
Berikut adalah contoh badan pesan dari respons kesalahan:
<?xml version="1.0" encoding="UTF-8"?>
<Error xmlns="http://mns.aliyuncs.com/doc/v1/">
<Code>InvalidArgument</Code>
<Message>Authorization header is invalid or missing.</Message>
<RequestId>04bb60e3-28aa-4706-99b0-9345d834****</RequestId>
<HostId>mns.cn-hangzhou.aliyuncs.com</HostId>
</Error> Badan pesan dari respons kesalahan mencakup parameter berikut:
Code: Kode kesalahan.
Message: Pesan kesalahan.
RequestId: ID unik untuk mengidentifikasi permintaan.
Jika Anda tidak dapat menyelesaikan masalah, Anda dapat memberikan ID permintaan untuk meminta bantuan dari dukungan teknis.
HostId: Titik akhir yang digunakan untuk mengakses instance SMQ.
Untuk informasi lebih lanjut tentang kesalahan spesifik operasi, lihat Operasi API yang sesuai.
Kode Kesalahan
Tabel berikut menjelaskan kode kesalahan dan pesan kesalahan dalam respons kesalahan serta menyediakan solusi yang direkomendasikan.
Kode Status HTTP | Kode Kesalahan | Pesan Kesalahan | Solusi yang Direkomendasikan |
400 | InvalidAuthorizationHeader | Format header Authorization tidak valid. | Pesan kesalahan dikembalikan karena ID AccessKey dan Rahasia AccessKey tidak valid. Periksa ID AccessKey dan Rahasia AccessKey. |
InvalidDateHeader | Format header Date tidak valid. | Pesan kesalahan dikembalikan karena format header Date tidak valid. Untuk informasi lebih lanjut, lihat Parameter Umum. | |
InvalidDegist | Content-MD5 yang Anda tentukan tidak valid. | Pesan kesalahan dikembalikan karena nilai header Content-MD5 tidak valid. | |
InvalidRequestURL | Format URL permintaan HTTP tidak valid. | Pesan kesalahan dikembalikan karena format URL yang diminta tidak valid. Untuk informasi lebih lanjut, lihat Referensi API. | |
InvalidQueryString | URL permintaan HTTP berisi item querystring yang tidak valid “Element⑤”. | Pesan kesalahan dikembalikan karena format URL yang diminta tidak valid. Untuk informasi lebih lanjut, lihat Referensi API. | |
MalformedXML | XML yang Anda sediakan tidak diformat dengan benar. | Pesan kesalahan dikembalikan karena format XML yang ditentukan tidak valid. Untuk informasi lebih lanjut, lihat Referensi API. | |
MissingAuthorizationHeader | Header Authorization diperlukan. | Pesan kesalahan dikembalikan karena satu atau lebih bidang tidak ditentukan dalam header permintaan. Untuk informasi lebih lanjut, lihat Parameter Umum. | |
MissingDateHeader | Header Date diperlukan. | Pesan kesalahan dikembalikan karena satu atau lebih bidang tidak ditentukan dalam header permintaan. Untuk informasi lebih lanjut, lihat Parameter Umum. | |
MissingReceiptHandle | ReceiptHandle diperlukan. | Pesan kesalahan dikembalikan karena satu atau lebih parameter permintaan tidak ditentukan. Untuk informasi lebih lanjut, lihat Referensi API. | |
MissingVisibilityTimeout | VisibilityTimeout diperlukan. | Pesan kesalahan dikembalikan karena satu atau lebih parameter permintaan tidak ditentukan. Untuk informasi lebih lanjut, lihat Referensi API. | |
InvalidQueueName | Nama antrian yang Anda sediakan tidak valid. QueueName harus dimulai dengan huruf alfabet dan hanya boleh berisi huruf alfabet, digit, atau -. | Pesan kesalahan dikembalikan karena nama antrian yang ditentukan tidak valid. Untuk informasi lebih lanjut, lihat Referensi API. | |
QueueNameLengthError | Panjang nama antrian harus antara 1 dan 255. | Pesan kesalahan dikembalikan karena nama antrian yang ditentukan tidak valid. Untuk informasi lebih lanjut, lihat Referensi API. | |
ReceiptHandleError | Receipt handle yang Anda sediakan tidak valid. | Pesan kesalahan dikembalikan karena satu atau lebih parameter permintaan tidak valid. Untuk informasi lebih lanjut, lihat Referensi API. | |
QpsLimitExceeded | Batas QPS antrian dilampaui. | Pesan kesalahan dikembalikan karena jumlah permintaan per detik melebihi batas QPS. Untuk meningkatkan batas QPS, hubungi dukungan teknis SMQ. | |
TopicNameInvalid | Nama topik yang Anda sediakan tidak valid. TopicName harus dimulai dengan huruf alfabet atau digit dan hanya boleh berisi huruf alfabet, digit, atau -. | Pesan kesalahan dikembalikan karena nama topik yang ditentukan tidak valid. Untuk informasi lebih lanjut, lihat Referensi API. | |
TopicNameLengthError | Panjang nama topik di luar rentang, harus antara 1 dan 255. | Pesan kesalahan dikembalikan karena nama topik yang ditentukan tidak valid. Untuk informasi lebih lanjut, lihat Referensi API. | |
SubscriptionNameInvalid | Nama langganan yang Anda sediakan tidak valid. SubscriptionName harus dimulai dengan huruf alfabet atau digit dan hanya boleh berisi huruf alfabet, digit, atau -. | Pesan kesalahan dikembalikan karena nama langganan yang ditentukan tidak valid. Untuk informasi lebih lanjut, lihat Referensi API. | |
SubscriptionNameLengthError | Panjang nama langganan di luar rentang, harus antara 1 dan 255. | Pesan kesalahan dikembalikan karena nama langganan yang ditentukan tidak valid. Untuk informasi lebih lanjut, lihat Referensi API. | |
EndpointInvalid | Format endpoint yang Anda sediakan tidak valid. | Pesan kesalahan dikembalikan karena endpoint yang ditentukan tidak valid. Untuk informasi lebih lanjut, lihat Endpoint. | |
InvalidArgument | Panjang pesan tidak boleh lebih besar dari MaximumMessageSize. | Pesan kesalahan dikembalikan karena badan pesan terlalu besar. Untuk informasi lebih lanjut, lihat Referensi API. | |
MaximumMessageSize dari langganan harus lebih besar dari MaximumMessageSize topik! | Pesan kesalahan dikembalikan karena badan pesan dalam antrian terlalu besar. Anda harus memodifikasi ukuran pesan antrian. Ukurannya harus lebih besar atau sama dengan ukuran pesan topik. | ||
XML yang Anda sediakan tidak divalidasi terhadap skema yang kami publikasikan, disebabkan oleh Element①. | Pesan kesalahan dikembalikan karena format XML yang ditentukan tidak valid. Untuk informasi lebih lanjut, lihat Referensi API. | ||
Nilai dari Element② harus antara Low③ dan High④ detik/byte. | Pesan kesalahan dikembalikan karena satu atau lebih parameter ditentukan dengan nilai yang tidak valid. Anda harus menentukan nilai yang valid sesuai petunjuk. | ||
403 | AccessDenied | OwnerId yang terkait dengan Access Key Id Anda dilarang untuk operasi ini. | Pesan kesalahan dikembalikan karena ID AccessKey dan Rahasia AccessKey tidak valid. Periksa ID AccessKey dan Rahasia AccessKey. |
InvalidAccessKeyId | ID AccessKey yang Anda sediakan tidak ada. | Pesan kesalahan dikembalikan karena ID AccessKey tidak valid. Periksa ID AccessKey. | |
SignatureDoesNotMatch | Tanda tangan permintaan yang kami hitung tidak cocok dengan tanda tangan yang Anda sediakan. Periksa kunci dan metode penandatanganan Anda. | Pesan kesalahan dikembalikan karena tanda tangan permintaan tidak valid. Untuk informasi lebih lanjut, lihat Tandatangani Permintaan. | |
404 | MessageNotExist | Pesan tidak ada. | Pesan kesalahan dikembalikan karena tidak ada pesan yang terlihat di dalam antrian. |
Receipt handle yang Anda sediakan telah kedaluwarsa. | Pesan kesalahan dikembalikan karena Anda belum mengonsumsi pesan dalam periode ketidakterlihatan dan receipt handle pesan tersebut telah kedaluwarsa. Konsumsi pesan dalam periode ketidakterlihatan atau tentukan periode ketidakterlihatan yang lebih lama. | ||
TopicNotExist | Topik yang Anda sediakan tidak ada. | Pesan kesalahan dikembalikan karena topik tidak ada. Anda harus membuat topik. | |
SubscriptionNotExist | Langganan yang Anda sediakan tidak ada. | Pesan kesalahan dikembalikan karena langganan yang ditentukan tidak ada. Anda harus membuat langganan. | |
QueueNotExist | Nama antrian yang Anda sediakan tidak ada. | Pesan kesalahan dikembalikan karena antrian yang ditentukan tidak ada. Anda harus membuat antrian. | |
408 | TimeExpired | Permintaan HTTP yang Anda kirim telah kedaluwarsa. | Pesan kesalahandikembalikan karena interval antara waktu permintaan dikirim dan waktu server SMQ menerima permintaan melebihi 15 menit. Periksa waktu sistem lokal. |
409 | SubscriptionAlreadyExist | Langganan yang ingin Anda buat sudah ada. | Pesan kesalahan dikembalikan karena langganan yang ditentukan memiliki nama yang sama dengan langganan yang ada, tetapi memiliki parameter yang berbeda dari langganan yang ada. |
TopicAlreadyExist | Topik yang ingin Anda buat sudah ada. | Pesan kesalahan dikembalikan karena topik yang ditentukan memiliki nama yang sama dengan topik yang ada, tetapi memiliki parameter yang berbeda dari topik yang ada. | |
QueueAlreadyExist | Antrian yang ingin Anda buat sudah ada. | Pesan kesalahan dikembalikan karena antrian yang ditentukan memiliki nama yang sama dengan antrian yang ada, tetapi memiliki parameter yang berbeda dari antrian yang ada. | |
429 | TooManyRequests | Permintaan ditolak oleh pembatas aliran kluster karena terlalu banyak permintaan. | Jika jumlah permintaan melebihi ambang batas throttling, aturan throttling dipicu. Untuk informasi lebih lanjut, lihat Kebijakan Throttling. |
500 | InternalError | Kesalahan internal. | Pesan kesalahan dikembalikan karena terjadi kesalahan sistem. Hubungi dukungan teknis SMQ. |
InternalServerError | Kesalahan internal. | Pesan kesalahan dikembalikan karena terjadi kesalahan sistem. Hubungi dukungan teknis SMQ. |
①②: Parameter dalam badan permintaan. Isi badan permintaan dalam format XML.
③: Nilai minimum dari parameter dalam SMQ.
④: Nilai maksimum dari parameter dalam SMQ.
⑤: Parameter QueryString dalam URL yang diminta.