REST Resource: projects.locations.cloudVmClusters

Resource: CloudVmCluster

Details of the Cloud VM Cluster resource. https://docs.oracle.com/en-us/iaas/api/#/en/database/20160918/CloudVmCluster/

JSON representation 
{
  "name": string,
  "exadataInfrastructure": string,
  "displayName": string,
  "gcpOracleZone": string,
  "properties": {
    object (CloudVmClusterProperties)
  },
  "labels": {
    string: string,
    ...
  },
  "createTime": string,
  "cidr": string,
  "backupSubnetCidr": string,
  "network": string
}
Fields
name

string

Identifier. The name of the VM Cluster resource with the format: projects/{project}/locations/{region}/cloudVmClusters/{cloudVmCluster}
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}
displayName

string

Optional. User friendly name for this resource.
gcpOracleZone

string

Output only. Google Cloud Platform location where Oracle Exadata is hosted. It is same as Google Cloud Platform Oracle zone of Exadata infrastructure.
properties

object (CloudVmClusterProperties)

Optional. Various properties of the VM Cluster.
labels

map (key: string, value: string)

Optional. Labels or tags associated with the VM Cluster.

An object containing a list of "key": value pairs. Example: { "name": "wrench", "mass": "1.3kg", "count": "3" }.
createTime

string (Timestamp format)

Output only. The date and time that the VM cluster was created.

A timestamp in RFC3339 UTC "Zulu" format, with nanosecond resolution and up to nine fractional digits. Examples: "2014-10-02T15:01:23Z" and "2014-10-02T15:01:23.045123456Z".
cidr

string

Required. Network settings. CIDR to use for cluster IP allocation.
backupSubnetCidr

string

Required. CIDR range of the backup subnet.
network

string

Required. The name of the VPC network. Format: projects/{project}/global/networks/{network}

CloudVmClusterProperties

Various properties and settings associated with Exadata VM cluster.

JSON representation 
{
  "ocid": string,
  "licenseType": enum (LicenseType),
  "giVersion": string,
  "timeZone": {
    object (TimeZone)
  },
  "sshPublicKeys": [
    string
  ],
  "nodeCount": integer,
  "shape": string,
  "ocpuCount": number,
  "memorySizeGb": integer,
  "dbNodeStorageSizeGb": integer,
  "storageSizeGb": integer,
  "dataStorageSizeTb": number,
  "diskRedundancy": enum (DiskRedundancy),
  "sparseDiskgroupEnabled": boolean,
  "localBackupEnabled": boolean,
  "hostnamePrefix": string,
  "diagnosticsDataCollectionOptions": {
    object (DataCollectionOptions)
  },
  "state": enum (State),
  "scanListenerPortTcp": integer,
  "scanListenerPortTcpSsl": integer,
  "domain": string,
  "scanDns": string,
  "hostname": string,
  "cpuCoreCount": integer,
  "systemVersion": string,
  "scanIpIds": [
    string
  ],
  "scanDnsRecordId": string,
  "ociUrl": string,
  "dbServerOcids": [
    string
  ],
  "compartmentId": string,
  "dnsListenerIp": string,
  "clusterName": string
}
Fields
ocid

string

Output only. Oracle Cloud Infrastructure ID of VM Cluster.
licenseType

enum (LicenseType)

Required. License type of VM Cluster.
giVersion

string

Optional. Grid Infrastructure Version.
timeZone

object (TimeZone)

Optional. Time zone of VM Cluster to set. Defaults to UTC if not specified.
sshPublicKeys[]

string

Optional. SSH public keys to be stored with cluster.
nodeCount

integer

Optional. Number of database servers.
shape

string

Output only. Shape of VM Cluster.
ocpuCount

number

Optional. OCPU count per VM. Minimum is 0.1.
memorySizeGb

integer

Optional. Memory allocated in GBs.
dbNodeStorageSizeGb

integer

Optional. Local storage per VM.
storageSizeGb

integer

Output only. The storage allocation for the disk group, in gigabytes (GB).
dataStorageSizeTb

number

Optional. The data disk group size to be allocated in TBs.
diskRedundancy

enum (DiskRedundancy)

Optional. The type of redundancy.
sparseDiskgroupEnabled

boolean

Optional. Use exadata sparse snapshots.
localBackupEnabled

boolean

Optional. Use local backup.
hostnamePrefix

string

Optional. Prefix for VM cluster host names.
diagnosticsDataCollectionOptions

object (DataCollectionOptions)

Optional. Data collection options for diagnostics.
state

enum (State)

Output only. State of the cluster.
scanListenerPortTcp

integer

Output only. SCAN listener port - TCP
scanListenerPortTcpSsl

integer

Output only. SCAN listener port - TLS
domain

string

Output only. Parent DNS domain where SCAN DNS and hosts names are qualified. ex: ocispdelegated.ocisp10jvnet.oraclevcn.com
scanDns

string

Output only. SCAN DNS name. ex: sp2-yi0xq-scan.ocispdelegated.ocisp10jvnet.oraclevcn.com
hostname

string

Output only. host name without domain. format: "-" with some suffix. ex: sp2-yi0xq where "sp2" is the hostnamePrefix.
cpuCoreCount

integer

Required. Number of enabled CPU cores.
systemVersion

string

Output only. Operating system version of the image.
scanIpIds[]

string

Output only. OCIDs of scan IPs.
scanDnsRecordId

string

Output only. OCID of scan DNS record.
ociUrl

string

Output only. Deep link to the OCI console to view this resource.
dbServerOcids[]

string

Optional. OCID of database servers.
compartmentId

string

Output only. Compartment ID of cluster.
dnsListenerIp

string

Output only. DNS listener IP.
clusterName

string

Optional. OCI Cluster name.

LicenseType

Different licenses supported.

Enums
LICENSE_TYPE_UNSPECIFIED Unspecified
LICENSE_INCLUDED License included part of offer
BRING_YOUR_OWN_LICENSE Bring your own license

TimeZone

Represents a time zone from the IANA Time Zone Database.

JSON representation 
{
  "id": string,
  "version": string
}
Fields
id

string

IANA Time Zone Database time zone, e.g. "America/New_York".
version

string

Optional. IANA Time Zone Database version number, e.g. "2019a".

DiskRedundancy

Types of disk redundancy provided by Oracle.

Enums
DISK_REDUNDANCY_UNSPECIFIED Unspecified.
HIGH High - 3 way mirror.
NORMAL Normal - 2 way mirror.

DataCollectionOptions

Data collection options for diagnostics.

JSON representation 
{
  "diagnosticsEventsEnabled": boolean,
  "healthMonitoringEnabled": boolean,
  "incidentLogsEnabled": boolean
}
Fields
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

State

The various lifecycle states of the VM cluster.

Enums
STATE_UNSPECIFIED Default unspecified value.
PROVISIONING Indicates that the resource is in provisioning state.
AVAILABLE Indicates that the resource is in available state.
UPDATING Indicates that the resource is in updating state.
TERMINATING Indicates that the resource is in terminating state.
TERMINATED Indicates that the resource is in terminated state.
FAILED Indicates that the resource is in failed state.
MAINTENANCE_IN_PROGRESS Indicates that the resource is in maintenance in progress state.

Methods

create

 Creates a new VM Cluster in a given project and location.

delete

 Deletes a single VM Cluster.

get

 Gets details of a single VM Cluster.

list

 Lists the VM Clusters in a given project and location.