文档

错误处理

更新时间:

通过本文您可以了解智能媒体管理请求发生错误时的错误格式、通用错误码和常见错误及处理。

错误格式

如果在处理请求时发生异常,则智能媒体管理会返回如下格式的错误信息。

{
    "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来控制频率。

该限制触发后会在一定时间内解除。

  • 本页导读 (1)
文档反馈