github.com/ezbercih/terraform@v0.1.1-0.20140729011846-3c33865e0839/website/source/docs/providers/aws/r/db_instance.html.markdown (about) 1 --- 2 layout: "aws" 3 page_title: "AWS: aws_db_instance" 4 sidebar_current: "docs-aws-resource-db-instance" 5 --- 6 7 # aws\_db\_instance 8 9 Provides an RDS instance resource. 10 11 ## Example Usage 12 13 ``` 14 resource "aws_db_instance" "default" { 15 identifier = "mydb-rds" 16 allocated_storage = 10 17 engine = "mysql" 18 engine_version = "5.6.17" 19 instance_class = "db.t1.micro" 20 name = "mydb" 21 username = "foo" 22 password = "bar" 23 security_group_names = ["${aws_db_security_group.bar.name}"] 24 } 25 ``` 26 27 ## Argument Reference 28 29 The following arguments are supported: 30 31 * `allocated_storage` - (Required) The allocated storage in gigabytes. 32 * `engine` - (Required) The database engine to use. 33 * `engine_version` - (Required) The engine version to use. 34 * `identifier` - (Required) The name of the RDS instance 35 * `instance_class` - (Required) The instance type of the RDS instance. 36 * `name` - (Required) The DB name to create. 37 * `password` - (Required) Password for the master DB user. 38 * `username` - (Required) Username for the master DB user. 39 * `availability_zone` - (Optional) The AZ for the RDS instance. 40 * `backup_retention_period` - (Optional) The days to retain backups for. 41 * `backup_window` - (Optional) The backup window. 42 * `iops` - (Optional) The amount of provisioned IOPS 43 * `maintenance_window` - (Optional) The window to perform maintanence in. 44 * `multi_az` - (Optional) Specifies if the RDS instance is multi-AZ 45 * `port` - (Optional) The port on which the DB accepts connetions. 46 * `publicly_accessible` - (Optional) Bool to control if instance is publically accessible. 47 * `vpc_security_group_ids` - (Optional) List of VPC security groups to associate. 48 * `skip_final_snapshot` - (Optional) Enables skipping the final snapshot on deletion. 49 * `security_group_names` - (Optional) List of DB Security Groups to associate. 50 51 ## Attributes Reference 52 53 The following attributes are exported: 54 55 * `id` - The RDS instance ID. 56 * `address` - The address of the RDS instance. 57 * `allocated_storage` - The amount of allocated storage 58 * `availability_zone` - The availability zone of the instance 59 * `backup_retention_period` - The backup retention period 60 * `backup_window` - The backup window 61 * `endpoint` - The connection endpoint 62 * `engine` - The database engine 63 * `engine_version` - The database engine version 64 * `instance_class`- The RDS instance class 65 * `maintenance_window` - The instance maintenance window 66 * `multi_az` - If the RDS instance is multi AZ enabled 67 * `name` - The database name 68 * `port` - The database port 69 * `status` - The RDS instance status 70 * `username` - The master username for the database 71