gcloud oracle-database cloud-vm-clusters create

NAME
gcloud oracle-database cloud-vm-clusters create - create a new CloudVmCluster
SYNOPSIS
gcloud oracle-database cloud-vm-clusters createCLOUD_VM_CLUSTER--exadata-infrastructure=EXADATA_INFRASTRUCTURE[--async][--backup-odb-subnet=BACKUP_ODB_SUBNET][--backup-subnet-cidr=BACKUP_SUBNET_CIDR][--cidr=CIDR][--display-name=DISPLAY_NAME][--labels=[LABELS,…]][--location=LOCATION][--network=NETWORK][--odb-network=ODB_NETWORK][--odb-subnet=ODB_SUBNET][--request-id=REQUEST_ID][[--properties-cpu-core-count=PROPERTIES_CPU_CORE_COUNT--properties-license-type=PROPERTIES_LICENSE_TYPE :--properties-cluster-name=PROPERTIES_CLUSTER_NAME--properties-data-storage-size-tb=PROPERTIES_DATA_STORAGE_SIZE_TB--properties-db-node-storage-size-gb=PROPERTIES_DB_NODE_STORAGE_SIZE_GB--properties-db-server-ocids=[PROPERTIES_DB_SERVER_OCIDS,…]--properties-disk-redundancy=PROPERTIES_DISK_REDUNDANCY--properties-gi-version=PROPERTIES_GI_VERSION--properties-hostname-prefix=PROPERTIES_HOSTNAME_PREFIX--properties-local-backup-enabled--properties-memory-size-gb=PROPERTIES_MEMORY_SIZE_GB--properties-node-count=PROPERTIES_NODE_COUNT--properties-ocpu-count=PROPERTIES_OCPU_COUNT--properties-sparse-diskgroup-enabled--properties-ssh-public-keys=[PROPERTIES_SSH_PUBLIC_KEYS,…]--properties-system-version=PROPERTIES_SYSTEM_VERSION--diagnostics-data-collection-options-events-enabled--diagnostics-data-collection-options-health-monitoring-enabled--diagnostics-data-collection-options-incident-logs-enabled--time-zone-id=TIME_ZONE_ID--time-zone-version=TIME_ZONE_VERSION]][GCLOUD_WIDE_FLAG]
DESCRIPTION
Create a new CloudVmCluster.
EXAMPLES
Choose an available gi-versions in your location by runninggcloudoracle-database db-system-shapes list --location=us-east4. To createCloudVmCluster instance with idmy-instance in the locationus-east4 with display-namemy instance, odb-networkprojects/network-project/locations/us-east4/odbNetworks/my-odbnetwork,odb-subnetprojects/network-project/locations/us-east4/odbNetworks/my-odbnetwork/odbSubnets/my-odbsubnet,backup-odb-subnetprojects/network-project/locations/us-east4/odbNetworks/my-odbnetwork/odbSubnets/my-backup-odbsubnet,cidr10.1.0.0/24, networkprojects/my-project/locations/global/networks/default,backup-subnet-cidr10.2.0.0/24, license-typeLICENSE_INCLUDED, ssh-public-keysVtTxzlPJtIivthmLOmWdRDFy5l27pKUTwLp02, hostname-prefixhostname1, cpu-core-count4 and choosen gi-versionxx.0.0.0, run:

To set the network configuration use one of the following options:

ODBNetwork based configuration(This is the recommended way):

gcloudoracle-databasecloud-vm-clusterscreatemy-instance--location=us-east4--display-name="my instance"--odb-network=projects/network-project/locations/us-east4/odbNetworks/my-odbnetwork--odb-subnet=projects/network-project/locations/us-east4/odbNetworks/my-odbnetwork/odbSubnets/my-odbsubnet--backup-odb-subnet=projects/network-project/locations/us-east4/odbNetworks/my-odbnetwork/odbSubnets/my-backup-odbsubnet--properties-license-type=LICENSE_INCLUDED--properties-ssh-public-keys="VtTxzlPJtIivthmLOmWdRDFy5l27pKUTwLp02"--properties-gi-version=xx.0.0.0--properties-hostname-prefix=hostname1--properties-cpu-core-count=4

Network and CIDR based configuration:

gcloudoracle-databasecloud-vm-clusterscreatemy-instance--location=us-east4--display-name="my instance"--cidr=10.1.0.0/24--network=projects/my-project/locations/global/networks/default--backup-subnet-cidr=10.2.0.0/24--properties-license-type=LICENSE_INCLUDED--properties-ssh-public-keys="VtTxzlPJtIivthmLOmWdRDFy5l27pKUTwLp02"--properties-gi-version=xx.0.0.0--properties-hostname-prefix=hostname1--properties-cpu-core-count=4
POSITIONAL ARGUMENTS
CloudVmCluster resource - Identifier. The name of the VM Cluster resource withthe format:projects/{project}/locations/{region}/cloudVmClusters/{cloud_vm_cluster} Thisrepresents a Cloud resource. (NOTE) Some attributes are not given arguments inthis group but can be set in other ways.

To set theproject attribute:

  • provide the argumentcloud_vm_cluster on the command line with afully specified name;
  • provide the argument--project on the command line;
  • set the propertycore/project.

To set thelocation attribute:

  • provide the argumentcloud_vm_cluster on the command line with afully specified name;
  • provide the argument--location on the command line.

This must be specified.

CLOUD_VM_CLUSTER
ID of the cloudVmCluster or fully qualified identifier for the cloudVmCluster.

To set thecloud_vm_cluster attribute:

  • provide the argumentcloud_vm_cluster on the command line.
REQUIRED FLAGS
CloudExadataInfrastructure resource - The name of the Exadata Infrastructureresource on which VM cluster resource is created, in the following format:projects/{project}/locations/{region}/cloudExadataInfrastuctures/{cloud_extradata_infrastructure}This represents a Cloud resource. (NOTE) Some attributes are not given argumentsin this group but can be set in other ways.

To set theproject attribute:

  • provide the argument--exadata-infrastructure on the command linewith a fully specified name;
  • provide the argument--project on the command line;
  • set the propertycore/project.

To set thelocation attribute:

  • provide the argument--exadata-infrastructure on the command linewith a fully specified name;
  • provide the argument--location on the command line.

This must be specified.

--exadata-infrastructure=EXADATA_INFRASTRUCTURE
ID of the cloudExadataInfrastructure or fully qualified identifier for thecloudExadataInfrastructure.

To set thecloud-exadata-infrastructure attribute:

  • provide the argument--exadata-infrastructure on the command line.
OPTIONAL FLAGS
--async
Return immediately, without waiting for the operation in progress to complete.
OdbSubnet resource - The name of the backup OdbSubnet associated with the VMCluster. Format:projects/{project}/locations/{location}/odbNetworks/{odb_network}/odbSubnets/{odb_subnet}This represents a Cloud resource. (NOTE) Some attributes are not given argumentsin this group but can be set in other ways.

To set theproject attribute:

  • provide the argument--backup-odb-subnet on the command line with afully specified name;
  • provide the argument--project on the command line;
  • set the propertycore/project.

To set thelocation attribute:

  • provide the argument--backup-odb-subnet on the command line with afully specified name;
  • provide the argument--location on the command line.

To set theodb-network attribute:

  • provide the argument--backup-odb-subnet on the command line with afully specified name;
  • provide the argument--odb-network on the command line.
--backup-odb-subnet=BACKUP_ODB_SUBNET
ID of the odbSubnet or fully qualified identifier for the odbSubnet.

To set theodb-subnet attribute:

  • provide the argument--backup-odb-subnet on the command line.
--backup-subnet-cidr=BACKUP_SUBNET_CIDR
CIDR range of the backup subnet.
--cidr=CIDR
Network settings. CIDR to use for cluster IP allocation.
--display-name=DISPLAY_NAME
User friendly name for this resource.
--labels=[LABELS,…]
Labels or tags associated with the VM Cluster.
KEY
Keys must start with a lowercase character and contain only hyphens(-), underscores (_), lowercase characters, andnumbers.
VALUE
Values must contain only hyphens (-), underscores (_),lowercase characters, and numbers.
Shorthand Example:
--labels=string=string

JSON Example:

--labels='{"string": "string"}'

File Example:

--labels=path_to_file.(yaml|json)
--location=LOCATION
For resources [backup-odb-subnet, cloud_vm_cluster, exadata-infrastructure,odb-network, odb-subnet], provides fallback value for resource locationattribute. When the resource's full URI path is not provided, location willfallback to this flag value.
Network resource - The name of the VPC network. 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 inother ways.

To set theproject attribute:

  • provide the argument--network on the command line with a fullyspecified name;
  • provide the argument--project on the command line;
  • set the propertycore/project.
--network=NETWORK
ID of the network or fully qualified identifier for the network.

To set thenetwork attribute:

  • provide the argument--network on the command line.
--odb-network=ODB_NETWORK
For resources [backup-odb-subnet, odb-network, odb-subnet], provides fallbackvalue for resource odb-network attribute. When the resource's full URI path isnot provided, odb-network will fallback to this flag value.
OdbSubnet resource - The name of the OdbSubnet associated with the VM Clusterfor IP allocation. Format:projects/{project}/locations/{location}/odbNetworks/{odb_network}/odbSubnets/{odb_subnet}This represents a Cloud resource. (NOTE) Some attributes are not given argumentsin this group but can be set in other ways.

To set theproject attribute:

  • provide the argument--odb-subnet on the command line with a fullyspecified name;
  • provide the argument--project on the command line;
  • set the propertycore/project.

To set thelocation attribute:

  • provide the argument--odb-subnet on the command line with a fullyspecified name;
  • provide the argument--location on the command line.

To set theodb-network attribute:

  • provide the argument--odb-subnet on the command line with a fullyspecified name;
  • provide the argument--odb-network on the command line.
--odb-subnet=ODB_SUBNET
ID of the odbSubnet or fully qualified identifier for the odbSubnet.

To set theodb-subnet attribute:

  • provide the argument--odb-subnet on the command line.
--request-id=REQUEST_ID
An optional ID to identify the request. This value is used to identify duplicaterequests. If you make a request with the same request ID and the originalrequest is still in progress or completed, the server ignores the secondrequest. This prevents clients from accidentally creating duplicate commitments.

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

Various properties and settings associated with Exadata VM cluster.
--properties-cpu-core-count=PROPERTIES_CPU_CORE_COUNT
Number of enabled CPU cores.

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

--properties-license-type=PROPERTIES_LICENSE_TYPE
License type of VM Cluster.PROPERTIES_LICENSE_TYPE mustbe one of:
bring-your-own-license
Bring your own license
license-included
License included part of offer
This flag argument must be specified if any of the other arguments in this groupare specified.
--properties-cluster-name=PROPERTIES_CLUSTER_NAME
OCI Cluster name.
--properties-data-storage-size-tb=PROPERTIES_DATA_STORAGE_SIZE_TB
The data disk group size to be allocated in TBs.
--properties-db-node-storage-size-gb=PROPERTIES_DB_NODE_STORAGE_SIZE_GB
Local storage per VM.
--properties-db-server-ocids=[PROPERTIES_DB_SERVER_OCIDS,…]
OCID of database servers.
--properties-disk-redundancy=PROPERTIES_DISK_REDUNDANCY
The type of redundancy.PROPERTIES_DISK_REDUNDANCY mustbe one of:
high
High - 3 way mirror.
normal
Normal - 2 way mirror.
--properties-gi-version=PROPERTIES_GI_VERSION
Grid Infrastructure Version.
--properties-hostname-prefix=PROPERTIES_HOSTNAME_PREFIX
Prefix for VM cluster host names.
--properties-local-backup-enabled
Use local backup.
--properties-memory-size-gb=PROPERTIES_MEMORY_SIZE_GB
Memory allocated in GBs.
--properties-node-count=PROPERTIES_NODE_COUNT
Number of database servers.
--properties-ocpu-count=PROPERTIES_OCPU_COUNT
OCPU count per VM. Minimum is 0.1.
--properties-sparse-diskgroup-enabled
Use exadata sparse snapshots.
--properties-ssh-public-keys=[PROPERTIES_SSH_PUBLIC_KEYS,…]
SSH public keys to be stored with cluster.
--properties-system-version=PROPERTIES_SYSTEM_VERSION
Operating system version of the image.
Data collection options for diagnostics.
--diagnostics-data-collection-options-events-enabled
Indicates whether diagnostic collection is enabled for the VM cluster
--diagnostics-data-collection-options-health-monitoring-enabled
Indicates whether health monitoring is enabled for the VM cluster
--diagnostics-data-collection-options-incident-logs-enabled
Indicates whether incident logs and trace collection are enabled for the VMcluster
Represents a time zone from theIANATime Zone Database.
--time-zone-id=TIME_ZONE_ID
IANA Time Zone Database time zone. For example "America/New_York".
--time-zone-version=TIME_ZONE_VERSION
IANA Time Zone Database version number. For example "2019a".
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$gcloud help for details.

API REFERENCE
This command uses theoracledatabase/v1 API. The full documentationfor this API can be found at:https://cloud.google.com/oracle/database/docs

Except as otherwise noted, the content of this page is licensed under theCreative Commons Attribution 4.0 License, and code samples are licensed under theApache 2.0 License. For details, see theGoogle Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.

Last updated 2025-07-29 UTC.