import * as pulumi from "@pulumi/pulumi"; import * as inputs from "../types/input"; import * as outputs from "../types/output"; /** * This resource provides the Data Guard Association resource in Oracle Cloud Infrastructure Database service. * Api doc link for the resource: https://docs.oracle.com/iaas/api/#/en/database/latest/DataGuardAssociation * * Example terraform configs related to the resource : https://github.com/oracle/terraform-provider-oci/tree/master/examples/database * * Creates a new Data Guard association. A Data Guard association represents the replication relationship between the * specified database and a peer database. For more information, see [Using Oracle Data Guard](https://docs.cloud.oracle.com/iaas/Content/Database/Tasks/usingdataguard.htm). * * All Oracle Cloud Infrastructure resources, including Data Guard associations, get an Oracle-assigned, unique ID * called an Oracle Cloud Identifier (OCID). When you create a resource, you can find its OCID in the response. * You can also retrieve a resource's OCID by using a List API operation on that resource type, or by viewing the * resource in the Console. For more information, see * [Resource Identifiers](https://docs.cloud.oracle.com/iaas/Content/General/Concepts/identifiers.htm). * * ## Example Usage * * ```typescript * import * as pulumi from "@pulumi/pulumi"; * import * as oci from "@pulumi/oci"; * * const testDataGuardAssociation = new oci.database.DataGuardAssociation("test_data_guard_association", { * creationType: dataGuardAssociationCreationType, * databaseAdminPassword: dataGuardAssociationDatabaseAdminPassword, * databaseId: testDatabase.id, * deleteStandbyDbHomeOnDelete: dataGuardAssociationDeleteStandbyDbHomeOnDelete, * protectionMode: dataGuardAssociationProtectionMode, * transportType: dataGuardAssociationTransportType, * availabilityDomain: dataGuardAssociationAvailabilityDomain, * backupNetworkNsgIds: dataGuardAssociationBackupNetworkNsgIds, * computeCount: Number(dataGuardAssociationComputeCount), * computeModel: dataGuardAssociationComputeModel, * cpuCoreCount: Number(dataGuardAssociationCpuCoreCount), * databaseDefinedTags: dataGuardAssociationDatabaseDefinedTags, * databaseFreeformTags: dataGuardAssociationDatabaseFreeformTags, * dataCollectionOptions: { * isDiagnosticsEventsEnabled: dataGuardAssociationDataCollectionOptionsIsDiagnosticsEventsEnabled === "true", * isHealthMonitoringEnabled: dataGuardAssociationDataCollectionOptionsIsHealthMonitoringEnabled === "true", * isIncidentLogsEnabled: dataGuardAssociationDataCollectionOptionsIsIncidentLogsEnabled === "true", * }, * databaseSoftwareImageId: testDatabaseSoftwareImage.id, * dbSystemDefinedTags: dataGuardAssociationDbSystemDefinedTags, * dbSystemFreeformTags: dataGuardAssociationDbSystemFreeformTags, * dbSystemSecurityAttributes: dataGuardAssociationDbSystemSecurityAttributes, * displayName: dataGuardAssociationDisplayName, * domain: dataGuardAssociationDomain, * faultDomains: dataGuardAssociationFaultDomains, * hostname: dataGuardAssociationHostname, * isActiveDataGuardEnabled: dataGuardAssociationIsActiveDataGuardEnabled === "true", * licenseModel: dataGuardAssociationLicenseModel, * nodeCount: Number(dataGuardAssociationNodeCount), * nsgIds: dataGuardAssociationNsgIds, * peerDbHomeId: testDbHome.id, * peerDbSystemId: testDbSystem.id, * peerDbUniqueName: dataGuardAssociationPeerDbUniqueName, * peerSidPrefix: dataGuardAssociationPeerSidPrefix, * peerVmClusterId: testVmCluster.id, * privateIp: dataGuardAssociationPrivateIp, * privateIpV6: dataGuardAssociationPrivateIpV6, * shape: dataGuardAssociationShape, * storageVolumePerformanceMode: dataGuardAssociationStorageVolumePerformanceMode, * subnetId: testSubnet.id, * timeZone: dataGuardAssociationTimeZone, * }); * ``` * * ## Import * * Import is not supported for this resource. */ export declare class DataGuardAssociation extends pulumi.CustomResource { /** * Get an existing DataGuardAssociation 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?: DataGuardAssociationState, opts?: pulumi.CustomResourceOptions): DataGuardAssociation; /** * Returns true if the given object is an instance of DataGuardAssociation. 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 DataGuardAssociation; /** * The lag time between updates to the primary database and application of the redo data on the standby database, as computed by the reporting database. Example: `9 seconds` */ readonly applyLag: pulumi.Output; /** * The rate at which redo logs are synced between the associated databases. Example: `180 Mb per second` */ readonly applyRate: pulumi.Output; /** * The name of the availability domain that the standby database DB system will be located in. For example- "Uocm:PHX-AD-1". */ 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; readonly clusterPlacementGroupId: pulumi.Output; /** * The number of compute servers for the DB system. */ readonly computeCount: pulumi.Output; /** * The compute model for Base Database Service. This is required if using the `computeCount` parameter. If using `cpuCoreCount` then it is an error to specify `computeModel` to a non-null value. The ECPU compute model is the recommended model, and the OCPU compute model is legacy. */ readonly computeModel: pulumi.Output; /** * The number of CPU cores available for AMD-based virtual machine DB systems. */ readonly cpuCoreCount: pulumi.Output; readonly createAsync: pulumi.Output; /** * Specifies whether to create the peer database in an existing DB system or in a new DB system. */ readonly creationType: pulumi.Output; /** * Indicates user preferences for the various diagnostic collection options for the VM cluster/Cloud VM cluster/VMBM DBCS. */ readonly dataCollectionOptions: pulumi.Output; /** * (Updatable) A strong password for the `SYS`, `SYSTEM`, and `PDB Admin` users to apply during standby creation. * * The password must contain no fewer than nine characters and include: * * At least two uppercase characters. * * At least two lowercase characters. * * At least two numeric characters. * * At least two special characters. Valid special characters include "_", "#", and "-" only. * * **The password MUST be the same as the primary admin password.** */ readonly databaseAdminPassword: 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 databaseDefinedTags: pulumi.Output<{ [key: string]: string; } | 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"}` */ readonly databaseFreeformTags: pulumi.Output<{ [key: string]: string; } | undefined>; /** * 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). Applicable only when creationType=`ExistingDbSystem` and when the existing database has Exadata shape. */ readonly databaseSoftwareImageId: 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 dbSystemDefinedTags: pulumi.Output<{ [key: string]: string; } | 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"}` */ readonly dbSystemFreeformTags: pulumi.Output<{ [key: string]: string; } | undefined>; /** * Security Attributes 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). Example: `{"Oracle-ZPR": {"MaxEgressCount": {"value": "42", "mode": "audit"}}}` */ readonly dbSystemSecurityAttributes: pulumi.Output<{ [key: string]: string; } | undefined>; /** * (Updatable) if set to true the destroy operation will destroy the standby dbHome/dbSystem that is referenced in the Data Guard Association. The Data Guard Association gets destroyed when standby dbHome/dbSystem is terminated. Only `true` is supported at this time. If you change an argument that is used during the delete operation you must run `pulumi up` first so that that the change in the value is registered in the statefile before running `terraform destroy`. `terraform destroy` only looks at what is currently on the statefile and ignores the terraform configuration files. */ readonly deleteStandbyDbHomeOnDelete: pulumi.Output; /** * The user-friendly name of the DB system that will contain the the standby database. The display name does not have to be unique. */ readonly displayName: pulumi.Output; /** * A domain name used for the DB system. If the Oracle-provided Internet and VCN Resolver is enabled for the specified subnet, the domain name for the subnet is used (do not provide one). Otherwise, provide a valid DNS domain name. Hyphens (-) are not permitted. */ readonly domain: pulumi.Output; /** * A Fault Domain is a grouping of hardware and infrastructure within an availability domain. Fault Domains let you distribute your instances so that they are not on the same physical hardware within a single availability domain. A hardware failure or maintenance that affects one Fault Domain does not affect DB systems in other Fault Domains. * * If you do not specify the Fault Domain, the system selects one for you. To change the Fault Domain for a DB system, terminate it and launch a new DB system in the preferred Fault Domain. * * If the node count is greater than 1, you can specify which Fault Domains these nodes will be distributed into. The system assigns your nodes automatically to the Fault Domains you specify so that no Fault Domain contains more than one node. * * To get a list of Fault Domains, use the [ListFaultDomains](https://docs.cloud.oracle.com/iaas/api/#/en/identity/latest/FaultDomain/ListFaultDomains) operation in the Identity and Access Management Service API. * * Example: `FAULT-DOMAIN-1` */ readonly faultDomains: pulumi.Output; /** * The hostname for the DB node. */ readonly hostname: pulumi.Output; /** * (Updatable) True if active Data Guard is enabled. */ readonly isActiveDataGuardEnabled: pulumi.Output; /** * The Oracle license model that applies to all the databases on the dataguard standby DB system. The default is LICENSE_INCLUDED. Bring your own license (BYOL) allows you to select the DB edition using the optional parameter, for Autonomous AI Database Serverless. */ readonly licenseModel: pulumi.Output; /** * Additional information about the current lifecycleState, if available. */ readonly lifecycleDetails: pulumi.Output; /** * (Updatable) An optional property when incremented triggers Migrate. Could be set to any integer value. * * ** 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 migrateTrigger: pulumi.Output; /** * The number of nodes to launch for the DB system of the standby in the Data Guard association. For a 2-node RAC virtual machine DB system, specify either 1 or 2. If you do not supply this parameter, the default is the node count of the primary DB system. */ readonly nodeCount: pulumi.Output; /** * The list of [OCIDs](https://docs.cloud.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.cloud.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. */ readonly nsgIds: pulumi.Output; /** * The [OCID](https://docs.cloud.oracle.com/iaas/Content/General/Concepts/identifiers.htm) of the peer database's Data Guard association. */ readonly peerDataGuardAssociationId: pulumi.Output; /** * The [OCID](https://docs.cloud.oracle.com/iaas/Content/General/Concepts/identifiers.htm) of the associated peer database. */ readonly peerDatabaseId: pulumi.Output; /** * The [OCID](https://docs.cloud.oracle.com/iaas/Content/General/Concepts/identifiers.htm) of the DB home in which to create the standby database. You must supply this value to create standby database with an existing DB home */ readonly peerDbHomeId: pulumi.Output; /** * The [OCID](https://docs.cloud.oracle.com/iaas/Content/General/Concepts/identifiers.htm) of the DB system in which to create the standby database. You must supply this value if creationType is `ExistingDbSystem`. */ readonly peerDbSystemId: pulumi.Output; /** * Specifies the `DB_UNIQUE_NAME` of the peer database to be created. */ readonly peerDbUniqueName: pulumi.Output; /** * The role of the peer database in this Data Guard association. */ readonly peerRole: pulumi.Output; /** * Specifies a prefix for the `Oracle SID` of the database to be created. */ readonly peerSidPrefix: pulumi.Output; /** * The [OCID](https://docs.cloud.oracle.com/iaas/Content/General/Concepts/identifiers.htm) of the VM Cluster in which to create the standby database. You must supply this value if creationType is `ExistingVmCluster`. */ readonly peerVmClusterId: pulumi.Output; /** * The IPv4 address from the provided Oracle Cloud Infrastructure subnet which needs to be assigned to the VNIC. If not provided, it will be auto-assigned with an available IPv4 address from the subnet. */ readonly privateIp: pulumi.Output; /** * The IPv6 address from the provided Oracle Cloud Infrastructure subnet which needs to be assigned to the VNIC. If not provided, it will be auto-assigned with an available IPv6 address from the subnet. */ readonly privateIpV6: pulumi.Output; /** * (Updatable) The protection mode to set up between the primary and standby databases. For more information, see [Oracle Data Guard Protection Modes](http://docs.oracle.com/database/122/SBYDB/oracle-data-guard-protection-modes.htm#SBYDB02000) in the Oracle Data Guard documentation. * * **IMPORTANT** - The only protection mode currently supported by the Database service is MAXIMUM_PERFORMANCE. */ readonly protectionMode: pulumi.Output; /** * The role of the reporting database in this Data Guard association. */ readonly role: pulumi.Output; /** * The virtual machine DB system shape to launch for the standby database in the Data Guard association. The shape determines the number of CPU cores and the amount of memory available for the DB system. Only virtual machine shapes are valid options. If you do not supply this parameter, the default shape is the shape of the primary DB system. * * To get a list of all shapes, use the [ListDbSystemShapes](https://docs.cloud.oracle.com/iaas/api/#/en/database/latest/DbSystemShapeSummary/ListDbSystemShapes) operation. */ readonly shape: pulumi.Output; /** * The current state of the Data Guard association. */ readonly state: pulumi.Output; /** * The block storage volume performance level. Valid values are `BALANCED` and `HIGH_PERFORMANCE`. See [Block Volume Performance](https://docs.cloud.oracle.com/iaas/Content/Block/Concepts/blockvolumeperformance.htm) for more information. */ readonly storageVolumePerformanceMode: pulumi.Output; /** * The OCID of the subnet the DB system is associated with. **Subnet Restrictions:** * * For 1- and 2-node RAC DB systems, do not use a subnet that overlaps with 192.168.16.16/28 * * 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. */ readonly subnetId: pulumi.Output; readonly subscriptionId: pulumi.Output; /** * The date and time the Data Guard association was created. */ readonly timeCreated: pulumi.Output; /** * The time zone of the dataguard standby DB system. For details, see [DB System Time Zones](https://docs.cloud.oracle.com/iaas/Content/Database/References/timezones.htm). */ readonly timeZone: pulumi.Output; /** * (Updatable) The redo transport type to use for this Data Guard association. Valid values depend on the specified `protectionMode`: * * MAXIMUM_AVAILABILITY - SYNC or FASTSYNC * * MAXIMUM_PERFORMANCE - ASYNC * * MAXIMUM_PROTECTION - SYNC * * For more information, see [Redo Transport Services](http://docs.oracle.com/database/122/SBYDB/oracle-data-guard-redo-transport-services.htm#SBYDB00400) in the Oracle Data Guard documentation. * * **IMPORTANT** - The only transport type currently supported by the Database service is ASYNC. */ readonly transportType: pulumi.Output; /** * Create a DataGuardAssociation 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: DataGuardAssociationArgs, opts?: pulumi.CustomResourceOptions); } /** * Input properties used for looking up and filtering DataGuardAssociation resources. */ export interface DataGuardAssociationState { /** * The lag time between updates to the primary database and application of the redo data on the standby database, as computed by the reporting database. Example: `9 seconds` */ applyLag?: pulumi.Input; /** * The rate at which redo logs are synced between the associated databases. Example: `180 Mb per second` */ applyRate?: pulumi.Input; /** * The name of the availability domain that the standby database DB system will be located in. For example- "Uocm:PHX-AD-1". */ 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>; clusterPlacementGroupId?: pulumi.Input; /** * The number of compute servers for the DB system. */ computeCount?: pulumi.Input; /** * The compute model for Base Database Service. This is required if using the `computeCount` parameter. If using `cpuCoreCount` then it is an error to specify `computeModel` to a non-null value. The ECPU compute model is the recommended model, and the OCPU compute model is legacy. */ computeModel?: pulumi.Input; /** * The number of CPU cores available for AMD-based virtual machine DB systems. */ cpuCoreCount?: pulumi.Input; createAsync?: pulumi.Input; /** * Specifies whether to create the peer database in an existing DB system or in a new DB system. */ creationType?: pulumi.Input; /** * Indicates user preferences for the various diagnostic collection options for the VM cluster/Cloud VM cluster/VMBM DBCS. */ dataCollectionOptions?: pulumi.Input; /** * (Updatable) A strong password for the `SYS`, `SYSTEM`, and `PDB Admin` users to apply during standby creation. * * The password must contain no fewer than nine characters and include: * * At least two uppercase characters. * * At least two lowercase characters. * * At least two numeric characters. * * At least two special characters. Valid special characters include "_", "#", and "-" only. * * **The password MUST be the same as the primary admin password.** */ databaseAdminPassword?: 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). */ databaseDefinedTags?: 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"}` */ databaseFreeformTags?: pulumi.Input<{ [key: string]: 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). Applicable only when creationType=`ExistingDbSystem` and when the existing database has Exadata shape. */ databaseSoftwareImageId?: 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). */ dbSystemDefinedTags?: 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"}` */ dbSystemFreeformTags?: pulumi.Input<{ [key: string]: pulumi.Input; } | undefined>; /** * Security Attributes 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). Example: `{"Oracle-ZPR": {"MaxEgressCount": {"value": "42", "mode": "audit"}}}` */ dbSystemSecurityAttributes?: pulumi.Input<{ [key: string]: pulumi.Input; } | undefined>; /** * (Updatable) if set to true the destroy operation will destroy the standby dbHome/dbSystem that is referenced in the Data Guard Association. The Data Guard Association gets destroyed when standby dbHome/dbSystem is terminated. Only `true` is supported at this time. If you change an argument that is used during the delete operation you must run `pulumi up` first so that that the change in the value is registered in the statefile before running `terraform destroy`. `terraform destroy` only looks at what is currently on the statefile and ignores the terraform configuration files. */ deleteStandbyDbHomeOnDelete?: pulumi.Input; /** * The user-friendly name of the DB system that will contain the the standby database. The display name does not have to be unique. */ displayName?: pulumi.Input; /** * A domain name used for the DB system. If the Oracle-provided Internet and VCN Resolver is enabled for the specified subnet, the domain name for the subnet is used (do not provide one). Otherwise, provide a valid DNS domain name. Hyphens (-) are not permitted. */ domain?: pulumi.Input; /** * A Fault Domain is a grouping of hardware and infrastructure within an availability domain. Fault Domains let you distribute your instances so that they are not on the same physical hardware within a single availability domain. A hardware failure or maintenance that affects one Fault Domain does not affect DB systems in other Fault Domains. * * If you do not specify the Fault Domain, the system selects one for you. To change the Fault Domain for a DB system, terminate it and launch a new DB system in the preferred Fault Domain. * * If the node count is greater than 1, you can specify which Fault Domains these nodes will be distributed into. The system assigns your nodes automatically to the Fault Domains you specify so that no Fault Domain contains more than one node. * * To get a list of Fault Domains, use the [ListFaultDomains](https://docs.cloud.oracle.com/iaas/api/#/en/identity/latest/FaultDomain/ListFaultDomains) operation in the Identity and Access Management Service API. * * Example: `FAULT-DOMAIN-1` */ faultDomains?: pulumi.Input[] | undefined>; /** * The hostname for the DB node. */ hostname?: pulumi.Input; /** * (Updatable) True if active Data Guard is enabled. */ isActiveDataGuardEnabled?: pulumi.Input; /** * The Oracle license model that applies to all the databases on the dataguard standby DB system. The default is LICENSE_INCLUDED. Bring your own license (BYOL) allows you to select the DB edition using the optional parameter, for Autonomous AI Database Serverless. */ licenseModel?: pulumi.Input; /** * Additional information about the current lifecycleState, if available. */ lifecycleDetails?: pulumi.Input; /** * (Updatable) An optional property when incremented triggers Migrate. Could be set to any integer value. * * ** 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 */ migrateTrigger?: pulumi.Input; /** * The number of nodes to launch for the DB system of the standby in the Data Guard association. For a 2-node RAC virtual machine DB system, specify either 1 or 2. If you do not supply this parameter, the default is the node count of the primary DB system. */ nodeCount?: pulumi.Input; /** * The list of [OCIDs](https://docs.cloud.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.cloud.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?: pulumi.Input[] | undefined>; /** * The [OCID](https://docs.cloud.oracle.com/iaas/Content/General/Concepts/identifiers.htm) of the peer database's Data Guard association. */ peerDataGuardAssociationId?: pulumi.Input; /** * The [OCID](https://docs.cloud.oracle.com/iaas/Content/General/Concepts/identifiers.htm) of the associated peer database. */ peerDatabaseId?: pulumi.Input; /** * The [OCID](https://docs.cloud.oracle.com/iaas/Content/General/Concepts/identifiers.htm) of the DB home in which to create the standby database. You must supply this value to create standby database with an existing DB home */ peerDbHomeId?: pulumi.Input; /** * The [OCID](https://docs.cloud.oracle.com/iaas/Content/General/Concepts/identifiers.htm) of the DB system in which to create the standby database. You must supply this value if creationType is `ExistingDbSystem`. */ peerDbSystemId?: pulumi.Input; /** * Specifies the `DB_UNIQUE_NAME` of the peer database to be created. */ peerDbUniqueName?: pulumi.Input; /** * The role of the peer database in this Data Guard association. */ peerRole?: pulumi.Input; /** * Specifies a prefix for the `Oracle SID` of the database to be created. */ peerSidPrefix?: pulumi.Input; /** * The [OCID](https://docs.cloud.oracle.com/iaas/Content/General/Concepts/identifiers.htm) of the VM Cluster in which to create the standby database. You must supply this value if creationType is `ExistingVmCluster`. */ peerVmClusterId?: pulumi.Input; /** * The IPv4 address from the provided Oracle Cloud Infrastructure subnet which needs to be assigned to the VNIC. If not provided, it will be auto-assigned with an available IPv4 address from the subnet. */ privateIp?: pulumi.Input; /** * The IPv6 address from the provided Oracle Cloud Infrastructure subnet which needs to be assigned to the VNIC. If not provided, it will be auto-assigned with an available IPv6 address from the subnet. */ privateIpV6?: pulumi.Input; /** * (Updatable) The protection mode to set up between the primary and standby databases. For more information, see [Oracle Data Guard Protection Modes](http://docs.oracle.com/database/122/SBYDB/oracle-data-guard-protection-modes.htm#SBYDB02000) in the Oracle Data Guard documentation. * * **IMPORTANT** - The only protection mode currently supported by the Database service is MAXIMUM_PERFORMANCE. */ protectionMode?: pulumi.Input; /** * The role of the reporting database in this Data Guard association. */ role?: pulumi.Input; /** * The virtual machine DB system shape to launch for the standby database in the Data Guard association. The shape determines the number of CPU cores and the amount of memory available for the DB system. Only virtual machine shapes are valid options. If you do not supply this parameter, the default shape is the shape of the primary DB system. * * To get a list of all shapes, use the [ListDbSystemShapes](https://docs.cloud.oracle.com/iaas/api/#/en/database/latest/DbSystemShapeSummary/ListDbSystemShapes) operation. */ shape?: pulumi.Input; /** * The current state of the Data Guard association. */ state?: pulumi.Input; /** * The block storage volume performance level. Valid values are `BALANCED` and `HIGH_PERFORMANCE`. See [Block Volume Performance](https://docs.cloud.oracle.com/iaas/Content/Block/Concepts/blockvolumeperformance.htm) for more information. */ storageVolumePerformanceMode?: pulumi.Input; /** * The OCID of the subnet the DB system is associated with. **Subnet Restrictions:** * * For 1- and 2-node RAC DB systems, do not use a subnet that overlaps with 192.168.16.16/28 * * 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?: pulumi.Input; subscriptionId?: pulumi.Input; /** * The date and time the Data Guard association was created. */ timeCreated?: pulumi.Input; /** * The time zone of the dataguard standby DB system. For details, see [DB System Time Zones](https://docs.cloud.oracle.com/iaas/Content/Database/References/timezones.htm). */ timeZone?: pulumi.Input; /** * (Updatable) The redo transport type to use for this Data Guard association. Valid values depend on the specified `protectionMode`: * * MAXIMUM_AVAILABILITY - SYNC or FASTSYNC * * MAXIMUM_PERFORMANCE - ASYNC * * MAXIMUM_PROTECTION - SYNC * * For more information, see [Redo Transport Services](http://docs.oracle.com/database/122/SBYDB/oracle-data-guard-redo-transport-services.htm#SBYDB00400) in the Oracle Data Guard documentation. * * **IMPORTANT** - The only transport type currently supported by the Database service is ASYNC. */ transportType?: pulumi.Input; } /** * The set of arguments for constructing a DataGuardAssociation resource. */ export interface DataGuardAssociationArgs { /** * The name of the availability domain that the standby database DB system will be located in. For example- "Uocm:PHX-AD-1". */ 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>; clusterPlacementGroupId?: pulumi.Input; /** * The number of compute servers for the DB system. */ computeCount?: pulumi.Input; /** * The compute model for Base Database Service. This is required if using the `computeCount` parameter. If using `cpuCoreCount` then it is an error to specify `computeModel` to a non-null value. The ECPU compute model is the recommended model, and the OCPU compute model is legacy. */ computeModel?: pulumi.Input; /** * The number of CPU cores available for AMD-based virtual machine DB systems. */ cpuCoreCount?: pulumi.Input; createAsync?: pulumi.Input; /** * Specifies whether to create the peer database in an existing DB system or in a new DB system. */ creationType: pulumi.Input; /** * Indicates user preferences for the various diagnostic collection options for the VM cluster/Cloud VM cluster/VMBM DBCS. */ dataCollectionOptions?: pulumi.Input; /** * (Updatable) A strong password for the `SYS`, `SYSTEM`, and `PDB Admin` users to apply during standby creation. * * The password must contain no fewer than nine characters and include: * * At least two uppercase characters. * * At least two lowercase characters. * * At least two numeric characters. * * At least two special characters. Valid special characters include "_", "#", and "-" only. * * **The password MUST be the same as the primary admin password.** */ databaseAdminPassword: 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). */ databaseDefinedTags?: 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"}` */ databaseFreeformTags?: pulumi.Input<{ [key: string]: 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). Applicable only when creationType=`ExistingDbSystem` and when the existing database has Exadata shape. */ databaseSoftwareImageId?: 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). */ dbSystemDefinedTags?: 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"}` */ dbSystemFreeformTags?: pulumi.Input<{ [key: string]: pulumi.Input; } | undefined>; /** * Security Attributes 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). Example: `{"Oracle-ZPR": {"MaxEgressCount": {"value": "42", "mode": "audit"}}}` */ dbSystemSecurityAttributes?: pulumi.Input<{ [key: string]: pulumi.Input; } | undefined>; /** * (Updatable) if set to true the destroy operation will destroy the standby dbHome/dbSystem that is referenced in the Data Guard Association. The Data Guard Association gets destroyed when standby dbHome/dbSystem is terminated. Only `true` is supported at this time. If you change an argument that is used during the delete operation you must run `pulumi up` first so that that the change in the value is registered in the statefile before running `terraform destroy`. `terraform destroy` only looks at what is currently on the statefile and ignores the terraform configuration files. */ deleteStandbyDbHomeOnDelete: pulumi.Input; /** * The user-friendly name of the DB system that will contain the the standby database. The display name does not have to be unique. */ displayName?: pulumi.Input; /** * A domain name used for the DB system. If the Oracle-provided Internet and VCN Resolver is enabled for the specified subnet, the domain name for the subnet is used (do not provide one). Otherwise, provide a valid DNS domain name. Hyphens (-) are not permitted. */ domain?: pulumi.Input; /** * A Fault Domain is a grouping of hardware and infrastructure within an availability domain. Fault Domains let you distribute your instances so that they are not on the same physical hardware within a single availability domain. A hardware failure or maintenance that affects one Fault Domain does not affect DB systems in other Fault Domains. * * If you do not specify the Fault Domain, the system selects one for you. To change the Fault Domain for a DB system, terminate it and launch a new DB system in the preferred Fault Domain. * * If the node count is greater than 1, you can specify which Fault Domains these nodes will be distributed into. The system assigns your nodes automatically to the Fault Domains you specify so that no Fault Domain contains more than one node. * * To get a list of Fault Domains, use the [ListFaultDomains](https://docs.cloud.oracle.com/iaas/api/#/en/identity/latest/FaultDomain/ListFaultDomains) operation in the Identity and Access Management Service API. * * Example: `FAULT-DOMAIN-1` */ faultDomains?: pulumi.Input[] | undefined>; /** * The hostname for the DB node. */ hostname?: pulumi.Input; /** * (Updatable) True if active Data Guard is enabled. */ isActiveDataGuardEnabled?: pulumi.Input; /** * The Oracle license model that applies to all the databases on the dataguard standby DB system. The default is LICENSE_INCLUDED. Bring your own license (BYOL) allows you to select the DB edition using the optional parameter, for Autonomous AI Database Serverless. */ licenseModel?: pulumi.Input; /** * (Updatable) An optional property when incremented triggers Migrate. Could be set to any integer value. * * ** 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 */ migrateTrigger?: pulumi.Input; /** * The number of nodes to launch for the DB system of the standby in the Data Guard association. For a 2-node RAC virtual machine DB system, specify either 1 or 2. If you do not supply this parameter, the default is the node count of the primary DB system. */ nodeCount?: pulumi.Input; /** * The list of [OCIDs](https://docs.cloud.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.cloud.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?: pulumi.Input[] | undefined>; /** * The [OCID](https://docs.cloud.oracle.com/iaas/Content/General/Concepts/identifiers.htm) of the DB home in which to create the standby database. You must supply this value to create standby database with an existing DB home */ peerDbHomeId?: pulumi.Input; /** * The [OCID](https://docs.cloud.oracle.com/iaas/Content/General/Concepts/identifiers.htm) of the DB system in which to create the standby database. You must supply this value if creationType is `ExistingDbSystem`. */ peerDbSystemId?: pulumi.Input; /** * Specifies the `DB_UNIQUE_NAME` of the peer database to be created. */ peerDbUniqueName?: pulumi.Input; /** * Specifies a prefix for the `Oracle SID` of the database to be created. */ peerSidPrefix?: pulumi.Input; /** * The [OCID](https://docs.cloud.oracle.com/iaas/Content/General/Concepts/identifiers.htm) of the VM Cluster in which to create the standby database. You must supply this value if creationType is `ExistingVmCluster`. */ peerVmClusterId?: pulumi.Input; /** * The IPv4 address from the provided Oracle Cloud Infrastructure subnet which needs to be assigned to the VNIC. If not provided, it will be auto-assigned with an available IPv4 address from the subnet. */ privateIp?: pulumi.Input; /** * The IPv6 address from the provided Oracle Cloud Infrastructure subnet which needs to be assigned to the VNIC. If not provided, it will be auto-assigned with an available IPv6 address from the subnet. */ privateIpV6?: pulumi.Input; /** * (Updatable) The protection mode to set up between the primary and standby databases. For more information, see [Oracle Data Guard Protection Modes](http://docs.oracle.com/database/122/SBYDB/oracle-data-guard-protection-modes.htm#SBYDB02000) in the Oracle Data Guard documentation. * * **IMPORTANT** - The only protection mode currently supported by the Database service is MAXIMUM_PERFORMANCE. */ protectionMode: pulumi.Input; /** * The virtual machine DB system shape to launch for the standby database in the Data Guard association. The shape determines the number of CPU cores and the amount of memory available for the DB system. Only virtual machine shapes are valid options. If you do not supply this parameter, the default shape is the shape of the primary DB system. * * To get a list of all shapes, use the [ListDbSystemShapes](https://docs.cloud.oracle.com/iaas/api/#/en/database/latest/DbSystemShapeSummary/ListDbSystemShapes) operation. */ shape?: pulumi.Input; /** * The block storage volume performance level. Valid values are `BALANCED` and `HIGH_PERFORMANCE`. See [Block Volume Performance](https://docs.cloud.oracle.com/iaas/Content/Block/Concepts/blockvolumeperformance.htm) for more information. */ storageVolumePerformanceMode?: pulumi.Input; /** * The OCID of the subnet the DB system is associated with. **Subnet Restrictions:** * * For 1- and 2-node RAC DB systems, do not use a subnet that overlaps with 192.168.16.16/28 * * 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?: pulumi.Input; subscriptionId?: pulumi.Input; /** * The time zone of the dataguard standby DB system. For details, see [DB System Time Zones](https://docs.cloud.oracle.com/iaas/Content/Database/References/timezones.htm). */ timeZone?: pulumi.Input; /** * (Updatable) The redo transport type to use for this Data Guard association. Valid values depend on the specified `protectionMode`: * * MAXIMUM_AVAILABILITY - SYNC or FASTSYNC * * MAXIMUM_PERFORMANCE - ASYNC * * MAXIMUM_PROTECTION - SYNC * * For more information, see [Redo Transport Services](http://docs.oracle.com/database/122/SBYDB/oracle-data-guard-redo-transport-services.htm#SBYDB00400) in the Oracle Data Guard documentation. * * **IMPORTANT** - The only transport type currently supported by the Database service is ASYNC. */ transportType: pulumi.Input; } //# sourceMappingURL=dataGuardAssociation.d.ts.map