gcloud oracle-database cloud-vm-clusters create Stay organized with collections Save and categorize content based on your preferences.
- 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 running
gcloudoracle-database db-system-shapes list --location=us-east4. To createCloudVmCluster instance with idmy-instancein the locationus-east4with 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-count4and 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=4Network 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 the
projectattribute:- provide the argument
cloud_vm_clusteron the command line with afully specified name; - provide the argument
--projecton the command line; - set the property
core/project.
To set the
locationattribute:- provide the argument
cloud_vm_clusteron the command line with afully specified name; - provide the argument
--locationon the command line.
This must be specified.
CLOUD_VM_CLUSTER- ID of the cloudVmCluster or fully qualified identifier for the cloudVmCluster.
To set the
cloud_vm_clusterattribute:- provide the argument
cloud_vm_clusteron the command line.
- provide the argument
- provide the argument
- 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.
- 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 the
projectattribute:- provide the argument
--exadata-infrastructureon the command linewith a fully specified name; - provide the argument
--projecton the command line; - set the property
core/project.
To set the
locationattribute:- provide the argument
--exadata-infrastructureon the command linewith a fully specified name; - provide the argument
--locationon the command line.
This must be specified.
--exadata-infrastructure=EXADATA_INFRASTRUCTURE- ID of the cloudExadataInfrastructure or fully qualified identifier for thecloudExadataInfrastructure.
To set the
cloud-exadata-infrastructureattribute:- provide the argument
--exadata-infrastructureon the command line.
- provide the argument
- provide the argument
- 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.
- 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 the
projectattribute:- provide the argument
--backup-odb-subneton the command line with afully specified name; - provide the argument
--projecton the command line; - set the property
core/project.
To set the
locationattribute:- provide the argument
--backup-odb-subneton the command line with afully specified name; - provide the argument
--locationon the command line.
To set the
odb-networkattribute:- provide the argument
--backup-odb-subneton the command line with afully specified name; - provide the argument
--odb-networkon the command line.
--backup-odb-subnet=BACKUP_ODB_SUBNET- ID of the odbSubnet or fully qualified identifier for the odbSubnet.
To set the
odb-subnetattribute:- provide the argument
--backup-odb-subneton the command line.
- provide the argument
- provide the argument
--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 the
projectattribute:- provide the argument
--networkon the command line with a fullyspecified name; - provide the argument
--projecton the command line; - set the property
core/project.
--network=NETWORK- ID of the network or fully qualified identifier for the network.
To set the
networkattribute:- provide the argument
--networkon the command line.
- provide the argument
- provide the argument
--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 the
projectattribute:- provide the argument
--odb-subneton the command line with a fullyspecified name; - provide the argument
--projecton the command line; - set the property
core/project.
To set the
locationattribute:- provide the argument
--odb-subneton the command line with a fullyspecified name; - provide the argument
--locationon the command line.
To set the
odb-networkattribute:- provide the argument
--odb-subneton the command line with a fullyspecified name; - provide the argument
--odb-networkon the command line.
--odb-subnet=ODB_SUBNET- ID of the odbSubnet or fully qualified identifier for the odbSubnet.
To set the
odb-subnetattribute:- provide the argument
--odb-subneton the command line.
- provide the argument
- provide the argument
--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_TYPEmustbe one of:bring-your-own-license- Bring your own license
license-included- License included part of offer
--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_REDUNDANCYmustbe 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 helpfor details. - API REFERENCE
- This command uses the
oracledatabase/v1API. 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.