# Describe RDS DB instances

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

Describe supported RDS DB instances and filter out Aurora, Neptune, DocumentDB, and RDS Custom. Page size is 20-100. Requires rds:DescribeDBInstances.

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

## Risk and exposure

- Risk: Read
- Idempotency: Safe — Safe to retry without coordination; repeats do not create additional side effects.
- Availability: Default
- Exposure: REST, SDK, MCP
- MCP hints: readOnly=true, destructive=false, idempotent=true, openWorld=true

## Required scopes

- `rds:DescribeDBInstances`

## Input schema fields

- `region`
- `db_instance_identifier`
- `page_size`
- `cursor`

## Output schema fields

- `db_instances`
- `db_instances[]`
- `db_instances[].identifier`
- `db_instances[].arn`
- `db_instances[].status`
- `db_instances[].engine`
- `db_instances[].engine_version`
- `db_instances[].instance_class`
- `db_instances[].endpoint_address`
- `db_instances[].endpoint_port`
- `db_instances[].availability_zone`
- `db_instances[].multi_az`
- `db_instances[].storage_encrypted`
- `db_instances[].publicly_accessible`
- `db_instances[].cluster_identifier`
- `db_instances[].automatic_restart_time`
- `db_instances[].created_at`
- `next_cursor`

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.describe
Deployment-effective discovery: https://api.fuse.init.inc/v1/tenants/%7Btenant_id%7D/providers/aws/actions