Updated on 2025-10-30 GMT+08:00

Error Codes

If an error code starting with APIGW is returned after you call an API, rectify the fault by referring to the instructions provided in API Gateway Error Codes.

Status Code

Error Codes

Error Message

Description

Solution

200

KOOPHONE.API.0000

tenant is not exist.

The actual requested tenant does not exist.

Check if tenants exist.

200

KOOPHONE.API.0001

missing request header 'x-tenant-id'.

No request header parameter x-tenant-id passed.

Check the request header parameter 'x-tenant-id'.

200

KOOPHONE.API.0002

missing request header 'x-request-id'.

No request header parameter x-request-id passed.

Check the request header 'x-request-id'.

200

KOOPHONE.API.0004

project is not exist.

The project ID in the requested parameters does not actually exist.

Check if the project exists.

200

KOOPHONE.API.0005

missing request header.

No specific parameters were passed for the request header.

Please check the request header.

200

KOOPHONE.API.1004

Services not subscribed.

Not yet subscribed to this service.

Please subscribe to the service first.

200

KOOPHONE.API.1012

instances are not belong to one tenant.

This instance does not exist under the tenant.

Please check if the instance belongs to a tenant.

200

KOOPHONE.API.2001

cloud app not exist.

There is no such cloud app available.

Please check if the cloud app exists.

200

KOOPHONE.API.2002

cloud app unauthorized.

This cloud app has not been authorized yet.

Please check if the cloud app is authorized.

200

KOOPHONE.API.2003

No idle instance.

No idle instance.

Please check if there are any idle instances.

200

KOOPHONE.API.2004

the instance already frozen.

The instance has been frozen.

Please unfreeze the instance first.

200

KOOPHONE.API.2005

the instance is in recover.

This instance is still in the process of recovery.

Please wait for instance recovery to complete.

200

KOOPHONE.API.2006

the instance is in backup.

This instance is still in the backup process.

Please wait for the instance backup to complete.

200

KOOPHONE.API.3002

no such sku or region.

sku or region does not exist.

Please check if the sku or region is correct.

200

KOOPHONE.API.3003

common instance need os version.

The common instance is missing the os version.

Please check if the common instance includes the os version.

200

KOOPHONE.API.3006

if period type is month, period num should between 1-9.

If the period type in the request parameter is month, the range of period num should be between 1-9.

Please check if the period type and period num are accurate.

200

KOOPHONE.API.3007

if period type is year, period num should between 1-3.

If the period type in the request parameter is year, the range of period num should be between 1-3.

Please check if the period type and period num are accurate.

200

KOOPHONE.API.3008

fast_install in request param should be 0 or 1.

fast_install in request param should be 0 or 1.

Check whether the request parameter "fast_install" is 0 or 1.

200

KOOPHONE.API.3009

query phoneId error.

query phoneId error.

Please check whether the interface for querying phoneId is abnormal.

200

KOOPHONE.API.4001

instance not exist.

This instance does not exist.

Please check if the instance exists.

200

KOOPHONE.API.40010

out of stock.

Insufficient inventory of ordered instances.

Please check if the stock is sufficient.

200

KOOPHONE.API.62006

The app size must be a number.

The app size must be a number.

Please check if the size of the app package is a number.

200

KOOPHONE.API.62010

The cloud instance is abnormal.

The cloud instance is abnormal.

Please check whether the instance is normal.

200

KOOPHONE.API.62015

The size of the app package exceeds the limit of 2G.

The size of the app package exceeds the limit of 2G.

Please check whether the size of the app package exceeds the limit of 2G.

200

KOOPHONE.API.62016

The total size of application packages uploaded by the tenant exceeds the total limit.

The total size of application packages uploaded by the tenant exceeds the total limit.

Please check whether the total application package size uploaded by a single tenant exceeds 1T.

200

KOOPHONE.API.62017

Download failed, please check the install_package_url.

Download failed, please check the install_package_url.

Please check whether the install_package_url in the request parameters is valid.

200

KOOPHONE.API.62019

Install app failed.

Install app failed.

Please check whether the installation of the app was successful.

200

KOOPHONE.API.62020

Version Conflict.

Version Conflict.

Please check if there is any version conflict.

200

KOOPHONE.API.62021

not enough space.

not enough space.

Please check whether the space of the instance to be installed is sufficient.

200

KOOPHONE.API.9001

redis returns empty value.

Request redis and return a null value.

Please check the Redis return value.

400

KOOPHONE.API.0003

invalid request header 'x-request-id'.

The parameter x-request-id in the request header is invalid.

Please check if the request header 'x-request-id' is valid.

400

KOOPHONE.API.1000

There is an error in the interface request parameters. Check if the request parameter type or range is consistent with the interface.

request param error, Check whether the request parameter type and range are defined by the interface.

Check whether the request parameter type and range are defined by the interface.

400

KOOPHONE.API.1002

The instance list to be operated on does not belong to the same region. Please modify the requested instances to the same region.

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

modify the request instance to the same region.

400

KOOPHONE.API.1005

request param error, Request param not contain the all needed encode and net combinations.

There is an error in the interface request parameters, as necessary encoding and network combinations are missing from the request parameters.

Please check if the request parameters include all required encoding and network combinations.

400

KOOPHONE.API.3001

input instance sku param need to match band sku.

The sku parameters in the input instance do not match the band sku.

Please check if the input instance sku parameters match the band sku.

400

KOOPHONE.API.4999

Invoking third api error.

Invoking third api error.

Please check the third-party API.

400

KOOPHONE.API.5001

Cannot delete on-demand instances.

The instance in the request parameter is an on-demand instance and cannot be deleted.

Please check if the deleted instance is an on-demand instance.

400

KOOPHONE.API.6000

Invalid request parameter.

Invalid request parameter.

Please check if the request parameters are valid.

401

KOOPHONE.API.1001

no instance permission, Check whether the instance ID passed in by the request is correct.

no instance permission, Check whether the instance ID passed in by the request is correct.

Check whether the instance ID passed in by the request is correct.

401

KOOPHONE.API.1003

tenant have no auth to use the API, please contact us to add you to the whitelist.

The current tenant is not authorized to use the API. Please contact us to add you to the whitelist.

Please contact us to add tenants to the whitelist and authorize them.

401

KOOPHONE.API.6001

Authenticate Failed!

Token has expired, authentication failed.

Please verify your identity.

403

KOOPHONE.API.6002

No permission.

No permission.

Please check if it is licensed.

500

KOOPHONE.API.6002

Token parsing failed.

Token parsing failed.

Please check token parsing.

500

KOOPHONE.API.9000

decrypt fail.

decrypt fail.

Please check if the decryption is correct.

500

KOOPHONE.API.9002

failed to acquire the redis lock.

Failed to obtain redis lock.

Please check to obtain redis lock.

500

KOOPHONE.API.9003

invoke third api error.

invoke third api error.

Please check the third-party API.

500

KOOPHONE.API.9999

unknown error.

unknown error.

Please contact the operator to check whether the system is normal.