--- title: "POST /v1/{+parent}/cloudVmClusters" method: POST path: "/v1/{+parent}/cloudVmClusters" tags: ["projects"] --- # POST /v1/{+parent}/cloudVmClusters `POST /v1/{+parent}/cloudVmClusters` Creates a new VM Cluster in a given project and location. ## Path parameters - `parent` string, required ## Query parameters - `cloudVmClusterId` string - `requestId` string ## Request body - CloudVmCluster — Details of the Cloud VM Cluster resource. https://docs.oracle.com/en-us/iaas/api/#/en/database/20160918/CloudVmCluster/ - `network` string — Optional. The name of the VPC network. Format: projects/{project}/global/networks/{network} - `backupOdbSubnet` string — Optional. The name of the backup OdbSubnet associated with the VM Cluster. Format: projects/{project}/locations/{location}/odbNetworks/{odb_network}/odbSubnets/{odb_subnet} - `odbSubnet` string — Optional. The name of the OdbSubnet associated with the VM Cluster for IP allocation. Format: projects/{project}/locations/{location}/odbNetworks/{odb_network}/odbSubnets/{odb_subnet} - `exadataInfrastructure` string — Required. The name of the Exadata Infrastructure resource on which VM cluster resource is created, in the following format: projects/{project}/locations/{region}/cloudExadataInfrastuctures/{cloud_extradata_infrastructure} - `exascaleDbStorageVault` string — Optional. The name of ExascaleDbStorageVault associated with the VM Cluster. Format: projects/{project}/locations/{location}/exascaleDbStorageVaults/{exascale_db_storage_vault} - `odbNetwork` string — Optional. The name of the OdbNetwork associated with the VM Cluster. Format: projects/{project}/locations/{location}/odbNetworks/{odb_network} It is optional but if specified, this should match the parent ODBNetwork of the odb_subnet and backup_odb_subnet. - `identityConnector` IdentityConnector — The identity connector details which will allow OCI to securely access the resources in the customer project. - `serviceAgentEmail` string — Output only. A google managed service account on which customers can grant roles to access resources in the customer project. Example: `p176944527254-55-75119d87fd8f@gcp-sa-oci.iam.gserviceaccount.com` - `connectionState` 'CONNECTION_STATE_UNSPECIFIED' | 'CONNECTED' | 'PARTIALLY_CONNECTED' | 'DISCONNECTED' | 'UNKNOWN' — Output only. The connection state of the identity connector. - `createTime` string, google-datetime — Output only. The date and time that the VM cluster was created. - `cidr` string — Optional. Network settings. CIDR to use for cluster IP allocation. - `backupSubnetCidr` string — Optional. CIDR range of the backup subnet. - `displayName` string — Optional. User friendly name for this resource. - `gcpOracleZone` string — Output only. The GCP Oracle zone where Oracle CloudVmCluster is hosted. This will be the same as the gcp_oracle_zone of the CloudExadataInfrastructure. Example: us-east4-b-r2. - `properties` CloudVmClusterProperties — Various properties and settings associated with Exadata VM cluster. - `cpuCoreCount` integer — Required. Number of enabled CPU cores. - `diskRedundancy` 'DISK_REDUNDANCY_UNSPECIFIED' | 'HIGH' | 'NORMAL' — Optional. The type of redundancy. - `sshPublicKeys` string[] — Optional. SSH public keys to be stored with cluster. - `domain` string — Output only. Parent DNS domain where SCAN DNS and hosts names are qualified. ex: ocispdelegated.ocisp10jvnet.oraclevcn.com - `state` 'STATE_UNSPECIFIED' | 'PROVISIONING' | 'AVAILABLE' | 'UPDATING' | 'TERMINATING' | 'TERMINATED' | 'FAILED' | 'MAINTENANCE_IN_PROGRESS' — Output only. State of the cluster. - `diagnosticsDataCollectionOptions` DataCollectionOptions — Data collection options for diagnostics. - `diagnosticsEventsEnabled` boolean — Optional. Indicates whether diagnostic collection is enabled for the VM cluster - `healthMonitoringEnabled` boolean — Optional. Indicates whether health monitoring is enabled for the VM cluster - `incidentLogsEnabled` boolean — Optional. Indicates whether incident logs and trace collection are enabled for the VM cluster - `storageManagementType` 'STORAGE_MANAGEMENT_TYPE_UNSPECIFIED' | 'ASM' | 'EXASCALE' — Output only. The storage management type of the VM Cluster. - `scanDns` string — Output only. SCAN DNS name. ex: sp2-yi0xq-scan.ocispdelegated.ocisp10jvnet.oraclevcn.com - `localBackupEnabled` boolean — Optional. Use local backup. - `dbNodeStorageSizeGb` integer — Optional. Local storage per VM. - `clusterName` string — Optional. OCI Cluster name. - `scanListenerPortTcpSsl` integer — Optional. SCAN listener port - TLS - `storageSizeGb` integer — Output only. The storage allocation for the disk group, in gigabytes (GB). - `shape` string — Output only. Shape of VM Cluster. - `ocpuCount` number, float — Optional. OCPU count per VM. Minimum is 0.1. - `sparseDiskgroupEnabled` boolean — Optional. Use exadata sparse snapshots. - `giVersion` string — Optional. Grid Infrastructure Version. - `dataStorageSizeTb` number, double — Optional. The data disk group size to be allocated in TBs. - `hostnamePrefix` string — Optional. Prefix for VM cluster host names. - `compartmentId` string — Output only. Compartment ID of cluster. - `ocid` string — Output only. Oracle Cloud Infrastructure ID of VM Cluster. - `licenseType` 'LICENSE_TYPE_UNSPECIFIED' | 'LICENSE_INCLUDED' | 'BRING_YOUR_OWN_LICENSE' — Required. License type of VM Cluster. - `scanListenerPortTcp` integer — Optional. SCAN listener port - TCP - `ociUrl` string — Output only. Deep link to the OCI console to view this resource. - `computeModel` 'COMPUTE_MODEL_UNSPECIFIED' | 'COMPUTE_MODEL_ECPU' | 'COMPUTE_MODEL_OCPU' — Output only. The compute model of the VM Cluster. - `timeZone` TimeZone — Represents a time zone from the [IANA Time Zone Database](https://www.iana.org/time-zones). - `id` string — IANA Time Zone Database time zone. For example "America/New_York". - `version` string — Optional. IANA Time Zone Database version number. For example "2019a". - `memorySizeGb` integer — Optional. Memory allocated in GBs. - `nodeCount` integer — Optional. Number of database servers. - `systemVersion` string — Optional. Operating system version of the image. - `dbServerOcids` string[] — Optional. OCID of database servers. - `hostname` string — Output only. host name without domain. format: "-" with some suffix. ex: sp2-yi0xq where "sp2" is the hostname_prefix. - `dnsListenerIp` string — Output only. DNS listener IP. - `scanIpIds` string[] — Output only. OCIDs of scan IPs. - `scanDnsRecordId` string — Output only. OCID of scan DNS record. - `labels` object — Optional. Labels or tags associated with the VM Cluster. - `name` string — Identifier. The name of the VM Cluster resource with the format: projects/{project}/locations/{region}/cloudVmClusters/{cloud_vm_cluster} ## Response `200` Successful response --- [API](https://skmtc.net/google/apis/oracledatabase.md) · [All operations](https://skmtc.net/google/apis/oracledatabase/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/google/oracledatabase/versions/120ce7891e09/schema)