更新时间:2023-05-22 GMT+08:00

错误码说明

当您使用各云服务的API时,如果遇到“APIGW”开头的错误码,请参考如下语义与解决方案进行处理。

表1 错误码

错误码

错误信息

HTTP状态码

语义

解决方案

APIGW.0101

The API does not exist or has not been published in the environment.

404

API不存在或未发布到环境

请参考"The API does not exist or has not been published in the environment."如何解决?处理

APIGW.0101

The API does not exist.

404

API请求方法不存在

检查API请求方法是否与API定义的方法相同

APIGW.0103

The backend does not exist.

404

无法找到后端

联系技术支持

APIGW.0104

The plug-ins do not exist.

400

无法找到插件配置

联系技术支持

APIGW.0105

The backend configurations do not exist.

400

无法找到后端配置

联系技术支持

APIGW.0106

Orchestration error.

400

编排错误

检查API配置的前后端参数是否合理

APIGW.0201

API request error.

400

请求格式不合法

使用合法的请求

APIGW.0201

Request entity too large.

413

请求body过大(大于12M)

减小请求body大小

APIGW.0201

Request URI too large.

414

请求URI过大

减小请求URI大小

APIGW.0201

Request headers too large.

494

请求头过大

减小请求头大小

APIGW.0201

Backend unavailable.

502

后端不可用

检查API配置的后端地址是否可用

APIGW.0201

Backend timeout.

504

后端超时

增大超时时间或缩小后端的处理时间

APIGW.0301

Incorrect IAM authentication information.

401

IAM认证信息错误

请参考IAM认证信息错误处理

APIGW.0302

The IAM user is not authorized to access the API.

403

IAM用户不允许访问API

检查用户是否被黑/白名单限制

APIGW.0303

Incorrect app authentication information.

401

APP认证信息错误

APP签名认证时,做如下检查:

  • 检查请求的方法、路径、查询参数、请求体和签名使用的方法、路径、查询参数、请求体是否一致
  • 检查客户端机器时间是否正确

请参考使用APP认证调用API检查签名代码的问题。

APPCODE简易认证时,做如下检查:检查请求是否携带了X-Apig-AppCode头域

APIGW.0304

The app is not authorized to access the API.

403

APP不允许访问API

检查APP是否授权访问API

APIGW.0305

Incorrect authentication information.

401

认证信息错误

检查认证信息是否正确

APIGW.0306

API access denied.

403

不允许访问API

检查是否授权访问API

APIGW.0307

The token must be updated.

401

Token需要更新

  • 重新从IAM服务获取Token
  • 也有可能是调用了不同region的接口,导致判断为Token失效,建议检查接口URL

APIGW.0308

The throttling threshold has been reached.

429

超出流控值限制

  • 等待流控刷新后访问。默认每个API每秒最多访问200次
  • 云服务开放的API,一般无法调整限额,请等待流控刷新后访问
  • 您在API网关服务中自行创建API,如需调整限额,请提工单联系技术支持

APIGW.0310

The project is unavailable.

403

project不可使用

使用其他project访问

APIGW.0311

Incorrect debugging authentication information.

401

调试认证信息错误

联系技术支持

APIGW.0401

Unknown client IP address.

403

无法识别客户端IP地址

联系技术支持

APIGW.0402

The IP address is not authorized to access the API.

403

IP地址不允许访问

检查IP地址是否被黑/白名单限制

APIGW.0404

Access to the backend IP address has been denied.

403

后端IP不允许访问

后端IP地址或后端域名对应的IP地址不允许访问,请检查IP地址是否被黑/白名单限制,或检查对应后端IP是否存在

APIGW.0501

The app quota has been used up.

405

APP已经超出配额

购买APP配额

APIGW.0502

The app has been frozen.

405

APP被冻结

余额不足,请前往“资金管理”充值。

APIGW.0601

Internal server error.

500

内部错误

联系技术支持

APIGW.0602

Bad request.

400

非法请求

检查请求是否合法

APIGW.0605

Domain name resolution failed.

500

域名解析失败

检查域名拼写,以及域名是否绑定了正确的后端地址

APIGW.0606

Failed to load the API configurations.

500

未加载API配置

联系技术支持

APIGW.0607

The following protocol is supported: {xxx}

400

协议不被允许,允许的协议是xxx

注意:xxx以实际响应中的内容为准

改用支持的协议(HTTP/HTTPS)访问

APIGW.0608

Failed to obtain the admin token.

500

无法获取管理租户

联系技术支持

APIGW.0609

The VPC backend does not exist.

500

找不到vpc后端

联系技术支持

APIGW.0610

No backend available.

502

没有可连接的后端

检查所有后端是否可用

APIGW.0611

The backend port does not exist.

500

后端端口未找到

联系技术支持

APIGW.0612

An API cannot call itself.

500

API调用自身

修改API后端配置,递归调用层数不能超过10层

APIGW.0613

The IAM service is currently unavailable.

503

IAM服务暂时不可用

联系技术支持

APIGW.0705

Backend signature calculation failed.

500

计算后端签名失败

联系技术支持

APIGW.0801

The service is unavailable in the currently selected region.

403

服务在当前region不可访问

检查所访问的服务是否支持跨region访问

APIGW.0802

The IAM user is forbidden in the currently selected region.

403

该IAM用户在当前region中被禁用

联系技术支持