---
title: "POST /v1/{+parent}/exadbVmClusters"
method: POST
path: "/v1/{+parent}/exadbVmClusters"
tags: ["projects"]
---

# POST /v1/{+parent}/exadbVmClusters

`POST /v1/{+parent}/exadbVmClusters`

Creates a new Exadb (Exascale) VM Cluster resource.

## Path parameters

- `parent` string, required

## Query parameters

- `exadbVmClusterId` string
- `requestId` string

## Request body

- ExadbVmCluster — ExadbVmCluster represents a cluster of VMs that are used to run Exadata workloads. https://docs.oracle.com/en-us/iaas/api/#/en/database/20160918/ExadbVmCluster/
  - `createTime` string, google-datetime — Output only. The date and time that the ExadbVmCluster was created.
  - `odbNetwork` string — Optional. Immutable. The name of the OdbNetwork associated with the ExadbVmCluster. Format: projects/{project}/locations/{location}/odbNetworks/{odb_network} It is optional but if specified, this should match the parent ODBNetwork of the OdbSubnet.
  - `name` string — Identifier. The name of the ExadbVmCluster resource in the following format: projects/{project}/locations/{region}/exadbVmClusters/{exadb_vm_cluster}
  - `gcpOracleZone` string — Output only. Immutable. The GCP Oracle zone where Oracle ExadbVmCluster is hosted. Example: us-east4-b-r2. During creation, the system will pick the zone assigned to the ExascaleDbStorageVault.
  - `backupOdbSubnet` string — Required. Immutable. The name of the backup OdbSubnet associated with the ExadbVmCluster. Format: projects/{project}/locations/{location}/odbNetworks/{odb_network}/odbSubnets/{odb_subnet}
  - `displayName` string — Required. Immutable. The display name for the ExadbVmCluster. The name does not have to be unique within your project. The name must be 1-255 characters long and can only contain alphanumeric characters.
  - `labels` object — Optional. The labels or tags associated with the ExadbVmCluster.
  - `entitlementId` string — Output only. The ID of the subscription entitlement associated with the ExadbVmCluster.
  - `properties` ExadbVmClusterProperties — The properties of an ExadbVmCluster.
    - `enabledEcpuCountPerNode` integer — Required. Immutable. The number of ECPUs enabled per node for an exadata vm cluster on exascale infrastructure.
    - `lifecycleState` 'EXADB_VM_CLUSTER_LIFECYCLE_STATE_UNSPECIFIED' | 'PROVISIONING' | 'AVAILABLE' | 'UPDATING' | 'TERMINATING' | 'TERMINATED' | 'FAILED' | 'MAINTENANCE_IN_PROGRESS' — Output only. State of the cluster.
    - `dataCollectionOptions` DataCollectionOptionsCommon — Data collection options for diagnostics. https://docs.oracle.com/en-us/iaas/api/#/en/database/20160918/datatypes/DataCollectionOptions
      - `isIncidentLogsEnabled` boolean — Optional. Indicates whether to enable incident logs and trace collection.
      - `isDiagnosticsEventsEnabled` boolean — Optional. Indicates whether to enable data collection for diagnostics.
      - `isHealthMonitoringEnabled` boolean — Optional. Indicates whether to enable health monitoring.
    - `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 — Output only. Memory per VM (GB) (Read-only): Shows the amount of memory allocated to each VM. Memory is calculated based on 2.75 GB per Total ECPUs.
    - `vmFileSystemStorage` ExadbVmClusterStorageDetails — The storage allocation for the exadbvmcluster, in gigabytes (GB).
      - `sizeInGbsPerNode` integer — Required. The storage allocation for the exadbvmcluster per node, in gigabytes (GB). This field is used to calculate the total storage allocation for the exadbvmcluster.
    - `nodeCount` integer — Required. The number of nodes/VMs in the ExadbVmCluster.
    - `licenseModel` 'LICENSE_MODEL_UNSPECIFIED' | 'LICENSE_INCLUDED' | 'BRING_YOUR_OWN_LICENSE' — Optional. Immutable. The license type of the ExadbVmCluster.
    - `ociUri` string — Output only. Deep link to the OCI console to view this resource.
    - `exascaleDbStorageVault` string — Required. Immutable. The name of ExascaleDbStorageVault associated with the ExadbVmCluster. It can refer to an existing ExascaleDbStorageVault. Or a new one can be created during the ExadbVmCluster creation (requires storage_vault_properties to be set). Format: projects/{project}/locations/{location}/exascaleDbStorageVaults/{exascale_db_storage_vault}
    - `clusterName` string — Optional. Immutable. The cluster name for Exascale vm cluster. The cluster name must begin with an alphabetic character and may contain hyphens(-) but can not contain underscores(_). It should be not more than 11 characters and is not case sensitive. OCI Cluster name.
    - `hostname` string — Output only. The hostname of the ExadbVmCluster.
    - `additionalEcpuCountPerNode` integer — Optional. Immutable. The number of additional ECPUs per node for an Exadata VM cluster on exascale infrastructure.
    - `sshPublicKeys` string[] — Required. Immutable. The SSH public keys for the ExadbVmCluster.
    - `shapeAttribute` 'SHAPE_ATTRIBUTE_UNSPECIFIED' | 'SMART_STORAGE' | 'BLOCK_STORAGE' — Required. Immutable. The shape attribute of the VM cluster. The type of Exascale storage used for Exadata VM cluster. The default is SMART_STORAGE which supports Oracle Database 23ai and later
    - `hostnamePrefix` string — Required. Immutable. Prefix for VM cluster host names.
    - `giVersion` string — Output only. The Oracle Grid Infrastructure (GI) software version.
    - `gridImageId` string — Required. Immutable. Grid Infrastructure Version.
    - `scanListenerPortTcp` integer — Optional. Immutable. SCAN listener port - TCP
  - `odbSubnet` string — Required. Immutable. The name of the OdbSubnet associated with the ExadbVmCluster for IP allocation. Format: projects/{project}/locations/{location}/odbNetworks/{odb_network}/odbSubnets/{odb_subnet}

## 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)