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