错误格式

当 IMM 在处理请求时，若发生异常，返回值形如

{
  "Recommend": "https://error-center.aliyun.com/status/search?Keyword=InvalidMaxKeys&source=PopGw",
  "Message": "Specified parameter MaxKeys is not valid.",
  "RequestId": "772328B2-E5F4-453C-9C23-AAAAAAAAAAAA",
  "HostId": "imm.cn-beijing.aliyuncs.com",
  "Code": "InvalidMaxKeys"
}

且 HTTP 状态码也会相应变化。其中：

• Code 为错误码，提示错误类型。
• Message 为错误消息，提示错误的原因和解决办法。
• HostId 为您请求所在的 Region 对应的 Endpoint。如果您需要提工单咨询，请给到该值。
• RequestId 为请求的唯一 ID。如果您需要提工单咨询，请给到该值。
• Recommend 为快捷搜索链接，该字段非必选。

通用错误码表

以下列出了通用错误码表，涵盖大部分可能出现的错误。其中：

• {ParameterName} 和 {ResourceType} 在实际返回的响应中，分别对应 字段名称 和 资源类型 。
• HTTP Status Code 列为响应的 HTTP 状态码。
• Message 列中的信息可能与实际返回的响应略有不同，这通常是为了提示更具体的错误信息。

常见错误及处理

QuotaExhausted.CU

该提示说明当前请求的 API 频次，超过了创建 Project 时设置的的 CU 限制。

如果当前 Project 的计费方式是 按调用次数计费，即 BillingType = ByUsage，那么该 Project 的默认 CU 限制为 1 。您可以控制客户端请求的频率来解决该问题。

如果当前 Project 的计费方式是 按 QPS 计费，即 BillingType = ByCU，则可以通过 控制台 调整 CU 值，来获取更高的并发能力。调整 CU 通常需要数分钟生效。

两种计费方式无法转换，如有需要可以重新创建一个 Project 来切换到另外的计费方式。

InvalidParameter.TgtUrl

该提示说明 TgtUrl 参数错误。请确保您使用正确的 oss 路径（而不是 http / https ）。并且您拥有该 oss 路径的写权限。

SDK.InvalidRegionId

该提示说明您所选取的 Region 错误，关于 IMM 已开通的 Region ，请参考 这里 。同时请确保您所使用的 SDK 为最新版本。

Throttling.User

该提示说明您的 API 调用过于频繁，超过流量控制。与 CU 限制不同的是，该限制通常很大。请检查您的调用过程中是否存在循环。如果确实循环，请在其中加入 sleep 来控制频率。该限制触发后会在一定时间内解除。

InvalidProject.IsDeleting

这通常出现在您试图创建一个刚刚删除的同名 Project 时。由于 Project 涉及计费，因此删除后 24 小时内无法重新创建同名 Project 。建议您更换名称，或等待 24 小时后再试。

如有任何问题，欢迎 联系我们