/** * Database Service API * The API for the Database Service. Use this API to manage resources such as databases and DB Systems. For more information, see [Overview of the Database Service](https://docs.oracle.com/iaas/Content/Database/Concepts/databaseoverview.htm). * OpenAPI spec version: 20160918 * Contact: sic_dbaas_cp_us_grp@oracle.com * * NOTE: This class is auto generated by OracleSDKGenerator. * Do not edit the class manually. * * Copyright (c) 2020, 2026, Oracle and/or its affiliates. All rights reserved. * This software is dual-licensed to you under the Universal Permissive License (UPL) 1.0 as shown at https://oss.oracle.com/licenses/upl or Apache License 2.0 as shown at http://www.apache.org/licenses/LICENSE-2.0. You may choose either license. */ import * as model from "../model"; export interface DbSystem { "iormConfigCache"?: model.ExadataIormConfig; /** * The [OCID](https://docs.oracle.com/iaas/Content/General/Concepts/identifiers.htm) of the DB system. */ "id": string; /** * The [OCID](https://docs.oracle.com/iaas/Content/General/Concepts/identifiers.htm) of the compartment. */ "compartmentId": string; /** * The [OCID](https://docs.oracle.com/iaas/Content/General/Concepts/identifiers.htm) of the subscription with which resource needs to be associated with. */ "subscriptionId"?: string; /** * The [OCID](https://docs.oracle.com/iaas/Content/General/Concepts/identifiers.htm) of the cluster placement group of the Exadata Infrastructure or Db System. */ "clusterPlacementGroupId"?: string; /** * The user-friendly name for the DB system. The name does not have to be unique. */ "displayName": string; /** * The name of the availability domain that the DB system is located in. */ "availabilityDomain": string; /** * List of the Fault Domains in which this DB system is provisioned. */ "faultDomains"?: Array; /** * The [OCID](https://docs.oracle.com/iaas/Content/General/Concepts/identifiers.htm) of the subnet the DB system 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 DB systems, do not use a subnet that overlaps with 192.168.128.0/20. *

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 backup subnet. * */ "subnetId": string; /** * The [OCID](https://docs.oracle.com/iaas/Content/General/Concepts/identifiers.htm) of the backup network subnet the DB system is associated with. Applicable only to Exadata DB systems. *

**Subnet Restriction:** See the subnet restrictions information for **subnetId**. * */ "backupSubnetId"?: string; /** * The list of [OCIDs](https://docs.oracle.com/iaas/Content/General/Concepts/identifiers.htm) 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](https://docs.oracle.com/iaas/Content/Network/Concepts/securityrules.htm). * **NsgIds restrictions:** * - A network security group (NSG) is optional for Autonomous AI Databases with private access. The nsgIds list can be empty. * */ "nsgIds"?: Array; /** * A list of the [OCIDs](https://docs.oracle.com/iaas/Content/General/Concepts/identifiers.htm) of the network security groups (NSGs) that the backup network of this DB system belongs to. Setting this to an empty array after the list is created removes the resource from all NSGs. For more information about NSGs, see [Security Rules](https://docs.oracle.com/iaas/Content/Network/Concepts/securityrules.htm). Applicable only to Exadata systems. * */ "backupNetworkNsgIds"?: Array; /** * The [OCID](https://docs.oracle.com/iaas/Content/General/Concepts/identifiers.htm) of a grid infrastructure software image. This is a database software image of the type {@code GRID_IMAGE}. */ "giSoftwareImageId"?: string; /** * Memory allocated to the DB system, in gigabytes. Note: Numbers greater than Number.MAX_SAFE_INTEGER will result in rounding issues. */ "memorySizeInGBs"?: number; /** * The block storage volume performance level. Valid values are {@code BALANCED} and {@code HIGH_PERFORMANCE}. See [Block Volume Performance](https://docs.oracle.com/iaas/Content/Block/Concepts/blockvolumeperformance.htm) for more information. * */ "storageVolumePerformanceMode"?: DbSystem.StorageVolumePerformanceMode; /** * The shape of the DB system. The shape determines resources to allocate to the DB system. * - For virtual machine shapes, the number of CPU cores and memory * - For bare metal and Exadata shapes, the number of CPU cores, storage, and memory * */ "shape": string; "dbSystemOptions"?: model.DbSystemOptions; /** * The public key portion of one or more key pairs used for SSH access to the DB system. */ "sshPublicKeys": Array; /** * The time zone of the DB system. For details, see [DB System Time Zones](https://docs.oracle.com/iaas/Content/Database/References/timezones.htm). */ "timeZone"?: string; /** * The hostname for the DB system. */ "hostname": string; /** * The domain name for the DB system. */ "domain": string; /** * The OCID of the key container that is used as the master encryption key in database transparent data encryption (TDE) operations. */ "kmsKeyId"?: string; /** * The Oracle Database version of the DB system. */ "version"?: string; /** * The most recent OS Patch Version applied on the DB system. */ "osVersion"?: string; /** * The number of CPU cores enabled on the DB system. Note: Numbers greater than Number.MAX_SAFE_INTEGER will result in rounding issues. */ "cpuCoreCount"?: number; /** * The cluster name for Exadata and 2-node RAC virtual machine DB systems. The cluster name must begin with an alphabetic character, and may contain hyphens (-). Underscores (_) are not permitted. The cluster name can be no longer than 11 characters and is not case sensitive. * */ "clusterName"?: string; /** * The percentage assigned to DATA storage (user data and database files). * The remaining percentage is assigned to RECO storage (database redo logs, archive logs, and recovery manager backups). Accepted values are 40 and 80. The default is 80 percent assigned to DATA storage. Not applicable for virtual machine DB systems. * Note: Numbers greater than Number.MAX_SAFE_INTEGER will result in rounding issues. */ "dataStoragePercentage"?: number; /** * The Oracle Database Edition that applies to all the databases on the DB system. * Exadata DB systems and 2-node RAC DB systems require ENTERPRISE_EDITION_EXTREME_PERFORMANCE. * */ "databaseEdition": DbSystem.DatabaseEdition; /** * The [OCID](https://docs.oracle.com/iaas/Content/General/Concepts/identifiers.htm) of the last patch history. This value is updated as soon as a patch operation starts. */ "lastPatchHistoryEntryId"?: string; /** * The port number configured for the listener on the DB system. Note: Numbers greater than Number.MAX_SAFE_INTEGER will result in rounding issues. */ "listenerPort"?: number; /** * The current state of the DB system. */ "lifecycleState": DbSystem.LifecycleState; /** * The date and time the DB system was created. */ "timeCreated"?: Date; /** * Additional information about the current lifecycle state. */ "lifecycleDetails"?: string; /** * The type of redundancy configured for the DB system. * NORMAL is 2-way redundancy. * HIGH is 3-way redundancy. * */ "diskRedundancy"?: DbSystem.DiskRedundancy; /** * True, if Sparse Diskgroup is configured for Exadata dbsystem, False, if Sparse diskgroup was not configured. * */ "sparseDiskgroup"?: boolean; /** * The [OCID](https://docs.oracle.com/iaas/Content/General/Concepts/identifiers.htm) of the Single Client Access Name (SCAN) IPv4 addresses associated with the DB system. * SCAN IPv4 addresses are typically used for load balancing and are not assigned to any interface. * Oracle Clusterware directs the requests to the appropriate nodes in the cluster. *

**Note:** For a single-node DB system, this list is empty. * */ "scanIpIds"?: Array; /** * The [OCID](https://docs.oracle.com/iaas/Content/General/Concepts/identifiers.htm) of the virtual IPv4 (VIP) addresses associated with the DB system. * The Cluster Ready Services (CRS) creates and maintains one VIPv4 address for each node in the DB system to * enable failover. If one node fails, the VIPv4 is reassigned to another active node in the cluster. *

**Note:** For a single-node DB system, this list is empty. * */ "vipIds"?: Array; /** * The [OCID](https://docs.oracle.com/iaas/Content/General/Concepts/identifiers.htm) of the Single Client Access Name (SCAN) IPv6 addresses associated with the DB system. * SCAN IPv6 addresses are typically used for load balancing and are not assigned to any interface. * Oracle Clusterware directs the requests to the appropriate nodes in the cluster. *

**Note:** For a single-node DB system, this list is empty. * */ "scanIpv6Ids"?: Array; /** * The [OCID](https://docs.oracle.com/iaas/Content/General/Concepts/identifiers.htm) of the virtual IPv6 (VIP) addresses associated with the DB system. * The Cluster Ready Services (CRS) creates and maintains one VIP IpV6 address for each node in the DB system to * enable failover. If one node fails, the VIP is reassigned to another active node in the cluster. *

**Note:** For a single-node DB system, this list is empty. * */ "vipv6Ids"?: Array; /** * The [OCID](https://docs.oracle.com/iaas/Content/General/Concepts/identifiers.htm) of the DNS record for the SCAN IP addresses that are associated with the DB system. * */ "scanDnsRecordId"?: string; /** * The FQDN of the DNS record for the SCAN IP addresses that are associated with the DB system. * */ "scanDnsName"?: string; /** * The OCID of the zone the DB system is associated with. * */ "zoneId"?: string; /** * The data storage size, in gigabytes, that is currently available to the DB system. Applies only for virtual machine DB systems. * Note: Numbers greater than Number.MAX_SAFE_INTEGER will result in rounding issues. */ "dataStorageSizeInGBs"?: number; /** * The RECO/REDO storage size, in gigabytes, that is currently allocated to the DB system. Applies only for virtual machine DB systems. * Note: Numbers greater than Number.MAX_SAFE_INTEGER will result in rounding issues. */ "recoStorageSizeInGB"?: number; /** * The number of nodes in the DB system. For RAC DB systems, the value is greater than 1. * Note: Numbers greater than Number.MAX_SAFE_INTEGER will result in rounding issues. */ "nodeCount"?: number; /** * The Oracle license model that applies to all the databases on the DB system. The default is LICENSE_INCLUDED. * */ "licenseModel"?: DbSystem.LicenseModel; "maintenanceWindow"?: model.MaintenanceWindow; /** * The [OCID](https://docs.oracle.com/iaas/Content/General/Concepts/identifiers.htm) of the last maintenance run. */ "lastMaintenanceRunId"?: string; /** * The [OCID](https://docs.oracle.com/iaas/Content/General/Concepts/identifiers.htm) of the next maintenance run. */ "nextMaintenanceRunId"?: string; /** * 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](https://docs.oracle.com/iaas/Content/General/Concepts/resourcetags.htm). *

Example: {@code {\"Department\": \"Finance\"}} * */ "freeformTags"?: { [key: string]: string; }; /** * Defined tags for this resource. Each key is predefined and scoped to a namespace. * For more information, see [Resource Tags](https://docs.oracle.com/iaas/Content/General/Concepts/resourcetags.htm). * */ "definedTags"?: { [key: string]: { [key: string]: any; }; }; /** * System tags for this resource. Each key is predefined and scoped to a namespace. * For more information, see [Resource Tags](https://docs.oracle.com/iaas/Content/General/Concepts/resourcetags.htm). * */ "systemTags"?: { [key: string]: { [key: string]: any; }; }; /** * Security Attributes for this resource. Each key is predefined and scoped to a namespace. * For more information, see [Resource Tags](https://docs.oracle.com/iaas/Content/General/Concepts/resourcetags.htm). * Example: {@code {\"Oracle-ZPR\": {\"MaxEgressCount\": {\"value\": \"42\", \"mode\": \"audit\"}}}} * */ "securityAttributes"?: { [key: string]: { [key: string]: any; }; }; /** * The [OCID](https://docs.oracle.com/iaas/Content/General/Concepts/identifiers.htm) of the DB system. */ "sourceDbSystemId"?: string; /** * The point in time for a cloned database system when the data disks were cloned from the source database system, as described in [RFC 3339](https://tools.ietf.org/rfc/rfc3339). */ "pointInTimeDataDiskCloneTimestamp"?: Date; "dataCollectionOptions"?: model.DataCollectionOptions; /** * The compute model for Base Database Service. This is required if using the {@code computeCount} parameter. If using {@code cpuCoreCount} then it is an error to specify {@code computeModel} to a non-null value. The ECPU compute model is the recommended model, and the OCPU compute model is legacy. */ "computeModel"?: DbSystem.ComputeModel; /** * The number of compute servers for the DB system. Note: Numbers greater than Number.MAX_SAFE_INTEGER will result in rounding issues. */ "computeCount"?: number; } export declare namespace DbSystem { enum StorageVolumePerformanceMode { Balanced = "BALANCED", HighPerformance = "HIGH_PERFORMANCE", /** * This value is used if a service returns a value for this enum that is not recognized by this * version of the SDK. */ UnknownValue = "UNKNOWN_VALUE" } enum DatabaseEdition { StandardEdition = "STANDARD_EDITION", EnterpriseEdition = "ENTERPRISE_EDITION", EnterpriseEditionHighPerformance = "ENTERPRISE_EDITION_HIGH_PERFORMANCE", EnterpriseEditionExtremePerformance = "ENTERPRISE_EDITION_EXTREME_PERFORMANCE", EnterpriseEditionDeveloper = "ENTERPRISE_EDITION_DEVELOPER", /** * This value is used if a service returns a value for this enum that is not recognized by this * version of the SDK. */ UnknownValue = "UNKNOWN_VALUE" } enum LifecycleState { Provisioning = "PROVISIONING", Available = "AVAILABLE", Updating = "UPDATING", Terminating = "TERMINATING", Terminated = "TERMINATED", Failed = "FAILED", Migrated = "MIGRATED", MaintenanceInProgress = "MAINTENANCE_IN_PROGRESS", NeedsAttention = "NEEDS_ATTENTION", Upgrading = "UPGRADING", /** * This value is used if a service returns a value for this enum that is not recognized by this * version of the SDK. */ UnknownValue = "UNKNOWN_VALUE" } enum DiskRedundancy { High = "HIGH", Normal = "NORMAL", /** * This value is used if a service returns a value for this enum that is not recognized by this * version of the SDK. */ UnknownValue = "UNKNOWN_VALUE" } enum LicenseModel { LicenseIncluded = "LICENSE_INCLUDED", BringYourOwnLicense = "BRING_YOUR_OWN_LICENSE", /** * This value is used if a service returns a value for this enum that is not recognized by this * version of the SDK. */ UnknownValue = "UNKNOWN_VALUE" } enum ComputeModel { Ecpu = "ECPU", Ocpu = "OCPU", /** * This value is used if a service returns a value for this enum that is not recognized by this * version of the SDK. */ UnknownValue = "UNKNOWN_VALUE" } function getJsonObj(obj: DbSystem): object; function getDeserializedJsonObj(obj: DbSystem): object; }