import * as pulumi from "@pulumi/pulumi"; import * as inputs from "../types/input"; import * as outputs from "../types/output"; /** * This resource provides the Database Upgrade resource in Oracle Cloud Infrastructure Database service. * Api doc link for the resource: https://docs.oracle.com/iaas/api/#/en/database/latest/DatabaseUpgrade * * Example terraform configs related to the resource : https://github.com/oracle/terraform-provider-oci/tree/master/examples/database * * Upgrades the specified Oracle Database instance. * * Database upgrade requires source to be `DB_VERSION` or `DB_SOFTWARE_IMAGE`. * `db_home.0.db_version` is updated to target DB version specified in the upgrade request. * To avoid a force new create of the dbHome on the next apply, add the following to the resource * ``` lifecycle { * ignore_changes = [ * db_home.0.db_version, * ] * } * ``` * * ## Example Usage * * ```typescript * import * as pulumi from "@pulumi/pulumi"; * import * as oci from "@pulumi/oci"; * * const testDatabaseUpgrade = new oci.database.DatabaseUpgrade("test_database_upgrade", { * action: databaseUpgradeAction, * databaseId: testDatabase.id, * databaseUpgradeSourceDetails: { * databaseSoftwareImageId: testDatabaseSoftwareImage.id, * dbHomeId: testDbHome.id, * dbVersion: databaseUpgradeDatabaseUpgradeSourceDetailsDbVersion, * options: databaseUpgradeDatabaseUpgradeSourceDetailsOptions, * source: databaseUpgradeDatabaseUpgradeSourceDetailsSource, * }, * }); * ``` * * ## Import * * Import is not supported for this resource. */ export declare class DatabaseUpgrade extends pulumi.CustomResource { /** * Get an existing DatabaseUpgrade 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?: DatabaseUpgradeState, opts?: pulumi.CustomResourceOptions): DatabaseUpgrade; /** * Returns true if the given object is an instance of DatabaseUpgrade. 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 DatabaseUpgrade; /** * The database upgrade action. */ readonly action: pulumi.Output; /** * The character set for the database. */ readonly characterSet: pulumi.Output; /** * The [OCID](https://docs.cloud.oracle.com/iaas/Content/General/Concepts/identifiers.htm) of the compartment. */ readonly compartmentId: pulumi.Output; /** * The Connection strings used to connect to the Oracle Database. */ readonly connectionStrings: pulumi.Output; /** * Details of Data Guard setup that the given database is part of. Also includes information about databases part of this Data Guard group and properties for their Data Guard configuration. */ readonly dataGuardGroups: pulumi.Output; /** * The database [OCID](https://docs.cloud.oracle.com/iaas/Content/General/Concepts/identifiers.htm). */ readonly databaseId: pulumi.Output; /** * The database software image [OCID](https://docs.cloud.oracle.com/iaas/Content/General/Concepts/identifiers.htm) */ readonly databaseSoftwareImageId: pulumi.Output; /** * Details for the database upgrade source. */ readonly databaseUpgradeSourceDetails: pulumi.Output; /** * Backup Options To use any of the API operations, you must be authorized in an IAM policy. If you're not authorized, talk to an administrator. If you're an administrator who needs to write policies to give users access, see [Getting Started with Policies](https://docs.cloud.oracle.com/iaas/Content/Identity/Concepts/policygetstarted.htm). */ readonly dbBackupConfigs: pulumi.Output; /** * The [OCID](https://docs.cloud.oracle.com/iaas/Content/General/Concepts/identifiers.htm) of the Database Home. */ readonly dbHomeId: pulumi.Output; /** * The database name. */ readonly dbName: pulumi.Output; /** * The [OCID](https://docs.cloud.oracle.com/iaas/Content/General/Concepts/identifiers.htm) of the DB system. */ readonly dbSystemId: pulumi.Output; /** * A system-generated name for the database to ensure uniqueness within an Oracle Data Guard group (a primary database and its standby databases). The unique name cannot be changed. */ readonly dbUniqueName: pulumi.Output; /** * **Deprecated.** The dbWorkload field has been deprecated for Exadata Database Service on Dedicated Infrastructure, Exadata Database Service on Cloud@Customer, and Base Database Service. Support for this attribute will end in November 2023. You may choose to update your custom scripts to exclude the dbWorkload attribute. After November 2023 if you pass a value to the dbWorkload attribute, it will be ignored. */ readonly dbWorkload: 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; }>; /** * 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; }>; /** * True if the database is a container database. */ readonly isCdb: pulumi.Output; /** * The [OCID](https://docs.cloud.oracle.com/iaas/Content/General/Concepts/identifiers.htm) of the key store of Oracle Vault. */ readonly keyStoreId: pulumi.Output; /** * The wallet name for Oracle Key Vault. */ readonly keyStoreWalletName: 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 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. Autonomous AI Database Serverless does not use key versions, hence is not applicable for Autonomous AI Database Serverless instances. */ readonly kmsKeyVersionId: pulumi.Output; /** * The duration when the latest database backup created. */ readonly lastBackupDurationInSeconds: pulumi.Output; /** * The date and time when the latest database backup was created. */ readonly lastBackupTimestamp: pulumi.Output; /** * The date and time when the latest database backup failed. */ readonly lastFailedBackupTimestamp: pulumi.Output; /** * Additional information about the current lifecycle state. */ readonly lifecycleDetails: pulumi.Output; /** * The national character set for the database. */ readonly ncharacterSet: pulumi.Output; /** * The name of the pluggable database. The name must begin with an alphabetic character and can contain a maximum of thirty alphanumeric characters. Special characters are not permitted. Pluggable database should not be same as database name. */ readonly pdbName: pulumi.Output; /** * Specifies a prefix for the `Oracle SID` of the database to be created. */ readonly sidPrefix: pulumi.Output; /** * Point in time recovery timeStamp of the source database at which cloned database system is cloned from the source database system, as described in [RFC 3339](https://tools.ietf.org/rfc/rfc3339) */ readonly sourceDatabasePointInTimeRecoveryTimestamp: pulumi.Output; /** * The current state of the database. */ readonly state: pulumi.Output; /** * System 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 systemTags: pulumi.Output<{ [key: string]: string; }>; /** * The date and time the database was created. */ readonly timeCreated: pulumi.Output; /** * The [OCID](https://docs.cloud.oracle.com/iaas/Content/General/Concepts/identifiers.htm) of the Oracle Cloud Infrastructure [vault](https://docs.cloud.oracle.com/iaas/Content/KeyManagement/Concepts/keyoverview.htm#concepts). This parameter and `secretId` are required for Customer Managed Keys. */ readonly vaultId: pulumi.Output; /** * The [OCID](https://docs.cloud.oracle.com/iaas/Content/General/Concepts/identifiers.htm) of the VM cluster. */ readonly vmClusterId: pulumi.Output; /** * Create a DatabaseUpgrade 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: DatabaseUpgradeArgs, opts?: pulumi.CustomResourceOptions); } /** * Input properties used for looking up and filtering DatabaseUpgrade resources. */ export interface DatabaseUpgradeState { /** * The database upgrade action. */ action?: pulumi.Input; /** * The character set for the database. */ characterSet?: pulumi.Input; /** * The [OCID](https://docs.cloud.oracle.com/iaas/Content/General/Concepts/identifiers.htm) of the compartment. */ compartmentId?: pulumi.Input; /** * The Connection strings used to connect to the Oracle Database. */ connectionStrings?: pulumi.Input[] | undefined>; /** * Details of Data Guard setup that the given database is part of. Also includes information about databases part of this Data Guard group and properties for their Data Guard configuration. */ dataGuardGroups?: pulumi.Input[] | undefined>; /** * The database [OCID](https://docs.cloud.oracle.com/iaas/Content/General/Concepts/identifiers.htm). */ databaseId?: pulumi.Input; /** * The database software image [OCID](https://docs.cloud.oracle.com/iaas/Content/General/Concepts/identifiers.htm) */ databaseSoftwareImageId?: pulumi.Input; /** * Details for the database upgrade source. */ databaseUpgradeSourceDetails?: pulumi.Input; /** * Backup Options To use any of the API operations, you must be authorized in an IAM policy. If you're not authorized, talk to an administrator. If you're an administrator who needs to write policies to give users access, see [Getting Started with Policies](https://docs.cloud.oracle.com/iaas/Content/Identity/Concepts/policygetstarted.htm). */ dbBackupConfigs?: pulumi.Input[] | undefined>; /** * The [OCID](https://docs.cloud.oracle.com/iaas/Content/General/Concepts/identifiers.htm) of the Database Home. */ dbHomeId?: pulumi.Input; /** * The database name. */ dbName?: pulumi.Input; /** * The [OCID](https://docs.cloud.oracle.com/iaas/Content/General/Concepts/identifiers.htm) of the DB system. */ dbSystemId?: pulumi.Input; /** * A system-generated name for the database to ensure uniqueness within an Oracle Data Guard group (a primary database and its standby databases). The unique name cannot be changed. */ dbUniqueName?: pulumi.Input; /** * **Deprecated.** The dbWorkload field has been deprecated for Exadata Database Service on Dedicated Infrastructure, Exadata Database Service on Cloud@Customer, and Base Database Service. Support for this attribute will end in November 2023. You may choose to update your custom scripts to exclude the dbWorkload attribute. After November 2023 if you pass a value to the dbWorkload attribute, it will be ignored. */ dbWorkload?: pulumi.Input; /** * 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>; /** * 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>; /** * True if the database is a container database. */ isCdb?: pulumi.Input; /** * The [OCID](https://docs.cloud.oracle.com/iaas/Content/General/Concepts/identifiers.htm) of the key store of Oracle Vault. */ keyStoreId?: pulumi.Input; /** * The wallet name for Oracle Key Vault. */ keyStoreWalletName?: 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 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. Autonomous AI Database Serverless does not use key versions, hence is not applicable for Autonomous AI Database Serverless instances. */ kmsKeyVersionId?: pulumi.Input; /** * The duration when the latest database backup created. */ lastBackupDurationInSeconds?: pulumi.Input; /** * The date and time when the latest database backup was created. */ lastBackupTimestamp?: pulumi.Input; /** * The date and time when the latest database backup failed. */ lastFailedBackupTimestamp?: pulumi.Input; /** * Additional information about the current lifecycle state. */ lifecycleDetails?: pulumi.Input; /** * The national character set for the database. */ ncharacterSet?: pulumi.Input; /** * The name of the pluggable database. The name must begin with an alphabetic character and can contain a maximum of thirty alphanumeric characters. Special characters are not permitted. Pluggable database should not be same as database name. */ pdbName?: pulumi.Input; /** * Specifies a prefix for the `Oracle SID` of the database to be created. */ sidPrefix?: pulumi.Input; /** * Point in time recovery timeStamp of the source database at which cloned database system is cloned from the source database system, as described in [RFC 3339](https://tools.ietf.org/rfc/rfc3339) */ sourceDatabasePointInTimeRecoveryTimestamp?: pulumi.Input; /** * The current state of the database. */ state?: pulumi.Input; /** * System 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). */ systemTags?: pulumi.Input<{ [key: string]: pulumi.Input; } | undefined>; /** * The date and time the database was created. */ timeCreated?: pulumi.Input; /** * The [OCID](https://docs.cloud.oracle.com/iaas/Content/General/Concepts/identifiers.htm) of the Oracle Cloud Infrastructure [vault](https://docs.cloud.oracle.com/iaas/Content/KeyManagement/Concepts/keyoverview.htm#concepts). This parameter and `secretId` are required for Customer Managed Keys. */ vaultId?: pulumi.Input; /** * The [OCID](https://docs.cloud.oracle.com/iaas/Content/General/Concepts/identifiers.htm) of the VM cluster. */ vmClusterId?: pulumi.Input; } /** * The set of arguments for constructing a DatabaseUpgrade resource. */ export interface DatabaseUpgradeArgs { /** * The database upgrade action. */ action: pulumi.Input; /** * The database [OCID](https://docs.cloud.oracle.com/iaas/Content/General/Concepts/identifiers.htm). */ databaseId: pulumi.Input; /** * Details for the database upgrade source. */ databaseUpgradeSourceDetails?: pulumi.Input; } //# sourceMappingURL=databaseUpgrade.d.ts.map