# Document history for the Amazon DocumentDB Developer Guide
<a name="doc-history"></a>
+ **API version:** 2014-10-31
+ **Latest documentation update: **July 23, 2024

The following table describes the documentation for this release of the *Amazon DocumentDB Developer Guide*.

| Change | Description | Date | 
| --- |--- |--- |
| [Amazon managed policy update - policy change](https://docs.amazonaws.cn/documentdb/latest/developerguide/docdb-managed-policies.html) | Amazon DocumentDB updates the full-access policies for elastic clusters.  | February 11, 2025 | 
| [Amazon managed policy update - policy change](https://docs.amazonaws.cn/documentdb/latest/developerguide/docdb-managed-policies.html) | Amazon DocumentDB updates the full-access policies for elastic clusters.  | February 21, 2024 | 
| [Amazon managed policy update - policy change](https://docs.amazonaws.cn/documentdb/latest/developerguide/docdb-managed-policies.html) | Amazon DocumentDB updates the read-only and full-access policies for elastic clusters.  | June 21, 2023 | 
| [Amazon managed policy update - new policy](https://docs.amazonaws.cn/documentdb/latest/developerguide/docdb-managed-policies.html) | Amazon DocumentDB introduces a new read-only policy for elastic clusters.  | June 8, 2023 | 
| [Amazon managed policy update - new policy](https://docs.amazonaws.cn/documentdb/latest/developerguide/docdb-managed-policies.html) | Amazon DocumentDB introduces a new full-access policy for elastic clusters.  | June 5, 2023 | 
| [MongoDB 5.0 Compatibility](https://docs.amazonaws.cn/documentdb/latest/developerguide/elastic-service-linked-roles.html) | Amazon DocumentDB is now compatible with version 5.0 of MongoDB.  | March 1, 2023 | 
| [Policy Update](https://docs.amazonaws.cn/documentdb/latest/developerguide/docdb-managed-policies.html) | To support the Amazon DocumentDB elastic cluster feature, AmazonDocDBConsoleFullAccess policy is updated, and the AmazonDocDB-ElasticServiceRolePolicy is introduced. | November 30, 2022 | 
| [Elastic Clusters](https://docs.amazonaws.cn/documentdb/latest/developerguide/docdb-using-elastic-clusters.html) | Added new Elastic Cluster feature supporting hash-based partitioning (sharding) of data across Amazon DocumentDB’s distributed storage system. | November 30, 2022 | 
| [Global Clusters](https://docs.amazonaws.cn/documentdb/latest/developerguide/global-clusters.html) | Added documentation on how to use Global Clusters. | June 2, 2021 | 
| [Event Subscriptions](https://docs.amazonaws.cn/documentdb/latest/developerguide/event-subscriptions.html) | Added event subscription documentation. | March 26, 2021 | 
| [Version 3.6 Upgrades](https://docs.amazonaws.cn/documentdb/latest/developerguide/release-notes.html#release-notes.01-15-2021) | Documented improvements to version 3.6 in role-based access controls, aggregation operators, and performance.  | January 15, 2021 | 
| [MongoDB 4.0 Compatibility](https://docs.amazonaws.cn/documentdb/latest/developerguide/compatibility.html) | Amazon DocumentDB is now compatible with version 4.0 of MongoDB.  | November 9, 2020 | 
| [Get Started Guides](https://docs.amazonaws.cn/documentdb/latest/developerguide/get-started-guide.html) | New Get Started Guides for getting started with Amazon DocumentDB using Amazon Cloud9, Amazon EC2, Robo3T or Studio3T.  | August 15, 2020 | 
| [Additional Availability Zones supported](https://docs.amazonaws.cn/documentdb/latest/developerguide/what-is.html#what-is-regions-and-azs) | Amazon DocumentDB added support for an additional Availability Zone in Asia Pacific (Seoul) (ap-northeast-2).  | July 14, 2020 | 
| [Added support for copying snapshots across Regions.](https://docs.amazonaws.cn/documentdb/latest/developerguide/backup_restore-copy_cluster_snapshot.html) | Amazon DocumentDB added support for copying cluster snapshots across Amazon Web Services Regions. For more information, see [ Copying Snapshots Across Regions](https://docs.amazonaws.cn/documentdb/latest/developerguide/backup_restore-copy_cluster_snapshot.html).  | July 10, 2020 | 
| [Added support for T3 instance class.](https://docs.amazonaws.cn/documentdb/latest/developerguide/db-instance-classes.html#db-instance-class-specs) | Added support for T3 instance types in all Regions supporting Amazon DocumentDB. For more information, see [ Supported Instance Classes by Region](https://docs.amazonaws.cn/documentdb/latest/developerguide/db-instance-classes.html#db-instance-classes-by-region) and [ Instance Class Specifications](https://docs.amazonaws.cn/documentdb/latest/developerguide/db-instance-classes.html#db-instance-class-specs).  | June 30, 2020 | 
| [Added support for Amazon GovCloud (US).](https://docs.amazonaws.cn/documentdb/latest/developerguide/db-instance-classes.html#db-instance-classes-by-region) | Amazon DocumentDB is now available in the Amazon GovCloud (US) Region (us-gov-west-1).  | June 29, 2020 | 
| [Added 16 new CloudWatch metrics.](https://docs.amazonaws.cn/documentdb/latest/developerguide/cloud_watch.html) | Amazon DocumentDB added support for 16 new Amazon CloudWatch metrics. For more information, see [ Monitoring Amazon DocumentDB with CloudWatch](https://docs.amazonaws.cn/documentdb/latest/developerguide/cloud_watch.html).  | June 23, 2020 | 
| [Added support for null characters and $regex operator.](https://docs.amazonaws.cn/documentdb/latest/developerguide/functional-differences.updated-functional-differences.html) | Amazon DocumentDB added support for null characters in strings and the ability to use an index for $regex. To view the supported MongoDB APIs and aggregation pipeline capabilities for Amazon DocumentDB, see [ Functional Differences with MongoDB](https://docs.amazonaws.cn/documentdb/latest/developerguide/functional-differences.html).  | June 22, 2020 | 
| [Added support for improved multi-key indexing capabilities.](https://docs.amazonaws.cn/documentdb/latest/developerguide/functional-differences.array-indexing.html) | Amazon DocumentDB added support for improved multi-key indexing capabilities that include indexing of arrays larger than 2,048 bytes and the ability to create a compound multi-key index with multiple keys in the same array. For more information, see [ Functional Differences with MongoDB](https://docs.amazonaws.cn/documentdb/latest/developerguide/functional-differences.html).  | April 23, 2020 | 
| [Added support for deletion protection for an Amazon DocumentDB Amazon CloudFormation stack.](https://docs.amazonaws.cn/documentdb/latest/developerguide/quick_start_cfn.html) | Amazon DocumentDB added support for enabling deletion protection when creating an Amazon DocumentDB Amazon CloudFormation stack. | April 20, 2020 | 
| [Added support for role-based access control.](https://docs.amazonaws.cn/documentdb/latest/developerguide/role_based_access_control.html) | Amazon DocumentDB added support for role-based access control using built-in roles. | March 26, 2020 | 
| [Added support for an additional Availability Zone in Canada (Central) (ca-central-1).](https://docs.amazonaws.cn/documentdb/latest/developerguide/what-is.html#what-is-regions-and-azs) | Amazon DocumentDB is now available in the Canada (Central) Region (ca-central-1) with R5 class instances and 3 Availability Zones.  | March 26, 2020 | 
| [Added support for two additional MongoDB APIs.](https://docs.amazonaws.cn/documentdb/latest/developerguide/mongo-apis.html) | Amazon DocumentDB added support for `$dateFromString` and `executionStats` MongoDB APIs. | March 23, 2020 | 
| [Added support for five additional MongoDB APIs.](https://docs.amazonaws.cn/documentdb/latest/developerguide/mongo-apis.html) | Amazon DocumentDB added support for `$objectToArray`, `$arrayToObject`, `$slice`, `$mod`, and `$range` MongoDB APIs. | February 6, 2020 | 
| [Added support for Canada (Central).](https://docs.amazonaws.cn/documentdb/latest/developerguide/db-instance-classes.html#db-instance-classes-by-region) | Amazon DocumentDB is now available in the Canada (Central) Region (ca-central-1) with R5 class instances.  | December 11, 2019 | 
| [Added support for ChangeStreamLogSize.](https://docs.amazonaws.cn/documentdb/latest/developerguide/cloud_watch.html#cloud_watch-docdb_metrics_list) | Amazon DocumentDB added support for `ChangeStreamLogSize` for Cloudwatch metrics.  | November 22, 2019 | 
| [Added support for Europe (Paris) region](https://docs.amazonaws.cn/documentdb/latest/developerguide/db-instance-classes.html#db-instance-classes-by-region) | Amazon DocumentDB is now available in the Europe (Paris) region (eu-west-3) with R5 class instances. | October 30, 2019 | 
| [Added support for Asia Pacific (Mumbai) region](https://docs.amazonaws.cn/documentdb/latest/developerguide/db-instance-classes.html#db-instance-classes-by-region) | Amazon DocumentDB is now available in the Asia Pacific (Mumbai) region (ap-south-1) with R5 class instances. | October 17, 2019 | 
| [Added support for three additional MongoDB APIs](https://docs.amazonaws.cn/documentdb/latest/developerguide/mongo-apis.html) | Amazon DocumentDB added support for the `$addFields`, `$concatArrays`, and `$lookup` MongoDB APIs. | October 16, 2019 | 
| [Added support for Asia Pacific (Singapore) region](https://docs.amazonaws.cn/documentdb/latest/developerguide/db-instance-classes.html#db-instance-classes-by-region) | Amazon DocumentDB is now available in the Asia Pacific (Singapore) region (ap-southeast-1) with R5 class instances. | October 14, 2019 | 
| [Added new document for updating TLS certificates](https://docs.amazonaws.cn/documentdb/latest/developerguide/ca_cert_rotation.html) | Added instructions for updating CA certificates to use the new CA certificate to create TLS connections. | October 2, 2019 | 
| [Added API support for certificates](https://docs.amazonaws.cn/documentdb/latest/developerguide/API_Certificate.html) | Amazon DocumentDB a new Certificate data type for instances. For more information, see [ DBInstance](https://docs.amazonaws.cn/documentdb/latest/developerguide/API_DBInstance.html).  | October 1, 2019 | 
| [Support for query profiling](https://docs.amazonaws.cn/documentdb/latest/developerguide/profiling.html) | Amazon DocumentDB added the ability to profile supported operations on your cluster's instances and databases. | August 19, 2019 | 
| [Added third AZ in Asia Pacific (Tokyo)](https://docs.amazonaws.cn/documentdb/latest/developerguide/what-is.html#what-is-regions-and-azs) | Amazon DocumentDB added a third Availability Zone (AZ) for your compute instances in Asia Pacific (Tokyo). | August 9, 2019 | 
| [Support for additional Mongo APIs](https://docs.amazonaws.cn/documentdb/latest/developerguide/mongo-apis.html) | Added support for additional aggregation pipeline capabilities that include the `$in`, `$isoWeek`, `$isoWeekYear`, `$isoDayOfWeek`, and `$dateToString` aggregation operators and the `$addToSet` aggregation stage. Amazon DocumentDB also added support for the `top()` command for collection level diagnostics and the ability to modify the `expireAfterSeconds` parameter for TTL indexes using the `collMod()` command. | July 31, 2019 | 
| [Added support for Europe (London)](https://docs.amazonaws.cn/documentdb/latest/developerguide/db-instance-classes.html#db-instance-classes-by-region) | Amazon DocumentDB is now available in Europe (London) (eu-west-2) with R5 class instances. | July 18, 2019 | 
| [Added code samples](https://docs.amazonaws.cn/documentdb/latest/developerguide/connect.html) | Added code examples in R and Ruby for programmatically connecting to Amazon DocumentDB. | July 17, 2019 | 
| [Added best practice](https://docs.amazonaws.cn/documentdb/latest/developerguide/best_practices.html#best_practices-cost_optimization) | Added a Best Practice to help you manage your Amazon DocumentDB costs. | July 17, 2019 | 
| [Support for stopping and starting a cluster](https://docs.amazonaws.cn/documentdb/latest/developerguide/db-cluster-stop-start.html) | Amazon DocumentDB added support for stopping and starting clusters to manage costs for development and test environments. | July 1, 2019 | 
| [Support for cluster deletion protection](https://docs.amazonaws.cn/documentdb/latest/developerguide/db-cluster-delete.html) | To protect your clusters from accidental deletion, Amazon DocumentDB added deletion protection. For more information, see the following topics: [Creating an Amazon DocumentDB Cluster](https://docs.amazonaws.cn/documentdb/latest/developerguide/db-cluster-create.html), [Modifying an Amazon DocumentDB Cluster](https://docs.amazonaws.cn/documentdb/latest/developerguide/db-cluster-modify.html), [Deleting an Amazon DocumentDB Cluster](https://docs.amazonaws.cn/documentdb/latest/developerguide/db-cluster-delete.html), and `DeletionProtection` in the API topic [DBCluster](https://docs.amazonaws.cn/documentdb/latest/developerguide/API_DBCluster.html). | July 1, 2019 | 
| [Functional differences update](https://docs.amazonaws.cn/documentdb/latest/developerguide/functional-differences.html#functional-differences.implicit-transactions) | Added Implicit Transactions to Functional Differences. | June 26, 2019 | 
| [Functional differences addition](https://docs.amazonaws.cn/documentdb/latest/developerguide/functional-differences.html#functional-differences.storage-compression) | Added note regarding storage and index compression in Amazon DocumentDB. | June 13, 2019 | 
| [Additional region supported](https://docs.amazonaws.cn/documentdb/latest/developerguide/db-instance-classes.html#db-instance-classes-by-region) | Amazon DocumentDB is now available in Asia Pacific (Sydney) (ap-southeast-2) with R5 class instances. | June 5, 2019 | 
| [R5 instance class supported in additional regions](https://docs.amazonaws.cn/documentdb/latest/developerguide/db-instance-classes.html#db-instance-classes-by-region) | Added R5 instance class support for 4 additional regions: US East (Ohio), US East (N. Virginia), US West (Oregon), and EU (Ireland). With this change, R5 instances are supported in all regions supporting Amazon DocumentDB. | May 17, 2019 | 
| [Additional regions supported](https://docs.amazonaws.cn/documentdb/latest/developerguide/how-it-works.html#how-it-works.availability) | Added support for 2 additional regions, Asia Pacific (Tokyo) (ap-northeast-1) and Asia Pacific (Seoul) (ap-northeast-2) with R5 instance classes. For more information, see [Supported Instance Classes by Region](https://docs.amazonaws.cn/documentdb/latest/developerguide/db-instance-classes.html#db-instance-classes-by-region) and [Instance Class Specifications](https://docs.amazonaws.cn/documentdb/latest/developerguide/db-instance-classes.html#db-instance-class-specs). | May 8, 2019 | 
| [Added more connection code examples](https://docs.amazonaws.cn/documentdb/latest/developerguide/connect.html) | Added code examples in Java and C\# for connecting to Amazon DocumentDB. | April 24, 2019 | 
| [Additional Mongo API support](https://docs.amazonaws.cn/documentdb/latest/developerguide/mongo-apis.html) | Added support for seven aggregation string operators (`$indexOfBytes`, `$indexOfCP`, `$strLenBytes`, `$strLenCP`, `$toLower`, `$toUpper`, and `$split`), nine date-time operators (`$dayOfYear`, `$dayOfMonth`, `$dayOfWeek`, `$year`, `$month`, `$hour`, `$minute`, `$second`, and `$millisecond`), and the `$sample` aggregation pipeline stage. | April 4, 2019 | 
| [Added connection code examples](https://docs.amazonaws.cn/documentdb/latest/developerguide/connect.html) | Added code examples in Python, Node.js, PHP, and Go for connecting to Amazon DocumentDB. | March 21, 2019 | 
| [Support for Frankfurt Region and R5 instances](https://docs.amazonaws.cn/documentdb/latest/developerguide/how-it-works.html#how-it-works.availability) | Added support for Europe (Frankfurt) Region (eu-central-1) with R5 instance classes. For more information, see [Supported Instance Classes by Region](https://docs.amazonaws.cn/documentdb/latest/developerguide/db-instance-classes.html#db-instance-classes-by-region) and [Instance Class Specifications](https://docs.amazonaws.cn/documentdb/latest/developerguide/db-instance-classes.html#db-instance-class-specs). | March 13, 2019 | 
| [Aggregation pipeline operators support](https://docs.amazonaws.cn/documentdb/latest/developerguide/mongo-apis-aggregation-pipeline.html) | Added support for new aggregation string operators (`$concat`, `$substr`, `$substrBytes`, `$substrCP`, `$strcasecmp`), an array aggregation operator (`$size`), an aggregation group accumulator operator (`$push`), and aggregation stages (`$redact` and `$indexStats`). We also added support for positional array operators (`$[]` and `$[<identifier>]`) and `hint()`. | February 28, 2019 | 
| [Engine upgrades](https://docs.amazonaws.cn/documentdb/latest/developerguide/db-cluster-version-upgrade.html) | Added documentation for determining pending cluster modifications and upgrading your cluster's engine version. | February 15, 2019 | 
| [Auditing events](https://docs.amazonaws.cn/documentdb/latest/developerguide/event-auditing.html) | Added support for auditing database events with Amazon CloudWatch Logs. | February 12, 2019 | 
| [Quick Start](https://docs.amazonaws.cn/documentdb/latest/developerguide/quick_start_cfn.html) | Added a Quick Start topic to help you easily start with Amazon DocumentDB using Amazon CloudFormation. | January 11, 2019 | 
| [Public Release](#doc-history) | This is the initial public release of Amazon DocumentDB (with MongoDB compatibility). This release includes the [Developer Guide](https://docs.amazonaws.cn/documentdb/latest/developerguide/what-is.html) and the integrated [Resource Management API Reference](https://docs.amazonaws.cn/documentdb/latest/developerguide/api-reference.html). | January 9, 2019 |