Note
Access to this page requires authorization. You can try signing in or changing directories.
Access to this page requires authorization. You can try changing directories.
Bicep resource definition
The dbSystems resource type can be deployed with operations that target:
- Resource groups - See resource group deployment commands
For a list of changed properties in each API version, see change log.
Resource format
To create a Oracle.Database/dbSystems resource, add the following Bicep to your template.
resource symbolicname 'Oracle.Database/dbSystems@2025-09-01' = {
location: 'string'
name: 'string'
properties: {
adminPassword: 'string'
clusterName: 'string'
computeCount: int
computeModel: 'string'
databaseEdition: 'string'
dbSystemOptions: {
storageManagement: 'string'
}
dbVersion: 'string'
diskRedundancy: 'string'
displayName: 'string'
domain: 'string'
hostname: 'string'
initialDataStorageSizeInGb: int
licenseModel: 'string'
networkAnchorId: 'string'
nodeCount: int
pdbName: 'string'
resourceAnchorId: 'string'
shape: 'string'
source: 'string'
sshPublicKeys: [
'string'
]
storageVolumePerformanceMode: 'string'
timeZone: 'string'
}
tags: {
{customized property}: 'string'
}
zones: [
'string'
]
}
Property Values
Oracle.Database/dbSystems
| Name | Description | Value |
|---|---|---|
| location | The geo-location where the resource lives | string (required) |
| name | The resource name | string Constraints: Pattern = .* (required) |
| properties | The resource-specific properties for this resource. | DbSystemProperties |
| tags | Resource tags | Dictionary of tag names and values. See Tags in templates |
| zones | The availability zones. | string[] |
DbSystemOptions
| Name | Description | Value |
|---|---|---|
| storageManagement | The storage option used in DB system. ASM - Automatic storage management, LVM - Logical Volume management. | 'LVM' |
DbSystemProperties
| Name | Description | Value |
|---|---|---|
| adminPassword | A strong password for SYS, SYSTEM, and PDB Admin. The password must be at least nine characters and contain at least two uppercase, two lowercase, two numbers, and two special characters. The special characters must be _, #, or -. | string Constraints: Sensitive value. Pass in as a secure parameter. |
| clusterName | The cluster name for Exadata and 2-node RAC virtual machine DB systems. 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. | string Constraints: Min length = 1 Max length = 11 |
| computeCount | The number of compute servers for the DB system. | int |
| computeModel | The compute model for Base Database Service. This is required if using the computeCount parameter. If using cpuCoreCount then it is an error to specify computeModel to a non-null value. The ECPU compute model is the recommended model, and the OCPU compute model is legacy. |
'ECPU' 'OCPU' |
| databaseEdition | The Oracle Database Edition that applies to all the databases on the DB system. Exadata DB systems and 2-node RAC DB systems require EnterpriseEditionExtremePerformance. | 'EnterpriseEdition' 'EnterpriseEditionDeveloper' 'EnterpriseEditionExtreme' 'EnterpriseEditionHighPerformance' 'StandardEdition' (required) |
| dbSystemOptions | The DB system options. | DbSystemOptions |
| dbVersion | A valid Oracle Database version. For a list of supported versions, use the ListDbVersions operation. | string (required) |
| diskRedundancy | The type of redundancy configured for the DB system. NORMAL is 2-way redundancy. HIGH is 3-way redundancy. | 'High' 'Normal' |
| displayName | The user-friendly name for the DB system. The name does not have to be unique. | string Constraints: Min length = 1 Max length = 255 |
| domain | The domain name for the DB system. | string |
| hostname | The hostname for the DB system. | string (required) |
| initialDataStorageSizeInGb | Size in GB of the initial data volume that will be created and attached to a virtual machine DB system. You can scale up storage after provisioning, as needed. Note that the total storage size attached will be more than the amount you specify to allow for REDO/RECO space and software volume. | int Constraints: Min value = 2 |
| licenseModel | The Oracle license model that applies to all the databases on the DB system. The default is LicenseIncluded. | 'BringYourOwnLicense' 'LicenseIncluded' |
| networkAnchorId | Azure Network Anchor ID | string (required) |
| nodeCount | The number of nodes in the DB system. For RAC DB systems, the value is greater than 1. | int Constraints: Min value = 1 |
| pdbName | The name of the pluggable database. The name must begin with an alphabetic character and can contain a maximum of thirty alphanumeric characters. Special characters are not permitted. Pluggable database should not be same as database name. | string |
| resourceAnchorId | Azure Resource Anchor ID | string (required) |
| shape | The shape of the DB system. The shape determines resources to allocate to the DB system. For virtual machine shapes, the number of CPU cores and memory. For bare metal and Exadata shapes, the number of CPU cores, storage, and memory. | string Constraints: Min length = 1 Max length = 255 (required) |
| source | The source of the database: Use None for creating a new database. The default is None. |
'None' (required) |
| sshPublicKeys | The public key portion of one or more key pairs used for SSH access to the DB system. | string Constraints: Min length = 1 Max length = 1024[] (required) |
| storageVolumePerformanceMode | The block storage volume performance level. Valid values are Balanced and HighPerformance. See Block Volume Performance for more information. | 'Balanced' 'HighPerformance' |
| timeZone | The time zone of the DB system, e.g., UTC, to set the timeZone as UTC. | string Constraints: Min length = 1 Max length = 255 |
TrackedResourceTags
| Name | Description | Value |
|---|
ARM template resource definition
The dbSystems resource type can be deployed with operations that target:
- Resource groups - See resource group deployment commands For a list of changed properties in each API version, see change log.
Usage Examples
Resource format
To create a Oracle.Database/dbSystems resource, add the following JSON to your template.
{
"type": "Oracle.Database/dbSystems",
"apiVersion": "2025-09-01",
"name": "string",
"location": "string",
"properties": {
"adminPassword": "string",
"clusterName": "string",
"computeCount": "int",
"computeModel": "string",
"databaseEdition": "string",
"dbSystemOptions": {
"storageManagement": "string"
},
"dbVersion": "string",
"diskRedundancy": "string",
"displayName": "string",
"domain": "string",
"hostname": "string",
"initialDataStorageSizeInGb": "int",
"licenseModel": "string",
"networkAnchorId": "string",
"nodeCount": "int",
"pdbName": "string",
"resourceAnchorId": "string",
"shape": "string",
"source": "string",
"sshPublicKeys": [ "string" ],
"storageVolumePerformanceMode": "string",
"timeZone": "string"
},
"tags": {
"{customized property}": "string"
},
"zones": [ "string" ]
}
Property Values
Oracle.Database/dbSystems
| Name | Description | Value |
|---|---|---|
| apiVersion | The api version | '2025-09-01' |
| location | The geo-location where the resource lives | string (required) |
| name | The resource name | string Constraints: Pattern = .* (required) |
| properties | The resource-specific properties for this resource. | DbSystemProperties |
| tags | Resource tags | Dictionary of tag names and values. See Tags in templates |
| type | The resource type | 'Oracle.Database/dbSystems' |
| zones | The availability zones. | string[] |
DbSystemOptions
| Name | Description | Value |
|---|---|---|
| storageManagement | The storage option used in DB system. ASM - Automatic storage management, LVM - Logical Volume management. | 'LVM' |
DbSystemProperties
| Name | Description | Value |
|---|---|---|
| adminPassword | A strong password for SYS, SYSTEM, and PDB Admin. The password must be at least nine characters and contain at least two uppercase, two lowercase, two numbers, and two special characters. The special characters must be _, #, or -. | string Constraints: Sensitive value. Pass in as a secure parameter. |
| clusterName | The cluster name for Exadata and 2-node RAC virtual machine DB systems. 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. | string Constraints: Min length = 1 Max length = 11 |
| computeCount | The number of compute servers for the DB system. | int |
| computeModel | The compute model for Base Database Service. This is required if using the computeCount parameter. If using cpuCoreCount then it is an error to specify computeModel to a non-null value. The ECPU compute model is the recommended model, and the OCPU compute model is legacy. |
'ECPU' 'OCPU' |
| databaseEdition | The Oracle Database Edition that applies to all the databases on the DB system. Exadata DB systems and 2-node RAC DB systems require EnterpriseEditionExtremePerformance. | 'EnterpriseEdition' 'EnterpriseEditionDeveloper' 'EnterpriseEditionExtreme' 'EnterpriseEditionHighPerformance' 'StandardEdition' (required) |
| dbSystemOptions | The DB system options. | DbSystemOptions |
| dbVersion | A valid Oracle Database version. For a list of supported versions, use the ListDbVersions operation. | string (required) |
| diskRedundancy | The type of redundancy configured for the DB system. NORMAL is 2-way redundancy. HIGH is 3-way redundancy. | 'High' 'Normal' |
| displayName | The user-friendly name for the DB system. The name does not have to be unique. | string Constraints: Min length = 1 Max length = 255 |
| domain | The domain name for the DB system. | string |
| hostname | The hostname for the DB system. | string (required) |
| initialDataStorageSizeInGb | Size in GB of the initial data volume that will be created and attached to a virtual machine DB system. You can scale up storage after provisioning, as needed. Note that the total storage size attached will be more than the amount you specify to allow for REDO/RECO space and software volume. | int Constraints: Min value = 2 |
| licenseModel | The Oracle license model that applies to all the databases on the DB system. The default is LicenseIncluded. | 'BringYourOwnLicense' 'LicenseIncluded' |
| networkAnchorId | Azure Network Anchor ID | string (required) |
| nodeCount | The number of nodes in the DB system. For RAC DB systems, the value is greater than 1. | int Constraints: Min value = 1 |
| pdbName | The name of the pluggable database. The name must begin with an alphabetic character and can contain a maximum of thirty alphanumeric characters. Special characters are not permitted. Pluggable database should not be same as database name. | string |
| resourceAnchorId | Azure Resource Anchor ID | string (required) |
| shape | The shape of the DB system. The shape determines resources to allocate to the DB system. For virtual machine shapes, the number of CPU cores and memory. For bare metal and Exadata shapes, the number of CPU cores, storage, and memory. | string Constraints: Min length = 1 Max length = 255 (required) |
| source | The source of the database: Use None for creating a new database. The default is None. |
'None' (required) |
| sshPublicKeys | The public key portion of one or more key pairs used for SSH access to the DB system. | string Constraints: Min length = 1 Max length = 1024[] (required) |
| storageVolumePerformanceMode | The block storage volume performance level. Valid values are Balanced and HighPerformance. See Block Volume Performance for more information. | 'Balanced' 'HighPerformance' |
| timeZone | The time zone of the DB system, e.g., UTC, to set the timeZone as UTC. | string Constraints: Min length = 1 Max length = 255 |
TrackedResourceTags
| Name | Description | Value |
|---|
Terraform (AzAPI provider) resource definition
The dbSystems resource type can be deployed with operations that target:
- Resource groups For a list of changed properties in each API version, see change log.
Resource format
To create a Oracle.Database/dbSystems resource, add the following Terraform to your template.
resource "azapi_resource" "symbolicname" {
type = "Oracle.Database/dbSystems@2025-09-01"
name = "string"
parent_id = "string"
location = "string"
tags = {
{customized property} = "string"
}
body = {
properties = {
adminPassword = "string"
clusterName = "string"
computeCount = int
computeModel = "string"
databaseEdition = "string"
dbSystemOptions = {
storageManagement = "string"
}
dbVersion = "string"
diskRedundancy = "string"
displayName = "string"
domain = "string"
hostname = "string"
initialDataStorageSizeInGb = int
licenseModel = "string"
networkAnchorId = "string"
nodeCount = int
pdbName = "string"
resourceAnchorId = "string"
shape = "string"
source = "string"
sshPublicKeys = [
"string"
]
storageVolumePerformanceMode = "string"
timeZone = "string"
}
zones = [
"string"
]
}
}
Property Values
Oracle.Database/dbSystems
| Name | Description | Value |
|---|---|---|
| location | The geo-location where the resource lives | string (required) |
| name | The resource name | string Constraints: Pattern = .* (required) |
| properties | The resource-specific properties for this resource. | DbSystemProperties |
| tags | Resource tags | Dictionary of tag names and values. |
| type | The resource type | "Oracle.Database/dbSystems@2025-09-01" |
| zones | The availability zones. | string[] |
DbSystemOptions
| Name | Description | Value |
|---|---|---|
| storageManagement | The storage option used in DB system. ASM - Automatic storage management, LVM - Logical Volume management. | 'LVM' |
DbSystemProperties
| Name | Description | Value |
|---|---|---|
| adminPassword | A strong password for SYS, SYSTEM, and PDB Admin. The password must be at least nine characters and contain at least two uppercase, two lowercase, two numbers, and two special characters. The special characters must be _, #, or -. | string Constraints: Sensitive value. Pass in as a secure parameter. |
| clusterName | The cluster name for Exadata and 2-node RAC virtual machine DB systems. 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. | string Constraints: Min length = 1 Max length = 11 |
| computeCount | The number of compute servers for the DB system. | int |
| computeModel | The compute model for Base Database Service. This is required if using the computeCount parameter. If using cpuCoreCount then it is an error to specify computeModel to a non-null value. The ECPU compute model is the recommended model, and the OCPU compute model is legacy. |
'ECPU' 'OCPU' |
| databaseEdition | The Oracle Database Edition that applies to all the databases on the DB system. Exadata DB systems and 2-node RAC DB systems require EnterpriseEditionExtremePerformance. | 'EnterpriseEdition' 'EnterpriseEditionDeveloper' 'EnterpriseEditionExtreme' 'EnterpriseEditionHighPerformance' 'StandardEdition' (required) |
| dbSystemOptions | The DB system options. | DbSystemOptions |
| dbVersion | A valid Oracle Database version. For a list of supported versions, use the ListDbVersions operation. | string (required) |
| diskRedundancy | The type of redundancy configured for the DB system. NORMAL is 2-way redundancy. HIGH is 3-way redundancy. | 'High' 'Normal' |
| displayName | The user-friendly name for the DB system. The name does not have to be unique. | string Constraints: Min length = 1 Max length = 255 |
| domain | The domain name for the DB system. | string |
| hostname | The hostname for the DB system. | string (required) |
| initialDataStorageSizeInGb | Size in GB of the initial data volume that will be created and attached to a virtual machine DB system. You can scale up storage after provisioning, as needed. Note that the total storage size attached will be more than the amount you specify to allow for REDO/RECO space and software volume. | int Constraints: Min value = 2 |
| licenseModel | The Oracle license model that applies to all the databases on the DB system. The default is LicenseIncluded. | 'BringYourOwnLicense' 'LicenseIncluded' |
| networkAnchorId | Azure Network Anchor ID | string (required) |
| nodeCount | The number of nodes in the DB system. For RAC DB systems, the value is greater than 1. | int Constraints: Min value = 1 |
| pdbName | The name of the pluggable database. The name must begin with an alphabetic character and can contain a maximum of thirty alphanumeric characters. Special characters are not permitted. Pluggable database should not be same as database name. | string |
| resourceAnchorId | Azure Resource Anchor ID | string (required) |
| shape | The shape of the DB system. The shape determines resources to allocate to the DB system. For virtual machine shapes, the number of CPU cores and memory. For bare metal and Exadata shapes, the number of CPU cores, storage, and memory. | string Constraints: Min length = 1 Max length = 255 (required) |
| source | The source of the database: Use None for creating a new database. The default is None. |
'None' (required) |
| sshPublicKeys | The public key portion of one or more key pairs used for SSH access to the DB system. | string Constraints: Min length = 1 Max length = 1024[] (required) |
| storageVolumePerformanceMode | The block storage volume performance level. Valid values are Balanced and HighPerformance. See Block Volume Performance for more information. | 'Balanced' 'HighPerformance' |
| timeZone | The time zone of the DB system, e.g., UTC, to set the timeZone as UTC. | string Constraints: Min length = 1 Max length = 255 |
TrackedResourceTags
| Name | Description | Value |
|---|