APIG的API错误码说明
当调用API时,可能遇到下表中的错误码。如果遇到“APIGW”开头的错误码,请参见API网关错误码进行处理。
错误码 |
错误信息 |
HTTP状态码 |
语义 |
解决方案 |
---|---|---|---|---|
APIG.0101 |
The API does not exist or has not been published in the environment. |
404 |
API不存在或未发布到环境 |
具体操作请参见常见问题。 |
APIG.0101 |
The API does not exist. |
404 |
API请求方法不存在 |
检查API请求方法是否与API定义的方法相同。 |
APIG.0103 |
The backend does not exist. |
500 |
无法找到后端 |
联系技术支持。 |
APIG.0104 |
The plug-ins do not exist. |
500 |
无法找到插件配置 |
联系技术支持。 |
APIG.0105 |
The backend configurations do not exist. |
500 |
无法找到后端配置 |
联系技术支持。 |
APIG.0106 |
Orchestration error. |
400 |
编排错误 |
检查API配置的前后端参数是否合理。 |
APIG.0107 |
The custom lua script encountered an unexpected error |
500 |
Lua脚本发生未知错误 |
联系技术支持。 |
APIG.0201 |
API request error. |
400 |
请求格式不合法 |
检查请求格式是否合法。 |
APIG.0201 |
Request entity too large. |
413 |
请求body过大(大于12M) |
减小请求body大小。 |
APIG.0201 |
Request URI too large. |
414 |
请求URI过大(大于32K) |
减小请求URI大小。 |
APIG.0201 |
Request headers too large. |
494 |
请求头过大(单个请求头大于32K或所有请求头总长度大于128K) |
减小请求头大小。 |
APIG.0201 |
Backend unavailable. |
502 |
后端不可用 |
具体操作请参见常见问题。 |
APIG.0201 |
Backend timeout. |
504 |
后端超时 |
编辑API增大超时时间,或缩小后端的处理时间。 |
APIG.0201 |
An unexpected error occurred |
500 |
内部错误 |
联系技术支持。 |
APIG.0202 |
Backend unavailable |
502 |
后端不可用 |
检查API配置的后端请求协议与后端服务请求协议是否一致。 |
APIG.0203 |
Backend timeout |
504 |
后端超时 |
编辑API增大超时时间,或缩小后端的处理时间。 |
APIG.0204 |
SSL protocol is not supported: TLSv1.1 |
400 |
SSL协议版本不支持 |
使用支持的SSL协议版本,当前支持TLS1.1和TLS1.2,推荐使用TLS1.2。 |
APIG.0205 |
Verify client certificate failed |
400 |
客户端证书校验失败 |
检查客户端证书是否正确。 |
APIG.0301 |
Incorrect IAM authentication information. |
401 |
IAM认证信息错误 |
检查请求的方法、路径、查询参数、请求体和签名使用的方法、路径、查询参数、请求体是否一致;检查客户端机器时间是否正确。请参见常见问题。 |
APIG.0302 |
The IAM user is not authorized to access the API. |
403 |
IAM用户不允许访问API |
检查用户是否被黑白名单限制。 |
APIG.0303 |
Incorrect app authentication information. |
401 |
APP认证信息错误 |
检查请求的方法、路径、查询参数、请求体和签名使用的方法、路径、查询参数、请求体是否一致;检查客户端机器时间是否正确。请参见常见问题。 |
APIG.0304 |
The app is not authorized to access the API. |
403 |
APP不允许访问API |
检查凭据是否绑定API,或API是否授权给凭据。 |
APIG.0305 |
Incorrect authentication information. |
401 |
认证信息错误 |
检查认证信息是否正确。 |
APIG.0306 |
API access denied. |
403 |
不允许访问API |
检查是否授权访问API。 |
APIG.0307 |
The token must be updated. |
401 |
token需要更新 |
重新从IAM获取token。 |
APIG.0308 |
The throttling threshold has been reached. |
429 |
超出流控值限制 |
等待流控刷新后访问。如果触发调试域名的单日请求数上限,请绑定独立域名。 |
APIG.0310 |
The project is unavailable. |
403 |
project不可使用 |
使用其他project访问。 |
APIG.0311 |
Incorrect debugging authentication information. |
401 |
调试认证信息错误 |
联系技术支持。 |
APIG.0312 |
Incorrect third-party authentication information,auth fail |
401 |
第三方认证信息错误,认证失败 |
检查身份信息是否正确。 |
APIG.0313 |
Incorrect third-party authentication information,identities error |
401 |
第三方认证信息错误,身份错误 |
检查请求中身份信息与第三方认证插件中身份来源设置是否一致。 |
APIG.0314 |
Incorrect third-party authentication information,access deny |
403 |
第三方认证信息错误,访问拒绝 |
联系技术支持确认请求来源是否为业务请求,如果是,则提高第三方认证插件的防爆力拦截阈值以解决。 |
APIG.0401 |
Unknown client IP address. |
403 |
无法识别客户端IP地址 |
联系技术支持。 |
APIG.0402 |
The IP address is not authorized to access the API. |
403 |
IP地址不允许访问 |
检查IP地址是否被API的访问控制限制。 |
APIG.0403 |
The IP address cannot be accessed. |
403 |
IP地址不允许访问 |
检查IP地址是否被实例级访问控制限制。 |
APIG.0404 |
Access to the backend IP address has been denied. |
403 |
后端IP不允许访问 |
后端IP地址或后端域名对应的IP地址不允许访问。 |
APIG.0405 |
The app is not accessed from a trusted IP address. |
403 |
未从受信任的IP地址访问应用程序 |
检查源IP是否在访问控制策略中配置了允许或者拒绝。 |
APIG.0501 |
The app quota has been used up. |
405 |
APP已经超出配额 或云市场调用次数用完 |
购买APP配额。 或重新购买云市场调用次数。 |
APIG.0502 |
The app has been frozen. |
405 |
APP被冻结 |
余额不足。 |
APIG.0601 |
Internal server error. |
500 |
内部错误 |
联系技术支持。 |
APIG.0602 |
Bad request. |
400 |
非法请求 |
检查请求是否合法。 |
APIG.0605 |
Domain name resolution failed. |
500 |
域名解析失败 |
检查域名拼写,以及域名是否绑定了正确的后端地址。 |
APIG.0606 |
Failed to load the API configurations. |
500 |
未加载API配置 |
联系技术支持。 |
APIG.0607 |
The following protocol is supported: {xxx} |
400 |
协议不被允许,允许的协议是xxx。 注意:xxx以实际响应中的内容为准。 |
改用支持的协议(HTTP/HTTPS)访问。 |
APIG.0608 |
Failed to obtain the admin token. |
500 |
无法获取管理账户 |
联系技术支持。 |
APIG.0609 |
The VPC backend does not exist. |
500 |
找不到负载后端 |
联系技术支持。 |
APIG.0610 |
No backend available. |
502 |
没有可连接的后端 |
检查所有后端是否可用,如调用信息与实际配置是否一致。 |
APIG.0611 |
The backend port does not exist. |
500 |
后端端口未找到 |
联系技术支持。 |
APIG.0612 |
An API cannot call itself. |
500 |
API调用自身 |
修改API后端配置,递归调用层数不能超过10层。 |
APIG.0613 |
The IAM service is currently unavailable. |
503 |
IAM服务暂时不可用 |
联系技术支持。 |
APIG.0615 |
Incorrect third-party authentication VPC information |
500 |
获取第三方鉴权负载通道节点失败 |
检查第三方认证的负载通道配置是否正确。 |
APIG.0616 |
Incorrect third-party authentication request information |
500 |
连接第三方鉴权服务失败 |
检查第三方认证服务是否正常。 |
APIG.0617 |
Incorrect third-party authentication response information |
500 |
获取第三方鉴权服务响应失败 |
检查第三方认证服务是否正常。 |
APIG.0705 |
Backend signature calculation failed. |
500 |
计算后端签名失败 |
联系技术支持。 |
APIG.0802 |
The IAM user is forbidden in the currently selected region |
403 |
该IAM用户在当前region中被禁用 |
联系技术支持。 |
APIG.2102 |
PublicKey is null |
400 |
签名密钥未找到 |
联系技术支持。 |
APIG.2201 |
Appkey or SecretKey is invalid |
400 |
Appkey或SecretKey不合法 |
检查请求的Appkey或SecretKey是否正确。 |
APIG.2202 |
Refresh token is invalid |
400 |
Refresh token不合法 |
检查Refresh token是否正确。 |
APIG.2203 |
Access token is invalid |
400 |
Access token不合法 |
检查Access token是否正确。 |
APIG.2204 |
ContentType invalid |
400 |
ContentType不合法 |
检查ContentType是否正确 |
APIG.2205 |
Auth parameter invalid |
400 |
认证参数不合法 |
检查认证参数是否正确。 |
APIG.2206 |
Auth method invalid |
400 |
认证方法不合法 |
检查认证方法是否正确。 |
APIG.2208 |
The length of through_data is out of range |
400 |
through_data超长 |
through_data长度上限为300,根据实际情况调整through_data内容。 |
APIG.2209 |
The value of grant_type is not in enum List |
400 |
grant_type的值不合法 |
grant_type只支持client_credentials、refresh_token,根据实际情况修改。 |
APIG.2210 |
Lack of grant_type |
400 |
缺少授权类型 |
添加grant_type。 |
APIG.2211 |
Lack of client_id |
400 |
缺少客户端ID |
添加客户端ID。 |
APIG.2212 |
Lack of client_secret |
400 |
缺少客户端密钥 |
添加客户端密钥。 |
APIG.2213 |
Lack of refresh_token |
400 |
缺少refresh token |
联系技术支持。 |
APIG.1001 |
Refresh token is expired |
401 |
Refresh token过期 |
重新获取refresh token。 |
APIG.1002 |
Access token is expired |
401 |
Access token过期 |
重新获取access token。 |
APIG.1003 |
App not match refresh token |
401 |
App与refresh token不匹配 |
检查client_id是否正确。 |
APIG.1004 |
App not exist |
401 |
App不存在 |
检查access token是否正确。 |
APIG.1009 |
AppKey or AppSecret is invalid |
400 |
AppKey或AppSecret不合法 |
检查请求的AppKey或AppSecret是否与凭据的Key或Secret相同。 |