All Products
Search
Document Center

Cloud Control API:Troubleshooting

Last Updated:Feb 19, 2025

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.