Errors may occur when you call an API operation of Cloud ControlAPI. In this case, you can troubleshoot the error based on the error code. This topic describes the solutions to common error codes.
Error codes returned
Error codes are returned when exceptions occur in an Alibaba Cloud service.
The following two error codes may be returned when exceptions occur. You can view the error messages for troubleshooting. The following table describes the parameters in the error message.
Parameter | Type | Description |
requestId | String | The ID of the request. |
errorCode | String | The error code. |
errorMsg | String | The error message. |
OperationFailure.OperationFailed
Cause: Errors occur in the downstream Alibaba Cloud services that cause all API operations of related services to fail.
Solution: Identify the causes of errors based on the error codes and messages.
{
"requestId": "473469C7-AA6F-4DC5-B3DB-A3DC0DE3****",
"Code": "OperationFailure.OperationFailed",
"Message": "{
"requestId":"432654B9-BB7F-3AE6-76CF-A5DC0DE9****",
"errorCode": "MissingName",
"errorMsg": "Name is mandatory for this action."
}"
}OperationFailure.PartialOperationFailed
Cause: Errors occur in the downstream Alibaba Cloud services that cause some API operations of related services to fail.
Solution: Identify the causes of errors based on the error codes and messages.
In this case, you can call the GetResource operation to view the latest status of the resource. If necessary, you can call the UpdateResource or DeleteResource operation to manually compensate for the failure.
{
"requestId": "473469C7-AA6F-4DC5-B3DB-A3DC0DE3****",
"Code": "OperationFailure.PartialOperationFailed",
"Message": "{
"requestId":"432654B9-BB7F-3AE6-76CF-A5DC0DE9****",
"errorCode": "InvalidRamUser.NoPermission",
"errorMsg": "Ram user is not authorized to perform the operation."
}"
}Error codes returned
The error codes are returned when exceptions occur in Cloud ControlAPI.
InvalidRamUser.NoPermission
Cause: Permissions on Cloud ControlAPI are not granted to the RAM user.
Solution: Authorize the RAM user to call API operations of Cloud ControlAPI by attaching a system permission policy or granting the permission on the corresponding API.
InvalidRamRole.NoPermission
Cause: RAM permissions on Cloud ControlAPI are not granted to the RAM role.
Solution: Authorize the RAM role to call API operations of Cloud ControlAPI by attaching a system permission policy or granting the permission on the corresponding API.
InvalidResourceType.NotFound
Cause: The specified resource type does not exist or is invalid.
Solution: Check whether the resource type is misspelled or not supported.
InvalidOperation.NotSupported
Cause: The operation on the resource is not allowed. For example, some resources cannot be updated or deleted.
Solution: Do not perform this operation.
InvalidParameter.RequiredNotExisted
Cause: The required parameters of resource attributes are not specified.
Solution: Specify all the required parameters and call the API operation again.
InvalidParameter.EnumCheckFailure
Cause: The value of a parameter is not among the valid values.
Solution: Set the parameter to a valid value.
InvalidOperation.InvalidTaskStatus
Cause: The status of the task is not Pending or Running. You cannot cancel the task.
Solution: Do not cancel the task.
InvalidOperation.TaskNotCompleted
Cause: An asynchronous task that involves the resource is not complete. You cannot manage the resource.
Solution: Wait until the asynchronous task is complete. If the task times out, cancel it and perform the operation.
InvalidRegion.NotFound
Cause: The specified region is invalid.
Solution: Set the region parameter to a valid value.
Throttling, Throttling.API, and Throttling.User
Cause: Your traffic in this period reaches the upper limit.
Solution: Submit a ticket if your business requirements are not met.
InternalError
Cause: An internal error occurs in Cloud ControlAPI.
Solution: Try again later. If the error code is repeatedly returned, contact technical support or submit a ticket.
ServiceUnavailable
Cause: Cloud ControlAPI is unavailable.
Solution: Try again later. If the error code is repeatedly returned, contact technical support or submit a ticket.