.TH "GCLOUD_EVENTARC_CHANNELS_UPDATE" 1



.SH "NAME"
.HP
gcloud eventarc channels update \- update an Eventarc channel



.SH "SYNOPSIS"
.HP
\f5gcloud eventarc channels update\fR (\fICHANNEL\fR\ :\ \fB\-\-location\fR=\fILOCATION\fR) [\fB\-\-async\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 channel.



.SH "EXAMPLES"

To update the channel \f5my\-channel\fR in location \f5us\-central1\fR, run:

.RS 2m
$ gcloud eventarc channels update my\-channel \-\-location=us\-central1
.RE

To configure the channel \f5my\-channel\fR in location \f5us\-central1\fR with a
Cloud KMS CryptoKey, run:

.RS 2m
$ gcloud eventarc channels update my\-channel \e
    \-\-location=us\-central1 \e
    \-\-crypto\-key=projects/PROJECT_ID/locations/KMS_LOCATION/\e
keyRings/KEYRING/cryptoKeys/KEY
.RE



.SH "POSITIONAL ARGUMENTS"

.RS 2m
.TP 2m

Channel resource \- Channel to update. The arguments in this group can be used
to specify the attributes of this 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 \f5channel\fR on the command line 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

This must be specified.


.RS 2m
.TP 2m
\fICHANNEL\fR

ID of the channel or fully qualified identifier for the channel.

To set the \f5channel\fR attribute:
.RS 2m
.IP "\(bu" 2m
provide the argument \f5channel\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\-\-location\fR=\fILOCATION\fR

The location for the Eventarc channel, which should be either \f5\fIglobal\fR\fR
or one of the supported regions. Alternatively, set the [eventarc/location]
property.

To set the \f5location\fR attribute:
.RS 2m
.IP "\(bu" 2m
provide the argument \f5channel\fR on the command line with a fully specified
name;
.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
.RE
.sp

.SH "FLAGS"

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

Return immediately, without waiting for the operation in progress to complete.

.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 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 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.