全部產品
Search
文件中心

Cloud Control API:故障排除

更新時間:May 21, 2025

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

解決方案:建議重試,如果多次重試報錯請聯絡服務方或提交工單。