.TH "GCLOUD_BETA_DATA\-FUSION_INSTANCES_UPDATE" 1



.SH "NAME"
.HP
gcloud beta data\-fusion instances update \- updates a Cloud Data Fusion instance



.SH "SYNOPSIS"
.HP
\f5gcloud beta data\-fusion instances update\fR (\fIINSTANCE\fR\ :\ \fB\-\-location\fR=\fILOCATION\fR) [\fB\-\-async\fR] [\fB\-\-enable_rbac\fR] [\fB\-\-enable_stackdriver_logging\fR] [\fB\-\-enable_stackdriver_monitoring\fR] [\fB\-\-labels\fR=[\fIKEY\fR=\fIVALUE\fR,...]] [\fB\-\-options\fR=[\fIKEY\fR=\fIVALUE\fR,...]] [\fB\-\-patch_revision\fR=\fIPATCH_REVISION\fR] [\fB\-\-version\fR=\fIVERSION\fR] [\fB\-\-clear\-maintenance\-window\fR\ |\ \fB\-\-maintenance\-window\-end\fR=\fIMAINTENANCE_WINDOW_END\fR\ \fB\-\-maintenance\-window\-recurrence\fR=\fIMAINTENANCE_WINDOW_RECURRENCE\fR\ \fB\-\-maintenance\-window\-start\fR=\fIMAINTENANCE_WINDOW_START\fR] [\fIGCLOUD_WIDE_FLAG\ ...\fR]



.SH "DESCRIPTION"

\fB(BETA)\fR If run asynchronously with \f5\-\-async\fR, exits after printing an
operation that can be used to poll the status of the creation operation via:

.RS 2m
gcloud beta data\-fusion instances update operations list
.RE



.SH "EXAMPLES"

To update instance 'my\-instance' in project 'my\-project' and location
\'my\-location' to version \f56.9.2\fR, run:

.RS 2m
$ gcloud beta data\-fusion instances update \-\-project=my\-project \e
    \-\-location=my\-location \-\-version=6.9.2 my\-instance
.RE

To update instance 'my\-instance' in project 'my\-project' and location
\'my\-location' to patch revision '6.9.2.1', run:

.RS 2m
$ gcloud beta data\-fusion instances update \-\-project=my\-project \e
    \-\-location=my\-location \-\-version=6.9.2 \e
    \-\-patch_revision=6.9.2.1 my\-instance
.RE



.SH "POSITIONAL ARGUMENTS"

.RS 2m
.TP 2m

Instance resource \- Instance 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 \f5instance\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
\fIINSTANCE\fR

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

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

Compute Engine region in which to create the instance.

To set the \f5location\fR attribute:
.RS 2m
.IP "\(bu" 2m
provide the argument \f5instance\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 \f5datafusion/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\-\-enable_rbac\fR

Enable granular role\-based access control for this Data Fusion instance.

.TP 2m
\fB\-\-enable_stackdriver_logging\fR

Enable Stackdriver logging for this Data Fusion instance.

.TP 2m
\fB\-\-enable_stackdriver_monitoring\fR

Enable Stackdriver monitoring for this Data Fusion instance.

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

List of label KEY=VALUE pairs to add.

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
\fB\-\-options\fR=[\fIKEY\fR=\fIVALUE\fR,...]

Options to use for instance update, specified as KEY1=VALUE1,KEY2=VALUE2.

.TP 2m
\fB\-\-patch_revision\fR=\fIPATCH_REVISION\fR

Patch revision version of Cloud Data Fusion to update to.

.TP 2m
\fB\-\-version\fR=\fIVERSION\fR

Version of Datafusion to update to.

.TP 2m

At most one of these can be specified:


.RS 2m
.TP 2m
\fB\-\-clear\-maintenance\-window\fR

Clear the maintenance window for this Data Fusion instance.

.TP 2m

Group of arguments for setting the maintenance window value.


.RS 2m
.TP 2m
\fB\-\-maintenance\-window\-end\fR=\fIMAINTENANCE_WINDOW_END\fR

The end time of the maintenance window. Only the time of the day is used as a
reference for an ending time of the window with a provided recurrence. This will
be used in conjunction with start time, and the difference will determine the
length of a single maintenance window. This flag must be specified if any of the
other arguments in this group are specified. For example:
\-\-maintenance_window_end=2024\-01\-02T01:00:00Z. See $ gcloud topic datetimes
for information on time formats.

.TP 2m
\fB\-\-maintenance\-window\-recurrence\fR=\fIMAINTENANCE_WINDOW_RECURRENCE\fR

An RFC 5545 RRULE, specifying how the maintenance window will recur. Only
FREQ=WEEKLY format is supported. This flag must be specified if any of the other
arguments in this group are specified. For example:
\-\-maintenance_window_recurrence="FREQ=WEEKLY;BYDAY=FR,SA,SU".

.TP 2m
\fB\-\-maintenance\-window\-start\fR=\fIMAINTENANCE_WINDOW_START\fR

The start time of the maintenance window. Only the time of the day is used as a
reference for a starting time of the window with a provided recurrence. This
flag must be specified if any of the other arguments in this group are
specified. For example: \-\-maintenance_window_start=2024\-01\-01T01:00:00Z. See
$ gcloud topic datetimes for information on time formats.


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

This command is currently in beta and might change without notice.