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, or resource isolated | Top up, 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. Top up, 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 Cloud Development 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 |