全部產品
Search
文件中心

Simple Message Queue (formerly MNS):錯誤碼

更新時間:Dec 03, 2024

當您訪問輕量訊息佇列(原 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的元素。