.TH "GCLOUD_DATABASE\-MIGRATION_CONVERSION\-WORKSPACES_CREATE" 1



.SH "NAME"
.HP
gcloud database\-migration conversion\-workspaces create \- create a Database Migration Service conversion workspace



.SH "SYNOPSIS"
.HP
\f5gcloud database\-migration conversion\-workspaces create\fR (\fICONVERSION_WORKSPACE\fR\ :\ \fB\-\-region\fR=\fIREGION\fR) \fB\-\-destination\-database\-engine\fR=\fIDESTINATION_DATABASE_ENGINE\fR \fB\-\-source\-database\-engine\fR=\fISOURCE_DATABASE_ENGINE\fR [\fB\-\-no\-async\fR] [\fB\-\-destination\-database\-provider\fR=\fIDESTINATION_DATABASE_PROVIDER\fR;\ default="CLOUDSQL"] [\fB\-\-destination\-database\-version\fR=\fIDESTINATION_DATABASE_VERSION\fR;\ default="unspecified"] [\fB\-\-display\-name\fR=\fIDISPLAY_NAME\fR] [\fB\-\-global\-settings\fR=[\fIKEY\fR=\fIVALUE\fR,...]] [\fB\-\-source\-database\-provider\fR=\fISOURCE_DATABASE_PROVIDER\fR;\ default="UNSPECIFIED"] [\fB\-\-source\-database\-version\fR=\fISOURCE_DATABASE_VERSION\fR;\ default="unspecified"] [\fIGCLOUD_WIDE_FLAG\ ...\fR]



.SH "DESCRIPTION"

Create a Database Migration Service conversion workspace.



.SH "EXAMPLES"

To create a conversion workspace:

.RS 2m
$ gcloud database\-migration conversion\-workspaces create \e
  my\-conversion\-workspace \-\-region=us\-central1 \e
  \-\-display\-name=cw1 \-\-source\-database\-engine=ORACLE \e
  \-\-source\-database\-version=11 \e
  \-\-destination\-database\-engine=POSTGRESQL \e
  \-\-destination\-database\-version=15
.RE



.SH "POSITIONAL ARGUMENTS"

.RS 2m
.TP 2m

Conversion workspace resource \- The conversion workspace 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 \f5conversion_workspace\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
\fICONVERSION_WORKSPACE\fR

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

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

The Cloud region for the conversion_workspace.

To set the \f5region\fR attribute:
.RS 2m
.IP "\(bu" 2m
provide the argument \f5conversion_workspace\fR on the command line with a fully
specified name;
.IP "\(bu" 2m
provide the argument \f5\-\-region\fR on the command line.
.RE
.sp


.RE
.RE
.sp

.SH "REQUIRED FLAGS"

.RS 2m
.TP 2m
\fB\-\-destination\-database\-engine\fR=\fIDESTINATION_DATABASE_ENGINE\fR

Destination database engine type. \fIDESTINATION_DATABASE_ENGINE\fR must be
(only one value is supported): \fBPOSTGRESQL\fR.

.TP 2m
\fB\-\-source\-database\-engine\fR=\fISOURCE_DATABASE_ENGINE\fR

Source database engine type. \fISOURCE_DATABASE_ENGINE\fR must be one of:
\fBORACLE\fR, \fBSQL_SERVER\fR.


.RE
.sp

.SH "OPTIONAL FLAGS"

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

Waits for the operation in progress to complete before returning.

.TP 2m
\fB\-\-destination\-database\-provider\fR=\fIDESTINATION_DATABASE_PROVIDER\fR; default="CLOUDSQL"

Destination database provider. \fIDESTINATION_DATABASE_PROVIDER\fR must be one
of: \fBALLOYDB\fR, \fBCLOUDSQL\fR.

.TP 2m
\fB\-\-destination\-database\-version\fR=\fIDESTINATION_DATABASE_VERSION\fR; default="unspecified"

Version number for the database engine. The version number must contain numbers
and letters only. Example for PostgreSQL 17.0, version number will be 17.0.

.TP 2m
\fB\-\-display\-name\fR=\fIDISPLAY_NAME\fR

A user\-friendly name for the conversion workspace. The display name can include
letters, numbers, spaces, and hyphens, and must start with a letter. The maximum
length allowed is 60 characters.

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

A generic list of settings for the workspace. The settings are database pair
dependant and can indicate default behavior for the mapping rules engine or turn
on or off specific features. An object containing a list of "key": "value"
pairs.

.TP 2m
\fB\-\-source\-database\-provider\fR=\fISOURCE_DATABASE_PROVIDER\fR; default="UNSPECIFIED"

Source database provider. \fISOURCE_DATABASE_PROVIDER\fR must be one of:
\fBAMAZON_RDS\fR, \fBAZURE_MANAGED_INSTANCE\fR, \fBAZURE_SQL_DATABASE\fR,
\fBCLOUDSQL\fR, \fBUNSPECIFIED\fR.

.TP 2m
\fB\-\-source\-database\-version\fR=\fISOURCE_DATABASE_VERSION\fR; default="unspecified"

Version number for the database engine. The version number must contain numbers
and letters only. Example for Oracle 21c, version number will be 21c.


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