Amazon DocumentDB cluster storage configurations - Amazon DocumentDB
Creating an I/O-optimized clusterCost analysis for determining storage configuration
Services or capabilities described in Amazon Web Services documentation might vary by Region. To see the differences applicable to the China Regions, see Getting Started with Amazon Web Services in China (PDF).

Amazon DocumentDB cluster storage configurations

Starting from Amazon DocumentDB 5.0, instance-based clusters support two storage configurations types:

  • Amazon DocumentDB standard storage: Designed for customers with low to moderate I/O consumption. If you expect your I/O costs to be less than 25% of your total Amazon DocumentDB cluster, this choice might be ideal for you. With the Amazon DocumentDB standard storage configuration, you’re billed on a pay-per-request I/O basis in addition to instance and storage charges. This means your billing might vary from one cycle to another based on usage. The configuration is tailored to accommodate fluctuating I/O demands of your application.

  • Amazon DocumentDB I/O-optimized storage: Designed for customers who prioritize price predictability or have I/O intensive applications. The I/O-optimized configuration offers improved performance, increased throughput, and reduced latency for customers with I/O intensive workloads. If you expect your I/O costs to exceed 25% of your total Amazon DocumentDB cluster costs, this option offers enhanced price performance. With the Amazon DocumentDB I/O-optimized storage configuration, you won't be charged based on I/O operations, ensuring predictable costs each billing cycle. The configuration stabilizes costs while improving performance.

You can switch your existing database clusters once every 30 days to Amazon DocumentDB I/O-optimized storage. You can switch back to Amazon DocumentDB standard storage at any time. The next date to modify the storage configuration to I/O-optimized can be tracked with the describe-db-clusters command using the Amazon CLI or through the Amazon Web Services Management Console in the cluster's configuration page.

You can create a new database cluster including the Amazon DocumentDB I/O-optimized configuration or convert your existing database clusters with a few clicks in the Amazon Web Services Management Console, a single parameter change in the Amazon Command Line Interface (Amazon CLI), or through Amazon SDKs. There is no downtime or reboot of instances required during or after modifying the storage configuration.

Creating an I/O-optimized cluster

Using the Amazon Web Services Management Console

To creating or modify an I/O-optimized cluster using the Amazon Web Services Management Console:

  1. On the Amazon DocumentDB management console, under Clusters, choose either Create or select the cluster and choose Actions, and then choose Modify.

  2. If you are creating a new cluster, make sure you choose Instance Based Clusters in the Cluster type section (this is the default option).

  3. In the Configuration section, under Cluster storage configuration, choose Amazon DocumentDB I/O Optimized.

  4. Complete your cluster creation or modification and choose Create cluster or Modify cluster.

    For the complete Create cluster process, see Creating a cluster and primary instance using the Amazon Web Services Management Console.

    For the complete Modify cluster process, see Modifying an Amazon DocumentDB cluster.

Using the Amazon CLI

To creating an I/O-optimized cluster using the Amazon CLI:

In the following examples, replace each user input placeholder with your own information.

For Linux, macOS, or Unix:

aws docdb create-db-cluster \
      --db-cluster-identifier sample-cluster \
      --engine docdb \
      --engine-version 5.0.0 \
      --storage-type iopt1 \
      --deletion-protection \
      --master-username username \
      --master-user-password password

For Windows:

aws docdb create-db-cluster ^
      --db-cluster-identifier sample-cluster ^
      --engine docdb ^
      --engine-version 5.0.0 ^
      --storage-type iopt1 ^
      --deletion-protection ^
      --master-username username ^
      --master-user-password password

Cost analysis for determining storage configuration

With Amazon DocumentDB, you have the flexibility to choose your storage configuration for every database cluster you have. In order to properly allocate your clusters between standard and I/O-optimized, you can track your Amazon DocumentDB costs cluster-wise. To do so, you can add tags to existing clusters, enable cost allocation tagging in your Amazon Billing and Cost Management dashboard, and analyze your costs for a given cluster in the Amazon Cost Explorer Service. For information on cost analysis, see our blog Using cost allocation tags.