Errors

Every Compute error carries a stable numeric error_code and a machine-readable reason. This page lists the logical (domain) error codes Compute can return. For the full error envelope (the google.rpc.Status shape, the reason and metadata fields, and how codes are structured) see Errors.

Compute codes begin with 3 (for example 3301001, read as 3_301_001: service, group, specific error). The wire value is always the flat integer; you can match on either error_code or reason, both are stable.

The Status column is the canonical gRPC status the error maps to, which the gateway renders as the matching HTTP status (see the status codes table).

Code	Reason	Status	Description
3301001	MEMORY_SIZE_CANT_BE_ALLOCATED_IF_ZONES_ARE_ALLOCATED	INVALID_ARGUMENT	A virtual machine cannot have a memory allocation (size > 0) when memory zones are defined and initialised. Set memory size to zero or remove the memory zones allocation.
3301002	MEMORY_SIZE_MUST_BE_GREATER_THAN_ZERO	INVALID_ARGUMENT	A virtual machine must have a memory size > 0 or memory zones greater than zero. Set memory size to a value greater than zero or add memory zones with a size greater than zero.
3301003	MEMORY_ACCESS_MODE_CANT_BE_PRIVATE_IF_HUGE_PAGES	INVALID_ARGUMENT	When a hugepages object is set, the access mode is forced to SHARED, because huge pages always require MAP_SHARED.
3301004	VIRTUAL_MACHINE_NAME_IS_INVALID	INVALID_ARGUMENT	Name must start with a lowercase letter, followed by up to 62 lowercase letters, numbers, or hyphens, and cannot end with a hyphen.
3301005	UNEXPECTED_ENGINE_RESULT	INVALID_ARGUMENT	The engine returned an unexpected result type.
3301006	VM_PROVIDER_VALIDATION_NOT_IMPLEMENTED	INVALID_ARGUMENT	Virtual machine validation is not yet implemented for this provider.
3301007	VIRTUAL_MACHINE_DESCRIPTION_IS_NOT_VALID	INVALID_ARGUMENT	Virtual machine description must not exceed 1024 characters.
3302001	OPERATION_PROGRESS_OUT_OF_RANGE	INVALID_ARGUMENT	Operation progress must be between 0 and 100 inclusive.
3302002	OPERATION_END_TIME_BEFORE_START_TIME	INVALID_ARGUMENT	Operation end time must not be before start time.
3303001	DISK_NAME_NOT_VALID	INVALID_ARGUMENT	Disk name is not valid.
3303002	DISK_SIZE_NOT_VALID	INVALID_ARGUMENT	Disk size is not valid.
3303003	DISK_ZONE_ID_NOT_VALID	INVALID_ARGUMENT	Disk zone id is not valid.
3304001	IMAGE_NAME_NOT_VALID	INVALID_ARGUMENT	Image name is not valid.
3304002	IMAGE_PATH_NOT_VALID	INVALID_ARGUMENT	Image path is not valid.
3304003	IMAGE_EXTENSION_NOT_VALID	INVALID_ARGUMENT	Image extension is not valid.
3304004	IMAGE_HOST_ID_NOT_VALID	INVALID_ARGUMENT	Image host id is not valid.
3304005	SYSTEM_IMAGE_CANNOT_BE_DELETED	INVALID_ARGUMENT	System images cannot be deleted.
3304006	IMAGE_REFERENCE_NOT_VALID	INVALID_ARGUMENT	Container image reference is not valid.
3304007	IMAGE_SOURCE_URL_NOT_VALID	INVALID_ARGUMENT	Data volume source URL is not valid.
3304008	IMAGE_STORAGE_CLASS_NOT_VALID	INVALID_ARGUMENT	Storage class name is not valid.
3304009	IMAGE_CLAIM_NAME_NOT_VALID	INVALID_ARGUMENT	PVC claim name is not valid.
3304010	IMAGE_NAMESPACE_NOT_VALID	INVALID_ARGUMENT	PVC namespace is not valid.
3304011	IMAGE_NOT_FOUND	NOT_FOUND	Image not found.
3305001	VM_NOT_IN_STARTABLE_STATE	FAILED_PRECONDITION	Virtual machine is not in a startable state.
3305002	VM_NOT_IN_STOPPABLE_STATE	FAILED_PRECONDITION	Virtual machine is not in a stoppable state.
3305003	VM_NOT_IN_RESTARTABLE_STATE	FAILED_PRECONDITION	Virtual machine is not in a restartable state.
3305004	VM_NOT_IN_SUSPENDABLE_STATE	FAILED_PRECONDITION	Virtual machine is not in a suspendable state.
3305005	VM_NOT_IN_RESUMABLE_STATE	FAILED_PRECONDITION	Virtual machine is not in a resumable state.
3305006	VM_NOT_IN_RESETTABLE_STATE	FAILED_PRECONDITION	Virtual machine is not in a resettable state.
3305007	VM_NOT_IN_UPDATABLE_STATE	FAILED_PRECONDITION	Virtual machine is not in an updatable state.
3306001	INSUFFICIENT_CPUS_TO_ALLOCATE	INVALID_ARGUMENT	The deployment target does not have enough available CPUs to deploy the specified virtual machine.
3306002	INSUFFICIENT_GPUS_TO_ALLOCATE	INVALID_ARGUMENT	The deployment target does not have enough available GPUs to deploy the specified virtual machine.
3306003	INSUFFICIENT_MEMORY_TO_ALLOCATE	INVALID_ARGUMENT	The deployment target does not have enough available memory to deploy the specified virtual machine.
3306004	INCORRECT_MEMORY_TYPE_TO_ALLOCATE	INVALID_ARGUMENT	The deployment target does not have the right memory type to deploy the specified virtual machine.
3306005	INSUFFICIENT_DISK_TO_ALLOCATE	INVALID_ARGUMENT	The deployment target does not have enough available disk storage to deploy the specified virtual machine.
3306006	INCORRECT_DISK_CONFIGURATION_TO_ALLOCATE	INVALID_ARGUMENT	The deployment target does not have the right disk configuration (disk type, IOPS, throughput, and so on) to deploy the specified virtual machine.
3306007	INSUFFICIENT_NETWORK_CONFIGURATION	INVALID_ARGUMENT	The deployment target does not have enough bandwidth or the right network configuration to deploy the specified virtual machine.
3306008	NOT_MATCHES_AFFINITY	INVALID_ARGUMENT	The deployment target does not match affinity parameters (such as tags) to deploy the specified virtual machine.
3306009	NO_SUITABLE_DEPLOYMENT_TARGET_FOR_SPECIFICATION	INVALID_ARGUMENT	No deployment target matches all the specifications required to deploy the virtual machine.
3306010	DEPLOYMENT_TARGET_VALIDATION_NOT_IMPLEMENTED	INVALID_ARGUMENT	Deployment target validation is not yet implemented.
3307001	CLOCK_TIMER_NAMES_NOT_UNIQUE	INVALID_ARGUMENT	Clock timer names must be unique.
3308001	QIBDO_VM_RESOURCE_POOL_ID_NOT_VALID	INVALID_ARGUMENT	Qibdo VM resource pool id is not valid.
3308002	QIBDO_VM_EVICTION_STRATEGY_NOT_VALID	INVALID_ARGUMENT	Qibdo VM eviction strategy is not valid.
3308003	QIBDO_VM_NOT_MARKED_FOR_DELETION	FAILED_PRECONDITION	Qibdo virtual machine must be marked for deletion before removal.
3309001	VM_WORKSPACE_NOT_FOUND	NOT_FOUND	Workspace referenced by the virtual-machine request does not exist.
3309002	VM_ZONE_NOT_FOUND	NOT_FOUND	Zone referenced by the virtual-machine request does not exist.
3309003	VM_RESOURCE_POOL_NOT_FOUND	NOT_FOUND	Resource pool referenced by the virtual-machine request does not exist.
3310001	DISK_LEVEL_CLOUD_INIT_DEPRECATED	INVALID_ARGUMENT	Disk-level initConfig is deprecated; set cloudInit on the CreateQibdoVm command instead.
3310002	CLOUD_INIT_TEMPLATE_NOT_FOUND	NOT_FOUND	Cloud-init template not found for the given id and generation.
3310003	CLOUD_INIT_PAYLOAD_TOO_LARGE	INVALID_ARGUMENT	Cloud-init user-data payload exceeds the maximum supported size.
3310004	CLOUD_INIT_PAYLOAD_INVALID	INVALID_ARGUMENT	Cloud-init user-data payload is not valid: malformed YAML or an unknown top-level key.
3311001	DEPLOYMENT_TARGET_CAPACITY_INCOMPLETE	FAILED_PRECONDITION	The scheduler refused to reason about an incomplete deployment-target candidate set.