错误码

通过对错误码定义,能够简单的帮助用户或开发者识别和理解异常性质,错误码与错误不是一对一关系,是错误类型的一种抽象代号。

AWS的错误码参照了HTTP状态码定义。错误码以3位的数字代码表达,所有错误码首数字代表的一类错误。

首数字 说明
4 客户端错误
5 服务端错误
7 服务可用性
8 配合限制和其他

当请求返回了AWS非预期消息或错误时,除了提供错误码,通常我们会根据具体的场景提供问题概要说明,如果是出错类异常,详细信息一定被记录到AWS的aws.log文件。

码表

Code 描述 异常或发生场景
400 错误的参数请求(Bad Request)

通常当缺少必要参数,或者参数值格式不正确时,会返回该错误信息。此时可以查看相关文档确认每个参数的格式是否正确。例如:执行启动流程方法时,未提供processInstId参数
AWSIllegalArgumentException

* 当客户端请求AWS服务时,若处于该场景将以该错误码返回到ResponseObject数据结构
401 未授权被拒绝(Unauthorized)

当用户提供了无效的session,或者请求的鉴权结果不正确时,会返回该错误信息。
目前只适用于SOAP/REST API的Web层封装的错误代码,不适用于服务器端异常处理

当客户端请求AWS服务时,若处于该场景将以该错误码返回到ResponseObject数据结构
403 访问被拒绝(Forbidden)

该请求是有效的,但操作是被禁止且不应该再次尝试时,会返回该错误信息。例如:要执行的任务实例已结束
AWSForbiddenException

* 当客户端请求AWS服务时,若处于该场景将以该错误码返回到ResponseObject数据结构
404 找不到资源对象(Not Find Resource)

当用户试图访问不存在的资源时,会返回该错误信息。例如:要执行的任务实例已不存;账户不存在
AWSObjectNotFindException
405 请求方法不允许(Method Not Allowed)

使用了不支持的请求方法去操作资源时,会返回该错误信息。例如:使用GET请求一个POST操作
* 目前只适用于REST API的Web层封装的错误代码,不适用于服务器端异常处理
408 资源请求超时(Request Timeout)

请求超出了等待时间,会返回该错误信息。例如:在调用AWS的SOAP或REST服务,连接至AWS服务器超时
* 目前只适用于SOAP/REST API的Web层封装的错误代码,不适用于服务器端异常处理
500 内部错误(Internal Server Error)

当服务器执行请求过程中,遇到内部处理错误时,会返回该错误信息。遇到这种错误,请检查AWS的错误日志,及时与我们联系
AWSException
所有继承该异常子类,未实现错误号的异常(getAPIErrorCode())
所有JDK或非AWS异常抛出,被系统捕获的

* 当客户端请求AWS服务时,若处于该场景将以该错误码返回到ResponseObject数据结构
520 引擎错误(Engine Error)

当服务器执行请求过程中,遇到流程引擎、表单引擎等引擎类错误时,会返回该错误信息。遇到这种错误,请检查AWS的错误日志,及时与我们联系
AWSEngineException
AWSExpressionException
521 传输转换错误(Transfer Error)

当服务器执行请求过程中,遇到导入导出或格式转换错误时,会返回该错误信息。遇到这种错误,请检查AWS的错误日志,及时与我们联系
AWSTransferException
530 应用容器错误(App Container Error)

当服务器执行请求过程中,遇到PaaS应用容器类错误时,会返回该错误信息。遇到这种错误,请检查AWS的错误日志,及时与我们联系
AppContainerException
540 应用商店错误(AppStore Error)

当服务器执行请求过程中,遇到PaaS与AppStore相互处理过程中发生错误时,会返回该错误信息。遇到这种错误,请检查AWS的错误日志,及时与我们联系
AppStoreException
550 业务错误(BPMN Error)

当BPMN引擎执行时由开发者抛出BPMNError业务异常时,会返回该错误信息。遇到这种错误,请与业务开发者联系
BPMNError
590 AWS Instance Server连接失败

当客户端以HTTP(S)经Web连接至AWS服务器时,未能正常建立通信连接时会返回该错误信息。遇到这种错误,可能是AWS服务已停止或Web与AWS之间的网络故障
Web层错误
591 处理AWS Instance Server响应时发生错误

当客户端以HTTP(S)与AWS服务器建立连接后,在发生指令请求等待返回结果发生错误时,会返回该错误信息。遇到这种错误,请检查AWS的错误日志,及时与我们联系
Web层错误
760 服务正在启动(Instance Starting)

当服务器正在启动尚未就绪时,会返回该错误信息。遇到这种错误,请稍后执行
*当客户端请求AWS服务时,若处于该场景将以该错误码返回到ResponseObject数据结构
761 服务正在关闭(Instance Stoping)

当服务器正在关闭时,会返回该错误信息。遇到这种错误,请不要再重复请求,服务器将被关闭
* 当客户端请求AWS服务时,若处于该场景将以该错误码返回到ResponseObject数据结构
762 服务脱机(Instance Offline)

当服务器处于运行中,由运维人员暂停客户端响应时,会返回该错误信息。遇到这种错误,请联系系统管理员
* 当客户端请求AWS服务时,若处于该场景将以该错误码返回到ResponseObject数据结构
770 应用正在启动(App Starting)

当访问的应用正在启动尚未就绪时,会返回该错误信息。遇到这种错误,请稍后执行
* 当客户端请求AWS服务时,若处于该场景将以该错误码返回到ResponseObject数据结构
771 应用正在关闭(App Stoping)

当访问的应用正在关闭时,会返回该错误信息。遇到这种错误,请不要再重复请求,应用将被关闭
* 当客户端请求AWS服务时,若处于该场景将以该错误码返回到ResponseObject数据结构
772 应用脱机(App Offline)

当应用处于就绪但依赖的应用未安装或暂停后,会返回该错误信息,如果该应用未被授权或订阅也会处于772状态。遇到这种错误,排出错误后再启动该应用
* 当客户端请求AWS服务时,若处于该场景将以该错误码返回到ResponseObject数据结构
773 应用已卸载(App Uninstall)

当应用已经被卸载后,会返回该错误信息。遇到这种错误可以忽略,或访问应用管理,将卸载的应用还原
* 当客户端请求AWS服务时,若处于该场景将以该错误码返回到ResponseObject数据结构
774 应用出错暂停(App Failed)

当应用启动失败后,会返回该错误信息。遇到这种错误,请检查该应用的日志,排出错误后再启动该应用
* 当客户端请求AWS服务时,若处于该场景将以该错误码返回到ResponseObject数据结构
800 许可配额限制(Quota Limit)

当资源配额超过许可限制时,会返回该错误信息。例如:超过许可的注册用户数
AWSQuotaException

* 当客户端请求并超过许可证允许的最大并发返回到ResponseObject中

如何使用错误码

  • 如果错误来自AWSException及其子类,可以通过getAPIErrorCode()在Java代码中获取
  • 如果错误来自客户端API,可通过ResponseObject结构的errorCode读取


Seven
 010-62962343-690
 liujx@actionsoft.com.cn
感谢您对该文档的关注!如果您对当前页面内容有疑问或好的建议,请与我联系。如果您需要解答相关技术问题请登录AWS客户成功社区