Error code
Updated at:2025-10-16
When an error occurs during BLB access, the corresponding error code and error information will be returned from BLB to help users identify error and process it appropriately. When a request error occurs, detailed error information is returned through the Response Body in the format below:
| Parameter name | Type | Description |
|---|---|---|
| code | String | Error code |
| message | String | Error description |
| requestId | String | Request ID of this request |
Example:
JSON
1{
2 "requestId" : "ae2225f7-1c2e-427a-a1ad-5413b762957d",
3 "code" : "NoSuchKey",
4 "message" : "The resource you requested does not exist"
5}
BCE global error codes
| Error code | Error description | HTTP status code | Semantics |
|---|---|---|---|
| AccessDenied | Access denied. | 403 Forbidden | No permission to access the corresponding resource |
| InappropriateJSON | The JSON you provided was well-formed and valid, but not appropriate for this operation. | 400 Bad Request | The JSON format in the request is syntactically correct but semantically invalid. For example, a required item might be missing, or the value type might be mismatched. For compatibility, all unrecognized items should be ignored, and this error should not be returned. |
| InternalError | We encountered an internal error. Please try again. | 500 Internal Server Error | All other undefined errors. This should not be used if there are clearly corresponding errors of other types, including both general and service-specific errors. |
| InvalidAccessKeyId | The Access Key ID you provided does not exist in our records. | 403 Forbidden | Access Key ID does not exist |
| InvalidHTTPAuthHeader | The HTTP authorization header is invalid. Consult the service documentation for details. | 400 Bad Request | Invalid authorization header format |
| InvalidHTTPRequest | There was an error in the body of your HTTP request. | 400 Bad Request | The HTTP body format is invalid, e.g., non-compliant encoding. |
| InvalidURI | Could not parse the specified URI. | 400 Bad Request | The URI format is invalid. For instance, predefined service-specific keywords may not be correct. For issues like ID mismatching, more specific error codes like NoSuchKey should be applied. |
| MalformedJSON | The JSON you provided was not well-formed. | 400 Bad Request | Invalid JSON |
| InvalidVersion | The API version specified was invalid. | 404 Not Found | Invalid URI version No. |
| OptInRequired | A subscription for the service is required. | 403 Forbidden | Corresponding service not activated |
| PreconditionFailed | The specified If-Match header doesn't match the ETag header. | 412 Precondition Failed | ETag does not match |
| RequestExpired | Request has expired. Timestamp date is XXX. | 400 Bad Request | Request timeout |
| IdempotentParameterMismatch | The request uses the same client token as a previous, but non-identical request. | 403 Forbidden | The API parameters do not match for the same clientToken. |
| SignatureDoesNotMatch | The request signature we calculated does not match the signature you provided. Check your Secret Access Key and signing method. Consult the service documentation for details. | 400 Bad Request | Signature in the Authorization header doesn’t match server verification |
BLB service error code
| Error code | Error description | HTTP status code | Semantics |
|---|---|---|---|
| InstanceNotFound | The specified BLB instance does not exist. | 404 | The specified Load Balancer instance does not exist |
| ListenerNotFound | The specified listener does not exist. | 404 | The specified listener does not exist |
| BackendServerNotFound | The specified backend server does not exist. | 404 | The specified real server does not exist |
| ListenerAlreadyExist | Listener already exists. | 400 | The listener to be created already exists |
| BackendServerAlreadyExist | Backend server already exists. | 400 | The real server to be bound already exists |
| LastOperationNotFinished | Last operation has not finished. | 409 | The previous LoadBalancer request has not been processed |
| RealNameAuthenticationRequired | You need to pass real-name authentication. | 403 | The current user has not passed certification |
| QuotaExceeded | You have exceeded current quota. | 413 | BLB count exceeds user quota limit |
| ServerRequired | You must have at least one bcc, dcc or bbc to create BLB. | 404 | You must first have a BCC, DCC or BBC Instances before creating a BLB |
| ListenerExceeded | You can create at most 20 listeners per BLB instance. | 413 | You can create up to 20 listeners for each BLB instance. |
| ServiceBlocked | Your BLB service is blocked, please contact technical support for assistance. | 403 | BLB service is blocked. Please contact technical service personnel |
| InstanceCreationFailed | Fail to create blb instance. | 400 | Fail to create BLB instance, usually due to insufficient resources, insufficient user balance, etc. |
| MissingParameter | A required parameter 'parameterName' is not supplied. | 400 | The required parameter "parameterName" is missing in the request. |
| InvalidParameter | The parameter 'parameterName' is invalid. | 400 | The parameter "parameterName" is invalid |
| EipUnbindFailed | Fail to unbind EIP | 400 | Fail to unbind EIP |
| RedirectPortNotFound | The specified redirect port does not exist. | 404 | The specified HTTPS listener does not exist |
| CertificateNotFound | The specified certificate does not exist. | 404 | The specified certificate does not exist |
