Skip to content

aetion/terraform-community-aws-rds

 
 

Repository files navigation

Variables

NameDescriptionTypeDefault Required
allocated_storage The allocated storage in gigabytes

string

n/a

yes
allow_major_version_upgrade Indicates that major version upgrades are allowed. Changing this parameter does not result in an outage and the change is asynchronously applied as soon as possible

bool

false

no
apply_immediately Specifies whether any database modifications are applied immediately, or during the next maintenance window

bool

false

no
auto_minor_version_upgrade Indicates that minor engine upgrades will be applied automatically to the DB instance during the maintenance window

bool

true

no
availability_zone The Availability Zone of the RDS instance

string

""

no
backup_retention_period The days to retain backups for

number

1

no
backup_window The daily time range (in UTC) during which automated backups are created if they are enabled. Example: '09:46-10:16'. Must not overlap with maintenance_window

string

n/a

yes
character_set_name (Optional) The character set name to use for DB encoding in Oracle instances. This can't be changed. See Oracle Character Sets Supported in Amazon RDS for more information

string

""

no
copy_tags_to_snapshot On delete, copy all Instance tags to the final snapshot (if final_snapshot_identifier is specified)

bool

false

no
create_db_instance Whether to create a database instance

bool

true

no
create_db_option_group Whether to create a database option group

bool

true

no
create_db_parameter_group Whether to create a database parameter group

bool

true

no
create_db_subnet_group Whether to create a database subnet group

bool

true

no
create_monitoring_role Create IAM role with a defined name that permits RDS to send enhanced monitoring metrics to CloudWatch Logs.

bool

false

no
db_depends_on Hack to add a depends on a module

any

n/a

yes
db_subnet_group_name Name of DB subnet group. DB instance will be created in the VPC associated with the DB subnet group. If unspecified, will be created in the default VPC

string

""

no
deletion_protection The database can't be deleted when this value is set to true.

bool

false

no
enabled_cloudwatch_logs_exports List of log types to enable for exporting to CloudWatch logs. If omitted, no logs will be exported. Valid values (depending on engine): alert, audit, error, general, listener, slowquery, trace, postgresql (PostgreSQL), upgrade (PostgreSQL).

list(string)

[]

no
engine The database engine to use

string

n/a

yes
engine_version The engine version to use

string

n/a

yes
family The family of the DB parameter group

string

""

no
final_snapshot_identifier The name of your final DB snapshot when this DB instance is deleted.

string

n/a

yes
iam_database_authentication_enabled Specifies whether or mappings of AWS Identity and Access Management (IAM) accounts to database accounts is enabled

bool

false

no
identifier The name of the RDS instance, if omitted, Terraform will assign a random, unique identifier

string

n/a

yes
instance_class The instance type of the RDS instance

string

n/a

yes
iops The amount of provisioned IOPS. Setting this implies a storage_type of 'io1'

number

0

no
kms_key_id The ARN for the KMS encryption key. If creating an encrypted replica, set this to the destination KMS ARN. If storage_encrypted is set to true and kms_key_id is not specified the default KMS key created in your account will be used

string

""

no
license_model License model information for this DB instance. Optional, but required for some DB engines, i.e. Oracle SE1

string

""

no
maintenance_window The window to perform maintenance in. Syntax: 'ddd:hh24:mi-ddd:hh24:mi'. Eg: 'Mon:00:00-Mon:03:00'

string

n/a

yes
major_engine_version Specifies the major version of the engine that this option group should be associated with

string

""

no
max_allocated_storage Specifies the value for Storage Autoscaling

number

0

no
monitoring_interval 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. Valid Values: 0, 1, 5, 10, 15, 30, 60.

number

0

no
monitoring_role_arn The ARN for the IAM role that permits RDS to send enhanced monitoring metrics to CloudWatch Logs. Must be specified if monitoring_interval is non-zero.

string

""

no
monitoring_role_name Name of the IAM role which will be created when create_monitoring_role is enabled.

string

"rds-monitoring-role"

no
multi_az Specifies if the RDS instance is multi-AZ

bool

false

no
name The DB name to create. If omitted, no database is created initially

string

""

no
option_group_description The description of the option group

string

""

no
option_group_name Name of the DB option group to associate. Setting this automatically disables option_group creation

string

""

no
options A list of Options to apply.

any

[]

no
parameter_group_description Description of the DB parameter group to create

string

""

no
parameter_group_name Name of the DB parameter group to associate or create

string

""

no
parameters A list of DB parameters (map) to apply

list(map(string))

[]

no
password Password for the master DB user. Note that this may show up in logs, and it will be stored in the state file

string

n/a

yes
performance_insights_enabled Specifies whether Performance Insights are enabled

bool

false

no
performance_insights_retention_period The amount of time in days to retain Performance Insights data. Either 7 (7 days) or 731 (2 years).

number

7

no
port The port on which the DB accepts connections

string

n/a

yes
publicly_accessible Bool to control if instance is publicly accessible

bool

false

no
replicate_source_db Specifies that this resource is a Replicate database, and to use this value as the source database. This correlates to the identifier of another Amazon RDS Database to replicate.

string

""

no
skip_final_snapshot Determines whether a final DB snapshot is created before the DB instance is deleted. If true is specified, no DBSnapshot is created. If false is specified, a DB snapshot is created before the DB instance is deleted, using the value from final_snapshot_identifier

bool

true

no
snapshot_identifier Specifies whether or not to create this database from a snapshot. This correlates to the snapshot ID you'd find in the RDS console, e.g: rds:production-2015-06-26-06-05.

string

""

no
storage_encrypted Specifies whether the DB instance is encrypted

bool

false

no
storage_type One of 'standard' (magnetic), 'gp2' (general purpose SSD), or 'io1' (provisioned IOPS SSD). The default is 'io1' if iops is specified, 'standard' if not. Note that this behaviour is different from the AWS web console, where the default is 'gp2'.

string

"gp2"

no
subnet_ids A list of VPC subnet IDs

list(string)

[]

no
tags A mapping of tags to assign to all resources

map(string)

{}

no
timeouts (Optional) Updated Terraform resource management timeouts. Applies to `aws_db_instance` in particular to permit resource management times

map(string)

{
  "create": "40m",
  "delete": "40m",
  "update": "80m"
}
no
timezone (Optional) Time zone of the DB instance. timezone is currently only supported by Microsoft SQL Server. The timezone can only be set on creation. See MSSQL User Guide for more information.

string

""

no
use_parameter_group_name_prefix Whether to use the parameter group name prefix or not

bool

true

no
username Username for the master DB user

string

n/a

yes
vpc_security_group_ids List of VPC security groups to associate

list(string)

[]

no

Outputs

Name Description
this_db_instance_address The address of the RDS instance
this_db_instance_arn The ARN of the RDS instance
this_db_instance_availability_zone The availability zone of the RDS instance
this_db_instance_endpoint The connection endpoint
this_db_instance_hosted_zone_id The canonical hosted zone ID of the DB instance (to be used in a Route 53 Alias record)
this_db_instance_id The RDS instance ID
this_db_instance_name The database name
this_db_instance_password The database password (this password may be old, because Terraform doesn't track it after initial creation)
this_db_instance_port The database port
this_db_instance_resource_id The RDS Resource ID of this instance
this_db_instance_status The RDS instance status
this_db_instance_username The master username for the database
this_db_option_group_arn The ARN of the db option group
this_db_option_group_id The db option group id
this_db_parameter_group_arn The ARN of the db parameter group
this_db_parameter_group_id The db parameter group id
this_db_subnet_group_arn The ARN of the db subnet group
this_db_subnet_group_id The db subnet group name