CC API在调用时可能会遇到一些错误,遇到错误时以错误码为依据进行故障排除,本文为您介绍常见错误码的解决方案。
云产品运行时错误码
云产品API运行时返回的错误码。
以下两个错误码为云产品运行时错误,如想获取云产品详细错误信息,需进一步解析Message(结构如下)。
名称 | 类型 | 描述 |
requestId | String | 云产品报错API的requestId |
errorCode | String | 云产品错误码 |
errorMsg | String | 云产品错误信息 |
OperationFailure.OperationFailed
原因:下游云产品服务出错,运行全部失败。
解决方案:解析具体的错误信息,进一步根据其中云产品的错误码和错误信息,判断云产品报错原因。
{
"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
原因:下游云产品服务出错,运行部分失败。
解决方案:解析具体的错误信息,进一步根据其中云产品的错误码和错误信息,判断云产品报错原因。
当用户遇到部分失败时,可调用GetResource API查看资源最新的状态,如果有必要可调用UpdateResource或DeleteResource进行手动补偿。
{
"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."
}"
}
CloudControl错误码
CloudControlAPI自身服务返回的错误码。
InvalidRamUser.NoPermission
原因:该RAM子账号未进行CC API的RAM授权
解决方案:授予该账号CC API的RAM权限,可授予系统权限策略或者对应API的权限。
InvalidRamRole.NoPermission
原因:该RAM角色未进行CC API的RAM授权
解决方案:授予该角色CC API的RAM权限,可授予系统权限策略或者对应API的权限。
InvalidResourceType.NotFound
原因:用户传入的资源类型不存在或尚未支持。
解决方案:检查资源类型是否拼写错误,需要在支持的资源类型范围内。
InvalidOperation.NotSupported
原因:该资源不支持此操作,例如某些资源不支持更新或删除操作。
解决方案:无需进行本次操作。
InvalidParameter.RequiredNotExisted
原因:资源属性中有必填参数没有传入。
解决方案:根据报错信息,将未传入的属性添加后重新调用。
InvalidParameter.EnumCheckFailure
原因:有参数的值不在指定的枚举值范围中。
解决方案:根据报错信息,将对应属性的值调整为被允许的值。
InvalidOperation.InvalidTaskStatus
原因:该任务的状态不是Pending或者Running,不支持取消任务操作。
解决方案:该任务无需取消。
InvalidOperation.TaskNotCompleted
原因:本次操作的资源存在未完成的异步任务,无法进行操作。
解决方案:等待该资源未完成的异步任务完成再进行下一步操作,如果上次异步任务超时,可以取消掉再进行下一步资源操作。
InvalidRegion.NotFound
原因:对应的云产品不支持传入的region参数。
解决方案:重新传入该产品支持的region调用。
Throttling、Throttling.Api 、Throttling.User
原因:您这个时段的流量已经超限。
解决方案:如果不能满足现有业务要求可以提工单进行申请。
InternalError
原因:CC API服务内部错误。
解决方案:建议重试,如果多次重试报错请联系服务方或提交工单。
ServiceUnavailable
原因:CC API服务不可用。
解决方案:建议重试,如果多次重试报错请联系服务方或提交工单。