Errors

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

Topology codes begin with 4 (for example 4306002, read as 4_306_002: 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
4303001	RESOURCE_POOL_NAME_IS_BLANK	INVALID_ARGUMENT	Resource pool name must not be blank.
4303002	RESOURCE_POOL_ZONE_ID_NOT_VALID	INVALID_ARGUMENT	Resource pool zone ID is required and must be a valid format.
4303003	RESOURCE_POOL_NAME_INVALID_FORMAT	INVALID_ARGUMENT	Resource pool name must be a valid DNS label: lowercase letters, digits, and hyphens; must start with a letter and end with a letter or digit.
4303004	RESOURCE_POOL_NAME_TOO_LONG	INVALID_ARGUMENT	Resource pool name must not exceed 63 characters.
4303005	RESOURCE_POOL_NAME_CONSECUTIVE_HYPHENS	INVALID_ARGUMENT	Resource pool name must not contain consecutive hyphens.
4303006	RESOURCE_POOL_LABEL_SELECTOR_NOT_VALID	INVALID_ARGUMENT	Resource pool label selector is not valid.
4303007	RESOURCE_POOL_IMMUTABLE_AFTER_ENABLED	FAILED_PRECONDITION	A resource pool cannot be modified once it has been enabled.
4303008	RESOURCE_POOL_STATUS_TRANSITION_NOT_ALLOWED	FAILED_PRECONDITION	Resource pool status transition is not allowed.
4303009	RESOURCE_POOL_DISPLAY_NAME_IS_BLANK	INVALID_ARGUMENT	Resource pool display name is required.
4303010	RESOURCE_POOL_DISPLAY_NAME_TOO_LONG	INVALID_ARGUMENT	Resource pool display name must not exceed 128 characters.
4303011	RESOURCE_POOL_DISPLAY_NAME_NOT_VALID	INVALID_ARGUMENT	Resource pool display name must not contain control characters.
4304001	DEPLOYMENT_TARGET_NAME_IS_BLANK	INVALID_ARGUMENT	Deployment target name must not be blank.
4304002	DEPLOYMENT_TARGET_HOSTNAME_IS_BLANK	INVALID_ARGUMENT	Deployment target hostname must not be blank.
4304003	DEPLOYMENT_TARGET_ONLINE_CPUS_ZERO	INVALID_ARGUMENT	Deployment target online CPUs must be greater than zero.
4304004	DEPLOYMENT_TARGET_TOTAL_MEMORY_ZERO	INVALID_ARGUMENT	Deployment target total memory must be greater than zero.
4304005	DEPLOYMENT_TARGET_NAME_TOO_LONG	INVALID_ARGUMENT	Deployment target name must not exceed 63 characters.
4304006	DEPLOYMENT_TARGET_NAME_INVALID_FORMAT	INVALID_ARGUMENT	Deployment target name must be a valid DNS label.
4304007	DEPLOYMENT_TARGET_NAME_CONSECUTIVE_HYPHENS	INVALID_ARGUMENT	Deployment target name must not contain consecutive hyphens.
4304008	DEPLOYMENT_TARGET_NODE_UID_NOT_VALID	INVALID_ARGUMENT	Deployment target node uid is not valid.
4304009	DEPLOYMENT_TARGET_STATUS_NOT_VALID	INVALID_ARGUMENT	Deployment target status is not valid.
4304010	DEPLOYMENT_TARGET_LABELS_NOT_VALID	INVALID_ARGUMENT	Deployment target labels are not valid.
4305001	OPERATION_PROGRESS_OUT_OF_RANGE	INVALID_ARGUMENT	Operation progress must be between 0 and 100 inclusive.
4305002	OPERATION_END_TIME_BEFORE_START_TIME	INVALID_ARGUMENT	Operation end time must not be before start time.
4305003	OPERATION_SCOPE_TYPE_NOT_VALID	INVALID_ARGUMENT	Operation scope type is not valid.
4306001	LOCATION_NOT_FOUND	NOT_FOUND	The referenced location does not exist.
4306002	LOCATION_NOT_ACTIVE	FAILED_PRECONDITION	The target location is not active and cannot take new placements.
4306003	LOCATION_KIND_NOT_PLACEABLE	INVALID_ARGUMENT	This kind of location cannot be used for the requested operation.
4306004	LOCATION_STATUS_TRANSITION_NOT_ALLOWED	FAILED_PRECONDITION	The requested status change is not allowed from the location’s current state.
4306005	UNKNOWN_LOCATION_KIND	INVALID_ARGUMENT	The location kind is not recognised.
4306006	UNKNOWN_LOCATION_STATUS	INVALID_ARGUMENT	The location status is not recognised.
4306007	LOCATION_NAME_IS_BLANK	INVALID_ARGUMENT	Location name must not be blank.
4306008	LOCATION_NAME_INVALID_FORMAT	INVALID_ARGUMENT	Location name must be a valid DNS label: lowercase letters, digits, and hyphens; must start with a letter and end with a letter or digit.
4306009	LOCATION_NAME_TOO_LONG	INVALID_ARGUMENT	Location name must not exceed 63 characters.
4306010	LOCATION_NAME_CONSECUTIVE_HYPHENS	INVALID_ARGUMENT	Location name must not contain consecutive hyphens.
4306011	LOCATION_DISPLAY_NAME_IS_BLANK	INVALID_ARGUMENT	Location display name must not be blank.
4306012	GLOBAL_LOCATION_NOT_ACTIVE	INVALID_ARGUMENT	The global location must always be active.
4306013	GLOBAL_LOCATION_HANDLE_INVALID	INVALID_ARGUMENT	The global location must keep its reserved global handle.
4306014	ZONE_IMMUTABLE_AFTER_ENABLED	FAILED_PRECONDITION	A zone cannot be modified once it has been enabled.
4306015	REGION_MULTI_REGION_REFERENCE_INVALID	INVALID_ARGUMENT	The region’s multi-region reference is not valid.
4306016	ZONE_REGION_ID_INVALID	INVALID_ARGUMENT	The zone’s region reference is not valid.
4306017	REGION_ALREADY_IN_MULTI_REGION	FAILED_PRECONDITION	The region already belongs to another multi-region.
4306018	ZONE_NOT_MARKED_FOR_DELETION	FAILED_PRECONDITION	A zone must be marked for deletion before it is removed.
4306019	ZONE_NOT_EMPTY	FAILED_PRECONDITION	A zone cannot be deleted while it still has resource pools.
4306020	LOCATION_DESCRIPTION_NOT_VALID	INVALID_ARGUMENT	Location description must be at most 1024 characters and carry no control or bidirectional characters.
4307001	MULTI_REGION_NOT_FOUND	NOT_FOUND	The referenced multi-region does not exist.
4307002	MULTI_REGION_NOT_MARKED_FOR_DELETION	FAILED_PRECONDITION	Multi-region must be marked for deletion before it is removed.
4601001	UNKNOWN_SCHEMA_VERSION	DATA_LOSS	Schema version is not recognized.
4601002	REGION_NOT_FOUND	NOT_FOUND	The region was not found.
4601003	ZONE_NOT_FOUND	NOT_FOUND	The zone was not found.
4601004	RESOURCE_POOL_NOT_FOUND	NOT_FOUND	The resource pool was not found.
4601005	DEPLOYMENT_TARGET_NOT_FOUND	NOT_FOUND	The deployment target was not found.
4601006	TOPOLOGY_OPERATION_NOT_FOUND	NOT_FOUND	The topology operation was not found.
4601007	UNKNOWN_DEPLOYMENT_TARGET_STATUS	DATA_LOSS	The deployment target status is not recognized.
4602001	UNKNOWN_INTEGRATION_VERSION	INVALID_ARGUMENT	The integration version is not recognized.
4602002	UNKNOWN_DEPLOYMENT_TARGET_STATUS	INVALID_ARGUMENT	The deployment target status is not recognized.