Errors
Error codes
Converge Cloud answers HTTP 200 for errors as well as successes. The discriminator is the presence of Response.Error, not the status code.
Match on Code, never on Message
Messages are returned in Chinese on vpc and in English elsewhere, and can vary between actions within a service. Code is stable. Test for the presence of the Error object rather than a non-empty Code — Converge Cloud occasionally returns an error whose code is the empty string.
Observed codes
Every code below was returned by a real call to Converge Cloud. This is not the complete set the platform can emit: an action can return a code that is not listed here.
| Code | Example message | Seen on |
|---|---|---|
| FailedOperation | Upload certificate failed, please check that the certificate meets the standard. | |
| InternalError | Phase 2 [getClusterInformation]: get cluster cls-00000000 failed ,err: clusters.platform.tkestack.io "cls-00000000" not found | |
| InternalError.SystemError | record not found | |
| InvalidAction | [Type 3001] the request action=`AcceptDirectConnectTunnel` is invalid or not found in service=`dc` and version=`2018-04-10` | |
| InvalidAddressId.StatusNotPermit | The status `"BIND_ENI"` for AddressId `"eip-f72l2q9u"` is not permit to do this operation. | |
| InvalidImageId.NotFound | ImageId img-00000000 is not found | |
| InvalidInstanceId.NotFound | The specified instance ID `['ins-00000000']` is not found. | |
| InvalidKeyPairId.Malformed | The specified key pair ID `.KeyIds` `skp-00000000` is malformed. Ensure that you provide the full key pair ID in the request, in the form skey-xxxxxxxx.The lett | |
| InvalidLaunchConfigurationId.NotFound | The specified launch configuration id `asc-00000000` is not found. | |
| InvalidParameter | LoadBalancer not exist | |
| InvalidParameter.Coexist | 请求中不支持同时传入参数 `Egress and Ingress`。 | |
| InvalidParameter.DcResourceNotFound | apply[dc-00000000] is not existent | |
| InvalidParameter.LBIdNotFound | LoadBalancerId `lb-00000000` not found. | |
| InvalidParameter.ParamError | ResourceNotFound.PolicyIdNotFound:policy id is not exist | |
| InvalidParameter.PolicyDocument | invalid policy document | |
| InvalidParameter.RoleName | invalid param RoleName | |
| InvalidParameter.RoleNotExist | Role not exist. | |
| InvalidParameterValue | %v 必填参数缺失 | |
| InvalidParameterValue.LaunchConfigurationNotFound | The specified launch configuration `asc-00000000` is not found. | |
| InvalidParameterValue.Length | The length of CertificateId 'cert-00000000' is not valid. | |
| InvalidParameterValue.ResourceDescriptionError | resource error,resource uin not equal uin,resource uin:100000000001 uin:100000000001 | |
| MissingParameter | The request is missing a required parameter `DiskType`. | |
| OperationDenied | 未查询到可扫描的机器 | |
| ResourceInUse | 指定资源 `sg-7timlyva` 已经在使用中。 | |
| ResourceNotFound | policy not found | |
| ResourceNotFound.AutoScalingGroupNotFound | The specified auto scaling group `asg-00000000` is not found. | |
| ResourceNotFound.InvalidPlacementSet | Invalid placement set `ps-00000000`. | |
| ResourceNotFound.PolicyIdNotFound | policy id is not exist | |
| ResourceNotFound.RecordNotExist | resource records not found | |
| unknow | tagKey invalid. | |
| UnknownParameter | failed to get subnet | |
| UnsupportedOperation | 404 | |
| UnsupportedOperation.InstanceStateRebooting | The request does not support the instance `ins-6l9ee4b2` which is in the state of `REBOOTING`. | |
| UnsupportedOperation.InstanceStateRunning | The request does not support the instance `ins-6l9ee4b2` which is in the state of `RUNNING`. |
Reading a verdict
| InvalidAction | The action does not exist on Converge Cloud — or the X-TC-Version is wrong for that service, which produces the identical error. |
| UnauthorizedOperation | The action exists and is deployed; this credential is not permitted to call it. |
| InvalidParameter, MissingParameter, InvalidParameterValue | The action exists and parsed the request. The request itself is at fault. |
| ResourceNotFound | The action exists and the request was well formed; the resource named does not exist. |
| AuthFailure | Signature or credential problem — including a clock more than 300 seconds from the server's. |
| InternalError | A server-side fault. A single retry is recommended. If the message names a resource from the request, the action parsed the request. |