# Stop RDS DB instance

Canonical URL: https://docs.fuse.init.inc/integrations/aws/actions/rds.db_instances.stop

Stop one supported RDS DB instance after Describe preflight. AWS may automatically restart stopped instances after seven days; automatic_restart_time is returned when present. Unsafe with one SDK attempt. Requires rds:DescribeDBInstances and rds:StopDBInstance.

Action ID: `rds.db_instances.stop`
Provider: AWS (`aws`)
Contract version: 1

## Risk and exposure

- Risk: Destructive
- Idempotency: Unsafe — Retries may duplicate side effects; callers must coordinate carefully.
- Availability: Default
- Exposure: REST, SDK
- MCP hints: readOnly=false, destructive=true, idempotent=false, openWorld=true

## Required scopes

- `rds:DescribeDBInstances`
- `rds:StopDBInstance`

## Input schema fields

- `db_instance_identifier`
- `region`

## Output schema fields

- `db_instance`
- `db_instance.identifier`
- `db_instance.arn`
- `db_instance.status`
- `db_instance.engine`
- `db_instance.engine_version`
- `db_instance.instance_class`
- `db_instance.endpoint_address`
- `db_instance.endpoint_port`
- `db_instance.availability_zone`
- `db_instance.multi_az`
- `db_instance.storage_encrypted`
- `db_instance.publicly_accessible`
- `db_instance.cluster_identifier`
- `db_instance.automatic_restart_time`
- `db_instance.created_at`

Provider overview: https://docs.fuse.init.inc/integrations/aws
Actions index: https://docs.fuse.init.inc/integrations/aws/actions
Exact canonical JSON contract: https://docs.fuse.init.inc/api/catalog/v1/providers/aws/actions/rds.db_instances.stop
Deployment-effective discovery: https://api.fuse.init.inc/v1/tenants/%7Btenant_id%7D/providers/aws/actions