AWS的错误码参照了HTTP状态码定义。错误码以3位的数字代码表达,所有错误码首数字代表的一类错误。
首数字|说明
--|--
4|客户端错误
5|服务端错误
7|服务可用性
8|配合限制和其他
当请求返回了AWS非预期消息或错误时,除了提供错误码,通常我们会根据具体的场景提供问题概要说明,如果是出错类异常,详细信息一定被记录到AWS的aws.log文件。
**码表**
Code|描述|异常或发生场景
--|--|--
400|错误的参数请求(Bad Request)<br>通常当缺少必要参数,或者参数值格式不正确时,会返回该错误信息。此时可以查看相关文档确认每个参数的格式是否正确。例如:执行启动流程方法时,未提供processInstId参数|AWSIllegalArgumentException<br>* 当客户端请求AWS服务时,若处于该场景将以该错误码返回到ResponseObject数据结构
401|未授权被拒绝(Unauthorized)<br>当用户提供了无效的session,或者请求的鉴权结果不正确时,会返回该错误信息。|目前只适用于SOAP/RESTAPI的Web层封装的错误代码,不适用于服务器端异常处理<br>当客户端请求AWS服务时,若处于该场景将以该错误码返回到ResponseObject数据结构
403|访问被拒绝(Forbidden)<br>该请求是有效的,但操作是被禁止且不应该再次尝试时,会返回该错误信息。例如:要执行的任务实例已结束|AWSForbiddenException<br>* 当客户端请求AWS服务时,若处于该场景将以该错误码返回到ResponseObject数据结构
404|找不到资源对象(Not Find Resource)<br>当用户试图访问不存在的资源时,会返回该错误信息。例如:要执行的任务实例已不存;账户不存在|AWSObjectNotFindException
405|请求方法不允许(Method Not Allowed)<br>使用了不支持的请求方法去操作资源时,会返回该错误信息。例如:使用GET请求一个POST操作|* 目前只适用于REST API的Web层封装的错误代码,不适用于服务器端异常处理
408|资源请求超时(Request Timeout)<br>请求超出了等待时间,会返回该错误信息。例如:在调用AWS的SOAP或REST服务,连接至AWS服务器超时|* 目前只适用于SOAP/REST API的Web层封装的错误代码,不适用于服务器端异常处理
500|内部错误(Internal Server Error)<br>当服务器执行请求过程中,遇到内部处理错误时,会返回该错误信息。遇到这种错误|AWSException所有继承该异常子类,未实现错误号的异常(getAPIErrorCode())所有JDK或非AWS异常抛出,被系统捕获的<br>* 当客户端请求AWS服务时,若处于该场景将以该错误码返回到ResponseObject数据结构
521|传输转换错误(Transfer Error)<br>当服务器执行请求过程中,遇到导入导出或格式转换错误时,会返回该错误信息。遇到这种错误|AWSTransferException
530|应用容器错误(App Container Error)<br>当服务器执行请求过程中,遇到PaaS应用容器类错误时,会返回该错误信息。遇到这种错误,请检查AWS的错误日志|AppContainerException
540|应用商店错误(AppStore Error)<br>当服务器执行请求过程中,遇到PaaS与AppStore相互处理过程中发生错误时,会返回该错误信息。遇到这种错误,请检查AWS的错误日志|AppStoreException
550|业务错误(BPMN Error)<br>当BPMN引擎执行时由开发者抛出BPMNError业务异常时,会返回该错误信息。|BPMNError
590|AWS Instance Server连接失败<br>当客户端以HTTP(S)经Web连接至AWS服务器时,未能正常建立通信连接时会返回该错误信息。遇到这种错误,可能是AWS服务已停止或Web与AWS之间的网络故障|Web层错误
760|服务正在启动(Instance Starting)<br>当服务器正在启动尚未就绪时,会返回该错误信息。遇到这种错误,请稍后执行|
761|服务正在关闭(Instance Stoping)<br>当服务器正在关闭时,会返回该错误信息。遇到这种错误,请不要再重复请求,服务器将被关闭|
762|服务脱机(Instance Offline)<br>当服务器处于运行中,由运维人员暂停客户端响应时,会返回该错误信息。遇到这种错误,请联系系统管理员|
770|应用正在启动(App Starting)<br>当访问的应用正在启动尚未就绪时,会返回该错误信息。遇到这种错误,请稍后执行|
771|应用正在关闭(App Stoping)<br>当访问的应用正在关闭时,会返回该错误信息。遇到这种错误,请不要再重复请求,应用将被关闭|
772|应用脱机(App Offline)<br>当应用处于就绪但依赖的应用未安装或暂停后,会返回该错误信息,如果该应用未被授权或订阅也会处于772状态。遇到这种错误,排出错误后再启动该应用|
773|应用已卸载(App Uninstall)<br>当应用已经被卸载后,会返回该错误信息。遇到这种错误可以忽略,或访问应用管理,将卸载的应用还原|
774|应用出错暂停(App Failed)<br>当应用启动失败后,会返回该错误信息。遇到这种错误,请检查该应用的日志,排出错误后再启动该应用|
- 概述
- OpenAPI使用方法
- 应用管理(AMC)接口
- 从开发小组中删除一个成员
- 添加一个成员到开发小组中
- App应用接口
- 获得app在当前AWS节点实例(JVM)的上下文对象
- 判断指定的应用是否已安装
- 判断指定的应用是否已启动
- 获得应用自定义的系统参数值
- 保存应用自定义的系统参数值
- 向指定App发送一条调试信息日志
- 向指定App发送一条警告信息日志,并输出至命令行屏幕
- 向指定App发送一条警告信息日志,并输出至命令行屏幕(2)
- 向指定App发送一条错误信息日志和解决方案建议,并输出至命令行屏幕
- 向指定App发送一条错误信息日志,并输出至命令行屏幕
- 获得I18N值(sid)
- 获得I18N值
- BO操作接口
- 为指定的BO表新增记录,该API适用于流程实例驱动的数据记录
- (批量)为指定的BO表新增记录,该API适用于流程实例驱动或DW仅存储实例驱动的数据记录
- (批量)为指定的BO表新增记录,该API适用于纯数据迁移和查询、利用,不能由流程实例或仅存储实例驱动
- 为指定的BO表新增记录,该API适用于纯数据迁移和查询、利用,不能由流程实例或仅存储实例驱动
- 删除一条BO表记录
- 删除与某流程实例相关的BO表记录
- 更新一条BO表记录,更新的BO数据ID需要在Map中指定,KEY要求大写
- (批量)根据流程实例更新BO数据
- 根据BOID查询指定字段的值
- 根据BOID查询一条BO数据,返回Json格式的字符串
- 获取指定附件字段已上传的全部文件列表
- 读取指定文件内容
- 将文件上传到BO表的指定字段并设置formFile附加信息,formFileModel的id不为空时执行更新操作,content为null,则只更新其他相关附属信息,如remark
- 批量删除指定字段的所有文件
- 删除指定id的附件
- BO数据查询方法
- DC存储接口
- 下载一个附件
- 上传一个附件
- 任务委托/代理(Delegation Task Instance)接口
- 通过角色创建委托申请
- 通过修改委托代理人账户列表
- 创建一个委托申请,如果scopeType=1,必须指定scope列表
- 删除一个委托申请
- 修改委托代理人账户列表
- 修改委托代理人失效时间
- 通过id获取委托申请
- 获得指定代理人的有效委托列表
- 表单访问和操作接口
- 返回完整的带有工具栏的表单
- 返回表单页面URL
- 返回表单页面
- 获取流程跟踪URL
- 返回完整的带有工具栏的表单URL
- 通知中心接口
- 系统消息是否可用
- 发送一封内部电子邮件。要正常使用该API,需要当前AwsPaaS安装了"内部邮件"应用(appId:com.actionsoft.apps.email)
- 发送一封含附件的互联网电子邮件(同步)
- 给用户发送一条消息。要正常使用该API,需要当前AWS PaaS安装了"通知中心"应用(appId:com.actionsoft.apps.notification)
- 以admin身份给用户发送一条系统消息。要正常使用该API,需要当前AWS PaaS安装了"通知中心"应用(appId:com.actionsoft.apps.notification)
- 发送一封含附件的互联网电子邮件(异步)
- 组织机构接口
- 获得一个用户对象
- 通过id获得一个用户对象
- 将可能含有账户别名的字符串处理成合法的登录账户名
- 将可能含有多个账户别名的字符串处理成合法的登录账户名字符串
- 将可能含有多个账户别名的字符串处理成用户对象
- 将一组AWS登录账户名转换成友好的账户别名
- 通过split将一组AWS登录账户(或含有别名的登录账户)转换成姓名
- 将一组AWS登录账户(或含有别名的登录账户)转换成姓名
- 检查一组AWS登录账户合法性,将不合法的账户返回
- 在uid所能访问的所有账户范围中搜索用户,返回匹配登录名、姓名或姓名拼音首写字母的结果
- 按部门查询用户对象
- 获取部门下兼职的用户对象
- 按部门查询用户对象(包含兼职)
- 获得部门下用户数
- 按角色查询用户对象
- 按角色查询用户对象,包含兼职到参数指定的角色的用户
- 按部门查询有管理者身份的人
- 是否有部门管理者身份
- 创建账户
- 更新一个账户属性
- 注销账户
- 激活用户
- 删除用户
- 账户移动部门
- 设置管理者身份
- 初始化用户密码
- 重设用户密码
- 删除用户
- 更新用户角色
- 取消管理者身份
- 创建一个账户兼任信息
- 查询用户兼任列表
- 获得部门兼任列表
- 创建一个新角色
- 删除角色
- 更新角色
- 获得角色列表
- 获得角色
- 获得一个角色对象
- 通过分类名获得角色列表
- 通过账户名获得一个角色对象
- 新建团队
- 更新团队名称
- 移除团队小组
- 获得团队列表
- 获得团队成员
- 添加团队小组成员
- 新建部门
- 获得指定部门所在的行政区域划分,如果当前部门没有 设定,则自动向上寻找
- 合并指定部门到另一个部门
- 合并多个部门到目标部门。注意,仅合并指定的源部门,不包含子部门
- 移动一个部门位置到单位下(id不变),该部门下的子部门layer也会级联改变
- 移动一个部门位置(id不变),该部门下的子部门layer也会级联改变
- 删除兼任
- 获得部门对象
- 是否存在子部门
- 获得指定部门的下级部门
- 获得一个部门对象
- 更新部门
- 注销部门,注销后不再显示该部门及子部门和人员信息
- 激活注销的部门
- 删除部门
- 新建单位
- 更新一个单位信息
- 注销单位,注销后不再显示该单位及单位以下的部门和人员信息
- 激活注销的单位
- 删除团队成员
- 获得一个单位对象方式一
- 获得单位列表
- 删除单位
- 获取用户所有兼职单位方式一
- 获取用户所有兼职单位方式二
- 获得一个单位对象方式二
- 判断某用户对于某单位是否有AC权限
- 权限接口
- 追加一个AC授权。操作结果,返回true表示成功,返回false表示失败
- 创建一个权限组
- 为权限组创建一个权限资源
- 为分配对象创建一个授权
- 是否为平台管理员
- 根据resourceType返回该类资源的AC插件配置对象
- 判断是否设置了AC授权
- 删除某资源的AC授权信息
- 获得为resourceType/resourceId分配的访问权限列表
- 获得为resourceType/resourceId/accessMode分配的访问权限列表
- 获得user能访问的某类资源集合
- AC授权验证
- 判断是否有流程启动权限
- 判断是否有移动策略配置访问权限
- 判断是否有移动应用访问权限
- 判断是否有导航菜单访问权限
- 删除一个权限组,同时与该权限组相关的资源项、分配定义等一并删除
- 删除一个权限资源
- 清空一个权限组的全部资源定义
- 删除与指定权限组Id有关的全部权限分配
- 删除与角色有关的全部权限分配
- 删除与账户有关的全部权限分配
- 身份验证和门户接口
- 设置用户的头像,头像默认大小120x120,如果上传超过这个大小,会根据传入参数裁剪
- 获得指定用户可访问的导航树全部功能菜单定义
- 获得指定用户可访问的下一级功能菜单定义
- 获取子系统导航下的所有功能菜单定义
- 根据AWS平台配置策略,是否允许个人修改口令
- 根据AWS平台三员安全的配置策略,当前是否到了要修改口令的时间。用于配合门户皮肤在登录系统时检查,弹出强行修改口令的对话框
- 个人配置信息必填项
- 获得指定账户头像URL资源,如果该用户未设置,给出一个默认头像
- 获得指定用户的基本信息资料
- 保存个人基本信息,该API只允许更新个人资料
- 创建默认属性的用户会话
- 创建一个PC端BPM客户端用户会话
- 创建一个新的BPM客户端用户会话
- 检查session有效性,如果有效则刷新一次session
- 刷新一次session,延长session生命周期
- 注销一个会话
- 获得当前用户前n条的登录日志
- 获得用户自定义的参数结构
- 设置用户自定义的参数结构
- 获得用户自定义的参数项
- 设置用户自定义的参数项
- 判断账户当前是否在线,返回平台提供的图标url
- 返回当前系统有效的在线用户列表
- 返回当前有效的在线用户数量
- 判断指定账户是否在线
- 判断指定账户是否在线
- 改变用户界面语言
- 流程实例控制接口
- 创建一个流程实例
- 创建一个短流程实例
- 创建一个仅存储实例控制
- 创建一个常规子流程实例
- 读取变量值
- 读取变量值
- 读取流程变量列表
- 通过processBusinessKey读取变量值列表
- 设置流程变量值
- 通过processBusinessKey为流程变量赋值
- 设置流程变量列表
- 通过processBusinessKey为流程变量赋值
- 通过id启动流程
- 通过processBusinessKey启动流程
- 通过id流程复活,重新激活已结束的流程实例
- 通过processBusinessKey流程复活,重新激活已结束的流程实例
- 通过id重置流程到第一个节点,将任务创建给流程启动者,等同于由启动者撤销重办业务(适用于开始事件后是UserTask的人工流程)
- 通过processBusinessKey重置流程到第一个节点,将任务创建给流程启动者,等同于由启动者撤销重办业务( 适用于开始事件后是UserTask的人工流程)
- 通过id恢复被挂起的流程实例
- 通过processBusinessKey恢复被挂起的流程实例
- 通过id挂起流程实例
- 通过processBusinessKey挂起流程实例
- 通过id终止一个流程实例
- 通过processBusinessKey终止一个流程实例
- 通过id删除流程实例,与流程实例(及子流程实例嵌套)相关的业务数据、控制数据、变量等全部删除
- 通过processBusinessKey删除一个流程实例,与流程实例(及子流程实例嵌套)相关的业务数据、控制数据、变量等全部删除
- 通过id取消流程,终止并补偿一个流程实例
- 通过processBusinessKey取消流程,终止并补偿一个流程实例
- 通过id判断流程实例是否被挂起
- 通过processBusinessKey判断流程实例是否被挂起
- 通过id判断流程实例是否允许撤销重办
- 通过processBusinessKey判断流程实例是否允许撤销重办
- 通过processBusinessKey判断流程实例是否已结束
- 判断流程实例是否已结束
- 设置流程实例关联的高级分类规则
- 设置流程实例扩展参数值
- 通过Id获得流程实例的历史参与者账户列表
- 通过processBusinessKey获得流程实例的历史参与者账户列表
- 获得一个流程实例对象
- 通过id统计流程处于活动状态的任务数量
- 通过processBusinessKey统计流程处于活动状态的任务数量
- 获得一个流程实例对象
- 通过Id获得流程实例的审批留言记录
- 通过processBusinessKey获得流程实例的审批留言记录
- 查询流程实例
- 查询流程实例
- 查询流程实例数
- 通过Id给当前办理者发送催办邮件(有外部邮箱配置的用户,优先发送外部邮件)
- 通过processBusinessKey给当前办理者发送催办邮件(有外部邮箱配置的用户,优先发送外部邮件)
- AWS模型元数据仓库接口
- 创建一个URL表单
- 修改一个URL表单模型
- 返回一个人工任务节点的JSON结构
- 获取流程实例的跟踪URL
- 获取流程信息
- 获取表单绑定的URL
- 删除一个表单
- 流程扩展属性,一个自定义的字符串
- 流程说明
- 获得流程的主版本Id
- 获得发布运行的流程版本Id
- 符合BPMN2规范的流程定义文件
- 返回base64字符串
- 返回流程跟踪图的URL
- API错误码