Routing configuration size and quota units

The load balancer configuration size quotas measure the size of all routing configurations (URL maps for Application Load Balancers or TLS routes for Proxy Network Load Balancers) in a project, VPC network, or region of a VPC network, depending on the type of load balancer. Individual URL maps are limited to 1 MB of data each, with the exception of the classic Application Load Balancer, which retains its 64 KB limit. Quota units represent the complexity of your routing configuration. A routing configuration with few rules or short matchers consumes fewer quota units, while a highly complex configuration with many rules, hostnames, or path matchers consumes more.

How the quota works

Only the routing configurations (URL maps or TLS routes) that are part of a complete Application Load Balancer or proxy Network Load Balancer configuration contribute to the usage of a load balancer configuration size quota. To be part of a complete configuration, a URL map or TLS route must be referenced by a target proxy (such as a target HTTP, HTTPS, or TCP proxy), and the target proxy must be referenced by a forwarding rule. Google Cloud calculates the total quota usage for routing configurations that are part of a complete configuration using the following formula:

Quota usage = sum of single routing configuration quota units × number of forwarding rules referencing the same configuration through a target proxy

If a relationship between a forwarding rule, through a target proxy, to the routing configuration doesn't exist, the configuration doesn't contribute to the usage of a load balancer configuration size quota.

Manage quota usage

The usage of each configuration size quota changes as you modify Application Load Balancers or Proxy Network Load Balancers:

  • Updating a URL map or TLS route: Modifying an existing URL map or TLS route (such as adding or removing host rules, path matchers, route rules, or SNI host matches) changes the number of quota units that the configuration uses. The number of quota units is multiplied by the number of forwarding rules that reference the configuration through target proxies.
  • Updating a target proxy: If you update a target proxy to reference a different URL map or TLS route, and no other target proxy references the previous configuration, the quota units used by the previous configuration no longer contribute to the usage of a configuration size quota.
  • Creating or deleting a forwarding rule: Creating a new forwarding rule associated with a target proxy that uses a URL map or TLS route increases the number of quota units that the configuration contributes to a configuration size quota. Conversely, deleting a forwarding rule reduces the number of quota units that the configuration contributes to a configuration size quota.

Check quota usage

To determine the number of quota units an existing URL map uses, use the gcloud compute url-maps describe command:

gcloud compute url-maps describe URL_MAP_NAME \
   [--region=REGION_NAME | --global] \
   --format="value(status)"

Replace the following:

  • URL_MAP_NAME: the name of your URL map.
  • REGION_NAME: the region where you defined the load balancer.

The output includes a read-only status.quotaUsage object showing the total number of units calculated for the URL map, as well as the number of forwarding rules using it.

For more information, see Quotas and limits.

What's next