- NAME
-
- gcloud alpha compute target-http-proxies update - update a target HTTP proxy
- SYNOPSIS
-
-
gcloud alpha compute target-http-proxies updateNAME[--url-map=URL_MAP] [--clear-http-filters|--http-filters=[HTTP_FILTERS,…]] [--clear-http-keep-alive-timeout-sec|--http-keep-alive-timeout-sec=HTTP_KEEP_ALIVE_TIMEOUT_SEC] [--global|--region=REGION] [--global-url-map|--url-map-region=URL_MAP_REGION] [GCLOUD_WIDE_FLAG …]
-
- DESCRIPTION
-
(ALPHA)gcloud alpha compute target-http-proxies updateis used to change the URL map of existing target HTTP proxies. A target HTTP proxy is referenced by one or more forwarding rules which specify the network traffic that the proxy is responsible for routing. The target HTTP proxy points to a URL map that defines the rules for routing the requests. The URL map's job is to map URLs to backend services which handle the actual requests. - EXAMPLES
-
If there is an already-created URL map with the name URL_MAP, update a global
target HTTP proxy pointing to this map by running:
gcloud alpha compute target-http-proxies update PROXY_NAME --url-map=URL_MAPUpdate a regional target HTTP proxy by running:
gcloud alpha compute target-http-proxies update PROXY_NAME --url-map=URL_MAP --region=REGION_NAME - POSITIONAL ARGUMENTS
-
NAME- Name of the target HTTP proxy to update.
- FLAGS
-
--url-map=URL_MAP- A reference to a URL map resource. A URL map defines the mapping of URLs to backend services. Before you can refer to a URL map, you must create the URL map. To delete a URL map that a target proxy is referring to, you must first delete the target HTTP proxy.
-
At most one of these can be specified:
--clear-http-filters- Clear existing HTTP filters.
-
Or at least one of these can be specified:
-
Http filter resource - The http filters to attach. This represents a Cloud
resource. (NOTE) Some attributes are not given arguments in this group but can
be set in other ways.
To set the
projectattribute:-
provide the argument
--http-filterson the command line with a fully specified name; -
provide the argument
--projecton the command line; -
set the property
core/project.
To set the
locationattribute:-
provide the argument
--http-filterson the command line with a fully specified name; -
provide the argument
--regionon the command line; - default value of location is [global].
-
provide the argument
--http-filters=[HTTP_FILTERS,…]-
IDs of the http filters or fully qualified identifiers for the http filters.
To set the
http_filterattribute:-
provide the argument
--http-filterson the command line.
-
provide the argument
-
Http filter resource - The http filters to attach. This represents a Cloud
resource. (NOTE) Some attributes are not given arguments in this group but can
be set in other ways.
-
At most one of these can be specified:
--clear-http-keep-alive-timeout-sec- Clears the previously configured HTTP keepalive timeout.
--http-keep-alive-timeout-sec=HTTP_KEEP_ALIVE_TIMEOUT_SEC- Represents the maximum amount of time that a TCP connection can be idle between the (downstream) client and the target HTTP proxy. If an HTTP keepalive timeout is not specified, the default value is 610 seconds. For global external Application Load Balancers, the minimum allowed value is 5 seconds and the maximum allowed value is 1200 seconds.
-
At most one of these can be specified:
--global- If set, the target HTTP proxy is global.
--region=REGION-
Region of the target HTTP proxy to update. If not specified, you might be
prompted to select a region (interactive mode only).
To avoid prompting when this flag is omitted, you can set the
property:compute/regiongcloud config set compute/region REGIONA list of regions can be fetched by running:
gcloud compute regions listTo unset the property, run:
gcloud config unset compute/regionAlternatively, the region can be stored in the environment variable
.CLOUDSDK_COMPUTE_REGION
-
At most one of these can be specified:
--global-url-map- If set, the URL map is global.
--url-map-region=URL_MAP_REGION-
Region of the URL map to operate on. Overrides the default
compute/regionproperty value for this command invocation.
- GCLOUD WIDE FLAGS
-
These flags are available to all commands:
--access-token-file,--account,--billing-project,--configuration,--flags-file,--flatten,--format,--help,--impersonate-service-account,--log-http,--project,--quiet,--trace-token,--user-output-enabled,--verbosity.Run
$ gcloud helpfor details. - NOTES
-
This command is currently in alpha and might change without notice. If this
command fails with API permission errors despite specifying the correct project,
you might be trying to access an API with an invitation-only early access
allowlist. These variants are also available:
gcloud compute target-http-proxies updategcloud beta compute target-http-proxies updategcloud preview compute target-http-proxies update
gcloud alpha compute target-http-proxies update
Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License, and code samples are licensed under the Apache 2.0 License. For details, see the Google Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.
Last updated 2026-08-18 UTC.