Compute Engine API Version v1: Error Catalog
Creates and runs virtual machines on Google Cloud Platform.
Service: compute.googleapis.com
When facing errors, refer to this catalog alongside using ourclient libraries. If you're using your own libraries, keep this guide handy for debugging and error resolution. To know more about the error response structure, visitthe error overview page.
Error codes
The following table lists HTTP status codes and associated errors that you might encounter when interacting with our API. Each status code corresponds to one or more reasons and descriptions to help you troubleshoot and handle errors effectively in your application. Within the descriptions, variables denoted by curly braces ({}) represent placeholders for values that are specific to your request.
| Reason | HTTP Status Code | Description |
|---|---|---|
PERMISSIONS_ERROR | 403 | Required '{permission}' permission for '{resource}' |
INVALID_FIELD_VALUE | 400 | Invalid value for field '{field}': '{value}'. {reason} |
FIELD_SIZE_TOO_LARGE | 400 | Value for field '{field}' is too large: maximum size {max_size} {size_unit}; actual size {actual_size}. |
MISSING_REQUIRED_FIELD | 400 | Required field '{field}' not specified |
PROJECT_NOT_FOUND | 404 | The resource '{project}' was not found |
NETWORK_NOT_FOUND | 404 | Network '{network_name}' was not found in project '{project}' in scope '{scope}' (type':' '{scope_type}'). |
SERVICE_UNAVAILABLE_FOR_LOCATION | 500 | '{service_name}' in location '{scope_name}' cannot accept requests. Please try again later. |
CROSS_LOCATION_REQUEST | 403 | Request in scope '{request_scope}' sent to api endpoint in '{endpoint_scope}'. |
RESOURCE_NOT_FOUND | 404 | The resource '{resource}' was not found |
EXTERNAL_RESOURCE_NOT_FOUND | 404 | The resource '{resource}' of type '{resource_type}' was not found. |
RESOURCE_ALREADY_EXISTS | 409 | The resource '{resource}' already exists |
RESOURCE_NOT_READY | 400 | The resource '{resource}' is not ready |
RESOURCE_NOT_READY_WITH_DETAILS | 400 | The resource '{resource}' is not ready. {reason} |
RESOURCE_IN_USE_BY_ANOTHER_RESOURCE | 400 | The {resource_type} resource '{resource}' is already being used by '{conflicting_resource}' |
RATE_LIMIT_EXCEEDED | 403 | Quota exceeded for quota metric '{quota_metric}' and limit '{quota_limit}' of service '{service}' for consumer '{consumer}'. |
QUOTA_EXCEEDED | 403 | Quota '{quota_metric}' exceeded. Limit: {quota_limit_value} |
LIMIT_EXCEEDED | 403 | Exceeded limit '{limit_metric}' on resource '{resource}'. Limit: {limit_value} |
RESOURCE_POOL_EXHAUSTED | 503 | The global or regional {resource_type} resource pool is exhausted |
ZONE_RESOURCE_POOL_EXHAUSTED | 503 | The zone '{zone}' does not have enough resources available to fulfill the request. Try a different zone, or try again later. For more information, see ourTroubleshooting documentation. |
ZONE_RESOURCE_POOL_EXHAUSTED_WITH_DETAILS | 503 | The zone '{zone}' does not have enough resources available to fulfill the request. '{details}' For more information, see ourTroubleshooting documentation. |
REGION_RESOURCE_POOL_EXHAUSTED_WITH_DETAILS | 503 | The region '{region}' does not have enough resources available to fulfill the request: '{details}' For more information, see ourTroubleshooting documentation. |
MACHINE_TYPE_UNSUPPORTED | 400 | The specified machine type '{machine_type}' does not exist in zone '{zone}'. See the documentation for a list of available machine types by zone. For more information, see ourTroubleshooting documentation. |
SERIAL_PORT_OUTPUT_IN_PROGRESS | 400 | Cannot retrieve serial port output for '{resource}'. An existing request to fetch the output is still being processed. Wait for the current request to complete before trying again. |
SSL_CERTIFICATE_MISSING_CN | 400 | The SSL certificate is missing a Common Name(CN) or Subject Alternative Name(SAN). |
SSL_CERTIFICATE_COULD_NOT_PARSE_CERT | 400 | The SSL certificate could not be parsed. |
SSL_CERTIFICATE_COULD_NOT_PARSE_KEY | 400 | The SSL key could not be parsed. |
SSL_CERTIFICATE_UNSUPPORTED_KEY_SIZE | 400 | The SSL key size is unsupported. The loadbalancer supports RSA-2048 and ECDSA P-256 certificates. |
SSL_CERTIFICATE_RSA_PUBLIC_EXPONENT_TOO_LARGE | 400 | The RSA public exponent is too large. |
TOO_MANY_FIREWALL_ATOMS | 400 | The network contains too many large firewalls. |
INSTANCE_IN_MULTIPLE_LOAD_BALANCED_IGS | 400 | Validation failed for instance '{instance}': instance may belong to at most one load-balanced instance group. |
INCOMPATIBLE_BACKEND_SERVICES | 400 | Validation failed for instance group '{instance_group}': backend services '{backend_service_1}' and '{backend_service_2}' point to the same instance group but the backends have incompatible {incompatible_parameter}. {incompatibility_explanation} |
IP_IN_USE_BY_ANOTHER_RESOURCE | 400 | IP '{ip_address}' is already being used by another resource. |
IP_SPACE_EXHAUSTED | 400 | IP space of '{network_or_subnetwork}' is exhausted. |
IP_SPACE_EXHAUSTED_WITH_DETAILS | 400 | IP space of '{network_or_subnetwork}' is exhausted. Insufficient free IP addresses in the IP range '{ip_range}'. Consider expanding the current IP range or selecting an alternative IP range. If this is a secondary range, consider adding an additional secondary range. |
IP_OUT_OF_RANGE | 400 | Requested IP '{ip_address}' is outside the valid CIDR range '{ip_range}' for resource '{resource}'. |
INSTANCE_GROUP_NETWORK_VALIDATION_ERROR | 400 | Validation failed for Instance Group '{instance_group}': load balanced instance group requires all instances to be part of the same network and subnetwork. |
WRONG_NETWORK | 400 | Resource '{resource}' is expected to be in the network '{expected_network}' but is in the network '{actual_network}'. |
WRONG_SUBNETWORK | 400 | Resource '{resource}' is expected to be in the subnetwork '{expected_subnetwork}' but is in the subnetwork '{actual_subnetwork}'. |
PREVIEW_FEATURE_UNSUPPORTED | 400 | Invalid preview feature name: {feature_name}. Currently, only the alpha-api-access preview feature can be enabled or disabled. |
PREVIEW_FEATURE_ROLLOUT_PLAN_UNSUPPORTED | 400 | Invalid rollout plan. Currently, only PredefinedRolloutPlan ROLLOUT_PLAN_FAST_ROLLOUT is supported. |
PREVIEW_FEATURE_ACTIVATION_STATUS_INVALID | 400 | Invalid activation status: {activation_status}. A preview feature can only be enabled or disabled. |
INCOMPATIBLE_RESERVATION_AFFINITY | 400 | You must configure the reservation affinity in the '{resource_type_1}' resource '{resource_name_1}' to match the reservation affinity of '{resource_type_2}' resource '{resource_name_2}'. View the details of the each resource to determine its reservation affinity then try again. For more information, see ourTroubleshooting documentation. |
INCOMPATIBLE_NODE_AFFINITY | 400 | You must configure the node affinity in the '{resource_type_1}' resource '{resource_name_1}' to match the node affinity of '{resource_type_2}' resource '{resource_name_2}'. View the details of the each resource to determine its node affinity then try again. For more information, see ourTroubleshooting documentation. |
INCOMPATIBLE_INSTANCE_PROVISIONING_MODEL | 400 | The '{resource_type_1}' resource '{resource_name_1}' has a '{resource_provisioning_model}' provisioning model. But the '{resource_type_2}' resource only supports instances with the '{supported_provisioning_models}' provisioning models. |
INCOMPATIBLE_DISK_REPLICA_ZONES | 400 | A regional disk attached to the '{resource_type_1}' resource '{resource_name_1}' is replicated in zones {replica_zones}. You must configure the '{resource_type_2}' resource '{resource_name_2}' in the same zones. |
REGIONAL_DISK_REQUIRED | 400 | A disk attached to the '{resource_type_1}' resource '{resource_name_1}' is either a zonal disk or a local disk. But '{resource_type_2}' resource only supports regional disks. For more information, see ourTroubleshooting documentation. |
INSTANCE_NAME_ALREADY_IN_USE_IN_BOTH_ZONES | 400 | Instance name '{instance_name}' already in use in both zones '{zones}'. To create an HA Controller the instance name must be used in only one of the zones. |
INCOMPATIBLE_BACKEND_SERVICE_NETWORK | 400 | You must configure the network in the Backend Service '{backend_service}' to match the network of '{resource_type}' resource '{resource_name}'. View the details of each resource to determine its network, then try again. |
INCOMPATIBLE_BACKEND_SERVICE_SCHEME | 400 | The provided Backend Service '{backend_service}' must have the '{supported_scheme}' load balancing scheme to be supported by '{resource_type}' resource '{resource_name}'. |
INCOMPATIBLE_BACKEND_SERVICE_SCOPE | 400 | The provided Backend Service '{backend_service}' must have the '{scope}' scope to be compatible with '{resource_type}' resource '{resource_name}'. |
BACKEND_SERVICE_NOT_EMPTY | 400 | To be compatible with '{resource_type}' resource '{resource_name}', the provided Backend Service '{backend_service}' must have no backends configured. |
HA_POLICY_MISSING | 400 | The provided Backend Service '{backend_service}' must specify the field 'haPolicy' to be supported by '{target_resource_type}'. |
RESOURCE_REGION_MISMATCH | 400 | The '{resource_type_1}' resource '{resource_name_1}' (region: '{region_1}') and '{resource_type_2}' resource '{resource_name_2}' (region: '{region_2}') are in different regions. Cross-region interaction is not supported. |
RESOURCE_PROJECT_MISMATCH | 400 | The '{resource_type_1}' resource '{resource_name_1}' (project: '{project_1}') and '{resource_type_2}' resource '{resource_name_2}' (project: '{project_2}') are in different projects. Cross-project interaction is not supported. |
INCOMPATIBLE_STACK_TYPE | 400 | You must configure the stack type in the '{resource_type_1}' resource '{resource_name_1}' to match the stack type of '{resource_type_2}' resource '{resource_name_2}'. View the details of each resource to determine its stack type, then try again. For more information, see ourTroubleshooting documentation. |
IP_STACK_TYPE_CONFLICT | 400 | The provided IP address '{ip_address}' is incompatible with the specified stack type ('{stack_type}'). Ensure the provided IP address matches the stack type or update the stack type configuration. |
INCOMPATIBLE_DISK_INTERFACE_FOR_MACHINE_TYPE | 400 | The specified disk interface '{disk_interface}' is not compatible with the specified machine type '{machine_type}'. See the documentation for compatible disk interfaces for each machine series. For more information, see ourTroubleshooting documentation. |
FIREWALL_POLICY_CONCURRENT_OPERATIONS_LIMIT_EXCEEDED | 429 | Firewall Policy concurrent operation limit exceeded for resource '{resource}'. Limit {limit} per firewall policy. Please wait for other operations to be done and try again later. |
BGP_ROUTES_NOT_AVAILABLE | 400 | No routes found because BGP session is not established or address family '{address_family}' is not configured for peer '{bgp_peer}'. See the documentation for more details on how to configure BGP sessions. For more information, see ourTroubleshooting documentation. |
NAMED_SET_NOT_FOUND | 404 | The named set '{named_set}' was not found. |
Except as otherwise noted, the content of this page is licensed under theCreative Commons Attribution 4.0 License, and code samples are licensed under theApache 2.0 License. For details, see theGoogle Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.
Last updated 2025-10-30 UTC.