错误码
通过对错误码定义,能够简单的帮助用户或开发者识别和理解异常性质,错误码与错误不是一对一关系,是错误类型的一种抽象代号。
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客户成功社区