通過本文您可以了解智能媒體管理請求發生錯誤時的錯誤格式、通用錯誤碼和常見錯誤及處理。
錯誤格式
如果在處理請求時發生異常，則智能媒體管理會返回如下格式的錯誤信息。
{
"RequestId": "D18E94DF-1D00-0B75-811E-****",
"HostId": "imm.cn-hangzhou.aliyuncs.com",
"Code": "InvalidArgument",
"Message": "The parameter ProjectName is required but not provided.",
"Recommend": "https://next.api.aliyun.com/troubleshoot?q=InvalidArgument&product=imm"
}HTTP狀態碼也會相應變化，錯誤信息的參數說明請參見下表。
參數 | 描述 |
RequestId | 當次請求的Request ID。 如果請求失敗需要提供幫助，請使用釘釘搜索釘釘群號31690030817加入釘釘群進行反饋。 |
HostId | 請求所在的地域對應的Endpoint。 如果請求失敗需要提供幫助，請使用釘釘搜索釘釘群號31690030817加入釘釘群進行反饋。 |
Code | 錯誤碼，提示錯誤類型。 |
Message | 錯誤消息，提供錯誤的原因和解決辦法。 |
Recommend | 快捷搜索鏈接。 |
通用錯誤碼
下表列出了通用錯誤碼，涵蓋大部分可能出現的錯誤。
HTTP Status Code列為響應的HTTP狀態碼。
Code列為錯誤碼，其中{ParameterName}和{ResourceType}在實際返回的響應中分別對應參數名稱和資源類型。
Message列為更具體的錯誤信息。錯誤信息可能與實際返回的響應略有不同。
HTTP Status Code | Code | Message示例 | 描述 |
400 | InvalidArgument | %s | 參數不合法，請參考文檔設置參數值。 |
400 | Missing{ParameterName} | {ParameterName} is mandatory for this action. | 參數缺失，執行該操作時必須設置對應參數。 |
400 | LimitExceededError | Message: input quota exceed the max value | 輸入的參數值不合法，超出合法范圍。 |
400 | LimitExceededError | Message: resource count exceeds the limit | 資源數量超出限制，請檢查。 |
400 | Invalid{ParameterName} | Specified parameter {ParameterName} is not valid. | 參數不合法。 |
400 | ResourceAlreadyExists | The specified resource {ResourceType} already exists. | 資源已經存在，請檢查。 |
400 | ResourceNotFound | The specified resource {ResourceType} is not found. | 資源不存在，請檢查。 |
400 | InvalidJSON Array parsing error，{ParameterName} | Specified parameter JSON Array parsing error, {ParameterName} is not valid. | 參數值JSON解析錯誤，不是正確的JSON格式。 |
400 | MalformedPOSTRequest | Invalid json string. | 請求的格式錯誤。 |
403 | AccessDenied | %s | 訪問權限錯誤，沒有訪問權限。 |
400 | Throttling.Api | The request was denied due to flow control. | API請求調用頻率太高，觸發API QPS限流。 |
400 | Throttling.User | Request was denied due to user flow control. | API請求調用頻率太高，觸發用戶QPS限流。 |
409 | StatusConflict | %s | 狀態沖突。 |
400 | Invalid{ResourceType}.Unsupported | The resource {ResourceType} is not supported. Please check. | 資源類型不支持，請檢查。 |
400 | Invalid{ResourceType}.DownloadFailed | The resource {ResourceType} can not be downloaded. Please check. | 資源類型不能下載，請檢查。 |
403 | Forbidden.AccountNotFound | The specified account does not exist. Please check your account. | 指定賬號不存在，請檢查賬號是否正確。 |
403 | Forbidden.AccountInDebt | The specified account is in debt. Please check your permission. | 指定賬號已欠費，請檢查賬號的權限。 |
403 | Forbidden.ServiceRole | Cannot access specified service role. Please check your permission. | 不能訪問指定的服務角色，請檢查賬號的權限。 |
403 | Forbidden.RiskControl | This operation is forbidden by Alibaba Cloud RiskControl system. Please check. | 阿里云風險控制系統禁止此操作。 |
403 | Forbidden | User not authorized to operate on the specified APIs. Please check your permission. | 用戶未被授權使用指定API進行操作，請檢查賬號的權限。 |
400 | StateConflict | User operation is not valid. Please try again later. | 操作不合法，請稍后重試。 |
408 | Timeout | Request timed out. Please try again later. | 請求超時，請稍后重試。 |
500 | InternalError | The request has been failed due to some unknown error. Please try again later. | 由于未知原因請求失敗，請稍后重試。 |
405 | HTTPMethodNotAllowed | The request http method is not supported for this resource. Please refer to document. | 資源不支持HTTP方式的請求，請參考文檔設置。 |
503 | ServiceUnavailable | The request has failed due to a temporary failure of the server. Please try again later. | 由于服務器臨時故障請求失敗，請稍后重試。 |
503 | ServiceUnavailable.RegionMaintaining | System maintenance is in progress on the selected region. Please wait a few minutes before trying again. | 所選地域的系統正在維護中，請等待幾分鐘再重試操作。 |
400 | STSAccessError | STS access error. Please check your permission. | 訪問STS錯誤，請檢查賬號的權限。 |
400 | OSSAccessError | OSS access error. Please check your permission. | 訪問OSS錯誤，請檢查賬號的權限。 |
403 | Throttling | The request project is blocked due to throttling control. Please wait a few minutes before trying again. | 由于流控原因，請求的項目處于阻塞狀態，請等待幾分鐘再操作。 |
400 | ContentMD5NotMatched | Specified content md5 is not matched with your request body. | MD5校驗不通過。 |
400 | EntityTooLarge | The payload size exceeds maximum allowed size (%s bytes). | 實體過大。 |
400 | IllegalTimestamp | The input parameter \"Timestamp\" that is mandatory for processing this request is not supplied. | 參數Timestamp不合法。 |
400 | IncompleteSignature | The request signature does not conform to Aliyun standards. | 簽名不匹配。 |
400 | InvalidAction | Specified action is not valid. | 操作不合法。 |
400 | InvalidProtocolNeedSsl | Your request is denied as lack of ssl protect. | API只支持HTTPS協議。 |
400 | InvalidSecurityTokenExpired | Specified SecurityToken is expired. | SecurityToken已過期。 |
400 | InvalidSecurityTokenMalformed | Specified SecurityToken is malformed. | SecurityToken錯誤。 |
400 | InvalidSecurityTokenMismatchWithAccessKey | Specified SecurityToken mismatch with the AccessKey. | SecurityToken與AccessKey不匹配。 |
400 | InvalidSignatureMethod | Specified parameter signature method is not valid. | 簽名方法不支持。 |
400 | InvalidTimeStampExpired | Specified time stamp or date value is expired. | 用戶請求時間和服務器接收到請求的時間間隔大于15分鐘。 |
400 | InvalidTimeStampFormat | Specified time stamp or date value is not well formatted. | 時間戳格式不正確。 |
400 | MissingRequiredHeader | The required HTTP header %s was not specified. | 缺少必要的請求Header。 |
400 | SignatureNonceUsed | Specified signature nonce was used already. | 指定的簽名已被使用。 |
400 | SignatureNotMatch | Specified signature is not matched with our calculation. | 簽名不匹配，AccessKey ID或AccessKey Secret配對錯誤。 |
400 | UnsupportedAction | The requested action '%s' is not supported. Please check. | 不支持的操作，請檢查。 |
400 | UnsupportedAPIVersion | The requested API version '%s' is not supported yet. Please check. | 不支持的API版本，請檢查。 |
403 | ForbiddenAccessDenied | Request was denied due to isolation policy. | 請求被隔離策略拒絕。 |
403 | ForbiddenAccessKeyDisabled | The Access Key is disabled. | AccessKey無效。 |
403 | ForbiddenProductDisabled | The target product is not enabled, try to enable it using web console or OpenAPI first. | 目標產品未啟用，請嘗試在Web控制臺或OpenAPI啟用。 |
403 | InvalidAccessKeyID | Invalid access key ID '%s'. | AccessKey ID無效。 |
403 | InvalidAccessKeyIDInactive | Specified access key is disabled. | AccessKey已被禁用。 |
403 | UnsupportedSignatureMethod | This signature method is not supported. | 簽名方法不支持。 |
403 | UnsupportedSignatureType | This signature type is not supported. | 簽名類型不支持。 |
404 | InvalidAccessKeyIDNotFound | Specified access key is not found. | AccessKey不存在。 |
412 | PreconditionFailed | The resource to be modified has been changed. | 資源更新失敗，該資源可能已被更改。 |
415 | UnsupportedMediaType | The content type must be 'application/x-www-form-urlencoded'. | 請求消息體類型錯誤。 |
常見錯誤及處理
常見錯誤 | 產生原因 | 處理方法 |
QuotaExhausted.CU | 當前請求的API頻次，超過了創建Project時設置的CU限制。 | 該Project的默認CU限制為10，您可以控制客戶端請求的頻率來解決該問題。 |
SDK.InvalidRegionId | 選擇的Region錯誤。 | 請確保已設置正確的地域同時使用的SDK為最新版本。 關于智能媒體管理已開通的Region請參見各地域支持的功能。 |
Throttling.Api | API調用過于頻繁，超過API流量控制。 | 請檢查調用過程中是否存在循環。如果存在循環，請加入sleep來控制頻率。 該限制觸發后會在一定時間內解除。 |
Throttling.User | API調用過于頻繁，超過用戶流量控制。 | 請檢查調用過程中是否存在循環。如果存在循環，請加入sleep來控制頻率。 該限制觸發后會在一定時間內解除。 |