import * as pulumi from "@pulumi/pulumi"; import * as inputs from "../types/input"; import * as outputs from "../types/output"; /** * This resource provides the Db Systems Upgrade resource in Oracle Cloud Infrastructure Database service. * * Upgrades the operating system and grid infrastructure of the DB system. * * ## Example Usage * * ```typescript * import * as pulumi from "@pulumi/pulumi"; * import * as oci from "@pulumi/oci"; * * const testDbSystemsUpgrade = new oci.database.DbSystemsUpgrade("test_db_systems_upgrade", { * action: dbSystemsUpgradeAction, * dbSystemId: testDbSystem.id, * isSnapshotRetentionDaysForceUpdated: dbSystemsUpgradeIsSnapshotRetentionDaysForceUpdated === "true", * newGiVersion: dbSystemsUpgradeNewGiVersion, * snapshotRetentionPeriodInDays: Number(dbSystemsUpgradeSnapshotRetentionPeriodInDays), * }); * ``` * * ## Import * * Import is not supported for this resource. */ export declare class DbSystemsUpgrade extends pulumi.CustomResource { /** * Get an existing DbSystemsUpgrade resource's state with the given name, ID, and optional extra * properties used to qualify the lookup. * * @param name The _unique_ name of the resulting resource. * @param id The _unique_ provider ID of the resource to lookup. * @param state Any extra arguments used during the lookup. * @param opts Optional settings to control the behavior of the CustomResource. */ static get(name: string, id: pulumi.Input, state?: DbSystemsUpgradeState, opts?: pulumi.CustomResourceOptions): DbSystemsUpgrade; /** * Returns true if the given object is an instance of DbSystemsUpgrade. This is designed to work even * when multiple copies of the Pulumi SDK have been loaded into the same process. */ static isInstance(obj: any): obj is DbSystemsUpgrade; /** * The operating system upgrade action. */ readonly action: pulumi.Output; /** * The name of the availability domain that the DB system is located in. */ readonly availabilityDomain: pulumi.Output; /** * A list of the [OCIDs](https://docs.cloud.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.cloud.oracle.com/iaas/Content/Network/Concepts/securityrules.htm). Applicable only to Exadata systems. */ readonly backupNetworkNsgIds: pulumi.Output; /** * The [OCID](https://docs.cloud.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. */ readonly backupSubnetId: pulumi.Output; /** * 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. */ readonly clusterName: pulumi.Output; /** * The [OCID](https://docs.cloud.oracle.com/iaas/Content/General/Concepts/identifiers.htm) of the compartment. */ readonly compartmentId: pulumi.Output; /** * The number of CPU cores enabled on the DB system. */ readonly cpuCoreCount: pulumi.Output; /** * 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. */ readonly dataStoragePercentage: pulumi.Output; /** * The data storage size, in gigabytes, that is currently available to the DB system. Applies only for virtual machine DB systems. */ readonly dataStorageSizeInGb: pulumi.Output; /** * The Oracle Database edition that applies to all the databases on the DB system. */ readonly databaseEdition: pulumi.Output; /** * The DB system [OCID](https://docs.cloud.oracle.com/iaas/Content/General/Concepts/identifiers.htm). */ readonly dbSystemId: pulumi.Output; /** * The DB system options. */ readonly dbSystemOptions: pulumi.Output; /** * Defined tags for this resource. Each key is predefined and scoped to a namespace. For more information, see [Resource Tags](https://docs.cloud.oracle.com/iaas/Content/General/Concepts/resourcetags.htm). */ readonly definedTags: pulumi.Output<{ [key: string]: string; }>; /** * The type of redundancy configured for the DB system. NORMAL is 2-way redundancy. HIGH is 3-way redundancy. */ readonly diskRedundancy: pulumi.Output; /** * The user-friendly name for the DB system. The name does not have to be unique. */ readonly displayName: pulumi.Output; /** * The domain name for the DB system. */ readonly domain: pulumi.Output; /** * List of the Fault Domains in which this DB system is provisioned. */ readonly faultDomains: pulumi.Output; /** * 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.cloud.oracle.com/iaas/Content/General/Concepts/resourcetags.htm). Example: `{"Department": "Finance"}` */ readonly freeformTags: pulumi.Output<{ [key: string]: string; }>; /** * The hostname for the DB system. */ readonly hostname: pulumi.Output; /** * The IORM settings of the Exadata DB system. */ readonly iormConfigCaches: pulumi.Output; /** * If true, rollback time is updated even if operating system upgrade history contains errors. */ readonly isSnapshotRetentionDaysForceUpdated: pulumi.Output; /** * The OCID of the key container that is used as the master encryption key in database transparent data encryption (TDE) operations. */ readonly kmsKeyId: pulumi.Output; /** * The [OCID](https://docs.cloud.oracle.com/iaas/Content/General/Concepts/identifiers.htm) of the last maintenance run. */ readonly lastMaintenanceRunId: pulumi.Output; /** * The [OCID](https://docs.cloud.oracle.com/iaas/Content/General/Concepts/identifiers.htm) of the last patch history. This value is updated as soon as a patch operation starts. */ readonly lastPatchHistoryEntryId: pulumi.Output; /** * The Oracle license model that applies to all the databases on the DB system. The default is LICENSE_INCLUDED. */ readonly licenseModel: pulumi.Output; /** * Additional information about the current lifecycle state. */ readonly lifecycleDetails: pulumi.Output; /** * The port number configured for the listener on the DB system. */ readonly listenerPort: pulumi.Output; /** * The scheduling details for the quarterly maintenance window. Patching and system updates take place during the maintenance window. */ readonly maintenanceWindows: pulumi.Output; /** * A valid Oracle Grid Infrastructure (GI) software version. */ readonly newGiVersion: pulumi.Output; readonly newOsVersion: pulumi.Output; /** * The [OCID](https://docs.cloud.oracle.com/iaas/Content/General/Concepts/identifiers.htm) of the next maintenance run. */ readonly nextMaintenanceRunId: pulumi.Output; /** * The number of nodes in the DB system. For RAC DB systems, the value is greater than 1. */ readonly nodeCount: pulumi.Output; /** * A list of the [OCIDs](https://docs.cloud.oracle.com/iaas/Content/General/Concepts/identifiers.htm) of the network security groups (NSGs) that this resource 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.cloud.oracle.com/iaas/Content/Network/Concepts/securityrules.htm). **NsgIds restrictions:** * * Autonomous Databases with private access require at least 1 Network Security Group (NSG). The nsgIds array cannot be empty. */ readonly nsgIds: pulumi.Output; /** * 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). */ readonly pointInTimeDataDiskCloneTimestamp: pulumi.Output; /** * The RECO/REDO storage size, in gigabytes, that is currently allocated to the DB system. Applies only for virtual machine DB systems. */ readonly recoStorageSizeInGb: pulumi.Output; /** * The FQDN of the DNS record for the SCAN IP addresses that are associated with the DB system. */ readonly scanDnsName: pulumi.Output; /** * The [OCID](https://docs.cloud.oracle.com/iaas/Content/General/Concepts/identifiers.htm) of the DNS record for the SCAN IP addresses that are associated with the DB system. */ readonly scanDnsRecordId: pulumi.Output; /** * The [OCID](https://docs.cloud.oracle.com/iaas/Content/General/Concepts/identifiers.htm) of the Single Client Access Name (SCAN) IP addresses associated with the DB system. SCAN IP addresses are typically used for load balancing and are not assigned to any interface. Oracle Clusterware directs the requests to the appropriate nodes in the cluster. */ readonly scanIpIds: pulumi.Output; /** * 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 */ readonly shape: pulumi.Output; /** * The retention period, in days, for the snapshot that allows you to perform a rollback of the upgrade operation. After this number of days passes, you cannot roll back the upgrade. * * ** 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 */ readonly snapshotRetentionPeriodInDays: pulumi.Output; /** * The [OCID](https://docs.cloud.oracle.com/iaas/Content/General/Concepts/identifiers.htm) of the DB system. */ readonly sourceDbSystemId: pulumi.Output; /** * True, if Sparse Diskgroup is configured for Exadata dbsystem, False, if Sparse diskgroup was not configured. */ readonly sparseDiskgroup: pulumi.Output; /** * The public key portion of one or more key pairs used for SSH access to the DB system. */ readonly sshPublicKeys: pulumi.Output; /** * The current state of the DB system. */ readonly state: pulumi.Output; /** * The [OCID](https://docs.cloud.oracle.com/iaas/Content/General/Concepts/identifiers.htm) of the subnet the DB system is associated with. */ readonly subnetId: pulumi.Output; /** * The date and time the DB system was created. */ readonly timeCreated: pulumi.Output; /** * The time zone of the DB system. For details, see [DB System Time Zones](https://docs.cloud.oracle.com/iaas/Content/Database/References/timezones.htm). */ readonly timeZone: pulumi.Output; /** * The Oracle Database version of the DB system. */ readonly version: pulumi.Output; /** * The [OCID](https://docs.cloud.oracle.com/iaas/Content/General/Concepts/identifiers.htm) of the virtual IP (VIP) addresses associated with the DB system. The Cluster Ready Services (CRS) creates and maintains one VIP 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. */ readonly vipIds: pulumi.Output; /** * The OCID of the zone the DB system is associated with. */ readonly zoneId: pulumi.Output; /** * Create a DbSystemsUpgrade resource with the given unique name, arguments, and options. * * @param name The _unique_ name of the resource. * @param args The arguments to use to populate this resource's properties. * @param opts A bag of options that control this resource's behavior. */ constructor(name: string, args: DbSystemsUpgradeArgs, opts?: pulumi.CustomResourceOptions); } /** * Input properties used for looking up and filtering DbSystemsUpgrade resources. */ export interface DbSystemsUpgradeState { /** * The operating system upgrade action. */ action?: pulumi.Input; /** * The name of the availability domain that the DB system is located in. */ availabilityDomain?: pulumi.Input; /** * A list of the [OCIDs](https://docs.cloud.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.cloud.oracle.com/iaas/Content/Network/Concepts/securityrules.htm). Applicable only to Exadata systems. */ backupNetworkNsgIds?: pulumi.Input[] | undefined>; /** * The [OCID](https://docs.cloud.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. */ backupSubnetId?: pulumi.Input; /** * 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?: pulumi.Input; /** * The [OCID](https://docs.cloud.oracle.com/iaas/Content/General/Concepts/identifiers.htm) of the compartment. */ compartmentId?: pulumi.Input; /** * The number of CPU cores enabled on the DB system. */ cpuCoreCount?: pulumi.Input; /** * 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. */ dataStoragePercentage?: pulumi.Input; /** * The data storage size, in gigabytes, that is currently available to the DB system. Applies only for virtual machine DB systems. */ dataStorageSizeInGb?: pulumi.Input; /** * The Oracle Database edition that applies to all the databases on the DB system. */ databaseEdition?: pulumi.Input; /** * The DB system [OCID](https://docs.cloud.oracle.com/iaas/Content/General/Concepts/identifiers.htm). */ dbSystemId?: pulumi.Input; /** * The DB system options. */ dbSystemOptions?: pulumi.Input[] | undefined>; /** * Defined tags for this resource. Each key is predefined and scoped to a namespace. For more information, see [Resource Tags](https://docs.cloud.oracle.com/iaas/Content/General/Concepts/resourcetags.htm). */ definedTags?: pulumi.Input<{ [key: string]: pulumi.Input; } | undefined>; /** * The type of redundancy configured for the DB system. NORMAL is 2-way redundancy. HIGH is 3-way redundancy. */ diskRedundancy?: pulumi.Input; /** * The user-friendly name for the DB system. The name does not have to be unique. */ displayName?: pulumi.Input; /** * The domain name for the DB system. */ domain?: pulumi.Input; /** * List of the Fault Domains in which this DB system is provisioned. */ faultDomains?: pulumi.Input[] | undefined>; /** * 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.cloud.oracle.com/iaas/Content/General/Concepts/resourcetags.htm). Example: `{"Department": "Finance"}` */ freeformTags?: pulumi.Input<{ [key: string]: pulumi.Input; } | undefined>; /** * The hostname for the DB system. */ hostname?: pulumi.Input; /** * The IORM settings of the Exadata DB system. */ iormConfigCaches?: pulumi.Input[] | undefined>; /** * If true, rollback time is updated even if operating system upgrade history contains errors. */ isSnapshotRetentionDaysForceUpdated?: pulumi.Input; /** * The OCID of the key container that is used as the master encryption key in database transparent data encryption (TDE) operations. */ kmsKeyId?: pulumi.Input; /** * The [OCID](https://docs.cloud.oracle.com/iaas/Content/General/Concepts/identifiers.htm) of the last maintenance run. */ lastMaintenanceRunId?: pulumi.Input; /** * The [OCID](https://docs.cloud.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?: pulumi.Input; /** * The Oracle license model that applies to all the databases on the DB system. The default is LICENSE_INCLUDED. */ licenseModel?: pulumi.Input; /** * Additional information about the current lifecycle state. */ lifecycleDetails?: pulumi.Input; /** * The port number configured for the listener on the DB system. */ listenerPort?: pulumi.Input; /** * The scheduling details for the quarterly maintenance window. Patching and system updates take place during the maintenance window. */ maintenanceWindows?: pulumi.Input[] | undefined>; /** * A valid Oracle Grid Infrastructure (GI) software version. */ newGiVersion?: pulumi.Input; newOsVersion?: pulumi.Input; /** * The [OCID](https://docs.cloud.oracle.com/iaas/Content/General/Concepts/identifiers.htm) of the next maintenance run. */ nextMaintenanceRunId?: pulumi.Input; /** * The number of nodes in the DB system. For RAC DB systems, the value is greater than 1. */ nodeCount?: pulumi.Input; /** * A list of the [OCIDs](https://docs.cloud.oracle.com/iaas/Content/General/Concepts/identifiers.htm) of the network security groups (NSGs) that this resource 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.cloud.oracle.com/iaas/Content/Network/Concepts/securityrules.htm). **NsgIds restrictions:** * * Autonomous Databases with private access require at least 1 Network Security Group (NSG). The nsgIds array cannot be empty. */ nsgIds?: pulumi.Input[] | undefined>; /** * 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?: pulumi.Input; /** * The RECO/REDO storage size, in gigabytes, that is currently allocated to the DB system. Applies only for virtual machine DB systems. */ recoStorageSizeInGb?: pulumi.Input; /** * The FQDN of the DNS record for the SCAN IP addresses that are associated with the DB system. */ scanDnsName?: pulumi.Input; /** * The [OCID](https://docs.cloud.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?: pulumi.Input; /** * The [OCID](https://docs.cloud.oracle.com/iaas/Content/General/Concepts/identifiers.htm) of the Single Client Access Name (SCAN) IP addresses associated with the DB system. SCAN IP addresses are typically used for load balancing and are not assigned to any interface. Oracle Clusterware directs the requests to the appropriate nodes in the cluster. */ scanIpIds?: pulumi.Input[] | undefined>; /** * 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?: pulumi.Input; /** * The retention period, in days, for the snapshot that allows you to perform a rollback of the upgrade operation. After this number of days passes, you cannot roll back the upgrade. * * ** 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 */ snapshotRetentionPeriodInDays?: pulumi.Input; /** * The [OCID](https://docs.cloud.oracle.com/iaas/Content/General/Concepts/identifiers.htm) of the DB system. */ sourceDbSystemId?: pulumi.Input; /** * True, if Sparse Diskgroup is configured for Exadata dbsystem, False, if Sparse diskgroup was not configured. */ sparseDiskgroup?: pulumi.Input; /** * The public key portion of one or more key pairs used for SSH access to the DB system. */ sshPublicKeys?: pulumi.Input[] | undefined>; /** * The current state of the DB system. */ state?: pulumi.Input; /** * The [OCID](https://docs.cloud.oracle.com/iaas/Content/General/Concepts/identifiers.htm) of the subnet the DB system is associated with. */ subnetId?: pulumi.Input; /** * The date and time the DB system was created. */ timeCreated?: pulumi.Input; /** * The time zone of the DB system. For details, see [DB System Time Zones](https://docs.cloud.oracle.com/iaas/Content/Database/References/timezones.htm). */ timeZone?: pulumi.Input; /** * The Oracle Database version of the DB system. */ version?: pulumi.Input; /** * The [OCID](https://docs.cloud.oracle.com/iaas/Content/General/Concepts/identifiers.htm) of the virtual IP (VIP) addresses associated with the DB system. The Cluster Ready Services (CRS) creates and maintains one VIP 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. */ vipIds?: pulumi.Input[] | undefined>; /** * The OCID of the zone the DB system is associated with. */ zoneId?: pulumi.Input; } /** * The set of arguments for constructing a DbSystemsUpgrade resource. */ export interface DbSystemsUpgradeArgs { /** * The operating system upgrade action. */ action: pulumi.Input; /** * The DB system [OCID](https://docs.cloud.oracle.com/iaas/Content/General/Concepts/identifiers.htm). */ dbSystemId: pulumi.Input; /** * If true, rollback time is updated even if operating system upgrade history contains errors. */ isSnapshotRetentionDaysForceUpdated?: pulumi.Input; /** * A valid Oracle Grid Infrastructure (GI) software version. */ newGiVersion?: pulumi.Input; newOsVersion?: pulumi.Input; /** * The retention period, in days, for the snapshot that allows you to perform a rollback of the upgrade operation. After this number of days passes, you cannot roll back the upgrade. * * ** 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 */ snapshotRetentionPeriodInDays?: pulumi.Input; } //# sourceMappingURL=dbSystemsUpgrade.d.ts.map