更新时间:2026-08-11 GMT+08:00
分享

错误码

当您调用API时,如果遇到“APIGW”开头的错误码,请参见API网关错误码进行处理。

状态码

错误码

子编码

错误信息

描述

处理措施

200

KOOPHONE.API.0000

/

租户不存在

实际请求的租户并不存在

检查租户是否存在

200

KOOPHONE.API.0001

/

缺少请求头x-tenant-id

没传请求头参数x-tenant-id

检查请求头参数x-tenant-id

200

KOOPHONE.API.0002

/

缺少请求头x-request-id

没传请求头参数x-request-id

检查请求头参数x-request-id

200

KOOPHONE.API.0004

/

项目不存在

请求的参数中项目id实际不存在

检查项目是否存在

200

KOOPHONE.API.0005

/

缺少请求头

没传请求头具体参数

请检查请求头

200

KOOPHONE.API.1004

/

未订阅服务

还没有订阅该服务

请先订阅服务

200

KOOPHONE.API.1012

/

实例不属于租户

租户下没有此实例

请检查该实例是否属于租户

200

KOOPHONE.API.1417

/

系统应用初始化中...

系统应用初始化中...

请稍后重试

200

KOOPHONE.API.1418

1418-1

数据加载中

云机未绑定计算资源

请联系客服

200

KOOPHONE.API.1418

1418-2

数据加载中

数据加载中

请稍后重试

200

KOOPHONE.API.1419

/

正在为您匹配快速通道

正在为您匹配快速通道

请稍后重试

200

KOOPHONE.API.2200

/

服务未订购

服务未订购

请订购云机

200

KOOPHONE.API.2001

/

云app不存在

没有此cloud app

请检查云app是否存在

200

KOOPHONE.API.2002

/

云app未授权

这个cloud app还没有被授权

请检查云app是否授权

200

KOOPHONE.API.2003

/

没有空闲实例

没有空闲实例

请检查是否存在空闲实例

200

KOOPHONE.API.2004

/

实例已冻结

实例已经被冻结了

请先解冻实例

200

KOOPHONE.API.2005

/

实例正在恢复中

此实例还在恢复过程中

请等待实例恢复完成

200

KOOPHONE.API.2006

/

实例在备份中

此实例还在备份过程中

请等待实例备份完成

200

KOOPHONE.API.2200

/

服务未订购

服务未订购

请订购云机

200

KOOPHONE.API.2221

/

云机已关机

云机已关机

请重启后重试

200

KOOPHONE.API.2404

/

云机实例已被冻结

云机实例已被冻结

请及时续费

200

KOOPHONE.API.3002

/

没有这样的sku或region

sku或者region不存在

请检查sku或者region是否正确

200

KOOPHONE.API.3003

/

通用实例需要操作系统版本

通用实例缺少了操作系统版本

请检查通用实例是否包含操作系统版本

200

KOOPHONE.API.3006

/

如果周期类型为月,则周期范围应在1-9之间

如果请求参数中的period type为月份,则period num的范围应在1-9之间

请检查周期类型和周期范围是否准确

200

KOOPHONE.API.3007

/

如果周期类型为年,周期范围应在1-3之间

如果请求参数中的period type为年份,则period num的范围应在1-3之间

请检查周期类型和周期范围是否准确

200

KOOPHONE.API.3008

/

请求参数中的fast_install应该为0或1

请求参数中的fast_install应该为0或1

检查请求参数fast_install是否为0或1

200

KOOPHONE.API.3009

/

查询不到phoneId

查询phoneId时报错

请检查查询phoneId的接口是否异常

200

KOOPHONE.API.30005

/

服务繁忙,请稍后重试

服务繁忙,请稍后重试

请稍后重试

200

KOOPHONE.API.4001

/

实例不存在

不存在此实例

请检查实例是否存在

200

KOOPHONE.API.40000

40000-1

云机不存在

云机不存在

请检查云机ID是否正确

200

KOOPHONE.API.40000

40000-2

云机不存在

云机状态异常

请检查云机激活状态

200

KOOPHONE.API.40001

/

云机重启中

云机重启中

请稍后重试

200

KOOPHONE.API.40004

/

云机不在线

云机不在线

请重启后重试

200

KOOPHONE.API.40005

40005-1

云机繁忙,云机初始化中

云机更换镜像中

请稍后重试

200

KOOPHONE.API.40005

40005-2

云机繁忙,云机初始化中

云机初始化中

请稍后重试

200

KOOPHONE.API.40009

/

云机维护中

云机维护中

请联系客服

200

KOOPHONE.API.40010

/

库存不足

订购的实例库存不足

请检查库存是否充足

200

KOOPHONE.API.40066

/

服务器维护中

服务器维护中

请联系客服

200

KOOPHONE.API.40090

/

正在更换云机

正在更换云机

请稍后重试

200

KOOPHONE.API.40092

/

云机还原中

云机还原中

请稍后重试

200

KOOPHONE.API.40099

40099-1

数据恢复异常

云机还原失败

请联系客服

200

KOOPHONE.API.40099

40099-2

数据恢复异常

云机还原超时

请重启后重试

200

KOOPHONE.API.50008

/

云机备份中

云机备份中

请稍后重试

200

KOOPHONE.API.50009

/

不满足类云应用禁止返回桌面

不满足类云应用禁止返回桌面

请联系客服

200

KOOPHONE.API.62006

/

应用程序的大小必须是一个数字

应用程序的大小必须是一个数字

请检查app包大小是否是数字

200

KOOPHONE.API.62010

/

云实例异常

云实例异常

请检查实例是否正常

200

KOOPHONE.API.62015

/

应用程序包的大小超过限制2G

应用程序包的大小超过限制2G

请检查app包的大小是否超过限制2G

200

KOOPHONE.API.62016

/

单个租户上传的应用包总大小超过上限1T

单个租户上传的应用包总大小超过上限1T

请检查单个租户上传的总应用包大小是否超过1T

200

KOOPHONE.API.62017

/

下载失败,请检查install_package_url

下载失败,请检查install_package_url

请检查请求参数中的install_package_url是否有效

200

KOOPHONE.API.62019

/

安装app失败

安装app失败

请检查安装app是否成功

200

KOOPHONE.API.62020

/

版本冲突

版本冲突

请检查版本是否冲突

200

KOOPHONE.API.62021

/

空间不足

空间不足

请检查待安装的实例空间是否充足

200

KOOPHONE.API.9001

/

Redis返回空值

请求redis,返回一个空值

请检查redis返回值

400

KOOPHONE.API.0003

/

无效的请求头x-request-id

请求头中的参数x-request-id无效

请检查请求头x-request-id是否有效

400

KOOPHONE.API.1000

/

接口请求参数存在错误,检查请求参数类型或者范围是否跟接口保持一致

请求参数错误,检查请求参数类型和范围是否由接口定义

检查请求参数类型及范围

400

KOOPHONE.API.1002

/

instance not in the same region, modify the request instance to the same region

要操作的实例列表不属于同一地区,请将请求实例修改为同一地区

修改请求实例为同一个大区

400

KOOPHONE.API.1005

/

请求参数错误,请求参数不包含所有需要的编码和网络组合

接口请求参数有错误,请求参数中缺少了必要的编码和网络组合

请检查请求参数是否包含所有需要的编码和网络组合

400

KOOPHONE.API.3001

/

输入实例sku参数需要与band sku匹配

输入实例中的sku参数与band sku不匹配

请检查输入实例sku参数和band sku是否匹配

400

KOOPHONE.API.4999

/

调用第三方api错误

第三方api调用错误

请检查第三方api

400

KOOPHONE.API.5001

/

不能删除按需实例

请求参数中的实例是按需实例,不能删除

请检查删除的是否是按需实例

400

KOOPHONE.API.6000

/

无效的请求参数

接口请求参数无效

请检查请求参数是否有效

401

KOOPHONE.API.1001

/

租户没有实例对应的权限,需要检查请求传入的实例ID是否正确

无实例权限,检查请求传入的实例ID是否正确

检查请求传入的实例id是否正确

401

KOOPHONE.API.1003

/

租户没有使用API的授权,请联系我们将您添加到白名单

当前租户未经授权,还不能使用API,请联系我们将您添加到白名单

请联系我们将租户添加白名单,给租户授权

401

KOOPHONE.API.6001

/

身份验证失败!

token失效了,身份验证失败

请检查身份验证

403

KOOPHONE.API.6002

/

没有许可

没有许可

请检查是否许可

500

KOOPHONE.API.6002

/

Token解析失败

Token解析失败

请检查token解析

500

KOOPHONE.API.9000

/

解密失败

解密失败

请检查解密是否正确

500

KOOPHONE.API.9002

/

未能获取redis锁

获取redis锁时失败

请检查获取redis锁

500

KOOPHONE.API.9003

/

调用第三方api错误

调用第三方api错误

请检查第三方api

500

KOOPHONE.API.9999

/

未知错误

未知错误

请联系运营人员检查系统是否正常

相关文档