Updated on 2025-04-25 GMT+08:00

ServiceComb 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.

Category

Status Code

Error Code

Error Message

Description

Solution

Common error codes

400

400001

Invalid parameter(s)

Invalid parameter.

Change parameters as prompted.

404

404001

ErrRecoudNotExists

The resource does not exist.

Enter valid search criteria.

409

409001

ErrRecordAlreadyExists

The resource already exists.

Do not create the same record.

500

500003

Internal server error

Internal server error.

Contact technical support.

Microservice

400

400002

ErrUnhealthy

The service is unhealthy.

Try again later or contact technical support.

400010

Micro-service already exists

The service already exists.

Modify the service ID or microservice description in the body of the request for creating a microservice.

400011

ErrUnavailableBackend

No available backend instance.

Try again later or contact technical support.

400012

Micro-service does not exist

The service does not exist.

Enter a valid service ID.

400013

Micro-service has deployed instance(s)

The microservice cannot be deleted because instances have been deployed.

Take the instance offline and then delete the microservice. Alternatively, forcibly delete the microservice by setting the query parameter force to true in the URL.

400014

Undefined schema id

The schema ID does not exist.

Enter a valid schema ID.

400015

Not allowed to modify schema

The schema cannot be modified.

The schema has been registered and cannot be modified.

400016

Schema does not exist

The schema does not exist.

Register the schema first.

400017

Instance does not exist

Instance does not exist.

Enter a valid instance ID.

400018

ErrTagNotExists

The tag does not exist.

This error code is usually generated for a query API, indicating that the tag does not exist. The service performs subsequent processing based on the returned value.

400019

ErrRuleAlreadyExists

The rule already exists.

The rule is repeatedly created. Generally, this error can be ignored.

400020

ErrBlackAndWhiteRule

Blacklist and whitelist error.

Modify the parameter value based on the error message.

400021

ErrModifyRuleNotAllow

The rule cannot be modified.

You can modify the microservice information only after changing the version number.

400022

ErrRuleNotExists

The rule does not exist.

This error code is usually generated for a query API, indicating that the rule does not exist. The service performs subsequent processing based on the returned value.

400023

Cosumer(s) depends on this micro-service

The microservice cannot be deleted because it is the dependent service of other microservices.

You can forcibly delete microservices by setting the query parameter force to true in the URL.

400024

ErrPermissionDeny

Insufficient permissions.

Use a proper account to perform operations.

400025

ErrEndpointAlreadyExists

The port already exists.

Check whether the port is occupied by another instance.

400026

Micro-service version does not exist

The microservice instance does not exist.

Enter a correct version number or range.

400100

Not enough quota

Insufficient quota.

The quotas of resources such as microservices, instances, or schemas are insufficient. Delete some resources and create again.

401

401204

No authorization header

Unauthorized.

This parameter is mandatory if security authentication is enabled for the microservice engine. Otherwise, this parameter is not required.

The token of the microservice engine with security authentication enabled is in the following format:

Authorization:Bearer {Token}

For details about how to obtain the token, see Obtaining the User Token of an Exclusive ServiceComb Engine.

401201

Request unauthorized

Unauthorized.

Enter a valid authorization.

403

403001

ErrForbidden

Insufficient permissions

Use a proper account to perform operations.

500

500011

Registry service is unavailable

The registry service is unavailable.

Contact technical support.

500101

ErrUnavailableQuota

No quota.

Try again later or contact technical support.

500605

NA

Failed to connect to etcd of the configuration center.

Try again later or contact technical support.

Authentication

401

401202

User name or password is wrong

Incorrect account name or password.

Enter the correct account name and password.