错误码 - 公有云文档中心

错误码

更新时间：2024-12-20 09:01:21

当 API 请求发生错误时，请求返回的消息体会以 Json 格式返回具体的错误码以及错误信息。

{
  "message":"PermissionDenied, instance [i-2aypaijz] is not running， can not be stopped",
  "ret_code":1400
}

青云的错误可分为客户端错误、服务器端错误、配置文件错误以及 License 错误四种，分别说明如下。

客户端错误

如果是客户端错误，说明该错误是由用户提交的 API 引起的，请确认用户提交的 API 请求符合规范。

错误代码错误类型提示

错误代码	错误类型	提示
1100	消息格式错误	当缺少必要参数，或者参数值格式不正确时，会返回该错误。此时可以查看相关文档确认每个参数的格式是否正确。
1101	请求方法错误	当请求了不存在的方法，或者参数值不正确时，会返回该错误。
1200	身份验证失败	当用户提供了不存在的 `access_key_id` 或 API 请求的签名不正确时，会返回该错误。此时可以检查 `access_key_id` 和 `secret_access_key` 是否配置正确，或者参考签名文档确认签名是否有误。
1300	消息已过期	当用户提交的 `time_stamp` 参数时间过期，超过 60 秒时会返回该错误。关于 `time_stamp`，用户可以参考公共参数相关说明。
1400	访问被拒绝	当用户试图访问不属于自己的资源，或者对于提交的操作没有权限，或者试图更改的资源处于不可更改的状态时等，会返回该错误，并在返回的错误信息里头提及错误原因。
1500	注册用户失败	当用户注册失败时，会返回该错误。
1510	帐号已存在	当注册已存在的账号时，会返回该错误。
1520	帐号格式不合法	当注册的账号格式不满足要求时，会返回该错误。
1600	登录失败	当用户输入错误的登录信息时，会返回该错误。
1610	找不到该用户	当用户提供了不存在的用户名时，会返回该错误。
1620	密码不匹配	当用户提供了不匹配的密码时，会返回该错误。
1630	重置密码失败	当用户重置密码不符合要求时，会返回该错误。
1640	重置密码过于频繁	当用户重置密码过于频繁时，会返回该错误。
1650	无效的密码重置 `token`	当用户重置密码 `token` 无效时，会返回该错误。
1660	用户名或密码不匹配	当用户提供了不匹配的用户名密码时，会返回该错误。
1661	用户未完成注册	当用户注册未完成时，会返回该错误。
1662	用户已被禁止访问	当用户执行超出权限时，会返回该错误。
2000	登录会话过期	当用户会话空闲过久时，会返回该错误，请重新登录。
2100	找不到资源	当用户试图访问不存在的资源时，会返回该错误。
2110	资源已存在	当用户创建已存在的资源时，会返回该错误。
2200	租赁资源失败	当用户租赁信息存在错误时，会返回该错误。
2300	解除租赁失败	当用户解除租赁失败时，会返回该错误。
2400	余额不足	当用户余额不足时，会返回该错误。
2500	超过配额	当用户试图创建的资源超过用户配额，或者短时间内的 API 访问请求超过配额限制时，会返回该错误。 API 访问请求配额限制是以 `天` 为单位，当超过配置限额时，将会在次日零点恢复。用户可以通过提交工单的方式来申请提高配额，并说明申请的理由。
3300	无效的 API 模块	当用户使用了无效的 API 模块时，会返回该错误。

1100

消息格式错误

当缺少必要参数，或者参数值格式不正确时，会返回该错误。此时可以查看相关文档确认每个参数的格式是否正确。

1101

请求方法错误

当请求了不存在的方法，或者参数值不正确时，会返回该错误。

1200

身份验证失败

当用户提供了不存在的 access_key_id 或 API 请求的签名不正确时，会返回该错误。
此时可以检查 access_key_id 和 secret_access_key 是否配置正确，或者参考签名文档确认签名是否有误。

1300

消息已过期

当用户提交的 time_stamp 参数时间过期，超过 60 秒时会返回该错误。关于 time_stamp，用户可以参考公共参数相关说明。

1400

访问被拒绝

当用户试图访问不属于自己的资源，或者对于提交的操作没有权限，或者试图更改的资源处于不可更改的状态时等，会返回该错误，并在返回的错误信息里头提及错误原因。

1500

注册用户失败

当用户注册失败时，会返回该错误。

1510

帐号已存在

当注册已存在的账号时，会返回该错误。

1520

帐号格式不合法

当注册的账号格式不满足要求时，会返回该错误。

1600

登录失败

当用户输入错误的登录信息时，会返回该错误。

1610

找不到该用户

当用户提供了不存在的用户名时，会返回该错误。

1620

密码不匹配

当用户提供了不匹配的密码时，会返回该错误。

1630

重置密码失败

当用户重置密码不符合要求时，会返回该错误。

1640

重置密码过于频繁

当用户重置密码过于频繁时，会返回该错误。

1650

无效的密码重置 token

当用户重置密码 token 无效时，会返回该错误。

1660

用户名或密码不匹配

当用户提供了不匹配的用户名密码时，会返回该错误。

1661

用户未完成注册

当用户注册未完成时，会返回该错误。

1662

用户已被禁止访问

当用户执行超出权限时，会返回该错误。

2000

登录会话过期

当用户会话空闲过久时，会返回该错误，请重新登录。

2100

找不到资源

当用户试图访问不存在的资源时，会返回该错误。

2110

资源已存在

当用户创建已存在的资源时，会返回该错误。

2200

租赁资源失败

当用户租赁信息存在错误时，会返回该错误。

2300

解除租赁失败

当用户解除租赁失败时，会返回该错误。

2400

余额不足

当用户余额不足时，会返回该错误。

2500

超过配额

当用户试图创建的资源超过用户配额，或者短时间内的 API 访问请求超过配额限制时，会返回该错误。

API 访问请求配额限制是以 天 为单位，当超过配置限额时，将会在次日零点恢复。
用户可以通过提交工单的方式来申请提高配额，并说明申请的理由。

3300

无效的 API 模块

当用户使用了无效的 API 模块时，会返回该错误。

License 错误

如果是 License 错误，说明授权证书存在错误，请确认授权证书。

错误代码	错误类型	提示
4000	无效的证书	当用户的证书失效时，会返回该错误。
4001	授权证书已经过期	当用户的授权证书已经过期时，会返回该错误。
4002	平台已有相同的授权证书	当用户的证书重复时，会返回该错误。
4003	超出证书授权	当用户的当前宿云服务器的数量已超过授权证书的规定数量时，会返回该错误。
4004	加载授权证书失败	当用户加载授权证书失败时，会返回该错误。
4005	找不到授权证书	当用户没有有效的授权证书时，会返回该错误。

错误代码

错误类型

提示

4000

无效的证书

当用户的证书失效时，会返回该错误。

4001

授权证书已经过期

当用户的授权证书已经过期时，会返回该错误。

4002

平台已有相同的授权证书

当用户的证书重复时，会返回该错误。

4003

超出证书授权

当用户的当前宿云服务器的数量已超过授权证书的规定数量时，会返回该错误。

4004

加载授权证书失败

当用户加载授权证书失败时，会返回该错误。

4005

找不到授权证书

当用户没有有效的授权证书时，会返回该错误。

服务器端错误

如果是服务器端错误，说明该错误是由服务器端引起的。

错误代码	错误类型	提示
5000	内部错误	当服务器执行请求过程中，遇到未知错误时，会返回该错误信息。
5100	服务器繁忙	当服务器执行超时，或者服务器负载过高无法完成请求时，会返回该错误信息。遇到这种错误，请稍后再尝试。
5200	资源不足	当青云的后台计算资源不足以满足用户的创建需求时，会返回该错误信息。
5300	服务更新中	当青云的后台服务正在更新时，会返回该错误信息。遇到这种错误，请稍后再尝试。
5400	存在依赖关系	当青云的后台服务正在更新时，会返回该错误信息。遇到这种错误，请稍后再尝试。
5500	Warehouse 服务未开启	当服务器 Warehouse 服务未开启时，会返回该错误信息。
5600	不支持的硬盘类型	当用户向一个不支持加密的云服务器挂载加密硬盘时，会返回该错误信息。

错误代码

错误类型

提示

5000

内部错误

当服务器执行请求过程中，遇到未知错误时，会返回该错误信息。

5100

服务器繁忙

当服务器执行超时，或者服务器负载过高无法完成请求时，会返回该错误信息。遇到这种错误，请稍后再尝试。

5200

资源不足

当青云的后台计算资源不足以满足用户的创建需求时，会返回该错误信息。

5300

服务更新中

当青云的后台服务正在更新时，会返回该错误信息。遇到这种错误，请稍后再尝试。

5400

存在依赖关系

当青云的后台服务正在更新时，会返回该错误信息。遇到这种错误，请稍后再尝试。

5500

Warehouse 服务未开启

当服务器 Warehouse 服务未开启时，会返回该错误信息。

5600

不支持的硬盘类型

当用户向一个不支持加密的云服务器挂载加密硬盘时，会返回该错误信息。

配置文件错误

如果是配置文件错误，说明配置文件中的某项配置内容存在问题，请确认相应的配置是否正确。

错误代码	错误类型	提示
8000	命令参数验证失败	当用户在配置文件中提供了错误的参数时，会返回该错误。
8001	配置文件中无任何镜像	当用户配置文件中无镜像时，会返回该错误。
8002	配置文件中镜像在指定区不存在	当用户配置文件中的镜像在指定区不存在时，会返回该错误。
8003	无效的集群设置	当用户配置文件提供了无效的集群设置时，会返回该错误。
8004	缺少配置文件	当缺少相应配置文件时，会返回该错误。

错误代码

错误类型

提示

8000

命令参数验证失败

当用户在配置文件中提供了错误的参数时，会返回该错误。

8001

配置文件中无任何镜像

当用户配置文件中无镜像时，会返回该错误。

8002

配置文件中镜像在指定区不存在

当用户配置文件中的镜像在指定区不存在时，会返回该错误。

8003

无效的集群设置

当用户配置文件提供了无效的集群设置时，会返回该错误。

8004

缺少配置文件

当缺少相应配置文件时，会返回该错误。