HEX
Server: Apache/2.4.65 (Ubuntu)
System: Linux ielts-store-v2 6.8.0-1036-gcp #38~22.04.1-Ubuntu SMP Thu Aug 14 01:19:18 UTC 2025 x86_64
User: root (0)
PHP: 7.2.34-54+ubuntu20.04.1+deb.sury.org+1
Disabled: pcntl_alarm,pcntl_fork,pcntl_waitpid,pcntl_wait,pcntl_wifexited,pcntl_wifstopped,pcntl_wifsignaled,pcntl_wifcontinued,pcntl_wexitstatus,pcntl_wtermsig,pcntl_wstopsig,pcntl_signal,pcntl_signal_get_handler,pcntl_signal_dispatch,pcntl_get_last_error,pcntl_strerror,pcntl_sigprocmask,pcntl_sigwaitinfo,pcntl_sigtimedwait,pcntl_exec,pcntl_getpriority,pcntl_setpriority,pcntl_async_signals,
Upload Files
File: //snap/google-cloud-cli/current/help/man/man1/gcloud_network-security_firewall-endpoints_update.1
.TH "GCLOUD_NETWORK\-SECURITY_FIREWALL\-ENDPOINTS_UPDATE" 1



.SH "NAME"
.HP
gcloud network\-security firewall\-endpoints update \- update a Firewall Plus endpoint



.SH "SYNOPSIS"
.HP
\f5gcloud network\-security firewall\-endpoints update\fR (\fIFIREWALL_ENDPOINT\fR\ :\ \fB\-\-organization\fR=\fIORGANIZATION\fR\ \fB\-\-zone\fR=\fIZONE\fR) [\fB\-\-async\fR] [\fB\-\-description\fR=\fIDESCRIPTION\fR] [\fB\-\-max\-wait\fR=\fIMAX_WAIT\fR;\ default="60m"] [\fB\-\-update\-billing\-project\fR=\fIBILLING_PROJECT\fR] [\fB\-\-update\-labels\fR=[\fIKEY\fR=\fIVALUE\fR,...]] [\fB\-\-clear\-labels\fR\ |\ \fB\-\-remove\-labels\fR=[\fIKEY\fR,...]] [\fIGCLOUD_WIDE_FLAG\ ...\fR]



.SH "DESCRIPTION"

Update a firewall endpoint. Check the progress of endpoint update by using
\f5gcloud network\-security firewall\-endpoints describe\fR.

For more examples, refer to the EXAMPLES section below.



.SH "EXAMPLES"

To update labels k1 and k2, run:

.RS 2m
$ gcloud network\-security firewall\-endpoints update my\-endpoint \e
    \-\-zone=us\-central1\-a \-\-organization=1234 \e
    \-\-update\-labels=k1=v1,k2=v2
.RE

To remove labels k3 and k4, run:

.RS 2m
$ gcloud network\-security firewall\-endpoints update my\-endpoint \e
    \-\-zone=us\-central1\-a \-\-organization=1234 \-\-remove\-labels=k3,k4
.RE

To clear all labels from the firewall endpoint, run:

.RS 2m
$ gcloud network\-security firewall\-endpoints update my\-endpoint \e
    \-\-zone=us\-central1\-a \-\-organization=1234 \-\-clear\-labels
.RE



.SH "POSITIONAL ARGUMENTS"

.RS 2m
.TP 2m

Firewall endpoint resource \- Firewall Plus. The arguments in this group can be
used to specify the attributes of this resource.

This must be specified.


.RS 2m
.TP 2m
\fIFIREWALL_ENDPOINT\fR

ID of the firewall endpoint or fully qualified identifier for the firewall
endpoint.

To set the \f5endpoint\-name\fR attribute:
.RS 2m
.IP "\(bu" 2m
provide the argument \f5FIREWALL_ENDPOINT\fR on the command line.
.RE
.sp

This positional argument must be specified if any of the other arguments in this
group are specified.

.TP 2m
\fB\-\-organization\fR=\fIORGANIZATION\fR

Organization ID of the firewall endpoint.

To set the \f5organization\fR attribute:
.RS 2m
.IP "\(bu" 2m
provide the argument \f5FIREWALL_ENDPOINT\fR on the command line with a fully
specified name;
.IP "\(bu" 2m
provide the argument \f5\-\-organization\fR on the command line.
.RE
.sp

.TP 2m
\fB\-\-zone\fR=\fIZONE\fR

Zone of the firewall endpoint.

To set the \f5zone\fR attribute:
.RS 2m
.IP "\(bu" 2m
provide the argument \f5FIREWALL_ENDPOINT\fR on the command line with a fully
specified name;
.IP "\(bu" 2m
provide the argument \f5\-\-zone\fR on the command line.
.RE
.sp


.RE
.RE
.sp

.SH "FLAGS"

.RS 2m
.TP 2m
\fB\-\-async\fR

Return immediately, without waiting for the operation in progress to complete.
The default is \fBTrue\fR. Enabled by default, use \fB\-\-no\-async\fR to
disable.

.TP 2m
\fB\-\-description\fR=\fIDESCRIPTION\fR

Description of the endpoint

.TP 2m
\fB\-\-max\-wait\fR=\fIMAX_WAIT\fR; default="60m"

Time to synchronously wait for the operation to complete, after which the
operation continues asynchronously. Ignored if \-\-no\-async isn't specified.
See $ gcloud topic datetimes for information on time formats.

.TP 2m
\fB\-\-update\-billing\-project\fR=\fIBILLING_PROJECT\fR

The Google Cloud project ID to use for API enablement check, quota, and endpoint
uptime billing. Overrides the default \fBbilling/quota_project\fR property value
for this command invocation.

.TP 2m
\fB\-\-update\-labels\fR=[\fIKEY\fR=\fIVALUE\fR,...]

List of label KEY=VALUE pairs to update. If a label exists, its value is
modified. Otherwise, a new label is created.

Keys must start with a lowercase character and contain only hyphens (\f5\-\fR),
underscores (\f5_\fR), lowercase characters, and numbers. Values must contain
only hyphens (\f5\-\fR), underscores (\f5_\fR), lowercase characters, and
numbers.

.TP 2m

At most one of these can be specified:


.RS 2m
.TP 2m
\fB\-\-clear\-labels\fR

Remove all labels. If \f5\-\-update\-labels\fR is also specified then
\f5\-\-clear\-labels\fR is applied first.

For example, to remove all labels:

.RS 2m
$ gcloud network\-security firewall\-endpoints update \-\-clear\-labels
.RE

To remove all existing labels and create two new labels, \f5\fIfoo\fR\fR and
\f5\fIbaz\fR\fR:

.RS 2m
$ gcloud network\-security firewall\-endpoints update \-\-clear\-labels \e
  \-\-update\-labels foo=bar,baz=qux
.RE

.TP 2m
\fB\-\-remove\-labels\fR=[\fIKEY\fR,...]

List of label keys to remove. If a label does not exist it is silently ignored.
If \f5\-\-update\-labels\fR is also specified then \f5\-\-update\-labels\fR is
applied first.


.RE
.RE
.sp

.SH "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 \fB$ gcloud help\fR for details.



.SH "NOTES"

These variants are also available:

.RS 2m
$ gcloud alpha network\-security firewall\-endpoints update
.RE

.RS 2m
$ gcloud beta network\-security firewall\-endpoints update
.RE