Semantic HTTP Status Codes
The CloudBase gateway returns HTTP status codes grouped by error scenario. Error codes that share a status require the same handling. All statuses listed on this page are 4XX and can be assigned a dedicated page in Custom Error Pages.
Only typical error codes are listed under each status below. For the full list, see Error Codes Overview.
Overview
| HTTP status | Scenario | Suggested action |
|---|---|---|
| 401 | Authentication failed: credential missing, invalid, or expired | Check or renew the credential and sign in again |
| 402 | Overdue payment, package exceeded, environment suspended, or resource isolated | Top up, renew, upgrade the package, or reduce usage |
| 403 | Insufficient permission or denied by access policy | Check permission and access policy configuration |
| 404 | Resource not found | Verify that the resource, domain, or path exists |
| 423 | Feature not enabled or route disabled | Enable the feature in the console or check the route configuration |
| 429 | Rate, quota, or concurrency limit exceeded | Reduce the request rate or upgrade the quota |
| 451 | Blocked or rejected for legal reasons | Check content compliance |
401 Unauthorized
Authentication failed because the credential is missing, invalid, or expired. Check the credential in the request and sign in again if needed.
| Error code | Description |
|---|---|
| MISSING_CREDENTIALS | Missing necessary authentication information in request header |
| INVALID_CREDENTIALS | Authentication failed, user information validation failed |
| ACCESS_TOKEN_INVALID | Authentication information in request header is invalid |
| ACCESS_TOKEN_EXPIRED | Access token has expired |
| ACCESS_TOKEN_KID_INVALID | Access token Key ID (kid) is invalid |
| AUTHENTICATION_FAILED | Request authentication failed |
402 Payment Required
The resource is suspended due to overdue payment, an exceeded package, or isolation. When an environment is suspended (for example, plan expiry isolation or exhausted resource points), all requests to that environment return 402. Top up, renew, upgrade the package, or reduce usage to restore it.
| Error code | Description |
|---|---|
| ENV_SUSPENDED | Environment is suspended, please check whether environment usage exceeds the package limit |
| ENV_ISOLATED | Environment is isolated after expiration, renew to restore it |
| DATABASE_RESOURCE_ISOLATED | PostgreSQL database resource is isolated |
| SERVICE_CHARGE_OVERDUE | Service suspended due to overdue payment, please recharge in time |
403 Forbidden
Permission is insufficient or the request is denied by an access policy. Check security rules, source restrictions, and other permission and policy settings.
| Error code | Description |
|---|---|
| ACCESS_DENIED | Request denied by gateway policy |
| ACTION_FORBIDDEN | Current identity has no permission to execute this operation |
| EXCEED_AUTHORITY | Authority limit exceeded |
| STORAGE_EXCEED_AUTHORITY | Current user has no permission to operate cloud storage resource |
| OBJECT_BATCH_TOO_LARGE | Too many objects in single batch operation |
| FUNCTIONS_PERMISSION_DENIED | No permission to call this cloud function |
| AI_MODEL_NOT_SUPPORTED | Specific model is not supported |
| AI_CHANNEL_NOT_ALLOWED | The Mini Program Growth Plan only supports calls from the Mini Program SDK and CloudBase SDK |
| SERVICE_FORBIDDEN | Service is disabled, may be due to permission closure, environment exception, or WeChat CloudRun starting |
| DEFAULT_DOMAIN_EXPIRED | Default domain has exceeded usage validity period, requires renewal or bind custom domain |
| CDN_SIGNATURE_MISSING | Signature missing for current access link |
| CDN_INVALID_SIGNATURE | Signature incorrect for current access link |
| CDN_SIGNATURE_EXPIRED | Signature expired for current access link |
404 Not Found
The resource does not exist. Verify that the resource, domain, or path is created and configured correctly.
| Error code | Description |
|---|---|
| INVALID_HOST | Invalid host |
| INVALID_REGION | Invalid region |
| INVALID_PATH | No matching forwarding rule found, please check HTTP Gateway forwarding rule configuration |
| INVALID_ENV | Invalid environment, environment not found |
| FUNCTIONS_NOT_FOUND | Cloud function not found |
| FUNCTIONS_NAME_MISSING | Function name not specified when calling |
| FUNCTIONS_QUALIFIER_NOT_FOUND | Specified function version to access does not exist |
| SERVICE_NOT_FOUND | Corresponding CloudRun service not found |
| SERVICE_VERSION_NOT_FOUND | Cannot find matching CloudRun service version |
| AI_MODEL_NOT_FOUND | Specified model group not found |
423 Locked
The feature is not enabled or the route is disabled. Enable the feature in the console or check the route configuration.
| Error code | Description |
|---|---|
| HTTPSERVICE_NONACTIVATED | HTTP Gateway not enabled |
| GATEWAY_ROUTE_DISABLED | Gateway route is disabled, please check the gateway route configuration |
| STATIC_RESOURCE_NONACTIVATED | Static website hosting service not enabled |
| AI_MODEL_CONFIG_MISSING | Missing necessary configuration for calling model such as API Key |
| AI_MODEL_DISABLED | Model has been disabled |
429 Too Many Requests
The request rate, quota, or concurrency limit is exceeded. Reduce the request rate or upgrade the quota, then retry.
| Error code | Description |
|---|---|
| EXCEED_RATELIMIT | Request frequency exceeds package or custom rate limit |
| EXCEED_REQUEST_LIMIT | Request count limit exceeded, package resources exhausted |
| EXCEED_CONCURRENT_REQUEST_LIMIT | Request concurrency limit exceeded |
| EXCEED_TOKEN_QUOTA_LIMIT | Large model Token usage exceeded quota or model group quota unavailable |
| FUNCTIONS_EXCEED_RESOURCE_LIMIT | Request frequency exceeds function provisioned concurrency |
451 Unavailable For Legal Reasons
The request is blocked or rejected for compliance reasons. Check content compliance.
| Error code | Description |
|---|---|
| REQUEST_FORBIDDEN | Request is forbidden to access |