當您訪問輕量訊息佇列(原 MNS)出錯時,輕量訊息佇列(原 MNS)會返回一個合適的3xx、4xx或5xx的HTTP狀態代碼,以及一個text或xml格式的訊息體。本文介紹輕量訊息佇列(原 MNS)錯誤碼訊息體說明及列表。
錯誤碼說明
錯誤響應的訊息體樣本:
<?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>
所有錯誤的訊息體中都包括以下元素:
Code:錯誤碼。
Message:詳細錯誤資訊。
RequestId:唯一標識該次請求的編號。
當您無法解決問題時,可以提供RequestId尋求支援人員工程師的協助。
HostId:標識請求訪問的地區。
其他特殊的錯誤資訊元素請參見每個請求的具體介紹。
錯誤碼列表
錯誤響應中錯誤碼的錯誤描述和建議處理方式,請參見下表。
HTTP狀態代碼 | 錯誤碼 | 錯誤描述 | 建議處理方式 |
400 | InvalidAuthorizationHeader | The Authorization header format is invalid. | 簽名格式不正確。具體資訊,請參見請求籤名機制。 |
InvalidDateHeader | The Date header format is invalid. | Date欄位不合法。具體資訊,請參見公用參數。 | |
InvalidDegist | The Content-MD5 you specified is invalid. | 請求Header中Content-MD5不正確。 | |
InvalidRequestURL | Http request URL format invalid. | 請求的URL不正確。具體資訊,請參見對應API文檔。 | |
InvalidQueryString | Http request URL contains invalid querystring item “Element⑤”. | 請求的URL不正確。具體資訊,請參見對應API文檔。 | |
MalformedXML | The XML you provided was not well-formed. | XML結構異常。具體資訊,請參見對應API文檔。 | |
MissingAuthorizationHeader | Authorization header is required. | 請求Header缺少欄位。具體資訊,請參見公用參數。 | |
MissingDateHeader | Date header is required. | 請求Header缺少欄位。具體資訊,請參見公用參數。 | |
MissingReceiptHandle | ReceiptHandle is required. | 請求缺少參數。具體資訊,請參見對應API文檔。 | |
MissingVisibilityTimeout | VisibilityTimeout is required. | 請求缺少參數。具體資訊,請參見對應API文檔。 | |
InvalidQueueName | The queue name you provided is invalid. QueueName should start with alpha and contain only alpha, digit or - . | 隊列名稱不合法。具體資訊,請參見對應API文檔。 | |
QueueNameLengthError | Queue name length should between 1 and 255. | 隊列名稱不合法。具體資訊,請參見對應API文檔。 | |
ReceiptHandleError | The receipt handle you provide is not valid. | 請求參數不合法。具體資訊,請參見對應API文檔。 | |
QpsLimitExceeded | The qps limit of the queue is exceeded. | 隊列每秒的請求次數超過QPS限制,如果需要提高QPS限制,請聯絡輕量訊息佇列(原 MNS)支援人員。 | |
TopicNameInvalid | The topic name you provided is invalid. TopicName should start with alpha or digit and contain only alpha, digit or -. | 主題名稱不合法。具體資訊,請參見對應API文檔。 | |
TopicNameLengthError | Topic name length is out of range, should be between 1 and 255. | 主題名稱不合法。具體資訊,請參見對應API文檔。 | |
SubscriptionNameInvalid | The subscription name you provided is invalid. SubscriptionName should start with alpha or digit and contain only alpha, digit or -. | 訂閱名稱不合法。具體資訊,請參見對應API文檔。 | |
SubscriptionNameLengthError | Subscription name length is out of range, should be between 1 and 255. | 訂閱名稱不合法。具體資訊,請參見對應API文檔。 | |
EndpointInvalid | The format of endpoint you provided is invalid. | Endpoint參數不合法。具體資訊,請參見Endpoint。 | |
InvalidArgument | The length of message should not be larger than MaximumMessageSize. | 訊息體過長。具體資訊,請參見對應API文檔。 | |
A subscription's MaximumMessageSize should be greater than the topic's MaximumMessageSize! | 修改隊列的訊息大小,使其大於或等於主題的訊息大小。 | ||
The XML you provided did not validate against our published schema, cause by Element①. | XML結構不正確。具體資訊,請參見對應API文檔。 | ||
The value of Element②should between Low③ and High④ seconds/bytes. | 參數值非法,請根據提示調整。 | ||
403 | AccessDenied | The OwnerId that your Access Key Id associated to is forbidden for this operation. | 檢查AccessKey ID和AccessKey Secret等配置是否正確。 |
InvalidAccessKeyId | The AccessKey Id you provided is not exist. | 檢查AccessKey ID是否正確。 | |
SignatureDoesNotMatch | The request signature we calculated does not match the signature you provided. Check your key and signing method. | 請求籤名異常。具體資訊,請參見請求籤名機制。 | |
404 | MessageNotExist | Message not exist. | 隊列中沒有可見訊息。 |
The receipt handle you provided has expired. | 消費訊息過慢導致訊息重新回到隊列產生新的ReceiptHandle,之前的ReceiptHandle失效。加快消費速度或者增加隊列的不可見時間。 | ||
TopicNotExist | The Topic you provided does not exist. | 主題不存在,請先建立主題。 | |
SubscriptionNotExist | The subscription you provided does not exist. | 訂閱不存在,請先建立訂閱。 | |
QueueNotExist | The queue name you provided is not exist. | 隊列不存在,請先建立隊列。 | |
408 | TimeExpired | The http request you sent is expired. | 請求時間與輕量訊息佇列(原 MNS)伺服器時間相差超過15分鐘,建議檢查本地時間。 |
409 | SubscriptionAlreadyExist | The subscription you want to create already exists. | 同名訂閱已經存在,且請求屬性與原有訂閱屬性不同。 |
TopicAlreadyExist | The topic you want to create already exists. | 同名主題已存在,並且請求屬性與原有主題屬性不同。 | |
QueueAlreadyExist | The queue you want to create is already exist. | 同名隊列已存在,且請求屬性與原有隊列屬性不同。 | |
429 | TooManyRequests | The request is denied by cluster flow limiter for too many requests. | 請求量超過設定的限流閾值,觸發限流策略。更多資訊,請參見限流策略。 |
500 | InternalError | Interal error. | 系統錯誤,請聯絡輕量訊息佇列(原 MNS)支援人員。 |
InternalServerError | Interal error. | 系統錯誤,請聯絡輕量訊息佇列(原 MNS)支援人員。 |
①②:在請求內容的XML元素名稱。
③:在輕量訊息佇列(原 MNS)中某個參數的下限值。
④:在輕量訊息佇列(原 MNS)中某個參數的上限值。
⑤:在URL請求中QueryString的元素。