.TH "GCLOUD_BETA_DATA\-FUSION_INSTANCES_CREATE" 1



.SH "NAME"
.HP
gcloud beta data\-fusion instances create \- create and initialize a Cloud Data Fusion instance



.SH "SYNOPSIS"
.HP
\f5gcloud beta data\-fusion instances create\fR (\fIINSTANCE\fR\ :\ \fB\-\-location\fR=\fILOCATION\fR) [\fB\-\-async\fR] [\fB\-\-edition\fR=\fIEDITION\fR;\ default="basic"] [\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\-\-tags\fR=[\fIKEY\fR=\fIVALUE\fR,...]] [\fB\-\-version\fR=\fIVERSION\fR] [\fB\-\-zone\fR=\fIZONE\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 create operations list
.RE



.SH "EXAMPLES"

To create instance \f5my\-instance\fR in project \f5my\-project\fR, location in
\f5my\-location\fR, and zone in \f5my\-zone\fR run:

.RS 2m
$ gcloud beta data\-fusion instances create my\-instance \e
    \-\-project=my\-project \-\-location=my\-location \-\-zone=my\-zone
.RE



.SH "POSITIONAL ARGUMENTS"

.RS 2m
.TP 2m

Instance resource \- Instance to create. 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\-\-edition\fR=\fIEDITION\fR; default="basic"

Edition of the Data Fusion instance to create. For example:
\f5\-\-edition=enterprise\fR. \fIEDITION\fR must be one of: \fBbasic\fR,
\fBenterprise\fR, \fBdeveloper\fR.

.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 creation, specified as KEY1=VALUE1,KEY2=VALUE2.

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

Patch revision version of Cloud Data Fusion to use when creating the
instance.For example: \f5\-\-patch_revision=6.9.2.1\fR.

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

List of tags KEY=VALUE pairs to bind. Each item must be specified in either ID
\f5<tag_Key_id>=<tag_value_id>\fR or Namespaced format
\f5<tag\-key\-namespaced\-name>=<tag\-value\-short\-name>\fR.

Example: \f5123/environment=production,123/costCenter=marketing\fR

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

The version of Cloud Data Fusion to use when creating the instance. For example:
\f5\-\-version=6.9.2\fR.

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

Compute Engine zone in which the instance will be created. Only needed for
DEVELOPER edition. For example: \f5\-\-zone=us\-central1\-a\fR.

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