Compute
Elastic Cloud Server
Huawei Cloud Flexus
Bare Metal Server
Auto Scaling
Image Management Service
Dedicated Host
FunctionGraph
Cloud Phone Host
Huawei Cloud EulerOS
Networking
Virtual Private Cloud
Elastic IP
Elastic Load Balance
NAT Gateway
Direct Connect
Virtual Private Network
VPC Endpoint
Cloud Connect
Enterprise Router
Enterprise Switch
Global Accelerator
Management & Governance
Cloud Eye
Identity and Access Management
Cloud Trace Service
Resource Formation Service
Tag Management Service
Log Tank Service
Config
OneAccess
Resource Access Manager
Simple Message Notification
Application Performance Management
Application Operations Management
Organizations
Optimization Advisor
IAM Identity Center
Cloud Operations Center
Resource Governance Center
Migration
Server Migration Service
Object Storage Migration Service
Cloud Data Migration
Migration Center
Cloud Ecosystem
KooGallery
Partner Center
User Support
My Account
Billing Center
Cost Center
Resource Center
Enterprise Management
Service Tickets
HUAWEI CLOUD (International) FAQs
ICP Filing
Support Plans
My Credentials
Customer Operation Capabilities
Partner Support Plans
Professional Services
Analytics
MapReduce Service
Data Lake Insight
CloudTable Service
Cloud Search Service
Data Lake Visualization
Data Ingestion Service
GaussDB(DWS)
DataArts Studio
Data Lake Factory
DataArts Lake Formation
IoT
IoT Device Access
Others
Product Pricing Details
System Permissions
Console Quick Start
Common FAQs
Instructions for Associating with a HUAWEI CLOUD Partner
Message Center
Security & Compliance
Security Technologies and Applications
Web Application Firewall
Host Security Service
Cloud Firewall
SecMaster
Anti-DDoS Service
Data Encryption Workshop
Database Security Service
Cloud Bastion Host
Data Security Center
Cloud Certificate Manager
Edge Security
Managed Threat Detection
Blockchain
Blockchain Service
Web3 Node Engine Service
Media Services
Media Processing Center
Video On Demand
Live
SparkRTC
MetaStudio
Storage
Object Storage Service
Elastic Volume Service
Cloud Backup and Recovery
Storage Disaster Recovery Service
Scalable File Service Turbo
Scalable File Service
Volume Backup Service
Cloud Server Backup Service
Data Express Service
Dedicated Distributed Storage Service
Containers
Cloud Container Engine
SoftWare Repository for Container
Application Service Mesh
Ubiquitous Cloud Native Service
Cloud Container Instance
Databases
Relational Database Service
Document Database Service
Data Admin Service
Data Replication Service
GeminiDB
GaussDB
Distributed Database Middleware
Database and Application Migration UGO
TaurusDB
Middleware
Distributed Cache Service
API Gateway
Distributed Message Service for Kafka
Distributed Message Service for RabbitMQ
Distributed Message Service for RocketMQ
Cloud Service Engine
Multi-Site High Availability Service
EventGrid
Dedicated Cloud
Dedicated Computing Cluster
Business Applications
Workspace
ROMA Connect
Message & SMS
Domain Name Service
Edge Data Center Management
Meeting
AI
Face Recognition Service
Graph Engine Service
Content Moderation
Image Recognition
Optical Character Recognition
ModelArts
ImageSearch
Conversational Bot Service
Speech Interaction Service
Huawei HiLens
Video Intelligent Analysis Service
Developer Tools
SDK Developer Guide
API Request Signing Guide
Terraform
Koo Command Line Interface
Content Delivery & Edge Computing
Content Delivery Network
Intelligent EdgeFabric
CloudPond
Intelligent EdgeCloud
Solutions
SAP Cloud
High Performance Computing
Developer Services
ServiceStage
CodeArts
CodeArts PerfTest
CodeArts Req
CodeArts Pipeline
CodeArts Build
CodeArts Deploy
CodeArts Artifact
CodeArts TestPlan
CodeArts Check
CodeArts Repo
Cloud Application Engine
MacroVerse aPaaS
KooMessage
KooPhone
KooDrive
On this page

Show all

Error Codes

Updated on 2023-05-06 GMT+08:00

Table 1 lists the error codes that you may encounter when calling APIs. If an error code starting with APIGW is returned after you call an API, rectify the fault by referring to the instructions provided in Error Codes.

NOTE:
  • For details about the error codes that may occur when you manage APIs, see Error Codes.
  • If an error occurs when you use APIG, find the error message and description in the following table according to the error code, for example, APIG.0101. The error messages are subject to change without prior notice.
Table 1 Error codes

Error Code

Error Message

HTTP Status Code

Description

Solution

APIG.0101

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

404

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

Check whether the domain name, method, and path are consistent with those of the registered API. Check whether the API has been published. If it has been published in a non-production environment, check whether the X-Stage header in the request is the environment name. Check whether the domain name used to call the API has been bound to the group to which the API belongs.

APIG.0101

The API does not exist.

404

The API request method does not exist.

Check whether the API request method is the same as the method defined by the API.

APIG.0103

The backend does not exist.

500

The backend service was not found.

Contact technical support.

APIG.0104

The plug-ins do not exist.

500

No plug-in configurations were found.

Contact technical support.

APIG.0105

The backend configurations do not exist.

500

No backend configurations were found.

Contact technical support.

APIG.0106

Orchestration error.

400

An orchestration error occurred.

Check whether the frontend and backend parameters of the API are correct.

APIG.0201

API request error.

400

Invalid request parameters.

Set valid request parameters.

APIG.0201

Request entity too large.

413

The request body exceeds 12 MB.

Reduce the size of the request body.

APIG.0201

Request URI too large.

414

The request URI exceeds 32 KB.

Reduce the size of the request URI.

APIG.0201

Request headers too large.

494

The request headers are too large because one of them exceeds 32 KB or the total length exceeds 128 KB.

Reduce the size of the request headers.

APIG.0201

Backend unavailable.

502

The backend service is unavailable.

Check whether the backend address configured for the API is accessible.

APIG.0201

Backend timeout.

504

The backend service has timed out.

Increase the timeout duration of the backend service or shorten the processing time.

APIG.0201

An unexpected error occurred

500

An internal error occurred.

Contact technical support.

APIG.0202

Backend unavailable

502

The backend is unavailable.

Check whether the backend request protocol configured for the API is the same as the request protocol used by the backend service.

APIG.0203

Backend timeout.

504

The backend service has timed out.

Increase the timeout of the backend service or shorten its processing time.

APIG.0204

SSL protocol is not supported: TLSv1.1

400

The SSL protocol version is not supported.

Use a supported SSL protocol version.

APIG.0301

Incorrect IAM authentication information.

401

The IAM authentication details are incorrect.

Check the token by referring to Common Errors Related to IAM Authentication Information.

APIG.0302

The IAM user is not authorized to access the API.

403

The IAM user is not allowed to access the API.

Check whether the user is controlled by a blacklist or whitelist.

APIG.0303

Incorrect app authentication information.

401

The app authentication details are incorrect.

Perform the following checks for app authentication:

  • Check whether the request method, path, query parameters, and request body are consistent with those used for signing.
  • Check whether the client time is correct.

Check whether the signing code is correct by referring to Calling APIs Through App Authentication.

In the case of AppCode-based simple authentication, check whether the request contains the X-Apig-AppCode header.

APIG.0304

The app is not authorized to access the API.

403

The app is not allowed to access the API.

Check whether the app has been authorized to access the API.

APIG.0305

Incorrect authentication information.

401

The authentication information is incorrect.

Check whether the authentication information is correct.

APIG.0306

API access denied.

403

Access to the API is not allowed.

Check whether you have been authorized to access the API.

APIG.0307

The token must be updated.

401

The token needs to be updated.

Obtain a new token from IAM.

APIG.0308

The throttling threshold has been reached.

429

The throttling threshold has been reached.

Try again after the throttling resumes. If the number of subdomain requests per day is reached, bind an independent domain name to the API.

APIG.0310

The project is unavailable.

403

The project is currently unavailable.

Select another project and try again.

APIG.0311

Incorrect debugging authentication information.

401

The debugging authentication details are incorrect.

Contact technical support.

APIG.0401

Unknown client IP address.

403

The client IP address cannot be identified.

Contact technical support.

APIG.0402

The IP address is not authorized to access the API.

403

The IP address is not allowed to access the API.

Check whether the IP address is controlled by a blacklist or whitelist.

APIG.0404

Access to the backend IP address has been denied.

403

The backend IP address cannot be accessed.

Check whether the backend IP address or the IP address corresponding to the backend domain name is accessible.

APIG.0501

The app quota has been used up.

405

The app quota has been reached.

Increase the app quota.

APIG.0502

The app has been frozen.

405

The app has been frozen.

Check whether your account balance is sufficient.

APIG.0601

Internal server error.

500

An internal error occurred.

Contact technical support.

APIG.0602

Bad request.

400

Invalid request.

Check whether the request is valid.

APIG.0605

Domain name resolution failed.

500

Domain name resolution failed.

Check whether the domain name is correct and has been bound to a correct backend address.

APIG.0606

Failed to load the API configurations.

500

API configurations could not be loaded.

Contact technical support.

APIG.0607

The following protocol is supported: {xxx}

400

The protocol is not supported. Only xxx is supported.

xxx is subject to the actual value in the response.

Use HTTP or HTTPS to access the API.

APIG.0608

Failed to obtain the admin token.

500

The tenant details cannot be obtained.

Contact technical support.

APIG.0609

The VPC backend does not exist.

500

The VPC backend service cannot be found.

Contact technical support.

APIG.0610

No backend available.

502

No backend services are available.

Check whether all backend services are available. For example, check whether the API calling information is consistent with the actual configuration.

APIG.0611

The backend port does not exist.

500

The backend port was not found.

Contact technical support.

APIG.0612

An API cannot call itself.

500

An API cannot call itself.

Modify the backend configurations, and ensure that the number of layers the API is recursively called does not exceed 10.

APIG.0613

The IAM service is currently unavailable.

503

IAM is currently unavailable.

Contact technical support.

APIG.0705

Backend signature calculation failed.

500

Backend signature calculation failed.

Contact technical support.

APIG.0802

The IAM user is forbidden in the currently selected region

403

The IAM user is disabled in the current region.

Contact technical support.

APIG.1009

AppKey or AppSecret is invalid

400

The AppKey or AppSecret is invalid.

Check whether the AppKey or AppSecret in the request is correct.

We use cookies to improve our site and your experience. By continuing to browse our site you accept our cookie policy. Find out more

Feedback

Feedback

Feedback

0/500

Selected Content

Submit selected content with the feedback