通过本文您可以了解智能媒体管理请求发生错误时的错误格式、通用错误码和常见错误及处理。
错误格式
如果在处理请求时发生异常，则智能媒体管理会返回如下格式的错误信息。
{
"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来控制频率。 该限制触发后会在一定时间内解除。 |