Amazon Aurora
User Guide (API Version 2014-10-31)

Deleting a DB Instance in a DB Cluster

You can delete a DB instance in a DB cluster. You can delete the primary DB instance in the DB cluster or an Aurora Replica. To delete a DB instance, you must specify the name of the instance.

For Aurora MySQL, you can't delete the DB instance in a DB cluster if both of the following conditions are true:

  • The DB cluster is a Read Replica of another Aurora DB cluster.

  • The DB instance is the only instance in the DB cluster.

To delete a DB instance in this case, first promote the DB cluster so it's no longer a Read Replica. After the promotion completes, you can delete the final DB instance in the DB cluster. For more information, see Replicating Amazon Aurora MySQL DB Clusters Across AWS Regions.

Delete a DB Instance

You can delete a DB instance using the AWS Management Console, the AWS CLI, or the RDS API.

AWS Management Console

To delete a 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 navigation pane, choose Instances, and then select the DB instance that you want to delete.

  3. Choose Instance actions, and then choose Delete.

  4. Type delete me in the box.

  5. Choose Delete.

CLI

To delete a DB instance by using the AWS CLI, call the delete-db-instance command and specify the --db-instance-identifier option.

For Linux, OS X, or Unix:

aws rds delete-db-instance \ --db-instance-identifier mydbinstance

For Windows:

aws rds delete-db-instance ^ --db-instance-identifier mydbinstance
API

To delete a DB instance by using the Amazon RDS API, call the DeleteDBInstance action and specify the DBInstanceIdentifier parameter.

On this page: