.TH "GCLOUD_ORACLE\-DATABASE_AUTONOMOUS\-DATABASES_CREATE" 1



.SH "NAME"
.HP
gcloud oracle\-database autonomous\-databases create \- create a new AutonomousDatabase



.SH "SYNOPSIS"
.HP
\f5gcloud oracle\-database autonomous\-databases create\fR \fIAUTONOMOUS_DATABASE\fR [\fB\-\-admin\-password\fR=\fIADMIN_PASSWORD\fR] [\fB\-\-async\fR] [\fB\-\-cidr\fR=\fICIDR\fR] [\fB\-\-database\fR=\fIDATABASE\fR] [\fB\-\-display\-name\fR=\fIDISPLAY_NAME\fR] [\fB\-\-labels\fR=[\fILABELS\fR,...]] [\fB\-\-location\fR=\fILOCATION\fR] [\fB\-\-network\fR=\fINETWORK\fR] [\fB\-\-odb\-network\fR=\fIODB_NETWORK\fR] [\fB\-\-odb\-subnet\fR=\fIODB_SUBNET\fR] [\fB\-\-request\-id\fR=\fIREQUEST_ID\fR] [[\fB\-\-properties\-db\-workload\fR=\fIPROPERTIES_DB_WORKLOAD\fR\ \fB\-\-properties\-license\-type\fR=\fIPROPERTIES_LICENSE_TYPE\fR\ :\ \fB\-\-properties\-allowlisted\-ips\fR=[\fIPROPERTIES_ALLOWLISTED_IPS\fR,...]\ \fB\-\-properties\-backup\-retention\-period\-days\fR=\fIPROPERTIES_BACKUP_RETENTION_PERIOD_DAYS\fR\ \fB\-\-properties\-character\-set\fR=\fIPROPERTIES_CHARACTER_SET\fR\ \fB\-\-properties\-compute\-count\fR=\fIPROPERTIES_COMPUTE_COUNT\fR\ \fB\-\-properties\-cpu\-core\-count\fR=\fIPROPERTIES_CPU_CORE_COUNT\fR\ \fB\-\-properties\-customer\-contacts\fR=[\fIemail\fR=\fIEMAIL\fR]\ \fB\-\-properties\-data\-storage\-size\-gb\fR=\fIPROPERTIES_DATA_STORAGE_SIZE_GB\fR\ \fB\-\-properties\-data\-storage\-size\-tb\fR=\fIPROPERTIES_DATA_STORAGE_SIZE_TB\fR\ \fB\-\-properties\-db\-edition\fR=\fIPROPERTIES_DB_EDITION\fR\ \fB\-\-properties\-db\-version\fR=\fIPROPERTIES_DB_VERSION\fR\ \fB\-\-properties\-is\-auto\-scaling\-enabled\fR\ \fB\-\-properties\-is\-storage\-auto\-scaling\-enabled\fR\ \fB\-\-properties\-maintenance\-schedule\-type\fR=\fIPROPERTIES_MAINTENANCE_SCHEDULE_TYPE\fR\ \fB\-\-properties\-mtls\-connection\-required\fR\ \fB\-\-properties\-n\-character\-set\fR=\fIPROPERTIES_N_CHARACTER_SET\fR\ \fB\-\-properties\-private\-endpoint\-ip\fR=\fIPROPERTIES_PRIVATE_ENDPOINT_IP\fR\ \fB\-\-properties\-private\-endpoint\-label\fR=\fIPROPERTIES_PRIVATE_ENDPOINT_LABEL\fR\ \fB\-\-properties\-secret\-id\fR=\fIPROPERTIES_SECRET_ID\fR\ \fB\-\-properties\-vault\-id\fR=\fIPROPERTIES_VAULT_ID\fR\ \fB\-\-encryption\-key\-provider\fR=\fIENCRYPTION_KEY_PROVIDER\fR\ [\fB\-\-encryption\-key\-kms\fR=\fIENCRYPTION_KEY_KMS\fR\ :\ \fB\-\-key\-ring\fR=\fIKEY_RING\fR]]] [\fB\-\-source\-config\-automatic\-backups\-replication\-enabled\fR\ \fB\-\-source\-config\-autonomous\-database\fR=\fISOURCE_CONFIG_AUTONOMOUS_DATABASE\fR] [\fIGCLOUD_WIDE_FLAG\ ...\fR]



.SH "DESCRIPTION"

Create a new AutonomousDatabase.



.SH "EXAMPLES"

To create AutonomousDatabase with id \f5my\-instance\fR in the location
\f5us\-east4\fR with display\-name \f5my instance\fR, odb\-network
\f5projects/network\-project/locations/us\-east4/odbNetworks/my\-odbnetwork\fR,
odb\-subnet
\f5projects/network\-project/locations/us\-east4/odbNetworks/my\-odbnetwork/odbSubnets/my\-odbsubnet\fR,
network \f5projects/my\-project/locations/global/networks/default\fR, location
\f5us\-east4\fR, database \f5testadb\fR, admin\-password \f5123Abpassdord\fR,
cidr \f512.2.0.0/24\fR, properties\-compute\-count \f52\fR,
properties\-db\-version \f519c\fR, properties\-license\-type
\f5LICENSE_INCLUDED\fR, properties\-db\-workload \f5DW\fR. run: To set the
network configuration use one of the following options:

ODBNetwork based configuration(This is the recommended way):

.RS 2m
$ gcloud oracle\-database autonomous\-databases create my\-instance \e
    \-\-location=us\-east4 \-\-display\-name="my instance" \e
    \-\-location=us\-east4 \-\-database=testadb \e
    \-\-admin\-password=123Abpassdord \-\-properties\-compute\-count=2 \e
    \-\-properties\-db\-version=19c \e
    \-\-properties\-license\-type=LICENSE_INCLUDED \e
    \-\-properties\-db\-workload=DW \e
    \-\-odb\-network=projects/network\-project/locations/us\-east4/\e
odbNetworks/my\-odbnetwork \e
    \-\-odb\-subnet=projects/network\-project/locations/us\-east4/\e
odbNetworks/my\-odbnetwork/odbSubnets/my\-odbsubnet
.RE

Network and CIDR based configuration:

.RS 2m
$ gcloud oracle\-database autonomous\-databases create my\-instance \e
    \-\-location=us\-east4 \-\-display\-name="my instance" \e
    \-\-network=projects/my\-project/locations/global/networks/\e
default \-\-cidr=12.2.0.0/24 \-\-location=us\-east4 \-\-database=testadb \e
    \-\-admin\-password=123Abpassdord \-\-properties\-compute\-count=2 \e
    \-\-properties\-db\-version=19c \e
    \-\-properties\-license\-type=LICENSE_INCLUDED \e
    \-\-properties\-db\-workload=DW
.RE



.SH "POSITIONAL ARGUMENTS"

.RS 2m
.TP 2m

AutonomousDatabase resource \- Identifier. The name of the Autonomous Database
resource in the following format:
projects/{project}/locations/{region}/autonomousDatabases/{autonomous_database}
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 \f5autonomous_database\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

To set the \f5location\fR attribute:
.RS 2m
.IP "\(em" 2m
provide the argument \f5autonomous_database\fR on the command line with a fully
specified name;
.IP "\(em" 2m
provide the argument \f5\-\-location\fR on the command line.
.RE
.sp

This must be specified.


.RS 2m
.TP 2m
\fIAUTONOMOUS_DATABASE\fR

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

To set the \f5autonomous_database\fR attribute:
.RS 2m
.IP "\(bu" 2m
provide the argument \f5autonomous_database\fR on the command line.
.RE
.sp


.RE
.RE
.sp

.SH "FLAGS"

.RS 2m
.TP 2m
\fB\-\-admin\-password\fR=\fIADMIN_PASSWORD\fR

The password for the default ADMIN user.

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

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

.TP 2m
\fB\-\-cidr\fR=\fICIDR\fR

The subnet CIDR range for the Autonomous Database.

.TP 2m
\fB\-\-database\fR=\fIDATABASE\fR

The name of the Autonomous Database. The database name must be unique in the
project. The name must begin with a letter and can contain a maximum of 30
alphanumeric characters.

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

The display name for the Autonomous Database. The name does not have to be
unique within your project.

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

The labels or tags associated with the Autonomous Database.

.RS 2m
.TP 2m
\fBKEY\fR
Keys must start with a lowercase character and contain only hyphens (\f5\-\fR),
underscores (\f5_\fR), lowercase characters, and numbers.

.TP 2m
\fBVALUE\fR
Values must contain only hyphens (\f5\-\fR), underscores (\f5_\fR), lowercase
characters, and numbers.

.RE
.sp
\fBShorthand Example:\fR


.RS 2m
\-\-labels=string=string
.RE


\fBJSON Example:\fR


.RS 2m
\-\-labels='{"string": "string"}'
.RE


\fBFile Example:\fR


.RS 2m
\-\-labels=path_to_file.(yaml|json)
.RE


.TP 2m
\fB\-\-location\fR=\fILOCATION\fR

For resources [autonomous_database, encryption\-key\-kms, odb\-network,
odb\-subnet, source\-config\-autonomous\-database], provides fallback value for
resource location attribute. When the resource's full URI path is not provided,
location will fallback to this flag value.

.TP 2m

Network resource \- The name of the VPC network used by the Autonomous Database
in the following format: projects/{project}/global/networks/{network} 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\-\-network\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


.RS 2m
.TP 2m
\fB\-\-network\fR=\fINETWORK\fR

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

To set the \f5network\fR attribute:
.RS 2m
.IP "\(bu" 2m
provide the argument \f5\-\-network\fR on the command line.
.RE
.sp

.RE
.sp
.TP 2m
\fB\-\-odb\-network\fR=\fIODB_NETWORK\fR

For resources [odb\-network, odb\-subnet], provides fallback value for resource
odb\-network attribute. When the resource's full URI path is not provided,
odb\-network will fallback to this flag value.

.TP 2m

OdbSubnet resource \- The name of the OdbSubnet associated with the Autonomous
Database. Format:
projects/{project}/locations/{location}/odbNetworks/{odb_network}/odbSubnets/{odb_subnet}
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\-\-odb\-subnet\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

To set the \f5location\fR attribute:
.RS 2m
.IP "\(em" 2m
provide the argument \f5\-\-odb\-subnet\fR on the command line with a fully
specified name;
.IP "\(em" 2m
provide the argument \f5\-\-location\fR on the command line.
.RE
.sp

To set the \f5odb\-network\fR attribute:
.RS 2m
.IP "\(em" 2m
provide the argument \f5\-\-odb\-subnet\fR on the command line with a fully
specified name;
.IP "\(em" 2m
provide the argument \f5\-\-odb\-network\fR on the command line.
.RE
.sp


.RS 2m
.TP 2m
\fB\-\-odb\-subnet\fR=\fIODB_SUBNET\fR

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

To set the \f5odb\-subnet\fR attribute:
.RS 2m
.IP "\(bu" 2m
provide the argument \f5\-\-odb\-subnet\fR on the command line.
.RE
.sp

.RE
.sp
.TP 2m
\fB\-\-request\-id\fR=\fIREQUEST_ID\fR

An optional ID to identify the request. This value is used to identify duplicate
requests. If you make a request with the same request ID and the original
request is still in progress or completed, the server ignores the second
request. This prevents clients from accidentally creating duplicate commitments.

The request ID must be a valid UUID with the exception that zero UUID is not
supported (00000000\-0000\-0000\-0000\-000000000000).

.TP 2m

The properties of an Autonomous Database.


.RS 2m
.TP 2m
\fB\-\-properties\-db\-workload\fR=\fIPROPERTIES_DB_WORKLOAD\fR

The workload type of the Autonomous Database. \fIPROPERTIES_DB_WORKLOAD\fR must
be one of:

.RS 2m
.TP 2m
\fBajd\fR
Autonomous JSON Database.
.TP 2m
\fBapex\fR
Autonomous Database with the Oracle APEX Application Development workload type.
.TP 2m
\fBdw\fR
Autonomous Data Warehouse database.
.TP 2m
\fBoltp\fR
Autonomous Transaction Processing database.
.RE
.sp


This flag argument must be specified if any of the other arguments in this group
are specified.

.TP 2m
\fB\-\-properties\-license\-type\fR=\fIPROPERTIES_LICENSE_TYPE\fR

The license type used for the Autonomous Database. \fIPROPERTIES_LICENSE_TYPE\fR
must be one of:

.RS 2m
.TP 2m
\fBbring\-your\-own\-license\fR
Bring your own license
.TP 2m
\fBlicense\-included\fR
License included part of offer
.RE
.sp


This flag argument must be specified if any of the other arguments in this group
are specified.

.TP 2m
\fB\-\-properties\-allowlisted\-ips\fR=[\fIPROPERTIES_ALLOWLISTED_IPS\fR,...]

The list of allowlisted IP addresses for the Autonomous Database.

.TP 2m
\fB\-\-properties\-backup\-retention\-period\-days\fR=\fIPROPERTIES_BACKUP_RETENTION_PERIOD_DAYS\fR

The retention period for the Autonomous Database. This field is specified in
days, can range from 1 day to 60 days, and has a default value of 60 days.

.TP 2m
\fB\-\-properties\-character\-set\fR=\fIPROPERTIES_CHARACTER_SET\fR

The character set for the Autonomous Database. The default is AL32UTF8.

.TP 2m
\fB\-\-properties\-compute\-count\fR=\fIPROPERTIES_COMPUTE_COUNT\fR

The number of compute servers for the Autonomous Database.

.TP 2m
\fB\-\-properties\-cpu\-core\-count\fR=\fIPROPERTIES_CPU_CORE_COUNT\fR

The number of CPU cores to be made available to the database.

.TP 2m
\fB\-\-properties\-customer\-contacts\fR=[\fIemail\fR=\fIEMAIL\fR]

The list of customer contacts.

.RS 2m
.TP 2m
\fBemail\fR
The email address used by Oracle to send notifications regarding databases and
infrastructure.

.RE
.sp
\fBShorthand Example:\fR


.RS 2m
\-\-properties\-customer\-contacts=email=string \-\-properties\-customer\-contacts=email=string
.RE


\fBJSON Example:\fR


.RS 2m
\-\-properties\-customer\-contacts='[{"email": "string"}]'
.RE


\fBFile Example:\fR


.RS 2m
\-\-properties\-customer\-contacts=path_to_file.(yaml|json)
.RE


.TP 2m
\fB\-\-properties\-data\-storage\-size\-gb\fR=\fIPROPERTIES_DATA_STORAGE_SIZE_GB\fR

The size of the data stored in the database, in gigabytes.

.TP 2m
\fB\-\-properties\-data\-storage\-size\-tb\fR=\fIPROPERTIES_DATA_STORAGE_SIZE_TB\fR

The size of the data stored in the database, in terabytes.

.TP 2m
\fB\-\-properties\-db\-edition\fR=\fIPROPERTIES_DB_EDITION\fR

The edition of the Autonomous Databases. \fIPROPERTIES_DB_EDITION\fR must be one
of:

.RS 2m
.TP 2m
\fBenterprise\-edition\fR
Enterprise Database Edition
.TP 2m
\fBstandard\-edition\fR
Standard Database Edition
.RE
.sp


.TP 2m
\fB\-\-properties\-db\-version\fR=\fIPROPERTIES_DB_VERSION\fR

The Oracle Database version for the Autonomous Database.

.TP 2m
\fB\-\-properties\-is\-auto\-scaling\-enabled\fR

This field indicates if auto scaling is enabled for the Autonomous Database CPU
core count.

.TP 2m
\fB\-\-properties\-is\-storage\-auto\-scaling\-enabled\fR

This field indicates if auto scaling is enabled for the Autonomous Database
storage.

.TP 2m
\fB\-\-properties\-maintenance\-schedule\-type\fR=\fIPROPERTIES_MAINTENANCE_SCHEDULE_TYPE\fR

The maintenance schedule of the Autonomous Database.
\fIPROPERTIES_MAINTENANCE_SCHEDULE_TYPE\fR must be one of:

.RS 2m
.TP 2m
\fBearly\fR
An EARLY maintenance schedule patches the database before the regular scheduled
maintenance.
.TP 2m
\fBregular\fR
A REGULAR maintenance schedule follows the normal maintenance cycle.
.RE
.sp


.TP 2m
\fB\-\-properties\-mtls\-connection\-required\fR

This field specifies if the Autonomous Database requires mTLS connections.

.TP 2m
\fB\-\-properties\-n\-character\-set\fR=\fIPROPERTIES_N_CHARACTER_SET\fR

The national character set for the Autonomous Database. The default is
AL16UTF16.

.TP 2m
\fB\-\-properties\-private\-endpoint\-ip\fR=\fIPROPERTIES_PRIVATE_ENDPOINT_IP\fR

The private endpoint IP address for the Autonomous Database.

.TP 2m
\fB\-\-properties\-private\-endpoint\-label\fR=\fIPROPERTIES_PRIVATE_ENDPOINT_LABEL\fR

The private endpoint label for the Autonomous Database.

.TP 2m
\fB\-\-properties\-secret\-id\fR=\fIPROPERTIES_SECRET_ID\fR

The ID of the Oracle Cloud Infrastructure vault secret.

.TP 2m
\fB\-\-properties\-vault\-id\fR=\fIPROPERTIES_VAULT_ID\fR

The ID of the Oracle Cloud Infrastructure vault.

.TP 2m

The encryption key used to encrypt the Autonomous Database.


.RS 2m
.TP 2m
\fB\-\-encryption\-key\-provider\fR=\fIENCRYPTION_KEY_PROVIDER\fR

The provider of the encryption key. \fIENCRYPTION_KEY_PROVIDER\fR must be one
of:

.RS 2m
.TP 2m
\fBgoogle\-managed\fR
Google Managed KMS key, if selected, please provide the KMS key name.
.TP 2m
\fBoracle\-managed\fR
Oracle Managed.
.RE
.sp


.TP 2m

CryptoKey resource \- The KMS key used to encrypt the Autonomous Database. This
field is required if the provider is GOOGLE_MANAGED. The name of the KMS key
resource in the following format:
\f5projects/{project}/locations/{location}/keyRings/{key_ring}/cryptoKeys/{crypto_key}\fR.
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 \f5\-\-encryption\-key\-kms\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

To set the \f5location\fR attribute:
.RS 2m
.IP "\(em" 2m
provide the argument \f5\-\-encryption\-key\-kms\fR on the command line with a
fully specified name;
.IP "\(em" 2m
provide the argument \f5\-\-location\fR on the command line.
.RE
.sp


.RS 2m
.TP 2m
\fB\-\-encryption\-key\-kms\fR=\fIENCRYPTION_KEY_KMS\fR

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

To set the \f5crypto\-key\fR attribute:
.RS 2m
.IP "\(bu" 2m
provide the argument \f5\-\-encryption\-key\-kms\fR on the command line.
.RE
.sp

This flag argument must be specified if any of the other arguments in this group
are specified.

.TP 2m
\fB\-\-key\-ring\fR=\fIKEY_RING\fR

The keyRing id of the cryptoKey resource.

To set the \f5key\-ring\fR attribute:
.RS 2m
.IP "\(bu" 2m
provide the argument \f5\-\-encryption\-key\-kms\fR on the command line with a
fully specified name;
.IP "\(bu" 2m
provide the argument \f5\-\-key\-ring\fR on the command line.
.RE
.sp

.RE
.RE
.RE
.sp
.TP 2m

The source configuration for the standby Autonomous Database.


.RS 2m
.TP 2m
\fB\-\-source\-config\-automatic\-backups\-replication\-enabled\fR

This field specifies if the replication of automatic backups is enabled when
creating a Data Guard.

.TP 2m

AutonomousDatabase resource \- The name of the primary Autonomous Database that
is used to create a Peer Autonomous Database from a source. 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 "\(bu" 2m
provide the argument \f5\-\-source\-config\-autonomous\-database\fR on the
command line with a fully specified name;
.IP "\(bu" 2m
provide the argument \f5\-\-project\fR on the command line;
.IP "\(bu" 2m
set the property \f5core/project\fR.
.RE
.sp

To set the \f5location\fR attribute:
.RS 2m
.IP "\(bu" 2m
provide the argument \f5\-\-source\-config\-autonomous\-database\fR on the
command line with a fully specified name;
.IP "\(bu" 2m
provide the argument \f5\-\-location\fR on the command line.
.RE
.sp


.RS 2m
.TP 2m
\fB\-\-source\-config\-autonomous\-database\fR=\fISOURCE_CONFIG_AUTONOMOUS_DATABASE\fR

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

To set the \f5autonomous\-database\fR attribute:
.RS 2m
.IP "\(em" 2m
provide the argument \f5\-\-source\-config\-autonomous\-database\fR on the
command line.
.RE
.sp


.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 "API REFERENCE"

This command uses the \fBoracledatabase/v1\fR API. The full documentation for
this API can be found at: https://cloud.google.com/oracle/database/docs