文档

错误码

更新时间:

当您访问消息服务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

队列中没有可见消息。

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。