Skip to content

Amazon DocumentDB

DocumentDB shares the RDS API surface and signs requests with the rds signing name. AWSim handles DocumentDB calls via the existing awsim-rds service — there's no separate DocDB endpoint or crate.

Endpoint: http://localhost:4566Signing name: rds (DocumentDB SDK uses RDS for sigv4) Protocol: AWS-Query

Operations

Use the standard RDS cluster + instance operations with Engine: docdb:

OperationEngine field
CreateDBClusterdocdb
CreateDBInstancedocdb
DescribeDBClusters / DescribeDBInstancesfilter as usual
DeleteDBCluster / DeleteDBInstancestandard
ModifyDBCluster / ModifyDBInstancestandard

Behavior notes

  • Default engine version: 5.0.0. Default port: 27017.
  • The cluster endpoint follows the same naming pattern as Aurora: {cluster}.cluster.awsim.{region}.rds.localhost.
  • Cross-region global cluster operations work via CreateGlobalCluster — same flow as Aurora Global Database.

Example

bash
aws --endpoint-url http://localhost:4566 rds create-db-cluster \
  --db-cluster-identifier orders-docdb \
  --engine docdb \
  --master-username admin --master-user-password supersecret

Released under MIT / Apache-2.0 License