Menu
Amazon Relational Database Service
User Guide (API Version 2014-10-31)

Creating a DB Instance Running the MySQL Database Engine

The basic building block of Amazon RDS is the DB instance. The DB instance is where you create your MySQL databases.

Important

You must complete the tasks in the Setting Up for Amazon RDS section before you can create or connect to a DB instance.

For an example that walks you through the process of creating and connecting to a sample DB instance, see Creating a MySQL DB Instance and Connecting to a Database on a MySQL DB Instance.

AWS Management Console

To launch a MySQL DB instance

  1. Sign in to the AWS Management Console and open the Amazon RDS console at https://console.aws.amazon.com/rds/.

  2. In the top right corner of the AWS Management Console, choose the region in which you want to create the DB instance.

  3. In the navigation pane, choose Instances.

  4. Choose Launch DB Instance to start the Launch DB Instance Wizard.

    The wizard opens on the Select Engine page.

    
						Select Engine
  5. In the Select Engine window, click the Select button for the MySQL DB engine.

  6. The Production? step asks if you are planning to use the DB instance you are creating for production. If you are, choose Yes. If you choose Yes, the failover option Multi-AZ and the Provisioned IOPS storage option are preselected in the following step. We recommend these features for any production environment.

  7. Choose Next to continue. The Specify DB Details page appears.

    On the Specify DB Details page, specify your DB instance information. For information about each setting, see Settings for MySQL DB Instances.

    
						Specify DB Details
  8. Choose Next to continue. The Configure Advanced Settings page appears.

    On the Configure Advanced Settings page, provide additional information that Amazon RDS needs to launch the DB instance. For information about each setting, see Settings for MySQL DB Instances.

    
						Configure Advanced Settings
  9. Choose Launch DB Instance.

  10. On the final page of the wizard, choose Close.

On the RDS console, the new DB instance appears in the list of DB instances. The DB instance has a status of creating until the DB instance is ready to use. When the state changes to available, you can connect to the DB instance. Depending on the DB instance class and the amount of storage, it can take up to 20 minutes before the new instance is available.


				My DB instances list

CLI

To create a MySQL DB instance by using the AWS CLI, call the create-db-instance command with the parameters below. For information about each setting, see Settings for MySQL DB Instances.

  • --db-instance-identifier

  • --db-instance-class

  • --db-security-groups

  • --db-subnet-group

  • --engine

  • --master-user-name

  • --master-user-password

  • --allocated-storage

  • --backup-retention-period

The following example creates a MySQL db instance named mydbinstance.

For Linux, OS X, or Unix:

aws rds create-db-instance \ --db-instance-identifier mydbinstance \ --db-instance-class db.m1.small \ --engine MySQL \ --allocated-storage 20 \ --master-username masterawsuser \ --master-user-password masteruserpassword \ --backup-retention-period 3

For Windows:

aws rds create-db-instance ^ --db-instance-identifier mydbinstance ^ --db-instance-class db.m3.medium ^ --engine MySQL ^ --allocated-storage 20 ^ --master-username masterawsuser ^ --master-user-password masteruserpassword ^ --backup-retention-period 3

This command should produce output similar to the following:

DBINSTANCE mydbinstance db.m3.medium mysql 20 sa creating 3 **** n 5.6.27 SECGROUP default active PARAMGRP default.mysql5.6 in-sync

API

To create a MySQL DB instance by using the Amazon RDS API, call the CreateDBInstance action with the parameters below. For information about each setting, see Settings for MySQL DB Instances.

  • AllocatedStorage

  • BackupRetentionPeriod

  • DBInstanceClass

  • DBInstanceIdentifier

  • DBSecurityGroups

  • DBSubnetGroup

  • Engine

  • MasterUsername

  • MasterUserPassword

The following example creates a MySQL db instance named mydbinstance.

https://rds.us-west-2.amazonaws.com/ ?Action=CreateDBInstance &AllocatedStorage=20 &BackupRetentionPeriod=3 &DBInstanceClass=db.m3.medium &DBInstanceIdentifier=mydbinstance &DBName=mydatabase &DBSecurityGroups.member.1=mysecuritygroup &DBSubnetGroup=mydbsubnetgroup &Engine=mysql &MasterUserPassword=masteruserpassword &MasterUsername=masterawsuser &Version=2014-10-31 &X-Amz-Algorithm=AWS4-HMAC-SHA256 &X-Amz-Credential=AKIADQKE4SARGYLE/20140213/us-west-2/rds/aws4_request &X-Amz-Date=20140213T162136Z &X-Amz-SignedHeaders=content-type;host;user-agent;x-amz-content-sha256;x-amz-date &X-Amz-Signature=8052a76dfb18469393c5f0182cdab0ebc224a9c7c5c949155376c1c250fc7ec3

Settings for MySQL DB Instances

The following table contains details about settings that you choose when you create a MySQL DB instance.

Setting Setting Description
Allocated Storage

The amount of storage to allocate for your DB instance (in gigabytes). In some cases, allocating a higher amount of storage for your DB instance than the size of your database can improve I/O performance.

For more information, see Storage for Amazon RDS.

Auto Minor Version Upgrade

Yes to enable your DB instance to receive minor DB engine version upgrades automatically when they become available.

Availability Zone

The availability zone for your DB instance. Use the default value of No Preference unless you want to specify an Availability Zone.

For more information, see Regions and Availability Zones.

Backup Retention Period

The number of days that you want automatic backups of your DB instance to be retained. For any non-trivial DB instance, you should set this value to 1 or greater.

For more information, see Working With Backups.

Backup Window

The time period during which Amazon RDS automatically takes a backup of your DB instance. Unless you have a specific time that you want to have your database backup, use the default of No Preference.

For more information, see Working With Backups.

Copy Tags To Snapshots

Select this option to copy any DB instance tags to a DB snapshot when you create a snapshot.

For more information, see Tagging Amazon RDS Resources.

Database Name

The name for the database on your DB instance. The name must contain 1 to 64 alpha-numeric characters. If you do not provide a name, Amazon RDS does not create a database on the DB instance you are creating.

To create additional databases on your DB instance, connect to your DB instance and use the SQL command CREATE DATABASE. For more information, see Connecting to a DB Instance Running the MySQL Database Engine.

Database Port

The port that you want to access the DB instance through. MySQL installations default to port 3306. If you use a DB security group with your DB instance, this must be the same port value you provided when creating the DB security group.

The firewalls at some companies block connections to the default MySQL port. If your company firewall blocks the default port, choose another port for your DB instance.

DB Engine Version

The version of MySQL that you want to use.

DB Instance Class

The configuration for your DB instance. For example, a db.m1.small instance class equates to 1.7 GB memory, 1 ECU (1 virtual core with 1 ECU), 64-bit platform, and moderate I/O capacity.

If possible, choose an instance class large enough that a typical query working set can be held in memory. When working sets are held in memory the system can avoid writing to disk, and this improves performance.

For more information, see DB Instance Class.

DB Instance Identifier

The name for your DB instance. Your DB instance identifier can contain up to 63 alphanumeric characters, and must be unique for your account in the region you chose. You can add some intelligence to the name, such as including the region you chose, for example mysql-instance1.

DB Parameter Group

A parameter group for your DB instance. You can choose the default parameter group or you can create a custom parameter group.

For more information, see Working with DB Parameter Groups.

Enable Encryption

Yes to enable encryption at rest for this DB instance.

For more information, see Encrypting Amazon RDS Resources.

Enable Enhanced Monitoring

Yes to gather metrics in real time for the operating system that your DB instance runs on.

For more information, see Enhanced Monitoring.

Enable IAM DB Authentication

Yes to enable IAM database authentication for this DB instance.

For more information, see IAM Database Authentication for MySQL and Amazon Aurora.

License Model

MySQL has only one license model, General-Public-License the general license agreement for MySQL.

Maintenance Window

The 30 minute window in which pending modifications to your DB instance are applied. If the time period doesn't matter, choose No Preference.

For more information, see The Amazon RDS Maintenance Window.

Master Username

The name that you use as the master user name to log on to your DB Instance.

For more information, and a list of the default privileges for the master user, see MySQL Security on Amazon RDS.

Master User Password

The password for your master user account. The password must contain from 8 to 16 printable ASCII characters (excluding /,", a space, and @).

Multi-AZ Deployment

Yes to create a standby mirror of your DB instance in another Availability Zone for failover support. We recommend Multi-AZ for production workloads to maintain high availability. For development and testing, you can choose No.

For more information, see High Availability (Multi-AZ).

Option Group

An option group for your DB instance. You can choose the default option group or you can create a custom option group.

For more information, see Working with Option Groups.

Publicly Accessible

Yes to give your DB instance a public IP address. This means that it is accessible outside the VPC (the DB instance also needs to be in a public subnet in the VPC). Choose No if you want the DB instance to only be accessible from inside the VPC.

For more information, see Hiding a DB Instance in a VPC from the Internet.

Storage Type

The storage type for your DB instance.

For more information, see Amazon RDS Storage Types.

Subnet Group

This setting depends on the platform you are on. If you are a new customer to AWS, choose default, which is the default DB subnet group that was created for your account. If you are creating a DB instance on the previous E2-Classic platform and you want your DB instance in a specific VPC, choose the DB subnet group you created for that VPC.

VPC

This setting depends on the platform you are on. If you are a new customer to AWS, choose the default VPC shown. If you are creating a DB instance on the previous E2-Classic platform that does not use a VPC, choose Not in VPC.

For more information, see Amazon Virtual Private Cloud (VPCs) and Amazon RDS.

VPC Security Group

If you are a new customer to AWS, choose the default VPC. Otherwise, choose the VPC security group you previously created.

For more information, see Working with DB Security Groups (EC2-Classic Platform).

Related Topics