DbInstanceArgs

data class DbInstanceArgs(val allocatedStorage: Output<String>? = null, val allowMajorVersionUpgrade: Output<Boolean>? = null, val associatedRoles: Output<List<DbInstanceDbInstanceRoleArgs>>? = null, val autoMinorVersionUpgrade: Output<Boolean>? = null, val automaticBackupReplicationRegion: Output<String>? = null, val availabilityZone: Output<String>? = null, val backupRetentionPeriod: Output<Int>? = null, val caCertificateIdentifier: Output<String>? = null, val certificateDetails: Output<DbInstanceCertificateDetailsArgs>? = null, val certificateRotationRestart: Output<Boolean>? = null, val characterSetName: Output<String>? = null, val copyTagsToSnapshot: Output<Boolean>? = null, val customIamInstanceProfile: Output<String>? = null, val dbClusterIdentifier: Output<String>? = null, val dbClusterSnapshotIdentifier: Output<String>? = null, val dbInstanceClass: Output<String>? = null, val dbInstanceIdentifier: Output<String>? = null, val dbName: Output<String>? = null, val dbParameterGroupName: Output<String>? = null, val dbSecurityGroups: Output<List<String>>? = null, val dbSnapshotIdentifier: Output<String>? = null, val dbSubnetGroupName: Output<String>? = null, val deleteAutomatedBackups: Output<Boolean>? = null, val deletionProtection: Output<Boolean>? = null, val domain: Output<String>? = null, val domainAuthSecretArn: Output<String>? = null, val domainDnsIps: Output<List<String>>? = null, val domainFqdn: Output<String>? = null, val domainIamRoleName: Output<String>? = null, val domainOu: Output<String>? = null, val enableCloudwatchLogsExports: Output<List<String>>? = null, val enableIamDatabaseAuthentication: Output<Boolean>? = null, val enablePerformanceInsights: Output<Boolean>? = null, val endpoint: Output<DbInstanceEndpointArgs>? = null, val engine: Output<String>? = null, val engineVersion: Output<String>? = null, val iops: Output<Int>? = null, val kmsKeyId: Output<String>? = null, val licenseModel: Output<String>? = null, val manageMasterUserPassword: Output<Boolean>? = null, val masterUserPassword: Output<String>? = null, val masterUserSecret: Output<DbInstanceMasterUserSecretArgs>? = null, val masterUsername: Output<String>? = null, val maxAllocatedStorage: Output<Int>? = null, val monitoringInterval: Output<Int>? = null, val monitoringRoleArn: Output<String>? = null, val multiAz: Output<Boolean>? = null, val ncharCharacterSetName: Output<String>? = null, val networkType: Output<String>? = null, val optionGroupName: Output<String>? = null, val performanceInsightsKmsKeyId: Output<String>? = null, val performanceInsightsRetentionPeriod: Output<Int>? = null, val port: Output<String>? = null, val preferredBackupWindow: Output<String>? = null, val preferredMaintenanceWindow: Output<String>? = null, val processorFeatures: Output<List<DbInstanceProcessorFeatureArgs>>? = null, val promotionTier: Output<Int>? = null, val publiclyAccessible: Output<Boolean>? = null, val replicaMode: Output<String>? = null, val restoreTime: Output<String>? = null, val sourceDbClusterIdentifier: Output<String>? = null, val sourceDbInstanceAutomatedBackupsArn: Output<String>? = null, val sourceDbInstanceIdentifier: Output<String>? = null, val sourceDbiResourceId: Output<String>? = null, val sourceRegion: Output<String>? = null, val storageEncrypted: Output<Boolean>? = null, val storageThroughput: Output<Int>? = null, val storageType: Output<String>? = null, val tags: Output<List<DbInstanceTagArgs>>? = null, val tdeCredentialArn: Output<String>? = null, val tdeCredentialPassword: Output<String>? = null, val timezone: Output<String>? = null, val useDefaultProcessorFeatures: Output<Boolean>? = null, val useLatestRestorableTime: Output<Boolean>? = null, val vpcSecurityGroups: Output<List<String>>? = null) : ConvertibleToJava<DbInstanceArgs>

The AWS::RDS::DBInstance resource creates an Amazon RDS DB instance.

Constructors

Link copied to clipboard
fun DbInstanceArgs(allocatedStorage: Output<String>? = null, allowMajorVersionUpgrade: Output<Boolean>? = null, associatedRoles: Output<List<DbInstanceDbInstanceRoleArgs>>? = null, autoMinorVersionUpgrade: Output<Boolean>? = null, automaticBackupReplicationRegion: Output<String>? = null, availabilityZone: Output<String>? = null, backupRetentionPeriod: Output<Int>? = null, caCertificateIdentifier: Output<String>? = null, certificateDetails: Output<DbInstanceCertificateDetailsArgs>? = null, certificateRotationRestart: Output<Boolean>? = null, characterSetName: Output<String>? = null, copyTagsToSnapshot: Output<Boolean>? = null, customIamInstanceProfile: Output<String>? = null, dbClusterIdentifier: Output<String>? = null, dbClusterSnapshotIdentifier: Output<String>? = null, dbInstanceClass: Output<String>? = null, dbInstanceIdentifier: Output<String>? = null, dbName: Output<String>? = null, dbParameterGroupName: Output<String>? = null, dbSecurityGroups: Output<List<String>>? = null, dbSnapshotIdentifier: Output<String>? = null, dbSubnetGroupName: Output<String>? = null, deleteAutomatedBackups: Output<Boolean>? = null, deletionProtection: Output<Boolean>? = null, domain: Output<String>? = null, domainAuthSecretArn: Output<String>? = null, domainDnsIps: Output<List<String>>? = null, domainFqdn: Output<String>? = null, domainIamRoleName: Output<String>? = null, domainOu: Output<String>? = null, enableCloudwatchLogsExports: Output<List<String>>? = null, enableIamDatabaseAuthentication: Output<Boolean>? = null, enablePerformanceInsights: Output<Boolean>? = null, endpoint: Output<DbInstanceEndpointArgs>? = null, engine: Output<String>? = null, engineVersion: Output<String>? = null, iops: Output<Int>? = null, kmsKeyId: Output<String>? = null, licenseModel: Output<String>? = null, manageMasterUserPassword: Output<Boolean>? = null, masterUserPassword: Output<String>? = null, masterUserSecret: Output<DbInstanceMasterUserSecretArgs>? = null, masterUsername: Output<String>? = null, maxAllocatedStorage: Output<Int>? = null, monitoringInterval: Output<Int>? = null, monitoringRoleArn: Output<String>? = null, multiAz: Output<Boolean>? = null, ncharCharacterSetName: Output<String>? = null, networkType: Output<String>? = null, optionGroupName: Output<String>? = null, performanceInsightsKmsKeyId: Output<String>? = null, performanceInsightsRetentionPeriod: Output<Int>? = null, port: Output<String>? = null, preferredBackupWindow: Output<String>? = null, preferredMaintenanceWindow: Output<String>? = null, processorFeatures: Output<List<DbInstanceProcessorFeatureArgs>>? = null, promotionTier: Output<Int>? = null, publiclyAccessible: Output<Boolean>? = null, replicaMode: Output<String>? = null, restoreTime: Output<String>? = null, sourceDbClusterIdentifier: Output<String>? = null, sourceDbInstanceAutomatedBackupsArn: Output<String>? = null, sourceDbInstanceIdentifier: Output<String>? = null, sourceDbiResourceId: Output<String>? = null, sourceRegion: Output<String>? = null, storageEncrypted: Output<Boolean>? = null, storageThroughput: Output<Int>? = null, storageType: Output<String>? = null, tags: Output<List<DbInstanceTagArgs>>? = null, tdeCredentialArn: Output<String>? = null, tdeCredentialPassword: Output<String>? = null, timezone: Output<String>? = null, useDefaultProcessorFeatures: Output<Boolean>? = null, useLatestRestorableTime: Output<Boolean>? = null, vpcSecurityGroups: Output<List<String>>? = null)

Functions

Link copied to clipboard
open override fun toJava(): DbInstanceArgs

Properties

Link copied to clipboard
val allocatedStorage: Output<String>? = null

The amount of storage (in gigabytes) to be initially allocated for the database instance.

Link copied to clipboard
val allowMajorVersionUpgrade: Output<Boolean>? = null

A value that indicates whether major version upgrades are allowed. Changing this parameter doesn't result in an outage and the change is asynchronously applied as soon as possible.

Link copied to clipboard

The AWS Identity and Access Management (IAM) roles associated with the DB instance.

Link copied to clipboard

Enables replication of automated backups to a different Amazon Web Services Region.

Link copied to clipboard
val autoMinorVersionUpgrade: Output<Boolean>? = null

A value that indicates whether minor engine upgrades are applied automatically to the DB instance during the maintenance window. By default, minor engine upgrades are applied automatically.

Link copied to clipboard
val availabilityZone: Output<String>? = null

The Availability Zone (AZ) where the database will be created. For information on AWS Regions and Availability Zones.

Link copied to clipboard
val backupRetentionPeriod: Output<Int>? = null

The number of days for which automated backups are retained. Setting this parameter to a positive number enables backups. Setting this parameter to 0 disables automated backups.

Link copied to clipboard
val caCertificateIdentifier: Output<String>? = null

The identifier of the CA certificate for this DB instance.

Link copied to clipboard

Returns the details of the DB instance's server certificate.

Link copied to clipboard
val certificateRotationRestart: Output<Boolean>? = null

A value that indicates whether the DB instance is restarted when you rotate your SSL/TLS certificate. By default, the DB instance is restarted when you rotate your SSL/TLS certificate. The certificate is not updated until the DB instance is restarted. If you are using SSL/TLS to connect to the DB instance, follow the appropriate instructions for your DB engine to rotate your SSL/TLS certificate This setting doesn't apply to RDS Custom.

Link copied to clipboard
val characterSetName: Output<String>? = null

For supported engines, indicates that the DB instance should be associated with the specified character set.

Link copied to clipboard
val copyTagsToSnapshot: Output<Boolean>? = null

A value that indicates whether to copy tags from the DB instance to snapshots of the DB instance. By default, tags are not copied.

Link copied to clipboard
val customIamInstanceProfile: Output<String>? = null

The instance profile associated with the underlying Amazon EC2 instance of an RDS Custom DB instance. The instance profile must meet the following requirements:

Link copied to clipboard
val dbClusterIdentifier: Output<String>? = null

The identifier of the DB cluster that the instance will belong to.

Link copied to clipboard
val dbClusterSnapshotIdentifier: Output<String>? = null

The identifier for the RDS for MySQL Multi-AZ DB cluster snapshot to restore from. For more information on Multi-AZ DB clusters, see Multi-AZ deployments with two readable standby DB instances in the Amazon RDS User Guide . Constraints:

Link copied to clipboard
val dbInstanceClass: Output<String>? = null

The compute and memory capacity of the DB instance, for example, db.m4.large. Not all DB instance classes are available in all AWS Regions, or for all database engines.

Link copied to clipboard
val dbInstanceIdentifier: Output<String>? = null

A name for the DB instance. If you specify a name, AWS CloudFormation converts it to lowercase. If you don't specify a name, AWS CloudFormation generates a unique physical ID and uses that ID for the DB instance.

Link copied to clipboard
val dbName: Output<String>? = null

The meaning of this parameter differs according to the database engine you use.

Link copied to clipboard
val dbParameterGroupName: Output<String>? = null

The name of an existing DB parameter group or a reference to an AWS::RDS::DBParameterGroup resource created in the template.

Link copied to clipboard
val dbSecurityGroups: Output<List<String>>? = null

A list of the DB security groups to assign to the DB instance. The list can include both the name of existing DB security groups or references to AWS::RDS::DBSecurityGroup resources created in the template.

Link copied to clipboard
val dbSnapshotIdentifier: Output<String>? = null

The name or Amazon Resource Name (ARN) of the DB snapshot that's used to restore the DB instance. If you're restoring from a shared manual DB snapshot, you must specify the ARN of the snapshot.

Link copied to clipboard
val dbSubnetGroupName: Output<String>? = null

A DB subnet group to associate with the DB instance. If you update this value, the new subnet group must be a subnet group in a new VPC.

Link copied to clipboard
val deleteAutomatedBackups: Output<Boolean>? = null

A value that indicates whether to remove automated backups immediately after the DB instance is deleted. This parameter isn't case-sensitive. The default is to remove automated backups immediately after the DB instance is deleted.

Link copied to clipboard
val deletionProtection: Output<Boolean>? = null

A value that indicates whether the DB instance has deletion protection enabled. The database can't be deleted when deletion protection is enabled. By default, deletion protection is disabled.

Link copied to clipboard
val domain: Output<String>? = null

The Active Directory directory ID to create the DB instance in. Currently, only MySQL, Microsoft SQL Server, Oracle, and PostgreSQL DB instances can be created in an Active Directory Domain.

Link copied to clipboard
val domainAuthSecretArn: Output<String>? = null

The ARN for the Secrets Manager secret with the credentials for the user joining the domain.

Link copied to clipboard
val domainDnsIps: Output<List<String>>? = null

The IPv4 DNS IP addresses of your primary and secondary Active Directory domain controllers.

Link copied to clipboard
val domainFqdn: Output<String>? = null

The fully qualified domain name (FQDN) of an Active Directory domain.

Link copied to clipboard
val domainIamRoleName: Output<String>? = null

Specify the name of the IAM role to be used when making API calls to the Directory Service.

Link copied to clipboard
val domainOu: Output<String>? = null

The Active Directory organizational unit for your DB instance to join.

Link copied to clipboard

The list of log types that need to be enabled for exporting to CloudWatch Logs. The values in the list depend on the DB engine being used.

Link copied to clipboard

A value that indicates whether to enable mapping of AWS Identity and Access Management (IAM) accounts to database accounts. By default, mapping is disabled.

Link copied to clipboard
val enablePerformanceInsights: Output<Boolean>? = null

A value that indicates whether to enable Performance Insights for the DB instance.

Link copied to clipboard
val endpoint: Output<DbInstanceEndpointArgs>? = null

Specifies the connection endpoint.

Link copied to clipboard
val engine: Output<String>? = null

The name of the database engine that you want to use for this DB instance.

Link copied to clipboard
val engineVersion: Output<String>? = null

The version number of the database engine to use.

Link copied to clipboard
val iops: Output<Int>? = null

The number of I/O operations per second (IOPS) that the database provisions.

Link copied to clipboard
val kmsKeyId: Output<String>? = null

The ARN of the AWS Key Management Service (AWS KMS) master key that's used to encrypt the DB instance.

Link copied to clipboard
val licenseModel: Output<String>? = null

License model information for this DB instance.

Link copied to clipboard
val manageMasterUserPassword: Output<Boolean>? = null

A value that indicates whether to manage the master user password with AWS Secrets Manager.

Link copied to clipboard
val masterUsername: Output<String>? = null

The master user name for the DB instance.

Link copied to clipboard
val masterUserPassword: Output<String>? = null

The password for the master user.

Link copied to clipboard

Contains the secret managed by RDS in AWS Secrets Manager for the master user password.

Link copied to clipboard
val maxAllocatedStorage: Output<Int>? = null

The upper limit to which Amazon RDS can automatically scale the storage of the DB instance.

Link copied to clipboard
val monitoringInterval: Output<Int>? = null

The interval, in seconds, between points when Enhanced Monitoring metrics are collected for the DB instance. To disable collecting Enhanced Monitoring metrics, specify 0. The default is 0.

Link copied to clipboard
val monitoringRoleArn: Output<String>? = null

The ARN for the IAM role that permits RDS to send enhanced monitoring metrics to Amazon CloudWatch Logs.

Link copied to clipboard
val multiAz: Output<Boolean>? = null

Specifies whether the database instance is a multiple Availability Zone deployment.

Link copied to clipboard
val ncharCharacterSetName: Output<String>? = null

The name of the NCHAR character set for the Oracle DB instance. This parameter doesn't apply to RDS Custom.

Link copied to clipboard
val networkType: Output<String>? = null

The network type of the DB cluster.

Link copied to clipboard
val optionGroupName: Output<String>? = null

Indicates that the DB instance should be associated with the specified option group.

Link copied to clipboard
val performanceInsightsKmsKeyId: Output<String>? = null

The AWS KMS key identifier for encryption of Performance Insights data. The KMS key ID is the Amazon Resource Name (ARN), KMS key identifier, or the KMS key alias for the KMS encryption key.

Link copied to clipboard

The amount of time, in days, to retain Performance Insights data. Valid values are 7 or 731 (2 years).

Link copied to clipboard
val port: Output<String>? = null

The port number on which the database accepts connections.

Link copied to clipboard
val preferredBackupWindow: Output<String>? = null

The daily time range during which automated backups are created if automated backups are enabled, using the BackupRetentionPeriod parameter.

Link copied to clipboard
val preferredMaintenanceWindow: Output<String>? = null

he weekly time range during which system maintenance can occur, in Universal Coordinated Time (UTC).

Link copied to clipboard

The number of CPU cores and the number of threads per core for the DB instance class of the DB instance.

Link copied to clipboard
val promotionTier: Output<Int>? = null

A value that specifies the order in which an Aurora Replica is promoted to the primary instance after a failure of the existing primary instance.

Link copied to clipboard
val publiclyAccessible: Output<Boolean>? = null

Indicates whether the DB instance is an internet-facing instance. If you specify true, AWS CloudFormation creates an instance with a publicly resolvable DNS name, which resolves to a public IP address. If you specify false, AWS CloudFormation creates an internal instance with a DNS name that resolves to a private IP address.

Link copied to clipboard
val replicaMode: Output<String>? = null

The open mode of an Oracle read replica. The default is open-read-only.

Link copied to clipboard
val restoreTime: Output<String>? = null

The date and time to restore from.

Link copied to clipboard
val sourceDbClusterIdentifier: Output<String>? = null

The identifier of the Multi-AZ DB cluster that will act as the source for the read replica. Each DB cluster can have up to 15 read replicas.

Link copied to clipboard

The Amazon Resource Name (ARN) of the replicated automated backups from which to restore.

Link copied to clipboard
val sourceDbInstanceIdentifier: Output<String>? = null

If you want to create a Read Replica DB instance, specify the ID of the source DB instance. Each DB instance can have a limited number of Read Replicas.

Link copied to clipboard
val sourceDbiResourceId: Output<String>? = null

The resource ID of the source DB instance from which to restore.

Link copied to clipboard
val sourceRegion: Output<String>? = null

The ID of the region that contains the source DB instance for the Read Replica.

Link copied to clipboard
val storageEncrypted: Output<Boolean>? = null

A value that indicates whether the DB instance is encrypted. By default, it isn't encrypted.

Link copied to clipboard
val storageThroughput: Output<Int>? = null

Specifies the storage throughput for the DB instance.

Link copied to clipboard
val storageType: Output<String>? = null

Specifies the storage type to be associated with the DB instance.

Link copied to clipboard
val tags: Output<List<DbInstanceTagArgs>>? = null

Tags to assign to the DB instance.

Link copied to clipboard
val tdeCredentialArn: Output<String>? = null

The ARN from the key store with which to associate the instance for TDE encryption.

Link copied to clipboard
val tdeCredentialPassword: Output<String>? = null

The password for the given ARN from the key store in order to access the device.

Link copied to clipboard
val timezone: Output<String>? = null

The time zone of the DB instance. The time zone parameter is currently supported only by Microsoft SQL Server.

Link copied to clipboard

A value that indicates whether the DB instance class of the DB instance uses its default processor features.

Link copied to clipboard
val useLatestRestorableTime: Output<Boolean>? = null

A value that indicates whether the DB instance is restored from the latest backup time. By default, the DB instance isn't restored from the latest backup time.

Link copied to clipboard
val vpcSecurityGroups: Output<List<String>>? = null

A list of the VPC security group IDs to assign to the DB instance. The list can include both the physical IDs of existing VPC security groups and references to AWS::EC2::SecurityGroup resources created in the template.