故障排除

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服务不可用。

解决方案:建议重试,如果多次重试报错请联系服务方或提交工单。