HTTP Access Service Error Codes
🌟 Are you experiencing HTTP access issues? Click here to consult Cloud Development Copilot for answers to your questions anytime. 📱 WeChat Cloud Development users, please choose the Mini Program Official Account to log in.
General Errors
BAD_REQUEST
The request data or parameter format is invalid. Please check whether the access domain name or Host is correctly filled, and whether the request headers and request body are properly configured.
INVALID_REQUEST
The HTTP request does not conform to protocol specifications, or the request parameters are abnormal. Please check the request format.
ENV_ABNORMAL
The environment status is abnormal. Please go to the console to check the environment status. If accessing CloudBase Run services, check whether the CloudBase Run service and version status are normal, and try creating a new service version.
INVALID_ENV
Environment ID is invalid or the corresponding CloudBase environment was not found. Please check whether the access domain name is correct.
ENV_NOT_READY
Environment resources are not ready yet. Please go to the console to check whether the environment initialization is complete, or wait a moment and try again.
ENV_FEATURE_NOT_CONFIGURED
The target resource being accessed does not exist in the environment. Please check on the console whether the target resource exists, or wait a moment and try again.
INVALID_HOST
Invalid or invalid hostname. Possible reasons include:
- The access domain name or Host is not correctly filled in;
- The requested domain name is neither a valid CloudBase default domain nor a bound custom domain;
- The requested domain is a custom domain, but it has not been configured with correct DNS resolution;
- The requested domain is a custom domain, but the modified DNS resolution has not yet taken effect.
You can check whether the domain name is filled in correctly and whether the correct DNS resolution is configured. If you have modified the DNS resolution, please check with your domain registrar whether the resolution has taken effect, or wait a moment and try again.
INVALID_PATH
No matching forwarding rules were found. Please check the configuration of the HTTP access service forwarding rules.
SERVICE_FORBIDDEN
The service is disabled. Possible reasons include:
- HTTP access path permissions are disabled, and service access is prohibited. If you want to enable the relevant permissions, please go to the CloudBase platform to configure;
- The service or environment status is abnormal. Please check whether the environment is in arrears or frozen;
- When using WeChat Cloud Run, there is a startup time of 1-3 minutes after the initial successful deployment of the service. You can wait and try again.
- When using WeChat Cloud Run Resource Reuse, it is carrying incorrect signature information.
HTTPSERVICE_NONACTIVATED
The HTTP access service is not enabled. Please go to the CloudBase platform to enable the service. If the service is already enabled, please try again later.
EXCEED_RATELIMIT
The request rate exceeds the QPS quota of your purchased plan. You can upgrade your plan to increase the QPS quota.
EXCEED_MAX_PAYLOAD_SIZE
The request body size exceeds the limit. The request body size limits are as follows:
- The maximum request body size limit for Cloud Functions: 100KB for text-type request bodies, 6MB for other types;
- The maximum request body size for other requests is 100MB.
BAD_GATEWAY
Gateway transmission error occurred. The request failed during forwarding to the target service or receiving a response from it. Please try again later. If this error occurs while accessing CloudBase Run services, check whether the CloudBase Run service is operating normally, or inspect the client or service logs.
ERR_ABORT_HANDLER
This error can occur for various reasons. If it occurs during the invocation of a large model, try the following solutions:
- Ensure that requests using streaming output (Server-sent Event) include
text/event-streamin theAcceptheader; otherwise, the request will time out after 60 seconds; - Ensure that SSE (Server-sent Event) responses continuously return data to prevent the connection from being closed due to prolonged idleness (exceeding 60 seconds). You can maintain a heartbeat by sending
comment lines(e.g.,: ping) periodically over the SSE connection. For details, see: Event Stream Format.
If this error occurs in the response of CloudBase Run (Function-as-a-Service), try redeploying the hosted service to upgrade to the latest framework version with built-in SSE keepalive.
DEFAULT_DOMAIN_EXPIRED
Due to security and compliance requirements, the default domain name is only available for development and testing purposes. The current default domain name has expired. Please click Renew on the CloudBase platform. The renewal is expected to take effect within 5 minutes. It is recommended to bind a custom domain name to avoid service availability risks caused by reduced accessibility of the platform's default domain name.
Authorization and Authentication Errors
MISSING_CREDENTIALS
The request header lacks the necessary authentication credentials. Possible reasons include:
- HTTP access authentication is enabled, but the request headers lack authentication credentials. See HTTP Access Authentication.
- Accessing via Open API without authentication credentials in the request headers. See Getting Started Guide.
INVALID_CREDENTIALS
Authentication failed. Possible reasons include:
- With HTTP access authentication enabled, the user information in the request headers failed verification. See HTTP Access Authentication.
- When accessing via Open API, the user information in the request headers failed verification. See Getting Started Guide.
ACCESS_TOKEN_EXPIRED
The authentication credentials in the request headers have expired. Please obtain new authentication credentials again.
ACCESS_TOKEN_INVALID
The authentication credentials in the request headers are invalid. Please check the format of the authentication credentials or obtain new credentials again.
ACTION_FORBIDDEN
The identity in the request headers lacks permission to perform the current operation. Please check whether the current identity has permission to execute this operation, or update the access policy associated with the current role in Cloud Development Platform - Extension Capabilities - Cloud Background Management - Permission Control - Policy Management.
UNSUPPORTED_AUTH_TYPE
The request uses an unsupported authentication type. If accessing the HTTP API, check whether you are using AccessToken or Tencent Cloud Signature V3 authentication.
AUTHENTICATION_FAILED
Authentication failed for the request. Please wait a moment and try again, or submit a ticket to us.
CloudBase Related Errors
SERVICE_NOT_FOUND
No corresponding Cloud Run service is found. Please check whether the service exists. For newly created services, you can wait 2 minutes and try again.
SERVICE_RESOURCE_NOT_FOUND
No corresponding resources are found. Please check whether the service and version statuses are normal, or create a new version.
SERVICE_VERSION_NOT_FOUND
No matching Cloud Run service version is found. The possible reasons are that no version has been created for the Cloud Run service, or the newly created version has not taken effect yet. You can wait a moment and try again.
SERVICE_ENDPOINT_NOT_FOUND
No available upstream address is found for the Cloud Run service. The possible reason is that traffic for all versions of the Cloud Run service has been set to zero.
SERVICE_LB_STATUS_ABNORMAL
The Cloud Run load balancer status is abnormal. Try creating a new version.
SERVICE_CHARGE_OVERDUE
Service suspended due to overdue payment. Please top up promptly.
SERVICE_NOT_READY
The Cloud Run service is in a not-ready state. Service instances may have been scaled down to 0 or the service version is undergoing cold start, preventing normal access. You can wait a moment and try again. To ensure the Cloud Run service maintains at least one instance, see Cloud Run Service Operation Modes and Scaling to adjust the service operation configuration.
SERVICE_TIMEOUT
The Cloud Run service response timed out. You can check the Cloud Run service logs for troubleshooting, add latency log printing in critical code paths, and optimize time-consuming steps.
Cloud Function Related Errors
FUNCTION_NOT_FOUND
No corresponding Cloud Function is found. Please check whether the Cloud Function exists.
FUNCTION_INVOCATION_FAILED
The call to the Cloud Function has timed out or failed. Please verify whether the Cloud Function's logic has any issues.
Error messages may include the stack trace of the Cloud Function error. You can also query error messages via Cloud Function logs.
FUNCTION_QUALIFIER_NOT_FOUND
The function version specified for access does not exist. Please check on the console whether the function version exists, or verify if the version specified in the request is correct.
FUNCTION_STATUS_ABNORMAL
The function status is abnormal. Please check the function status on the console.
FUNCTION_TIME_LIMIT_EXCEEDED
The function execution timed out. Please check whether the function contains time-consuming logic or adjust the function timeout setting on the console.
FUNCTION_MEMORY_LIMIT_EXCEEDED
The function execution memory exceeds the limit. Please check the relevant logic in the function code or adjust the function memory configuration on the console.
FUNCTION_EXECUTE_FAIL
Execution of the function failed. Please check whether the parameters for invoking the function are correct, troubleshoot the function logic, or query the error messages via Cloud Function logs.
FUNCTION_PARAM_INVALID
An exception occurred with the function call parameters. Please check the function call parameters.
FUNCTION_EXCEED_RESOURCE_LIMIT
The request frequency exceeds the provisioned concurrency of the function. Please reduce the request frequency or increase the provisioned concurrency of the function on the console.
Static Hosting Related Errors
STATIC_RESOURCE_NONACTIVATED
Static website hosting service is not enabled. Please enable the service on the console.
STATIC_RESOURCE_TOO_MANY_REDIRECTS
The request has been redirected too many times. Please check whether there is a redirect loop in the Static Hosting service configuration.
STATIC_RESOURCE_REQUESTS_FAILED
Failed to access static hosting resources. Please try again later or submit a ticket to us.
Cloud Storage Related Errors
STORAGE_EXCEED_AUTHORITY
The user does not have permission to perform the corresponding operation on this object. Please check the bucket permission settings and whether the user identity associated with the current request has the required permissions.
OBJECT_NOT_EXIST
The requested object does not exist, and the specified operation cannot be performed.
OBJECT_ALREADY_EXIST
The object already exists, and the specified operation cannot be performed.
COS_ACTION_FAILED
The object storage operation failed to execute. Please wait a moment and try again.
CDN_SIGNATURE_MISSING
The signature for the current access URL is missing. Please check whether the URL carries the correct signature parameters.
CDN_INVALID_SIGNATURE
The signature for the current access URL is incorrect. Please check whether the signature parameters carried by the URL are correct.
CDN_SIGNATURE_EXPIRED
The signature for the current access URL has expired. Please regenerate the signature.
Large Model Invocation Related Errors
AI_MODEL_NOT_FOUND
The specified model group was not found. Please check the request parameters and verify whether the corresponding group exists on the console. If it is a newly created group, please wait a moment and try again.
AI_MODEL_CONFIG_MISSING
The required configurations for model invocation, such as the API Key, are missing. Please add the configurations on the console. After adding the configurations, please wait a moment and try again.
AI_MODEL_REQUEST_FAILED
The large model invocation failed. See the target large model documentation to check whether the model invocation parameters are correct, or see Log Monitoring to query the details of the corresponding invocation.
AI_MODEL_DISABLED
The model has been deactivated. Please check on the console whether the model is activated, or wait 2 minutes and try again.
EXCEED_CONCURRENT_REQUEST_LIMIT
The large model invocation has exceeded the concurrency limit. Please wait a moment and try again, or submit a ticket to request a higher concurrency limit.
EXCEED_TOKEN_QUOTA_LIMIT
The large model Token usage has exceeded the quota. Please purchase resource packages to increase the quota.
System Errors
INTERNAL_REQUEST_FAIL
Internal system request error. Please try again later or submit a ticket to us.
SYS_ERR
Internal system error. Please submit a ticket to us.