URL map size and quota units

The load balancer configuration size quotas measure the size of all URL maps in a project, VPC network, or region of a VPC network, depending on the type of Application 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 the configuration of your URL map. 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 URL maps that are part of a complete Application Load Balancer configuration contribute to the usage of a load balancer configuration size quota. To be part of a complete configuration, a URL map must be referenced by a target HTTP proxy or target HTTPS proxy, and the target proxy must be referenced by a forwarding rule. Google Cloud calculates the total quota usage for URL maps that are part of a complete configuration using the following formula:

Quota usage = sum of single URL map quota units × number of forwarding rules referencing the same URL map through a target HTTP proxy or target HTTPS proxy

If a relationship between a forwarding rule, through a target HTTP proxy or target HTTPS proxy, to the URL map doesn't exist, the URL map 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:

  • Updating a URL map: Modifying an existing URL map (such as adding or removing host rules, path matchers, or route rules) changes the number of quota units that the URL map uses. The number of quota units is multiplied by the number of forwarding rules that reference the URL map through target HTTP proxies and target HTTPS proxies.
  • Updating a Target Proxy: If you update a target proxy to reference a different URL map, and no other target proxy references the previous URL map, the quota units used by the previous URL map 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 increases the number of quota units that the URL map contributes to a configuration size quota. Conversely, deleting a forwarding rule reduces the number of quota units that the URL map contributes to a configuration size quota.

Check quota usage

To determine the number of quota units an existing URL map uses, use the following Google Cloud CLI command:

gcloud beta 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 in which the load balancer is defined.

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