Errors
Every Network error carries a stable numeric error_code and a machine-readable
reason. This page lists the logical (domain) error codes Network can return.
For the full error envelope (the google.rpc.Status shape, the reason and
metadata fields, and how codes are structured) see Errors.
Network codes begin with 5 (for example 5300001, read as 5_300_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 |
|---|---|---|---|
5300001 | VPC_NAME_IS_BLANK | INVALID_ARGUMENT | VPC name must not be blank. |
5300002 | VPC_NAME_TOO_LONG | INVALID_ARGUMENT | VPC name must not exceed 63 characters. |
5300003 | VPC_CIDR_IS_NOT_VALID | INVALID_ARGUMENT | VPC CIDR is not valid. |
5300004 | VPC_WORKSPACE_ID_IS_NOT_VALID | INVALID_ARGUMENT | VPC workspace ID is not valid. |
5300005 | VPC_ZONE_ID_IS_NOT_VALID | INVALID_ARGUMENT | VPC zone ID is not valid. |
5300006 | VPC_HAS_CHILDREN | FAILED_PRECONDITION | VPC cannot be deleted because it has children. |
5300007 | VPC_NAME_ALREADY_EXISTS | ALREADY_EXISTS | VPC name already exists. |
5301001 | SUBNET_NAME_IS_BLANK | INVALID_ARGUMENT | Subnet name must not be blank. |
5301002 | SUBNET_NAME_TOO_LONG | INVALID_ARGUMENT | Subnet name must not exceed 63 characters. |
5301003 | SUBNET_CIDR_IS_NOT_VALID | INVALID_ARGUMENT | Subnet CIDR is not valid. |
5301004 | SUBNET_GATEWAY_IP_NOT_WITHIN_CIDR | INVALID_ARGUMENT | Subnet gateway IP is not within the CIDR range. |
5301005 | SUBNET_CIDR_NOT_CONTAINED_IN_VPC | FAILED_PRECONDITION | Subnet CIDR is not contained within the VPC CIDR. |
5301006 | SUBNET_CIDR_OVERLAPS | FAILED_PRECONDITION | Subnet CIDR overlaps with an existing subnet in the same VPC. |
5302001 | FIREWALL_POLICY_NAME_IS_BLANK | INVALID_ARGUMENT | Firewall policy name must not be blank. |
5302002 | FIREWALL_POLICY_NAME_TOO_LONG | INVALID_ARGUMENT | Firewall policy name must not exceed 63 characters. |
5302003 | FIREWALL_POLICY_VPC_ID_IS_NOT_VALID | INVALID_ARGUMENT | Firewall policy VPC ID is not valid. |
5302004 | FIREWALL_POLICY_HAS_CHILDREN | FAILED_PRECONDITION | Firewall policy cannot be deleted because it has children. |
5302005 | FIREWALL_POLICY_RULE_PRIORITIES_ARE_NOT_UNIQUE | ALREADY_EXISTS | Firewall policy rule priorities must be unique within a policy. |
5302006 | FIREWALL_POLICY_RULE_COUNT_EXCEEDS_LIMIT | RESOURCE_EXHAUSTED | Firewall policy rule count exceeds the maximum allowed. |
5303001 | FIREWALL_POLICY_RULE_DIRECTION_IS_NOT_VALID | INVALID_ARGUMENT | Firewall policy rule direction is not valid. |
5303002 | FIREWALL_POLICY_RULE_ACTION_IS_NOT_VALID | INVALID_ARGUMENT | Firewall policy rule action is not valid. |
5303003 | FIREWALL_POLICY_RULE_PORT_RANGE_IS_NOT_VALID | INVALID_ARGUMENT | Firewall policy rule port range is not valid. |
5303004 | FIREWALL_POLICY_RULE_PORT_RANGE_NOT_APPLICABLE_TO_ICMP | INVALID_ARGUMENT | Port range is not applicable to the ICMP protocol. |
5303005 | FIREWALL_POLICY_RULE_PRIORITY_IS_NOT_VALID | INVALID_ARGUMENT | Firewall policy rule priority is not valid. |
5303006 | FIREWALL_POLICY_RULE_SOURCE_CIDRS_NOT_VALID | INVALID_ARGUMENT | Firewall policy rule source CIDRs are not valid. |
5303007 | FIREWALL_POLICY_RULE_DESTINATION_CIDRS_NOT_VALID | INVALID_ARGUMENT | Firewall policy rule destination CIDRs are not valid. |
5303008 | FIREWALL_POLICY_RULE_MATCHES_IS_NOT_VALID | INVALID_ARGUMENT | Firewall policy rule must declare at least one protocol match. |
5303009 | FIREWALL_POLICY_RULE_NOT_FOUND_IN_POLICY | NOT_FOUND | Firewall policy rule not found within the firewall policy. |
5304001 | QUOTA_DEFINITION_METRIC_IS_BLANK | INVALID_ARGUMENT | Quota definition metric must not be blank. |
5304002 | QUOTA_DEFINITION_METRIC_FORMAT_IS_NOT_VALID | INVALID_ARGUMENT | Quota definition metric format is not valid. |
5304003 | QUOTA_DEFINITION_DISPLAY_NAME_IS_BLANK | INVALID_ARGUMENT | Quota definition display name must not be blank. |
5304004 | QUOTA_DEFINITION_DEFAULT_LIMIT_IS_NOT_VALID | INVALID_ARGUMENT | Quota definition default limit must be positive. |
5304005 | QUOTA_DEFINITION_REFRESH_INTERVAL_IS_NOT_VALID | INVALID_ARGUMENT | Quota definition refresh interval is not valid for the quota type. |
5305001 | QUOTA_LIMIT_EFFECTIVE_LIMIT_IS_NOT_VALID | INVALID_ARGUMENT | Quota limit effective limit must be positive. |
5305002 | QUOTA_LIMIT_CONTAINER_ID_IS_NOT_VALID | INVALID_ARGUMENT | Quota limit container ID is not valid. |
5306001 | NETWORK_QUOTA_EXCEEDED | RESOURCE_EXHAUSTED | Network quota exceeded. |
5307001 | NETWORK_OPERATION_PROGRESS_OUT_OF_RANGE | INVALID_ARGUMENT | Operation progress must be between 0 and 100. |
5307002 | NETWORK_OPERATION_END_TIME_BEFORE_START_TIME | INVALID_ARGUMENT | Operation end time must not be before start time. |