---
title: "POST /#Action=StopDBInstance"
method: POST
path: "/#Action=StopDBInstance"
---

# POST /#Action=StopDBInstance

`POST /#Action=StopDBInstance`

Stops an Amazon RDS DB instance. When you stop a DB instance, Amazon RDS retains the DB instance's metadata, including its endpoint, DB parameter group, and option group membership. Amazon RDS also retains the transaction logs so you can do a point-in-time restore if necessary.

For more information, see [Stopping an Amazon RDS DB Instance Temporarily](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_StopInstance.html) in the _Amazon RDS User Guide._

This command doesn't apply to RDS Custom, Aurora MySQL, and Aurora PostgreSQL. For Aurora clusters, use `StopDBCluster` instead.

## Query parameters

- `Action` 'StopDBInstance', required
- `Version` '2014-10-31', required

## Response `200`

Success

## Other responses

- `480` — DBInstanceNotFoundFault
- `481` — InvalidDBInstanceStateFault
- `482` — DBSnapshotAlreadyExistsFault
- `483` — SnapshotQuotaExceededFault
- `484` — InvalidDBClusterStateFault

---

[API](https://skmtc.net/aws/apis/rds.md) · [All operations](https://skmtc.net/aws/apis/rds/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/aws/rds/versions/e6b3ad7df19b/schema)