oci.Database.AutonomousDatabase
Explore with Pulumi AI
This resource provides the Autonomous Database resource in Oracle Cloud Infrastructure Database service.
Creates a new Autonomous Database.
Create AutonomousDatabase Resource
new AutonomousDatabase(name: string, args: AutonomousDatabaseArgs, opts?: CustomResourceOptions);
@overload
def AutonomousDatabase(resource_name: str,
opts: Optional[ResourceOptions] = None,
admin_password: Optional[str] = None,
are_primary_whitelisted_ips_used: Optional[bool] = None,
autonomous_container_database_id: Optional[str] = None,
autonomous_database_backup_id: Optional[str] = None,
autonomous_database_id: Optional[str] = None,
autonomous_maintenance_schedule_type: Optional[str] = None,
backup_retention_period_in_days: Optional[int] = None,
character_set: Optional[str] = None,
clone_type: Optional[str] = None,
compartment_id: Optional[str] = None,
compute_count: Optional[float] = None,
compute_model: Optional[str] = None,
cpu_core_count: Optional[int] = None,
customer_contacts: Optional[Sequence[_database.AutonomousDatabaseCustomerContactArgs]] = None,
data_safe_status: Optional[str] = None,
data_storage_size_in_gb: Optional[int] = None,
data_storage_size_in_tbs: Optional[int] = None,
database_edition: Optional[str] = None,
database_management_status: Optional[str] = None,
db_name: Optional[str] = None,
db_version: Optional[str] = None,
db_workload: Optional[str] = None,
defined_tags: Optional[Mapping[str, Any]] = None,
display_name: Optional[str] = None,
freeform_tags: Optional[Mapping[str, Any]] = None,
in_memory_percentage: Optional[int] = None,
is_access_control_enabled: Optional[bool] = None,
is_auto_scaling_enabled: Optional[bool] = None,
is_auto_scaling_for_storage_enabled: Optional[bool] = None,
is_data_guard_enabled: Optional[bool] = None,
is_dedicated: Optional[bool] = None,
is_free_tier: Optional[bool] = None,
is_local_data_guard_enabled: Optional[bool] = None,
is_mtls_connection_required: Optional[bool] = None,
is_preview_version_with_service_terms_accepted: Optional[bool] = None,
is_refreshable_clone: Optional[bool] = None,
is_shrink_only: Optional[bool] = None,
kms_key_id: Optional[str] = None,
license_model: Optional[str] = None,
local_adg_auto_failover_max_data_loss_limit: Optional[int] = None,
max_cpu_core_count: Optional[int] = None,
ncharacter_set: Optional[str] = None,
nsg_ids: Optional[Sequence[str]] = None,
ocpu_count: Optional[float] = None,
open_mode: Optional[str] = None,
operations_insights_status: Optional[str] = None,
permission_level: Optional[str] = None,
private_endpoint_ip: Optional[str] = None,
private_endpoint_label: Optional[str] = None,
refreshable_mode: Optional[str] = None,
remote_disaster_recovery_type: Optional[str] = None,
resource_pool_leader_id: Optional[str] = None,
resource_pool_summary: Optional[_database.AutonomousDatabaseResourcePoolSummaryArgs] = None,
rotate_key_trigger: Optional[bool] = None,
scheduled_operations: Optional[Sequence[_database.AutonomousDatabaseScheduledOperationArgs]] = None,
secret_id: Optional[str] = None,
secret_version_number: Optional[int] = None,
source: Optional[str] = None,
source_id: Optional[str] = None,
standby_whitelisted_ips: Optional[Sequence[str]] = None,
state: Optional[str] = None,
subnet_id: Optional[str] = None,
switchover_to: Optional[str] = None,
switchover_to_remote_peer_id: Optional[str] = None,
timestamp: Optional[str] = None,
use_latest_available_backup_time_stamp: Optional[bool] = None,
vault_id: Optional[str] = None,
whitelisted_ips: Optional[Sequence[str]] = None)
@overload
def AutonomousDatabase(resource_name: str,
args: AutonomousDatabaseArgs,
opts: Optional[ResourceOptions] = None)
func NewAutonomousDatabase(ctx *Context, name string, args AutonomousDatabaseArgs, opts ...ResourceOption) (*AutonomousDatabase, error)
public AutonomousDatabase(string name, AutonomousDatabaseArgs args, CustomResourceOptions? opts = null)
public AutonomousDatabase(String name, AutonomousDatabaseArgs args)
public AutonomousDatabase(String name, AutonomousDatabaseArgs args, CustomResourceOptions options)
type: oci:Database:AutonomousDatabase
properties: # The arguments to resource properties.
options: # Bag of options to control resource's behavior.
- name string
- The unique name of the resource.
- args AutonomousDatabaseArgs
- The arguments to resource properties.
- opts CustomResourceOptions
- Bag of options to control resource's behavior.
- resource_name str
- The unique name of the resource.
- args AutonomousDatabaseArgs
- The arguments to resource properties.
- opts ResourceOptions
- Bag of options to control resource's behavior.
- ctx Context
- Context object for the current deployment.
- name string
- The unique name of the resource.
- args AutonomousDatabaseArgs
- The arguments to resource properties.
- opts ResourceOption
- Bag of options to control resource's behavior.
- name string
- The unique name of the resource.
- args AutonomousDatabaseArgs
- The arguments to resource properties.
- opts CustomResourceOptions
- Bag of options to control resource's behavior.
- name String
- The unique name of the resource.
- args AutonomousDatabaseArgs
- The arguments to resource properties.
- options CustomResourceOptions
- Bag of options to control resource's behavior.
AutonomousDatabase Resource Properties
To learn more about resource properties and how to use them, see Inputs and Outputs in the Architecture and Concepts docs.
Inputs
The AutonomousDatabase resource accepts the following input properties:
- Compartment
Id string (Updatable) The OCID of the compartment of the Autonomous Database.
- Db
Name string (Updatable) Specify the database name; it must consist of letters and numbers only. The maximum length is 30 characters. The same database name cannot be used for multiple Autonomous Databases in the same tenancy in the same region.
- Admin
Password string (Updatable) The password must be between 12 and 30 characters long, and must contain at least 1 uppercase, 1 lowercase, and 1 numeric character. It cannot contain the double quote symbol (") or the username "admin", regardless of casing. The password is mandatory if source value is "BACKUP_FROM_ID", "BACKUP_FROM_TIMESTAMP", "DATABASE" or "NONE".
- Are
Primary boolWhitelisted Ips Used (Updatable) This field will be null if the Autonomous Database is not Data Guard enabled or Access Control is disabled. It's value would be
TRUE
if Autonomous Database is Data Guard enabled and Access Control is enabled and if the Autonomous Database uses primary IP access control list (ACL) for standby. It's value would beFALSE
if Autonomous Database is Data Guard enabled and Access Control is enabled and if the Autonomous Database uses different IP access control list (ACL) for standby compared to primary.- Autonomous
Container stringDatabase Id The Autonomous Container Database OCID.
- Autonomous
Database stringBackup Id The OCID of the source Autonomous Database Backup that you will clone to create a new Autonomous Database.
- Autonomous
Database stringId The OCID of the source Autonomous Database that you will clone to create a new Autonomous Database.
- Autonomous
Maintenance stringSchedule Type The maintenance schedule type of the Autonomous Database on shared Exadata infrastructure. The EARLY maintenance schedule of this Autonomous Database follows a schedule that applies patches prior to the REGULAR schedule.The REGULAR maintenance schedule of this Autonomous Database follows the normal cycle.
- Backup
Retention intPeriod In Days (Updatable) Retention period, in days, for backups.
- Character
Set string The character set for the autonomous database. The default is AL32UTF8. Allowed values for an Autonomous Database on shared infrastructure as as returned by List Autonomous Database Character Sets
For an Autonomous Database on dedicated infrastructure, the allowed values are:
AL32UTF8, AR8ADOS710, AR8ADOS720, AR8APTEC715, AR8ARABICMACS, AR8ASMO8X, AR8ISO8859P6, AR8MSWIN1256, AR8MUSSAD768, AR8NAFITHA711, AR8NAFITHA721, AR8SAKHR706, AR8SAKHR707, AZ8ISO8859P9E, BG8MSWIN, BG8PC437S, BLT8CP921, BLT8ISO8859P13, BLT8MSWIN1257, BLT8PC775, BN8BSCII, CDN8PC863, CEL8ISO8859P14, CL8ISO8859P5, CL8ISOIR111, CL8KOI8R, CL8KOI8U, CL8MACCYRILLICS, CL8MSWIN1251, EE8ISO8859P2, EE8MACCES, EE8MACCROATIANS, EE8MSWIN1250, EE8PC852, EL8DEC, EL8ISO8859P7, EL8MACGREEKS, EL8MSWIN1253, EL8PC437S, EL8PC851, EL8PC869, ET8MSWIN923, HU8ABMOD, HU8CWI2, IN8ISCII, IS8PC861, IW8ISO8859P8, IW8MACHEBREWS, IW8MSWIN1255, IW8PC1507, JA16EUC, JA16EUCTILDE, JA16SJIS, JA16SJISTILDE, JA16VMS, KO16KSC5601, KO16KSCCS, KO16MSWIN949, LA8ISO6937, LA8PASSPORT, LT8MSWIN921, LT8PC772, LT8PC774, LV8PC1117, LV8PC8LR, LV8RST104090, N8PC865, NE8ISO8859P10, NEE8ISO8859P4, RU8BESTA, RU8PC855, RU8PC866, SE8ISO8859P3, TH8MACTHAIS, TH8TISASCII, TR8DEC, TR8MACTURKISHS, TR8MSWIN1254, TR8PC857, US7ASCII, US8PC437, UTF8, VN8MSWIN1258, VN8VN3, WE8DEC, WE8DG, WE8ISO8859P1, WE8ISO8859P15, WE8ISO8859P9, WE8MACROMAN8S, WE8MSWIN1252, WE8NCR4970, WE8NEXTSTEP, WE8PC850, WE8PC858, WE8PC860, WE8ROMAN8, ZHS16CGB231280, ZHS16GBK, ZHT16BIG5, ZHT16CCDC, ZHT16DBT, ZHT16HKSCS, ZHT16MSWIN950, ZHT32EUC, ZHT32SOPS, ZHT32TRIS
- Clone
Type string The Autonomous Database clone type.
- Compute
Count double (Updatable) The compute amount available to the database. Minimum and maximum values depend on the compute model and whether the database is on Shared or Dedicated infrastructure. For an Autonomous Database on Shared infrastructure, the 'ECPU' compute model requires values in multiples of two. Required when using the
computeModel
parameter. When usingcpuCoreCount
parameter, it is an error to specify computeCount to a non-null value.- Compute
Model string (Updatable) The compute model of the Autonomous Database. This is required if using the
computeCount
parameter. If usingcpuCoreCount
then it is an error to specifycomputeModel
to a non-null value.- Cpu
Core intCount (Updatable) The number of OCPU cores to be made available to the database. For Autonomous Databases on dedicated Exadata infrastructure, the maximum number of cores is determined by the infrastructure shape. See Characteristics of Infrastructure Shapes for shape details. Note: This parameter cannot be used with the
ocpuCount
parameter. This input is ignored for Always Free resources.- The data type must be an integer.
- The minimum number of cores for all types of autonomous database is 1
- The maximum number of cores is as follows:
- Autonomous Databases on shared Exadata infrastructure: The maximum number of cores is 128.
- Autonomous Databases on dedicated Exadata infrastructure: The maximum number of cores is determined by the infrastructure shape. See Characteristics of Infrastructure Shapes for shape details.
- Customer
Contacts List<AutonomousDatabase Customer Contact> (Updatable) Customer Contacts.
- Data
Safe stringStatus (Updatable) Status of the Data Safe registration for this Autonomous Database. Could be REGISTERED or NOT_REGISTERED.
- Data
Storage intSize In Gb (Updatable) The size, in gigabytes, of the data volume that will be created and attached to the database. This storage can later be scaled up if needed. The maximum storage value is determined by the infrastructure shape. See Characteristics of Infrastructure Shapes for shape details.
Notes
- This parameter is only supported for dedicated Exadata infrastructure.
- This parameter cannot be used with the
dataStorageSizeInTBs
parameter.
- Data
Storage intSize In Tbs (Updatable) The size, in terabytes, of the data volume that will be created and attached to the database. This storage can later be scaled up if needed. For Autonomous Databases on dedicated Exadata infrastructure, the maximum storage value is determined by the infrastructure shape. See Characteristics of Infrastructure Shapes for shape details. A full Exadata service is allocated when the Autonomous Database size is set to the upper limit (384 TB).
Note: This parameter cannot be used with the
dataStorageSizeInGBs
parameter. This input is ignored for Always Free resources.- Database
Edition string (Updatable) The Oracle Database Edition that applies to the Autonomous databases.
- Database
Management stringStatus Status of Database Management for this Autonomous Database.
- Db
Version string (Updatable) A valid Oracle Database version for Autonomous Database.
db_workload
AJD and APEX are only supported fordb_version
19c
and above.- Db
Workload string (Updatable) The Autonomous Database workload type. The following values are valid:
- OLTP - indicates an Autonomous Transaction Processing database
- DW - indicates an Autonomous Data Warehouse database
- AJD - indicates an Autonomous JSON Database
- APEX - indicates an Autonomous Database with the Oracle APEX Application Development workload type.
This cannot be updated in parallel with any of the following: licenseModel, dbEdition, cpuCoreCount, computeCount, computeModel, adminPassword, whitelistedIps, isMTLSConnectionRequired, privateEndpointLabel, nsgIds, dbVersion, isRefreshable, dbName, scheduledOperations, dbToolsDetails, isLocalDataGuardEnabled, or isFreeTier. *Note:
db_workload
can only be updated from AJD to OLTP or from a free OLTP to AJD.- Dictionary<string, object>
(Updatable) Defined tags for this resource. Each key is predefined and scoped to a namespace. For more information, see Resource Tags.
- Display
Name string (Updatable) The user-friendly name for the Autonomous Database. The name does not have to be unique.
- Dictionary<string, object>
(Updatable) Free-form tags for this resource. Each tag is a simple key-value pair with no predefined name, type, or namespace. For more information, see Resource Tags. Example:
{"Department": "Finance"}
- In
Memory intPercentage (Updatable) The percentage of the System Global Area(SGA) assigned to In-Memory tables in Autonomous Database.
- Is
Access boolControl Enabled (Updatable) Indicates if the database-level access control is enabled. If disabled, database access is defined by the network security rules. If enabled, database access is restricted to the IP addresses defined by the rules specified with the
whitelistedIps
property. While specifyingwhitelistedIps
rules is optional, if database-level access control is enabled and no rules are specified, the database will become inaccessible. The rules can be added later using theUpdateAutonomousDatabase
API operation or edit option in console. When creating a database clone, the desired access control setting should be specified. By default, database-level access control will be disabled for the clone.This property is applicable only to Autonomous Databases on the Exadata Cloud@Customer platform.
- Is
Auto boolScaling Enabled (Updatable) Indicates if auto scaling is enabled for the Autonomous Database OCPU core count. The default value is
FALSE
.- Is
Auto boolScaling For Storage Enabled (Updatable) Indicates if auto scaling is enabled for the Autonomous Database storage. The default value is
FALSE
.- Is
Data boolGuard Enabled (Updatable) Deprecated. Indicates whether the Autonomous Database has local (in-region) Data Guard enabled. Not applicable to cross-region Autonomous Data Guard associations, or to Autonomous Databases using dedicated Exadata infrastructure or Exadata Cloud@Customer infrastructure.
- Is
Dedicated bool True if the database is on dedicated Exadata infrastructure.
- Is
Free boolTier (Updatable) Indicates if this is an Always Free resource. The default value is false. Note that Always Free Autonomous Databases have 1 CPU and 20GB of memory. For Always Free databases, memory and CPU cannot be scaled. When
db_workload
isAJD
orAPEX
it cannot betrue
.- Is
Local boolData Guard Enabled (Updatable) Indicates whether the Autonomous Database has local (in-region) Data Guard enabled. Not applicable to cross-region Autonomous Data Guard associations, or to Autonomous Databases using dedicated Exadata infrastructure or Exadata Cloud@Customer infrastructure.
- Is
Mtls boolConnection Required (Updatable) Indicates whether the Autonomous Database requires mTLS connections.
- Is
Preview boolVersion With Service Terms Accepted If set to
TRUE
, indicates that an Autonomous Database preview version is being provisioned, and that the preview version's terms of service have been accepted. Note that preview version software is only available for databases on shared Exadata infrastructure.- Is
Refreshable boolClone (Updatable) True for creating a refreshable clone and False for detaching the clone from source Autonomous Database. Detaching is one time operation and clone becomes a regular Autonomous Database.
- Is
Shrink boolOnly (Updatable) An optional property when enabled triggers the Shrinking of Autonomous Database once. To trigger Shrinking of ADB once again, this flag needs to be disabled and re-enabled again. It should not be passed during create database operation. It is only applicable on shared databases i.e. where
is_dedicated
is false.** IMPORTANT ** Any change to a property that does not support update will force the destruction and recreation of the resource with the new property values
- Kms
Key stringId The OCID of the key container that is used as the master encryption key in database transparent data encryption (TDE) operations.
- License
Model string (Updatable) The Oracle license model that applies to the Oracle Autonomous Database. Bring your own license (BYOL) allows you to apply your current on-premises Oracle software licenses to equivalent, highly automated Oracle PaaS and IaaS services in the cloud. License Included allows you to subscribe to new Oracle Database software licenses and the Database service. Note that when provisioning an Autonomous Database on dedicated Exadata infrastructure, this attribute must be null because the attribute is already set at the Autonomous Exadata Infrastructure level. When using shared Exadata infrastructure, if a value is not specified, the system will supply the value of
BRING_YOUR_OWN_LICENSE
. It is a required field whendb_workload
is AJD and needs to be set toLICENSE_INCLUDED
as AJD does not support defaultlicense_model
valueBRING_YOUR_OWN_LICENSE
.- Local
Adg intAuto Failover Max Data Loss Limit Parameter that allows users to select an acceptable maximum data loss limit in seconds, up to which Automatic Failover will be triggered when necessary for a Local Autonomous Data Guard
- Max
Cpu intCore Count (Updatable) The number of Max OCPU cores to be made available to the autonomous database with auto scaling of cpu enabled.
- Ncharacter
Set string The national character set for the autonomous database. The default is AL16UTF16. Allowed values are: AL16UTF16 or UTF8.
- Nsg
Ids List<string> (Updatable) The list of OCIDs for the network security groups (NSGs) to which this resource belongs. Setting this to an empty list removes all resources from all NSGs. For more information about NSGs, see Security Rules. NsgIds restrictions:
- A network security group (NSG) is optional for Autonomous Databases with private access. The nsgIds list can be empty.
- Ocpu
Count double (Updatable) The number of OCPU cores to be made available to the database.
The following points apply:
- For Autonomous Databases on dedicated Exadata infrastructure, to provision less than 1 core, enter a fractional value in an increment of 0.1. For example, you can provision 0.3 or 0.4 cores, but not 0.35 cores. (Note that fractional OCPU values are not supported for Autonomous Databasese on shared Exadata infrastructure.)
- To provision 1 or more cores, you must enter an integer between 1 and the maximum number of cores available for the infrastructure shape. For example, you can provision 2 cores or 3 cores, but not 2.5 cores. This applies to Autonomous Databases on both shared and dedicated Exadata infrastructure.
For Autonomous Databases on dedicated Exadata infrastructure, the maximum number of cores is determined by the infrastructure shape. See Characteristics of Infrastructure Shapes for shape details.
Note: This parameter cannot be used with the
cpuCoreCount
parameter.- Open
Mode string Indicates the Autonomous Database mode. The database can be opened in
READ_ONLY
orREAD_WRITE
mode.- Operations
Insights stringStatus (Updatable) Status of Operations Insights for this Autonomous Database. Values supported are
ENABLED
andNOT_ENABLED
- Permission
Level string The Autonomous Database permission level. Restricted mode allows access only by admin users.
- Private
Endpoint stringIp The private endpoint Ip address for the resource.
- Private
Endpoint stringLabel (Updatable) The private endpoint label for the resource.
- Refreshable
Mode string (Updatable) The refresh mode of the clone. AUTOMATIC indicates that the clone is automatically being refreshed with data from the source Autonomous Database.
- Remote
Disaster stringRecovery Type Indicates the cross-region disaster recovery (DR) type of the standby Shared Autonomous Database. Autonomous Data Guard (ADG) DR type provides business critical DR with a faster recovery time objective (RTO) during failover or switchover. Backup-based DR type provides lower cost DR with a slower RTO during failover or switchover.
- Resource
Pool stringLeader Id - Resource
Pool AutonomousSummary Database Resource Pool Summary - Rotate
Key boolTrigger (Updatable) An optional property when flipped triggers rotation of KMS key. It is only applicable on dedicated databases i.e. where
is_dedicated
is true.- Scheduled
Operations List<AutonomousDatabase Scheduled Operation> (Updatable) The list of scheduled operations.
This cannot be updated in parallel with any of the following: licenseModel, dbEdition, cpuCoreCount, computeCount, computeModel, whitelistedIps, isMTLSConnectionRequired, openMode, permissionLevel, dbWorkload, privateEndpointLabel, nsgIds, dbVersion, isRefreshable, dbName, dbToolsDetails, isLocalDataGuardEnabled, or isFreeTier.
- Secret
Id string (Updatable) The Oracle Cloud Infrastructure vault secret [/Content/General/Concepts/identifiers.htm]OCID.
- Secret
Version intNumber (Updatable) The version of the vault secret. If no version is specified, the latest version will be used.
- Source string
The source of the database: Use
NONE
for creating a new Autonomous Database. UseDATABASE
for creating a new Autonomous Database by cloning an existing Autonomous Database. UseCROSS_REGION_DATAGUARD
to create a standby Data Guard database in another region.For Autonomous Databases on shared Exadata infrastructure, the following cloning options are available: Use
BACKUP_FROM_ID
for creating a new Autonomous Database from a specified backup. UseBACKUP_FROM_TIMESTAMP
for creating a point-in-time Autonomous Database clone using backups. For more information, see Cloning and Moving an Autonomous Database.- Source
Id string The OCID of the source Autonomous Database that will be used to create a new standby database for the Data Guard association.
- Standby
Whitelisted List<string>Ips (Updatable) The client IP access control list (ACL). This feature is available for autonomous databases on shared Exadata infrastructure and on Exadata Cloud@Customer. Only clients connecting from an IP address included in the ACL may access the Autonomous Database instance.
For shared Exadata infrastructure, this is an array of CIDR (Classless Inter-Domain Routing) notations for a subnet or VCN OCID. Use a semicolon (;) as a deliminator between the VCN-specific subnets or IPs. Example:
["1.1.1.1","1.1.1.0/24","ocid1.vcn.oc1.sea.<unique_id>","ocid1.vcn.oc1.sea.<unique_id1>;1.1.1.1","ocid1.vcn.oc1.sea.<unique_id2>;1.1.0.0/16"]
For Exadata Cloud@Customer, this is an array of IP addresses or CIDR (Classless Inter-Domain Routing) notations. Example:["1.1.1.1","1.1.1.0/24","1.1.2.25"]
For an update operation, if you want to delete all the IPs in the ACL, use an array with a single empty string entry.
This cannot be updated in parallel with any of the following: licenseModel, dbEdition, cpuCoreCount, computeCount, computeModel, adminPassword, isMTLSConnectionRequired, openMode, permissionLevel, dbWorkload, dbVersion, isRefreshable, dbName, scheduledOperations, dbToolsDetails, isLocalDataGuardEnabled, or isFreeTier.
- State string
The current state of the Autonomous Database.
- Subnet
Id string (Updatable) The OCID of the subnet the resource is associated with.
Subnet Restrictions:
- For bare metal DB systems and for single node virtual machine DB systems, do not use a subnet that overlaps with 192.168.16.16/28.
- For Exadata and virtual machine 2-node RAC systems, do not use a subnet that overlaps with 192.168.128.0/20.
- For Autonomous Database, setting this will disable public secure access to the database.
These subnets are used by the Oracle Clusterware private interconnect on the database instance. Specifying an overlapping subnet will cause the private interconnect to malfunction. This restriction applies to both the client subnet and the backup subnet.
- Switchover
To string It is applicable only when
is_data_guard_enabled
is true. Could be set toPRIMARY
orSTANDBY
. Default value isPRIMARY
.- Switchover
To stringRemote Peer Id (Updatable) It is applicable only when
dataguard_region_type
androle
are set, andis_dedicated
is false. It takes the OCID of the remote peer to switchover to.- Timestamp string
The timestamp specified for the point-in-time clone of the source Autonomous Database. The timestamp must be in the past.
- Use
Latest boolAvailable Backup Time Stamp Clone from latest available backup timestamp.
- Vault
Id string - Whitelisted
Ips List<string> (Updatable) The client IP access control list (ACL). This feature is available for autonomous databases on shared Exadata infrastructure and on Exadata Cloud@Customer. Only clients connecting from an IP address included in the ACL may access the Autonomous Database instance.
For shared Exadata infrastructure, this is an array of CIDR (Classless Inter-Domain Routing) notations for a subnet or VCN OCID. Use a semicolon (;) as a deliminator between the VCN-specific subnets or IPs. Example:
["1.1.1.1","1.1.1.0/24","ocid1.vcn.oc1.sea.<unique_id>","ocid1.vcn.oc1.sea.<unique_id1>;1.1.1.1","ocid1.vcn.oc1.sea.<unique_id2>;1.1.0.0/16"]
For Exadata Cloud@Customer, this is an array of IP addresses or CIDR (Classless Inter-Domain Routing) notations. Example:["1.1.1.1","1.1.1.0/24","1.1.2.25"]
For an update operation, if you want to delete all the IPs in the ACL, use an array with a single empty string entry.
This cannot be updated in parallel with any of the following: licenseModel, dbEdition, cpuCoreCount, computeCount, computeModel, adminPassword, isMTLSConnectionRequired, openMode, permissionLevel, dbWorkload, dbVersion, isRefreshable, dbName, scheduledOperations, dbToolsDetails, isLocalDataGuardEnabled, or isFreeTier. To remove all whitelisted IPs, set the field to a list with an empty string
[""]
.This cannot be updated in parallel with any of the following: licenseModel, dbEdition, cpuCoreCount, computeCount, computeModel, adminPassword, isMTLSConnectionRequired, openMode, permissionLevel, dbWorkload, dbVersion, isRefreshable, dbName, scheduledOperations, dbToolsDetails, isLocalDataGuardEnabled, or isFreeTier. To remove all whitelisted IPs, set the field to a list with an empty string
[""]
.
- Compartment
Id string (Updatable) The OCID of the compartment of the Autonomous Database.
- Db
Name string (Updatable) Specify the database name; it must consist of letters and numbers only. The maximum length is 30 characters. The same database name cannot be used for multiple Autonomous Databases in the same tenancy in the same region.
- Admin
Password string (Updatable) The password must be between 12 and 30 characters long, and must contain at least 1 uppercase, 1 lowercase, and 1 numeric character. It cannot contain the double quote symbol (") or the username "admin", regardless of casing. The password is mandatory if source value is "BACKUP_FROM_ID", "BACKUP_FROM_TIMESTAMP", "DATABASE" or "NONE".
- Are
Primary boolWhitelisted Ips Used (Updatable) This field will be null if the Autonomous Database is not Data Guard enabled or Access Control is disabled. It's value would be
TRUE
if Autonomous Database is Data Guard enabled and Access Control is enabled and if the Autonomous Database uses primary IP access control list (ACL) for standby. It's value would beFALSE
if Autonomous Database is Data Guard enabled and Access Control is enabled and if the Autonomous Database uses different IP access control list (ACL) for standby compared to primary.- Autonomous
Container stringDatabase Id The Autonomous Container Database OCID.
- Autonomous
Database stringBackup Id The OCID of the source Autonomous Database Backup that you will clone to create a new Autonomous Database.
- Autonomous
Database stringId The OCID of the source Autonomous Database that you will clone to create a new Autonomous Database.
- Autonomous
Maintenance stringSchedule Type The maintenance schedule type of the Autonomous Database on shared Exadata infrastructure. The EARLY maintenance schedule of this Autonomous Database follows a schedule that applies patches prior to the REGULAR schedule.The REGULAR maintenance schedule of this Autonomous Database follows the normal cycle.
- Backup
Retention intPeriod In Days (Updatable) Retention period, in days, for backups.
- Character
Set string The character set for the autonomous database. The default is AL32UTF8. Allowed values for an Autonomous Database on shared infrastructure as as returned by List Autonomous Database Character Sets
For an Autonomous Database on dedicated infrastructure, the allowed values are:
AL32UTF8, AR8ADOS710, AR8ADOS720, AR8APTEC715, AR8ARABICMACS, AR8ASMO8X, AR8ISO8859P6, AR8MSWIN1256, AR8MUSSAD768, AR8NAFITHA711, AR8NAFITHA721, AR8SAKHR706, AR8SAKHR707, AZ8ISO8859P9E, BG8MSWIN, BG8PC437S, BLT8CP921, BLT8ISO8859P13, BLT8MSWIN1257, BLT8PC775, BN8BSCII, CDN8PC863, CEL8ISO8859P14, CL8ISO8859P5, CL8ISOIR111, CL8KOI8R, CL8KOI8U, CL8MACCYRILLICS, CL8MSWIN1251, EE8ISO8859P2, EE8MACCES, EE8MACCROATIANS, EE8MSWIN1250, EE8PC852, EL8DEC, EL8ISO8859P7, EL8MACGREEKS, EL8MSWIN1253, EL8PC437S, EL8PC851, EL8PC869, ET8MSWIN923, HU8ABMOD, HU8CWI2, IN8ISCII, IS8PC861, IW8ISO8859P8, IW8MACHEBREWS, IW8MSWIN1255, IW8PC1507, JA16EUC, JA16EUCTILDE, JA16SJIS, JA16SJISTILDE, JA16VMS, KO16KSC5601, KO16KSCCS, KO16MSWIN949, LA8ISO6937, LA8PASSPORT, LT8MSWIN921, LT8PC772, LT8PC774, LV8PC1117, LV8PC8LR, LV8RST104090, N8PC865, NE8ISO8859P10, NEE8ISO8859P4, RU8BESTA, RU8PC855, RU8PC866, SE8ISO8859P3, TH8MACTHAIS, TH8TISASCII, TR8DEC, TR8MACTURKISHS, TR8MSWIN1254, TR8PC857, US7ASCII, US8PC437, UTF8, VN8MSWIN1258, VN8VN3, WE8DEC, WE8DG, WE8ISO8859P1, WE8ISO8859P15, WE8ISO8859P9, WE8MACROMAN8S, WE8MSWIN1252, WE8NCR4970, WE8NEXTSTEP, WE8PC850, WE8PC858, WE8PC860, WE8ROMAN8, ZHS16CGB231280, ZHS16GBK, ZHT16BIG5, ZHT16CCDC, ZHT16DBT, ZHT16HKSCS, ZHT16MSWIN950, ZHT32EUC, ZHT32SOPS, ZHT32TRIS
- Clone
Type string The Autonomous Database clone type.
- Compute
Count float64 (Updatable) The compute amount available to the database. Minimum and maximum values depend on the compute model and whether the database is on Shared or Dedicated infrastructure. For an Autonomous Database on Shared infrastructure, the 'ECPU' compute model requires values in multiples of two. Required when using the
computeModel
parameter. When usingcpuCoreCount
parameter, it is an error to specify computeCount to a non-null value.- Compute
Model string (Updatable) The compute model of the Autonomous Database. This is required if using the
computeCount
parameter. If usingcpuCoreCount
then it is an error to specifycomputeModel
to a non-null value.- Cpu
Core intCount (Updatable) The number of OCPU cores to be made available to the database. For Autonomous Databases on dedicated Exadata infrastructure, the maximum number of cores is determined by the infrastructure shape. See Characteristics of Infrastructure Shapes for shape details. Note: This parameter cannot be used with the
ocpuCount
parameter. This input is ignored for Always Free resources.- The data type must be an integer.
- The minimum number of cores for all types of autonomous database is 1
- The maximum number of cores is as follows:
- Autonomous Databases on shared Exadata infrastructure: The maximum number of cores is 128.
- Autonomous Databases on dedicated Exadata infrastructure: The maximum number of cores is determined by the infrastructure shape. See Characteristics of Infrastructure Shapes for shape details.
- Customer
Contacts []AutonomousDatabase Customer Contact Args (Updatable) Customer Contacts.
- Data
Safe stringStatus (Updatable) Status of the Data Safe registration for this Autonomous Database. Could be REGISTERED or NOT_REGISTERED.
- Data
Storage intSize In Gb (Updatable) The size, in gigabytes, of the data volume that will be created and attached to the database. This storage can later be scaled up if needed. The maximum storage value is determined by the infrastructure shape. See Characteristics of Infrastructure Shapes for shape details.
Notes
- This parameter is only supported for dedicated Exadata infrastructure.
- This parameter cannot be used with the
dataStorageSizeInTBs
parameter.
- Data
Storage intSize In Tbs (Updatable) The size, in terabytes, of the data volume that will be created and attached to the database. This storage can later be scaled up if needed. For Autonomous Databases on dedicated Exadata infrastructure, the maximum storage value is determined by the infrastructure shape. See Characteristics of Infrastructure Shapes for shape details. A full Exadata service is allocated when the Autonomous Database size is set to the upper limit (384 TB).
Note: This parameter cannot be used with the
dataStorageSizeInGBs
parameter. This input is ignored for Always Free resources.- Database
Edition string (Updatable) The Oracle Database Edition that applies to the Autonomous databases.
- Database
Management stringStatus Status of Database Management for this Autonomous Database.
- Db
Version string (Updatable) A valid Oracle Database version for Autonomous Database.
db_workload
AJD and APEX are only supported fordb_version
19c
and above.- Db
Workload string (Updatable) The Autonomous Database workload type. The following values are valid:
- OLTP - indicates an Autonomous Transaction Processing database
- DW - indicates an Autonomous Data Warehouse database
- AJD - indicates an Autonomous JSON Database
- APEX - indicates an Autonomous Database with the Oracle APEX Application Development workload type.
This cannot be updated in parallel with any of the following: licenseModel, dbEdition, cpuCoreCount, computeCount, computeModel, adminPassword, whitelistedIps, isMTLSConnectionRequired, privateEndpointLabel, nsgIds, dbVersion, isRefreshable, dbName, scheduledOperations, dbToolsDetails, isLocalDataGuardEnabled, or isFreeTier. *Note:
db_workload
can only be updated from AJD to OLTP or from a free OLTP to AJD.- map[string]interface{}
(Updatable) Defined tags for this resource. Each key is predefined and scoped to a namespace. For more information, see Resource Tags.
- Display
Name string (Updatable) The user-friendly name for the Autonomous Database. The name does not have to be unique.
- map[string]interface{}
(Updatable) Free-form tags for this resource. Each tag is a simple key-value pair with no predefined name, type, or namespace. For more information, see Resource Tags. Example:
{"Department": "Finance"}
- In
Memory intPercentage (Updatable) The percentage of the System Global Area(SGA) assigned to In-Memory tables in Autonomous Database.
- Is
Access boolControl Enabled (Updatable) Indicates if the database-level access control is enabled. If disabled, database access is defined by the network security rules. If enabled, database access is restricted to the IP addresses defined by the rules specified with the
whitelistedIps
property. While specifyingwhitelistedIps
rules is optional, if database-level access control is enabled and no rules are specified, the database will become inaccessible. The rules can be added later using theUpdateAutonomousDatabase
API operation or edit option in console. When creating a database clone, the desired access control setting should be specified. By default, database-level access control will be disabled for the clone.This property is applicable only to Autonomous Databases on the Exadata Cloud@Customer platform.
- Is
Auto boolScaling Enabled (Updatable) Indicates if auto scaling is enabled for the Autonomous Database OCPU core count. The default value is
FALSE
.- Is
Auto boolScaling For Storage Enabled (Updatable) Indicates if auto scaling is enabled for the Autonomous Database storage. The default value is
FALSE
.- Is
Data boolGuard Enabled (Updatable) Deprecated. Indicates whether the Autonomous Database has local (in-region) Data Guard enabled. Not applicable to cross-region Autonomous Data Guard associations, or to Autonomous Databases using dedicated Exadata infrastructure or Exadata Cloud@Customer infrastructure.
- Is
Dedicated bool True if the database is on dedicated Exadata infrastructure.
- Is
Free boolTier (Updatable) Indicates if this is an Always Free resource. The default value is false. Note that Always Free Autonomous Databases have 1 CPU and 20GB of memory. For Always Free databases, memory and CPU cannot be scaled. When
db_workload
isAJD
orAPEX
it cannot betrue
.- Is
Local boolData Guard Enabled (Updatable) Indicates whether the Autonomous Database has local (in-region) Data Guard enabled. Not applicable to cross-region Autonomous Data Guard associations, or to Autonomous Databases using dedicated Exadata infrastructure or Exadata Cloud@Customer infrastructure.
- Is
Mtls boolConnection Required (Updatable) Indicates whether the Autonomous Database requires mTLS connections.
- Is
Preview boolVersion With Service Terms Accepted If set to
TRUE
, indicates that an Autonomous Database preview version is being provisioned, and that the preview version's terms of service have been accepted. Note that preview version software is only available for databases on shared Exadata infrastructure.- Is
Refreshable boolClone (Updatable) True for creating a refreshable clone and False for detaching the clone from source Autonomous Database. Detaching is one time operation and clone becomes a regular Autonomous Database.
- Is
Shrink boolOnly (Updatable) An optional property when enabled triggers the Shrinking of Autonomous Database once. To trigger Shrinking of ADB once again, this flag needs to be disabled and re-enabled again. It should not be passed during create database operation. It is only applicable on shared databases i.e. where
is_dedicated
is false.** IMPORTANT ** Any change to a property that does not support update will force the destruction and recreation of the resource with the new property values
- Kms
Key stringId The OCID of the key container that is used as the master encryption key in database transparent data encryption (TDE) operations.
- License
Model string (Updatable) The Oracle license model that applies to the Oracle Autonomous Database. Bring your own license (BYOL) allows you to apply your current on-premises Oracle software licenses to equivalent, highly automated Oracle PaaS and IaaS services in the cloud. License Included allows you to subscribe to new Oracle Database software licenses and the Database service. Note that when provisioning an Autonomous Database on dedicated Exadata infrastructure, this attribute must be null because the attribute is already set at the Autonomous Exadata Infrastructure level. When using shared Exadata infrastructure, if a value is not specified, the system will supply the value of
BRING_YOUR_OWN_LICENSE
. It is a required field whendb_workload
is AJD and needs to be set toLICENSE_INCLUDED
as AJD does not support defaultlicense_model
valueBRING_YOUR_OWN_LICENSE
.- Local
Adg intAuto Failover Max Data Loss Limit Parameter that allows users to select an acceptable maximum data loss limit in seconds, up to which Automatic Failover will be triggered when necessary for a Local Autonomous Data Guard
- Max
Cpu intCore Count (Updatable) The number of Max OCPU cores to be made available to the autonomous database with auto scaling of cpu enabled.
- Ncharacter
Set string The national character set for the autonomous database. The default is AL16UTF16. Allowed values are: AL16UTF16 or UTF8.
- Nsg
Ids []string (Updatable) The list of OCIDs for the network security groups (NSGs) to which this resource belongs. Setting this to an empty list removes all resources from all NSGs. For more information about NSGs, see Security Rules. NsgIds restrictions:
- A network security group (NSG) is optional for Autonomous Databases with private access. The nsgIds list can be empty.
- Ocpu
Count float64 (Updatable) The number of OCPU cores to be made available to the database.
The following points apply:
- For Autonomous Databases on dedicated Exadata infrastructure, to provision less than 1 core, enter a fractional value in an increment of 0.1. For example, you can provision 0.3 or 0.4 cores, but not 0.35 cores. (Note that fractional OCPU values are not supported for Autonomous Databasese on shared Exadata infrastructure.)
- To provision 1 or more cores, you must enter an integer between 1 and the maximum number of cores available for the infrastructure shape. For example, you can provision 2 cores or 3 cores, but not 2.5 cores. This applies to Autonomous Databases on both shared and dedicated Exadata infrastructure.
For Autonomous Databases on dedicated Exadata infrastructure, the maximum number of cores is determined by the infrastructure shape. See Characteristics of Infrastructure Shapes for shape details.
Note: This parameter cannot be used with the
cpuCoreCount
parameter.- Open
Mode string Indicates the Autonomous Database mode. The database can be opened in
READ_ONLY
orREAD_WRITE
mode.- Operations
Insights stringStatus (Updatable) Status of Operations Insights for this Autonomous Database. Values supported are
ENABLED
andNOT_ENABLED
- Permission
Level string The Autonomous Database permission level. Restricted mode allows access only by admin users.
- Private
Endpoint stringIp The private endpoint Ip address for the resource.
- Private
Endpoint stringLabel (Updatable) The private endpoint label for the resource.
- Refreshable
Mode string (Updatable) The refresh mode of the clone. AUTOMATIC indicates that the clone is automatically being refreshed with data from the source Autonomous Database.
- Remote
Disaster stringRecovery Type Indicates the cross-region disaster recovery (DR) type of the standby Shared Autonomous Database. Autonomous Data Guard (ADG) DR type provides business critical DR with a faster recovery time objective (RTO) during failover or switchover. Backup-based DR type provides lower cost DR with a slower RTO during failover or switchover.
- Resource
Pool stringLeader Id - Resource
Pool AutonomousSummary Database Resource Pool Summary Args - Rotate
Key boolTrigger (Updatable) An optional property when flipped triggers rotation of KMS key. It is only applicable on dedicated databases i.e. where
is_dedicated
is true.- Scheduled
Operations []AutonomousDatabase Scheduled Operation Args (Updatable) The list of scheduled operations.
This cannot be updated in parallel with any of the following: licenseModel, dbEdition, cpuCoreCount, computeCount, computeModel, whitelistedIps, isMTLSConnectionRequired, openMode, permissionLevel, dbWorkload, privateEndpointLabel, nsgIds, dbVersion, isRefreshable, dbName, dbToolsDetails, isLocalDataGuardEnabled, or isFreeTier.
- Secret
Id string (Updatable) The Oracle Cloud Infrastructure vault secret [/Content/General/Concepts/identifiers.htm]OCID.
- Secret
Version intNumber (Updatable) The version of the vault secret. If no version is specified, the latest version will be used.
- Source string
The source of the database: Use
NONE
for creating a new Autonomous Database. UseDATABASE
for creating a new Autonomous Database by cloning an existing Autonomous Database. UseCROSS_REGION_DATAGUARD
to create a standby Data Guard database in another region.For Autonomous Databases on shared Exadata infrastructure, the following cloning options are available: Use
BACKUP_FROM_ID
for creating a new Autonomous Database from a specified backup. UseBACKUP_FROM_TIMESTAMP
for creating a point-in-time Autonomous Database clone using backups. For more information, see Cloning and Moving an Autonomous Database.- Source
Id string The OCID of the source Autonomous Database that will be used to create a new standby database for the Data Guard association.
- Standby
Whitelisted []stringIps (Updatable) The client IP access control list (ACL). This feature is available for autonomous databases on shared Exadata infrastructure and on Exadata Cloud@Customer. Only clients connecting from an IP address included in the ACL may access the Autonomous Database instance.
For shared Exadata infrastructure, this is an array of CIDR (Classless Inter-Domain Routing) notations for a subnet or VCN OCID. Use a semicolon (;) as a deliminator between the VCN-specific subnets or IPs. Example:
["1.1.1.1","1.1.1.0/24","ocid1.vcn.oc1.sea.<unique_id>","ocid1.vcn.oc1.sea.<unique_id1>;1.1.1.1","ocid1.vcn.oc1.sea.<unique_id2>;1.1.0.0/16"]
For Exadata Cloud@Customer, this is an array of IP addresses or CIDR (Classless Inter-Domain Routing) notations. Example:["1.1.1.1","1.1.1.0/24","1.1.2.25"]
For an update operation, if you want to delete all the IPs in the ACL, use an array with a single empty string entry.
This cannot be updated in parallel with any of the following: licenseModel, dbEdition, cpuCoreCount, computeCount, computeModel, adminPassword, isMTLSConnectionRequired, openMode, permissionLevel, dbWorkload, dbVersion, isRefreshable, dbName, scheduledOperations, dbToolsDetails, isLocalDataGuardEnabled, or isFreeTier.
- State string
The current state of the Autonomous Database.
- Subnet
Id string (Updatable) The OCID of the subnet the resource is associated with.
Subnet Restrictions:
- For bare metal DB systems and for single node virtual machine DB systems, do not use a subnet that overlaps with 192.168.16.16/28.
- For Exadata and virtual machine 2-node RAC systems, do not use a subnet that overlaps with 192.168.128.0/20.
- For Autonomous Database, setting this will disable public secure access to the database.
These subnets are used by the Oracle Clusterware private interconnect on the database instance. Specifying an overlapping subnet will cause the private interconnect to malfunction. This restriction applies to both the client subnet and the backup subnet.
- Switchover
To string It is applicable only when
is_data_guard_enabled
is true. Could be set toPRIMARY
orSTANDBY
. Default value isPRIMARY
.- Switchover
To stringRemote Peer Id (Updatable) It is applicable only when
dataguard_region_type
androle
are set, andis_dedicated
is false. It takes the OCID of the remote peer to switchover to.- Timestamp string
The timestamp specified for the point-in-time clone of the source Autonomous Database. The timestamp must be in the past.
- Use
Latest boolAvailable Backup Time Stamp Clone from latest available backup timestamp.
- Vault
Id string - Whitelisted
Ips []string (Updatable) The client IP access control list (ACL). This feature is available for autonomous databases on shared Exadata infrastructure and on Exadata Cloud@Customer. Only clients connecting from an IP address included in the ACL may access the Autonomous Database instance.
For shared Exadata infrastructure, this is an array of CIDR (Classless Inter-Domain Routing) notations for a subnet or VCN OCID. Use a semicolon (;) as a deliminator between the VCN-specific subnets or IPs. Example:
["1.1.1.1","1.1.1.0/24","ocid1.vcn.oc1.sea.<unique_id>","ocid1.vcn.oc1.sea.<unique_id1>;1.1.1.1","ocid1.vcn.oc1.sea.<unique_id2>;1.1.0.0/16"]
For Exadata Cloud@Customer, this is an array of IP addresses or CIDR (Classless Inter-Domain Routing) notations. Example:["1.1.1.1","1.1.1.0/24","1.1.2.25"]
For an update operation, if you want to delete all the IPs in the ACL, use an array with a single empty string entry.
This cannot be updated in parallel with any of the following: licenseModel, dbEdition, cpuCoreCount, computeCount, computeModel, adminPassword, isMTLSConnectionRequired, openMode, permissionLevel, dbWorkload, dbVersion, isRefreshable, dbName, scheduledOperations, dbToolsDetails, isLocalDataGuardEnabled, or isFreeTier. To remove all whitelisted IPs, set the field to a list with an empty string
[""]
.This cannot be updated in parallel with any of the following: licenseModel, dbEdition, cpuCoreCount, computeCount, computeModel, adminPassword, isMTLSConnectionRequired, openMode, permissionLevel, dbWorkload, dbVersion, isRefreshable, dbName, scheduledOperations, dbToolsDetails, isLocalDataGuardEnabled, or isFreeTier. To remove all whitelisted IPs, set the field to a list with an empty string
[""]
.
- compartment
Id String (Updatable) The OCID of the compartment of the Autonomous Database.
- db
Name String (Updatable) Specify the database name; it must consist of letters and numbers only. The maximum length is 30 characters. The same database name cannot be used for multiple Autonomous Databases in the same tenancy in the same region.
- admin
Password String (Updatable) The password must be between 12 and 30 characters long, and must contain at least 1 uppercase, 1 lowercase, and 1 numeric character. It cannot contain the double quote symbol (") or the username "admin", regardless of casing. The password is mandatory if source value is "BACKUP_FROM_ID", "BACKUP_FROM_TIMESTAMP", "DATABASE" or "NONE".
- are
Primary BooleanWhitelisted Ips Used (Updatable) This field will be null if the Autonomous Database is not Data Guard enabled or Access Control is disabled. It's value would be
TRUE
if Autonomous Database is Data Guard enabled and Access Control is enabled and if the Autonomous Database uses primary IP access control list (ACL) for standby. It's value would beFALSE
if Autonomous Database is Data Guard enabled and Access Control is enabled and if the Autonomous Database uses different IP access control list (ACL) for standby compared to primary.- autonomous
Container StringDatabase Id The Autonomous Container Database OCID.
- autonomous
Database StringBackup Id The OCID of the source Autonomous Database Backup that you will clone to create a new Autonomous Database.
- autonomous
Database StringId The OCID of the source Autonomous Database that you will clone to create a new Autonomous Database.
- autonomous
Maintenance StringSchedule Type The maintenance schedule type of the Autonomous Database on shared Exadata infrastructure. The EARLY maintenance schedule of this Autonomous Database follows a schedule that applies patches prior to the REGULAR schedule.The REGULAR maintenance schedule of this Autonomous Database follows the normal cycle.
- backup
Retention IntegerPeriod In Days (Updatable) Retention period, in days, for backups.
- character
Set String The character set for the autonomous database. The default is AL32UTF8. Allowed values for an Autonomous Database on shared infrastructure as as returned by List Autonomous Database Character Sets
For an Autonomous Database on dedicated infrastructure, the allowed values are:
AL32UTF8, AR8ADOS710, AR8ADOS720, AR8APTEC715, AR8ARABICMACS, AR8ASMO8X, AR8ISO8859P6, AR8MSWIN1256, AR8MUSSAD768, AR8NAFITHA711, AR8NAFITHA721, AR8SAKHR706, AR8SAKHR707, AZ8ISO8859P9E, BG8MSWIN, BG8PC437S, BLT8CP921, BLT8ISO8859P13, BLT8MSWIN1257, BLT8PC775, BN8BSCII, CDN8PC863, CEL8ISO8859P14, CL8ISO8859P5, CL8ISOIR111, CL8KOI8R, CL8KOI8U, CL8MACCYRILLICS, CL8MSWIN1251, EE8ISO8859P2, EE8MACCES, EE8MACCROATIANS, EE8MSWIN1250, EE8PC852, EL8DEC, EL8ISO8859P7, EL8MACGREEKS, EL8MSWIN1253, EL8PC437S, EL8PC851, EL8PC869, ET8MSWIN923, HU8ABMOD, HU8CWI2, IN8ISCII, IS8PC861, IW8ISO8859P8, IW8MACHEBREWS, IW8MSWIN1255, IW8PC1507, JA16EUC, JA16EUCTILDE, JA16SJIS, JA16SJISTILDE, JA16VMS, KO16KSC5601, KO16KSCCS, KO16MSWIN949, LA8ISO6937, LA8PASSPORT, LT8MSWIN921, LT8PC772, LT8PC774, LV8PC1117, LV8PC8LR, LV8RST104090, N8PC865, NE8ISO8859P10, NEE8ISO8859P4, RU8BESTA, RU8PC855, RU8PC866, SE8ISO8859P3, TH8MACTHAIS, TH8TISASCII, TR8DEC, TR8MACTURKISHS, TR8MSWIN1254, TR8PC857, US7ASCII, US8PC437, UTF8, VN8MSWIN1258, VN8VN3, WE8DEC, WE8DG, WE8ISO8859P1, WE8ISO8859P15, WE8ISO8859P9, WE8MACROMAN8S, WE8MSWIN1252, WE8NCR4970, WE8NEXTSTEP, WE8PC850, WE8PC858, WE8PC860, WE8ROMAN8, ZHS16CGB231280, ZHS16GBK, ZHT16BIG5, ZHT16CCDC, ZHT16DBT, ZHT16HKSCS, ZHT16MSWIN950, ZHT32EUC, ZHT32SOPS, ZHT32TRIS
- clone
Type String The Autonomous Database clone type.
- compute
Count Double (Updatable) The compute amount available to the database. Minimum and maximum values depend on the compute model and whether the database is on Shared or Dedicated infrastructure. For an Autonomous Database on Shared infrastructure, the 'ECPU' compute model requires values in multiples of two. Required when using the
computeModel
parameter. When usingcpuCoreCount
parameter, it is an error to specify computeCount to a non-null value.- compute
Model String (Updatable) The compute model of the Autonomous Database. This is required if using the
computeCount
parameter. If usingcpuCoreCount
then it is an error to specifycomputeModel
to a non-null value.- cpu
Core IntegerCount (Updatable) The number of OCPU cores to be made available to the database. For Autonomous Databases on dedicated Exadata infrastructure, the maximum number of cores is determined by the infrastructure shape. See Characteristics of Infrastructure Shapes for shape details. Note: This parameter cannot be used with the
ocpuCount
parameter. This input is ignored for Always Free resources.- The data type must be an integer.
- The minimum number of cores for all types of autonomous database is 1
- The maximum number of cores is as follows:
- Autonomous Databases on shared Exadata infrastructure: The maximum number of cores is 128.
- Autonomous Databases on dedicated Exadata infrastructure: The maximum number of cores is determined by the infrastructure shape. See Characteristics of Infrastructure Shapes for shape details.
- customer
Contacts List<AutonomousCustomer Contact> (Updatable) Customer Contacts.
- data
Safe StringStatus (Updatable) Status of the Data Safe registration for this Autonomous Database. Could be REGISTERED or NOT_REGISTERED.
- data
Storage IntegerSize In Gb (Updatable) The size, in gigabytes, of the data volume that will be created and attached to the database. This storage can later be scaled up if needed. The maximum storage value is determined by the infrastructure shape. See Characteristics of Infrastructure Shapes for shape details.
Notes
- This parameter is only supported for dedicated Exadata infrastructure.
- This parameter cannot be used with the
dataStorageSizeInTBs
parameter.
- data
Storage IntegerSize In Tbs (Updatable) The size, in terabytes, of the data volume that will be created and attached to the database. This storage can later be scaled up if needed. For Autonomous Databases on dedicated Exadata infrastructure, the maximum storage value is determined by the infrastructure shape. See Characteristics of Infrastructure Shapes for shape details. A full Exadata service is allocated when the Autonomous Database size is set to the upper limit (384 TB).
Note: This parameter cannot be used with the
dataStorageSizeInGBs
parameter. This input is ignored for Always Free resources.- database
Edition String (Updatable) The Oracle Database Edition that applies to the Autonomous databases.
- database
Management StringStatus Status of Database Management for this Autonomous Database.
- db
Version String (Updatable) A valid Oracle Database version for Autonomous Database.
db_workload
AJD and APEX are only supported fordb_version
19c
and above.- db
Workload String (Updatable) The Autonomous Database workload type. The following values are valid:
- OLTP - indicates an Autonomous Transaction Processing database
- DW - indicates an Autonomous Data Warehouse database
- AJD - indicates an Autonomous JSON Database
- APEX - indicates an Autonomous Database with the Oracle APEX Application Development workload type.
This cannot be updated in parallel with any of the following: licenseModel, dbEdition, cpuCoreCount, computeCount, computeModel, adminPassword, whitelistedIps, isMTLSConnectionRequired, privateEndpointLabel, nsgIds, dbVersion, isRefreshable, dbName, scheduledOperations, dbToolsDetails, isLocalDataGuardEnabled, or isFreeTier. *Note:
db_workload
can only be updated from AJD to OLTP or from a free OLTP to AJD.- Map<String,Object>
(Updatable) Defined tags for this resource. Each key is predefined and scoped to a namespace. For more information, see Resource Tags.
- display
Name String (Updatable) The user-friendly name for the Autonomous Database. The name does not have to be unique.
- Map<String,Object>
(Updatable) Free-form tags for this resource. Each tag is a simple key-value pair with no predefined name, type, or namespace. For more information, see Resource Tags. Example:
{"Department": "Finance"}
- in
Memory IntegerPercentage (Updatable) The percentage of the System Global Area(SGA) assigned to In-Memory tables in Autonomous Database.
- is
Access BooleanControl Enabled (Updatable) Indicates if the database-level access control is enabled. If disabled, database access is defined by the network security rules. If enabled, database access is restricted to the IP addresses defined by the rules specified with the
whitelistedIps
property. While specifyingwhitelistedIps
rules is optional, if database-level access control is enabled and no rules are specified, the database will become inaccessible. The rules can be added later using theUpdateAutonomousDatabase
API operation or edit option in console. When creating a database clone, the desired access control setting should be specified. By default, database-level access control will be disabled for the clone.This property is applicable only to Autonomous Databases on the Exadata Cloud@Customer platform.
- is
Auto BooleanScaling Enabled (Updatable) Indicates if auto scaling is enabled for the Autonomous Database OCPU core count. The default value is
FALSE
.- is
Auto BooleanScaling For Storage Enabled (Updatable) Indicates if auto scaling is enabled for the Autonomous Database storage. The default value is
FALSE
.- is
Data BooleanGuard Enabled (Updatable) Deprecated. Indicates whether the Autonomous Database has local (in-region) Data Guard enabled. Not applicable to cross-region Autonomous Data Guard associations, or to Autonomous Databases using dedicated Exadata infrastructure or Exadata Cloud@Customer infrastructure.
- is
Dedicated Boolean True if the database is on dedicated Exadata infrastructure.
- is
Free BooleanTier (Updatable) Indicates if this is an Always Free resource. The default value is false. Note that Always Free Autonomous Databases have 1 CPU and 20GB of memory. For Always Free databases, memory and CPU cannot be scaled. When
db_workload
isAJD
orAPEX
it cannot betrue
.- is
Local BooleanData Guard Enabled (Updatable) Indicates whether the Autonomous Database has local (in-region) Data Guard enabled. Not applicable to cross-region Autonomous Data Guard associations, or to Autonomous Databases using dedicated Exadata infrastructure or Exadata Cloud@Customer infrastructure.
- is
Mtls BooleanConnection Required (Updatable) Indicates whether the Autonomous Database requires mTLS connections.
- is
Preview BooleanVersion With Service Terms Accepted If set to
TRUE
, indicates that an Autonomous Database preview version is being provisioned, and that the preview version's terms of service have been accepted. Note that preview version software is only available for databases on shared Exadata infrastructure.- is
Refreshable BooleanClone (Updatable) True for creating a refreshable clone and False for detaching the clone from source Autonomous Database. Detaching is one time operation and clone becomes a regular Autonomous Database.
- is
Shrink BooleanOnly (Updatable) An optional property when enabled triggers the Shrinking of Autonomous Database once. To trigger Shrinking of ADB once again, this flag needs to be disabled and re-enabled again. It should not be passed during create database operation. It is only applicable on shared databases i.e. where
is_dedicated
is false.** IMPORTANT ** Any change to a property that does not support update will force the destruction and recreation of the resource with the new property values
- kms
Key StringId The OCID of the key container that is used as the master encryption key in database transparent data encryption (TDE) operations.
- license
Model String (Updatable) The Oracle license model that applies to the Oracle Autonomous Database. Bring your own license (BYOL) allows you to apply your current on-premises Oracle software licenses to equivalent, highly automated Oracle PaaS and IaaS services in the cloud. License Included allows you to subscribe to new Oracle Database software licenses and the Database service. Note that when provisioning an Autonomous Database on dedicated Exadata infrastructure, this attribute must be null because the attribute is already set at the Autonomous Exadata Infrastructure level. When using shared Exadata infrastructure, if a value is not specified, the system will supply the value of
BRING_YOUR_OWN_LICENSE
. It is a required field whendb_workload
is AJD and needs to be set toLICENSE_INCLUDED
as AJD does not support defaultlicense_model
valueBRING_YOUR_OWN_LICENSE
.- local
Adg IntegerAuto Failover Max Data Loss Limit Parameter that allows users to select an acceptable maximum data loss limit in seconds, up to which Automatic Failover will be triggered when necessary for a Local Autonomous Data Guard
- max
Cpu IntegerCore Count (Updatable) The number of Max OCPU cores to be made available to the autonomous database with auto scaling of cpu enabled.
- ncharacter
Set String The national character set for the autonomous database. The default is AL16UTF16. Allowed values are: AL16UTF16 or UTF8.
- nsg
Ids List<String> (Updatable) The list of OCIDs for the network security groups (NSGs) to which this resource belongs. Setting this to an empty list removes all resources from all NSGs. For more information about NSGs, see Security Rules. NsgIds restrictions:
- A network security group (NSG) is optional for Autonomous Databases with private access. The nsgIds list can be empty.
- ocpu
Count Double (Updatable) The number of OCPU cores to be made available to the database.
The following points apply:
- For Autonomous Databases on dedicated Exadata infrastructure, to provision less than 1 core, enter a fractional value in an increment of 0.1. For example, you can provision 0.3 or 0.4 cores, but not 0.35 cores. (Note that fractional OCPU values are not supported for Autonomous Databasese on shared Exadata infrastructure.)
- To provision 1 or more cores, you must enter an integer between 1 and the maximum number of cores available for the infrastructure shape. For example, you can provision 2 cores or 3 cores, but not 2.5 cores. This applies to Autonomous Databases on both shared and dedicated Exadata infrastructure.
For Autonomous Databases on dedicated Exadata infrastructure, the maximum number of cores is determined by the infrastructure shape. See Characteristics of Infrastructure Shapes for shape details.
Note: This parameter cannot be used with the
cpuCoreCount
parameter.- open
Mode String Indicates the Autonomous Database mode. The database can be opened in
READ_ONLY
orREAD_WRITE
mode.- operations
Insights StringStatus (Updatable) Status of Operations Insights for this Autonomous Database. Values supported are
ENABLED
andNOT_ENABLED
- permission
Level String The Autonomous Database permission level. Restricted mode allows access only by admin users.
- private
Endpoint StringIp The private endpoint Ip address for the resource.
- private
Endpoint StringLabel (Updatable) The private endpoint label for the resource.
- refreshable
Mode String (Updatable) The refresh mode of the clone. AUTOMATIC indicates that the clone is automatically being refreshed with data from the source Autonomous Database.
- remote
Disaster StringRecovery Type Indicates the cross-region disaster recovery (DR) type of the standby Shared Autonomous Database. Autonomous Data Guard (ADG) DR type provides business critical DR with a faster recovery time objective (RTO) during failover or switchover. Backup-based DR type provides lower cost DR with a slower RTO during failover or switchover.
- resource
Pool StringLeader Id - resource
Pool AutonomousSummary Resource Pool Summary - rotate
Key BooleanTrigger (Updatable) An optional property when flipped triggers rotation of KMS key. It is only applicable on dedicated databases i.e. where
is_dedicated
is true.- scheduled
Operations List<AutonomousScheduled Operation> (Updatable) The list of scheduled operations.
This cannot be updated in parallel with any of the following: licenseModel, dbEdition, cpuCoreCount, computeCount, computeModel, whitelistedIps, isMTLSConnectionRequired, openMode, permissionLevel, dbWorkload, privateEndpointLabel, nsgIds, dbVersion, isRefreshable, dbName, dbToolsDetails, isLocalDataGuardEnabled, or isFreeTier.
- secret
Id String (Updatable) The Oracle Cloud Infrastructure vault secret [/Content/General/Concepts/identifiers.htm]OCID.
- secret
Version IntegerNumber (Updatable) The version of the vault secret. If no version is specified, the latest version will be used.
- source String
The source of the database: Use
NONE
for creating a new Autonomous Database. UseDATABASE
for creating a new Autonomous Database by cloning an existing Autonomous Database. UseCROSS_REGION_DATAGUARD
to create a standby Data Guard database in another region.For Autonomous Databases on shared Exadata infrastructure, the following cloning options are available: Use
BACKUP_FROM_ID
for creating a new Autonomous Database from a specified backup. UseBACKUP_FROM_TIMESTAMP
for creating a point-in-time Autonomous Database clone using backups. For more information, see Cloning and Moving an Autonomous Database.- source
Id String The OCID of the source Autonomous Database that will be used to create a new standby database for the Data Guard association.
- standby
Whitelisted List<String>Ips (Updatable) The client IP access control list (ACL). This feature is available for autonomous databases on shared Exadata infrastructure and on Exadata Cloud@Customer. Only clients connecting from an IP address included in the ACL may access the Autonomous Database instance.
For shared Exadata infrastructure, this is an array of CIDR (Classless Inter-Domain Routing) notations for a subnet or VCN OCID. Use a semicolon (;) as a deliminator between the VCN-specific subnets or IPs. Example:
["1.1.1.1","1.1.1.0/24","ocid1.vcn.oc1.sea.<unique_id>","ocid1.vcn.oc1.sea.<unique_id1>;1.1.1.1","ocid1.vcn.oc1.sea.<unique_id2>;1.1.0.0/16"]
For Exadata Cloud@Customer, this is an array of IP addresses or CIDR (Classless Inter-Domain Routing) notations. Example:["1.1.1.1","1.1.1.0/24","1.1.2.25"]
For an update operation, if you want to delete all the IPs in the ACL, use an array with a single empty string entry.
This cannot be updated in parallel with any of the following: licenseModel, dbEdition, cpuCoreCount, computeCount, computeModel, adminPassword, isMTLSConnectionRequired, openMode, permissionLevel, dbWorkload, dbVersion, isRefreshable, dbName, scheduledOperations, dbToolsDetails, isLocalDataGuardEnabled, or isFreeTier.
- state String
The current state of the Autonomous Database.
- subnet
Id String (Updatable) The OCID of the subnet the resource is associated with.
Subnet Restrictions:
- For bare metal DB systems and for single node virtual machine DB systems, do not use a subnet that overlaps with 192.168.16.16/28.
- For Exadata and virtual machine 2-node RAC systems, do not use a subnet that overlaps with 192.168.128.0/20.
- For Autonomous Database, setting this will disable public secure access to the database.
These subnets are used by the Oracle Clusterware private interconnect on the database instance. Specifying an overlapping subnet will cause the private interconnect to malfunction. This restriction applies to both the client subnet and the backup subnet.
- switchover
To String It is applicable only when
is_data_guard_enabled
is true. Could be set toPRIMARY
orSTANDBY
. Default value isPRIMARY
.- switchover
To StringRemote Peer Id (Updatable) It is applicable only when
dataguard_region_type
androle
are set, andis_dedicated
is false. It takes the OCID of the remote peer to switchover to.- timestamp String
The timestamp specified for the point-in-time clone of the source Autonomous Database. The timestamp must be in the past.
- use
Latest BooleanAvailable Backup Time Stamp Clone from latest available backup timestamp.
- vault
Id String - whitelisted
Ips List<String> (Updatable) The client IP access control list (ACL). This feature is available for autonomous databases on shared Exadata infrastructure and on Exadata Cloud@Customer. Only clients connecting from an IP address included in the ACL may access the Autonomous Database instance.
For shared Exadata infrastructure, this is an array of CIDR (Classless Inter-Domain Routing) notations for a subnet or VCN OCID. Use a semicolon (;) as a deliminator between the VCN-specific subnets or IPs. Example:
["1.1.1.1","1.1.1.0/24","ocid1.vcn.oc1.sea.<unique_id>","ocid1.vcn.oc1.sea.<unique_id1>;1.1.1.1","ocid1.vcn.oc1.sea.<unique_id2>;1.1.0.0/16"]
For Exadata Cloud@Customer, this is an array of IP addresses or CIDR (Classless Inter-Domain Routing) notations. Example:["1.1.1.1","1.1.1.0/24","1.1.2.25"]
For an update operation, if you want to delete all the IPs in the ACL, use an array with a single empty string entry.
This cannot be updated in parallel with any of the following: licenseModel, dbEdition, cpuCoreCount, computeCount, computeModel, adminPassword, isMTLSConnectionRequired, openMode, permissionLevel, dbWorkload, dbVersion, isRefreshable, dbName, scheduledOperations, dbToolsDetails, isLocalDataGuardEnabled, or isFreeTier. To remove all whitelisted IPs, set the field to a list with an empty string
[""]
.This cannot be updated in parallel with any of the following: licenseModel, dbEdition, cpuCoreCount, computeCount, computeModel, adminPassword, isMTLSConnectionRequired, openMode, permissionLevel, dbWorkload, dbVersion, isRefreshable, dbName, scheduledOperations, dbToolsDetails, isLocalDataGuardEnabled, or isFreeTier. To remove all whitelisted IPs, set the field to a list with an empty string
[""]
.
- compartment
Id string (Updatable) The OCID of the compartment of the Autonomous Database.
- db
Name string (Updatable) Specify the database name; it must consist of letters and numbers only. The maximum length is 30 characters. The same database name cannot be used for multiple Autonomous Databases in the same tenancy in the same region.
- admin
Password string (Updatable) The password must be between 12 and 30 characters long, and must contain at least 1 uppercase, 1 lowercase, and 1 numeric character. It cannot contain the double quote symbol (") or the username "admin", regardless of casing. The password is mandatory if source value is "BACKUP_FROM_ID", "BACKUP_FROM_TIMESTAMP", "DATABASE" or "NONE".
- are
Primary booleanWhitelisted Ips Used (Updatable) This field will be null if the Autonomous Database is not Data Guard enabled or Access Control is disabled. It's value would be
TRUE
if Autonomous Database is Data Guard enabled and Access Control is enabled and if the Autonomous Database uses primary IP access control list (ACL) for standby. It's value would beFALSE
if Autonomous Database is Data Guard enabled and Access Control is enabled and if the Autonomous Database uses different IP access control list (ACL) for standby compared to primary.- autonomous
Container stringDatabase Id The Autonomous Container Database OCID.
- autonomous
Database stringBackup Id The OCID of the source Autonomous Database Backup that you will clone to create a new Autonomous Database.
- autonomous
Database stringId The OCID of the source Autonomous Database that you will clone to create a new Autonomous Database.
- autonomous
Maintenance stringSchedule Type The maintenance schedule type of the Autonomous Database on shared Exadata infrastructure. The EARLY maintenance schedule of this Autonomous Database follows a schedule that applies patches prior to the REGULAR schedule.The REGULAR maintenance schedule of this Autonomous Database follows the normal cycle.
- backup
Retention numberPeriod In Days (Updatable) Retention period, in days, for backups.
- character
Set string The character set for the autonomous database. The default is AL32UTF8. Allowed values for an Autonomous Database on shared infrastructure as as returned by List Autonomous Database Character Sets
For an Autonomous Database on dedicated infrastructure, the allowed values are:
AL32UTF8, AR8ADOS710, AR8ADOS720, AR8APTEC715, AR8ARABICMACS, AR8ASMO8X, AR8ISO8859P6, AR8MSWIN1256, AR8MUSSAD768, AR8NAFITHA711, AR8NAFITHA721, AR8SAKHR706, AR8SAKHR707, AZ8ISO8859P9E, BG8MSWIN, BG8PC437S, BLT8CP921, BLT8ISO8859P13, BLT8MSWIN1257, BLT8PC775, BN8BSCII, CDN8PC863, CEL8ISO8859P14, CL8ISO8859P5, CL8ISOIR111, CL8KOI8R, CL8KOI8U, CL8MACCYRILLICS, CL8MSWIN1251, EE8ISO8859P2, EE8MACCES, EE8MACCROATIANS, EE8MSWIN1250, EE8PC852, EL8DEC, EL8ISO8859P7, EL8MACGREEKS, EL8MSWIN1253, EL8PC437S, EL8PC851, EL8PC869, ET8MSWIN923, HU8ABMOD, HU8CWI2, IN8ISCII, IS8PC861, IW8ISO8859P8, IW8MACHEBREWS, IW8MSWIN1255, IW8PC1507, JA16EUC, JA16EUCTILDE, JA16SJIS, JA16SJISTILDE, JA16VMS, KO16KSC5601, KO16KSCCS, KO16MSWIN949, LA8ISO6937, LA8PASSPORT, LT8MSWIN921, LT8PC772, LT8PC774, LV8PC1117, LV8PC8LR, LV8RST104090, N8PC865, NE8ISO8859P10, NEE8ISO8859P4, RU8BESTA, RU8PC855, RU8PC866, SE8ISO8859P3, TH8MACTHAIS, TH8TISASCII, TR8DEC, TR8MACTURKISHS, TR8MSWIN1254, TR8PC857, US7ASCII, US8PC437, UTF8, VN8MSWIN1258, VN8VN3, WE8DEC, WE8DG, WE8ISO8859P1, WE8ISO8859P15, WE8ISO8859P9, WE8MACROMAN8S, WE8MSWIN1252, WE8NCR4970, WE8NEXTSTEP, WE8PC850, WE8PC858, WE8PC860, WE8ROMAN8, ZHS16CGB231280, ZHS16GBK, ZHT16BIG5, ZHT16CCDC, ZHT16DBT, ZHT16HKSCS, ZHT16MSWIN950, ZHT32EUC, ZHT32SOPS, ZHT32TRIS
- clone
Type string The Autonomous Database clone type.
- compute
Count number (Updatable) The compute amount available to the database. Minimum and maximum values depend on the compute model and whether the database is on Shared or Dedicated infrastructure. For an Autonomous Database on Shared infrastructure, the 'ECPU' compute model requires values in multiples of two. Required when using the
computeModel
parameter. When usingcpuCoreCount
parameter, it is an error to specify computeCount to a non-null value.- compute
Model string (Updatable) The compute model of the Autonomous Database. This is required if using the
computeCount
parameter. If usingcpuCoreCount
then it is an error to specifycomputeModel
to a non-null value.- cpu
Core numberCount (Updatable) The number of OCPU cores to be made available to the database. For Autonomous Databases on dedicated Exadata infrastructure, the maximum number of cores is determined by the infrastructure shape. See Characteristics of Infrastructure Shapes for shape details. Note: This parameter cannot be used with the
ocpuCount
parameter. This input is ignored for Always Free resources.- The data type must be an integer.
- The minimum number of cores for all types of autonomous database is 1
- The maximum number of cores is as follows:
- Autonomous Databases on shared Exadata infrastructure: The maximum number of cores is 128.
- Autonomous Databases on dedicated Exadata infrastructure: The maximum number of cores is determined by the infrastructure shape. See Characteristics of Infrastructure Shapes for shape details.
- customer
Contacts AutonomousDatabase Customer Contact[] (Updatable) Customer Contacts.
- data
Safe stringStatus (Updatable) Status of the Data Safe registration for this Autonomous Database. Could be REGISTERED or NOT_REGISTERED.
- data
Storage numberSize In Gb (Updatable) The size, in gigabytes, of the data volume that will be created and attached to the database. This storage can later be scaled up if needed. The maximum storage value is determined by the infrastructure shape. See Characteristics of Infrastructure Shapes for shape details.
Notes
- This parameter is only supported for dedicated Exadata infrastructure.
- This parameter cannot be used with the
dataStorageSizeInTBs
parameter.
- data
Storage numberSize In Tbs (Updatable) The size, in terabytes, of the data volume that will be created and attached to the database. This storage can later be scaled up if needed. For Autonomous Databases on dedicated Exadata infrastructure, the maximum storage value is determined by the infrastructure shape. See Characteristics of Infrastructure Shapes for shape details. A full Exadata service is allocated when the Autonomous Database size is set to the upper limit (384 TB).
Note: This parameter cannot be used with the
dataStorageSizeInGBs
parameter. This input is ignored for Always Free resources.- database
Edition string (Updatable) The Oracle Database Edition that applies to the Autonomous databases.
- database
Management stringStatus Status of Database Management for this Autonomous Database.
- db
Version string (Updatable) A valid Oracle Database version for Autonomous Database.
db_workload
AJD and APEX are only supported fordb_version
19c
and above.- db
Workload string (Updatable) The Autonomous Database workload type. The following values are valid:
- OLTP - indicates an Autonomous Transaction Processing database
- DW - indicates an Autonomous Data Warehouse database
- AJD - indicates an Autonomous JSON Database
- APEX - indicates an Autonomous Database with the Oracle APEX Application Development workload type.
This cannot be updated in parallel with any of the following: licenseModel, dbEdition, cpuCoreCount, computeCount, computeModel, adminPassword, whitelistedIps, isMTLSConnectionRequired, privateEndpointLabel, nsgIds, dbVersion, isRefreshable, dbName, scheduledOperations, dbToolsDetails, isLocalDataGuardEnabled, or isFreeTier. *Note:
db_workload
can only be updated from AJD to OLTP or from a free OLTP to AJD.- {[key: string]: any}
(Updatable) Defined tags for this resource. Each key is predefined and scoped to a namespace. For more information, see Resource Tags.
- display
Name string (Updatable) The user-friendly name for the Autonomous Database. The name does not have to be unique.
- {[key: string]: any}
(Updatable) Free-form tags for this resource. Each tag is a simple key-value pair with no predefined name, type, or namespace. For more information, see Resource Tags. Example:
{"Department": "Finance"}
- in
Memory numberPercentage (Updatable) The percentage of the System Global Area(SGA) assigned to In-Memory tables in Autonomous Database.
- is
Access booleanControl Enabled (Updatable) Indicates if the database-level access control is enabled. If disabled, database access is defined by the network security rules. If enabled, database access is restricted to the IP addresses defined by the rules specified with the
whitelistedIps
property. While specifyingwhitelistedIps
rules is optional, if database-level access control is enabled and no rules are specified, the database will become inaccessible. The rules can be added later using theUpdateAutonomousDatabase
API operation or edit option in console. When creating a database clone, the desired access control setting should be specified. By default, database-level access control will be disabled for the clone.This property is applicable only to Autonomous Databases on the Exadata Cloud@Customer platform.
- is
Auto booleanScaling Enabled (Updatable) Indicates if auto scaling is enabled for the Autonomous Database OCPU core count. The default value is
FALSE
.- is
Auto booleanScaling For Storage Enabled (Updatable) Indicates if auto scaling is enabled for the Autonomous Database storage. The default value is
FALSE
.- is
Data booleanGuard Enabled (Updatable) Deprecated. Indicates whether the Autonomous Database has local (in-region) Data Guard enabled. Not applicable to cross-region Autonomous Data Guard associations, or to Autonomous Databases using dedicated Exadata infrastructure or Exadata Cloud@Customer infrastructure.
- is
Dedicated boolean True if the database is on dedicated Exadata infrastructure.
- is
Free booleanTier (Updatable) Indicates if this is an Always Free resource. The default value is false. Note that Always Free Autonomous Databases have 1 CPU and 20GB of memory. For Always Free databases, memory and CPU cannot be scaled. When
db_workload
isAJD
orAPEX
it cannot betrue
.- is
Local booleanData Guard Enabled (Updatable) Indicates whether the Autonomous Database has local (in-region) Data Guard enabled. Not applicable to cross-region Autonomous Data Guard associations, or to Autonomous Databases using dedicated Exadata infrastructure or Exadata Cloud@Customer infrastructure.
- is
Mtls booleanConnection Required (Updatable) Indicates whether the Autonomous Database requires mTLS connections.
- is
Preview booleanVersion With Service Terms Accepted If set to
TRUE
, indicates that an Autonomous Database preview version is being provisioned, and that the preview version's terms of service have been accepted. Note that preview version software is only available for databases on shared Exadata infrastructure.- is
Refreshable booleanClone (Updatable) True for creating a refreshable clone and False for detaching the clone from source Autonomous Database. Detaching is one time operation and clone becomes a regular Autonomous Database.
- is
Shrink booleanOnly (Updatable) An optional property when enabled triggers the Shrinking of Autonomous Database once. To trigger Shrinking of ADB once again, this flag needs to be disabled and re-enabled again. It should not be passed during create database operation. It is only applicable on shared databases i.e. where
is_dedicated
is false.** IMPORTANT ** Any change to a property that does not support update will force the destruction and recreation of the resource with the new property values
- kms
Key stringId The OCID of the key container that is used as the master encryption key in database transparent data encryption (TDE) operations.
- license
Model string (Updatable) The Oracle license model that applies to the Oracle Autonomous Database. Bring your own license (BYOL) allows you to apply your current on-premises Oracle software licenses to equivalent, highly automated Oracle PaaS and IaaS services in the cloud. License Included allows you to subscribe to new Oracle Database software licenses and the Database service. Note that when provisioning an Autonomous Database on dedicated Exadata infrastructure, this attribute must be null because the attribute is already set at the Autonomous Exadata Infrastructure level. When using shared Exadata infrastructure, if a value is not specified, the system will supply the value of
BRING_YOUR_OWN_LICENSE
. It is a required field whendb_workload
is AJD and needs to be set toLICENSE_INCLUDED
as AJD does not support defaultlicense_model
valueBRING_YOUR_OWN_LICENSE
.- local
Adg numberAuto Failover Max Data Loss Limit Parameter that allows users to select an acceptable maximum data loss limit in seconds, up to which Automatic Failover will be triggered when necessary for a Local Autonomous Data Guard
- max
Cpu numberCore Count (Updatable) The number of Max OCPU cores to be made available to the autonomous database with auto scaling of cpu enabled.
- ncharacter
Set string The national character set for the autonomous database. The default is AL16UTF16. Allowed values are: AL16UTF16 or UTF8.
- nsg
Ids string[] (Updatable) The list of OCIDs for the network security groups (NSGs) to which this resource belongs. Setting this to an empty list removes all resources from all NSGs. For more information about NSGs, see Security Rules. NsgIds restrictions:
- A network security group (NSG) is optional for Autonomous Databases with private access. The nsgIds list can be empty.
- ocpu
Count number (Updatable) The number of OCPU cores to be made available to the database.
The following points apply:
- For Autonomous Databases on dedicated Exadata infrastructure, to provision less than 1 core, enter a fractional value in an increment of 0.1. For example, you can provision 0.3 or 0.4 cores, but not 0.35 cores. (Note that fractional OCPU values are not supported for Autonomous Databasese on shared Exadata infrastructure.)
- To provision 1 or more cores, you must enter an integer between 1 and the maximum number of cores available for the infrastructure shape. For example, you can provision 2 cores or 3 cores, but not 2.5 cores. This applies to Autonomous Databases on both shared and dedicated Exadata infrastructure.
For Autonomous Databases on dedicated Exadata infrastructure, the maximum number of cores is determined by the infrastructure shape. See Characteristics of Infrastructure Shapes for shape details.
Note: This parameter cannot be used with the
cpuCoreCount
parameter.- open
Mode string Indicates the Autonomous Database mode. The database can be opened in
READ_ONLY
orREAD_WRITE
mode.- operations
Insights stringStatus (Updatable) Status of Operations Insights for this Autonomous Database. Values supported are
ENABLED
andNOT_ENABLED
- permission
Level string The Autonomous Database permission level. Restricted mode allows access only by admin users.
- private
Endpoint stringIp The private endpoint Ip address for the resource.
- private
Endpoint stringLabel (Updatable) The private endpoint label for the resource.
- refreshable
Mode string (Updatable) The refresh mode of the clone. AUTOMATIC indicates that the clone is automatically being refreshed with data from the source Autonomous Database.
- remote
Disaster stringRecovery Type Indicates the cross-region disaster recovery (DR) type of the standby Shared Autonomous Database. Autonomous Data Guard (ADG) DR type provides business critical DR with a faster recovery time objective (RTO) during failover or switchover. Backup-based DR type provides lower cost DR with a slower RTO during failover or switchover.
- resource
Pool stringLeader Id - resource
Pool AutonomousSummary Database Resource Pool Summary - rotate
Key booleanTrigger (Updatable) An optional property when flipped triggers rotation of KMS key. It is only applicable on dedicated databases i.e. where
is_dedicated
is true.- scheduled
Operations AutonomousDatabase Scheduled Operation[] (Updatable) The list of scheduled operations.
This cannot be updated in parallel with any of the following: licenseModel, dbEdition, cpuCoreCount, computeCount, computeModel, whitelistedIps, isMTLSConnectionRequired, openMode, permissionLevel, dbWorkload, privateEndpointLabel, nsgIds, dbVersion, isRefreshable, dbName, dbToolsDetails, isLocalDataGuardEnabled, or isFreeTier.
- secret
Id string (Updatable) The Oracle Cloud Infrastructure vault secret [/Content/General/Concepts/identifiers.htm]OCID.
- secret
Version numberNumber (Updatable) The version of the vault secret. If no version is specified, the latest version will be used.
- source string
The source of the database: Use
NONE
for creating a new Autonomous Database. UseDATABASE
for creating a new Autonomous Database by cloning an existing Autonomous Database. UseCROSS_REGION_DATAGUARD
to create a standby Data Guard database in another region.For Autonomous Databases on shared Exadata infrastructure, the following cloning options are available: Use
BACKUP_FROM_ID
for creating a new Autonomous Database from a specified backup. UseBACKUP_FROM_TIMESTAMP
for creating a point-in-time Autonomous Database clone using backups. For more information, see Cloning and Moving an Autonomous Database.- source
Id string The OCID of the source Autonomous Database that will be used to create a new standby database for the Data Guard association.
- standby
Whitelisted string[]Ips (Updatable) The client IP access control list (ACL). This feature is available for autonomous databases on shared Exadata infrastructure and on Exadata Cloud@Customer. Only clients connecting from an IP address included in the ACL may access the Autonomous Database instance.
For shared Exadata infrastructure, this is an array of CIDR (Classless Inter-Domain Routing) notations for a subnet or VCN OCID. Use a semicolon (;) as a deliminator between the VCN-specific subnets or IPs. Example:
["1.1.1.1","1.1.1.0/24","ocid1.vcn.oc1.sea.<unique_id>","ocid1.vcn.oc1.sea.<unique_id1>;1.1.1.1","ocid1.vcn.oc1.sea.<unique_id2>;1.1.0.0/16"]
For Exadata Cloud@Customer, this is an array of IP addresses or CIDR (Classless Inter-Domain Routing) notations. Example:["1.1.1.1","1.1.1.0/24","1.1.2.25"]
For an update operation, if you want to delete all the IPs in the ACL, use an array with a single empty string entry.
This cannot be updated in parallel with any of the following: licenseModel, dbEdition, cpuCoreCount, computeCount, computeModel, adminPassword, isMTLSConnectionRequired, openMode, permissionLevel, dbWorkload, dbVersion, isRefreshable, dbName, scheduledOperations, dbToolsDetails, isLocalDataGuardEnabled, or isFreeTier.
- state string
The current state of the Autonomous Database.
- subnet
Id string (Updatable) The OCID of the subnet the resource is associated with.
Subnet Restrictions:
- For bare metal DB systems and for single node virtual machine DB systems, do not use a subnet that overlaps with 192.168.16.16/28.
- For Exadata and virtual machine 2-node RAC systems, do not use a subnet that overlaps with 192.168.128.0/20.
- For Autonomous Database, setting this will disable public secure access to the database.
These subnets are used by the Oracle Clusterware private interconnect on the database instance. Specifying an overlapping subnet will cause the private interconnect to malfunction. This restriction applies to both the client subnet and the backup subnet.
- switchover
To string It is applicable only when
is_data_guard_enabled
is true. Could be set toPRIMARY
orSTANDBY
. Default value isPRIMARY
.- switchover
To stringRemote Peer Id (Updatable) It is applicable only when
dataguard_region_type
androle
are set, andis_dedicated
is false. It takes the OCID of the remote peer to switchover to.- timestamp string
The timestamp specified for the point-in-time clone of the source Autonomous Database. The timestamp must be in the past.
- use
Latest booleanAvailable Backup Time Stamp Clone from latest available backup timestamp.
- vault
Id string - whitelisted
Ips string[] (Updatable) The client IP access control list (ACL). This feature is available for autonomous databases on shared Exadata infrastructure and on Exadata Cloud@Customer. Only clients connecting from an IP address included in the ACL may access the Autonomous Database instance.
For shared Exadata infrastructure, this is an array of CIDR (Classless Inter-Domain Routing) notations for a subnet or VCN OCID. Use a semicolon (;) as a deliminator between the VCN-specific subnets or IPs. Example:
["1.1.1.1","1.1.1.0/24","ocid1.vcn.oc1.sea.<unique_id>","ocid1.vcn.oc1.sea.<unique_id1>;1.1.1.1","ocid1.vcn.oc1.sea.<unique_id2>;1.1.0.0/16"]
For Exadata Cloud@Customer, this is an array of IP addresses or CIDR (Classless Inter-Domain Routing) notations. Example:["1.1.1.1","1.1.1.0/24","1.1.2.25"]
For an update operation, if you want to delete all the IPs in the ACL, use an array with a single empty string entry.
This cannot be updated in parallel with any of the following: licenseModel, dbEdition, cpuCoreCount, computeCount, computeModel, adminPassword, isMTLSConnectionRequired, openMode, permissionLevel, dbWorkload, dbVersion, isRefreshable, dbName, scheduledOperations, dbToolsDetails, isLocalDataGuardEnabled, or isFreeTier. To remove all whitelisted IPs, set the field to a list with an empty string
[""]
.This cannot be updated in parallel with any of the following: licenseModel, dbEdition, cpuCoreCount, computeCount, computeModel, adminPassword, isMTLSConnectionRequired, openMode, permissionLevel, dbWorkload, dbVersion, isRefreshable, dbName, scheduledOperations, dbToolsDetails, isLocalDataGuardEnabled, or isFreeTier. To remove all whitelisted IPs, set the field to a list with an empty string
[""]
.
- compartment_
id str (Updatable) The OCID of the compartment of the Autonomous Database.
- db_
name str (Updatable) Specify the database name; it must consist of letters and numbers only. The maximum length is 30 characters. The same database name cannot be used for multiple Autonomous Databases in the same tenancy in the same region.
- admin_
password str (Updatable) The password must be between 12 and 30 characters long, and must contain at least 1 uppercase, 1 lowercase, and 1 numeric character. It cannot contain the double quote symbol (") or the username "admin", regardless of casing. The password is mandatory if source value is "BACKUP_FROM_ID", "BACKUP_FROM_TIMESTAMP", "DATABASE" or "NONE".
- are_
primary_ boolwhitelisted_ ips_ used (Updatable) This field will be null if the Autonomous Database is not Data Guard enabled or Access Control is disabled. It's value would be
TRUE
if Autonomous Database is Data Guard enabled and Access Control is enabled and if the Autonomous Database uses primary IP access control list (ACL) for standby. It's value would beFALSE
if Autonomous Database is Data Guard enabled and Access Control is enabled and if the Autonomous Database uses different IP access control list (ACL) for standby compared to primary.- autonomous_
container_ strdatabase_ id The Autonomous Container Database OCID.
- autonomous_
database_ strbackup_ id The OCID of the source Autonomous Database Backup that you will clone to create a new Autonomous Database.
- autonomous_
database_ strid The OCID of the source Autonomous Database that you will clone to create a new Autonomous Database.
- autonomous_
maintenance_ strschedule_ type The maintenance schedule type of the Autonomous Database on shared Exadata infrastructure. The EARLY maintenance schedule of this Autonomous Database follows a schedule that applies patches prior to the REGULAR schedule.The REGULAR maintenance schedule of this Autonomous Database follows the normal cycle.
- backup_
retention_ intperiod_ in_ days (Updatable) Retention period, in days, for backups.
- character_
set str The character set for the autonomous database. The default is AL32UTF8. Allowed values for an Autonomous Database on shared infrastructure as as returned by List Autonomous Database Character Sets
For an Autonomous Database on dedicated infrastructure, the allowed values are:
AL32UTF8, AR8ADOS710, AR8ADOS720, AR8APTEC715, AR8ARABICMACS, AR8ASMO8X, AR8ISO8859P6, AR8MSWIN1256, AR8MUSSAD768, AR8NAFITHA711, AR8NAFITHA721, AR8SAKHR706, AR8SAKHR707, AZ8ISO8859P9E, BG8MSWIN, BG8PC437S, BLT8CP921, BLT8ISO8859P13, BLT8MSWIN1257, BLT8PC775, BN8BSCII, CDN8PC863, CEL8ISO8859P14, CL8ISO8859P5, CL8ISOIR111, CL8KOI8R, CL8KOI8U, CL8MACCYRILLICS, CL8MSWIN1251, EE8ISO8859P2, EE8MACCES, EE8MACCROATIANS, EE8MSWIN1250, EE8PC852, EL8DEC, EL8ISO8859P7, EL8MACGREEKS, EL8MSWIN1253, EL8PC437S, EL8PC851, EL8PC869, ET8MSWIN923, HU8ABMOD, HU8CWI2, IN8ISCII, IS8PC861, IW8ISO8859P8, IW8MACHEBREWS, IW8MSWIN1255, IW8PC1507, JA16EUC, JA16EUCTILDE, JA16SJIS, JA16SJISTILDE, JA16VMS, KO16KSC5601, KO16KSCCS, KO16MSWIN949, LA8ISO6937, LA8PASSPORT, LT8MSWIN921, LT8PC772, LT8PC774, LV8PC1117, LV8PC8LR, LV8RST104090, N8PC865, NE8ISO8859P10, NEE8ISO8859P4, RU8BESTA, RU8PC855, RU8PC866, SE8ISO8859P3, TH8MACTHAIS, TH8TISASCII, TR8DEC, TR8MACTURKISHS, TR8MSWIN1254, TR8PC857, US7ASCII, US8PC437, UTF8, VN8MSWIN1258, VN8VN3, WE8DEC, WE8DG, WE8ISO8859P1, WE8ISO8859P15, WE8ISO8859P9, WE8MACROMAN8S, WE8MSWIN1252, WE8NCR4970, WE8NEXTSTEP, WE8PC850, WE8PC858, WE8PC860, WE8ROMAN8, ZHS16CGB231280, ZHS16GBK, ZHT16BIG5, ZHT16CCDC, ZHT16DBT, ZHT16HKSCS, ZHT16MSWIN950, ZHT32EUC, ZHT32SOPS, ZHT32TRIS
- clone_
type str The Autonomous Database clone type.
- compute_
count float (Updatable) The compute amount available to the database. Minimum and maximum values depend on the compute model and whether the database is on Shared or Dedicated infrastructure. For an Autonomous Database on Shared infrastructure, the 'ECPU' compute model requires values in multiples of two. Required when using the
computeModel
parameter. When usingcpuCoreCount
parameter, it is an error to specify computeCount to a non-null value.- compute_
model str (Updatable) The compute model of the Autonomous Database. This is required if using the
computeCount
parameter. If usingcpuCoreCount
then it is an error to specifycomputeModel
to a non-null value.- cpu_
core_ intcount (Updatable) The number of OCPU cores to be made available to the database. For Autonomous Databases on dedicated Exadata infrastructure, the maximum number of cores is determined by the infrastructure shape. See Characteristics of Infrastructure Shapes for shape details. Note: This parameter cannot be used with the
ocpuCount
parameter. This input is ignored for Always Free resources.- The data type must be an integer.
- The minimum number of cores for all types of autonomous database is 1
- The maximum number of cores is as follows:
- Autonomous Databases on shared Exadata infrastructure: The maximum number of cores is 128.
- Autonomous Databases on dedicated Exadata infrastructure: The maximum number of cores is determined by the infrastructure shape. See Characteristics of Infrastructure Shapes for shape details.
- customer_
contacts AutonomousDatabase Customer Contact Args] (Updatable) Customer Contacts.
- data_
safe_ strstatus (Updatable) Status of the Data Safe registration for this Autonomous Database. Could be REGISTERED or NOT_REGISTERED.
- data_
storage_ intsize_ in_ gb (Updatable) The size, in gigabytes, of the data volume that will be created and attached to the database. This storage can later be scaled up if needed. The maximum storage value is determined by the infrastructure shape. See Characteristics of Infrastructure Shapes for shape details.
Notes
- This parameter is only supported for dedicated Exadata infrastructure.
- This parameter cannot be used with the
dataStorageSizeInTBs
parameter.
- data_
storage_ intsize_ in_ tbs (Updatable) The size, in terabytes, of the data volume that will be created and attached to the database. This storage can later be scaled up if needed. For Autonomous Databases on dedicated Exadata infrastructure, the maximum storage value is determined by the infrastructure shape. See Characteristics of Infrastructure Shapes for shape details. A full Exadata service is allocated when the Autonomous Database size is set to the upper limit (384 TB).
Note: This parameter cannot be used with the
dataStorageSizeInGBs
parameter. This input is ignored for Always Free resources.- database_
edition str (Updatable) The Oracle Database Edition that applies to the Autonomous databases.
- database_
management_ strstatus Status of Database Management for this Autonomous Database.
- db_
version str (Updatable) A valid Oracle Database version for Autonomous Database.
db_workload
AJD and APEX are only supported fordb_version
19c
and above.- db_
workload str (Updatable) The Autonomous Database workload type. The following values are valid:
- OLTP - indicates an Autonomous Transaction Processing database
- DW - indicates an Autonomous Data Warehouse database
- AJD - indicates an Autonomous JSON Database
- APEX - indicates an Autonomous Database with the Oracle APEX Application Development workload type.
This cannot be updated in parallel with any of the following: licenseModel, dbEdition, cpuCoreCount, computeCount, computeModel, adminPassword, whitelistedIps, isMTLSConnectionRequired, privateEndpointLabel, nsgIds, dbVersion, isRefreshable, dbName, scheduledOperations, dbToolsDetails, isLocalDataGuardEnabled, or isFreeTier. *Note:
db_workload
can only be updated from AJD to OLTP or from a free OLTP to AJD.- Mapping[str, Any]
(Updatable) Defined tags for this resource. Each key is predefined and scoped to a namespace. For more information, see Resource Tags.
- display_
name str (Updatable) The user-friendly name for the Autonomous Database. The name does not have to be unique.
- Mapping[str, Any]
(Updatable) Free-form tags for this resource. Each tag is a simple key-value pair with no predefined name, type, or namespace. For more information, see Resource Tags. Example:
{"Department": "Finance"}
- in_
memory_ intpercentage (Updatable) The percentage of the System Global Area(SGA) assigned to In-Memory tables in Autonomous Database.
- is_
access_ boolcontrol_ enabled (Updatable) Indicates if the database-level access control is enabled. If disabled, database access is defined by the network security rules. If enabled, database access is restricted to the IP addresses defined by the rules specified with the
whitelistedIps
property. While specifyingwhitelistedIps
rules is optional, if database-level access control is enabled and no rules are specified, the database will become inaccessible. The rules can be added later using theUpdateAutonomousDatabase
API operation or edit option in console. When creating a database clone, the desired access control setting should be specified. By default, database-level access control will be disabled for the clone.This property is applicable only to Autonomous Databases on the Exadata Cloud@Customer platform.
- is_
auto_ boolscaling_ enabled (Updatable) Indicates if auto scaling is enabled for the Autonomous Database OCPU core count. The default value is
FALSE
.- is_
auto_ boolscaling_ for_ storage_ enabled (Updatable) Indicates if auto scaling is enabled for the Autonomous Database storage. The default value is
FALSE
.- is_
data_ boolguard_ enabled (Updatable) Deprecated. Indicates whether the Autonomous Database has local (in-region) Data Guard enabled. Not applicable to cross-region Autonomous Data Guard associations, or to Autonomous Databases using dedicated Exadata infrastructure or Exadata Cloud@Customer infrastructure.
- is_
dedicated bool True if the database is on dedicated Exadata infrastructure.
- is_
free_ booltier (Updatable) Indicates if this is an Always Free resource. The default value is false. Note that Always Free Autonomous Databases have 1 CPU and 20GB of memory. For Always Free databases, memory and CPU cannot be scaled. When
db_workload
isAJD
orAPEX
it cannot betrue
.- is_
local_ booldata_ guard_ enabled (Updatable) Indicates whether the Autonomous Database has local (in-region) Data Guard enabled. Not applicable to cross-region Autonomous Data Guard associations, or to Autonomous Databases using dedicated Exadata infrastructure or Exadata Cloud@Customer infrastructure.
- is_
mtls_ boolconnection_ required (Updatable) Indicates whether the Autonomous Database requires mTLS connections.
- is_
preview_ boolversion_ with_ service_ terms_ accepted If set to
TRUE
, indicates that an Autonomous Database preview version is being provisioned, and that the preview version's terms of service have been accepted. Note that preview version software is only available for databases on shared Exadata infrastructure.- is_
refreshable_ boolclone (Updatable) True for creating a refreshable clone and False for detaching the clone from source Autonomous Database. Detaching is one time operation and clone becomes a regular Autonomous Database.
- is_
shrink_ boolonly (Updatable) An optional property when enabled triggers the Shrinking of Autonomous Database once. To trigger Shrinking of ADB once again, this flag needs to be disabled and re-enabled again. It should not be passed during create database operation. It is only applicable on shared databases i.e. where
is_dedicated
is false.** IMPORTANT ** Any change to a property that does not support update will force the destruction and recreation of the resource with the new property values
- kms_
key_ strid The OCID of the key container that is used as the master encryption key in database transparent data encryption (TDE) operations.
- license_
model str (Updatable) The Oracle license model that applies to the Oracle Autonomous Database. Bring your own license (BYOL) allows you to apply your current on-premises Oracle software licenses to equivalent, highly automated Oracle PaaS and IaaS services in the cloud. License Included allows you to subscribe to new Oracle Database software licenses and the Database service. Note that when provisioning an Autonomous Database on dedicated Exadata infrastructure, this attribute must be null because the attribute is already set at the Autonomous Exadata Infrastructure level. When using shared Exadata infrastructure, if a value is not specified, the system will supply the value of
BRING_YOUR_OWN_LICENSE
. It is a required field whendb_workload
is AJD and needs to be set toLICENSE_INCLUDED
as AJD does not support defaultlicense_model
valueBRING_YOUR_OWN_LICENSE
.- local_
adg_ intauto_ failover_ max_ data_ loss_ limit Parameter that allows users to select an acceptable maximum data loss limit in seconds, up to which Automatic Failover will be triggered when necessary for a Local Autonomous Data Guard
- max_
cpu_ intcore_ count (Updatable) The number of Max OCPU cores to be made available to the autonomous database with auto scaling of cpu enabled.
- ncharacter_
set str The national character set for the autonomous database. The default is AL16UTF16. Allowed values are: AL16UTF16 or UTF8.
- nsg_
ids Sequence[str] (Updatable) The list of OCIDs for the network security groups (NSGs) to which this resource belongs. Setting this to an empty list removes all resources from all NSGs. For more information about NSGs, see Security Rules. NsgIds restrictions:
- A network security group (NSG) is optional for Autonomous Databases with private access. The nsgIds list can be empty.
- ocpu_
count float (Updatable) The number of OCPU cores to be made available to the database.
The following points apply:
- For Autonomous Databases on dedicated Exadata infrastructure, to provision less than 1 core, enter a fractional value in an increment of 0.1. For example, you can provision 0.3 or 0.4 cores, but not 0.35 cores. (Note that fractional OCPU values are not supported for Autonomous Databasese on shared Exadata infrastructure.)
- To provision 1 or more cores, you must enter an integer between 1 and the maximum number of cores available for the infrastructure shape. For example, you can provision 2 cores or 3 cores, but not 2.5 cores. This applies to Autonomous Databases on both shared and dedicated Exadata infrastructure.
For Autonomous Databases on dedicated Exadata infrastructure, the maximum number of cores is determined by the infrastructure shape. See Characteristics of Infrastructure Shapes for shape details.
Note: This parameter cannot be used with the
cpuCoreCount
parameter.- open_
mode str Indicates the Autonomous Database mode. The database can be opened in
READ_ONLY
orREAD_WRITE
mode.- operations_
insights_ strstatus (Updatable) Status of Operations Insights for this Autonomous Database. Values supported are
ENABLED
andNOT_ENABLED
- permission_
level str The Autonomous Database permission level. Restricted mode allows access only by admin users.
- private_
endpoint_ strip The private endpoint Ip address for the resource.
- private_
endpoint_ strlabel (Updatable) The private endpoint label for the resource.
- refreshable_
mode str (Updatable) The refresh mode of the clone. AUTOMATIC indicates that the clone is automatically being refreshed with data from the source Autonomous Database.
- remote_
disaster_ strrecovery_ type Indicates the cross-region disaster recovery (DR) type of the standby Shared Autonomous Database. Autonomous Data Guard (ADG) DR type provides business critical DR with a faster recovery time objective (RTO) during failover or switchover. Backup-based DR type provides lower cost DR with a slower RTO during failover or switchover.
- resource_
pool_ strleader_ id - resource_
pool_ Autonomoussummary Database Resource Pool Summary Args - rotate_
key_ booltrigger (Updatable) An optional property when flipped triggers rotation of KMS key. It is only applicable on dedicated databases i.e. where
is_dedicated
is true.- scheduled_
operations AutonomousDatabase Scheduled Operation Args] (Updatable) The list of scheduled operations.
This cannot be updated in parallel with any of the following: licenseModel, dbEdition, cpuCoreCount, computeCount, computeModel, whitelistedIps, isMTLSConnectionRequired, openMode, permissionLevel, dbWorkload, privateEndpointLabel, nsgIds, dbVersion, isRefreshable, dbName, dbToolsDetails, isLocalDataGuardEnabled, or isFreeTier.
- secret_
id str (Updatable) The Oracle Cloud Infrastructure vault secret [/Content/General/Concepts/identifiers.htm]OCID.
- secret_
version_ intnumber (Updatable) The version of the vault secret. If no version is specified, the latest version will be used.
- source str
The source of the database: Use
NONE
for creating a new Autonomous Database. UseDATABASE
for creating a new Autonomous Database by cloning an existing Autonomous Database. UseCROSS_REGION_DATAGUARD
to create a standby Data Guard database in another region.For Autonomous Databases on shared Exadata infrastructure, the following cloning options are available: Use
BACKUP_FROM_ID
for creating a new Autonomous Database from a specified backup. UseBACKUP_FROM_TIMESTAMP
for creating a point-in-time Autonomous Database clone using backups. For more information, see Cloning and Moving an Autonomous Database.- source_
id str The OCID of the source Autonomous Database that will be used to create a new standby database for the Data Guard association.
- standby_
whitelisted_ Sequence[str]ips (Updatable) The client IP access control list (ACL). This feature is available for autonomous databases on shared Exadata infrastructure and on Exadata Cloud@Customer. Only clients connecting from an IP address included in the ACL may access the Autonomous Database instance.
For shared Exadata infrastructure, this is an array of CIDR (Classless Inter-Domain Routing) notations for a subnet or VCN OCID. Use a semicolon (;) as a deliminator between the VCN-specific subnets or IPs. Example:
["1.1.1.1","1.1.1.0/24","ocid1.vcn.oc1.sea.<unique_id>","ocid1.vcn.oc1.sea.<unique_id1>;1.1.1.1","ocid1.vcn.oc1.sea.<unique_id2>;1.1.0.0/16"]
For Exadata Cloud@Customer, this is an array of IP addresses or CIDR (Classless Inter-Domain Routing) notations. Example:["1.1.1.1","1.1.1.0/24","1.1.2.25"]
For an update operation, if you want to delete all the IPs in the ACL, use an array with a single empty string entry.
This cannot be updated in parallel with any of the following: licenseModel, dbEdition, cpuCoreCount, computeCount, computeModel, adminPassword, isMTLSConnectionRequired, openMode, permissionLevel, dbWorkload, dbVersion, isRefreshable, dbName, scheduledOperations, dbToolsDetails, isLocalDataGuardEnabled, or isFreeTier.
- state str
The current state of the Autonomous Database.
- subnet_
id str (Updatable) The OCID of the subnet the resource is associated with.
Subnet Restrictions:
- For bare metal DB systems and for single node virtual machine DB systems, do not use a subnet that overlaps with 192.168.16.16/28.
- For Exadata and virtual machine 2-node RAC systems, do not use a subnet that overlaps with 192.168.128.0/20.
- For Autonomous Database, setting this will disable public secure access to the database.
These subnets are used by the Oracle Clusterware private interconnect on the database instance. Specifying an overlapping subnet will cause the private interconnect to malfunction. This restriction applies to both the client subnet and the backup subnet.
- switchover_
to str It is applicable only when
is_data_guard_enabled
is true. Could be set toPRIMARY
orSTANDBY
. Default value isPRIMARY
.- switchover_
to_ strremote_ peer_ id (Updatable) It is applicable only when
dataguard_region_type
androle
are set, andis_dedicated
is false. It takes the OCID of the remote peer to switchover to.- timestamp str
The timestamp specified for the point-in-time clone of the source Autonomous Database. The timestamp must be in the past.
- use_
latest_ boolavailable_ backup_ time_ stamp Clone from latest available backup timestamp.
- vault_
id str - whitelisted_
ips Sequence[str] (Updatable) The client IP access control list (ACL). This feature is available for autonomous databases on shared Exadata infrastructure and on Exadata Cloud@Customer. Only clients connecting from an IP address included in the ACL may access the Autonomous Database instance.
For shared Exadata infrastructure, this is an array of CIDR (Classless Inter-Domain Routing) notations for a subnet or VCN OCID. Use a semicolon (;) as a deliminator between the VCN-specific subnets or IPs. Example:
["1.1.1.1","1.1.1.0/24","ocid1.vcn.oc1.sea.<unique_id>","ocid1.vcn.oc1.sea.<unique_id1>;1.1.1.1","ocid1.vcn.oc1.sea.<unique_id2>;1.1.0.0/16"]
For Exadata Cloud@Customer, this is an array of IP addresses or CIDR (Classless Inter-Domain Routing) notations. Example:["1.1.1.1","1.1.1.0/24","1.1.2.25"]
For an update operation, if you want to delete all the IPs in the ACL, use an array with a single empty string entry.
This cannot be updated in parallel with any of the following: licenseModel, dbEdition, cpuCoreCount, computeCount, computeModel, adminPassword, isMTLSConnectionRequired, openMode, permissionLevel, dbWorkload, dbVersion, isRefreshable, dbName, scheduledOperations, dbToolsDetails, isLocalDataGuardEnabled, or isFreeTier. To remove all whitelisted IPs, set the field to a list with an empty string
[""]
.This cannot be updated in parallel with any of the following: licenseModel, dbEdition, cpuCoreCount, computeCount, computeModel, adminPassword, isMTLSConnectionRequired, openMode, permissionLevel, dbWorkload, dbVersion, isRefreshable, dbName, scheduledOperations, dbToolsDetails, isLocalDataGuardEnabled, or isFreeTier. To remove all whitelisted IPs, set the field to a list with an empty string
[""]
.
- compartment
Id String (Updatable) The OCID of the compartment of the Autonomous Database.
- db
Name String (Updatable) Specify the database name; it must consist of letters and numbers only. The maximum length is 30 characters. The same database name cannot be used for multiple Autonomous Databases in the same tenancy in the same region.
- admin
Password String (Updatable) The password must be between 12 and 30 characters long, and must contain at least 1 uppercase, 1 lowercase, and 1 numeric character. It cannot contain the double quote symbol (") or the username "admin", regardless of casing. The password is mandatory if source value is "BACKUP_FROM_ID", "BACKUP_FROM_TIMESTAMP", "DATABASE" or "NONE".
- are
Primary BooleanWhitelisted Ips Used (Updatable) This field will be null if the Autonomous Database is not Data Guard enabled or Access Control is disabled. It's value would be
TRUE
if Autonomous Database is Data Guard enabled and Access Control is enabled and if the Autonomous Database uses primary IP access control list (ACL) for standby. It's value would beFALSE
if Autonomous Database is Data Guard enabled and Access Control is enabled and if the Autonomous Database uses different IP access control list (ACL) for standby compared to primary.- autonomous
Container StringDatabase Id The Autonomous Container Database OCID.
- autonomous
Database StringBackup Id The OCID of the source Autonomous Database Backup that you will clone to create a new Autonomous Database.
- autonomous
Database StringId The OCID of the source Autonomous Database that you will clone to create a new Autonomous Database.
- autonomous
Maintenance StringSchedule Type The maintenance schedule type of the Autonomous Database on shared Exadata infrastructure. The EARLY maintenance schedule of this Autonomous Database follows a schedule that applies patches prior to the REGULAR schedule.The REGULAR maintenance schedule of this Autonomous Database follows the normal cycle.
- backup
Retention NumberPeriod In Days (Updatable) Retention period, in days, for backups.
- character
Set String The character set for the autonomous database. The default is AL32UTF8. Allowed values for an Autonomous Database on shared infrastructure as as returned by List Autonomous Database Character Sets
For an Autonomous Database on dedicated infrastructure, the allowed values are:
AL32UTF8, AR8ADOS710, AR8ADOS720, AR8APTEC715, AR8ARABICMACS, AR8ASMO8X, AR8ISO8859P6, AR8MSWIN1256, AR8MUSSAD768, AR8NAFITHA711, AR8NAFITHA721, AR8SAKHR706, AR8SAKHR707, AZ8ISO8859P9E, BG8MSWIN, BG8PC437S, BLT8CP921, BLT8ISO8859P13, BLT8MSWIN1257, BLT8PC775, BN8BSCII, CDN8PC863, CEL8ISO8859P14, CL8ISO8859P5, CL8ISOIR111, CL8KOI8R, CL8KOI8U, CL8MACCYRILLICS, CL8MSWIN1251, EE8ISO8859P2, EE8MACCES, EE8MACCROATIANS, EE8MSWIN1250, EE8PC852, EL8DEC, EL8ISO8859P7, EL8MACGREEKS, EL8MSWIN1253, EL8PC437S, EL8PC851, EL8PC869, ET8MSWIN923, HU8ABMOD, HU8CWI2, IN8ISCII, IS8PC861, IW8ISO8859P8, IW8MACHEBREWS, IW8MSWIN1255, IW8PC1507, JA16EUC, JA16EUCTILDE, JA16SJIS, JA16SJISTILDE, JA16VMS, KO16KSC5601, KO16KSCCS, KO16MSWIN949, LA8ISO6937, LA8PASSPORT, LT8MSWIN921, LT8PC772, LT8PC774, LV8PC1117, LV8PC8LR, LV8RST104090, N8PC865, NE8ISO8859P10, NEE8ISO8859P4, RU8BESTA, RU8PC855, RU8PC866, SE8ISO8859P3, TH8MACTHAIS, TH8TISASCII, TR8DEC, TR8MACTURKISHS, TR8MSWIN1254, TR8PC857, US7ASCII, US8PC437, UTF8, VN8MSWIN1258, VN8VN3, WE8DEC, WE8DG, WE8ISO8859P1, WE8ISO8859P15, WE8ISO8859P9, WE8MACROMAN8S, WE8MSWIN1252, WE8NCR4970, WE8NEXTSTEP, WE8PC850, WE8PC858, WE8PC860, WE8ROMAN8, ZHS16CGB231280, ZHS16GBK, ZHT16BIG5, ZHT16CCDC, ZHT16DBT, ZHT16HKSCS, ZHT16MSWIN950, ZHT32EUC, ZHT32SOPS, ZHT32TRIS
- clone
Type String The Autonomous Database clone type.
- compute
Count Number (Updatable) The compute amount available to the database. Minimum and maximum values depend on the compute model and whether the database is on Shared or Dedicated infrastructure. For an Autonomous Database on Shared infrastructure, the 'ECPU' compute model requires values in multiples of two. Required when using the
computeModel
parameter. When usingcpuCoreCount
parameter, it is an error to specify computeCount to a non-null value.- compute
Model String (Updatable) The compute model of the Autonomous Database. This is required if using the
computeCount
parameter. If usingcpuCoreCount
then it is an error to specifycomputeModel
to a non-null value.- cpu
Core NumberCount (Updatable) The number of OCPU cores to be made available to the database. For Autonomous Databases on dedicated Exadata infrastructure, the maximum number of cores is determined by the infrastructure shape. See Characteristics of Infrastructure Shapes for shape details. Note: This parameter cannot be used with the
ocpuCount
parameter. This input is ignored for Always Free resources.- The data type must be an integer.
- The minimum number of cores for all types of autonomous database is 1
- The maximum number of cores is as follows:
- Autonomous Databases on shared Exadata infrastructure: The maximum number of cores is 128.
- Autonomous Databases on dedicated Exadata infrastructure: The maximum number of cores is determined by the infrastructure shape. See Characteristics of Infrastructure Shapes for shape details.
- customer
Contacts List<Property Map> (Updatable) Customer Contacts.
- data
Safe StringStatus (Updatable) Status of the Data Safe registration for this Autonomous Database. Could be REGISTERED or NOT_REGISTERED.
- data
Storage NumberSize In Gb (Updatable) The size, in gigabytes, of the data volume that will be created and attached to the database. This storage can later be scaled up if needed. The maximum storage value is determined by the infrastructure shape. See Characteristics of Infrastructure Shapes for shape details.
Notes
- This parameter is only supported for dedicated Exadata infrastructure.
- This parameter cannot be used with the
dataStorageSizeInTBs
parameter.
- data
Storage NumberSize In Tbs (Updatable) The size, in terabytes, of the data volume that will be created and attached to the database. This storage can later be scaled up if needed. For Autonomous Databases on dedicated Exadata infrastructure, the maximum storage value is determined by the infrastructure shape. See Characteristics of Infrastructure Shapes for shape details. A full Exadata service is allocated when the Autonomous Database size is set to the upper limit (384 TB).
Note: This parameter cannot be used with the
dataStorageSizeInGBs
parameter. This input is ignored for Always Free resources.- database
Edition String (Updatable) The Oracle Database Edition that applies to the Autonomous databases.
- database
Management StringStatus Status of Database Management for this Autonomous Database.
- db
Version String (Updatable) A valid Oracle Database version for Autonomous Database.
db_workload
AJD and APEX are only supported fordb_version
19c
and above.- db
Workload String (Updatable) The Autonomous Database workload type. The following values are valid:
- OLTP - indicates an Autonomous Transaction Processing database
- DW - indicates an Autonomous Data Warehouse database
- AJD - indicates an Autonomous JSON Database
- APEX - indicates an Autonomous Database with the Oracle APEX Application Development workload type.
This cannot be updated in parallel with any of the following: licenseModel, dbEdition, cpuCoreCount, computeCount, computeModel, adminPassword, whitelistedIps, isMTLSConnectionRequired, privateEndpointLabel, nsgIds, dbVersion, isRefreshable, dbName, scheduledOperations, dbToolsDetails, isLocalDataGuardEnabled, or isFreeTier. *Note:
db_workload
can only be updated from AJD to OLTP or from a free OLTP to AJD.- Map<Any>
(Updatable) Defined tags for this resource. Each key is predefined and scoped to a namespace. For more information, see Resource Tags.
- display
Name String (Updatable) The user-friendly name for the Autonomous Database. The name does not have to be unique.
- Map<Any>
(Updatable) Free-form tags for this resource. Each tag is a simple key-value pair with no predefined name, type, or namespace. For more information, see Resource Tags. Example:
{"Department": "Finance"}
- in
Memory NumberPercentage (Updatable) The percentage of the System Global Area(SGA) assigned to In-Memory tables in Autonomous Database.
- is
Access BooleanControl Enabled (Updatable) Indicates if the database-level access control is enabled. If disabled, database access is defined by the network security rules. If enabled, database access is restricted to the IP addresses defined by the rules specified with the
whitelistedIps
property. While specifyingwhitelistedIps
rules is optional, if database-level access control is enabled and no rules are specified, the database will become inaccessible. The rules can be added later using theUpdateAutonomousDatabase
API operation or edit option in console. When creating a database clone, the desired access control setting should be specified. By default, database-level access control will be disabled for the clone.This property is applicable only to Autonomous Databases on the Exadata Cloud@Customer platform.
- is
Auto BooleanScaling Enabled (Updatable) Indicates if auto scaling is enabled for the Autonomous Database OCPU core count. The default value is
FALSE
.- is
Auto BooleanScaling For Storage Enabled (Updatable) Indicates if auto scaling is enabled for the Autonomous Database storage. The default value is
FALSE
.- is
Data BooleanGuard Enabled (Updatable) Deprecated. Indicates whether the Autonomous Database has local (in-region) Data Guard enabled. Not applicable to cross-region Autonomous Data Guard associations, or to Autonomous Databases using dedicated Exadata infrastructure or Exadata Cloud@Customer infrastructure.
- is
Dedicated Boolean True if the database is on dedicated Exadata infrastructure.
- is
Free BooleanTier (Updatable) Indicates if this is an Always Free resource. The default value is false. Note that Always Free Autonomous Databases have 1 CPU and 20GB of memory. For Always Free databases, memory and CPU cannot be scaled. When
db_workload
isAJD
orAPEX
it cannot betrue
.- is
Local BooleanData Guard Enabled (Updatable) Indicates whether the Autonomous Database has local (in-region) Data Guard enabled. Not applicable to cross-region Autonomous Data Guard associations, or to Autonomous Databases using dedicated Exadata infrastructure or Exadata Cloud@Customer infrastructure.
- is
Mtls BooleanConnection Required (Updatable) Indicates whether the Autonomous Database requires mTLS connections.
- is
Preview BooleanVersion With Service Terms Accepted If set to
TRUE
, indicates that an Autonomous Database preview version is being provisioned, and that the preview version's terms of service have been accepted. Note that preview version software is only available for databases on shared Exadata infrastructure.- is
Refreshable BooleanClone (Updatable) True for creating a refreshable clone and False for detaching the clone from source Autonomous Database. Detaching is one time operation and clone becomes a regular Autonomous Database.
- is
Shrink BooleanOnly (Updatable) An optional property when enabled triggers the Shrinking of Autonomous Database once. To trigger Shrinking of ADB once again, this flag needs to be disabled and re-enabled again. It should not be passed during create database operation. It is only applicable on shared databases i.e. where
is_dedicated
is false.** IMPORTANT ** Any change to a property that does not support update will force the destruction and recreation of the resource with the new property values
- kms
Key StringId The OCID of the key container that is used as the master encryption key in database transparent data encryption (TDE) operations.
- license
Model String (Updatable) The Oracle license model that applies to the Oracle Autonomous Database. Bring your own license (BYOL) allows you to apply your current on-premises Oracle software licenses to equivalent, highly automated Oracle PaaS and IaaS services in the cloud. License Included allows you to subscribe to new Oracle Database software licenses and the Database service. Note that when provisioning an Autonomous Database on dedicated Exadata infrastructure, this attribute must be null because the attribute is already set at the Autonomous Exadata Infrastructure level. When using shared Exadata infrastructure, if a value is not specified, the system will supply the value of
BRING_YOUR_OWN_LICENSE
. It is a required field whendb_workload
is AJD and needs to be set toLICENSE_INCLUDED
as AJD does not support defaultlicense_model
valueBRING_YOUR_OWN_LICENSE
.- local
Adg NumberAuto Failover Max Data Loss Limit Parameter that allows users to select an acceptable maximum data loss limit in seconds, up to which Automatic Failover will be triggered when necessary for a Local Autonomous Data Guard
- max
Cpu NumberCore Count (Updatable) The number of Max OCPU cores to be made available to the autonomous database with auto scaling of cpu enabled.
- ncharacter
Set String The national character set for the autonomous database. The default is AL16UTF16. Allowed values are: AL16UTF16 or UTF8.
- nsg
Ids List<String> (Updatable) The list of OCIDs for the network security groups (NSGs) to which this resource belongs. Setting this to an empty list removes all resources from all NSGs. For more information about NSGs, see Security Rules. NsgIds restrictions:
- A network security group (NSG) is optional for Autonomous Databases with private access. The nsgIds list can be empty.
- ocpu
Count Number (Updatable) The number of OCPU cores to be made available to the database.
The following points apply:
- For Autonomous Databases on dedicated Exadata infrastructure, to provision less than 1 core, enter a fractional value in an increment of 0.1. For example, you can provision 0.3 or 0.4 cores, but not 0.35 cores. (Note that fractional OCPU values are not supported for Autonomous Databasese on shared Exadata infrastructure.)
- To provision 1 or more cores, you must enter an integer between 1 and the maximum number of cores available for the infrastructure shape. For example, you can provision 2 cores or 3 cores, but not 2.5 cores. This applies to Autonomous Databases on both shared and dedicated Exadata infrastructure.
For Autonomous Databases on dedicated Exadata infrastructure, the maximum number of cores is determined by the infrastructure shape. See Characteristics of Infrastructure Shapes for shape details.
Note: This parameter cannot be used with the
cpuCoreCount
parameter.- open
Mode String Indicates the Autonomous Database mode. The database can be opened in
READ_ONLY
orREAD_WRITE
mode.- operations
Insights StringStatus (Updatable) Status of Operations Insights for this Autonomous Database. Values supported are
ENABLED
andNOT_ENABLED
- permission
Level String The Autonomous Database permission level. Restricted mode allows access only by admin users.
- private
Endpoint StringIp The private endpoint Ip address for the resource.
- private
Endpoint StringLabel (Updatable) The private endpoint label for the resource.
- refreshable
Mode String (Updatable) The refresh mode of the clone. AUTOMATIC indicates that the clone is automatically being refreshed with data from the source Autonomous Database.
- remote
Disaster StringRecovery Type Indicates the cross-region disaster recovery (DR) type of the standby Shared Autonomous Database. Autonomous Data Guard (ADG) DR type provides business critical DR with a faster recovery time objective (RTO) during failover or switchover. Backup-based DR type provides lower cost DR with a slower RTO during failover or switchover.
- resource
Pool StringLeader Id - resource
Pool Property MapSummary - rotate
Key BooleanTrigger (Updatable) An optional property when flipped triggers rotation of KMS key. It is only applicable on dedicated databases i.e. where
is_dedicated
is true.- scheduled
Operations List<Property Map> (Updatable) The list of scheduled operations.
This cannot be updated in parallel with any of the following: licenseModel, dbEdition, cpuCoreCount, computeCount, computeModel, whitelistedIps, isMTLSConnectionRequired, openMode, permissionLevel, dbWorkload, privateEndpointLabel, nsgIds, dbVersion, isRefreshable, dbName, dbToolsDetails, isLocalDataGuardEnabled, or isFreeTier.
- secret
Id String (Updatable) The Oracle Cloud Infrastructure vault secret [/Content/General/Concepts/identifiers.htm]OCID.
- secret
Version NumberNumber (Updatable) The version of the vault secret. If no version is specified, the latest version will be used.
- source String
The source of the database: Use
NONE
for creating a new Autonomous Database. UseDATABASE
for creating a new Autonomous Database by cloning an existing Autonomous Database. UseCROSS_REGION_DATAGUARD
to create a standby Data Guard database in another region.For Autonomous Databases on shared Exadata infrastructure, the following cloning options are available: Use
BACKUP_FROM_ID
for creating a new Autonomous Database from a specified backup. UseBACKUP_FROM_TIMESTAMP
for creating a point-in-time Autonomous Database clone using backups. For more information, see Cloning and Moving an Autonomous Database.- source
Id String The OCID of the source Autonomous Database that will be used to create a new standby database for the Data Guard association.
- standby
Whitelisted List<String>Ips (Updatable) The client IP access control list (ACL). This feature is available for autonomous databases on shared Exadata infrastructure and on Exadata Cloud@Customer. Only clients connecting from an IP address included in the ACL may access the Autonomous Database instance.
For shared Exadata infrastructure, this is an array of CIDR (Classless Inter-Domain Routing) notations for a subnet or VCN OCID. Use a semicolon (;) as a deliminator between the VCN-specific subnets or IPs. Example:
["1.1.1.1","1.1.1.0/24","ocid1.vcn.oc1.sea.<unique_id>","ocid1.vcn.oc1.sea.<unique_id1>;1.1.1.1","ocid1.vcn.oc1.sea.<unique_id2>;1.1.0.0/16"]
For Exadata Cloud@Customer, this is an array of IP addresses or CIDR (Classless Inter-Domain Routing) notations. Example:["1.1.1.1","1.1.1.0/24","1.1.2.25"]
For an update operation, if you want to delete all the IPs in the ACL, use an array with a single empty string entry.
This cannot be updated in parallel with any of the following: licenseModel, dbEdition, cpuCoreCount, computeCount, computeModel, adminPassword, isMTLSConnectionRequired, openMode, permissionLevel, dbWorkload, dbVersion, isRefreshable, dbName, scheduledOperations, dbToolsDetails, isLocalDataGuardEnabled, or isFreeTier.
- state String
The current state of the Autonomous Database.
- subnet
Id String (Updatable) The OCID of the subnet the resource is associated with.
Subnet Restrictions:
- For bare metal DB systems and for single node virtual machine DB systems, do not use a subnet that overlaps with 192.168.16.16/28.
- For Exadata and virtual machine 2-node RAC systems, do not use a subnet that overlaps with 192.168.128.0/20.
- For Autonomous Database, setting this will disable public secure access to the database.
These subnets are used by the Oracle Clusterware private interconnect on the database instance. Specifying an overlapping subnet will cause the private interconnect to malfunction. This restriction applies to both the client subnet and the backup subnet.
- switchover
To String It is applicable only when
is_data_guard_enabled
is true. Could be set toPRIMARY
orSTANDBY
. Default value isPRIMARY
.- switchover
To StringRemote Peer Id (Updatable) It is applicable only when
dataguard_region_type
androle
are set, andis_dedicated
is false. It takes the OCID of the remote peer to switchover to.- timestamp String
The timestamp specified for the point-in-time clone of the source Autonomous Database. The timestamp must be in the past.
- use
Latest BooleanAvailable Backup Time Stamp Clone from latest available backup timestamp.
- vault
Id String - whitelisted
Ips List<String> (Updatable) The client IP access control list (ACL). This feature is available for autonomous databases on shared Exadata infrastructure and on Exadata Cloud@Customer. Only clients connecting from an IP address included in the ACL may access the Autonomous Database instance.
For shared Exadata infrastructure, this is an array of CIDR (Classless Inter-Domain Routing) notations for a subnet or VCN OCID. Use a semicolon (;) as a deliminator between the VCN-specific subnets or IPs. Example:
["1.1.1.1","1.1.1.0/24","ocid1.vcn.oc1.sea.<unique_id>","ocid1.vcn.oc1.sea.<unique_id1>;1.1.1.1","ocid1.vcn.oc1.sea.<unique_id2>;1.1.0.0/16"]
For Exadata Cloud@Customer, this is an array of IP addresses or CIDR (Classless Inter-Domain Routing) notations. Example:["1.1.1.1","1.1.1.0/24","1.1.2.25"]
For an update operation, if you want to delete all the IPs in the ACL, use an array with a single empty string entry.
This cannot be updated in parallel with any of the following: licenseModel, dbEdition, cpuCoreCount, computeCount, computeModel, adminPassword, isMTLSConnectionRequired, openMode, permissionLevel, dbWorkload, dbVersion, isRefreshable, dbName, scheduledOperations, dbToolsDetails, isLocalDataGuardEnabled, or isFreeTier. To remove all whitelisted IPs, set the field to a list with an empty string
[""]
.This cannot be updated in parallel with any of the following: licenseModel, dbEdition, cpuCoreCount, computeCount, computeModel, adminPassword, isMTLSConnectionRequired, openMode, permissionLevel, dbWorkload, dbVersion, isRefreshable, dbName, scheduledOperations, dbToolsDetails, isLocalDataGuardEnabled, or isFreeTier. To remove all whitelisted IPs, set the field to a list with an empty string
[""]
.
Outputs
All input properties are implicitly available as output properties. Additionally, the AutonomousDatabase resource produces the following output properties:
- Actual
Used doubleData Storage Size In Tbs The current amount of storage in use for user and system data, in terabytes (TB).
- Allocated
Storage doubleSize In Tbs The amount of storage currently allocated for the database tables and billed for, rounded up. When auto-scaling is not enabled, this value is equal to the
dataStorageSizeInTBs
value. You can compare this value to theactualUsedDataStorageSizeInTBs
value to determine if a manual shrink operation is appropriate for your allocated storage.- Apex
Details List<AutonomousDatabase Apex Detail> Information about Oracle APEX Application Development.
- Available
Upgrade List<string>Versions List of Oracle Database versions available for a database upgrade. If there are no version upgrades available, this list is empty.
- Backup
Configs List<AutonomousDatabase Backup Config> Autonomous Database configuration details for storing manual backups in the Object Storage service.
- Connection
Strings List<AutonomousDatabase Connection String> The connection string used to connect to the Autonomous Database. The username for the Service Console is ADMIN. Use the password you entered when creating the Autonomous Database for the password value.
- Connection
Urls List<AutonomousDatabase Connection Url> The URLs for accessing Oracle Application Express (APEX) and SQL Developer Web with a browser from a Compute instance within your VCN or that has a direct connection to your VCN. Note that these URLs are provided by the console only for databases on dedicated Exadata infrastructure. Example:
{"sqlDevWebUrl": "https://<hostname>/ords...", "apexUrl", "https://<hostname>/ords..."}
- Dataguard
Region stringType The Autonomous Data Guard region type of the Autonomous Database. For Autonomous Databases on shared Exadata infrastructure, Data Guard associations have designated primary and standby regions, and these region types do not change when the database changes roles. The standby regions in Data Guard associations can be the same region designated as the primary region, or they can be remote regions. Certain database administrative operations may be available only in the primary region of the Data Guard association, and cannot be performed when the database using the "primary" role is operating in a remote Data Guard standby region.
- Disaster
Recovery stringRegion Type The disaster recovery (DR) region type of the Autonomous Database. For Shared Autonomous Databases, DR associations have designated primary and standby regions. These region types do not change when the database changes roles. The standby region in DR associations can be the same region as the primary region, or they can be in a remote regions. Some database administration operations may be available only in the primary region of the DR association, and cannot be performed when the database using the primary role is operating in a remote region.
- Failed
Data intRecovery In Seconds Indicates the number of seconds of data loss for a Data Guard failover.
- Id string
The provider-assigned unique ID for this managed resource.
- In
Memory intArea In Gbs The area assigned to In-Memory tables in Autonomous Database.
- Infrastructure
Type string The infrastructure type this resource belongs to.
- Is
Preview bool Indicates if the Autonomous Database version is a preview version.
- Is
Reconnect boolClone Enabled Indicates if the refreshable clone can be reconnected to its source database.
- Is
Remote boolData Guard Enabled Indicates whether the Autonomous Database has Cross Region Data Guard enabled. Not applicable to Autonomous Databases using dedicated Exadata infrastructure or Exadata Cloud@Customer infrastructure.
- Key
History List<AutonomousEntries Database Key History Entry> Key History Entry.
- Key
Store stringId The OCID of the key store.
- Key
Store stringWallet Name The wallet name for Oracle Key Vault.
- Kms
Key stringLifecycle Details KMS key lifecycle details.
- Kms
Key stringVersion Id The OCID of the key container version that is used in database transparent data encryption (TDE) operations KMS Key can have multiple key versions. If none is specified, the current key version (latest) of the Key Id is used for the operation.
- Lifecycle
Details string Additional information about the current lifecycle state.
- Local
Disaster stringRecovery Type Indicates the local disaster recovery (DR) type of the Shared Autonomous Database. Autonomous Data Guard (ADG) DR type provides business critical DR with a faster recovery time objective (RTO) during failover or switchover. Backup-based DR type provides lower cost DR with a slower RTO during failover or switchover.
- Local
Standby List<AutonomousDbs Database Local Standby Db> Autonomous Data Guard standby database details.
- Long
Term List<AutonomousBackup Schedules Database Long Term Backup Schedule> Details for the long-term backup schedule.
- Memory
Per intOracle Compute Unit In Gbs The amount of memory (in GBs) enabled per each OCPU core in Autonomous VM Cluster.
- Next
Long stringTerm Backup Time Stamp The date and time when the next long-term backup would be created.
- Peer
Db List<string>Ids The list of OCIDs of standby databases located in Autonomous Data Guard remote regions that are associated with the source database. Note that for shared Exadata infrastructure, standby databases located in the same region as the source primary database do not have OCIDs.
- Private
Endpoint string The private endpoint for the resource.
- Provisionable
Cpuses List<double> An array of CPU values that an Autonomous Database can be scaled to.
- Refreshable
Status string The refresh status of the clone. REFRESHING indicates that the clone is currently being refreshed with data from the source Autonomous Database.
- Remote
Disaster List<AutonomousRecovery Configurations Database Remote Disaster Recovery Configuration> Configurations of a Disaster Recovery.
- Role string
The Data Guard role of the Autonomous Container Database or Autonomous Database, if Autonomous Data Guard is enabled.
- Service
Console stringUrl The URL of the Service Console for the Autonomous Database.
- Standby
Dbs List<AutonomousDatabase Standby Db> Deprecated Autonomous Data Guard standby database details.
- Supported
Regions List<string>To Clone Tos The list of regions that support the creation of an Autonomous Database clone or an Autonomous Data Guard standby database.
- Dictionary<string, object>
System tags for this resource. Each key is predefined and scoped to a namespace. For more information, see Resource Tags.
- Time
Created string The date and time the Autonomous Database was created.
- Time
Data stringGuard Role Changed The date and time the Autonomous Data Guard role was switched for the Autonomous Database. For databases that have standbys in both the primary Data Guard region and a remote Data Guard standby region, this is the latest timestamp of either the database using the "primary" role in the primary Data Guard region, or database located in the remote Data Guard standby region.
- Time
Deletion stringOf Free Autonomous Database The date and time the Always Free database will be automatically deleted because of inactivity. If the database is in the STOPPED state and without activity until this time, it will be deleted.
- Time
Disaster stringRecovery Role Changed The date and time the Disaster Recovery role was switched for the standby Autonomous Database.
- Time
Local stringData Guard Enabled The date and time that Autonomous Data Guard was enabled for an Autonomous Database where the standby was provisioned in the same region as the primary database.
- Time
Maintenance stringBegin The date and time when maintenance will begin.
- Time
Maintenance stringEnd The date and time when maintenance will end.
- Time
Of stringJoining Resource Pool - Time
Of stringLast Failover The timestamp of the last failover operation.
- Time
Of stringLast Refresh The date and time when last refresh happened.
- Time
Of stringLast Refresh Point The refresh point timestamp (UTC). The refresh point is the time to which the database was most recently refreshed. Data created after the refresh point is not included in the refresh.
- Time
Of stringLast Switchover The timestamp of the last switchover operation for the Autonomous Database.
- Time
Of stringNext Refresh The date and time of next refresh.
- Time
Reclamation stringOf Free Autonomous Database The date and time the Always Free database will be stopped because of inactivity. If this time is reached without any database activity, the database will automatically be put into the STOPPED state.
- Time
Until stringReconnect Clone Enabled The time and date as an RFC3339 formatted string, e.g., 2022-01-01T12:00:00.000Z, to set the limit for a refreshable clone to be reconnected to its source database.
- Total
Backup doubleStorage Size In Gbs The backup storage to the database.
- Used
Data intStorage Size In Gbs The storage space consumed by Autonomous Database in GBs.
- Used
Data intStorage Size In Tbs The amount of storage that has been used, in terabytes.
- Actual
Used float64Data Storage Size In Tbs The current amount of storage in use for user and system data, in terabytes (TB).
- Allocated
Storage float64Size In Tbs The amount of storage currently allocated for the database tables and billed for, rounded up. When auto-scaling is not enabled, this value is equal to the
dataStorageSizeInTBs
value. You can compare this value to theactualUsedDataStorageSizeInTBs
value to determine if a manual shrink operation is appropriate for your allocated storage.- Apex
Details []AutonomousDatabase Apex Detail Information about Oracle APEX Application Development.
- Available
Upgrade []stringVersions List of Oracle Database versions available for a database upgrade. If there are no version upgrades available, this list is empty.
- Backup
Configs []AutonomousDatabase Backup Config Autonomous Database configuration details for storing manual backups in the Object Storage service.
- Connection
Strings []AutonomousDatabase Connection String The connection string used to connect to the Autonomous Database. The username for the Service Console is ADMIN. Use the password you entered when creating the Autonomous Database for the password value.
- Connection
Urls []AutonomousDatabase Connection Url The URLs for accessing Oracle Application Express (APEX) and SQL Developer Web with a browser from a Compute instance within your VCN or that has a direct connection to your VCN. Note that these URLs are provided by the console only for databases on dedicated Exadata infrastructure. Example:
{"sqlDevWebUrl": "https://<hostname>/ords...", "apexUrl", "https://<hostname>/ords..."}
- Dataguard
Region stringType The Autonomous Data Guard region type of the Autonomous Database. For Autonomous Databases on shared Exadata infrastructure, Data Guard associations have designated primary and standby regions, and these region types do not change when the database changes roles. The standby regions in Data Guard associations can be the same region designated as the primary region, or they can be remote regions. Certain database administrative operations may be available only in the primary region of the Data Guard association, and cannot be performed when the database using the "primary" role is operating in a remote Data Guard standby region.
- Disaster
Recovery stringRegion Type The disaster recovery (DR) region type of the Autonomous Database. For Shared Autonomous Databases, DR associations have designated primary and standby regions. These region types do not change when the database changes roles. The standby region in DR associations can be the same region as the primary region, or they can be in a remote regions. Some database administration operations may be available only in the primary region of the DR association, and cannot be performed when the database using the primary role is operating in a remote region.
- Failed
Data intRecovery In Seconds Indicates the number of seconds of data loss for a Data Guard failover.
- Id string
The provider-assigned unique ID for this managed resource.
- In
Memory intArea In Gbs The area assigned to In-Memory tables in Autonomous Database.
- Infrastructure
Type string The infrastructure type this resource belongs to.
- Is
Preview bool Indicates if the Autonomous Database version is a preview version.
- Is
Reconnect boolClone Enabled Indicates if the refreshable clone can be reconnected to its source database.
- Is
Remote boolData Guard Enabled Indicates whether the Autonomous Database has Cross Region Data Guard enabled. Not applicable to Autonomous Databases using dedicated Exadata infrastructure or Exadata Cloud@Customer infrastructure.
- Key
History []AutonomousEntries Database Key History Entry Key History Entry.
- Key
Store stringId The OCID of the key store.
- Key
Store stringWallet Name The wallet name for Oracle Key Vault.
- Kms
Key stringLifecycle Details KMS key lifecycle details.
- Kms
Key stringVersion Id The OCID of the key container version that is used in database transparent data encryption (TDE) operations KMS Key can have multiple key versions. If none is specified, the current key version (latest) of the Key Id is used for the operation.
- Lifecycle
Details string Additional information about the current lifecycle state.
- Local
Disaster stringRecovery Type Indicates the local disaster recovery (DR) type of the Shared Autonomous Database. Autonomous Data Guard (ADG) DR type provides business critical DR with a faster recovery time objective (RTO) during failover or switchover. Backup-based DR type provides lower cost DR with a slower RTO during failover or switchover.
- Local
Standby []AutonomousDbs Database Local Standby Db Autonomous Data Guard standby database details.
- Long
Term []AutonomousBackup Schedules Database Long Term Backup Schedule Details for the long-term backup schedule.
- Memory
Per intOracle Compute Unit In Gbs The amount of memory (in GBs) enabled per each OCPU core in Autonomous VM Cluster.
- Next
Long stringTerm Backup Time Stamp The date and time when the next long-term backup would be created.
- Peer
Db []stringIds The list of OCIDs of standby databases located in Autonomous Data Guard remote regions that are associated with the source database. Note that for shared Exadata infrastructure, standby databases located in the same region as the source primary database do not have OCIDs.
- Private
Endpoint string The private endpoint for the resource.
- Provisionable
Cpuses []float64 An array of CPU values that an Autonomous Database can be scaled to.
- Refreshable
Status string The refresh status of the clone. REFRESHING indicates that the clone is currently being refreshed with data from the source Autonomous Database.
- Remote
Disaster []AutonomousRecovery Configurations Database Remote Disaster Recovery Configuration Configurations of a Disaster Recovery.
- Role string
The Data Guard role of the Autonomous Container Database or Autonomous Database, if Autonomous Data Guard is enabled.
- Service
Console stringUrl The URL of the Service Console for the Autonomous Database.
- Standby
Dbs []AutonomousDatabase Standby Db Deprecated Autonomous Data Guard standby database details.
- Supported
Regions []stringTo Clone Tos The list of regions that support the creation of an Autonomous Database clone or an Autonomous Data Guard standby database.
- map[string]interface{}
System tags for this resource. Each key is predefined and scoped to a namespace. For more information, see Resource Tags.
- Time
Created string The date and time the Autonomous Database was created.
- Time
Data stringGuard Role Changed The date and time the Autonomous Data Guard role was switched for the Autonomous Database. For databases that have standbys in both the primary Data Guard region and a remote Data Guard standby region, this is the latest timestamp of either the database using the "primary" role in the primary Data Guard region, or database located in the remote Data Guard standby region.
- Time
Deletion stringOf Free Autonomous Database The date and time the Always Free database will be automatically deleted because of inactivity. If the database is in the STOPPED state and without activity until this time, it will be deleted.
- Time
Disaster stringRecovery Role Changed The date and time the Disaster Recovery role was switched for the standby Autonomous Database.
- Time
Local stringData Guard Enabled The date and time that Autonomous Data Guard was enabled for an Autonomous Database where the standby was provisioned in the same region as the primary database.
- Time
Maintenance stringBegin The date and time when maintenance will begin.
- Time
Maintenance stringEnd The date and time when maintenance will end.
- Time
Of stringJoining Resource Pool - Time
Of stringLast Failover The timestamp of the last failover operation.
- Time
Of stringLast Refresh The date and time when last refresh happened.
- Time
Of stringLast Refresh Point The refresh point timestamp (UTC). The refresh point is the time to which the database was most recently refreshed. Data created after the refresh point is not included in the refresh.
- Time
Of stringLast Switchover The timestamp of the last switchover operation for the Autonomous Database.
- Time
Of stringNext Refresh The date and time of next refresh.
- Time
Reclamation stringOf Free Autonomous Database The date and time the Always Free database will be stopped because of inactivity. If this time is reached without any database activity, the database will automatically be put into the STOPPED state.
- Time
Until stringReconnect Clone Enabled The time and date as an RFC3339 formatted string, e.g., 2022-01-01T12:00:00.000Z, to set the limit for a refreshable clone to be reconnected to its source database.
- Total
Backup float64Storage Size In Gbs The backup storage to the database.
- Used
Data intStorage Size In Gbs The storage space consumed by Autonomous Database in GBs.
- Used
Data intStorage Size In Tbs The amount of storage that has been used, in terabytes.
- actual
Used DoubleData Storage Size In Tbs The current amount of storage in use for user and system data, in terabytes (TB).
- allocated
Storage DoubleSize In Tbs The amount of storage currently allocated for the database tables and billed for, rounded up. When auto-scaling is not enabled, this value is equal to the
dataStorageSizeInTBs
value. You can compare this value to theactualUsedDataStorageSizeInTBs
value to determine if a manual shrink operation is appropriate for your allocated storage.- apex
Details List<AutonomousApex Detail> Information about Oracle APEX Application Development.
- available
Upgrade List<String>Versions List of Oracle Database versions available for a database upgrade. If there are no version upgrades available, this list is empty.
- backup
Configs List<AutonomousBackup Config> Autonomous Database configuration details for storing manual backups in the Object Storage service.
- connection
Strings List<AutonomousConnection String> The connection string used to connect to the Autonomous Database. The username for the Service Console is ADMIN. Use the password you entered when creating the Autonomous Database for the password value.
- connection
Urls List<AutonomousConnection Url> The URLs for accessing Oracle Application Express (APEX) and SQL Developer Web with a browser from a Compute instance within your VCN or that has a direct connection to your VCN. Note that these URLs are provided by the console only for databases on dedicated Exadata infrastructure. Example:
{"sqlDevWebUrl": "https://<hostname>/ords...", "apexUrl", "https://<hostname>/ords..."}
- dataguard
Region StringType The Autonomous Data Guard region type of the Autonomous Database. For Autonomous Databases on shared Exadata infrastructure, Data Guard associations have designated primary and standby regions, and these region types do not change when the database changes roles. The standby regions in Data Guard associations can be the same region designated as the primary region, or they can be remote regions. Certain database administrative operations may be available only in the primary region of the Data Guard association, and cannot be performed when the database using the "primary" role is operating in a remote Data Guard standby region.
- disaster
Recovery StringRegion Type The disaster recovery (DR) region type of the Autonomous Database. For Shared Autonomous Databases, DR associations have designated primary and standby regions. These region types do not change when the database changes roles. The standby region in DR associations can be the same region as the primary region, or they can be in a remote regions. Some database administration operations may be available only in the primary region of the DR association, and cannot be performed when the database using the primary role is operating in a remote region.
- failed
Data IntegerRecovery In Seconds Indicates the number of seconds of data loss for a Data Guard failover.
- id String
The provider-assigned unique ID for this managed resource.
- in
Memory IntegerArea In Gbs The area assigned to In-Memory tables in Autonomous Database.
- infrastructure
Type String The infrastructure type this resource belongs to.
- is
Preview Boolean Indicates if the Autonomous Database version is a preview version.
- is
Reconnect BooleanClone Enabled Indicates if the refreshable clone can be reconnected to its source database.
- is
Remote BooleanData Guard Enabled Indicates whether the Autonomous Database has Cross Region Data Guard enabled. Not applicable to Autonomous Databases using dedicated Exadata infrastructure or Exadata Cloud@Customer infrastructure.
- key
History List<AutonomousEntries Key History Entry> Key History Entry.
- key
Store StringId The OCID of the key store.
- key
Store StringWallet Name The wallet name for Oracle Key Vault.
- kms
Key StringLifecycle Details KMS key lifecycle details.
- kms
Key StringVersion Id The OCID of the key container version that is used in database transparent data encryption (TDE) operations KMS Key can have multiple key versions. If none is specified, the current key version (latest) of the Key Id is used for the operation.
- lifecycle
Details String Additional information about the current lifecycle state.
- local
Disaster StringRecovery Type Indicates the local disaster recovery (DR) type of the Shared Autonomous Database. Autonomous Data Guard (ADG) DR type provides business critical DR with a faster recovery time objective (RTO) during failover or switchover. Backup-based DR type provides lower cost DR with a slower RTO during failover or switchover.
- local
Standby List<AutonomousDbs Local Standby Db> Autonomous Data Guard standby database details.
- long
Term List<AutonomousBackup Schedules Long Term Backup Schedule> Details for the long-term backup schedule.
- memory
Per IntegerOracle Compute Unit In Gbs The amount of memory (in GBs) enabled per each OCPU core in Autonomous VM Cluster.
- next
Long StringTerm Backup Time Stamp The date and time when the next long-term backup would be created.
- peer
Db List<String>Ids The list of OCIDs of standby databases located in Autonomous Data Guard remote regions that are associated with the source database. Note that for shared Exadata infrastructure, standby databases located in the same region as the source primary database do not have OCIDs.
- private
Endpoint String The private endpoint for the resource.
- provisionable
Cpuses List<Double> An array of CPU values that an Autonomous Database can be scaled to.
- refreshable
Status String The refresh status of the clone. REFRESHING indicates that the clone is currently being refreshed with data from the source Autonomous Database.
- remote
Disaster List<AutonomousRecovery Configurations Remote Disaster Recovery Configuration> Configurations of a Disaster Recovery.
- role String
The Data Guard role of the Autonomous Container Database or Autonomous Database, if Autonomous Data Guard is enabled.
- service
Console StringUrl The URL of the Service Console for the Autonomous Database.
- standby
Dbs List<AutonomousStandby Db> Deprecated Autonomous Data Guard standby database details.
- supported
Regions List<String>To Clone Tos The list of regions that support the creation of an Autonomous Database clone or an Autonomous Data Guard standby database.
- Map<String,Object>
System tags for this resource. Each key is predefined and scoped to a namespace. For more information, see Resource Tags.
- time
Created String The date and time the Autonomous Database was created.
- time
Data StringGuard Role Changed The date and time the Autonomous Data Guard role was switched for the Autonomous Database. For databases that have standbys in both the primary Data Guard region and a remote Data Guard standby region, this is the latest timestamp of either the database using the "primary" role in the primary Data Guard region, or database located in the remote Data Guard standby region.
- time
Deletion StringOf Free Autonomous Database The date and time the Always Free database will be automatically deleted because of inactivity. If the database is in the STOPPED state and without activity until this time, it will be deleted.
- time
Disaster StringRecovery Role Changed The date and time the Disaster Recovery role was switched for the standby Autonomous Database.
- time
Local StringData Guard Enabled The date and time that Autonomous Data Guard was enabled for an Autonomous Database where the standby was provisioned in the same region as the primary database.
- time
Maintenance StringBegin The date and time when maintenance will begin.
- time
Maintenance StringEnd The date and time when maintenance will end.
- time
Of StringJoining Resource Pool - time
Of StringLast Failover The timestamp of the last failover operation.
- time
Of StringLast Refresh The date and time when last refresh happened.
- time
Of StringLast Refresh Point The refresh point timestamp (UTC). The refresh point is the time to which the database was most recently refreshed. Data created after the refresh point is not included in the refresh.
- time
Of StringLast Switchover The timestamp of the last switchover operation for the Autonomous Database.
- time
Of StringNext Refresh The date and time of next refresh.
- time
Reclamation StringOf Free Autonomous Database The date and time the Always Free database will be stopped because of inactivity. If this time is reached without any database activity, the database will automatically be put into the STOPPED state.
- time
Until StringReconnect Clone Enabled The time and date as an RFC3339 formatted string, e.g., 2022-01-01T12:00:00.000Z, to set the limit for a refreshable clone to be reconnected to its source database.
- total
Backup DoubleStorage Size In Gbs The backup storage to the database.
- used
Data IntegerStorage Size In Gbs The storage space consumed by Autonomous Database in GBs.
- used
Data IntegerStorage Size In Tbs The amount of storage that has been used, in terabytes.
- actual
Used numberData Storage Size In Tbs The current amount of storage in use for user and system data, in terabytes (TB).
- allocated
Storage numberSize In Tbs The amount of storage currently allocated for the database tables and billed for, rounded up. When auto-scaling is not enabled, this value is equal to the
dataStorageSizeInTBs
value. You can compare this value to theactualUsedDataStorageSizeInTBs
value to determine if a manual shrink operation is appropriate for your allocated storage.- apex
Details AutonomousDatabase Apex Detail[] Information about Oracle APEX Application Development.
- available
Upgrade string[]Versions List of Oracle Database versions available for a database upgrade. If there are no version upgrades available, this list is empty.
- backup
Configs AutonomousDatabase Backup Config[] Autonomous Database configuration details for storing manual backups in the Object Storage service.
- connection
Strings AutonomousDatabase Connection String[] The connection string used to connect to the Autonomous Database. The username for the Service Console is ADMIN. Use the password you entered when creating the Autonomous Database for the password value.
- connection
Urls AutonomousDatabase Connection Url[] The URLs for accessing Oracle Application Express (APEX) and SQL Developer Web with a browser from a Compute instance within your VCN or that has a direct connection to your VCN. Note that these URLs are provided by the console only for databases on dedicated Exadata infrastructure. Example:
{"sqlDevWebUrl": "https://<hostname>/ords...", "apexUrl", "https://<hostname>/ords..."}
- dataguard
Region stringType The Autonomous Data Guard region type of the Autonomous Database. For Autonomous Databases on shared Exadata infrastructure, Data Guard associations have designated primary and standby regions, and these region types do not change when the database changes roles. The standby regions in Data Guard associations can be the same region designated as the primary region, or they can be remote regions. Certain database administrative operations may be available only in the primary region of the Data Guard association, and cannot be performed when the database using the "primary" role is operating in a remote Data Guard standby region.
- disaster
Recovery stringRegion Type The disaster recovery (DR) region type of the Autonomous Database. For Shared Autonomous Databases, DR associations have designated primary and standby regions. These region types do not change when the database changes roles. The standby region in DR associations can be the same region as the primary region, or they can be in a remote regions. Some database administration operations may be available only in the primary region of the DR association, and cannot be performed when the database using the primary role is operating in a remote region.
- failed
Data numberRecovery In Seconds Indicates the number of seconds of data loss for a Data Guard failover.
- id string
The provider-assigned unique ID for this managed resource.
- in
Memory numberArea In Gbs The area assigned to In-Memory tables in Autonomous Database.
- infrastructure
Type string The infrastructure type this resource belongs to.
- is
Preview boolean Indicates if the Autonomous Database version is a preview version.
- is
Reconnect booleanClone Enabled Indicates if the refreshable clone can be reconnected to its source database.
- is
Remote booleanData Guard Enabled Indicates whether the Autonomous Database has Cross Region Data Guard enabled. Not applicable to Autonomous Databases using dedicated Exadata infrastructure or Exadata Cloud@Customer infrastructure.
- key
History AutonomousEntries Database Key History Entry[] Key History Entry.
- key
Store stringId The OCID of the key store.
- key
Store stringWallet Name The wallet name for Oracle Key Vault.
- kms
Key stringLifecycle Details KMS key lifecycle details.
- kms
Key stringVersion Id The OCID of the key container version that is used in database transparent data encryption (TDE) operations KMS Key can have multiple key versions. If none is specified, the current key version (latest) of the Key Id is used for the operation.
- lifecycle
Details string Additional information about the current lifecycle state.
- local
Disaster stringRecovery Type Indicates the local disaster recovery (DR) type of the Shared Autonomous Database. Autonomous Data Guard (ADG) DR type provides business critical DR with a faster recovery time objective (RTO) during failover or switchover. Backup-based DR type provides lower cost DR with a slower RTO during failover or switchover.
- local
Standby AutonomousDbs Database Local Standby Db[] Autonomous Data Guard standby database details.
- long
Term AutonomousBackup Schedules Database Long Term Backup Schedule[] Details for the long-term backup schedule.
- memory
Per numberOracle Compute Unit In Gbs The amount of memory (in GBs) enabled per each OCPU core in Autonomous VM Cluster.
- next
Long stringTerm Backup Time Stamp The date and time when the next long-term backup would be created.
- peer
Db string[]Ids The list of OCIDs of standby databases located in Autonomous Data Guard remote regions that are associated with the source database. Note that for shared Exadata infrastructure, standby databases located in the same region as the source primary database do not have OCIDs.
- private
Endpoint string The private endpoint for the resource.
- provisionable
Cpuses number[] An array of CPU values that an Autonomous Database can be scaled to.
- refreshable
Status string The refresh status of the clone. REFRESHING indicates that the clone is currently being refreshed with data from the source Autonomous Database.
- remote
Disaster AutonomousRecovery Configurations Database Remote Disaster Recovery Configuration[] Configurations of a Disaster Recovery.
- role string
The Data Guard role of the Autonomous Container Database or Autonomous Database, if Autonomous Data Guard is enabled.
- service
Console stringUrl The URL of the Service Console for the Autonomous Database.
- standby
Dbs AutonomousDatabase Standby Db[] Deprecated Autonomous Data Guard standby database details.
- supported
Regions string[]To Clone Tos The list of regions that support the creation of an Autonomous Database clone or an Autonomous Data Guard standby database.
- {[key: string]: any}
System tags for this resource. Each key is predefined and scoped to a namespace. For more information, see Resource Tags.
- time
Created string The date and time the Autonomous Database was created.
- time
Data stringGuard Role Changed The date and time the Autonomous Data Guard role was switched for the Autonomous Database. For databases that have standbys in both the primary Data Guard region and a remote Data Guard standby region, this is the latest timestamp of either the database using the "primary" role in the primary Data Guard region, or database located in the remote Data Guard standby region.
- time
Deletion stringOf Free Autonomous Database The date and time the Always Free database will be automatically deleted because of inactivity. If the database is in the STOPPED state and without activity until this time, it will be deleted.
- time
Disaster stringRecovery Role Changed The date and time the Disaster Recovery role was switched for the standby Autonomous Database.
- time
Local stringData Guard Enabled The date and time that Autonomous Data Guard was enabled for an Autonomous Database where the standby was provisioned in the same region as the primary database.
- time
Maintenance stringBegin The date and time when maintenance will begin.
- time
Maintenance stringEnd The date and time when maintenance will end.
- time
Of stringJoining Resource Pool - time
Of stringLast Failover The timestamp of the last failover operation.
- time
Of stringLast Refresh The date and time when last refresh happened.
- time
Of stringLast Refresh Point The refresh point timestamp (UTC). The refresh point is the time to which the database was most recently refreshed. Data created after the refresh point is not included in the refresh.
- time
Of stringLast Switchover The timestamp of the last switchover operation for the Autonomous Database.
- time
Of stringNext Refresh The date and time of next refresh.
- time
Reclamation stringOf Free Autonomous Database The date and time the Always Free database will be stopped because of inactivity. If this time is reached without any database activity, the database will automatically be put into the STOPPED state.
- time
Until stringReconnect Clone Enabled The time and date as an RFC3339 formatted string, e.g., 2022-01-01T12:00:00.000Z, to set the limit for a refreshable clone to be reconnected to its source database.
- total
Backup numberStorage Size In Gbs The backup storage to the database.
- used
Data numberStorage Size In Gbs The storage space consumed by Autonomous Database in GBs.
- used
Data numberStorage Size In Tbs The amount of storage that has been used, in terabytes.
- actual_
used_ floatdata_ storage_ size_ in_ tbs The current amount of storage in use for user and system data, in terabytes (TB).
- allocated_
storage_ floatsize_ in_ tbs The amount of storage currently allocated for the database tables and billed for, rounded up. When auto-scaling is not enabled, this value is equal to the
dataStorageSizeInTBs
value. You can compare this value to theactualUsedDataStorageSizeInTBs
value to determine if a manual shrink operation is appropriate for your allocated storage.- apex_
details AutonomousDatabase Apex Detail] Information about Oracle APEX Application Development.
- available_
upgrade_ Sequence[str]versions List of Oracle Database versions available for a database upgrade. If there are no version upgrades available, this list is empty.
- backup_
configs AutonomousDatabase Backup Config] Autonomous Database configuration details for storing manual backups in the Object Storage service.
- connection_
strings AutonomousDatabase Connection String] The connection string used to connect to the Autonomous Database. The username for the Service Console is ADMIN. Use the password you entered when creating the Autonomous Database for the password value.
- connection_
urls AutonomousDatabase Connection Url] The URLs for accessing Oracle Application Express (APEX) and SQL Developer Web with a browser from a Compute instance within your VCN or that has a direct connection to your VCN. Note that these URLs are provided by the console only for databases on dedicated Exadata infrastructure. Example:
{"sqlDevWebUrl": "https://<hostname>/ords...", "apexUrl", "https://<hostname>/ords..."}
- dataguard_
region_ strtype The Autonomous Data Guard region type of the Autonomous Database. For Autonomous Databases on shared Exadata infrastructure, Data Guard associations have designated primary and standby regions, and these region types do not change when the database changes roles. The standby regions in Data Guard associations can be the same region designated as the primary region, or they can be remote regions. Certain database administrative operations may be available only in the primary region of the Data Guard association, and cannot be performed when the database using the "primary" role is operating in a remote Data Guard standby region.
- disaster_
recovery_ strregion_ type The disaster recovery (DR) region type of the Autonomous Database. For Shared Autonomous Databases, DR associations have designated primary and standby regions. These region types do not change when the database changes roles. The standby region in DR associations can be the same region as the primary region, or they can be in a remote regions. Some database administration operations may be available only in the primary region of the DR association, and cannot be performed when the database using the primary role is operating in a remote region.
- failed_
data_ intrecovery_ in_ seconds Indicates the number of seconds of data loss for a Data Guard failover.
- id str
The provider-assigned unique ID for this managed resource.
- in_
memory_ intarea_ in_ gbs The area assigned to In-Memory tables in Autonomous Database.
- infrastructure_
type str The infrastructure type this resource belongs to.
- is_
preview bool Indicates if the Autonomous Database version is a preview version.
- is_
reconnect_ boolclone_ enabled Indicates if the refreshable clone can be reconnected to its source database.
- is_
remote_ booldata_ guard_ enabled Indicates whether the Autonomous Database has Cross Region Data Guard enabled. Not applicable to Autonomous Databases using dedicated Exadata infrastructure or Exadata Cloud@Customer infrastructure.
- key_
history_ Autonomousentries Database Key History Entry] Key History Entry.
- key_
store_ strid The OCID of the key store.
- key_
store_ strwallet_ name The wallet name for Oracle Key Vault.
- kms_
key_ strlifecycle_ details KMS key lifecycle details.
- kms_
key_ strversion_ id The OCID of the key container version that is used in database transparent data encryption (TDE) operations KMS Key can have multiple key versions. If none is specified, the current key version (latest) of the Key Id is used for the operation.
- lifecycle_
details str Additional information about the current lifecycle state.
- local_
disaster_ strrecovery_ type Indicates the local disaster recovery (DR) type of the Shared Autonomous Database. Autonomous Data Guard (ADG) DR type provides business critical DR with a faster recovery time objective (RTO) during failover or switchover. Backup-based DR type provides lower cost DR with a slower RTO during failover or switchover.
- local_
standby_ Autonomousdbs Database Local Standby Db] Autonomous Data Guard standby database details.
- long_
term_ Autonomousbackup_ schedules Database Long Term Backup Schedule] Details for the long-term backup schedule.
- memory_
per_ intoracle_ compute_ unit_ in_ gbs The amount of memory (in GBs) enabled per each OCPU core in Autonomous VM Cluster.
- next_
long_ strterm_ backup_ time_ stamp The date and time when the next long-term backup would be created.
- peer_
db_ Sequence[str]ids The list of OCIDs of standby databases located in Autonomous Data Guard remote regions that are associated with the source database. Note that for shared Exadata infrastructure, standby databases located in the same region as the source primary database do not have OCIDs.
- private_
endpoint str The private endpoint for the resource.
- provisionable_
cpuses Sequence[float] An array of CPU values that an Autonomous Database can be scaled to.
- refreshable_
status str The refresh status of the clone. REFRESHING indicates that the clone is currently being refreshed with data from the source Autonomous Database.
- remote_
disaster_ Autonomousrecovery_ configurations Database Remote Disaster Recovery Configuration] Configurations of a Disaster Recovery.
- role str
The Data Guard role of the Autonomous Container Database or Autonomous Database, if Autonomous Data Guard is enabled.
- service_
console_ strurl The URL of the Service Console for the Autonomous Database.
- standby_
dbs AutonomousDatabase Standby Db] Deprecated Autonomous Data Guard standby database details.
- supported_
regions_ Sequence[str]to_ clone_ tos The list of regions that support the creation of an Autonomous Database clone or an Autonomous Data Guard standby database.
- Mapping[str, Any]
System tags for this resource. Each key is predefined and scoped to a namespace. For more information, see Resource Tags.
- time_
created str The date and time the Autonomous Database was created.
- time_
data_ strguard_ role_ changed The date and time the Autonomous Data Guard role was switched for the Autonomous Database. For databases that have standbys in both the primary Data Guard region and a remote Data Guard standby region, this is the latest timestamp of either the database using the "primary" role in the primary Data Guard region, or database located in the remote Data Guard standby region.
- time_
deletion_ strof_ free_ autonomous_ database The date and time the Always Free database will be automatically deleted because of inactivity. If the database is in the STOPPED state and without activity until this time, it will be deleted.
- time_
disaster_ strrecovery_ role_ changed The date and time the Disaster Recovery role was switched for the standby Autonomous Database.
- time_
local_ strdata_ guard_ enabled The date and time that Autonomous Data Guard was enabled for an Autonomous Database where the standby was provisioned in the same region as the primary database.
- time_
maintenance_ strbegin The date and time when maintenance will begin.
- time_
maintenance_ strend The date and time when maintenance will end.
- time_
of_ strjoining_ resource_ pool - time_
of_ strlast_ failover The timestamp of the last failover operation.
- time_
of_ strlast_ refresh The date and time when last refresh happened.
- time_
of_ strlast_ refresh_ point The refresh point timestamp (UTC). The refresh point is the time to which the database was most recently refreshed. Data created after the refresh point is not included in the refresh.
- time_
of_ strlast_ switchover The timestamp of the last switchover operation for the Autonomous Database.
- time_
of_ strnext_ refresh The date and time of next refresh.
- time_
reclamation_ strof_ free_ autonomous_ database The date and time the Always Free database will be stopped because of inactivity. If this time is reached without any database activity, the database will automatically be put into the STOPPED state.
- time_
until_ strreconnect_ clone_ enabled The time and date as an RFC3339 formatted string, e.g., 2022-01-01T12:00:00.000Z, to set the limit for a refreshable clone to be reconnected to its source database.
- total_
backup_ floatstorage_ size_ in_ gbs The backup storage to the database.
- used_
data_ intstorage_ size_ in_ gbs The storage space consumed by Autonomous Database in GBs.
- used_
data_ intstorage_ size_ in_ tbs The amount of storage that has been used, in terabytes.
- actual
Used NumberData Storage Size In Tbs The current amount of storage in use for user and system data, in terabytes (TB).
- allocated
Storage NumberSize In Tbs The amount of storage currently allocated for the database tables and billed for, rounded up. When auto-scaling is not enabled, this value is equal to the
dataStorageSizeInTBs
value. You can compare this value to theactualUsedDataStorageSizeInTBs
value to determine if a manual shrink operation is appropriate for your allocated storage.- apex
Details List<Property Map> Information about Oracle APEX Application Development.
- available
Upgrade List<String>Versions List of Oracle Database versions available for a database upgrade. If there are no version upgrades available, this list is empty.
- backup
Configs List<Property Map> Autonomous Database configuration details for storing manual backups in the Object Storage service.
- connection
Strings List<Property Map> The connection string used to connect to the Autonomous Database. The username for the Service Console is ADMIN. Use the password you entered when creating the Autonomous Database for the password value.
- connection
Urls List<Property Map> The URLs for accessing Oracle Application Express (APEX) and SQL Developer Web with a browser from a Compute instance within your VCN or that has a direct connection to your VCN. Note that these URLs are provided by the console only for databases on dedicated Exadata infrastructure. Example:
{"sqlDevWebUrl": "https://<hostname>/ords...", "apexUrl", "https://<hostname>/ords..."}
- dataguard
Region StringType The Autonomous Data Guard region type of the Autonomous Database. For Autonomous Databases on shared Exadata infrastructure, Data Guard associations have designated primary and standby regions, and these region types do not change when the database changes roles. The standby regions in Data Guard associations can be the same region designated as the primary region, or they can be remote regions. Certain database administrative operations may be available only in the primary region of the Data Guard association, and cannot be performed when the database using the "primary" role is operating in a remote Data Guard standby region.
- disaster
Recovery StringRegion Type The disaster recovery (DR) region type of the Autonomous Database. For Shared Autonomous Databases, DR associations have designated primary and standby regions. These region types do not change when the database changes roles. The standby region in DR associations can be the same region as the primary region, or they can be in a remote regions. Some database administration operations may be available only in the primary region of the DR association, and cannot be performed when the database using the primary role is operating in a remote region.
- failed
Data NumberRecovery In Seconds Indicates the number of seconds of data loss for a Data Guard failover.
- id String
The provider-assigned unique ID for this managed resource.
- in
Memory NumberArea In Gbs The area assigned to In-Memory tables in Autonomous Database.
- infrastructure
Type String The infrastructure type this resource belongs to.
- is
Preview Boolean Indicates if the Autonomous Database version is a preview version.
- is
Reconnect BooleanClone Enabled Indicates if the refreshable clone can be reconnected to its source database.
- is
Remote BooleanData Guard Enabled Indicates whether the Autonomous Database has Cross Region Data Guard enabled. Not applicable to Autonomous Databases using dedicated Exadata infrastructure or Exadata Cloud@Customer infrastructure.
- key
History List<Property Map>Entries Key History Entry.
- key
Store StringId The OCID of the key store.
- key
Store StringWallet Name The wallet name for Oracle Key Vault.
- kms
Key StringLifecycle Details KMS key lifecycle details.
- kms
Key StringVersion Id The OCID of the key container version that is used in database transparent data encryption (TDE) operations KMS Key can have multiple key versions. If none is specified, the current key version (latest) of the Key Id is used for the operation.
- lifecycle
Details String Additional information about the current lifecycle state.
- local
Disaster StringRecovery Type Indicates the local disaster recovery (DR) type of the Shared Autonomous Database. Autonomous Data Guard (ADG) DR type provides business critical DR with a faster recovery time objective (RTO) during failover or switchover. Backup-based DR type provides lower cost DR with a slower RTO during failover or switchover.
- local
Standby List<Property Map>Dbs Autonomous Data Guard standby database details.
- long
Term List<Property Map>Backup Schedules Details for the long-term backup schedule.
- memory
Per NumberOracle Compute Unit In Gbs The amount of memory (in GBs) enabled per each OCPU core in Autonomous VM Cluster.
- next
Long StringTerm Backup Time Stamp The date and time when the next long-term backup would be created.
- peer
Db List<String>Ids The list of OCIDs of standby databases located in Autonomous Data Guard remote regions that are associated with the source database. Note that for shared Exadata infrastructure, standby databases located in the same region as the source primary database do not have OCIDs.
- private
Endpoint String The private endpoint for the resource.
- provisionable
Cpuses List<Number> An array of CPU values that an Autonomous Database can be scaled to.
- refreshable
Status String The refresh status of the clone. REFRESHING indicates that the clone is currently being refreshed with data from the source Autonomous Database.
- remote
Disaster List<Property Map>Recovery Configurations Configurations of a Disaster Recovery.
- role String
The Data Guard role of the Autonomous Container Database or Autonomous Database, if Autonomous Data Guard is enabled.
- service
Console StringUrl The URL of the Service Console for the Autonomous Database.
- standby
Dbs List<Property Map> Deprecated Autonomous Data Guard standby database details.
- supported
Regions List<String>To Clone Tos The list of regions that support the creation of an Autonomous Database clone or an Autonomous Data Guard standby database.
- Map<Any>
System tags for this resource. Each key is predefined and scoped to a namespace. For more information, see Resource Tags.
- time
Created String The date and time the Autonomous Database was created.
- time
Data StringGuard Role Changed The date and time the Autonomous Data Guard role was switched for the Autonomous Database. For databases that have standbys in both the primary Data Guard region and a remote Data Guard standby region, this is the latest timestamp of either the database using the "primary" role in the primary Data Guard region, or database located in the remote Data Guard standby region.
- time
Deletion StringOf Free Autonomous Database The date and time the Always Free database will be automatically deleted because of inactivity. If the database is in the STOPPED state and without activity until this time, it will be deleted.
- time
Disaster StringRecovery Role Changed The date and time the Disaster Recovery role was switched for the standby Autonomous Database.
- time
Local StringData Guard Enabled The date and time that Autonomous Data Guard was enabled for an Autonomous Database where the standby was provisioned in the same region as the primary database.
- time
Maintenance StringBegin The date and time when maintenance will begin.
- time
Maintenance StringEnd The date and time when maintenance will end.
- time
Of StringJoining Resource Pool - time
Of StringLast Failover The timestamp of the last failover operation.
- time
Of StringLast Refresh The date and time when last refresh happened.
- time
Of StringLast Refresh Point The refresh point timestamp (UTC). The refresh point is the time to which the database was most recently refreshed. Data created after the refresh point is not included in the refresh.
- time
Of StringLast Switchover The timestamp of the last switchover operation for the Autonomous Database.
- time
Of StringNext Refresh The date and time of next refresh.
- time
Reclamation StringOf Free Autonomous Database The date and time the Always Free database will be stopped because of inactivity. If this time is reached without any database activity, the database will automatically be put into the STOPPED state.
- time
Until StringReconnect Clone Enabled The time and date as an RFC3339 formatted string, e.g., 2022-01-01T12:00:00.000Z, to set the limit for a refreshable clone to be reconnected to its source database.
- total
Backup NumberStorage Size In Gbs The backup storage to the database.
- used
Data NumberStorage Size In Gbs The storage space consumed by Autonomous Database in GBs.
- used
Data NumberStorage Size In Tbs The amount of storage that has been used, in terabytes.
Look up Existing AutonomousDatabase Resource
Get an existing AutonomousDatabase resource’s state with the given name, ID, and optional extra properties used to qualify the lookup.
public static get(name: string, id: Input<ID>, state?: AutonomousDatabaseState, opts?: CustomResourceOptions): AutonomousDatabase
@staticmethod
def get(resource_name: str,
id: str,
opts: Optional[ResourceOptions] = None,
actual_used_data_storage_size_in_tbs: Optional[float] = None,
admin_password: Optional[str] = None,
allocated_storage_size_in_tbs: Optional[float] = None,
apex_details: Optional[Sequence[_database.AutonomousDatabaseApexDetailArgs]] = None,
are_primary_whitelisted_ips_used: Optional[bool] = None,
autonomous_container_database_id: Optional[str] = None,
autonomous_database_backup_id: Optional[str] = None,
autonomous_database_id: Optional[str] = None,
autonomous_maintenance_schedule_type: Optional[str] = None,
available_upgrade_versions: Optional[Sequence[str]] = None,
backup_configs: Optional[Sequence[_database.AutonomousDatabaseBackupConfigArgs]] = None,
backup_retention_period_in_days: Optional[int] = None,
character_set: Optional[str] = None,
clone_type: Optional[str] = None,
compartment_id: Optional[str] = None,
compute_count: Optional[float] = None,
compute_model: Optional[str] = None,
connection_strings: Optional[Sequence[_database.AutonomousDatabaseConnectionStringArgs]] = None,
connection_urls: Optional[Sequence[_database.AutonomousDatabaseConnectionUrlArgs]] = None,
cpu_core_count: Optional[int] = None,
customer_contacts: Optional[Sequence[_database.AutonomousDatabaseCustomerContactArgs]] = None,
data_safe_status: Optional[str] = None,
data_storage_size_in_gb: Optional[int] = None,
data_storage_size_in_tbs: Optional[int] = None,
database_edition: Optional[str] = None,
database_management_status: Optional[str] = None,
dataguard_region_type: Optional[str] = None,
db_name: Optional[str] = None,
db_version: Optional[str] = None,
db_workload: Optional[str] = None,
defined_tags: Optional[Mapping[str, Any]] = None,
disaster_recovery_region_type: Optional[str] = None,
display_name: Optional[str] = None,
failed_data_recovery_in_seconds: Optional[int] = None,
freeform_tags: Optional[Mapping[str, Any]] = None,
in_memory_area_in_gbs: Optional[int] = None,
in_memory_percentage: Optional[int] = None,
infrastructure_type: Optional[str] = None,
is_access_control_enabled: Optional[bool] = None,
is_auto_scaling_enabled: Optional[bool] = None,
is_auto_scaling_for_storage_enabled: Optional[bool] = None,
is_data_guard_enabled: Optional[bool] = None,
is_dedicated: Optional[bool] = None,
is_free_tier: Optional[bool] = None,
is_local_data_guard_enabled: Optional[bool] = None,
is_mtls_connection_required: Optional[bool] = None,
is_preview: Optional[bool] = None,
is_preview_version_with_service_terms_accepted: Optional[bool] = None,
is_reconnect_clone_enabled: Optional[bool] = None,
is_refreshable_clone: Optional[bool] = None,
is_remote_data_guard_enabled: Optional[bool] = None,
is_shrink_only: Optional[bool] = None,
key_history_entries: Optional[Sequence[_database.AutonomousDatabaseKeyHistoryEntryArgs]] = None,
key_store_id: Optional[str] = None,
key_store_wallet_name: Optional[str] = None,
kms_key_id: Optional[str] = None,
kms_key_lifecycle_details: Optional[str] = None,
kms_key_version_id: Optional[str] = None,
license_model: Optional[str] = None,
lifecycle_details: Optional[str] = None,
local_adg_auto_failover_max_data_loss_limit: Optional[int] = None,
local_disaster_recovery_type: Optional[str] = None,
local_standby_dbs: Optional[Sequence[_database.AutonomousDatabaseLocalStandbyDbArgs]] = None,
long_term_backup_schedules: Optional[Sequence[_database.AutonomousDatabaseLongTermBackupScheduleArgs]] = None,
max_cpu_core_count: Optional[int] = None,
memory_per_oracle_compute_unit_in_gbs: Optional[int] = None,
ncharacter_set: Optional[str] = None,
next_long_term_backup_time_stamp: Optional[str] = None,
nsg_ids: Optional[Sequence[str]] = None,
ocpu_count: Optional[float] = None,
open_mode: Optional[str] = None,
operations_insights_status: Optional[str] = None,
peer_db_ids: Optional[Sequence[str]] = None,
permission_level: Optional[str] = None,
private_endpoint: Optional[str] = None,
private_endpoint_ip: Optional[str] = None,
private_endpoint_label: Optional[str] = None,
provisionable_cpuses: Optional[Sequence[float]] = None,
refreshable_mode: Optional[str] = None,
refreshable_status: Optional[str] = None,
remote_disaster_recovery_configurations: Optional[Sequence[_database.AutonomousDatabaseRemoteDisasterRecoveryConfigurationArgs]] = None,
remote_disaster_recovery_type: Optional[str] = None,
resource_pool_leader_id: Optional[str] = None,
resource_pool_summary: Optional[_database.AutonomousDatabaseResourcePoolSummaryArgs] = None,
role: Optional[str] = None,
rotate_key_trigger: Optional[bool] = None,
scheduled_operations: Optional[Sequence[_database.AutonomousDatabaseScheduledOperationArgs]] = None,
secret_id: Optional[str] = None,
secret_version_number: Optional[int] = None,
service_console_url: Optional[str] = None,
source: Optional[str] = None,
source_id: Optional[str] = None,
standby_dbs: Optional[Sequence[_database.AutonomousDatabaseStandbyDbArgs]] = None,
standby_whitelisted_ips: Optional[Sequence[str]] = None,
state: Optional[str] = None,
subnet_id: Optional[str] = None,
supported_regions_to_clone_tos: Optional[Sequence[str]] = None,
switchover_to: Optional[str] = None,
switchover_to_remote_peer_id: Optional[str] = None,
system_tags: Optional[Mapping[str, Any]] = None,
time_created: Optional[str] = None,
time_data_guard_role_changed: Optional[str] = None,
time_deletion_of_free_autonomous_database: Optional[str] = None,
time_disaster_recovery_role_changed: Optional[str] = None,
time_local_data_guard_enabled: Optional[str] = None,
time_maintenance_begin: Optional[str] = None,
time_maintenance_end: Optional[str] = None,
time_of_joining_resource_pool: Optional[str] = None,
time_of_last_failover: Optional[str] = None,
time_of_last_refresh: Optional[str] = None,
time_of_last_refresh_point: Optional[str] = None,
time_of_last_switchover: Optional[str] = None,
time_of_next_refresh: Optional[str] = None,
time_reclamation_of_free_autonomous_database: Optional[str] = None,
time_until_reconnect_clone_enabled: Optional[str] = None,
timestamp: Optional[str] = None,
total_backup_storage_size_in_gbs: Optional[float] = None,
use_latest_available_backup_time_stamp: Optional[bool] = None,
used_data_storage_size_in_gbs: Optional[int] = None,
used_data_storage_size_in_tbs: Optional[int] = None,
vault_id: Optional[str] = None,
whitelisted_ips: Optional[Sequence[str]] = None) -> AutonomousDatabase
func GetAutonomousDatabase(ctx *Context, name string, id IDInput, state *AutonomousDatabaseState, opts ...ResourceOption) (*AutonomousDatabase, error)
public static AutonomousDatabase Get(string name, Input<string> id, AutonomousDatabaseState? state, CustomResourceOptions? opts = null)
public static AutonomousDatabase get(String name, Output<String> id, AutonomousDatabaseState state, CustomResourceOptions options)
Resource lookup is not supported in YAML
- name
- The unique name of the resulting resource.
- id
- The unique provider ID of the resource to lookup.
- state
- Any extra arguments used during the lookup.
- opts
- A bag of options that control this resource's behavior.
- resource_name
- The unique name of the resulting resource.
- id
- The unique provider ID of the resource to lookup.
- name
- The unique name of the resulting resource.
- id
- The unique provider ID of the resource to lookup.
- state
- Any extra arguments used during the lookup.
- opts
- A bag of options that control this resource's behavior.
- name
- The unique name of the resulting resource.
- id
- The unique provider ID of the resource to lookup.
- state
- Any extra arguments used during the lookup.
- opts
- A bag of options that control this resource's behavior.
- name
- The unique name of the resulting resource.
- id
- The unique provider ID of the resource to lookup.
- state
- Any extra arguments used during the lookup.
- opts
- A bag of options that control this resource's behavior.
- Actual
Used doubleData Storage Size In Tbs The current amount of storage in use for user and system data, in terabytes (TB).
- Admin
Password string (Updatable) The password must be between 12 and 30 characters long, and must contain at least 1 uppercase, 1 lowercase, and 1 numeric character. It cannot contain the double quote symbol (") or the username "admin", regardless of casing. The password is mandatory if source value is "BACKUP_FROM_ID", "BACKUP_FROM_TIMESTAMP", "DATABASE" or "NONE".
- Allocated
Storage doubleSize In Tbs The amount of storage currently allocated for the database tables and billed for, rounded up. When auto-scaling is not enabled, this value is equal to the
dataStorageSizeInTBs
value. You can compare this value to theactualUsedDataStorageSizeInTBs
value to determine if a manual shrink operation is appropriate for your allocated storage.- Apex
Details List<AutonomousDatabase Apex Detail> Information about Oracle APEX Application Development.
- Are
Primary boolWhitelisted Ips Used (Updatable) This field will be null if the Autonomous Database is not Data Guard enabled or Access Control is disabled. It's value would be
TRUE
if Autonomous Database is Data Guard enabled and Access Control is enabled and if the Autonomous Database uses primary IP access control list (ACL) for standby. It's value would beFALSE
if Autonomous Database is Data Guard enabled and Access Control is enabled and if the Autonomous Database uses different IP access control list (ACL) for standby compared to primary.- Autonomous
Container stringDatabase Id The Autonomous Container Database OCID.
- Autonomous
Database stringBackup Id The OCID of the source Autonomous Database Backup that you will clone to create a new Autonomous Database.
- Autonomous
Database stringId The OCID of the source Autonomous Database that you will clone to create a new Autonomous Database.
- Autonomous
Maintenance stringSchedule Type The maintenance schedule type of the Autonomous Database on shared Exadata infrastructure. The EARLY maintenance schedule of this Autonomous Database follows a schedule that applies patches prior to the REGULAR schedule.The REGULAR maintenance schedule of this Autonomous Database follows the normal cycle.
- Available
Upgrade List<string>Versions List of Oracle Database versions available for a database upgrade. If there are no version upgrades available, this list is empty.
- Backup
Configs List<AutonomousDatabase Backup Config> Autonomous Database configuration details for storing manual backups in the Object Storage service.
- Backup
Retention intPeriod In Days (Updatable) Retention period, in days, for backups.
- Character
Set string The character set for the autonomous database. The default is AL32UTF8. Allowed values for an Autonomous Database on shared infrastructure as as returned by List Autonomous Database Character Sets
For an Autonomous Database on dedicated infrastructure, the allowed values are:
AL32UTF8, AR8ADOS710, AR8ADOS720, AR8APTEC715, AR8ARABICMACS, AR8ASMO8X, AR8ISO8859P6, AR8MSWIN1256, AR8MUSSAD768, AR8NAFITHA711, AR8NAFITHA721, AR8SAKHR706, AR8SAKHR707, AZ8ISO8859P9E, BG8MSWIN, BG8PC437S, BLT8CP921, BLT8ISO8859P13, BLT8MSWIN1257, BLT8PC775, BN8BSCII, CDN8PC863, CEL8ISO8859P14, CL8ISO8859P5, CL8ISOIR111, CL8KOI8R, CL8KOI8U, CL8MACCYRILLICS, CL8MSWIN1251, EE8ISO8859P2, EE8MACCES, EE8MACCROATIANS, EE8MSWIN1250, EE8PC852, EL8DEC, EL8ISO8859P7, EL8MACGREEKS, EL8MSWIN1253, EL8PC437S, EL8PC851, EL8PC869, ET8MSWIN923, HU8ABMOD, HU8CWI2, IN8ISCII, IS8PC861, IW8ISO8859P8, IW8MACHEBREWS, IW8MSWIN1255, IW8PC1507, JA16EUC, JA16EUCTILDE, JA16SJIS, JA16SJISTILDE, JA16VMS, KO16KSC5601, KO16KSCCS, KO16MSWIN949, LA8ISO6937, LA8PASSPORT, LT8MSWIN921, LT8PC772, LT8PC774, LV8PC1117, LV8PC8LR, LV8RST104090, N8PC865, NE8ISO8859P10, NEE8ISO8859P4, RU8BESTA, RU8PC855, RU8PC866, SE8ISO8859P3, TH8MACTHAIS, TH8TISASCII, TR8DEC, TR8MACTURKISHS, TR8MSWIN1254, TR8PC857, US7ASCII, US8PC437, UTF8, VN8MSWIN1258, VN8VN3, WE8DEC, WE8DG, WE8ISO8859P1, WE8ISO8859P15, WE8ISO8859P9, WE8MACROMAN8S, WE8MSWIN1252, WE8NCR4970, WE8NEXTSTEP, WE8PC850, WE8PC858, WE8PC860, WE8ROMAN8, ZHS16CGB231280, ZHS16GBK, ZHT16BIG5, ZHT16CCDC, ZHT16DBT, ZHT16HKSCS, ZHT16MSWIN950, ZHT32EUC, ZHT32SOPS, ZHT32TRIS
- Clone
Type string The Autonomous Database clone type.
- Compartment
Id string (Updatable) The OCID of the compartment of the Autonomous Database.
- Compute
Count double (Updatable) The compute amount available to the database. Minimum and maximum values depend on the compute model and whether the database is on Shared or Dedicated infrastructure. For an Autonomous Database on Shared infrastructure, the 'ECPU' compute model requires values in multiples of two. Required when using the
computeModel
parameter. When usingcpuCoreCount
parameter, it is an error to specify computeCount to a non-null value.- Compute
Model string (Updatable) The compute model of the Autonomous Database. This is required if using the
computeCount
parameter. If usingcpuCoreCount
then it is an error to specifycomputeModel
to a non-null value.- Connection
Strings List<AutonomousDatabase Connection String> The connection string used to connect to the Autonomous Database. The username for the Service Console is ADMIN. Use the password you entered when creating the Autonomous Database for the password value.
- Connection
Urls List<AutonomousDatabase Connection Url> The URLs for accessing Oracle Application Express (APEX) and SQL Developer Web with a browser from a Compute instance within your VCN or that has a direct connection to your VCN. Note that these URLs are provided by the console only for databases on dedicated Exadata infrastructure. Example:
{"sqlDevWebUrl": "https://<hostname>/ords...", "apexUrl", "https://<hostname>/ords..."}
- Cpu
Core intCount (Updatable) The number of OCPU cores to be made available to the database. For Autonomous Databases on dedicated Exadata infrastructure, the maximum number of cores is determined by the infrastructure shape. See Characteristics of Infrastructure Shapes for shape details. Note: This parameter cannot be used with the
ocpuCount
parameter. This input is ignored for Always Free resources.- The data type must be an integer.
- The minimum number of cores for all types of autonomous database is 1
- The maximum number of cores is as follows:
- Autonomous Databases on shared Exadata infrastructure: The maximum number of cores is 128.
- Autonomous Databases on dedicated Exadata infrastructure: The maximum number of cores is determined by the infrastructure shape. See Characteristics of Infrastructure Shapes for shape details.
- Customer
Contacts List<AutonomousDatabase Customer Contact> (Updatable) Customer Contacts.
- Data
Safe stringStatus (Updatable) Status of the Data Safe registration for this Autonomous Database. Could be REGISTERED or NOT_REGISTERED.
- Data
Storage intSize In Gb (Updatable) The size, in gigabytes, of the data volume that will be created and attached to the database. This storage can later be scaled up if needed. The maximum storage value is determined by the infrastructure shape. See Characteristics of Infrastructure Shapes for shape details.
Notes
- This parameter is only supported for dedicated Exadata infrastructure.
- This parameter cannot be used with the
dataStorageSizeInTBs
parameter.
- Data
Storage intSize In Tbs (Updatable) The size, in terabytes, of the data volume that will be created and attached to the database. This storage can later be scaled up if needed. For Autonomous Databases on dedicated Exadata infrastructure, the maximum storage value is determined by the infrastructure shape. See Characteristics of Infrastructure Shapes for shape details. A full Exadata service is allocated when the Autonomous Database size is set to the upper limit (384 TB).
Note: This parameter cannot be used with the
dataStorageSizeInGBs
parameter. This input is ignored for Always Free resources.- Database
Edition string (Updatable) The Oracle Database Edition that applies to the Autonomous databases.
- Database
Management stringStatus Status of Database Management for this Autonomous Database.
- Dataguard
Region stringType The Autonomous Data Guard region type of the Autonomous Database. For Autonomous Databases on shared Exadata infrastructure, Data Guard associations have designated primary and standby regions, and these region types do not change when the database changes roles. The standby regions in Data Guard associations can be the same region designated as the primary region, or they can be remote regions. Certain database administrative operations may be available only in the primary region of the Data Guard association, and cannot be performed when the database using the "primary" role is operating in a remote Data Guard standby region.
- Db
Name string (Updatable) Specify the database name; it must consist of letters and numbers only. The maximum length is 30 characters. The same database name cannot be used for multiple Autonomous Databases in the same tenancy in the same region.
- Db
Version string (Updatable) A valid Oracle Database version for Autonomous Database.
db_workload
AJD and APEX are only supported fordb_version
19c
and above.- Db
Workload string (Updatable) The Autonomous Database workload type. The following values are valid:
- OLTP - indicates an Autonomous Transaction Processing database
- DW - indicates an Autonomous Data Warehouse database
- AJD - indicates an Autonomous JSON Database
- APEX - indicates an Autonomous Database with the Oracle APEX Application Development workload type.
This cannot be updated in parallel with any of the following: licenseModel, dbEdition, cpuCoreCount, computeCount, computeModel, adminPassword, whitelistedIps, isMTLSConnectionRequired, privateEndpointLabel, nsgIds, dbVersion, isRefreshable, dbName, scheduledOperations, dbToolsDetails, isLocalDataGuardEnabled, or isFreeTier. *Note:
db_workload
can only be updated from AJD to OLTP or from a free OLTP to AJD.- Dictionary<string, object>
(Updatable) Defined tags for this resource. Each key is predefined and scoped to a namespace. For more information, see Resource Tags.
- Disaster
Recovery stringRegion Type The disaster recovery (DR) region type of the Autonomous Database. For Shared Autonomous Databases, DR associations have designated primary and standby regions. These region types do not change when the database changes roles. The standby region in DR associations can be the same region as the primary region, or they can be in a remote regions. Some database administration operations may be available only in the primary region of the DR association, and cannot be performed when the database using the primary role is operating in a remote region.
- Display
Name string (Updatable) The user-friendly name for the Autonomous Database. The name does not have to be unique.
- Failed
Data intRecovery In Seconds Indicates the number of seconds of data loss for a Data Guard failover.
- Dictionary<string, object>
(Updatable) Free-form tags for this resource. Each tag is a simple key-value pair with no predefined name, type, or namespace. For more information, see Resource Tags. Example:
{"Department": "Finance"}
- In
Memory intArea In Gbs The area assigned to In-Memory tables in Autonomous Database.
- In
Memory intPercentage (Updatable) The percentage of the System Global Area(SGA) assigned to In-Memory tables in Autonomous Database.
- Infrastructure
Type string The infrastructure type this resource belongs to.
- Is
Access boolControl Enabled (Updatable) Indicates if the database-level access control is enabled. If disabled, database access is defined by the network security rules. If enabled, database access is restricted to the IP addresses defined by the rules specified with the
whitelistedIps
property. While specifyingwhitelistedIps
rules is optional, if database-level access control is enabled and no rules are specified, the database will become inaccessible. The rules can be added later using theUpdateAutonomousDatabase
API operation or edit option in console. When creating a database clone, the desired access control setting should be specified. By default, database-level access control will be disabled for the clone.This property is applicable only to Autonomous Databases on the Exadata Cloud@Customer platform.
- Is
Auto boolScaling Enabled (Updatable) Indicates if auto scaling is enabled for the Autonomous Database OCPU core count. The default value is
FALSE
.- Is
Auto boolScaling For Storage Enabled (Updatable) Indicates if auto scaling is enabled for the Autonomous Database storage. The default value is
FALSE
.- Is
Data boolGuard Enabled (Updatable) Deprecated. Indicates whether the Autonomous Database has local (in-region) Data Guard enabled. Not applicable to cross-region Autonomous Data Guard associations, or to Autonomous Databases using dedicated Exadata infrastructure or Exadata Cloud@Customer infrastructure.
- Is
Dedicated bool True if the database is on dedicated Exadata infrastructure.
- Is
Free boolTier (Updatable) Indicates if this is an Always Free resource. The default value is false. Note that Always Free Autonomous Databases have 1 CPU and 20GB of memory. For Always Free databases, memory and CPU cannot be scaled. When
db_workload
isAJD
orAPEX
it cannot betrue
.- Is
Local boolData Guard Enabled (Updatable) Indicates whether the Autonomous Database has local (in-region) Data Guard enabled. Not applicable to cross-region Autonomous Data Guard associations, or to Autonomous Databases using dedicated Exadata infrastructure or Exadata Cloud@Customer infrastructure.
- Is
Mtls boolConnection Required (Updatable) Indicates whether the Autonomous Database requires mTLS connections.
- Is
Preview bool Indicates if the Autonomous Database version is a preview version.
- Is
Preview boolVersion With Service Terms Accepted If set to
TRUE
, indicates that an Autonomous Database preview version is being provisioned, and that the preview version's terms of service have been accepted. Note that preview version software is only available for databases on shared Exadata infrastructure.- Is
Reconnect boolClone Enabled Indicates if the refreshable clone can be reconnected to its source database.
- Is
Refreshable boolClone (Updatable) True for creating a refreshable clone and False for detaching the clone from source Autonomous Database. Detaching is one time operation and clone becomes a regular Autonomous Database.
- Is
Remote boolData Guard Enabled Indicates whether the Autonomous Database has Cross Region Data Guard enabled. Not applicable to Autonomous Databases using dedicated Exadata infrastructure or Exadata Cloud@Customer infrastructure.
- Is
Shrink boolOnly (Updatable) An optional property when enabled triggers the Shrinking of Autonomous Database once. To trigger Shrinking of ADB once again, this flag needs to be disabled and re-enabled again. It should not be passed during create database operation. It is only applicable on shared databases i.e. where
is_dedicated
is false.** IMPORTANT ** Any change to a property that does not support update will force the destruction and recreation of the resource with the new property values
- Key
History List<AutonomousEntries Database Key History Entry> Key History Entry.
- Key
Store stringId The OCID of the key store.
- Key
Store stringWallet Name The wallet name for Oracle Key Vault.
- Kms
Key stringId The OCID of the key container that is used as the master encryption key in database transparent data encryption (TDE) operations.
- Kms
Key stringLifecycle Details KMS key lifecycle details.
- Kms
Key stringVersion Id The OCID of the key container version that is used in database transparent data encryption (TDE) operations KMS Key can have multiple key versions. If none is specified, the current key version (latest) of the Key Id is used for the operation.
- License
Model string (Updatable) The Oracle license model that applies to the Oracle Autonomous Database. Bring your own license (BYOL) allows you to apply your current on-premises Oracle software licenses to equivalent, highly automated Oracle PaaS and IaaS services in the cloud. License Included allows you to subscribe to new Oracle Database software licenses and the Database service. Note that when provisioning an Autonomous Database on dedicated Exadata infrastructure, this attribute must be null because the attribute is already set at the Autonomous Exadata Infrastructure level. When using shared Exadata infrastructure, if a value is not specified, the system will supply the value of
BRING_YOUR_OWN_LICENSE
. It is a required field whendb_workload
is AJD and needs to be set toLICENSE_INCLUDED
as AJD does not support defaultlicense_model
valueBRING_YOUR_OWN_LICENSE
.- Lifecycle
Details string Additional information about the current lifecycle state.
- Local
Adg intAuto Failover Max Data Loss Limit Parameter that allows users to select an acceptable maximum data loss limit in seconds, up to which Automatic Failover will be triggered when necessary for a Local Autonomous Data Guard
- Local
Disaster stringRecovery Type Indicates the local disaster recovery (DR) type of the Shared Autonomous Database. Autonomous Data Guard (ADG) DR type provides business critical DR with a faster recovery time objective (RTO) during failover or switchover. Backup-based DR type provides lower cost DR with a slower RTO during failover or switchover.
- Local
Standby List<AutonomousDbs Database Local Standby Db> Autonomous Data Guard standby database details.
- Long
Term List<AutonomousBackup Schedules Database Long Term Backup Schedule> Details for the long-term backup schedule.
- Max
Cpu intCore Count (Updatable) The number of Max OCPU cores to be made available to the autonomous database with auto scaling of cpu enabled.
- Memory
Per intOracle Compute Unit In Gbs The amount of memory (in GBs) enabled per each OCPU core in Autonomous VM Cluster.
- Ncharacter
Set string The national character set for the autonomous database. The default is AL16UTF16. Allowed values are: AL16UTF16 or UTF8.
- Next
Long stringTerm Backup Time Stamp The date and time when the next long-term backup would be created.
- Nsg
Ids List<string> (Updatable) The list of OCIDs for the network security groups (NSGs) to which this resource belongs. Setting this to an empty list removes all resources from all NSGs. For more information about NSGs, see Security Rules. NsgIds restrictions:
- A network security group (NSG) is optional for Autonomous Databases with private access. The nsgIds list can be empty.
- Ocpu
Count double (Updatable) The number of OCPU cores to be made available to the database.
The following points apply:
- For Autonomous Databases on dedicated Exadata infrastructure, to provision less than 1 core, enter a fractional value in an increment of 0.1. For example, you can provision 0.3 or 0.4 cores, but not 0.35 cores. (Note that fractional OCPU values are not supported for Autonomous Databasese on shared Exadata infrastructure.)
- To provision 1 or more cores, you must enter an integer between 1 and the maximum number of cores available for the infrastructure shape. For example, you can provision 2 cores or 3 cores, but not 2.5 cores. This applies to Autonomous Databases on both shared and dedicated Exadata infrastructure.
For Autonomous Databases on dedicated Exadata infrastructure, the maximum number of cores is determined by the infrastructure shape. See Characteristics of Infrastructure Shapes for shape details.
Note: This parameter cannot be used with the
cpuCoreCount
parameter.- Open
Mode string Indicates the Autonomous Database mode. The database can be opened in
READ_ONLY
orREAD_WRITE
mode.- Operations
Insights stringStatus (Updatable) Status of Operations Insights for this Autonomous Database. Values supported are
ENABLED
andNOT_ENABLED
- Peer
Db List<string>Ids The list of OCIDs of standby databases located in Autonomous Data Guard remote regions that are associated with the source database. Note that for shared Exadata infrastructure, standby databases located in the same region as the source primary database do not have OCIDs.
- Permission
Level string The Autonomous Database permission level. Restricted mode allows access only by admin users.
- Private
Endpoint string The private endpoint for the resource.
- Private
Endpoint stringIp The private endpoint Ip address for the resource.
- Private
Endpoint stringLabel (Updatable) The private endpoint label for the resource.
- Provisionable
Cpuses List<double> An array of CPU values that an Autonomous Database can be scaled to.
- Refreshable
Mode string (Updatable) The refresh mode of the clone. AUTOMATIC indicates that the clone is automatically being refreshed with data from the source Autonomous Database.
- Refreshable
Status string The refresh status of the clone. REFRESHING indicates that the clone is currently being refreshed with data from the source Autonomous Database.
- Remote
Disaster List<AutonomousRecovery Configurations Database Remote Disaster Recovery Configuration> Configurations of a Disaster Recovery.
- Remote
Disaster stringRecovery Type Indicates the cross-region disaster recovery (DR) type of the standby Shared Autonomous Database. Autonomous Data Guard (ADG) DR type provides business critical DR with a faster recovery time objective (RTO) during failover or switchover. Backup-based DR type provides lower cost DR with a slower RTO during failover or switchover.
- Resource
Pool stringLeader Id - Resource
Pool AutonomousSummary Database Resource Pool Summary - Role string
The Data Guard role of the Autonomous Container Database or Autonomous Database, if Autonomous Data Guard is enabled.
- Rotate
Key boolTrigger (Updatable) An optional property when flipped triggers rotation of KMS key. It is only applicable on dedicated databases i.e. where
is_dedicated
is true.- Scheduled
Operations List<AutonomousDatabase Scheduled Operation> (Updatable) The list of scheduled operations.
This cannot be updated in parallel with any of the following: licenseModel, dbEdition, cpuCoreCount, computeCount, computeModel, whitelistedIps, isMTLSConnectionRequired, openMode, permissionLevel, dbWorkload, privateEndpointLabel, nsgIds, dbVersion, isRefreshable, dbName, dbToolsDetails, isLocalDataGuardEnabled, or isFreeTier.
- Secret
Id string (Updatable) The Oracle Cloud Infrastructure vault secret [/Content/General/Concepts/identifiers.htm]OCID.
- Secret
Version intNumber (Updatable) The version of the vault secret. If no version is specified, the latest version will be used.
- Service
Console stringUrl The URL of the Service Console for the Autonomous Database.
- Source string
The source of the database: Use
NONE
for creating a new Autonomous Database. UseDATABASE
for creating a new Autonomous Database by cloning an existing Autonomous Database. UseCROSS_REGION_DATAGUARD
to create a standby Data Guard database in another region.For Autonomous Databases on shared Exadata infrastructure, the following cloning options are available: Use
BACKUP_FROM_ID
for creating a new Autonomous Database from a specified backup. UseBACKUP_FROM_TIMESTAMP
for creating a point-in-time Autonomous Database clone using backups. For more information, see Cloning and Moving an Autonomous Database.- Source
Id string The OCID of the source Autonomous Database that will be used to create a new standby database for the Data Guard association.
- Standby
Dbs List<AutonomousDatabase Standby Db> Deprecated Autonomous Data Guard standby database details.
- Standby
Whitelisted List<string>Ips (Updatable) The client IP access control list (ACL). This feature is available for autonomous databases on shared Exadata infrastructure and on Exadata Cloud@Customer. Only clients connecting from an IP address included in the ACL may access the Autonomous Database instance.
For shared Exadata infrastructure, this is an array of CIDR (Classless Inter-Domain Routing) notations for a subnet or VCN OCID. Use a semicolon (;) as a deliminator between the VCN-specific subnets or IPs. Example:
["1.1.1.1","1.1.1.0/24","ocid1.vcn.oc1.sea.<unique_id>","ocid1.vcn.oc1.sea.<unique_id1>;1.1.1.1","ocid1.vcn.oc1.sea.<unique_id2>;1.1.0.0/16"]
For Exadata Cloud@Customer, this is an array of IP addresses or CIDR (Classless Inter-Domain Routing) notations. Example:["1.1.1.1","1.1.1.0/24","1.1.2.25"]
For an update operation, if you want to delete all the IPs in the ACL, use an array with a single empty string entry.
This cannot be updated in parallel with any of the following: licenseModel, dbEdition, cpuCoreCount, computeCount, computeModel, adminPassword, isMTLSConnectionRequired, openMode, permissionLevel, dbWorkload, dbVersion, isRefreshable, dbName, scheduledOperations, dbToolsDetails, isLocalDataGuardEnabled, or isFreeTier.
- State string
The current state of the Autonomous Database.
- Subnet
Id string (Updatable) The OCID of the subnet the resource is associated with.
Subnet Restrictions:
- For bare metal DB systems and for single node virtual machine DB systems, do not use a subnet that overlaps with 192.168.16.16/28.
- For Exadata and virtual machine 2-node RAC systems, do not use a subnet that overlaps with 192.168.128.0/20.
- For Autonomous Database, setting this will disable public secure access to the database.
These subnets are used by the Oracle Clusterware private interconnect on the database instance. Specifying an overlapping subnet will cause the private interconnect to malfunction. This restriction applies to both the client subnet and the backup subnet.
- Supported
Regions List<string>To Clone Tos The list of regions that support the creation of an Autonomous Database clone or an Autonomous Data Guard standby database.
- Switchover
To string It is applicable only when
is_data_guard_enabled
is true. Could be set toPRIMARY
orSTANDBY
. Default value isPRIMARY
.- Switchover
To stringRemote Peer Id (Updatable) It is applicable only when
dataguard_region_type
androle
are set, andis_dedicated
is false. It takes the OCID of the remote peer to switchover to.- Dictionary<string, object>
System tags for this resource. Each key is predefined and scoped to a namespace. For more information, see Resource Tags.
- Time
Created string The date and time the Autonomous Database was created.
- Time
Data stringGuard Role Changed The date and time the Autonomous Data Guard role was switched for the Autonomous Database. For databases that have standbys in both the primary Data Guard region and a remote Data Guard standby region, this is the latest timestamp of either the database using the "primary" role in the primary Data Guard region, or database located in the remote Data Guard standby region.
- Time
Deletion stringOf Free Autonomous Database The date and time the Always Free database will be automatically deleted because of inactivity. If the database is in the STOPPED state and without activity until this time, it will be deleted.
- Time
Disaster stringRecovery Role Changed The date and time the Disaster Recovery role was switched for the standby Autonomous Database.
- Time
Local stringData Guard Enabled The date and time that Autonomous Data Guard was enabled for an Autonomous Database where the standby was provisioned in the same region as the primary database.
- Time
Maintenance stringBegin The date and time when maintenance will begin.
- Time
Maintenance stringEnd The date and time when maintenance will end.
- Time
Of stringJoining Resource Pool - Time
Of stringLast Failover The timestamp of the last failover operation.
- Time
Of stringLast Refresh The date and time when last refresh happened.
- Time
Of stringLast Refresh Point The refresh point timestamp (UTC). The refresh point is the time to which the database was most recently refreshed. Data created after the refresh point is not included in the refresh.
- Time
Of stringLast Switchover The timestamp of the last switchover operation for the Autonomous Database.
- Time
Of stringNext Refresh The date and time of next refresh.
- Time
Reclamation stringOf Free Autonomous Database The date and time the Always Free database will be stopped because of inactivity. If this time is reached without any database activity, the database will automatically be put into the STOPPED state.
- Time
Until stringReconnect Clone Enabled The time and date as an RFC3339 formatted string, e.g., 2022-01-01T12:00:00.000Z, to set the limit for a refreshable clone to be reconnected to its source database.
- Timestamp string
The timestamp specified for the point-in-time clone of the source Autonomous Database. The timestamp must be in the past.
- Total
Backup doubleStorage Size In Gbs The backup storage to the database.
- Use
Latest boolAvailable Backup Time Stamp Clone from latest available backup timestamp.
- Used
Data intStorage Size In Gbs The storage space consumed by Autonomous Database in GBs.
- Used
Data intStorage Size In Tbs The amount of storage that has been used, in terabytes.
- Vault
Id string - Whitelisted
Ips List<string> (Updatable) The client IP access control list (ACL). This feature is available for autonomous databases on shared Exadata infrastructure and on Exadata Cloud@Customer. Only clients connecting from an IP address included in the ACL may access the Autonomous Database instance.
For shared Exadata infrastructure, this is an array of CIDR (Classless Inter-Domain Routing) notations for a subnet or VCN OCID. Use a semicolon (;) as a deliminator between the VCN-specific subnets or IPs. Example:
["1.1.1.1","1.1.1.0/24","ocid1.vcn.oc1.sea.<unique_id>","ocid1.vcn.oc1.sea.<unique_id1>;1.1.1.1","ocid1.vcn.oc1.sea.<unique_id2>;1.1.0.0/16"]
For Exadata Cloud@Customer, this is an array of IP addresses or CIDR (Classless Inter-Domain Routing) notations. Example:["1.1.1.1","1.1.1.0/24","1.1.2.25"]
For an update operation, if you want to delete all the IPs in the ACL, use an array with a single empty string entry.
This cannot be updated in parallel with any of the following: licenseModel, dbEdition, cpuCoreCount, computeCount, computeModel, adminPassword, isMTLSConnectionRequired, openMode, permissionLevel, dbWorkload, dbVersion, isRefreshable, dbName, scheduledOperations, dbToolsDetails, isLocalDataGuardEnabled, or isFreeTier. To remove all whitelisted IPs, set the field to a list with an empty string
[""]
.This cannot be updated in parallel with any of the following: licenseModel, dbEdition, cpuCoreCount, computeCount, computeModel, adminPassword, isMTLSConnectionRequired, openMode, permissionLevel, dbWorkload, dbVersion, isRefreshable, dbName, scheduledOperations, dbToolsDetails, isLocalDataGuardEnabled, or isFreeTier. To remove all whitelisted IPs, set the field to a list with an empty string
[""]
.
- Actual
Used float64Data Storage Size In Tbs The current amount of storage in use for user and system data, in terabytes (TB).
- Admin
Password string (Updatable) The password must be between 12 and 30 characters long, and must contain at least 1 uppercase, 1 lowercase, and 1 numeric character. It cannot contain the double quote symbol (") or the username "admin", regardless of casing. The password is mandatory if source value is "BACKUP_FROM_ID", "BACKUP_FROM_TIMESTAMP", "DATABASE" or "NONE".
- Allocated
Storage float64Size In Tbs The amount of storage currently allocated for the database tables and billed for, rounded up. When auto-scaling is not enabled, this value is equal to the
dataStorageSizeInTBs
value. You can compare this value to theactualUsedDataStorageSizeInTBs
value to determine if a manual shrink operation is appropriate for your allocated storage.- Apex
Details []AutonomousDatabase Apex Detail Args Information about Oracle APEX Application Development.
- Are
Primary boolWhitelisted Ips Used (Updatable) This field will be null if the Autonomous Database is not Data Guard enabled or Access Control is disabled. It's value would be
TRUE
if Autonomous Database is Data Guard enabled and Access Control is enabled and if the Autonomous Database uses primary IP access control list (ACL) for standby. It's value would beFALSE
if Autonomous Database is Data Guard enabled and Access Control is enabled and if the Autonomous Database uses different IP access control list (ACL) for standby compared to primary.- Autonomous
Container stringDatabase Id The Autonomous Container Database OCID.
- Autonomous
Database stringBackup Id The OCID of the source Autonomous Database Backup that you will clone to create a new Autonomous Database.
- Autonomous
Database stringId The OCID of the source Autonomous Database that you will clone to create a new Autonomous Database.
- Autonomous
Maintenance stringSchedule Type The maintenance schedule type of the Autonomous Database on shared Exadata infrastructure. The EARLY maintenance schedule of this Autonomous Database follows a schedule that applies patches prior to the REGULAR schedule.The REGULAR maintenance schedule of this Autonomous Database follows the normal cycle.
- Available
Upgrade []stringVersions List of Oracle Database versions available for a database upgrade. If there are no version upgrades available, this list is empty.
- Backup
Configs []AutonomousDatabase Backup Config Args Autonomous Database configuration details for storing manual backups in the Object Storage service.
- Backup
Retention intPeriod In Days (Updatable) Retention period, in days, for backups.
- Character
Set string The character set for the autonomous database. The default is AL32UTF8. Allowed values for an Autonomous Database on shared infrastructure as as returned by List Autonomous Database Character Sets
For an Autonomous Database on dedicated infrastructure, the allowed values are:
AL32UTF8, AR8ADOS710, AR8ADOS720, AR8APTEC715, AR8ARABICMACS, AR8ASMO8X, AR8ISO8859P6, AR8MSWIN1256, AR8MUSSAD768, AR8NAFITHA711, AR8NAFITHA721, AR8SAKHR706, AR8SAKHR707, AZ8ISO8859P9E, BG8MSWIN, BG8PC437S, BLT8CP921, BLT8ISO8859P13, BLT8MSWIN1257, BLT8PC775, BN8BSCII, CDN8PC863, CEL8ISO8859P14, CL8ISO8859P5, CL8ISOIR111, CL8KOI8R, CL8KOI8U, CL8MACCYRILLICS, CL8MSWIN1251, EE8ISO8859P2, EE8MACCES, EE8MACCROATIANS, EE8MSWIN1250, EE8PC852, EL8DEC, EL8ISO8859P7, EL8MACGREEKS, EL8MSWIN1253, EL8PC437S, EL8PC851, EL8PC869, ET8MSWIN923, HU8ABMOD, HU8CWI2, IN8ISCII, IS8PC861, IW8ISO8859P8, IW8MACHEBREWS, IW8MSWIN1255, IW8PC1507, JA16EUC, JA16EUCTILDE, JA16SJIS, JA16SJISTILDE, JA16VMS, KO16KSC5601, KO16KSCCS, KO16MSWIN949, LA8ISO6937, LA8PASSPORT, LT8MSWIN921, LT8PC772, LT8PC774, LV8PC1117, LV8PC8LR, LV8RST104090, N8PC865, NE8ISO8859P10, NEE8ISO8859P4, RU8BESTA, RU8PC855, RU8PC866, SE8ISO8859P3, TH8MACTHAIS, TH8TISASCII, TR8DEC, TR8MACTURKISHS, TR8MSWIN1254, TR8PC857, US7ASCII, US8PC437, UTF8, VN8MSWIN1258, VN8VN3, WE8DEC, WE8DG, WE8ISO8859P1, WE8ISO8859P15, WE8ISO8859P9, WE8MACROMAN8S, WE8MSWIN1252, WE8NCR4970, WE8NEXTSTEP, WE8PC850, WE8PC858, WE8PC860, WE8ROMAN8, ZHS16CGB231280, ZHS16GBK, ZHT16BIG5, ZHT16CCDC, ZHT16DBT, ZHT16HKSCS, ZHT16MSWIN950, ZHT32EUC, ZHT32SOPS, ZHT32TRIS
- Clone
Type string The Autonomous Database clone type.
- Compartment
Id string (Updatable) The OCID of the compartment of the Autonomous Database.
- Compute
Count float64 (Updatable) The compute amount available to the database. Minimum and maximum values depend on the compute model and whether the database is on Shared or Dedicated infrastructure. For an Autonomous Database on Shared infrastructure, the 'ECPU' compute model requires values in multiples of two. Required when using the
computeModel
parameter. When usingcpuCoreCount
parameter, it is an error to specify computeCount to a non-null value.- Compute
Model string (Updatable) The compute model of the Autonomous Database. This is required if using the
computeCount
parameter. If usingcpuCoreCount
then it is an error to specifycomputeModel
to a non-null value.- Connection
Strings []AutonomousDatabase Connection String Args The connection string used to connect to the Autonomous Database. The username for the Service Console is ADMIN. Use the password you entered when creating the Autonomous Database for the password value.
- Connection
Urls []AutonomousDatabase Connection Url Args The URLs for accessing Oracle Application Express (APEX) and SQL Developer Web with a browser from a Compute instance within your VCN or that has a direct connection to your VCN. Note that these URLs are provided by the console only for databases on dedicated Exadata infrastructure. Example:
{"sqlDevWebUrl": "https://<hostname>/ords...", "apexUrl", "https://<hostname>/ords..."}
- Cpu
Core intCount (Updatable) The number of OCPU cores to be made available to the database. For Autonomous Databases on dedicated Exadata infrastructure, the maximum number of cores is determined by the infrastructure shape. See Characteristics of Infrastructure Shapes for shape details. Note: This parameter cannot be used with the
ocpuCount
parameter. This input is ignored for Always Free resources.- The data type must be an integer.
- The minimum number of cores for all types of autonomous database is 1
- The maximum number of cores is as follows:
- Autonomous Databases on shared Exadata infrastructure: The maximum number of cores is 128.
- Autonomous Databases on dedicated Exadata infrastructure: The maximum number of cores is determined by the infrastructure shape. See Characteristics of Infrastructure Shapes for shape details.
- Customer
Contacts []AutonomousDatabase Customer Contact Args (Updatable) Customer Contacts.
- Data
Safe stringStatus (Updatable) Status of the Data Safe registration for this Autonomous Database. Could be REGISTERED or NOT_REGISTERED.
- Data
Storage intSize In Gb (Updatable) The size, in gigabytes, of the data volume that will be created and attached to the database. This storage can later be scaled up if needed. The maximum storage value is determined by the infrastructure shape. See Characteristics of Infrastructure Shapes for shape details.
Notes
- This parameter is only supported for dedicated Exadata infrastructure.
- This parameter cannot be used with the
dataStorageSizeInTBs
parameter.
- Data
Storage intSize In Tbs (Updatable) The size, in terabytes, of the data volume that will be created and attached to the database. This storage can later be scaled up if needed. For Autonomous Databases on dedicated Exadata infrastructure, the maximum storage value is determined by the infrastructure shape. See Characteristics of Infrastructure Shapes for shape details. A full Exadata service is allocated when the Autonomous Database size is set to the upper limit (384 TB).
Note: This parameter cannot be used with the
dataStorageSizeInGBs
parameter. This input is ignored for Always Free resources.- Database
Edition string (Updatable) The Oracle Database Edition that applies to the Autonomous databases.
- Database
Management stringStatus Status of Database Management for this Autonomous Database.
- Dataguard
Region stringType The Autonomous Data Guard region type of the Autonomous Database. For Autonomous Databases on shared Exadata infrastructure, Data Guard associations have designated primary and standby regions, and these region types do not change when the database changes roles. The standby regions in Data Guard associations can be the same region designated as the primary region, or they can be remote regions. Certain database administrative operations may be available only in the primary region of the Data Guard association, and cannot be performed when the database using the "primary" role is operating in a remote Data Guard standby region.
- Db
Name string (Updatable) Specify the database name; it must consist of letters and numbers only. The maximum length is 30 characters. The same database name cannot be used for multiple Autonomous Databases in the same tenancy in the same region.
- Db
Version string (Updatable) A valid Oracle Database version for Autonomous Database.
db_workload
AJD and APEX are only supported fordb_version
19c
and above.- Db
Workload string (Updatable) The Autonomous Database workload type. The following values are valid:
- OLTP - indicates an Autonomous Transaction Processing database
- DW - indicates an Autonomous Data Warehouse database
- AJD - indicates an Autonomous JSON Database
- APEX - indicates an Autonomous Database with the Oracle APEX Application Development workload type.
This cannot be updated in parallel with any of the following: licenseModel, dbEdition, cpuCoreCount, computeCount, computeModel, adminPassword, whitelistedIps, isMTLSConnectionRequired, privateEndpointLabel, nsgIds, dbVersion, isRefreshable, dbName, scheduledOperations, dbToolsDetails, isLocalDataGuardEnabled, or isFreeTier. *Note:
db_workload
can only be updated from AJD to OLTP or from a free OLTP to AJD.- map[string]interface{}
(Updatable) Defined tags for this resource. Each key is predefined and scoped to a namespace. For more information, see Resource Tags.
- Disaster
Recovery stringRegion Type The disaster recovery (DR) region type of the Autonomous Database. For Shared Autonomous Databases, DR associations have designated primary and standby regions. These region types do not change when the database changes roles. The standby region in DR associations can be the same region as the primary region, or they can be in a remote regions. Some database administration operations may be available only in the primary region of the DR association, and cannot be performed when the database using the primary role is operating in a remote region.
- Display
Name string (Updatable) The user-friendly name for the Autonomous Database. The name does not have to be unique.
- Failed
Data intRecovery In Seconds Indicates the number of seconds of data loss for a Data Guard failover.
- map[string]interface{}
(Updatable) Free-form tags for this resource. Each tag is a simple key-value pair with no predefined name, type, or namespace. For more information, see Resource Tags. Example:
{"Department": "Finance"}
- In
Memory intArea In Gbs The area assigned to In-Memory tables in Autonomous Database.
- In
Memory intPercentage (Updatable) The percentage of the System Global Area(SGA) assigned to In-Memory tables in Autonomous Database.
- Infrastructure
Type string The infrastructure type this resource belongs to.
- Is
Access boolControl Enabled (Updatable) Indicates if the database-level access control is enabled. If disabled, database access is defined by the network security rules. If enabled, database access is restricted to the IP addresses defined by the rules specified with the
whitelistedIps
property. While specifyingwhitelistedIps
rules is optional, if database-level access control is enabled and no rules are specified, the database will become inaccessible. The rules can be added later using theUpdateAutonomousDatabase
API operation or edit option in console. When creating a database clone, the desired access control setting should be specified. By default, database-level access control will be disabled for the clone.This property is applicable only to Autonomous Databases on the Exadata Cloud@Customer platform.
- Is
Auto boolScaling Enabled (Updatable) Indicates if auto scaling is enabled for the Autonomous Database OCPU core count. The default value is
FALSE
.- Is
Auto boolScaling For Storage Enabled (Updatable) Indicates if auto scaling is enabled for the Autonomous Database storage. The default value is
FALSE
.- Is
Data boolGuard Enabled (Updatable) Deprecated. Indicates whether the Autonomous Database has local (in-region) Data Guard enabled. Not applicable to cross-region Autonomous Data Guard associations, or to Autonomous Databases using dedicated Exadata infrastructure or Exadata Cloud@Customer infrastructure.
- Is
Dedicated bool True if the database is on dedicated Exadata infrastructure.
- Is
Free boolTier (Updatable) Indicates if this is an Always Free resource. The default value is false. Note that Always Free Autonomous Databases have 1 CPU and 20GB of memory. For Always Free databases, memory and CPU cannot be scaled. When
db_workload
isAJD
orAPEX
it cannot betrue
.- Is
Local boolData Guard Enabled (Updatable) Indicates whether the Autonomous Database has local (in-region) Data Guard enabled. Not applicable to cross-region Autonomous Data Guard associations, or to Autonomous Databases using dedicated Exadata infrastructure or Exadata Cloud@Customer infrastructure.
- Is
Mtls boolConnection Required (Updatable) Indicates whether the Autonomous Database requires mTLS connections.
- Is
Preview bool Indicates if the Autonomous Database version is a preview version.
- Is
Preview boolVersion With Service Terms Accepted If set to
TRUE
, indicates that an Autonomous Database preview version is being provisioned, and that the preview version's terms of service have been accepted. Note that preview version software is only available for databases on shared Exadata infrastructure.- Is
Reconnect boolClone Enabled Indicates if the refreshable clone can be reconnected to its source database.
- Is
Refreshable boolClone (Updatable) True for creating a refreshable clone and False for detaching the clone from source Autonomous Database. Detaching is one time operation and clone becomes a regular Autonomous Database.
- Is
Remote boolData Guard Enabled Indicates whether the Autonomous Database has Cross Region Data Guard enabled. Not applicable to Autonomous Databases using dedicated Exadata infrastructure or Exadata Cloud@Customer infrastructure.
- Is
Shrink boolOnly (Updatable) An optional property when enabled triggers the Shrinking of Autonomous Database once. To trigger Shrinking of ADB once again, this flag needs to be disabled and re-enabled again. It should not be passed during create database operation. It is only applicable on shared databases i.e. where
is_dedicated
is false.** IMPORTANT ** Any change to a property that does not support update will force the destruction and recreation of the resource with the new property values
- Key
History []AutonomousEntries Database Key History Entry Args Key History Entry.
- Key
Store stringId The OCID of the key store.
- Key
Store stringWallet Name The wallet name for Oracle Key Vault.
- Kms
Key stringId The OCID of the key container that is used as the master encryption key in database transparent data encryption (TDE) operations.
- Kms
Key stringLifecycle Details KMS key lifecycle details.
- Kms
Key stringVersion Id The OCID of the key container version that is used in database transparent data encryption (TDE) operations KMS Key can have multiple key versions. If none is specified, the current key version (latest) of the Key Id is used for the operation.
- License
Model string (Updatable) The Oracle license model that applies to the Oracle Autonomous Database. Bring your own license (BYOL) allows you to apply your current on-premises Oracle software licenses to equivalent, highly automated Oracle PaaS and IaaS services in the cloud. License Included allows you to subscribe to new Oracle Database software licenses and the Database service. Note that when provisioning an Autonomous Database on dedicated Exadata infrastructure, this attribute must be null because the attribute is already set at the Autonomous Exadata Infrastructure level. When using shared Exadata infrastructure, if a value is not specified, the system will supply the value of
BRING_YOUR_OWN_LICENSE
. It is a required field whendb_workload
is AJD and needs to be set toLICENSE_INCLUDED
as AJD does not support defaultlicense_model
valueBRING_YOUR_OWN_LICENSE
.- Lifecycle
Details string Additional information about the current lifecycle state.
- Local
Adg intAuto Failover Max Data Loss Limit Parameter that allows users to select an acceptable maximum data loss limit in seconds, up to which Automatic Failover will be triggered when necessary for a Local Autonomous Data Guard
- Local
Disaster stringRecovery Type Indicates the local disaster recovery (DR) type of the Shared Autonomous Database. Autonomous Data Guard (ADG) DR type provides business critical DR with a faster recovery time objective (RTO) during failover or switchover. Backup-based DR type provides lower cost DR with a slower RTO during failover or switchover.
- Local
Standby []AutonomousDbs Database Local Standby Db Args Autonomous Data Guard standby database details.
- Long
Term []AutonomousBackup Schedules Database Long Term Backup Schedule Args Details for the long-term backup schedule.
- Max
Cpu intCore Count (Updatable) The number of Max OCPU cores to be made available to the autonomous database with auto scaling of cpu enabled.
- Memory
Per intOracle Compute Unit In Gbs The amount of memory (in GBs) enabled per each OCPU core in Autonomous VM Cluster.
- Ncharacter
Set string The national character set for the autonomous database. The default is AL16UTF16. Allowed values are: AL16UTF16 or UTF8.
- Next
Long stringTerm Backup Time Stamp The date and time when the next long-term backup would be created.
- Nsg
Ids []string (Updatable) The list of OCIDs for the network security groups (NSGs) to which this resource belongs. Setting this to an empty list removes all resources from all NSGs. For more information about NSGs, see Security Rules. NsgIds restrictions:
- A network security group (NSG) is optional for Autonomous Databases with private access. The nsgIds list can be empty.
- Ocpu
Count float64 (Updatable) The number of OCPU cores to be made available to the database.
The following points apply:
- For Autonomous Databases on dedicated Exadata infrastructure, to provision less than 1 core, enter a fractional value in an increment of 0.1. For example, you can provision 0.3 or 0.4 cores, but not 0.35 cores. (Note that fractional OCPU values are not supported for Autonomous Databasese on shared Exadata infrastructure.)
- To provision 1 or more cores, you must enter an integer between 1 and the maximum number of cores available for the infrastructure shape. For example, you can provision 2 cores or 3 cores, but not 2.5 cores. This applies to Autonomous Databases on both shared and dedicated Exadata infrastructure.
For Autonomous Databases on dedicated Exadata infrastructure, the maximum number of cores is determined by the infrastructure shape. See Characteristics of Infrastructure Shapes for shape details.
Note: This parameter cannot be used with the
cpuCoreCount
parameter.- Open
Mode string Indicates the Autonomous Database mode. The database can be opened in
READ_ONLY
orREAD_WRITE
mode.- Operations
Insights stringStatus (Updatable) Status of Operations Insights for this Autonomous Database. Values supported are
ENABLED
andNOT_ENABLED
- Peer
Db []stringIds The list of OCIDs of standby databases located in Autonomous Data Guard remote regions that are associated with the source database. Note that for shared Exadata infrastructure, standby databases located in the same region as the source primary database do not have OCIDs.
- Permission
Level string The Autonomous Database permission level. Restricted mode allows access only by admin users.
- Private
Endpoint string The private endpoint for the resource.
- Private
Endpoint stringIp The private endpoint Ip address for the resource.
- Private
Endpoint stringLabel (Updatable) The private endpoint label for the resource.
- Provisionable
Cpuses []float64 An array of CPU values that an Autonomous Database can be scaled to.
- Refreshable
Mode string (Updatable) The refresh mode of the clone. AUTOMATIC indicates that the clone is automatically being refreshed with data from the source Autonomous Database.
- Refreshable
Status string The refresh status of the clone. REFRESHING indicates that the clone is currently being refreshed with data from the source Autonomous Database.
- Remote
Disaster []AutonomousRecovery Configurations Database Remote Disaster Recovery Configuration Args Configurations of a Disaster Recovery.
- Remote
Disaster stringRecovery Type Indicates the cross-region disaster recovery (DR) type of the standby Shared Autonomous Database. Autonomous Data Guard (ADG) DR type provides business critical DR with a faster recovery time objective (RTO) during failover or switchover. Backup-based DR type provides lower cost DR with a slower RTO during failover or switchover.
- Resource
Pool stringLeader Id - Resource
Pool AutonomousSummary Database Resource Pool Summary Args - Role string
The Data Guard role of the Autonomous Container Database or Autonomous Database, if Autonomous Data Guard is enabled.
- Rotate
Key boolTrigger (Updatable) An optional property when flipped triggers rotation of KMS key. It is only applicable on dedicated databases i.e. where
is_dedicated
is true.- Scheduled
Operations []AutonomousDatabase Scheduled Operation Args (Updatable) The list of scheduled operations.
This cannot be updated in parallel with any of the following: licenseModel, dbEdition, cpuCoreCount, computeCount, computeModel, whitelistedIps, isMTLSConnectionRequired, openMode, permissionLevel, dbWorkload, privateEndpointLabel, nsgIds, dbVersion, isRefreshable, dbName, dbToolsDetails, isLocalDataGuardEnabled, or isFreeTier.
- Secret
Id string (Updatable) The Oracle Cloud Infrastructure vault secret [/Content/General/Concepts/identifiers.htm]OCID.
- Secret
Version intNumber (Updatable) The version of the vault secret. If no version is specified, the latest version will be used.
- Service
Console stringUrl The URL of the Service Console for the Autonomous Database.
- Source string
The source of the database: Use
NONE
for creating a new Autonomous Database. UseDATABASE
for creating a new Autonomous Database by cloning an existing Autonomous Database. UseCROSS_REGION_DATAGUARD
to create a standby Data Guard database in another region.For Autonomous Databases on shared Exadata infrastructure, the following cloning options are available: Use
BACKUP_FROM_ID
for creating a new Autonomous Database from a specified backup. UseBACKUP_FROM_TIMESTAMP
for creating a point-in-time Autonomous Database clone using backups. For more information, see Cloning and Moving an Autonomous Database.- Source
Id string The OCID of the source Autonomous Database that will be used to create a new standby database for the Data Guard association.
- Standby
Dbs []AutonomousDatabase Standby Db Args Deprecated Autonomous Data Guard standby database details.
- Standby
Whitelisted []stringIps (Updatable) The client IP access control list (ACL). This feature is available for autonomous databases on shared Exadata infrastructure and on Exadata Cloud@Customer. Only clients connecting from an IP address included in the ACL may access the Autonomous Database instance.
For shared Exadata infrastructure, this is an array of CIDR (Classless Inter-Domain Routing) notations for a subnet or VCN OCID. Use a semicolon (;) as a deliminator between the VCN-specific subnets or IPs. Example:
["1.1.1.1","1.1.1.0/24","ocid1.vcn.oc1.sea.<unique_id>","ocid1.vcn.oc1.sea.<unique_id1>;1.1.1.1","ocid1.vcn.oc1.sea.<unique_id2>;1.1.0.0/16"]
For Exadata Cloud@Customer, this is an array of IP addresses or CIDR (Classless Inter-Domain Routing) notations. Example:["1.1.1.1","1.1.1.0/24","1.1.2.25"]
For an update operation, if you want to delete all the IPs in the ACL, use an array with a single empty string entry.
This cannot be updated in parallel with any of the following: licenseModel, dbEdition, cpuCoreCount, computeCount, computeModel, adminPassword, isMTLSConnectionRequired, openMode, permissionLevel, dbWorkload, dbVersion, isRefreshable, dbName, scheduledOperations, dbToolsDetails, isLocalDataGuardEnabled, or isFreeTier.
- State string
The current state of the Autonomous Database.
- Subnet
Id string (Updatable) The OCID of the subnet the resource is associated with.
Subnet Restrictions:
- For bare metal DB systems and for single node virtual machine DB systems, do not use a subnet that overlaps with 192.168.16.16/28.
- For Exadata and virtual machine 2-node RAC systems, do not use a subnet that overlaps with 192.168.128.0/20.
- For Autonomous Database, setting this will disable public secure access to the database.
These subnets are used by the Oracle Clusterware private interconnect on the database instance. Specifying an overlapping subnet will cause the private interconnect to malfunction. This restriction applies to both the client subnet and the backup subnet.
- Supported
Regions []stringTo Clone Tos The list of regions that support the creation of an Autonomous Database clone or an Autonomous Data Guard standby database.
- Switchover
To string It is applicable only when
is_data_guard_enabled
is true. Could be set toPRIMARY
orSTANDBY
. Default value isPRIMARY
.- Switchover
To stringRemote Peer Id (Updatable) It is applicable only when
dataguard_region_type
androle
are set, andis_dedicated
is false. It takes the OCID of the remote peer to switchover to.- map[string]interface{}
System tags for this resource. Each key is predefined and scoped to a namespace. For more information, see Resource Tags.
- Time
Created string The date and time the Autonomous Database was created.
- Time
Data stringGuard Role Changed The date and time the Autonomous Data Guard role was switched for the Autonomous Database. For databases that have standbys in both the primary Data Guard region and a remote Data Guard standby region, this is the latest timestamp of either the database using the "primary" role in the primary Data Guard region, or database located in the remote Data Guard standby region.
- Time
Deletion stringOf Free Autonomous Database The date and time the Always Free database will be automatically deleted because of inactivity. If the database is in the STOPPED state and without activity until this time, it will be deleted.
- Time
Disaster stringRecovery Role Changed The date and time the Disaster Recovery role was switched for the standby Autonomous Database.
- Time
Local stringData Guard Enabled The date and time that Autonomous Data Guard was enabled for an Autonomous Database where the standby was provisioned in the same region as the primary database.
- Time
Maintenance stringBegin The date and time when maintenance will begin.
- Time
Maintenance stringEnd The date and time when maintenance will end.
- Time
Of stringJoining Resource Pool - Time
Of stringLast Failover The timestamp of the last failover operation.
- Time
Of stringLast Refresh The date and time when last refresh happened.
- Time
Of stringLast Refresh Point The refresh point timestamp (UTC). The refresh point is the time to which the database was most recently refreshed. Data created after the refresh point is not included in the refresh.
- Time
Of stringLast Switchover The timestamp of the last switchover operation for the Autonomous Database.
- Time
Of stringNext Refresh The date and time of next refresh.
- Time
Reclamation stringOf Free Autonomous Database The date and time the Always Free database will be stopped because of inactivity. If this time is reached without any database activity, the database will automatically be put into the STOPPED state.
- Time
Until stringReconnect Clone Enabled The time and date as an RFC3339 formatted string, e.g., 2022-01-01T12:00:00.000Z, to set the limit for a refreshable clone to be reconnected to its source database.
- Timestamp string
The timestamp specified for the point-in-time clone of the source Autonomous Database. The timestamp must be in the past.
- Total
Backup float64Storage Size In Gbs The backup storage to the database.
- Use
Latest boolAvailable Backup Time Stamp Clone from latest available backup timestamp.
- Used
Data intStorage Size In Gbs The storage space consumed by Autonomous Database in GBs.
- Used
Data intStorage Size In Tbs The amount of storage that has been used, in terabytes.
- Vault
Id string - Whitelisted
Ips []string (Updatable) The client IP access control list (ACL). This feature is available for autonomous databases on shared Exadata infrastructure and on Exadata Cloud@Customer. Only clients connecting from an IP address included in the ACL may access the Autonomous Database instance.
For shared Exadata infrastructure, this is an array of CIDR (Classless Inter-Domain Routing) notations for a subnet or VCN OCID. Use a semicolon (;) as a deliminator between the VCN-specific subnets or IPs. Example:
["1.1.1.1","1.1.1.0/24","ocid1.vcn.oc1.sea.<unique_id>","ocid1.vcn.oc1.sea.<unique_id1>;1.1.1.1","ocid1.vcn.oc1.sea.<unique_id2>;1.1.0.0/16"]
For Exadata Cloud@Customer, this is an array of IP addresses or CIDR (Classless Inter-Domain Routing) notations. Example:["1.1.1.1","1.1.1.0/24","1.1.2.25"]
For an update operation, if you want to delete all the IPs in the ACL, use an array with a single empty string entry.
This cannot be updated in parallel with any of the following: licenseModel, dbEdition, cpuCoreCount, computeCount, computeModel, adminPassword, isMTLSConnectionRequired, openMode, permissionLevel, dbWorkload, dbVersion, isRefreshable, dbName, scheduledOperations, dbToolsDetails, isLocalDataGuardEnabled, or isFreeTier. To remove all whitelisted IPs, set the field to a list with an empty string
[""]
.This cannot be updated in parallel with any of the following: licenseModel, dbEdition, cpuCoreCount, computeCount, computeModel, adminPassword, isMTLSConnectionRequired, openMode, permissionLevel, dbWorkload, dbVersion, isRefreshable, dbName, scheduledOperations, dbToolsDetails, isLocalDataGuardEnabled, or isFreeTier. To remove all whitelisted IPs, set the field to a list with an empty string
[""]
.
- actual
Used DoubleData Storage Size In Tbs The current amount of storage in use for user and system data, in terabytes (TB).
- admin
Password String (Updatable) The password must be between 12 and 30 characters long, and must contain at least 1 uppercase, 1 lowercase, and 1 numeric character. It cannot contain the double quote symbol (") or the username "admin", regardless of casing. The password is mandatory if source value is "BACKUP_FROM_ID", "BACKUP_FROM_TIMESTAMP", "DATABASE" or "NONE".
- allocated
Storage DoubleSize In Tbs The amount of storage currently allocated for the database tables and billed for, rounded up. When auto-scaling is not enabled, this value is equal to the
dataStorageSizeInTBs
value. You can compare this value to theactualUsedDataStorageSizeInTBs
value to determine if a manual shrink operation is appropriate for your allocated storage.- apex
Details List<AutonomousApex Detail> Information about Oracle APEX Application Development.
- are
Primary BooleanWhitelisted Ips Used (Updatable) This field will be null if the Autonomous Database is not Data Guard enabled or Access Control is disabled. It's value would be
TRUE
if Autonomous Database is Data Guard enabled and Access Control is enabled and if the Autonomous Database uses primary IP access control list (ACL) for standby. It's value would beFALSE
if Autonomous Database is Data Guard enabled and Access Control is enabled and if the Autonomous Database uses different IP access control list (ACL) for standby compared to primary.- autonomous
Container StringDatabase Id The Autonomous Container Database OCID.
- autonomous
Database StringBackup Id The OCID of the source Autonomous Database Backup that you will clone to create a new Autonomous Database.
- autonomous
Database StringId The OCID of the source Autonomous Database that you will clone to create a new Autonomous Database.
- autonomous
Maintenance StringSchedule Type The maintenance schedule type of the Autonomous Database on shared Exadata infrastructure. The EARLY maintenance schedule of this Autonomous Database follows a schedule that applies patches prior to the REGULAR schedule.The REGULAR maintenance schedule of this Autonomous Database follows the normal cycle.
- available
Upgrade List<String>Versions List of Oracle Database versions available for a database upgrade. If there are no version upgrades available, this list is empty.
- backup
Configs List<AutonomousBackup Config> Autonomous Database configuration details for storing manual backups in the Object Storage service.
- backup
Retention IntegerPeriod In Days (Updatable) Retention period, in days, for backups.
- character
Set String The character set for the autonomous database. The default is AL32UTF8. Allowed values for an Autonomous Database on shared infrastructure as as returned by List Autonomous Database Character Sets
For an Autonomous Database on dedicated infrastructure, the allowed values are:
AL32UTF8, AR8ADOS710, AR8ADOS720, AR8APTEC715, AR8ARABICMACS, AR8ASMO8X, AR8ISO8859P6, AR8MSWIN1256, AR8MUSSAD768, AR8NAFITHA711, AR8NAFITHA721, AR8SAKHR706, AR8SAKHR707, AZ8ISO8859P9E, BG8MSWIN, BG8PC437S, BLT8CP921, BLT8ISO8859P13, BLT8MSWIN1257, BLT8PC775, BN8BSCII, CDN8PC863, CEL8ISO8859P14, CL8ISO8859P5, CL8ISOIR111, CL8KOI8R, CL8KOI8U, CL8MACCYRILLICS, CL8MSWIN1251, EE8ISO8859P2, EE8MACCES, EE8MACCROATIANS, EE8MSWIN1250, EE8PC852, EL8DEC, EL8ISO8859P7, EL8MACGREEKS, EL8MSWIN1253, EL8PC437S, EL8PC851, EL8PC869, ET8MSWIN923, HU8ABMOD, HU8CWI2, IN8ISCII, IS8PC861, IW8ISO8859P8, IW8MACHEBREWS, IW8MSWIN1255, IW8PC1507, JA16EUC, JA16EUCTILDE, JA16SJIS, JA16SJISTILDE, JA16VMS, KO16KSC5601, KO16KSCCS, KO16MSWIN949, LA8ISO6937, LA8PASSPORT, LT8MSWIN921, LT8PC772, LT8PC774, LV8PC1117, LV8PC8LR, LV8RST104090, N8PC865, NE8ISO8859P10, NEE8ISO8859P4, RU8BESTA, RU8PC855, RU8PC866, SE8ISO8859P3, TH8MACTHAIS, TH8TISASCII, TR8DEC, TR8MACTURKISHS, TR8MSWIN1254, TR8PC857, US7ASCII, US8PC437, UTF8, VN8MSWIN1258, VN8VN3, WE8DEC, WE8DG, WE8ISO8859P1, WE8ISO8859P15, WE8ISO8859P9, WE8MACROMAN8S, WE8MSWIN1252, WE8NCR4970, WE8NEXTSTEP, WE8PC850, WE8PC858, WE8PC860, WE8ROMAN8, ZHS16CGB231280, ZHS16GBK, ZHT16BIG5, ZHT16CCDC, ZHT16DBT, ZHT16HKSCS, ZHT16MSWIN950, ZHT32EUC, ZHT32SOPS, ZHT32TRIS
- clone
Type String The Autonomous Database clone type.
- compartment
Id String (Updatable) The OCID of the compartment of the Autonomous Database.
- compute
Count Double (Updatable) The compute amount available to the database. Minimum and maximum values depend on the compute model and whether the database is on Shared or Dedicated infrastructure. For an Autonomous Database on Shared infrastructure, the 'ECPU' compute model requires values in multiples of two. Required when using the
computeModel
parameter. When usingcpuCoreCount
parameter, it is an error to specify computeCount to a non-null value.- compute
Model String (Updatable) The compute model of the Autonomous Database. This is required if using the
computeCount
parameter. If usingcpuCoreCount
then it is an error to specifycomputeModel
to a non-null value.- connection
Strings List<AutonomousConnection String> The connection string used to connect to the Autonomous Database. The username for the Service Console is ADMIN. Use the password you entered when creating the Autonomous Database for the password value.
- connection
Urls List<AutonomousConnection Url> The URLs for accessing Oracle Application Express (APEX) and SQL Developer Web with a browser from a Compute instance within your VCN or that has a direct connection to your VCN. Note that these URLs are provided by the console only for databases on dedicated Exadata infrastructure. Example:
{"sqlDevWebUrl": "https://<hostname>/ords...", "apexUrl", "https://<hostname>/ords..."}
- cpu
Core IntegerCount (Updatable) The number of OCPU cores to be made available to the database. For Autonomous Databases on dedicated Exadata infrastructure, the maximum number of cores is determined by the infrastructure shape. See Characteristics of Infrastructure Shapes for shape details. Note: This parameter cannot be used with the
ocpuCount
parameter. This input is ignored for Always Free resources.- The data type must be an integer.
- The minimum number of cores for all types of autonomous database is 1
- The maximum number of cores is as follows:
- Autonomous Databases on shared Exadata infrastructure: The maximum number of cores is 128.
- Autonomous Databases on dedicated Exadata infrastructure: The maximum number of cores is determined by the infrastructure shape. See Characteristics of Infrastructure Shapes for shape details.
- customer
Contacts List<AutonomousCustomer Contact> (Updatable) Customer Contacts.
- data
Safe StringStatus (Updatable) Status of the Data Safe registration for this Autonomous Database. Could be REGISTERED or NOT_REGISTERED.
- data
Storage IntegerSize In Gb (Updatable) The size, in gigabytes, of the data volume that will be created and attached to the database. This storage can later be scaled up if needed. The maximum storage value is determined by the infrastructure shape. See Characteristics of Infrastructure Shapes for shape details.
Notes
- This parameter is only supported for dedicated Exadata infrastructure.
- This parameter cannot be used with the
dataStorageSizeInTBs
parameter.
- data
Storage IntegerSize In Tbs (Updatable) The size, in terabytes, of the data volume that will be created and attached to the database. This storage can later be scaled up if needed. For Autonomous Databases on dedicated Exadata infrastructure, the maximum storage value is determined by the infrastructure shape. See Characteristics of Infrastructure Shapes for shape details. A full Exadata service is allocated when the Autonomous Database size is set to the upper limit (384 TB).
Note: This parameter cannot be used with the
dataStorageSizeInGBs
parameter. This input is ignored for Always Free resources.- database
Edition String (Updatable) The Oracle Database Edition that applies to the Autonomous databases.
- database
Management StringStatus Status of Database Management for this Autonomous Database.
- dataguard
Region StringType The Autonomous Data Guard region type of the Autonomous Database. For Autonomous Databases on shared Exadata infrastructure, Data Guard associations have designated primary and standby regions, and these region types do not change when the database changes roles. The standby regions in Data Guard associations can be the same region designated as the primary region, or they can be remote regions. Certain database administrative operations may be available only in the primary region of the Data Guard association, and cannot be performed when the database using the "primary" role is operating in a remote Data Guard standby region.
- db
Name String (Updatable) Specify the database name; it must consist of letters and numbers only. The maximum length is 30 characters. The same database name cannot be used for multiple Autonomous Databases in the same tenancy in the same region.
- db
Version String (Updatable) A valid Oracle Database version for Autonomous Database.
db_workload
AJD and APEX are only supported fordb_version
19c
and above.- db
Workload String (Updatable) The Autonomous Database workload type. The following values are valid:
- OLTP - indicates an Autonomous Transaction Processing database
- DW - indicates an Autonomous Data Warehouse database
- AJD - indicates an Autonomous JSON Database
- APEX - indicates an Autonomous Database with the Oracle APEX Application Development workload type.
This cannot be updated in parallel with any of the following: licenseModel, dbEdition, cpuCoreCount, computeCount, computeModel, adminPassword, whitelistedIps, isMTLSConnectionRequired, privateEndpointLabel, nsgIds, dbVersion, isRefreshable, dbName, scheduledOperations, dbToolsDetails, isLocalDataGuardEnabled, or isFreeTier. *Note:
db_workload
can only be updated from AJD to OLTP or from a free OLTP to AJD.- Map<String,Object>
(Updatable) Defined tags for this resource. Each key is predefined and scoped to a namespace. For more information, see Resource Tags.
- disaster
Recovery StringRegion Type The disaster recovery (DR) region type of the Autonomous Database. For Shared Autonomous Databases, DR associations have designated primary and standby regions. These region types do not change when the database changes roles. The standby region in DR associations can be the same region as the primary region, or they can be in a remote regions. Some database administration operations may be available only in the primary region of the DR association, and cannot be performed when the database using the primary role is operating in a remote region.
- display
Name String (Updatable) The user-friendly name for the Autonomous Database. The name does not have to be unique.
- failed
Data IntegerRecovery In Seconds Indicates the number of seconds of data loss for a Data Guard failover.
- Map<String,Object>
(Updatable) Free-form tags for this resource. Each tag is a simple key-value pair with no predefined name, type, or namespace. For more information, see Resource Tags. Example:
{"Department": "Finance"}
- in
Memory IntegerArea In Gbs The area assigned to In-Memory tables in Autonomous Database.
- in
Memory IntegerPercentage (Updatable) The percentage of the System Global Area(SGA) assigned to In-Memory tables in Autonomous Database.
- infrastructure
Type String The infrastructure type this resource belongs to.
- is
Access BooleanControl Enabled (Updatable) Indicates if the database-level access control is enabled. If disabled, database access is defined by the network security rules. If enabled, database access is restricted to the IP addresses defined by the rules specified with the
whitelistedIps
property. While specifyingwhitelistedIps
rules is optional, if database-level access control is enabled and no rules are specified, the database will become inaccessible. The rules can be added later using theUpdateAutonomousDatabase
API operation or edit option in console. When creating a database clone, the desired access control setting should be specified. By default, database-level access control will be disabled for the clone.This property is applicable only to Autonomous Databases on the Exadata Cloud@Customer platform.
- is
Auto BooleanScaling Enabled (Updatable) Indicates if auto scaling is enabled for the Autonomous Database OCPU core count. The default value is
FALSE
.- is
Auto BooleanScaling For Storage Enabled (Updatable) Indicates if auto scaling is enabled for the Autonomous Database storage. The default value is
FALSE
.- is
Data BooleanGuard Enabled (Updatable) Deprecated. Indicates whether the Autonomous Database has local (in-region) Data Guard enabled. Not applicable to cross-region Autonomous Data Guard associations, or to Autonomous Databases using dedicated Exadata infrastructure or Exadata Cloud@Customer infrastructure.
- is
Dedicated Boolean True if the database is on dedicated Exadata infrastructure.
- is
Free BooleanTier (Updatable) Indicates if this is an Always Free resource. The default value is false. Note that Always Free Autonomous Databases have 1 CPU and 20GB of memory. For Always Free databases, memory and CPU cannot be scaled. When
db_workload
isAJD
orAPEX
it cannot betrue
.- is
Local BooleanData Guard Enabled (Updatable) Indicates whether the Autonomous Database has local (in-region) Data Guard enabled. Not applicable to cross-region Autonomous Data Guard associations, or to Autonomous Databases using dedicated Exadata infrastructure or Exadata Cloud@Customer infrastructure.
- is
Mtls BooleanConnection Required (Updatable) Indicates whether the Autonomous Database requires mTLS connections.
- is
Preview Boolean Indicates if the Autonomous Database version is a preview version.
- is
Preview BooleanVersion With Service Terms Accepted If set to
TRUE
, indicates that an Autonomous Database preview version is being provisioned, and that the preview version's terms of service have been accepted. Note that preview version software is only available for databases on shared Exadata infrastructure.- is
Reconnect BooleanClone Enabled Indicates if the refreshable clone can be reconnected to its source database.
- is
Refreshable BooleanClone (Updatable) True for creating a refreshable clone and False for detaching the clone from source Autonomous Database. Detaching is one time operation and clone becomes a regular Autonomous Database.
- is
Remote BooleanData Guard Enabled Indicates whether the Autonomous Database has Cross Region Data Guard enabled. Not applicable to Autonomous Databases using dedicated Exadata infrastructure or Exadata Cloud@Customer infrastructure.
- is
Shrink BooleanOnly (Updatable) An optional property when enabled triggers the Shrinking of Autonomous Database once. To trigger Shrinking of ADB once again, this flag needs to be disabled and re-enabled again. It should not be passed during create database operation. It is only applicable on shared databases i.e. where
is_dedicated
is false.** IMPORTANT ** Any change to a property that does not support update will force the destruction and recreation of the resource with the new property values
- key
History List<AutonomousEntries Key History Entry> Key History Entry.
- key
Store StringId The OCID of the key store.
- key
Store StringWallet Name The wallet name for Oracle Key Vault.
- kms
Key StringId The OCID of the key container that is used as the master encryption key in database transparent data encryption (TDE) operations.
- kms
Key StringLifecycle Details KMS key lifecycle details.
- kms
Key StringVersion Id The OCID of the key container version that is used in database transparent data encryption (TDE) operations KMS Key can have multiple key versions. If none is specified, the current key version (latest) of the Key Id is used for the operation.
- license
Model String (Updatable) The Oracle license model that applies to the Oracle Autonomous Database. Bring your own license (BYOL) allows you to apply your current on-premises Oracle software licenses to equivalent, highly automated Oracle PaaS and IaaS services in the cloud. License Included allows you to subscribe to new Oracle Database software licenses and the Database service. Note that when provisioning an Autonomous Database on dedicated Exadata infrastructure, this attribute must be null because the attribute is already set at the Autonomous Exadata Infrastructure level. When using shared Exadata infrastructure, if a value is not specified, the system will supply the value of
BRING_YOUR_OWN_LICENSE
. It is a required field whendb_workload
is AJD and needs to be set toLICENSE_INCLUDED
as AJD does not support defaultlicense_model
valueBRING_YOUR_OWN_LICENSE
.- lifecycle
Details String Additional information about the current lifecycle state.
- local
Adg IntegerAuto Failover Max Data Loss Limit Parameter that allows users to select an acceptable maximum data loss limit in seconds, up to which Automatic Failover will be triggered when necessary for a Local Autonomous Data Guard
- local
Disaster StringRecovery Type Indicates the local disaster recovery (DR) type of the Shared Autonomous Database. Autonomous Data Guard (ADG) DR type provides business critical DR with a faster recovery time objective (RTO) during failover or switchover. Backup-based DR type provides lower cost DR with a slower RTO during failover or switchover.
- local
Standby List<AutonomousDbs Local Standby Db> Autonomous Data Guard standby database details.
- long
Term List<AutonomousBackup Schedules Long Term Backup Schedule> Details for the long-term backup schedule.
- max
Cpu IntegerCore Count (Updatable) The number of Max OCPU cores to be made available to the autonomous database with auto scaling of cpu enabled.
- memory
Per IntegerOracle Compute Unit In Gbs The amount of memory (in GBs) enabled per each OCPU core in Autonomous VM Cluster.
- ncharacter
Set String The national character set for the autonomous database. The default is AL16UTF16. Allowed values are: AL16UTF16 or UTF8.
- next
Long StringTerm Backup Time Stamp The date and time when the next long-term backup would be created.
- nsg
Ids List<String> (Updatable) The list of OCIDs for the network security groups (NSGs) to which this resource belongs. Setting this to an empty list removes all resources from all NSGs. For more information about NSGs, see Security Rules. NsgIds restrictions:
- A network security group (NSG) is optional for Autonomous Databases with private access. The nsgIds list can be empty.
- ocpu
Count Double (Updatable) The number of OCPU cores to be made available to the database.
The following points apply:
- For Autonomous Databases on dedicated Exadata infrastructure, to provision less than 1 core, enter a fractional value in an increment of 0.1. For example, you can provision 0.3 or 0.4 cores, but not 0.35 cores. (Note that fractional OCPU values are not supported for Autonomous Databasese on shared Exadata infrastructure.)
- To provision 1 or more cores, you must enter an integer between 1 and the maximum number of cores available for the infrastructure shape. For example, you can provision 2 cores or 3 cores, but not 2.5 cores. This applies to Autonomous Databases on both shared and dedicated Exadata infrastructure.
For Autonomous Databases on dedicated Exadata infrastructure, the maximum number of cores is determined by the infrastructure shape. See Characteristics of Infrastructure Shapes for shape details.
Note: This parameter cannot be used with the
cpuCoreCount
parameter.- open
Mode String Indicates the Autonomous Database mode. The database can be opened in
READ_ONLY
orREAD_WRITE
mode.- operations
Insights StringStatus (Updatable) Status of Operations Insights for this Autonomous Database. Values supported are
ENABLED
andNOT_ENABLED
- peer
Db List<String>Ids The list of OCIDs of standby databases located in Autonomous Data Guard remote regions that are associated with the source database. Note that for shared Exadata infrastructure, standby databases located in the same region as the source primary database do not have OCIDs.
- permission
Level String The Autonomous Database permission level. Restricted mode allows access only by admin users.
- private
Endpoint String The private endpoint for the resource.
- private
Endpoint StringIp The private endpoint Ip address for the resource.
- private
Endpoint StringLabel (Updatable) The private endpoint label for the resource.
- provisionable
Cpuses List<Double> An array of CPU values that an Autonomous Database can be scaled to.
- refreshable
Mode String (Updatable) The refresh mode of the clone. AUTOMATIC indicates that the clone is automatically being refreshed with data from the source Autonomous Database.
- refreshable
Status String The refresh status of the clone. REFRESHING indicates that the clone is currently being refreshed with data from the source Autonomous Database.
- remote
Disaster List<AutonomousRecovery Configurations Remote Disaster Recovery Configuration> Configurations of a Disaster Recovery.
- remote
Disaster StringRecovery Type Indicates the cross-region disaster recovery (DR) type of the standby Shared Autonomous Database. Autonomous Data Guard (ADG) DR type provides business critical DR with a faster recovery time objective (RTO) during failover or switchover. Backup-based DR type provides lower cost DR with a slower RTO during failover or switchover.
- resource
Pool StringLeader Id - resource
Pool AutonomousSummary Resource Pool Summary - role String
The Data Guard role of the Autonomous Container Database or Autonomous Database, if Autonomous Data Guard is enabled.
- rotate
Key BooleanTrigger (Updatable) An optional property when flipped triggers rotation of KMS key. It is only applicable on dedicated databases i.e. where
is_dedicated
is true.- scheduled
Operations List<AutonomousScheduled Operation> (Updatable) The list of scheduled operations.
This cannot be updated in parallel with any of the following: licenseModel, dbEdition, cpuCoreCount, computeCount, computeModel, whitelistedIps, isMTLSConnectionRequired, openMode, permissionLevel, dbWorkload, privateEndpointLabel, nsgIds, dbVersion, isRefreshable, dbName, dbToolsDetails, isLocalDataGuardEnabled, or isFreeTier.
- secret
Id String (Updatable) The Oracle Cloud Infrastructure vault secret [/Content/General/Concepts/identifiers.htm]OCID.
- secret
Version IntegerNumber (Updatable) The version of the vault secret. If no version is specified, the latest version will be used.
- service
Console StringUrl The URL of the Service Console for the Autonomous Database.
- source String
The source of the database: Use
NONE
for creating a new Autonomous Database. UseDATABASE
for creating a new Autonomous Database by cloning an existing Autonomous Database. UseCROSS_REGION_DATAGUARD
to create a standby Data Guard database in another region.For Autonomous Databases on shared Exadata infrastructure, the following cloning options are available: Use
BACKUP_FROM_ID
for creating a new Autonomous Database from a specified backup. UseBACKUP_FROM_TIMESTAMP
for creating a point-in-time Autonomous Database clone using backups. For more information, see Cloning and Moving an Autonomous Database.- source
Id String The OCID of the source Autonomous Database that will be used to create a new standby database for the Data Guard association.
- standby
Dbs List<AutonomousStandby Db> Deprecated Autonomous Data Guard standby database details.
- standby
Whitelisted List<String>Ips (Updatable) The client IP access control list (ACL). This feature is available for autonomous databases on shared Exadata infrastructure and on Exadata Cloud@Customer. Only clients connecting from an IP address included in the ACL may access the Autonomous Database instance.
For shared Exadata infrastructure, this is an array of CIDR (Classless Inter-Domain Routing) notations for a subnet or VCN OCID. Use a semicolon (;) as a deliminator between the VCN-specific subnets or IPs. Example:
["1.1.1.1","1.1.1.0/24","ocid1.vcn.oc1.sea.<unique_id>","ocid1.vcn.oc1.sea.<unique_id1>;1.1.1.1","ocid1.vcn.oc1.sea.<unique_id2>;1.1.0.0/16"]
For Exadata Cloud@Customer, this is an array of IP addresses or CIDR (Classless Inter-Domain Routing) notations. Example:["1.1.1.1","1.1.1.0/24","1.1.2.25"]
For an update operation, if you want to delete all the IPs in the ACL, use an array with a single empty string entry.
This cannot be updated in parallel with any of the following: licenseModel, dbEdition, cpuCoreCount, computeCount, computeModel, adminPassword, isMTLSConnectionRequired, openMode, permissionLevel, dbWorkload, dbVersion, isRefreshable, dbName, scheduledOperations, dbToolsDetails, isLocalDataGuardEnabled, or isFreeTier.
- state String
The current state of the Autonomous Database.
- subnet
Id String (Updatable) The OCID of the subnet the resource is associated with.
Subnet Restrictions:
- For bare metal DB systems and for single node virtual machine DB systems, do not use a subnet that overlaps with 192.168.16.16/28.
- For Exadata and virtual machine 2-node RAC systems, do not use a subnet that overlaps with 192.168.128.0/20.
- For Autonomous Database, setting this will disable public secure access to the database.
These subnets are used by the Oracle Clusterware private interconnect on the database instance. Specifying an overlapping subnet will cause the private interconnect to malfunction. This restriction applies to both the client subnet and the backup subnet.
- supported
Regions List<String>To Clone Tos The list of regions that support the creation of an Autonomous Database clone or an Autonomous Data Guard standby database.
- switchover
To String It is applicable only when
is_data_guard_enabled
is true. Could be set toPRIMARY
orSTANDBY
. Default value isPRIMARY
.- switchover
To StringRemote Peer Id (Updatable) It is applicable only when
dataguard_region_type
androle
are set, andis_dedicated
is false. It takes the OCID of the remote peer to switchover to.- Map<String,Object>
System tags for this resource. Each key is predefined and scoped to a namespace. For more information, see Resource Tags.
- time
Created String The date and time the Autonomous Database was created.
- time
Data StringGuard Role Changed The date and time the Autonomous Data Guard role was switched for the Autonomous Database. For databases that have standbys in both the primary Data Guard region and a remote Data Guard standby region, this is the latest timestamp of either the database using the "primary" role in the primary Data Guard region, or database located in the remote Data Guard standby region.
- time
Deletion StringOf Free Autonomous Database The date and time the Always Free database will be automatically deleted because of inactivity. If the database is in the STOPPED state and without activity until this time, it will be deleted.
- time
Disaster StringRecovery Role Changed The date and time the Disaster Recovery role was switched for the standby Autonomous Database.
- time
Local StringData Guard Enabled The date and time that Autonomous Data Guard was enabled for an Autonomous Database where the standby was provisioned in the same region as the primary database.
- time
Maintenance StringBegin The date and time when maintenance will begin.
- time
Maintenance StringEnd The date and time when maintenance will end.
- time
Of StringJoining Resource Pool - time
Of StringLast Failover The timestamp of the last failover operation.
- time
Of StringLast Refresh The date and time when last refresh happened.
- time
Of StringLast Refresh Point The refresh point timestamp (UTC). The refresh point is the time to which the database was most recently refreshed. Data created after the refresh point is not included in the refresh.
- time
Of StringLast Switchover The timestamp of the last switchover operation for the Autonomous Database.
- time
Of StringNext Refresh The date and time of next refresh.
- time
Reclamation StringOf Free Autonomous Database The date and time the Always Free database will be stopped because of inactivity. If this time is reached without any database activity, the database will automatically be put into the STOPPED state.
- time
Until StringReconnect Clone Enabled The time and date as an RFC3339 formatted string, e.g., 2022-01-01T12:00:00.000Z, to set the limit for a refreshable clone to be reconnected to its source database.
- timestamp String
The timestamp specified for the point-in-time clone of the source Autonomous Database. The timestamp must be in the past.
- total
Backup DoubleStorage Size In Gbs The backup storage to the database.
- use
Latest BooleanAvailable Backup Time Stamp Clone from latest available backup timestamp.
- used
Data IntegerStorage Size In Gbs The storage space consumed by Autonomous Database in GBs.
- used
Data IntegerStorage Size In Tbs The amount of storage that has been used, in terabytes.
- vault
Id String - whitelisted
Ips List<String> (Updatable) The client IP access control list (ACL). This feature is available for autonomous databases on shared Exadata infrastructure and on Exadata Cloud@Customer. Only clients connecting from an IP address included in the ACL may access the Autonomous Database instance.
For shared Exadata infrastructure, this is an array of CIDR (Classless Inter-Domain Routing) notations for a subnet or VCN OCID. Use a semicolon (;) as a deliminator between the VCN-specific subnets or IPs. Example:
["1.1.1.1","1.1.1.0/24","ocid1.vcn.oc1.sea.<unique_id>","ocid1.vcn.oc1.sea.<unique_id1>;1.1.1.1","ocid1.vcn.oc1.sea.<unique_id2>;1.1.0.0/16"]
For Exadata Cloud@Customer, this is an array of IP addresses or CIDR (Classless Inter-Domain Routing) notations. Example:["1.1.1.1","1.1.1.0/24","1.1.2.25"]
For an update operation, if you want to delete all the IPs in the ACL, use an array with a single empty string entry.
This cannot be updated in parallel with any of the following: licenseModel, dbEdition, cpuCoreCount, computeCount, computeModel, adminPassword, isMTLSConnectionRequired, openMode, permissionLevel, dbWorkload, dbVersion, isRefreshable, dbName, scheduledOperations, dbToolsDetails, isLocalDataGuardEnabled, or isFreeTier. To remove all whitelisted IPs, set the field to a list with an empty string
[""]
.This cannot be updated in parallel with any of the following: licenseModel, dbEdition, cpuCoreCount, computeCount, computeModel, adminPassword, isMTLSConnectionRequired, openMode, permissionLevel, dbWorkload, dbVersion, isRefreshable, dbName, scheduledOperations, dbToolsDetails, isLocalDataGuardEnabled, or isFreeTier. To remove all whitelisted IPs, set the field to a list with an empty string
[""]
.
- actual
Used numberData Storage Size In Tbs The current amount of storage in use for user and system data, in terabytes (TB).
- admin
Password string (Updatable) The password must be between 12 and 30 characters long, and must contain at least 1 uppercase, 1 lowercase, and 1 numeric character. It cannot contain the double quote symbol (") or the username "admin", regardless of casing. The password is mandatory if source value is "BACKUP_FROM_ID", "BACKUP_FROM_TIMESTAMP", "DATABASE" or "NONE".
- allocated
Storage numberSize In Tbs The amount of storage currently allocated for the database tables and billed for, rounded up. When auto-scaling is not enabled, this value is equal to the
dataStorageSizeInTBs
value. You can compare this value to theactualUsedDataStorageSizeInTBs
value to determine if a manual shrink operation is appropriate for your allocated storage.- apex
Details AutonomousDatabase Apex Detail[] Information about Oracle APEX Application Development.
- are
Primary booleanWhitelisted Ips Used (Updatable) This field will be null if the Autonomous Database is not Data Guard enabled or Access Control is disabled. It's value would be
TRUE
if Autonomous Database is Data Guard enabled and Access Control is enabled and if the Autonomous Database uses primary IP access control list (ACL) for standby. It's value would beFALSE
if Autonomous Database is Data Guard enabled and Access Control is enabled and if the Autonomous Database uses different IP access control list (ACL) for standby compared to primary.- autonomous
Container stringDatabase Id The Autonomous Container Database OCID.
- autonomous
Database stringBackup Id The OCID of the source Autonomous Database Backup that you will clone to create a new Autonomous Database.
- autonomous
Database stringId The OCID of the source Autonomous Database that you will clone to create a new Autonomous Database.
- autonomous
Maintenance stringSchedule Type The maintenance schedule type of the Autonomous Database on shared Exadata infrastructure. The EARLY maintenance schedule of this Autonomous Database follows a schedule that applies patches prior to the REGULAR schedule.The REGULAR maintenance schedule of this Autonomous Database follows the normal cycle.
- available
Upgrade string[]Versions List of Oracle Database versions available for a database upgrade. If there are no version upgrades available, this list is empty.
- backup
Configs AutonomousDatabase Backup Config[] Autonomous Database configuration details for storing manual backups in the Object Storage service.
- backup
Retention numberPeriod In Days (Updatable) Retention period, in days, for backups.
- character
Set string The character set for the autonomous database. The default is AL32UTF8. Allowed values for an Autonomous Database on shared infrastructure as as returned by List Autonomous Database Character Sets
For an Autonomous Database on dedicated infrastructure, the allowed values are:
AL32UTF8, AR8ADOS710, AR8ADOS720, AR8APTEC715, AR8ARABICMACS, AR8ASMO8X, AR8ISO8859P6, AR8MSWIN1256, AR8MUSSAD768, AR8NAFITHA711, AR8NAFITHA721, AR8SAKHR706, AR8SAKHR707, AZ8ISO8859P9E, BG8MSWIN, BG8PC437S, BLT8CP921, BLT8ISO8859P13, BLT8MSWIN1257, BLT8PC775, BN8BSCII, CDN8PC863, CEL8ISO8859P14, CL8ISO8859P5, CL8ISOIR111, CL8KOI8R, CL8KOI8U, CL8MACCYRILLICS, CL8MSWIN1251, EE8ISO8859P2, EE8MACCES, EE8MACCROATIANS, EE8MSWIN1250, EE8PC852, EL8DEC, EL8ISO8859P7, EL8MACGREEKS, EL8MSWIN1253, EL8PC437S, EL8PC851, EL8PC869, ET8MSWIN923, HU8ABMOD, HU8CWI2, IN8ISCII, IS8PC861, IW8ISO8859P8, IW8MACHEBREWS, IW8MSWIN1255, IW8PC1507, JA16EUC, JA16EUCTILDE, JA16SJIS, JA16SJISTILDE, JA16VMS, KO16KSC5601, KO16KSCCS, KO16MSWIN949, LA8ISO6937, LA8PASSPORT, LT8MSWIN921, LT8PC772, LT8PC774, LV8PC1117, LV8PC8LR, LV8RST104090, N8PC865, NE8ISO8859P10, NEE8ISO8859P4, RU8BESTA, RU8PC855, RU8PC866, SE8ISO8859P3, TH8MACTHAIS, TH8TISASCII, TR8DEC, TR8MACTURKISHS, TR8MSWIN1254, TR8PC857, US7ASCII, US8PC437, UTF8, VN8MSWIN1258, VN8VN3, WE8DEC, WE8DG, WE8ISO8859P1, WE8ISO8859P15, WE8ISO8859P9, WE8MACROMAN8S, WE8MSWIN1252, WE8NCR4970, WE8NEXTSTEP, WE8PC850, WE8PC858, WE8PC860, WE8ROMAN8, ZHS16CGB231280, ZHS16GBK, ZHT16BIG5, ZHT16CCDC, ZHT16DBT, ZHT16HKSCS, ZHT16MSWIN950, ZHT32EUC, ZHT32SOPS, ZHT32TRIS
- clone
Type string The Autonomous Database clone type.
- compartment
Id string (Updatable) The OCID of the compartment of the Autonomous Database.
- compute
Count number (Updatable) The compute amount available to the database. Minimum and maximum values depend on the compute model and whether the database is on Shared or Dedicated infrastructure. For an Autonomous Database on Shared infrastructure, the 'ECPU' compute model requires values in multiples of two. Required when using the
computeModel
parameter. When usingcpuCoreCount
parameter, it is an error to specify computeCount to a non-null value.- compute
Model string (Updatable) The compute model of the Autonomous Database. This is required if using the
computeCount
parameter. If usingcpuCoreCount
then it is an error to specifycomputeModel
to a non-null value.- connection
Strings AutonomousDatabase Connection String[] The connection string used to connect to the Autonomous Database. The username for the Service Console is ADMIN. Use the password you entered when creating the Autonomous Database for the password value.
- connection
Urls AutonomousDatabase Connection Url[] The URLs for accessing Oracle Application Express (APEX) and SQL Developer Web with a browser from a Compute instance within your VCN or that has a direct connection to your VCN. Note that these URLs are provided by the console only for databases on dedicated Exadata infrastructure. Example:
{"sqlDevWebUrl": "https://<hostname>/ords...", "apexUrl", "https://<hostname>/ords..."}
- cpu
Core numberCount (Updatable) The number of OCPU cores to be made available to the database. For Autonomous Databases on dedicated Exadata infrastructure, the maximum number of cores is determined by the infrastructure shape. See Characteristics of Infrastructure Shapes for shape details. Note: This parameter cannot be used with the
ocpuCount
parameter. This input is ignored for Always Free resources.- The data type must be an integer.
- The minimum number of cores for all types of autonomous database is 1
- The maximum number of cores is as follows:
- Autonomous Databases on shared Exadata infrastructure: The maximum number of cores is 128.
- Autonomous Databases on dedicated Exadata infrastructure: The maximum number of cores is determined by the infrastructure shape. See Characteristics of Infrastructure Shapes for shape details.
- customer
Contacts AutonomousDatabase Customer Contact[] (Updatable) Customer Contacts.
- data
Safe stringStatus (Updatable) Status of the Data Safe registration for this Autonomous Database. Could be REGISTERED or NOT_REGISTERED.
- data
Storage numberSize In Gb (Updatable) The size, in gigabytes, of the data volume that will be created and attached to the database. This storage can later be scaled up if needed. The maximum storage value is determined by the infrastructure shape. See Characteristics of Infrastructure Shapes for shape details.
Notes
- This parameter is only supported for dedicated Exadata infrastructure.
- This parameter cannot be used with the
dataStorageSizeInTBs
parameter.
- data
Storage numberSize In Tbs (Updatable) The size, in terabytes, of the data volume that will be created and attached to the database. This storage can later be scaled up if needed. For Autonomous Databases on dedicated Exadata infrastructure, the maximum storage value is determined by the infrastructure shape. See Characteristics of Infrastructure Shapes for shape details. A full Exadata service is allocated when the Autonomous Database size is set to the upper limit (384 TB).
Note: This parameter cannot be used with the
dataStorageSizeInGBs
parameter. This input is ignored for Always Free resources.- database
Edition string (Updatable) The Oracle Database Edition that applies to the Autonomous databases.
- database
Management stringStatus Status of Database Management for this Autonomous Database.
- dataguard
Region stringType The Autonomous Data Guard region type of the Autonomous Database. For Autonomous Databases on shared Exadata infrastructure, Data Guard associations have designated primary and standby regions, and these region types do not change when the database changes roles. The standby regions in Data Guard associations can be the same region designated as the primary region, or they can be remote regions. Certain database administrative operations may be available only in the primary region of the Data Guard association, and cannot be performed when the database using the "primary" role is operating in a remote Data Guard standby region.
- db
Name string (Updatable) Specify the database name; it must consist of letters and numbers only. The maximum length is 30 characters. The same database name cannot be used for multiple Autonomous Databases in the same tenancy in the same region.
- db
Version string (Updatable) A valid Oracle Database version for Autonomous Database.
db_workload
AJD and APEX are only supported fordb_version
19c
and above.- db
Workload string (Updatable) The Autonomous Database workload type. The following values are valid:
- OLTP - indicates an Autonomous Transaction Processing database
- DW - indicates an Autonomous Data Warehouse database
- AJD - indicates an Autonomous JSON Database
- APEX - indicates an Autonomous Database with the Oracle APEX Application Development workload type.
This cannot be updated in parallel with any of the following: licenseModel, dbEdition, cpuCoreCount, computeCount, computeModel, adminPassword, whitelistedIps, isMTLSConnectionRequired, privateEndpointLabel, nsgIds, dbVersion, isRefreshable, dbName, scheduledOperations, dbToolsDetails, isLocalDataGuardEnabled, or isFreeTier. *Note:
db_workload
can only be updated from AJD to OLTP or from a free OLTP to AJD.- {[key: string]: any}
(Updatable) Defined tags for this resource. Each key is predefined and scoped to a namespace. For more information, see Resource Tags.
- disaster
Recovery stringRegion Type The disaster recovery (DR) region type of the Autonomous Database. For Shared Autonomous Databases, DR associations have designated primary and standby regions. These region types do not change when the database changes roles. The standby region in DR associations can be the same region as the primary region, or they can be in a remote regions. Some database administration operations may be available only in the primary region of the DR association, and cannot be performed when the database using the primary role is operating in a remote region.
- display
Name string (Updatable) The user-friendly name for the Autonomous Database. The name does not have to be unique.
- failed
Data numberRecovery In Seconds Indicates the number of seconds of data loss for a Data Guard failover.
- {[key: string]: any}
(Updatable) Free-form tags for this resource. Each tag is a simple key-value pair with no predefined name, type, or namespace. For more information, see Resource Tags. Example:
{"Department": "Finance"}
- in
Memory numberArea In Gbs The area assigned to In-Memory tables in Autonomous Database.
- in
Memory numberPercentage (Updatable) The percentage of the System Global Area(SGA) assigned to In-Memory tables in Autonomous Database.
- infrastructure
Type string The infrastructure type this resource belongs to.
- is
Access booleanControl Enabled (Updatable) Indicates if the database-level access control is enabled. If disabled, database access is defined by the network security rules. If enabled, database access is restricted to the IP addresses defined by the rules specified with the
whitelistedIps
property. While specifyingwhitelistedIps
rules is optional, if database-level access control is enabled and no rules are specified, the database will become inaccessible. The rules can be added later using theUpdateAutonomousDatabase
API operation or edit option in console. When creating a database clone, the desired access control setting should be specified. By default, database-level access control will be disabled for the clone.This property is applicable only to Autonomous Databases on the Exadata Cloud@Customer platform.
- is
Auto booleanScaling Enabled (Updatable) Indicates if auto scaling is enabled for the Autonomous Database OCPU core count. The default value is
FALSE
.- is
Auto booleanScaling For Storage Enabled (Updatable) Indicates if auto scaling is enabled for the Autonomous Database storage. The default value is
FALSE
.- is
Data booleanGuard Enabled (Updatable) Deprecated. Indicates whether the Autonomous Database has local (in-region) Data Guard enabled. Not applicable to cross-region Autonomous Data Guard associations, or to Autonomous Databases using dedicated Exadata infrastructure or Exadata Cloud@Customer infrastructure.
- is
Dedicated boolean True if the database is on dedicated Exadata infrastructure.
- is
Free booleanTier (Updatable) Indicates if this is an Always Free resource. The default value is false. Note that Always Free Autonomous Databases have 1 CPU and 20GB of memory. For Always Free databases, memory and CPU cannot be scaled. When
db_workload
isAJD
orAPEX
it cannot betrue
.- is
Local booleanData Guard Enabled (Updatable) Indicates whether the Autonomous Database has local (in-region) Data Guard enabled. Not applicable to cross-region Autonomous Data Guard associations, or to Autonomous Databases using dedicated Exadata infrastructure or Exadata Cloud@Customer infrastructure.
- is
Mtls booleanConnection Required (Updatable) Indicates whether the Autonomous Database requires mTLS connections.
- is
Preview boolean Indicates if the Autonomous Database version is a preview version.
- is
Preview booleanVersion With Service Terms Accepted If set to
TRUE
, indicates that an Autonomous Database preview version is being provisioned, and that the preview version's terms of service have been accepted. Note that preview version software is only available for databases on shared Exadata infrastructure.- is
Reconnect booleanClone Enabled Indicates if the refreshable clone can be reconnected to its source database.
- is
Refreshable booleanClone (Updatable) True for creating a refreshable clone and False for detaching the clone from source Autonomous Database. Detaching is one time operation and clone becomes a regular Autonomous Database.
- is
Remote booleanData Guard Enabled Indicates whether the Autonomous Database has Cross Region Data Guard enabled. Not applicable to Autonomous Databases using dedicated Exadata infrastructure or Exadata Cloud@Customer infrastructure.
- is
Shrink booleanOnly (Updatable) An optional property when enabled triggers the Shrinking of Autonomous Database once. To trigger Shrinking of ADB once again, this flag needs to be disabled and re-enabled again. It should not be passed during create database operation. It is only applicable on shared databases i.e. where
is_dedicated
is false.** IMPORTANT ** Any change to a property that does not support update will force the destruction and recreation of the resource with the new property values
- key
History AutonomousEntries Database Key History Entry[] Key History Entry.
- key
Store stringId The OCID of the key store.
- key
Store stringWallet Name The wallet name for Oracle Key Vault.
- kms
Key stringId The OCID of the key container that is used as the master encryption key in database transparent data encryption (TDE) operations.
- kms
Key stringLifecycle Details KMS key lifecycle details.
- kms
Key stringVersion Id The OCID of the key container version that is used in database transparent data encryption (TDE) operations KMS Key can have multiple key versions. If none is specified, the current key version (latest) of the Key Id is used for the operation.
- license
Model string (Updatable) The Oracle license model that applies to the Oracle Autonomous Database. Bring your own license (BYOL) allows you to apply your current on-premises Oracle software licenses to equivalent, highly automated Oracle PaaS and IaaS services in the cloud. License Included allows you to subscribe to new Oracle Database software licenses and the Database service. Note that when provisioning an Autonomous Database on dedicated Exadata infrastructure, this attribute must be null because the attribute is already set at the Autonomous Exadata Infrastructure level. When using shared Exadata infrastructure, if a value is not specified, the system will supply the value of
BRING_YOUR_OWN_LICENSE
. It is a required field whendb_workload
is AJD and needs to be set toLICENSE_INCLUDED
as AJD does not support defaultlicense_model
valueBRING_YOUR_OWN_LICENSE
.- lifecycle
Details string Additional information about the current lifecycle state.
- local
Adg numberAuto Failover Max Data Loss Limit Parameter that allows users to select an acceptable maximum data loss limit in seconds, up to which Automatic Failover will be triggered when necessary for a Local Autonomous Data Guard
- local
Disaster stringRecovery Type Indicates the local disaster recovery (DR) type of the Shared Autonomous Database. Autonomous Data Guard (ADG) DR type provides business critical DR with a faster recovery time objective (RTO) during failover or switchover. Backup-based DR type provides lower cost DR with a slower RTO during failover or switchover.
- local
Standby AutonomousDbs Database Local Standby Db[] Autonomous Data Guard standby database details.
- long
Term AutonomousBackup Schedules Database Long Term Backup Schedule[] Details for the long-term backup schedule.
- max
Cpu numberCore Count (Updatable) The number of Max OCPU cores to be made available to the autonomous database with auto scaling of cpu enabled.
- memory
Per numberOracle Compute Unit In Gbs The amount of memory (in GBs) enabled per each OCPU core in Autonomous VM Cluster.
- ncharacter
Set string The national character set for the autonomous database. The default is AL16UTF16. Allowed values are: AL16UTF16 or UTF8.
- next
Long stringTerm Backup Time Stamp The date and time when the next long-term backup would be created.
- nsg
Ids string[] (Updatable) The list of OCIDs for the network security groups (NSGs) to which this resource belongs. Setting this to an empty list removes all resources from all NSGs. For more information about NSGs, see Security Rules. NsgIds restrictions:
- A network security group (NSG) is optional for Autonomous Databases with private access. The nsgIds list can be empty.
- ocpu
Count number (Updatable) The number of OCPU cores to be made available to the database.
The following points apply:
- For Autonomous Databases on dedicated Exadata infrastructure, to provision less than 1 core, enter a fractional value in an increment of 0.1. For example, you can provision 0.3 or 0.4 cores, but not 0.35 cores. (Note that fractional OCPU values are not supported for Autonomous Databasese on shared Exadata infrastructure.)
- To provision 1 or more cores, you must enter an integer between 1 and the maximum number of cores available for the infrastructure shape. For example, you can provision 2 cores or 3 cores, but not 2.5 cores. This applies to Autonomous Databases on both shared and dedicated Exadata infrastructure.
For Autonomous Databases on dedicated Exadata infrastructure, the maximum number of cores is determined by the infrastructure shape. See Characteristics of Infrastructure Shapes for shape details.
Note: This parameter cannot be used with the
cpuCoreCount
parameter.- open
Mode string Indicates the Autonomous Database mode. The database can be opened in
READ_ONLY
orREAD_WRITE
mode.- operations
Insights stringStatus (Updatable) Status of Operations Insights for this Autonomous Database. Values supported are
ENABLED
andNOT_ENABLED
- peer
Db string[]Ids The list of OCIDs of standby databases located in Autonomous Data Guard remote regions that are associated with the source database. Note that for shared Exadata infrastructure, standby databases located in the same region as the source primary database do not have OCIDs.
- permission
Level string The Autonomous Database permission level. Restricted mode allows access only by admin users.
- private
Endpoint string The private endpoint for the resource.
- private
Endpoint stringIp The private endpoint Ip address for the resource.
- private
Endpoint stringLabel (Updatable) The private endpoint label for the resource.
- provisionable
Cpuses number[] An array of CPU values that an Autonomous Database can be scaled to.
- refreshable
Mode string (Updatable) The refresh mode of the clone. AUTOMATIC indicates that the clone is automatically being refreshed with data from the source Autonomous Database.
- refreshable
Status string The refresh status of the clone. REFRESHING indicates that the clone is currently being refreshed with data from the source Autonomous Database.
- remote
Disaster AutonomousRecovery Configurations Database Remote Disaster Recovery Configuration[] Configurations of a Disaster Recovery.
- remote
Disaster stringRecovery Type Indicates the cross-region disaster recovery (DR) type of the standby Shared Autonomous Database. Autonomous Data Guard (ADG) DR type provides business critical DR with a faster recovery time objective (RTO) during failover or switchover. Backup-based DR type provides lower cost DR with a slower RTO during failover or switchover.
- resource
Pool stringLeader Id - resource
Pool AutonomousSummary Database Resource Pool Summary - role string
The Data Guard role of the Autonomous Container Database or Autonomous Database, if Autonomous Data Guard is enabled.
- rotate
Key booleanTrigger (Updatable) An optional property when flipped triggers rotation of KMS key. It is only applicable on dedicated databases i.e. where
is_dedicated
is true.- scheduled
Operations AutonomousDatabase Scheduled Operation[] (Updatable) The list of scheduled operations.
This cannot be updated in parallel with any of the following: licenseModel, dbEdition, cpuCoreCount, computeCount, computeModel, whitelistedIps, isMTLSConnectionRequired, openMode, permissionLevel, dbWorkload, privateEndpointLabel, nsgIds, dbVersion, isRefreshable, dbName, dbToolsDetails, isLocalDataGuardEnabled, or isFreeTier.
- secret
Id string (Updatable) The Oracle Cloud Infrastructure vault secret [/Content/General/Concepts/identifiers.htm]OCID.
- secret
Version numberNumber (Updatable) The version of the vault secret. If no version is specified, the latest version will be used.
- service
Console stringUrl The URL of the Service Console for the Autonomous Database.
- source string
The source of the database: Use
NONE
for creating a new Autonomous Database. UseDATABASE
for creating a new Autonomous Database by cloning an existing Autonomous Database. UseCROSS_REGION_DATAGUARD
to create a standby Data Guard database in another region.For Autonomous Databases on shared Exadata infrastructure, the following cloning options are available: Use
BACKUP_FROM_ID
for creating a new Autonomous Database from a specified backup. UseBACKUP_FROM_TIMESTAMP
for creating a point-in-time Autonomous Database clone using backups. For more information, see Cloning and Moving an Autonomous Database.- source
Id string The OCID of the source Autonomous Database that will be used to create a new standby database for the Data Guard association.
- standby
Dbs AutonomousDatabase Standby Db[] Deprecated Autonomous Data Guard standby database details.
- standby
Whitelisted string[]Ips (Updatable) The client IP access control list (ACL). This feature is available for autonomous databases on shared Exadata infrastructure and on Exadata Cloud@Customer. Only clients connecting from an IP address included in the ACL may access the Autonomous Database instance.
For shared Exadata infrastructure, this is an array of CIDR (Classless Inter-Domain Routing) notations for a subnet or VCN OCID. Use a semicolon (;) as a deliminator between the VCN-specific subnets or IPs. Example:
["1.1.1.1","1.1.1.0/24","ocid1.vcn.oc1.sea.<unique_id>","ocid1.vcn.oc1.sea.<unique_id1>;1.1.1.1","ocid1.vcn.oc1.sea.<unique_id2>;1.1.0.0/16"]
For Exadata Cloud@Customer, this is an array of IP addresses or CIDR (Classless Inter-Domain Routing) notations. Example:["1.1.1.1","1.1.1.0/24","1.1.2.25"]
For an update operation, if you want to delete all the IPs in the ACL, use an array with a single empty string entry.
This cannot be updated in parallel with any of the following: licenseModel, dbEdition, cpuCoreCount, computeCount, computeModel, adminPassword, isMTLSConnectionRequired, openMode, permissionLevel, dbWorkload, dbVersion, isRefreshable, dbName, scheduledOperations, dbToolsDetails, isLocalDataGuardEnabled, or isFreeTier.
- state string
The current state of the Autonomous Database.
- subnet
Id string (Updatable) The OCID of the subnet the resource is associated with.
Subnet Restrictions:
- For bare metal DB systems and for single node virtual machine DB systems, do not use a subnet that overlaps with 192.168.16.16/28.
- For Exadata and virtual machine 2-node RAC systems, do not use a subnet that overlaps with 192.168.128.0/20.
- For Autonomous Database, setting this will disable public secure access to the database.
These subnets are used by the Oracle Clusterware private interconnect on the database instance. Specifying an overlapping subnet will cause the private interconnect to malfunction. This restriction applies to both the client subnet and the backup subnet.
- supported
Regions string[]To Clone Tos The list of regions that support the creation of an Autonomous Database clone or an Autonomous Data Guard standby database.
- switchover
To string It is applicable only when
is_data_guard_enabled
is true. Could be set toPRIMARY
orSTANDBY
. Default value isPRIMARY
.- switchover
To stringRemote Peer Id (Updatable) It is applicable only when
dataguard_region_type
androle
are set, andis_dedicated
is false. It takes the OCID of the remote peer to switchover to.- {[key: string]: any}
System tags for this resource. Each key is predefined and scoped to a namespace. For more information, see Resource Tags.
- time
Created string The date and time the Autonomous Database was created.
- time
Data stringGuard Role Changed The date and time the Autonomous Data Guard role was switched for the Autonomous Database. For databases that have standbys in both the primary Data Guard region and a remote Data Guard standby region, this is the latest timestamp of either the database using the "primary" role in the primary Data Guard region, or database located in the remote Data Guard standby region.
- time
Deletion stringOf Free Autonomous Database The date and time the Always Free database will be automatically deleted because of inactivity. If the database is in the STOPPED state and without activity until this time, it will be deleted.
- time
Disaster stringRecovery Role Changed The date and time the Disaster Recovery role was switched for the standby Autonomous Database.
- time
Local stringData Guard Enabled The date and time that Autonomous Data Guard was enabled for an Autonomous Database where the standby was provisioned in the same region as the primary database.
- time
Maintenance stringBegin The date and time when maintenance will begin.
- time
Maintenance stringEnd The date and time when maintenance will end.
- time
Of stringJoining Resource Pool - time
Of stringLast Failover The timestamp of the last failover operation.
- time
Of stringLast Refresh The date and time when last refresh happened.
- time
Of stringLast Refresh Point The refresh point timestamp (UTC). The refresh point is the time to which the database was most recently refreshed. Data created after the refresh point is not included in the refresh.
- time
Of stringLast Switchover The timestamp of the last switchover operation for the Autonomous Database.
- time
Of stringNext Refresh The date and time of next refresh.
- time
Reclamation stringOf Free Autonomous Database The date and time the Always Free database will be stopped because of inactivity. If this time is reached without any database activity, the database will automatically be put into the STOPPED state.
- time
Until stringReconnect Clone Enabled The time and date as an RFC3339 formatted string, e.g., 2022-01-01T12:00:00.000Z, to set the limit for a refreshable clone to be reconnected to its source database.
- timestamp string
The timestamp specified for the point-in-time clone of the source Autonomous Database. The timestamp must be in the past.
- total
Backup numberStorage Size In Gbs The backup storage to the database.
- use
Latest booleanAvailable Backup Time Stamp Clone from latest available backup timestamp.
- used
Data numberStorage Size In Gbs The storage space consumed by Autonomous Database in GBs.
- used
Data numberStorage Size In Tbs The amount of storage that has been used, in terabytes.
- vault
Id string - whitelisted
Ips string[] (Updatable) The client IP access control list (ACL). This feature is available for autonomous databases on shared Exadata infrastructure and on Exadata Cloud@Customer. Only clients connecting from an IP address included in the ACL may access the Autonomous Database instance.
For shared Exadata infrastructure, this is an array of CIDR (Classless Inter-Domain Routing) notations for a subnet or VCN OCID. Use a semicolon (;) as a deliminator between the VCN-specific subnets or IPs. Example:
["1.1.1.1","1.1.1.0/24","ocid1.vcn.oc1.sea.<unique_id>","ocid1.vcn.oc1.sea.<unique_id1>;1.1.1.1","ocid1.vcn.oc1.sea.<unique_id2>;1.1.0.0/16"]
For Exadata Cloud@Customer, this is an array of IP addresses or CIDR (Classless Inter-Domain Routing) notations. Example:["1.1.1.1","1.1.1.0/24","1.1.2.25"]
For an update operation, if you want to delete all the IPs in the ACL, use an array with a single empty string entry.
This cannot be updated in parallel with any of the following: licenseModel, dbEdition, cpuCoreCount, computeCount, computeModel, adminPassword, isMTLSConnectionRequired, openMode, permissionLevel, dbWorkload, dbVersion, isRefreshable, dbName, scheduledOperations, dbToolsDetails, isLocalDataGuardEnabled, or isFreeTier. To remove all whitelisted IPs, set the field to a list with an empty string
[""]
.This cannot be updated in parallel with any of the following: licenseModel, dbEdition, cpuCoreCount, computeCount, computeModel, adminPassword, isMTLSConnectionRequired, openMode, permissionLevel, dbWorkload, dbVersion, isRefreshable, dbName, scheduledOperations, dbToolsDetails, isLocalDataGuardEnabled, or isFreeTier. To remove all whitelisted IPs, set the field to a list with an empty string
[""]
.
- actual_
used_ floatdata_ storage_ size_ in_ tbs The current amount of storage in use for user and system data, in terabytes (TB).
- admin_
password str (Updatable) The password must be between 12 and 30 characters long, and must contain at least 1 uppercase, 1 lowercase, and 1 numeric character. It cannot contain the double quote symbol (") or the username "admin", regardless of casing. The password is mandatory if source value is "BACKUP_FROM_ID", "BACKUP_FROM_TIMESTAMP", "DATABASE" or "NONE".
- allocated_
storage_ floatsize_ in_ tbs The amount of storage currently allocated for the database tables and billed for, rounded up. When auto-scaling is not enabled, this value is equal to the
dataStorageSizeInTBs
value. You can compare this value to theactualUsedDataStorageSizeInTBs
value to determine if a manual shrink operation is appropriate for your allocated storage.- apex_
details AutonomousDatabase Apex Detail Args] Information about Oracle APEX Application Development.
- are_
primary_ boolwhitelisted_ ips_ used (Updatable) This field will be null if the Autonomous Database is not Data Guard enabled or Access Control is disabled. It's value would be
TRUE
if Autonomous Database is Data Guard enabled and Access Control is enabled and if the Autonomous Database uses primary IP access control list (ACL) for standby. It's value would beFALSE
if Autonomous Database is Data Guard enabled and Access Control is enabled and if the Autonomous Database uses different IP access control list (ACL) for standby compared to primary.- autonomous_
container_ strdatabase_ id The Autonomous Container Database OCID.
- autonomous_
database_ strbackup_ id The OCID of the source Autonomous Database Backup that you will clone to create a new Autonomous Database.
- autonomous_
database_ strid The OCID of the source Autonomous Database that you will clone to create a new Autonomous Database.
- autonomous_
maintenance_ strschedule_ type The maintenance schedule type of the Autonomous Database on shared Exadata infrastructure. The EARLY maintenance schedule of this Autonomous Database follows a schedule that applies patches prior to the REGULAR schedule.The REGULAR maintenance schedule of this Autonomous Database follows the normal cycle.
- available_
upgrade_ Sequence[str]versions List of Oracle Database versions available for a database upgrade. If there are no version upgrades available, this list is empty.
- backup_
configs AutonomousDatabase Backup Config Args] Autonomous Database configuration details for storing manual backups in the Object Storage service.
- backup_
retention_ intperiod_ in_ days (Updatable) Retention period, in days, for backups.
- character_
set str The character set for the autonomous database. The default is AL32UTF8. Allowed values for an Autonomous Database on shared infrastructure as as returned by List Autonomous Database Character Sets
For an Autonomous Database on dedicated infrastructure, the allowed values are:
AL32UTF8, AR8ADOS710, AR8ADOS720, AR8APTEC715, AR8ARABICMACS, AR8ASMO8X, AR8ISO8859P6, AR8MSWIN1256, AR8MUSSAD768, AR8NAFITHA711, AR8NAFITHA721, AR8SAKHR706, AR8SAKHR707, AZ8ISO8859P9E, BG8MSWIN, BG8PC437S, BLT8CP921, BLT8ISO8859P13, BLT8MSWIN1257, BLT8PC775, BN8BSCII, CDN8PC863, CEL8ISO8859P14, CL8ISO8859P5, CL8ISOIR111, CL8KOI8R, CL8KOI8U, CL8MACCYRILLICS, CL8MSWIN1251, EE8ISO8859P2, EE8MACCES, EE8MACCROATIANS, EE8MSWIN1250, EE8PC852, EL8DEC, EL8ISO8859P7, EL8MACGREEKS, EL8MSWIN1253, EL8PC437S, EL8PC851, EL8PC869, ET8MSWIN923, HU8ABMOD, HU8CWI2, IN8ISCII, IS8PC861, IW8ISO8859P8, IW8MACHEBREWS, IW8MSWIN1255, IW8PC1507, JA16EUC, JA16EUCTILDE, JA16SJIS, JA16SJISTILDE, JA16VMS, KO16KSC5601, KO16KSCCS, KO16MSWIN949, LA8ISO6937, LA8PASSPORT, LT8MSWIN921, LT8PC772, LT8PC774, LV8PC1117, LV8PC8LR, LV8RST104090, N8PC865, NE8ISO8859P10, NEE8ISO8859P4, RU8BESTA, RU8PC855, RU8PC866, SE8ISO8859P3, TH8MACTHAIS, TH8TISASCII, TR8DEC, TR8MACTURKISHS, TR8MSWIN1254, TR8PC857, US7ASCII, US8PC437, UTF8, VN8MSWIN1258, VN8VN3, WE8DEC, WE8DG, WE8ISO8859P1, WE8ISO8859P15, WE8ISO8859P9, WE8MACROMAN8S, WE8MSWIN1252, WE8NCR4970, WE8NEXTSTEP, WE8PC850, WE8PC858, WE8PC860, WE8ROMAN8, ZHS16CGB231280, ZHS16GBK, ZHT16BIG5, ZHT16CCDC, ZHT16DBT, ZHT16HKSCS, ZHT16MSWIN950, ZHT32EUC, ZHT32SOPS, ZHT32TRIS
- clone_
type str The Autonomous Database clone type.
- compartment_
id str (Updatable) The OCID of the compartment of the Autonomous Database.
- compute_
count float (Updatable) The compute amount available to the database. Minimum and maximum values depend on the compute model and whether the database is on Shared or Dedicated infrastructure. For an Autonomous Database on Shared infrastructure, the 'ECPU' compute model requires values in multiples of two. Required when using the
computeModel
parameter. When usingcpuCoreCount
parameter, it is an error to specify computeCount to a non-null value.- compute_
model str (Updatable) The compute model of the Autonomous Database. This is required if using the
computeCount
parameter. If usingcpuCoreCount
then it is an error to specifycomputeModel
to a non-null value.- connection_
strings AutonomousDatabase Connection String Args] The connection string used to connect to the Autonomous Database. The username for the Service Console is ADMIN. Use the password you entered when creating the Autonomous Database for the password value.
- connection_
urls AutonomousDatabase Connection Url Args] The URLs for accessing Oracle Application Express (APEX) and SQL Developer Web with a browser from a Compute instance within your VCN or that has a direct connection to your VCN. Note that these URLs are provided by the console only for databases on dedicated Exadata infrastructure. Example:
{"sqlDevWebUrl": "https://<hostname>/ords...", "apexUrl", "https://<hostname>/ords..."}
- cpu_
core_ intcount (Updatable) The number of OCPU cores to be made available to the database. For Autonomous Databases on dedicated Exadata infrastructure, the maximum number of cores is determined by the infrastructure shape. See Characteristics of Infrastructure Shapes for shape details. Note: This parameter cannot be used with the
ocpuCount
parameter. This input is ignored for Always Free resources.- The data type must be an integer.
- The minimum number of cores for all types of autonomous database is 1
- The maximum number of cores is as follows:
- Autonomous Databases on shared Exadata infrastructure: The maximum number of cores is 128.
- Autonomous Databases on dedicated Exadata infrastructure: The maximum number of cores is determined by the infrastructure shape. See Characteristics of Infrastructure Shapes for shape details.
- customer_
contacts AutonomousDatabase Customer Contact Args] (Updatable) Customer Contacts.
- data_
safe_ strstatus (Updatable) Status of the Data Safe registration for this Autonomous Database. Could be REGISTERED or NOT_REGISTERED.
- data_
storage_ intsize_ in_ gb (Updatable) The size, in gigabytes, of the data volume that will be created and attached to the database. This storage can later be scaled up if needed. The maximum storage value is determined by the infrastructure shape. See Characteristics of Infrastructure Shapes for shape details.
Notes
- This parameter is only supported for dedicated Exadata infrastructure.
- This parameter cannot be used with the
dataStorageSizeInTBs
parameter.
- data_
storage_ intsize_ in_ tbs (Updatable) The size, in terabytes, of the data volume that will be created and attached to the database. This storage can later be scaled up if needed. For Autonomous Databases on dedicated Exadata infrastructure, the maximum storage value is determined by the infrastructure shape. See Characteristics of Infrastructure Shapes for shape details. A full Exadata service is allocated when the Autonomous Database size is set to the upper limit (384 TB).
Note: This parameter cannot be used with the
dataStorageSizeInGBs
parameter. This input is ignored for Always Free resources.- database_
edition str (Updatable) The Oracle Database Edition that applies to the Autonomous databases.
- database_
management_ strstatus Status of Database Management for this Autonomous Database.
- dataguard_
region_ strtype The Autonomous Data Guard region type of the Autonomous Database. For Autonomous Databases on shared Exadata infrastructure, Data Guard associations have designated primary and standby regions, and these region types do not change when the database changes roles. The standby regions in Data Guard associations can be the same region designated as the primary region, or they can be remote regions. Certain database administrative operations may be available only in the primary region of the Data Guard association, and cannot be performed when the database using the "primary" role is operating in a remote Data Guard standby region.
- db_
name str (Updatable) Specify the database name; it must consist of letters and numbers only. The maximum length is 30 characters. The same database name cannot be used for multiple Autonomous Databases in the same tenancy in the same region.
- db_
version str (Updatable) A valid Oracle Database version for Autonomous Database.
db_workload
AJD and APEX are only supported fordb_version
19c
and above.- db_
workload str (Updatable) The Autonomous Database workload type. The following values are valid:
- OLTP - indicates an Autonomous Transaction Processing database
- DW - indicates an Autonomous Data Warehouse database
- AJD - indicates an Autonomous JSON Database
- APEX - indicates an Autonomous Database with the Oracle APEX Application Development workload type.
This cannot be updated in parallel with any of the following: licenseModel, dbEdition, cpuCoreCount, computeCount, computeModel, adminPassword, whitelistedIps, isMTLSConnectionRequired, privateEndpointLabel, nsgIds, dbVersion, isRefreshable, dbName, scheduledOperations, dbToolsDetails, isLocalDataGuardEnabled, or isFreeTier. *Note:
db_workload
can only be updated from AJD to OLTP or from a free OLTP to AJD.- Mapping[str, Any]
(Updatable) Defined tags for this resource. Each key is predefined and scoped to a namespace. For more information, see Resource Tags.
- disaster_
recovery_ strregion_ type The disaster recovery (DR) region type of the Autonomous Database. For Shared Autonomous Databases, DR associations have designated primary and standby regions. These region types do not change when the database changes roles. The standby region in DR associations can be the same region as the primary region, or they can be in a remote regions. Some database administration operations may be available only in the primary region of the DR association, and cannot be performed when the database using the primary role is operating in a remote region.
- display_
name str (Updatable) The user-friendly name for the Autonomous Database. The name does not have to be unique.
- failed_
data_ intrecovery_ in_ seconds Indicates the number of seconds of data loss for a Data Guard failover.
- Mapping[str, Any]
(Updatable) Free-form tags for this resource. Each tag is a simple key-value pair with no predefined name, type, or namespace. For more information, see Resource Tags. Example:
{"Department": "Finance"}
- in_
memory_ intarea_ in_ gbs The area assigned to In-Memory tables in Autonomous Database.
- in_
memory_ intpercentage (Updatable) The percentage of the System Global Area(SGA) assigned to In-Memory tables in Autonomous Database.
- infrastructure_
type str The infrastructure type this resource belongs to.
- is_
access_ boolcontrol_ enabled (Updatable) Indicates if the database-level access control is enabled. If disabled, database access is defined by the network security rules. If enabled, database access is restricted to the IP addresses defined by the rules specified with the
whitelistedIps
property. While specifyingwhitelistedIps
rules is optional, if database-level access control is enabled and no rules are specified, the database will become inaccessible. The rules can be added later using theUpdateAutonomousDatabase
API operation or edit option in console. When creating a database clone, the desired access control setting should be specified. By default, database-level access control will be disabled for the clone.This property is applicable only to Autonomous Databases on the Exadata Cloud@Customer platform.
- is_
auto_ boolscaling_ enabled (Updatable) Indicates if auto scaling is enabled for the Autonomous Database OCPU core count. The default value is
FALSE
.- is_
auto_ boolscaling_ for_ storage_ enabled (Updatable) Indicates if auto scaling is enabled for the Autonomous Database storage. The default value is
FALSE
.- is_
data_ boolguard_ enabled (Updatable) Deprecated. Indicates whether the Autonomous Database has local (in-region) Data Guard enabled. Not applicable to cross-region Autonomous Data Guard associations, or to Autonomous Databases using dedicated Exadata infrastructure or Exadata Cloud@Customer infrastructure.
- is_
dedicated bool True if the database is on dedicated Exadata infrastructure.
- is_
free_ booltier (Updatable) Indicates if this is an Always Free resource. The default value is false. Note that Always Free Autonomous Databases have 1 CPU and 20GB of memory. For Always Free databases, memory and CPU cannot be scaled. When
db_workload
isAJD
orAPEX
it cannot betrue
.- is_
local_ booldata_ guard_ enabled (Updatable) Indicates whether the Autonomous Database has local (in-region) Data Guard enabled. Not applicable to cross-region Autonomous Data Guard associations, or to Autonomous Databases using dedicated Exadata infrastructure or Exadata Cloud@Customer infrastructure.
- is_
mtls_ boolconnection_ required (Updatable) Indicates whether the Autonomous Database requires mTLS connections.
- is_
preview bool Indicates if the Autonomous Database version is a preview version.
- is_
preview_ boolversion_ with_ service_ terms_ accepted If set to
TRUE
, indicates that an Autonomous Database preview version is being provisioned, and that the preview version's terms of service have been accepted. Note that preview version software is only available for databases on shared Exadata infrastructure.- is_
reconnect_ boolclone_ enabled Indicates if the refreshable clone can be reconnected to its source database.
- is_
refreshable_ boolclone (Updatable) True for creating a refreshable clone and False for detaching the clone from source Autonomous Database. Detaching is one time operation and clone becomes a regular Autonomous Database.
- is_
remote_ booldata_ guard_ enabled Indicates whether the Autonomous Database has Cross Region Data Guard enabled. Not applicable to Autonomous Databases using dedicated Exadata infrastructure or Exadata Cloud@Customer infrastructure.
- is_
shrink_ boolonly (Updatable) An optional property when enabled triggers the Shrinking of Autonomous Database once. To trigger Shrinking of ADB once again, this flag needs to be disabled and re-enabled again. It should not be passed during create database operation. It is only applicable on shared databases i.e. where
is_dedicated
is false.** IMPORTANT ** Any change to a property that does not support update will force the destruction and recreation of the resource with the new property values
- key_
history_ Autonomousentries Database Key History Entry Args] Key History Entry.
- key_
store_ strid The OCID of the key store.
- key_
store_ strwallet_ name The wallet name for Oracle Key Vault.
- kms_
key_ strid The OCID of the key container that is used as the master encryption key in database transparent data encryption (TDE) operations.
- kms_
key_ strlifecycle_ details KMS key lifecycle details.
- kms_
key_ strversion_ id The OCID of the key container version that is used in database transparent data encryption (TDE) operations KMS Key can have multiple key versions. If none is specified, the current key version (latest) of the Key Id is used for the operation.
- license_
model str (Updatable) The Oracle license model that applies to the Oracle Autonomous Database. Bring your own license (BYOL) allows you to apply your current on-premises Oracle software licenses to equivalent, highly automated Oracle PaaS and IaaS services in the cloud. License Included allows you to subscribe to new Oracle Database software licenses and the Database service. Note that when provisioning an Autonomous Database on dedicated Exadata infrastructure, this attribute must be null because the attribute is already set at the Autonomous Exadata Infrastructure level. When using shared Exadata infrastructure, if a value is not specified, the system will supply the value of
BRING_YOUR_OWN_LICENSE
. It is a required field whendb_workload
is AJD and needs to be set toLICENSE_INCLUDED
as AJD does not support defaultlicense_model
valueBRING_YOUR_OWN_LICENSE
.- lifecycle_
details str Additional information about the current lifecycle state.
- local_
adg_ intauto_ failover_ max_ data_ loss_ limit Parameter that allows users to select an acceptable maximum data loss limit in seconds, up to which Automatic Failover will be triggered when necessary for a Local Autonomous Data Guard
- local_
disaster_ strrecovery_ type Indicates the local disaster recovery (DR) type of the Shared Autonomous Database. Autonomous Data Guard (ADG) DR type provides business critical DR with a faster recovery time objective (RTO) during failover or switchover. Backup-based DR type provides lower cost DR with a slower RTO during failover or switchover.
- local_
standby_ Autonomousdbs Database Local Standby Db Args] Autonomous Data Guard standby database details.
- long_
term_ Autonomousbackup_ schedules Database Long Term Backup Schedule Args] Details for the long-term backup schedule.
- max_
cpu_ intcore_ count (Updatable) The number of Max OCPU cores to be made available to the autonomous database with auto scaling of cpu enabled.
- memory_
per_ intoracle_ compute_ unit_ in_ gbs The amount of memory (in GBs) enabled per each OCPU core in Autonomous VM Cluster.
- ncharacter_
set str The national character set for the autonomous database. The default is AL16UTF16. Allowed values are: AL16UTF16 or UTF8.
- next_
long_ strterm_ backup_ time_ stamp The date and time when the next long-term backup would be created.
- nsg_
ids Sequence[str] (Updatable) The list of OCIDs for the network security groups (NSGs) to which this resource belongs. Setting this to an empty list removes all resources from all NSGs. For more information about NSGs, see Security Rules. NsgIds restrictions:
- A network security group (NSG) is optional for Autonomous Databases with private access. The nsgIds list can be empty.
- ocpu_
count float (Updatable) The number of OCPU cores to be made available to the database.
The following points apply:
- For Autonomous Databases on dedicated Exadata infrastructure, to provision less than 1 core, enter a fractional value in an increment of 0.1. For example, you can provision 0.3 or 0.4 cores, but not 0.35 cores. (Note that fractional OCPU values are not supported for Autonomous Databasese on shared Exadata infrastructure.)
- To provision 1 or more cores, you must enter an integer between 1 and the maximum number of cores available for the infrastructure shape. For example, you can provision 2 cores or 3 cores, but not 2.5 cores. This applies to Autonomous Databases on both shared and dedicated Exadata infrastructure.
For Autonomous Databases on dedicated Exadata infrastructure, the maximum number of cores is determined by the infrastructure shape. See Characteristics of Infrastructure Shapes for shape details.
Note: This parameter cannot be used with the
cpuCoreCount
parameter.- open_
mode str Indicates the Autonomous Database mode. The database can be opened in
READ_ONLY
orREAD_WRITE
mode.- operations_
insights_ strstatus (Updatable) Status of Operations Insights for this Autonomous Database. Values supported are
ENABLED
andNOT_ENABLED
- peer_
db_ Sequence[str]ids The list of OCIDs of standby databases located in Autonomous Data Guard remote regions that are associated with the source database. Note that for shared Exadata infrastructure, standby databases located in the same region as the source primary database do not have OCIDs.
- permission_
level str The Autonomous Database permission level. Restricted mode allows access only by admin users.
- private_
endpoint str The private endpoint for the resource.
- private_
endpoint_ strip The private endpoint Ip address for the resource.
- private_
endpoint_ strlabel (Updatable) The private endpoint label for the resource.
- provisionable_
cpuses Sequence[float] An array of CPU values that an Autonomous Database can be scaled to.
- refreshable_
mode str (Updatable) The refresh mode of the clone. AUTOMATIC indicates that the clone is automatically being refreshed with data from the source Autonomous Database.
- refreshable_
status str The refresh status of the clone. REFRESHING indicates that the clone is currently being refreshed with data from the source Autonomous Database.
- remote_
disaster_ Autonomousrecovery_ configurations Database Remote Disaster Recovery Configuration Args] Configurations of a Disaster Recovery.
- remote_
disaster_ strrecovery_ type Indicates the cross-region disaster recovery (DR) type of the standby Shared Autonomous Database. Autonomous Data Guard (ADG) DR type provides business critical DR with a faster recovery time objective (RTO) during failover or switchover. Backup-based DR type provides lower cost DR with a slower RTO during failover or switchover.
- resource_
pool_ strleader_ id - resource_
pool_ Autonomoussummary Database Resource Pool Summary Args - role str
The Data Guard role of the Autonomous Container Database or Autonomous Database, if Autonomous Data Guard is enabled.
- rotate_
key_ booltrigger (Updatable) An optional property when flipped triggers rotation of KMS key. It is only applicable on dedicated databases i.e. where
is_dedicated
is true.- scheduled_
operations AutonomousDatabase Scheduled Operation Args] (Updatable) The list of scheduled operations.
This cannot be updated in parallel with any of the following: licenseModel, dbEdition, cpuCoreCount, computeCount, computeModel, whitelistedIps, isMTLSConnectionRequired, openMode, permissionLevel, dbWorkload, privateEndpointLabel, nsgIds, dbVersion, isRefreshable, dbName, dbToolsDetails, isLocalDataGuardEnabled, or isFreeTier.
- secret_
id str (Updatable) The Oracle Cloud Infrastructure vault secret [/Content/General/Concepts/identifiers.htm]OCID.
- secret_
version_ intnumber (Updatable) The version of the vault secret. If no version is specified, the latest version will be used.
- service_
console_ strurl The URL of the Service Console for the Autonomous Database.
- source str
The source of the database: Use
NONE
for creating a new Autonomous Database. UseDATABASE
for creating a new Autonomous Database by cloning an existing Autonomous Database. UseCROSS_REGION_DATAGUARD
to create a standby Data Guard database in another region.For Autonomous Databases on shared Exadata infrastructure, the following cloning options are available: Use
BACKUP_FROM_ID
for creating a new Autonomous Database from a specified backup. UseBACKUP_FROM_TIMESTAMP
for creating a point-in-time Autonomous Database clone using backups. For more information, see Cloning and Moving an Autonomous Database.- source_
id str The OCID of the source Autonomous Database that will be used to create a new standby database for the Data Guard association.
- standby_
dbs AutonomousDatabase Standby Db Args] Deprecated Autonomous Data Guard standby database details.
- standby_
whitelisted_ Sequence[str]ips (Updatable) The client IP access control list (ACL). This feature is available for autonomous databases on shared Exadata infrastructure and on Exadata Cloud@Customer. Only clients connecting from an IP address included in the ACL may access the Autonomous Database instance.
For shared Exadata infrastructure, this is an array of CIDR (Classless Inter-Domain Routing) notations for a subnet or VCN OCID. Use a semicolon (;) as a deliminator between the VCN-specific subnets or IPs. Example:
["1.1.1.1","1.1.1.0/24","ocid1.vcn.oc1.sea.<unique_id>","ocid1.vcn.oc1.sea.<unique_id1>;1.1.1.1","ocid1.vcn.oc1.sea.<unique_id2>;1.1.0.0/16"]
For Exadata Cloud@Customer, this is an array of IP addresses or CIDR (Classless Inter-Domain Routing) notations. Example:["1.1.1.1","1.1.1.0/24","1.1.2.25"]
For an update operation, if you want to delete all the IPs in the ACL, use an array with a single empty string entry.
This cannot be updated in parallel with any of the following: licenseModel, dbEdition, cpuCoreCount, computeCount, computeModel, adminPassword, isMTLSConnectionRequired, openMode, permissionLevel, dbWorkload, dbVersion, isRefreshable, dbName, scheduledOperations, dbToolsDetails, isLocalDataGuardEnabled, or isFreeTier.
- state str
The current state of the Autonomous Database.
- subnet_
id str (Updatable) The OCID of the subnet the resource is associated with.
Subnet Restrictions:
- For bare metal DB systems and for single node virtual machine DB systems, do not use a subnet that overlaps with 192.168.16.16/28.
- For Exadata and virtual machine 2-node RAC systems, do not use a subnet that overlaps with 192.168.128.0/20.
- For Autonomous Database, setting this will disable public secure access to the database.
These subnets are used by the Oracle Clusterware private interconnect on the database instance. Specifying an overlapping subnet will cause the private interconnect to malfunction. This restriction applies to both the client subnet and the backup subnet.
- supported_
regions_ Sequence[str]to_ clone_ tos The list of regions that support the creation of an Autonomous Database clone or an Autonomous Data Guard standby database.
- switchover_
to str It is applicable only when
is_data_guard_enabled
is true. Could be set toPRIMARY
orSTANDBY
. Default value isPRIMARY
.- switchover_
to_ strremote_ peer_ id (Updatable) It is applicable only when
dataguard_region_type
androle
are set, andis_dedicated
is false. It takes the OCID of the remote peer to switchover to.- Mapping[str, Any]
System tags for this resource. Each key is predefined and scoped to a namespace. For more information, see Resource Tags.
- time_
created str The date and time the Autonomous Database was created.
- time_
data_ strguard_ role_ changed The date and time the Autonomous Data Guard role was switched for the Autonomous Database. For databases that have standbys in both the primary Data Guard region and a remote Data Guard standby region, this is the latest timestamp of either the database using the "primary" role in the primary Data Guard region, or database located in the remote Data Guard standby region.
- time_
deletion_ strof_ free_ autonomous_ database The date and time the Always Free database will be automatically deleted because of inactivity. If the database is in the STOPPED state and without activity until this time, it will be deleted.
- time_
disaster_ strrecovery_ role_ changed The date and time the Disaster Recovery role was switched for the standby Autonomous Database.
- time_
local_ strdata_ guard_ enabled The date and time that Autonomous Data Guard was enabled for an Autonomous Database where the standby was provisioned in the same region as the primary database.
- time_
maintenance_ strbegin The date and time when maintenance will begin.
- time_
maintenance_ strend The date and time when maintenance will end.
- time_
of_ strjoining_ resource_ pool - time_
of_ strlast_ failover The timestamp of the last failover operation.
- time_
of_ strlast_ refresh The date and time when last refresh happened.
- time_
of_ strlast_ refresh_ point The refresh point timestamp (UTC). The refresh point is the time to which the database was most recently refreshed. Data created after the refresh point is not included in the refresh.
- time_
of_ strlast_ switchover The timestamp of the last switchover operation for the Autonomous Database.
- time_
of_ strnext_ refresh The date and time of next refresh.
- time_
reclamation_ strof_ free_ autonomous_ database The date and time the Always Free database will be stopped because of inactivity. If this time is reached without any database activity, the database will automatically be put into the STOPPED state.
- time_
until_ strreconnect_ clone_ enabled The time and date as an RFC3339 formatted string, e.g., 2022-01-01T12:00:00.000Z, to set the limit for a refreshable clone to be reconnected to its source database.
- timestamp str
The timestamp specified for the point-in-time clone of the source Autonomous Database. The timestamp must be in the past.
- total_
backup_ floatstorage_ size_ in_ gbs The backup storage to the database.
- use_
latest_ boolavailable_ backup_ time_ stamp Clone from latest available backup timestamp.
- used_
data_ intstorage_ size_ in_ gbs The storage space consumed by Autonomous Database in GBs.
- used_
data_ intstorage_ size_ in_ tbs The amount of storage that has been used, in terabytes.
- vault_
id str - whitelisted_
ips Sequence[str] (Updatable) The client IP access control list (ACL). This feature is available for autonomous databases on shared Exadata infrastructure and on Exadata Cloud@Customer. Only clients connecting from an IP address included in the ACL may access the Autonomous Database instance.
For shared Exadata infrastructure, this is an array of CIDR (Classless Inter-Domain Routing) notations for a subnet or VCN OCID. Use a semicolon (;) as a deliminator between the VCN-specific subnets or IPs. Example:
["1.1.1.1","1.1.1.0/24","ocid1.vcn.oc1.sea.<unique_id>","ocid1.vcn.oc1.sea.<unique_id1>;1.1.1.1","ocid1.vcn.oc1.sea.<unique_id2>;1.1.0.0/16"]
For Exadata Cloud@Customer, this is an array of IP addresses or CIDR (Classless Inter-Domain Routing) notations. Example:["1.1.1.1","1.1.1.0/24","1.1.2.25"]
For an update operation, if you want to delete all the IPs in the ACL, use an array with a single empty string entry.
This cannot be updated in parallel with any of the following: licenseModel, dbEdition, cpuCoreCount, computeCount, computeModel, adminPassword, isMTLSConnectionRequired, openMode, permissionLevel, dbWorkload, dbVersion, isRefreshable, dbName, scheduledOperations, dbToolsDetails, isLocalDataGuardEnabled, or isFreeTier. To remove all whitelisted IPs, set the field to a list with an empty string
[""]
.This cannot be updated in parallel with any of the following: licenseModel, dbEdition, cpuCoreCount, computeCount, computeModel, adminPassword, isMTLSConnectionRequired, openMode, permissionLevel, dbWorkload, dbVersion, isRefreshable, dbName, scheduledOperations, dbToolsDetails, isLocalDataGuardEnabled, or isFreeTier. To remove all whitelisted IPs, set the field to a list with an empty string
[""]
.
- actual
Used NumberData Storage Size In Tbs The current amount of storage in use for user and system data, in terabytes (TB).
- admin
Password String (Updatable) The password must be between 12 and 30 characters long, and must contain at least 1 uppercase, 1 lowercase, and 1 numeric character. It cannot contain the double quote symbol (") or the username "admin", regardless of casing. The password is mandatory if source value is "BACKUP_FROM_ID", "BACKUP_FROM_TIMESTAMP", "DATABASE" or "NONE".
- allocated
Storage NumberSize In Tbs The amount of storage currently allocated for the database tables and billed for, rounded up. When auto-scaling is not enabled, this value is equal to the
dataStorageSizeInTBs
value. You can compare this value to theactualUsedDataStorageSizeInTBs
value to determine if a manual shrink operation is appropriate for your allocated storage.- apex
Details List<Property Map> Information about Oracle APEX Application Development.
- are
Primary BooleanWhitelisted Ips Used (Updatable) This field will be null if the Autonomous Database is not Data Guard enabled or Access Control is disabled. It's value would be
TRUE
if Autonomous Database is Data Guard enabled and Access Control is enabled and if the Autonomous Database uses primary IP access control list (ACL) for standby. It's value would beFALSE
if Autonomous Database is Data Guard enabled and Access Control is enabled and if the Autonomous Database uses different IP access control list (ACL) for standby compared to primary.- autonomous
Container StringDatabase Id The Autonomous Container Database OCID.
- autonomous
Database StringBackup Id The OCID of the source Autonomous Database Backup that you will clone to create a new Autonomous Database.
- autonomous
Database StringId The OCID of the source Autonomous Database that you will clone to create a new Autonomous Database.
- autonomous
Maintenance StringSchedule Type The maintenance schedule type of the Autonomous Database on shared Exadata infrastructure. The EARLY maintenance schedule of this Autonomous Database follows a schedule that applies patches prior to the REGULAR schedule.The REGULAR maintenance schedule of this Autonomous Database follows the normal cycle.
- available
Upgrade List<String>Versions List of Oracle Database versions available for a database upgrade. If there are no version upgrades available, this list is empty.
- backup
Configs List<Property Map> Autonomous Database configuration details for storing manual backups in the Object Storage service.
- backup
Retention NumberPeriod In Days (Updatable) Retention period, in days, for backups.
- character
Set String The character set for the autonomous database. The default is AL32UTF8. Allowed values for an Autonomous Database on shared infrastructure as as returned by List Autonomous Database Character Sets
For an Autonomous Database on dedicated infrastructure, the allowed values are:
AL32UTF8, AR8ADOS710, AR8ADOS720, AR8APTEC715, AR8ARABICMACS, AR8ASMO8X, AR8ISO8859P6, AR8MSWIN1256, AR8MUSSAD768, AR8NAFITHA711, AR8NAFITHA721, AR8SAKHR706, AR8SAKHR707, AZ8ISO8859P9E, BG8MSWIN, BG8PC437S, BLT8CP921, BLT8ISO8859P13, BLT8MSWIN1257, BLT8PC775, BN8BSCII, CDN8PC863, CEL8ISO8859P14, CL8ISO8859P5, CL8ISOIR111, CL8KOI8R, CL8KOI8U, CL8MACCYRILLICS, CL8MSWIN1251, EE8ISO8859P2, EE8MACCES, EE8MACCROATIANS, EE8MSWIN1250, EE8PC852, EL8DEC, EL8ISO8859P7, EL8MACGREEKS, EL8MSWIN1253, EL8PC437S, EL8PC851, EL8PC869, ET8MSWIN923, HU8ABMOD, HU8CWI2, IN8ISCII, IS8PC861, IW8ISO8859P8, IW8MACHEBREWS, IW8MSWIN1255, IW8PC1507, JA16EUC, JA16EUCTILDE, JA16SJIS, JA16SJISTILDE, JA16VMS, KO16KSC5601, KO16KSCCS, KO16MSWIN949, LA8ISO6937, LA8PASSPORT, LT8MSWIN921, LT8PC772, LT8PC774, LV8PC1117, LV8PC8LR, LV8RST104090, N8PC865, NE8ISO8859P10, NEE8ISO8859P4, RU8BESTA, RU8PC855, RU8PC866, SE8ISO8859P3, TH8MACTHAIS, TH8TISASCII, TR8DEC, TR8MACTURKISHS, TR8MSWIN1254, TR8PC857, US7ASCII, US8PC437, UTF8, VN8MSWIN1258, VN8VN3, WE8DEC, WE8DG, WE8ISO8859P1, WE8ISO8859P15, WE8ISO8859P9, WE8MACROMAN8S, WE8MSWIN1252, WE8NCR4970, WE8NEXTSTEP, WE8PC850, WE8PC858, WE8PC860, WE8ROMAN8, ZHS16CGB231280, ZHS16GBK, ZHT16BIG5, ZHT16CCDC, ZHT16DBT, ZHT16HKSCS, ZHT16MSWIN950, ZHT32EUC, ZHT32SOPS, ZHT32TRIS
- clone
Type String The Autonomous Database clone type.
- compartment
Id String (Updatable) The OCID of the compartment of the Autonomous Database.
- compute
Count Number (Updatable) The compute amount available to the database. Minimum and maximum values depend on the compute model and whether the database is on Shared or Dedicated infrastructure. For an Autonomous Database on Shared infrastructure, the 'ECPU' compute model requires values in multiples of two. Required when using the
computeModel
parameter. When usingcpuCoreCount
parameter, it is an error to specify computeCount to a non-null value.- compute
Model String (Updatable) The compute model of the Autonomous Database. This is required if using the
computeCount
parameter. If usingcpuCoreCount
then it is an error to specifycomputeModel
to a non-null value.- connection
Strings List<Property Map> The connection string used to connect to the Autonomous Database. The username for the Service Console is ADMIN. Use the password you entered when creating the Autonomous Database for the password value.
- connection
Urls List<Property Map> The URLs for accessing Oracle Application Express (APEX) and SQL Developer Web with a browser from a Compute instance within your VCN or that has a direct connection to your VCN. Note that these URLs are provided by the console only for databases on dedicated Exadata infrastructure. Example:
{"sqlDevWebUrl": "https://<hostname>/ords...", "apexUrl", "https://<hostname>/ords..."}
- cpu
Core NumberCount (Updatable) The number of OCPU cores to be made available to the database. For Autonomous Databases on dedicated Exadata infrastructure, the maximum number of cores is determined by the infrastructure shape. See Characteristics of Infrastructure Shapes for shape details. Note: This parameter cannot be used with the
ocpuCount
parameter. This input is ignored for Always Free resources.- The data type must be an integer.
- The minimum number of cores for all types of autonomous database is 1
- The maximum number of cores is as follows:
- Autonomous Databases on shared Exadata infrastructure: The maximum number of cores is 128.
- Autonomous Databases on dedicated Exadata infrastructure: The maximum number of cores is determined by the infrastructure shape. See Characteristics of Infrastructure Shapes for shape details.
- customer
Contacts List<Property Map> (Updatable) Customer Contacts.
- data
Safe StringStatus (Updatable) Status of the Data Safe registration for this Autonomous Database. Could be REGISTERED or NOT_REGISTERED.
- data
Storage NumberSize In Gb (Updatable) The size, in gigabytes, of the data volume that will be created and attached to the database. This storage can later be scaled up if needed. The maximum storage value is determined by the infrastructure shape. See Characteristics of Infrastructure Shapes for shape details.
Notes
- This parameter is only supported for dedicated Exadata infrastructure.
- This parameter cannot be used with the
dataStorageSizeInTBs
parameter.
- data
Storage NumberSize In Tbs (Updatable) The size, in terabytes, of the data volume that will be created and attached to the database. This storage can later be scaled up if needed. For Autonomous Databases on dedicated Exadata infrastructure, the maximum storage value is determined by the infrastructure shape. See Characteristics of Infrastructure Shapes for shape details. A full Exadata service is allocated when the Autonomous Database size is set to the upper limit (384 TB).
Note: This parameter cannot be used with the
dataStorageSizeInGBs
parameter. This input is ignored for Always Free resources.- database
Edition String (Updatable) The Oracle Database Edition that applies to the Autonomous databases.
- database
Management StringStatus Status of Database Management for this Autonomous Database.
- dataguard
Region StringType The Autonomous Data Guard region type of the Autonomous Database. For Autonomous Databases on shared Exadata infrastructure, Data Guard associations have designated primary and standby regions, and these region types do not change when the database changes roles. The standby regions in Data Guard associations can be the same region designated as the primary region, or they can be remote regions. Certain database administrative operations may be available only in the primary region of the Data Guard association, and cannot be performed when the database using the "primary" role is operating in a remote Data Guard standby region.
- db
Name String (Updatable) Specify the database name; it must consist of letters and numbers only. The maximum length is 30 characters. The same database name cannot be used for multiple Autonomous Databases in the same tenancy in the same region.
- db
Version String (Updatable) A valid Oracle Database version for Autonomous Database.
db_workload
AJD and APEX are only supported fordb_version
19c
and above.- db
Workload String (Updatable) The Autonomous Database workload type. The following values are valid:
- OLTP - indicates an Autonomous Transaction Processing database
- DW - indicates an Autonomous Data Warehouse database
- AJD - indicates an Autonomous JSON Database
- APEX - indicates an Autonomous Database with the Oracle APEX Application Development workload type.
This cannot be updated in parallel with any of the following: licenseModel, dbEdition, cpuCoreCount, computeCount, computeModel, adminPassword, whitelistedIps, isMTLSConnectionRequired, privateEndpointLabel, nsgIds, dbVersion, isRefreshable, dbName, scheduledOperations, dbToolsDetails, isLocalDataGuardEnabled, or isFreeTier. *Note:
db_workload
can only be updated from AJD to OLTP or from a free OLTP to AJD.- Map<Any>
(Updatable) Defined tags for this resource. Each key is predefined and scoped to a namespace. For more information, see Resource Tags.
- disaster
Recovery StringRegion Type The disaster recovery (DR) region type of the Autonomous Database. For Shared Autonomous Databases, DR associations have designated primary and standby regions. These region types do not change when the database changes roles. The standby region in DR associations can be the same region as the primary region, or they can be in a remote regions. Some database administration operations may be available only in the primary region of the DR association, and cannot be performed when the database using the primary role is operating in a remote region.
- display
Name String (Updatable) The user-friendly name for the Autonomous Database. The name does not have to be unique.
- failed
Data NumberRecovery In Seconds Indicates the number of seconds of data loss for a Data Guard failover.
- Map<Any>
(Updatable) Free-form tags for this resource. Each tag is a simple key-value pair with no predefined name, type, or namespace. For more information, see Resource Tags. Example:
{"Department": "Finance"}
- in
Memory NumberArea In Gbs The area assigned to In-Memory tables in Autonomous Database.
- in
Memory NumberPercentage (Updatable) The percentage of the System Global Area(SGA) assigned to In-Memory tables in Autonomous Database.
- infrastructure
Type String The infrastructure type this resource belongs to.
- is
Access BooleanControl Enabled (Updatable) Indicates if the database-level access control is enabled. If disabled, database access is defined by the network security rules. If enabled, database access is restricted to the IP addresses defined by the rules specified with the
whitelistedIps
property. While specifyingwhitelistedIps
rules is optional, if database-level access control is enabled and no rules are specified, the database will become inaccessible. The rules can be added later using theUpdateAutonomousDatabase
API operation or edit option in console. When creating a database clone, the desired access control setting should be specified. By default, database-level access control will be disabled for the clone.This property is applicable only to Autonomous Databases on the Exadata Cloud@Customer platform.
- is
Auto BooleanScaling Enabled (Updatable) Indicates if auto scaling is enabled for the Autonomous Database OCPU core count. The default value is
FALSE
.- is
Auto BooleanScaling For Storage Enabled (Updatable) Indicates if auto scaling is enabled for the Autonomous Database storage. The default value is
FALSE
.- is
Data BooleanGuard Enabled (Updatable) Deprecated. Indicates whether the Autonomous Database has local (in-region) Data Guard enabled. Not applicable to cross-region Autonomous Data Guard associations, or to Autonomous Databases using dedicated Exadata infrastructure or Exadata Cloud@Customer infrastructure.
- is
Dedicated Boolean True if the database is on dedicated Exadata infrastructure.
- is
Free BooleanTier (Updatable) Indicates if this is an Always Free resource. The default value is false. Note that Always Free Autonomous Databases have 1 CPU and 20GB of memory. For Always Free databases, memory and CPU cannot be scaled. When
db_workload
isAJD
orAPEX
it cannot betrue
.- is
Local BooleanData Guard Enabled (Updatable) Indicates whether the Autonomous Database has local (in-region) Data Guard enabled. Not applicable to cross-region Autonomous Data Guard associations, or to Autonomous Databases using dedicated Exadata infrastructure or Exadata Cloud@Customer infrastructure.
- is
Mtls BooleanConnection Required (Updatable) Indicates whether the Autonomous Database requires mTLS connections.
- is
Preview Boolean Indicates if the Autonomous Database version is a preview version.
- is
Preview BooleanVersion With Service Terms Accepted If set to
TRUE
, indicates that an Autonomous Database preview version is being provisioned, and that the preview version's terms of service have been accepted. Note that preview version software is only available for databases on shared Exadata infrastructure.- is
Reconnect BooleanClone Enabled Indicates if the refreshable clone can be reconnected to its source database.
- is
Refreshable BooleanClone (Updatable) True for creating a refreshable clone and False for detaching the clone from source Autonomous Database. Detaching is one time operation and clone becomes a regular Autonomous Database.
- is
Remote BooleanData Guard Enabled Indicates whether the Autonomous Database has Cross Region Data Guard enabled. Not applicable to Autonomous Databases using dedicated Exadata infrastructure or Exadata Cloud@Customer infrastructure.
- is
Shrink BooleanOnly (Updatable) An optional property when enabled triggers the Shrinking of Autonomous Database once. To trigger Shrinking of ADB once again, this flag needs to be disabled and re-enabled again. It should not be passed during create database operation. It is only applicable on shared databases i.e. where
is_dedicated
is false.** IMPORTANT ** Any change to a property that does not support update will force the destruction and recreation of the resource with the new property values
- key
History List<Property Map>Entries Key History Entry.
- key
Store StringId The OCID of the key store.
- key
Store StringWallet Name The wallet name for Oracle Key Vault.
- kms
Key StringId The OCID of the key container that is used as the master encryption key in database transparent data encryption (TDE) operations.
- kms
Key StringLifecycle Details KMS key lifecycle details.
- kms
Key StringVersion Id The OCID of the key container version that is used in database transparent data encryption (TDE) operations KMS Key can have multiple key versions. If none is specified, the current key version (latest) of the Key Id is used for the operation.
- license
Model String (Updatable) The Oracle license model that applies to the Oracle Autonomous Database. Bring your own license (BYOL) allows you to apply your current on-premises Oracle software licenses to equivalent, highly automated Oracle PaaS and IaaS services in the cloud. License Included allows you to subscribe to new Oracle Database software licenses and the Database service. Note that when provisioning an Autonomous Database on dedicated Exadata infrastructure, this attribute must be null because the attribute is already set at the Autonomous Exadata Infrastructure level. When using shared Exadata infrastructure, if a value is not specified, the system will supply the value of
BRING_YOUR_OWN_LICENSE
. It is a required field whendb_workload
is AJD and needs to be set toLICENSE_INCLUDED
as AJD does not support defaultlicense_model
valueBRING_YOUR_OWN_LICENSE
.- lifecycle
Details String Additional information about the current lifecycle state.
- local
Adg NumberAuto Failover Max Data Loss Limit Parameter that allows users to select an acceptable maximum data loss limit in seconds, up to which Automatic Failover will be triggered when necessary for a Local Autonomous Data Guard
- local
Disaster StringRecovery Type Indicates the local disaster recovery (DR) type of the Shared Autonomous Database. Autonomous Data Guard (ADG) DR type provides business critical DR with a faster recovery time objective (RTO) during failover or switchover. Backup-based DR type provides lower cost DR with a slower RTO during failover or switchover.
- local
Standby List<Property Map>Dbs Autonomous Data Guard standby database details.
- long
Term List<Property Map>Backup Schedules Details for the long-term backup schedule.
- max
Cpu NumberCore Count (Updatable) The number of Max OCPU cores to be made available to the autonomous database with auto scaling of cpu enabled.
- memory
Per NumberOracle Compute Unit In Gbs The amount of memory (in GBs) enabled per each OCPU core in Autonomous VM Cluster.
- ncharacter
Set String The national character set for the autonomous database. The default is AL16UTF16. Allowed values are: AL16UTF16 or UTF8.
- next
Long StringTerm Backup Time Stamp The date and time when the next long-term backup would be created.
- nsg
Ids List<String> (Updatable) The list of OCIDs for the network security groups (NSGs) to which this resource belongs. Setting this to an empty list removes all resources from all NSGs. For more information about NSGs, see Security Rules. NsgIds restrictions:
- A network security group (NSG) is optional for Autonomous Databases with private access. The nsgIds list can be empty.
- ocpu
Count Number (Updatable) The number of OCPU cores to be made available to the database.
The following points apply:
- For Autonomous Databases on dedicated Exadata infrastructure, to provision less than 1 core, enter a fractional value in an increment of 0.1. For example, you can provision 0.3 or 0.4 cores, but not 0.35 cores. (Note that fractional OCPU values are not supported for Autonomous Databasese on shared Exadata infrastructure.)
- To provision 1 or more cores, you must enter an integer between 1 and the maximum number of cores available for the infrastructure shape. For example, you can provision 2 cores or 3 cores, but not 2.5 cores. This applies to Autonomous Databases on both shared and dedicated Exadata infrastructure.
For Autonomous Databases on dedicated Exadata infrastructure, the maximum number of cores is determined by the infrastructure shape. See Characteristics of Infrastructure Shapes for shape details.
Note: This parameter cannot be used with the
cpuCoreCount
parameter.- open
Mode String Indicates the Autonomous Database mode. The database can be opened in
READ_ONLY
orREAD_WRITE
mode.- operations
Insights StringStatus (Updatable) Status of Operations Insights for this Autonomous Database. Values supported are
ENABLED
andNOT_ENABLED
- peer
Db List<String>Ids The list of OCIDs of standby databases located in Autonomous Data Guard remote regions that are associated with the source database. Note that for shared Exadata infrastructure, standby databases located in the same region as the source primary database do not have OCIDs.
- permission
Level String The Autonomous Database permission level. Restricted mode allows access only by admin users.
- private
Endpoint String The private endpoint for the resource.
- private
Endpoint StringIp The private endpoint Ip address for the resource.
- private
Endpoint StringLabel (Updatable) The private endpoint label for the resource.
- provisionable
Cpuses List<Number> An array of CPU values that an Autonomous Database can be scaled to.
- refreshable
Mode String (Updatable) The refresh mode of the clone. AUTOMATIC indicates that the clone is automatically being refreshed with data from the source Autonomous Database.
- refreshable
Status String The refresh status of the clone. REFRESHING indicates that the clone is currently being refreshed with data from the source Autonomous Database.
- remote
Disaster List<Property Map>Recovery Configurations Configurations of a Disaster Recovery.
- remote
Disaster StringRecovery Type Indicates the cross-region disaster recovery (DR) type of the standby Shared Autonomous Database. Autonomous Data Guard (ADG) DR type provides business critical DR with a faster recovery time objective (RTO) during failover or switchover. Backup-based DR type provides lower cost DR with a slower RTO during failover or switchover.
- resource
Pool StringLeader Id - resource
Pool Property MapSummary - role String
The Data Guard role of the Autonomous Container Database or Autonomous Database, if Autonomous Data Guard is enabled.
- rotate
Key BooleanTrigger (Updatable) An optional property when flipped triggers rotation of KMS key. It is only applicable on dedicated databases i.e. where
is_dedicated
is true.- scheduled
Operations List<Property Map> (Updatable) The list of scheduled operations.
This cannot be updated in parallel with any of the following: licenseModel, dbEdition, cpuCoreCount, computeCount, computeModel, whitelistedIps, isMTLSConnectionRequired, openMode, permissionLevel, dbWorkload, privateEndpointLabel, nsgIds, dbVersion, isRefreshable, dbName, dbToolsDetails, isLocalDataGuardEnabled, or isFreeTier.
- secret
Id String (Updatable) The Oracle Cloud Infrastructure vault secret [/Content/General/Concepts/identifiers.htm]OCID.
- secret
Version NumberNumber (Updatable) The version of the vault secret. If no version is specified, the latest version will be used.
- service
Console StringUrl The URL of the Service Console for the Autonomous Database.
- source String
The source of the database: Use
NONE
for creating a new Autonomous Database. UseDATABASE
for creating a new Autonomous Database by cloning an existing Autonomous Database. UseCROSS_REGION_DATAGUARD
to create a standby Data Guard database in another region.For Autonomous Databases on shared Exadata infrastructure, the following cloning options are available: Use
BACKUP_FROM_ID
for creating a new Autonomous Database from a specified backup. UseBACKUP_FROM_TIMESTAMP
for creating a point-in-time Autonomous Database clone using backups. For more information, see Cloning and Moving an Autonomous Database.- source
Id String The OCID of the source Autonomous Database that will be used to create a new standby database for the Data Guard association.
- standby
Dbs List<Property Map> Deprecated Autonomous Data Guard standby database details.
- standby
Whitelisted List<String>Ips (Updatable) The client IP access control list (ACL). This feature is available for autonomous databases on shared Exadata infrastructure and on Exadata Cloud@Customer. Only clients connecting from an IP address included in the ACL may access the Autonomous Database instance.
For shared Exadata infrastructure, this is an array of CIDR (Classless Inter-Domain Routing) notations for a subnet or VCN OCID. Use a semicolon (;) as a deliminator between the VCN-specific subnets or IPs. Example:
["1.1.1.1","1.1.1.0/24","ocid1.vcn.oc1.sea.<unique_id>","ocid1.vcn.oc1.sea.<unique_id1>;1.1.1.1","ocid1.vcn.oc1.sea.<unique_id2>;1.1.0.0/16"]
For Exadata Cloud@Customer, this is an array of IP addresses or CIDR (Classless Inter-Domain Routing) notations. Example:["1.1.1.1","1.1.1.0/24","1.1.2.25"]
For an update operation, if you want to delete all the IPs in the ACL, use an array with a single empty string entry.
This cannot be updated in parallel with any of the following: licenseModel, dbEdition, cpuCoreCount, computeCount, computeModel, adminPassword, isMTLSConnectionRequired, openMode, permissionLevel, dbWorkload, dbVersion, isRefreshable, dbName, scheduledOperations, dbToolsDetails, isLocalDataGuardEnabled, or isFreeTier.
- state String
The current state of the Autonomous Database.
- subnet
Id String (Updatable) The OCID of the subnet the resource is associated with.
Subnet Restrictions:
- For bare metal DB systems and for single node virtual machine DB systems, do not use a subnet that overlaps with 192.168.16.16/28.
- For Exadata and virtual machine 2-node RAC systems, do not use a subnet that overlaps with 192.168.128.0/20.
- For Autonomous Database, setting this will disable public secure access to the database.
These subnets are used by the Oracle Clusterware private interconnect on the database instance. Specifying an overlapping subnet will cause the private interconnect to malfunction. This restriction applies to both the client subnet and the backup subnet.
- supported
Regions List<String>To Clone Tos The list of regions that support the creation of an Autonomous Database clone or an Autonomous Data Guard standby database.
- switchover
To String It is applicable only when
is_data_guard_enabled
is true. Could be set toPRIMARY
orSTANDBY
. Default value isPRIMARY
.- switchover
To StringRemote Peer Id (Updatable) It is applicable only when
dataguard_region_type
androle
are set, andis_dedicated
is false. It takes the OCID of the remote peer to switchover to.- Map<Any>
System tags for this resource. Each key is predefined and scoped to a namespace. For more information, see Resource Tags.
- time
Created String The date and time the Autonomous Database was created.
- time
Data StringGuard Role Changed The date and time the Autonomous Data Guard role was switched for the Autonomous Database. For databases that have standbys in both the primary Data Guard region and a remote Data Guard standby region, this is the latest timestamp of either the database using the "primary" role in the primary Data Guard region, or database located in the remote Data Guard standby region.
- time
Deletion StringOf Free Autonomous Database The date and time the Always Free database will be automatically deleted because of inactivity. If the database is in the STOPPED state and without activity until this time, it will be deleted.
- time
Disaster StringRecovery Role Changed The date and time the Disaster Recovery role was switched for the standby Autonomous Database.
- time
Local StringData Guard Enabled The date and time that Autonomous Data Guard was enabled for an Autonomous Database where the standby was provisioned in the same region as the primary database.
- time
Maintenance StringBegin The date and time when maintenance will begin.
- time
Maintenance StringEnd The date and time when maintenance will end.
- time
Of StringJoining Resource Pool - time
Of StringLast Failover The timestamp of the last failover operation.
- time
Of StringLast Refresh The date and time when last refresh happened.
- time
Of StringLast Refresh Point The refresh point timestamp (UTC). The refresh point is the time to which the database was most recently refreshed. Data created after the refresh point is not included in the refresh.
- time
Of StringLast Switchover The timestamp of the last switchover operation for the Autonomous Database.
- time
Of StringNext Refresh The date and time of next refresh.
- time
Reclamation StringOf Free Autonomous Database The date and time the Always Free database will be stopped because of inactivity. If this time is reached without any database activity, the database will automatically be put into the STOPPED state.
- time
Until StringReconnect Clone Enabled The time and date as an RFC3339 formatted string, e.g., 2022-01-01T12:00:00.000Z, to set the limit for a refreshable clone to be reconnected to its source database.
- timestamp String
The timestamp specified for the point-in-time clone of the source Autonomous Database. The timestamp must be in the past.
- total
Backup NumberStorage Size In Gbs The backup storage to the database.
- use
Latest BooleanAvailable Backup Time Stamp Clone from latest available backup timestamp.
- used
Data NumberStorage Size In Gbs The storage space consumed by Autonomous Database in GBs.
- used
Data NumberStorage Size In Tbs The amount of storage that has been used, in terabytes.
- vault
Id String - whitelisted
Ips List<String> (Updatable) The client IP access control list (ACL). This feature is available for autonomous databases on shared Exadata infrastructure and on Exadata Cloud@Customer. Only clients connecting from an IP address included in the ACL may access the Autonomous Database instance.
For shared Exadata infrastructure, this is an array of CIDR (Classless Inter-Domain Routing) notations for a subnet or VCN OCID. Use a semicolon (;) as a deliminator between the VCN-specific subnets or IPs. Example:
["1.1.1.1","1.1.1.0/24","ocid1.vcn.oc1.sea.<unique_id>","ocid1.vcn.oc1.sea.<unique_id1>;1.1.1.1","ocid1.vcn.oc1.sea.<unique_id2>;1.1.0.0/16"]
For Exadata Cloud@Customer, this is an array of IP addresses or CIDR (Classless Inter-Domain Routing) notations. Example:["1.1.1.1","1.1.1.0/24","1.1.2.25"]
For an update operation, if you want to delete all the IPs in the ACL, use an array with a single empty string entry.
This cannot be updated in parallel with any of the following: licenseModel, dbEdition, cpuCoreCount, computeCount, computeModel, adminPassword, isMTLSConnectionRequired, openMode, permissionLevel, dbWorkload, dbVersion, isRefreshable, dbName, scheduledOperations, dbToolsDetails, isLocalDataGuardEnabled, or isFreeTier. To remove all whitelisted IPs, set the field to a list with an empty string
[""]
.This cannot be updated in parallel with any of the following: licenseModel, dbEdition, cpuCoreCount, computeCount, computeModel, adminPassword, isMTLSConnectionRequired, openMode, permissionLevel, dbWorkload, dbVersion, isRefreshable, dbName, scheduledOperations, dbToolsDetails, isLocalDataGuardEnabled, or isFreeTier. To remove all whitelisted IPs, set the field to a list with an empty string
[""]
.
Supporting Types
AutonomousDatabaseApexDetail, AutonomousDatabaseApexDetailArgs
- Apex
Version string The Oracle APEX Application Development version.
- Ords
Version string The Oracle REST Data Services (ORDS) version.
- Apex
Version string The Oracle APEX Application Development version.
- Ords
Version string The Oracle REST Data Services (ORDS) version.
- apex
Version String The Oracle APEX Application Development version.
- ords
Version String The Oracle REST Data Services (ORDS) version.
- apex
Version string The Oracle APEX Application Development version.
- ords
Version string The Oracle REST Data Services (ORDS) version.
- apex_
version str The Oracle APEX Application Development version.
- ords_
version str The Oracle REST Data Services (ORDS) version.
- apex
Version String The Oracle APEX Application Development version.
- ords
Version String The Oracle REST Data Services (ORDS) version.
AutonomousDatabaseBackupConfig, AutonomousDatabaseBackupConfigArgs
- Manual
Backup stringBucket Name Name of Object Storage bucket to use for storing manual backups.
- Manual
Backup stringType The manual backup destination type.
- Manual
Backup stringBucket Name Name of Object Storage bucket to use for storing manual backups.
- Manual
Backup stringType The manual backup destination type.
- manual
Backup StringBucket Name Name of Object Storage bucket to use for storing manual backups.
- manual
Backup StringType The manual backup destination type.
- manual
Backup stringBucket Name Name of Object Storage bucket to use for storing manual backups.
- manual
Backup stringType The manual backup destination type.
- manual_
backup_ strbucket_ name Name of Object Storage bucket to use for storing manual backups.
- manual_
backup_ strtype The manual backup destination type.
- manual
Backup StringBucket Name Name of Object Storage bucket to use for storing manual backups.
- manual
Backup StringType The manual backup destination type.
AutonomousDatabaseConnectionString, AutonomousDatabaseConnectionStringArgs
- All
Connection Dictionary<string, object>Strings Returns all connection strings that can be used to connect to the Autonomous Database. For more information, please see Predefined Database Service Names for Autonomous Transaction Processing
- Dedicated string
The database service provides the least level of resources to each SQL statement, but supports the most number of concurrent SQL statements.
- High string
The High database service provides the highest level of resources to each SQL statement resulting in the highest performance, but supports the fewest number of concurrent SQL statements.
- Low string
The Low database service provides the least level of resources to each SQL statement, but supports the most number of concurrent SQL statements.
- Medium string
The Medium database service provides a lower level of resources to each SQL statement potentially resulting a lower level of performance, but supports more concurrent SQL statements.
- Profiles
List<Autonomous
Database Connection String Profile> A list of connection string profiles to allow clients to group, filter and select connection string values based on structured metadata.
- All
Connection map[string]interface{}Strings Returns all connection strings that can be used to connect to the Autonomous Database. For more information, please see Predefined Database Service Names for Autonomous Transaction Processing
- Dedicated string
The database service provides the least level of resources to each SQL statement, but supports the most number of concurrent SQL statements.
- High string
The High database service provides the highest level of resources to each SQL statement resulting in the highest performance, but supports the fewest number of concurrent SQL statements.
- Low string
The Low database service provides the least level of resources to each SQL statement, but supports the most number of concurrent SQL statements.
- Medium string
The Medium database service provides a lower level of resources to each SQL statement potentially resulting a lower level of performance, but supports more concurrent SQL statements.
- Profiles
[]Autonomous
Database Connection String Profile A list of connection string profiles to allow clients to group, filter and select connection string values based on structured metadata.
- all
Connection Map<String,Object>Strings Returns all connection strings that can be used to connect to the Autonomous Database. For more information, please see Predefined Database Service Names for Autonomous Transaction Processing
- dedicated String
The database service provides the least level of resources to each SQL statement, but supports the most number of concurrent SQL statements.
- high String
The High database service provides the highest level of resources to each SQL statement resulting in the highest performance, but supports the fewest number of concurrent SQL statements.
- low String
The Low database service provides the least level of resources to each SQL statement, but supports the most number of concurrent SQL statements.
- medium String
The Medium database service provides a lower level of resources to each SQL statement potentially resulting a lower level of performance, but supports more concurrent SQL statements.
- profiles
List<Autonomous
Connection String Profile> A list of connection string profiles to allow clients to group, filter and select connection string values based on structured metadata.
- all
Connection {[key: string]: any}Strings Returns all connection strings that can be used to connect to the Autonomous Database. For more information, please see Predefined Database Service Names for Autonomous Transaction Processing
- dedicated string
The database service provides the least level of resources to each SQL statement, but supports the most number of concurrent SQL statements.
- high string
The High database service provides the highest level of resources to each SQL statement resulting in the highest performance, but supports the fewest number of concurrent SQL statements.
- low string
The Low database service provides the least level of resources to each SQL statement, but supports the most number of concurrent SQL statements.
- medium string
The Medium database service provides a lower level of resources to each SQL statement potentially resulting a lower level of performance, but supports more concurrent SQL statements.
- profiles
Autonomous
Database Connection String Profile[] A list of connection string profiles to allow clients to group, filter and select connection string values based on structured metadata.
- all_
connection_ Mapping[str, Any]strings Returns all connection strings that can be used to connect to the Autonomous Database. For more information, please see Predefined Database Service Names for Autonomous Transaction Processing
- dedicated str
The database service provides the least level of resources to each SQL statement, but supports the most number of concurrent SQL statements.
- high str
The High database service provides the highest level of resources to each SQL statement resulting in the highest performance, but supports the fewest number of concurrent SQL statements.
- low str
The Low database service provides the least level of resources to each SQL statement, but supports the most number of concurrent SQL statements.
- medium str
The Medium database service provides a lower level of resources to each SQL statement potentially resulting a lower level of performance, but supports more concurrent SQL statements.
- profiles
Autonomous
Database Connection String Profile] A list of connection string profiles to allow clients to group, filter and select connection string values based on structured metadata.
- all
Connection Map<Any>Strings Returns all connection strings that can be used to connect to the Autonomous Database. For more information, please see Predefined Database Service Names for Autonomous Transaction Processing
- dedicated String
The database service provides the least level of resources to each SQL statement, but supports the most number of concurrent SQL statements.
- high String
The High database service provides the highest level of resources to each SQL statement resulting in the highest performance, but supports the fewest number of concurrent SQL statements.
- low String
The Low database service provides the least level of resources to each SQL statement, but supports the most number of concurrent SQL statements.
- medium String
The Medium database service provides a lower level of resources to each SQL statement potentially resulting a lower level of performance, but supports more concurrent SQL statements.
- profiles List<Property Map>
A list of connection string profiles to allow clients to group, filter and select connection string values based on structured metadata.
AutonomousDatabaseConnectionStringProfile, AutonomousDatabaseConnectionStringProfileArgs
- Consumer
Group string Consumer group used by the connection.
- Display
Name string (Updatable) The user-friendly name for the Autonomous Database. The name does not have to be unique.
- Host
Format string Host format used in connection string.
- Protocol string
Protocol used by the connection.
- Session
Mode string Specifies whether the listener performs a direct hand-off of the session, or redirects the session. In RAC deployments where SCAN is used, sessions are redirected to a Node VIP. Use
DIRECT
for direct hand-offs. UseREDIRECT
to redirect the session.- Syntax
Format string Specifies whether the connection string is using the long (
LONG
), Easy Connect (EZCONNECT
), or Easy Connect Plus (EZCONNECTPLUS
) format. Autonomous Databases on shared Exadata infrastructure always use the long format.- Tls
Authentication string Specifies whether the TLS handshake is using one-way (
SERVER
) or mutual (MUTUAL
) authentication.- Value string
Connection string value.
- Consumer
Group string Consumer group used by the connection.
- Display
Name string (Updatable) The user-friendly name for the Autonomous Database. The name does not have to be unique.
- Host
Format string Host format used in connection string.
- Protocol string
Protocol used by the connection.
- Session
Mode string Specifies whether the listener performs a direct hand-off of the session, or redirects the session. In RAC deployments where SCAN is used, sessions are redirected to a Node VIP. Use
DIRECT
for direct hand-offs. UseREDIRECT
to redirect the session.- Syntax
Format string Specifies whether the connection string is using the long (
LONG
), Easy Connect (EZCONNECT
), or Easy Connect Plus (EZCONNECTPLUS
) format. Autonomous Databases on shared Exadata infrastructure always use the long format.- Tls
Authentication string Specifies whether the TLS handshake is using one-way (
SERVER
) or mutual (MUTUAL
) authentication.- Value string
Connection string value.
- consumer
Group String Consumer group used by the connection.
- display
Name String (Updatable) The user-friendly name for the Autonomous Database. The name does not have to be unique.
- host
Format String Host format used in connection string.
- protocol String
Protocol used by the connection.
- session
Mode String Specifies whether the listener performs a direct hand-off of the session, or redirects the session. In RAC deployments where SCAN is used, sessions are redirected to a Node VIP. Use
DIRECT
for direct hand-offs. UseREDIRECT
to redirect the session.- syntax
Format String Specifies whether the connection string is using the long (
LONG
), Easy Connect (EZCONNECT
), or Easy Connect Plus (EZCONNECTPLUS
) format. Autonomous Databases on shared Exadata infrastructure always use the long format.- tls
Authentication String Specifies whether the TLS handshake is using one-way (
SERVER
) or mutual (MUTUAL
) authentication.- value String
Connection string value.
- consumer
Group string Consumer group used by the connection.
- display
Name string (Updatable) The user-friendly name for the Autonomous Database. The name does not have to be unique.
- host
Format string Host format used in connection string.
- protocol string
Protocol used by the connection.
- session
Mode string Specifies whether the listener performs a direct hand-off of the session, or redirects the session. In RAC deployments where SCAN is used, sessions are redirected to a Node VIP. Use
DIRECT
for direct hand-offs. UseREDIRECT
to redirect the session.- syntax
Format string Specifies whether the connection string is using the long (
LONG
), Easy Connect (EZCONNECT
), or Easy Connect Plus (EZCONNECTPLUS
) format. Autonomous Databases on shared Exadata infrastructure always use the long format.- tls
Authentication string Specifies whether the TLS handshake is using one-way (
SERVER
) or mutual (MUTUAL
) authentication.- value string
Connection string value.
- consumer_
group str Consumer group used by the connection.
- display_
name str (Updatable) The user-friendly name for the Autonomous Database. The name does not have to be unique.
- host_
format str Host format used in connection string.
- protocol str
Protocol used by the connection.
- session_
mode str Specifies whether the listener performs a direct hand-off of the session, or redirects the session. In RAC deployments where SCAN is used, sessions are redirected to a Node VIP. Use
DIRECT
for direct hand-offs. UseREDIRECT
to redirect the session.- syntax_
format str Specifies whether the connection string is using the long (
LONG
), Easy Connect (EZCONNECT
), or Easy Connect Plus (EZCONNECTPLUS
) format. Autonomous Databases on shared Exadata infrastructure always use the long format.- tls_
authentication str Specifies whether the TLS handshake is using one-way (
SERVER
) or mutual (MUTUAL
) authentication.- value str
Connection string value.
- consumer
Group String Consumer group used by the connection.
- display
Name String (Updatable) The user-friendly name for the Autonomous Database. The name does not have to be unique.
- host
Format String Host format used in connection string.
- protocol String
Protocol used by the connection.
- session
Mode String Specifies whether the listener performs a direct hand-off of the session, or redirects the session. In RAC deployments where SCAN is used, sessions are redirected to a Node VIP. Use
DIRECT
for direct hand-offs. UseREDIRECT
to redirect the session.- syntax
Format String Specifies whether the connection string is using the long (
LONG
), Easy Connect (EZCONNECT
), or Easy Connect Plus (EZCONNECTPLUS
) format. Autonomous Databases on shared Exadata infrastructure always use the long format.- tls
Authentication String Specifies whether the TLS handshake is using one-way (
SERVER
) or mutual (MUTUAL
) authentication.- value String
Connection string value.
AutonomousDatabaseConnectionUrl, AutonomousDatabaseConnectionUrlArgs
- Apex
Url string Oracle Application Express (APEX) URL.
- Graph
Studio stringUrl The URL of the Graph Studio for the Autonomous Database.
- Machine
Learning stringUser Management Url Oracle Machine Learning user management URL.
- Sql
Dev stringWeb Url Oracle SQL Developer Web URL.
- Apex
Url string Oracle Application Express (APEX) URL.
- Graph
Studio stringUrl The URL of the Graph Studio for the Autonomous Database.
- Machine
Learning stringUser Management Url Oracle Machine Learning user management URL.
- Sql
Dev stringWeb Url Oracle SQL Developer Web URL.
- apex
Url String Oracle Application Express (APEX) URL.
- graph
Studio StringUrl The URL of the Graph Studio for the Autonomous Database.
- machine
Learning StringUser Management Url Oracle Machine Learning user management URL.
- sql
Dev StringWeb Url Oracle SQL Developer Web URL.
- apex
Url string Oracle Application Express (APEX) URL.
- graph
Studio stringUrl The URL of the Graph Studio for the Autonomous Database.
- machine
Learning stringUser Management Url Oracle Machine Learning user management URL.
- sql
Dev stringWeb Url Oracle SQL Developer Web URL.
- apex_
url str Oracle Application Express (APEX) URL.
- graph_
studio_ strurl The URL of the Graph Studio for the Autonomous Database.
- machine_
learning_ struser_ management_ url Oracle Machine Learning user management URL.
- sql_
dev_ strweb_ url Oracle SQL Developer Web URL.
- apex
Url String Oracle Application Express (APEX) URL.
- graph
Studio StringUrl The URL of the Graph Studio for the Autonomous Database.
- machine
Learning StrinUser Management Url