錯誤碼說明

當您訪問輕量訊息佇列（原 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狀態代碼	建議處理方式
AccessDenied	The OwnerId that your Access Key Id associated to is forbidden for this operation.	403	檢查AccessKey ID和AccessKey Secret等配置是否正確。
InvalidAccessKeyId	The AccessKey Id you provided is not exist.	403	檢查AccessKey ID是否正確。
InternalError	Interal error.	500	系統錯誤，請聯絡輕量訊息佇列（原 MNS）支援人員。
InternalServerError	Interal error.	500	系統錯誤，請聯絡輕量訊息佇列（原 MNS）支援人員。
InvalidAuthorizationHeader	The Authorization header format is invalid.	400	簽名格式不正確。具體資訊，請參見請求籤名機制。
InvalidDateHeader	The Date header format is invalid.	400	Date欄位不合法。具體資訊，請參見公用參數。
InvalidArgument	The XML you provided did not validate against our published schema, cause by Element①.	400	XML結構不正確。具體資訊，請參見對應API文檔。
InvalidArgument	The value of Element②should between Low③ and High④ seconds/bytes.	400	參數值非法，請根據提示調整。
InvalidDegist	The Content-MD5 you specified is invalid.	400	請求Header中Content-MD5不正確。
InvalidRequestURL	Http request URL format invalid.	400	請求的URL不正確。具體資訊，請參見對應API文檔。
InvalidQueryString	Http request URL contains invalid querystring item “Element⑤”.	400	請求的URL不正確。具體資訊，請參見對應API文檔。
MalformedXML	The XML you provided was not well-formed.	400	XML結構異常。具體資訊，請參見對應API文檔。
MissingAuthorizationHeader	Authorization header is required.	400	請求Header缺少欄位。具體資訊，請參見公用參數。
MissingDateHeader	Date header is required.	400	請求Header缺少欄位。具體資訊，請參見公用參數。
MissingReceiptHandle	ReceiptHandle is required.	400	請求缺少參數。具體資訊，請參見對應API文檔。
MissingVisibilityTimeout	VisibilityTimeout is required.	400	請求缺少參數。具體資訊，請參見對應API文檔。
MessageNotExist	Message not exist.	404	隊列中沒有可見訊息。
MessageNotExist	The receipt handle you provided has expired.	404	消費訊息過慢導致訊息重新回到隊列產生新的ReceiptHandle，之前的ReceiptHandle失效。加快消費速度或者增加隊列的不可見時間。
QueueAlreadyExist	The queue you want to create is already exist.	409	同名隊列已存在，且請求屬性與原有隊列屬性不同。
InvalidQueueName	The queue name you provided is invalid. QueueName should start with alpha and contain only alpha, digit or - .	400	隊列名稱不合法。具體資訊，請參見對應API文檔。
QueueNameLengthError	Queue name length should between 1 and 255.	400	隊列名稱不合法。具體資訊，請參見對應API文檔。
QueueNotExist	The queue name you provided is not exist.	404	隊列不存在，請先建立隊列。
ReceiptHandleError	The receipt handle you provide is not valid.	400	請求參數不合法。具體資訊，請參見對應API文檔。
SignatureDoesNotMatch	The request signature we calculated does not match the signature you provided. Check your key and signing method.	403	請求籤名異常。具體資訊，請參見請求籤名機制。
TimeExpired	The http request you sent is expired.	408	請求時間與輕量訊息佇列（原 MNS）伺服器時間相差超過15分鐘，建議檢查本地時間。
QpsLimitExceeded	The qps limit of the queue is exceeded ⑥.	400	隊列每秒的請求次數超過QPS限制，如果需要提高QPS限制，請聯絡輕量訊息佇列（原 MNS）支援人員。
TopicAlreadyExist	The topic you want to create already exists.	409	同名主題已存在，並且請求屬性與原有主題屬性不同。
TopicNameInvalid	The topic name you provided is invalid. TopicName should start with alpha or digit and contain only alpha, digit or -.	400	主題名稱不合法。具體資訊，請參見對應API文檔。
TopicNameLengthError	Topic name length is out of range, should be between 1 and 255.	400	主題名稱不合法。具體資訊，請參見對應API文檔。
TopicNotExist	The Topic you provided does not exist.	404	主題不存在，請先建立主題。
SubscriptionNameInvalid	The subscription name you provided is invalid. SubscriptionName should start with alpha or digit and contain only alpha, digit or -.	400	訂閱名稱不合法。具體資訊，請參見對應API文檔。
SubscriptionNameLengthError	Subscription name length is out of range, should be between 1 and 255.	400	訂閱名稱不合法。具體資訊，請參見對應API文檔。
SubscriptionNotExist	The subscription you provided does not exist.	404	訂閱不存在，請先建立訂閱。
SubscriptionAlreadyExist	The subscription you want to create already exists.	409	同名訂閱已經存在，且請求屬性與原有訂閱屬性不同。
EndpointInvalid	The format of endpoint you provided is invalid.	400	Endpoint參數不合法。具體資訊，請參見Endpoint。
InvalidArgument	The length of message should not be larger than MaximumMessageSize.	400	訊息體過長。具體資訊，請參見對應API文檔。

說明

①②：在請求內容的XML元素名稱。
③：在輕量訊息佇列（原 MNS）中某個參數的下限值。
④：在輕量訊息佇列（原 MNS）中某個參數的上限值。
⑤：在URL請求中QueryString的元素。
⑥：當前輕量訊息佇列（原 MNS）的單個Queue的QPS上限為3000。