Errors

Every Topology error carries a stable numeric error_code and a machine-readable reason. This page lists the logical (domain) error codes Topology can return. 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
4301001	REGION_NAME_IS_BLANK	INVALID_ARGUMENT	Region name must not be blank.
4301002	REGION_NAME_INVALID_FORMAT	INVALID_ARGUMENT	Region name must be a valid DNS label: lowercase letters, digits, and hyphens; must start with a letter and end with a letter or digit.
4301003	REGION_NAME_TOO_LONG	INVALID_ARGUMENT	Region name must not exceed 63 characters.
4301004	REGION_NAME_CONSECUTIVE_HYPHENS	INVALID_ARGUMENT	Region name must not contain consecutive hyphens.
4302001	ZONE_NAME_IS_BLANK	INVALID_ARGUMENT	Zone name must not be blank.
4302002	ZONE_REGION_ID_NOT_VALID	INVALID_ARGUMENT	Zone region ID is required and must be a valid format.
4302003	ZONE_NAME_INVALID_FORMAT	INVALID_ARGUMENT	Zone name must be a valid DNS label: lowercase letters, digits, and hyphens; must start with a letter and end with a letter or digit.
4302004	ZONE_NAME_TOO_LONG	INVALID_ARGUMENT	Zone name must not exceed 80 characters.
4302005	ZONE_NAME_CONSECUTIVE_HYPHENS	INVALID_ARGUMENT	Zone name must not contain consecutive hyphens.
4302006	ZONE_NAME_MISSING_REGION_PREFIX	INVALID_ARGUMENT	Zone name must be prefixed with its parent region name followed by a hyphen.
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.
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.
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.
4307001	MULTI_REGION_NOT_FOUND	NOT_FOUND	The referenced multi-region does not exist.
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.