File: //snap/google-cloud-cli/396/help/man/man1/gcloud_eventarc_google-channels_update.1
.TH "GCLOUD_EVENTARC_GOOGLE\-CHANNELS_UPDATE" 1
.SH "NAME"
.HP
gcloud eventarc google\-channels update \- update an Eventarc Google channel
.SH "SYNOPSIS"
.HP
\f5gcloud eventarc google\-channels update\fR [\fB\-\-location\fR=\fILOCATION\fR] [\fB\-\-update\-labels\fR=[\fIKEY\fR=\fIVALUE\fR,...]] [\fB\-\-clear\-crypto\-key\fR\ |\ \fB\-\-crypto\-key\fR=\fICRYPTO_KEY\fR] [\fB\-\-clear\-labels\fR\ |\ \fB\-\-remove\-labels\fR=[\fIKEY\fR,...]] [\fIGCLOUD_WIDE_FLAG\ ...\fR]
.SH "DESCRIPTION"
Update an Eventarc Google channel.
.SH "EXAMPLES"
To update the Google channel in location \f5us\-central1\fR, run:
.RS 2m
$ gcloud eventarc google\-channels update \-\-location=us\-central1
.RE
To configure the Google channel in location \f5us\-central1\fR with a Cloud KMS
CryptoKey, run:
.RS 2m
$ gcloud eventarc google\-channels update \-\-location=us\-central1 \e
\-\-crypto\-key=projects/PROJECT_ID/locations/KMS_LOCATION/\e
keyRings/KEYRING/cryptoKeys/KEY
.RE
.SH "FLAGS"
.RS 2m
.TP 2m
Location resource \- The location of the Google Channel. 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 \f5project\fR attribute:
.RS 2m
.IP "\(em" 2m
provide the argument \f5\-\-location\fR on the command line with a fully
specified name;
.IP "\(em" 2m
set the property \f5eventarc/location\fR with a fully specified name;
.IP "\(em" 2m
provide the argument \f5\-\-project\fR on the command line;
.IP "\(em" 2m
set the property \f5core/project\fR.
.RE
.sp
.RS 2m
.TP 2m
\fB\-\-location\fR=\fILOCATION\fR
ID of the location or fully qualified identifier for the location.
To set the \f5location\fR attribute:
.RS 2m
.IP "\(bu" 2m
provide the argument \f5\-\-location\fR on the command line;
.IP "\(bu" 2m
set the property \f5eventarc/location\fR.
.RE
.sp
.RE
.sp
.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\-crypto\-key\fR
Remove the previously configured crypto key. The channel will continue to be
encrypted using Google\-managed keys.
.TP 2m
\fB\-\-crypto\-key\fR=\fICRYPTO_KEY\fR
Fully qualified name of the crypto key to use for customer\-managed encryption.
If this is unspecified, Google\-managed keys will be used for encryption.
.RE
.sp
.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 eventarc google\-channels 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 eventarc google\-channels 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.