Cloud Vm Clusters - Get
Get a CloudVmCluster
GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Oracle.Database/cloudVmClusters/{cloudvmclustername}?api-version=2023-09-01
URI Parameters
Name | In | Required | Type | Description |
---|---|---|---|---|
cloudvmclustername
|
path | True |
string pattern: .* |
CloudVmCluster name |
resource
|
path | True |
string minLength: 1maxLength: 90 |
The name of the resource group. The name is case insensitive. |
subscription
|
path | True |
string (uuid) |
The ID of the target subscription. The value must be an UUID. |
api-version
|
query | True |
string minLength: 1 |
The API version to use for this operation. |
Responses
Name | Type | Description |
---|---|---|
200 OK |
Azure operation completed successfully. |
|
Other Status Codes |
An unexpected error response. |
Security
azure_auth
Azure Active Directory OAuth2 Flow.
Type:
oauth2
Flow:
implicit
Authorization URL:
https://login.microsoftonline.com/common/oauth2/authorize
Scopes
Name | Description |
---|---|
user_impersonation | impersonate your user account |
Examples
Get VM Cluster
Sample request
Sample response
{
"id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg000/providers/Oracle.Database/cloudVmClusters/cluster1",
"type": "Oracle.Database/cloudVmClusters",
"location": "eastus",
"tags": {
"tagK1": "tagV1"
},
"properties": {
"ocid": "ocid1..aaaa",
"listenerPort": 1050,
"nodeCount": 100,
"storageSizeInGbs": 1000,
"dataStorageSizeInTbs": 10,
"dbNodeStorageSizeInGbs": 100,
"memorySizeInGbs": 1000,
"timeCreated": "2023-10-22T02:18:35.683Z",
"lifecycleDetails": "success",
"timeZone": "UTC",
"zoneId": "ocid1..aaaa",
"hostname": "hostname1",
"domain": "domain1",
"cpuCoreCount": 10,
"ocpuCount": 100,
"clusterName": "cluster1",
"dataStoragePercentage": 80,
"isLocalBackupEnabled": false,
"cloudExadataInfrastructureId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg000/providers/Oracle.Database/cloudExadataInfrastructures/infra1",
"isSparseDiskgroupEnabled": false,
"sshPublicKeys": [
"ssh-key 1"
],
"nsgCidrs": [
{
"source": "10.0.0.0/16",
"destinationPortRange": {
"min": 1520,
"max": 1522
}
},
{
"source": "10.10.0.0/24"
}
],
"licenseModel": "LicenseIncluded",
"scanListenerPortTcp": 1050,
"scanListenerPortTcpSsl": 1025,
"vnetId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg000/providers/Microsoft.Network/virtualNetworks/vnet1",
"giVersion": "19.0.0.0",
"subnetId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg000/providers/Microsoft.Network/virtualNetworks/vnet1/subnets/subnet1",
"backupSubnetCidr": "172.17.5.0/24",
"systemVersion": "v1",
"diskRedundancy": "High",
"scanIpIds": [
"10.0.0.1"
],
"vipIds": [
"10.0.1.3"
],
"scanDnsName": "dbdns1",
"scanDnsRecordId": "scandns1",
"shape": "EXADATA.X9M",
"provisioningState": "Succeeded",
"ociUrl": "https://fake",
"nsgUrl": "https://fake",
"dataCollectionOptions": {
"isDiagnosticsEventsEnabled": false,
"isHealthMonitoringEnabled": false,
"isIncidentLogsEnabled": false
},
"displayName": "cluster 1",
"iormConfigCache": {
"dbPlans": [
{
"dbName": "db1",
"flashCacheLimit": "none",
"share": 32
}
],
"lifecycleDetails": "Disabled",
"lifecycleState": "Disabled",
"objective": "LowLatency"
},
"lastUpdateHistoryEntryId": "none",
"dbServers": [
"ocid1..aaaa"
],
"compartmentId": "ocid1..aaaaaa",
"subnetOcid": "ocid1..aaaaaa"
}
}
Definitions
Name | Description |
---|---|
Azure |
Azure Resource Provisioning State enum |
Cloud |
CloudVmCluster resource definition |
Cloud |
Cloud VM Cluster lifecycle state enum |
created |
The type of identity that created the resource. |
Data |
DataCollectionOptions resource properties |
Db |
DbIormConfig for cloud vm cluster |
Disk |
Disk redundancy enum |
Error |
The resource management error additional info. |
Error |
The error detail. |
Error |
Error response |
Exadata |
ExadataIormConfig for cloud vm cluster |
Iorm |
ORM lifecycle state enum |
License |
LicenseModel enum |
Nsg |
A rule for allowing inbound (INGRESS) IP packets |
Objective |
Objective enum |
Port |
Port Range to specify particular destination ports for TCP rules. |
system |
Metadata pertaining to creation and last modification of the resource. |
AzureResourceProvisioningState
Azure Resource Provisioning State enum
Value | Description |
---|---|
Canceled |
Resource creation was canceled. |
Failed |
Resource creation failed. |
Provisioning |
Indicates that resource in Provisioning state |
Succeeded |
Resource has been created. |
CloudVmCluster
CloudVmCluster resource definition
Name | Type | Default value | Description |
---|---|---|---|
id |
string (arm-id) |
Fully qualified resource ID for the resource. E.g. "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}" |
|
location |
string |
The geo-location where the resource lives |
|
name |
string |
The name of the resource |
|
properties.backupSubnetCidr |
string minLength: 1maxLength: 32 |
Client OCI backup subnet CIDR, default is 192.168.252.0/22 |
|
properties.cloudExadataInfrastructureId |
string (arm-id) |
Cloud Exadata Infrastructure ID |
|
properties.clusterName |
string minLength: 1maxLength: 11 |
The cluster name for cloud VM cluster. The cluster name must begin with an alphabetic character, and may contain hyphens (-). Underscores (_) are not permitted. The cluster name can be no longer than 11 characters and is not case sensitive. |
|
properties.compartmentId |
string minLength: 1maxLength: 255 |
Cluster compartmentId |
|
properties.computeNodes |
string[] minLength: 1maxLength: 255 |
The list of compute servers to be added to the cloud VM cluster. |
|
properties.cpuCoreCount |
integer (int32) |
The number of CPU cores enabled on the cloud VM cluster. |
|
properties.dataCollectionOptions |
Indicates user preferences for the various diagnostic collection options for the VM cluster/Cloud VM cluster/VMBM DBCS. |
||
properties.dataStoragePercentage |
integer (int32) |
The percentage assigned to DATA storage (user data and database files). The remaining percentage is assigned to RECO storage (database redo logs, archive logs, and recovery manager backups). Accepted values are 35, 40, 60 and 80. The default is 80 percent assigned to DATA storage. See Storage Configuration in the Exadata documentation for details on the impact of the configuration settings on storage. |
|
properties.dataStorageSizeInTbs |
number (double) |
The data disk group size to be allocated in TBs. |
|
properties.dbNodeStorageSizeInGbs |
integer (int32) |
The local node storage to be allocated in GBs. |
|
properties.dbServers |
string[] minLength: 1maxLength: 255 |
The list of DB servers. |
|
properties.diskRedundancy |
The type of redundancy configured for the cloud Vm cluster. NORMAL is 2-way redundancy. HIGH is 3-way redundancy. |
||
properties.displayName |
string minLength: 1maxLength: 255 |
Display Name |
|
properties.domain |
string |
The domain name for the cloud VM cluster. |
|
properties.giVersion |
string |
Oracle Grid Infrastructure (GI) software version |
|
properties.hostname |
string minLength: 1maxLength: 23 |
The hostname for the cloud VM cluster. |
|
properties.iormConfigCache |
iormConfigCache details for cloud VM cluster. |
||
properties.isLocalBackupEnabled |
boolean |
False |
If true, database backup on local Exadata storage is configured for the cloud VM cluster. If false, database backup on local Exadata storage is not available in the cloud VM cluster. |
properties.isSparseDiskgroupEnabled |
boolean |
False |
If true, sparse disk group is configured for the cloud VM cluster. If false, sparse disk group is not created. |
properties.lastUpdateHistoryEntryId |
string minLength: 1maxLength: 255 |
The OCID of the last maintenance update history entry. |
|
properties.licenseModel |
The Oracle license model that applies to the cloud VM cluster. The default is LICENSE_INCLUDED. |
||
properties.lifecycleDetails |
string |
Additional information about the current lifecycle state. |
|
properties.lifecycleState |
CloudVmCluster lifecycle state |
||
properties.listenerPort |
integer (int64) |
The port number configured for the listener on the cloud VM cluster. |
|
properties.memorySizeInGbs |
integer (int32) |
The memory to be allocated in GBs. |
|
properties.nodeCount |
integer (int32) |
The number of nodes in the cloud VM cluster. |
|
properties.nsgCidrs |
Nsg |
CIDR blocks for additional NSG ingress rules. The VNET CIDRs used to provision the VM Cluster will be added by default. |
|
properties.nsgUrl |
string (uri) |
HTTPS link to OCI Network Security Group exposed to Azure Customer via the Azure Interface. |
|
properties.ociUrl |
string (uri) |
HTTPS link to OCI resources exposed to Azure Customer via Azure Interface. |
|
properties.ocid |
string minLength: 1maxLength: 255 |
Cloud VM Cluster ocid |
|
properties.ocpuCount |
number (float) |
The number of OCPU cores to enable on the cloud VM cluster. Only 1 decimal place is allowed for the fractional part. |
|
properties.provisioningState |
CloudVmCluster provisioning state |
||
properties.scanDnsName |
string minLength: 1maxLength: 72 |
The FQDN of the DNS record for the SCAN IP addresses that are associated with the cloud VM cluster. |
|
properties.scanDnsRecordId |
string minLength: 1maxLength: 255 |
The OCID of the DNS record for the SCAN IP addresses that are associated with the cloud VM cluster. |
|
properties.scanIpIds |
string[] |
The Single Client Access Name (SCAN) IP addresses associated with the cloud VM cluster. SCAN IP addresses are typically used for load balancing and are not assigned to any interface. Oracle Clusterware directs the requests to the appropriate nodes in the cluster. Note: For a single-node DB system, this list is empty. |
|
properties.scanListenerPortTcp |
integer (int32) |
The TCP Single Client Access Name (SCAN) port. The default port is 1521. |
|
properties.scanListenerPortTcpSsl |
integer (int32) |
The TCPS Single Client Access Name (SCAN) port. The default port is 2484. |
|
properties.shape |
string minLength: 1maxLength: 255 |
The model name of the Exadata hardware running the cloud VM cluster. |
|
properties.sshPublicKeys |
string[] |
The public key portion of one or more key pairs used for SSH access to the cloud VM cluster. |
|
properties.storageSizeInGbs |
integer (int32) |
The data disk group size to be allocated in GBs per VM. |
|
properties.subnetId |
string (arm-id) |
Client subnet |
|
properties.subnetOcid |
string minLength: 1maxLength: 255 |
Cluster subnet ocid |
|
properties.systemVersion |
string minLength: 1maxLength: 255 |
Operating system version of the image. |
|
properties.timeCreated |
string (date-time) |
The date and time that the cloud VM cluster was created. |
|
properties.timeZone |
string minLength: 1maxLength: 255 |
The time zone of the cloud VM cluster. For details, see Exadata Infrastructure Time Zones. |
|
properties.vipIds |
string[] |
The virtual IP (VIP) addresses associated with the cloud VM cluster. The Cluster Ready Services (CRS) creates and maintains one VIP address for each node in the Exadata Cloud Service instance to enable failover. If one node fails, the VIP is reassigned to another active node in the cluster. Note: For a single-node DB system, this list is empty. |
|
properties.vnetId |
string (arm-id) |
VNET for network connectivity |
|
properties.zoneId |
string minLength: 1maxLength: 255 |
The OCID of the zone the cloud VM cluster is associated with. |
|
systemData |
Azure Resource Manager metadata containing createdBy and modifiedBy information. |
||
tags |
object |
Resource tags. |
|
type |
string |
The type of the resource. E.g. "Microsoft.Compute/virtualMachines" or "Microsoft.Storage/storageAccounts" |
CloudVmClusterLifecycleState
Cloud VM Cluster lifecycle state enum
Value | Description |
---|---|
Available |
Indicates that resource in Available state |
Failed |
Indicates that resource in Failed state |
MaintenanceInProgress |
Indicates that resource Maintenance in progress state |
Provisioning |
Indicates that resource in Provisioning state |
Terminated |
Indicates that resource in Terminated state |
Terminating |
Indicates that resource in Terminating state |
Updating |
Indicates that resource in Updating state |
createdByType
The type of identity that created the resource.
Value | Description |
---|---|
Application | |
Key | |
ManagedIdentity | |
User |
DataCollectionOptions
DataCollectionOptions resource properties
Name | Type | Default value | Description |
---|---|---|---|
isDiagnosticsEventsEnabled |
boolean |
False |
Indicates whether diagnostic collection is enabled for the VM cluster/Cloud VM cluster/VMBM DBCS. |
isHealthMonitoringEnabled |
boolean |
False |
Indicates whether health monitoring is enabled for the VM cluster / Cloud VM cluster / VMBM DBCS. |
isIncidentLogsEnabled |
boolean |
False |
Indicates whether incident logs and trace collection are enabled for the VM cluster / Cloud VM cluster / VMBM DBCS. |
DbIormConfig
DbIormConfig for cloud vm cluster
Name | Type | Description |
---|---|---|
dbName |
string |
The database name. For the default DbPlan, the dbName is default. |
flashCacheLimit |
string |
The flash cache limit for this database. This value is internally configured based on the share value assigned to the database. |
share |
integer (int32) minimum: 1maximum: 32 |
The relative priority of this database. |
DiskRedundancy
Disk redundancy enum
Value | Description |
---|---|
High |
High redundancy |
Normal |
Normal redundancy |
ErrorAdditionalInfo
The resource management error additional info.
Name | Type | Description |
---|---|---|
info |
object |
The additional info. |
type |
string |
The additional info type. |
ErrorDetail
The error detail.
Name | Type | Description |
---|---|---|
additionalInfo |
The error additional info. |
|
code |
string |
The error code. |
details |
The error details. |
|
message |
string |
The error message. |
target |
string |
The error target. |
ErrorResponse
Error response
Name | Type | Description |
---|---|---|
error |
The error object. |
ExadataIormConfig
ExadataIormConfig for cloud vm cluster
Name | Type | Description |
---|---|---|
dbPlans |
An array of IORM settings for all the database in the Exadata DB system. |
|
lifecycleDetails |
string |
Additional information about the current lifecycleState. |
lifecycleState |
The current state of IORM configuration for the Exadata DB system. |
|
objective |
The current value for the IORM objective. The default is AUTO. |
IormLifecycleState
ORM lifecycle state enum
Value | Description |
---|---|
BootStrapping |
Indicates that resource in Provisioning state |
Disabled |
Indicates that resource in Disabled state |
Enabled |
Indicates that resource in Enabled state |
Failed |
Indicates that resource in Failed state |
Updating |
Indicates that resource in Updating state |
LicenseModel
LicenseModel enum
Value | Description |
---|---|
BringYourOwnLicense |
Bring Your Own License |
LicenseIncluded |
License included |
NsgCidr
A rule for allowing inbound (INGRESS) IP packets
Name | Type | Description |
---|---|---|
destinationPortRange |
Destination port range to specify particular destination ports for TCP rules. |
|
source |
string minLength: 1maxLength: 128 |
Conceptually, this is the range of IP addresses that a packet coming into the instance can come from. |
Objective
Objective enum
Value | Description |
---|---|
Auto |
Auto objective |
Balanced |
Balanced objective |
Basic |
Basic objective |
HighThroughput |
High throughput objective |
LowLatency |
Low latency objective |
PortRange
Port Range to specify particular destination ports for TCP rules.
Name | Type | Description |
---|---|---|
max |
integer (int32) minimum: 1maximum: 65535 |
The maximum port number, which must not be less than the minimum port number. To specify a single port number, set both the min and max to the same value. |
min |
integer (int32) minimum: 1maximum: 65535 |
The minimum port number, which must not be greater than the maximum port number. |
systemData
Metadata pertaining to creation and last modification of the resource.
Name | Type | Description |
---|---|---|
createdAt |
string (date-time) |
The timestamp of resource creation (UTC). |
createdBy |
string |
The identity that created the resource. |
createdByType |
The type of identity that created the resource. |
|
lastModifiedAt |
string (date-time) |
The timestamp of resource last modification (UTC) |
lastModifiedBy |
string |
The identity that last modified the resource. |
lastModifiedByType |
The type of identity that last modified the resource. |