INTMDB-632: v1.10.0 CHANGELOG and Upgrade Guide Doc Updates (#1232)

* Update CHANGELOG.md

* Update CHANGELOG.md

* Update CHANGELOG.md

* Update CHANGELOG.md

* Update CHANGELOG.md

* Update CHANGELOG.md

* Update CHANGELOG.md

* Update CHANGELOG.md

* Release Notes Updates

* Update 1.10.0-upgrade-guide.html.markdown

* Update 1.10.0-upgrade-guide.html.markdown

* Update 1.10.0-upgrade-guide.html.markdown

* Update 1.10.0-upgrade-guide.html.markdown

* Update 1.10.0-upgrade-guide.html.markdown

* Update 1.10.0-upgrade-guide.html.markdown

* Update 1.10.0-upgrade-guide.html.markdown

* Update website/docs/guides/1.10.0-upgrade-guide.html.markdown

* Update CHANGELOG.md

Co-authored-by: Melissa Plunkett <[email protected]>

* Update website/docs/guides/1.10.0-upgrade-guide.html.markdown

Co-authored-by: Melissa Plunkett <[email protected]>

* Update website/docs/guides/1.10.0-upgrade-guide.html.markdown

Co-authored-by: Melissa Plunkett <[email protected]>

* Update website/docs/guides/1.10.0-upgrade-guide.html.markdown

Co-authored-by: Melissa Plunkett <[email protected]>

* Update PAK-upgrade-guide-1.10.0.html.markdown

* Update 1.10.0-upgrade-guide.html.markdown

* File rename

* Atlas Org Updates

* Update website/docs/guides/1.10.0-upgrade-guide.html.markdown

* Update 1.10.0-upgrade-guide.html.markdown

* Update 1.10.0-upgrade-guide.html.markdown

* Update CHANGELOG.md

* Update CHANGELOG.md

* Update Programmatic-API-Key-upgrade-guide-1.10.0.html.markdown

* Update website/docs/guides/Programmatic-API-Key-upgrade-guide-1.10.0.html.markdown

* Update README.md

* Update Programmatic-API-Key-upgrade-guide-1.10.0.html.markdown

* Update Programmatic-API-Key-upgrade-guide-1.10.0.html.markdown

* Update website/docs/guides/Programmatic-API-Key-upgrade-guide-1.10.0.html.markdown

* Update Programmatic-API-Key-upgrade-guide-1.10.0.html.markdown

* Update Programmatic-API-Key-upgrade-guide-1.10.0.html.markdown

* Update Programmatic-API-Key-upgrade-guide-1.10.0.html.markdown

* Update website/docs/guides/Programmatic-API-Key-upgrade-guide-1.10.0.html.markdown

Co-authored-by: Melissa Plunkett <[email protected]>

* Update website/docs/guides/Programmatic-API-Key-upgrade-guide-1.10.0.html.markdown

Co-authored-by: Melissa Plunkett <[email protected]>

* Update website/docs/guides/Programmatic-API-Key-upgrade-guide-1.10.0.html.markdown

---------

Co-authored-by: Melissa Plunkett <[email protected]>

Author: Zuhairahmed

CHANGELOG.md

@@ -1,9 +1,43 @@
 # Changelog
 
-## [v1.10.0](https://github.com/mongodb/terraform-provider-mongodbatlas/tree/v1.10.0) (June 10, 2023)
+## [v1.10.0](https://github.com/mongodb/terraform-provider-mongodbatlas/tree/v1.10.0) (2023-6-13)
 
 [Full Changelog](https://github.com/mongodb/terraform-provider-mongodbatlas/compare/v1.9.0...v1.10.0)
 
+**Enhancements:**
+
+- New: [Organizations Management](https://www.mongodb.com/docs/atlas/reference/api-resources-spec/#tag/Organizations/operation/createOrganization) including Create (https://github.com/mongodb/terraform-provider-mongodbatlas/pull/1176) - INTMDB-533  
+- New: [Federated Database Instance](https://www.mongodb.com/docs/atlas/reference/api-resources-spec/#tag/Data-Federation/operation/createFederatedDatabase) resource and data sources (https://github.com/mongodb/terraform-provider-mongodbatlas/pull/1163) - INTMDB-801
+- New: [Query Limit for Database Instance](https://www.mongodb.com/docs/atlas/reference/api-resources-spec/#tag/Data-Federation/operation/createOneDataFederationQueryLimit) resource and data sources (https://github.com/mongodb/terraform-provider-mongodbatlas/pull/1173) - INTMDB-802
+- New: [Private Endpoint](https://www.mongodb.com/docs/atlas/reference/api-resources-spec/#tag/Data-Federation/operation/createDataFederationPrivateEndpoint) resources and data sources for Federated Database Instance and Online Archive (https://github.com/mongodb/terraform-provider-mongodbatlas/pull/1182) - INTMDB-803
+- New: [Data Lake Pipelines](https://www.mongodb.com/docs/atlas/reference/api-resources-spec/#tag/Data-Lake-Pipelines/operation/createPipeline) resource and data sources (https://github.com/mongodb/terraform-provider-mongodbatlas/pull/1174) - INTMDB-804
+- New: [Data Lake Pipelines Run](https://www.mongodb.com/docs/atlas/reference/api-resources-spec/#tag/Data-Lake-Pipelines/operation/getPipelineRun) data sources (https://github.com/mongodb/terraform-provider-mongodbatlas/pull/1177) - INTMDB-805
+- New: [Cluster Outage Simulation](https://www.mongodb.com/docs/atlas/reference/api-resources-spec/#tag/Cluster-Outage-Simulation/operation/startOutageSimulation) resource and data sources (https://github.com/mongodb/terraform-provider-mongodbatlas/pull/1188) - INTMDB-835
+- Feature Add: [Cluster Enable Extended Storage](https://www.mongodb.com/docs/atlas/customize-storage/#minimum-disk-capacity-to-ram-ratios) Sizes in `mongodbatlas_project` (https://github.com/mongodb/terraform-provider-mongodbatlas/pull/1128) - INTMDB-466
+- Feature Add: [srvShardOptimizedConnectionString parameter](https://www.mongodb.com/docs/atlas/reference/api-resources-spec/#tag/Multi-Cloud-Clusters/operation/createCluster) to `mongodbatlas_cluster` and `mongodbatlas_advanced_cluster` Data Sources (https://github.com/mongodb/terraform-provider-mongodbatlas/pull/1157) - INTMDB-694
+- Feature Add: [retainBackups parameter](https://www.mongodb.com/docs/atlas/reference/api-resources-spec/#tag/Multi-Cloud-Clusters/operation/createCluster) to `mongodbatlas_cluster` and `mongodbatlas_advanced_cluster` (https://github.com/mongodb/terraform-provider-mongodbatlas/pull/1210) - INTMDB-781
+- [Programmatic API Key](https://www.mongodb.com/docs/atlas/reference/api-resources-spec/#tag/Programmatic-API-Keys) Resource Updates (`mongodbatlas_api_key`, `mongodbatlas_project_api_key` and `mongodbatlas_project_ip_access_list_key`) + Doc Cleanup (https://github.com/mongodb/terraform-provider-mongodbatlas/pull/1208) - INTMDB-655
+- Release.md File Updates with Action Items (https://github.com/mongodb/terraform-provider-mongodbatlas/pull/1203) - INTMDB-690
+- ChangeLog Generator (https://github.com/mongodb/terraform-provider-mongodbatlas/pull/1165) - INTMDB-720
+- Upgrade to [Go 1.20](https://go.dev/blog/go1.20) (https://github.com/mongodb/terraform-provider-mongodbatlas/pull/1153) - INTMDB-658
+
+**Deprecations and Removals:**
+
+- `mongodbatlas_data_lake` and `mongodbatlas_privatelink_endpoint_service_adl` (https://github.com/mongodb/terraform-provider-mongodbatlas/pull/1190) - INTMDB-806
+-  Remove `mongodbatlas_private_ip_mode` and NEW_RELIC and FLOWDOCK in `mongodbatlas_third_party_integration` resources and data sources (https://github.com/mongodb/terraform-provider-mongodbatlas/pull/1159) - INTMDB-408
+-  Remove mongodbatlas_cloud_provider (access, snapshot, snapshot_backup_policy, snapshot_restore_job) resources and datas sources (https://github.com/mongodb/terraform-provider-mongodbatlas/pull/1159) - INTMDB-408
+
+**Bug Fixes:**
+
+- `mongodbatlas_serverless_instance` wants to do an in-place update on every run (https://github.com/mongodb/terraform-provider-mongodbatlas/pull/1152) - INTMDB-710
+- Documentation bug: analyzer argument in `mongodbatlas_search_index` is required (https://github.com/mongodb/terraform-provider-mongodbatlas/pull/1158) - INTMDB-780
+- Point in Time Restore is not enabled when should_copy_oplogs is set to true, when copying backups to other regions (https://github.com/mongodb/terraform-provider-mongodbatlas/pull/1150) - INTMDB-783
+- `mongodbatlas_third_party_integration` - microsoft_teams_webhook_url keeps updating on every apply (https://github.com/mongodb/terraform-provider-mongodbatlas/pull/1148) - INTMDB-784
+- In `mongodbatlas_database_user` usernames with spaces breaks state due to URL encoding (https://github.com/mongodb/terraform-provider-mongodbatlas/pull/1164) - INTMDB-809
+- `mongodbatlas_backup_compliance_policy` causing `mongodbatlas_cloud_backup_schedule` resource to fail (https://github.com/mongodb/terraform-provider-mongodbatlas/pull/1209) - INTMDB-827 
+- `mongodbatlas_advanced_cluster` `node_count` parameter doc bug fix (https://github.com/mongodb/terraform-provider-mongodbatlas/pull/1193) - INTMDB-844
+- Fix typos in docs for `mongodbatlas_network_peering` and  `mongodbatlas_network_container` resource imports (https://github.com/mongodb/terraform-provider-mongodbatlas/pull/1200) 
+
 **Closed issues:**
 
 - Online Archive: "Specified cloud provider is not supported in Data Lake Storage" but works in UI [\#1216](https://github.com/mongodb/terraform-provider-mongodbatlas/issues/1216)
@@ -15,6 +49,21 @@
 - Failed to respond to the plugin.\(\*GRPCProvider\).PlanResourceChange call [\#1136](https://github.com/mongodb/terraform-provider-mongodbatlas/issues/1136)
 - Error: error creating MongoDB Cluster: unexpected EOF [\#674](https://github.com/mongodb/terraform-provider-mongodbatlas/issues/674)
 
+**Merged Pull Requests:**
+
+- Chore\(deps\):  Bump actions/stale from 7 to 8 (https://github.com/mongodb/terraform-provider-mongodbatlas/pull/1117)
+- Chore\(deps\):  Bump github.com/zclconf/go-cty from 1.13.1 to 1.13.2 (https://github.com/mongodb/terraform-provider-mongodbatlas/pull/1184)
+- Chore\(deps\):  Bump github.com/aws/aws-sdk-go from 1.44.268 to 1.44.272 (https://github.com/mongodb/terraform-provider-mongodbatlas/pull/1196)
+- Chore(deps): Bump github.com/gruntwork-io/terratest from 0.42.0 to 0.43.0 (https://github.com/mongodb/terraform-provider-mongodbatlas/pull/1197)
+- Chore(deps): Bump github.com/spf13/cast from 1.5.0 to 1.5.1 (https://github.com/mongodb/terraform-provider-mongodbatlas/pull/1195)
+- Chore(deps): Bump go.mongodb.org/atlas from 0.25.0 to 0.28.0 (https://github.com/mongodb/terraform-provider-mongodbatlas/pull/1194)
+- corrected documentation for advanced cluster and cluster (https://github.com/mongodb/terraform-provider-mongodbatlas/pull/1167) 
+- Update component field to "Terraform" GitHub action (https://github.com/mongodb/terraform-provider-mongodbatlas/pull/1178)
+- Add action to create JIRA ticket for a new Github issue (https://github.com/mongodb/terraform-provider-mongodbatlas/pull/1166)
+- Terraform Provider Secrets Audit (https://github.com/mongodb/terraform-provider-mongodbatlas/pull/1202) 
+- Add Code-health action (https://github.com/mongodb/terraform-provider-mongodbatlas/pull/1144)  
+- Fix TestAccConfigDSSearchIndexes_basic (https://github.com/mongodb/terraform-provider-mongodbatlas/pull/1227) 
+
 ## [v1.9.0](https://github.com/mongodb/terraform-provider-mongodbatlas/tree/v1.9.0) (2023-4-27)
 
 [Full Changelog](https://github.com/mongodb/terraform-provider-mongodbatlas/compare/v1.8.2...v1.9.0)

examples/atlas-api-key/README.md

@@ -12,7 +12,7 @@ To further facilitate the transition, we've included in this atlas-api-key folde
 
 * "Create and Assign PAK Separately" (Deprecated) — this is an older method of creating and assigning PAKs, now deprecated but still available for reference.
 
-Lastly, in MongoDB Atlas, all PAKs are Organization API keys. Once created, a PAK are linked at the organization level with an 'Organization Member' role. However, these Organization API keys can also be assigned to one or more projects within the organization. When a PAK is assigned to a specific project, it essentially takes on the 'Project Owner' role for that particular project. This enables the key to perform operations at the project level, in addition to the organization level. The flexibility of PAKs provides a powerful mechanism for fine-grained access and control, once their functioning is clearly understood. 
+Lastly, in MongoDB Atlas, all PAKs are Organization API keys. Once created, a PAK is linked at the organization level with an 'Organization Member' role. However, these Organization API keys can also be assigned to one or more projects within the organization. When a PAK is assigned to a specific project, it essentially takes on the 'Project Owner' role for that particular project. This enables the key to perform operations at the project level, in addition to the organization level. The flexibility of PAKs provides a powerful mechanism for fine-grained access and control, once their functioning is clearly understood. 
 
 Our hope is that these examples will provide clear guidance and help ease your transition to this new PAK workflow in our Terraform Provider.
 

website/docs/guides/1.10.0-upgrade-guide.html.markdown

@@ -0,0 +1,49 @@
+---
+layout: "mongodbatlas"
+page_title: "MongoDB Atlas Provider 1.10.0: Upgrade and Information Guide"
+sidebar_current: "docs-mongodbatlas-guides-1100-upgrade-guide"
+description: |-
+MongoDB Atlas Provider 1.10.0: Upgrade and Information Guide
+---
+
+# MongoDB Atlas Provider 1.10.0: Upgrade and Information Guide
+
+The Terraform MongoDB Atlas Provider version 1.10.0 has a number of new and exciting features and changes.
+
+**New Resources, Data Sources, and Features:**
+- You can now manage [MongoDB Atlas Organizations](https://www.mongodb.com/docs/atlas/reference/api-resources-spec/#tag/Organizations/operation/createOrganization) (including Create) with [`mongodbatlas_organization`](https://registry.terraform.io/providers/mongodb/mongodbatlas/latest/docs/resources/organization). Newly created Organizations are linked to the requesting API Key's organization. The requesting API Key's organization must be a paying organization and have [Cross-Organization Billing](https://www.mongodb.com/docs/atlas/billing/?_ga=2.39600355.114292989.1686535076-1433452924.1667927805&_gac=1.182003541.1684298278.CjwKCAjw04yjBhApEiwAJcvNoZ23kmDMLJdSWF_21lgtuZjnV0yUzkXt_9RLfLO_yeFKyWlBGSpKkxoCyK8QAvD_BwE#cross-organization-billing) enabled.
+- You can now manage [Federated Database Instances](https://www.mongodb.com/docs/atlas/reference/api-resources-spec/#tag/Data-Federation/operation/createFederatedDatabase) with [`mongodbatlas_federated_database_instance`](https://registry.terraform.io/providers/mongodb/mongodbatlas/latest/docs/resources/federated_database_instance)
+- You can now manage [Query Limits for Federated Database Instances](https://www.mongodb.com/docs/atlas/reference/api-resources-spec/#tag/Data-Federation/operation/createOneDataFederationQueryLimit) with [`mongodbatlas_federated_query_limit`](https://registry.terraform.io/providers/mongodb/mongodbatlas/latest/docs/resources/federated_database_instance)  
+- You can now manage [Private Endpoints](https://www.mongodb.com/docs/atlas/reference/api-resources-spec/#tag/Data-Federation/operation/createDataFederationPrivateEndpoint) for Federated Database Instances and Online Archives with [`mongodbatlas_privatelink_endpoint_service_data_federation_online_archive`](https://registry.terraform.io/providers/mongodb/mongodbatlas/latest/docs/resources/privatelink_endpoint_service_data_federation_online_archive)
+- You can now manage [Data Lake Pipelines](https://www.mongodb.com/docs/atlas/reference/api-resources-spec/#tag/Data-Lake-Pipelines/operation/createPipeline) with [`mongodbatlas_data_lake_pipeline`](https://registry.terraform.io/providers/mongodb/mongodbatlas/latest/docs/resources/data_lake_pipeline)
+- You can now create data sources for [Data Lake Pipelines Runs](https://www.mongodb.com/docs/atlas/reference/api-resources-spec/#tag/Data-Lake-Pipelines/operation/getPipelineRun) with [`mongodbatlas_data_lake_pipeline_run`](https://registry.terraform.io/providers/mongodb/mongodbatlas/latest/docs/data-sources/data_lake_pipeline_run)
+- You can now manage [Cluster Outage Simulations](https://www.mongodb.com/docs/atlas/reference/api-resources-spec/#tag/Cluster-Outage-Simulation/operation/startOutageSimulation) with [`mongodbatlas_cluster_outage_simulation`](https://registry.terraform.io/providers/mongodb/mongodbatlas/latest/docs/resources/cluster_outage_simulation) 
+- You can now enable [Extended Cluster Storage Sizes](https://www.mongodb.com/docs/atlas/customize-storage/#minimum-disk-capacity-to-ram-ratios) in [`mongodbatlas_project`](https://registry.terraform.io/providers/mongodb/mongodbatlas/latest/docs/resources/project). This setting allows M40+ clusters to be configured with storage greater than the standard maximum (up to 4TB for M40, 8TB for M50/M60, and 14TB for M80+). Clusters with extended storage sizes must be on AWS or GCP, and cannot span multiple regions. 
+- You can now leverage the [`PrivateEndpoint.srvShardOptimizedConnectionString`](https://www.mongodb.com/docs/atlas/reference/api-resources-spec/#tag/Multi-Cloud-Clusters/operation/createCluster) parameter in [`mongodbatlas_advanced_cluster`](https://registry.terraform.io/providers/mongodb/mongodbatlas/latest/docs/data-sources/advanced_cluster) and [`mongodbatlas_cluster`](https://registry.terraform.io/providers/mongodb/mongodbatlas/latest/docs/data-sources/cluster) Data Sources. This is a private endpoint-aware connection string optimized for sharded clusters that uses the `mongodb+srv://` protocol to connect to MongoDB Atlas.
+- You can now leverage the [`retainBackups`](https://www.mongodb.com/docs/atlas/reference/api-resources-spec/#tag/Multi-Cloud-Clusters/operation/createCluster) parameter in [`mongodbatlas_advanced_cluster`](https://registry.terraform.io/providers/mongodb/mongodbatlas/latest/docs/resources/advanced_cluster) and [`mongodbatlas_cluster`](https://registry.terraform.io/providers/mongodb/mongodbatlas/latest/docs/resources/cluster) Resources. Set to true to retain backup snapshots for the deleted M10+ cluster. The default value is false.
+
+
+**Changes**
+- [Programmatic API Key](https://www.mongodb.com/docs/atlas/reference/api-resources-spec/#tag/Programmatic-API-Keys) Resources and Data Sources have been updated to make easier and more intuitive to use ([`mongodbatlas_api_key`](https://registry.terraform.io/providers/mongodb/mongodbatlas/latest/docs/resources/api_key), [`mongodbatlas_project_api_key`](https://registry.terraform.io/providers/mongodb/mongodbatlas/latest/docs/resources/project_api_key) and [`mongodbatlas_project_ip_access_list_key`](https://registry.terraform.io/providers/mongodb/mongodbatlas/latest/docs/resources/access_list_api_key)). We have created a dedicated [Programmatic API Key Upgrade Guide](https://registry.terraform.io/providers/mongodb/mongodbatlas/latest/docs/guides/Programmatic-API-Key-upgrade-guide-1.10.0) to help you transition smoothly from the previous version which was first released in Terraform Provider for MongoDB Atlas in v1.8.0 to the new version in v1.10.0.
+
+
+**Deprecations and Removals:**
+- [`mongodbatlas_data_lake`](https://registry.terraform.io/providers/mongodb/mongodbatlas/latest/docs/resources/data_lake) has been deprecated. We will proceed with code removal in future release targeting v1.12.0. This has been replaced with [`mongodbatlas_federated_database_instance`](https://registry.terraform.io/providers/mongodb/mongodbatlas/latest/docs/resources/federated_database_instance) 
+- [`mongodbatlas_privatelink_endpoint_service_adl`](https://registry.terraform.io/providers/mongodb/mongodbatlas/latest/docs/resources/privatelink_endpoint_service_adl) has been deprecated. We will proceed with code removal in future release targeting v1.12.0. This has been replaced with [`mongodbatlas_privatelink_endpoint_service_data_federation_online_archive`](https://registry.terraform.io/providers/mongodb/mongodbatlas/latest/docs/resources/privatelink_endpoint_service_data_federation_online_archive)  
+-  We have removed source code for [`mongodbatlas_private_ip_mode`](https://registry.terraform.io/providers/mongodb/mongodbatlas/latest/docs/resources/private_ip_mode), NEW_RELIC and FLOWDOCK in [`mongodbatlas_third_party_integration`](https://registry.terraform.io/providers/mongodb/mongodbatlas/latest/docs/resources/third_party_integration) resources and data sources, as well as `mongodbatlas_cloud_provider` resources and datas sources including: 
+    -  [`access`](https://registry.terraform.io/providers/mongodb/mongodbatlas/latest/docs/resources/cloud_provider_access)
+    -  [`snapshot`](https://registry.terraform.io/providers/mongodb/mongodbatlas/latest/docs/resources/cloud_provider_snapshot)
+    -  [`snapshot_backup_policy`](https://registry.terraform.io/providers/mongodb/mongodbatlas/latest/docs/resources/cloud_provider_snapshot_backup_policy)
+    -  [`snapshot_restore_job`](https://registry.terraform.io/providers/mongodb/mongodbatlas/latest/docs/resources/cloud_provider_snapshot_restore_job) 
+
+
+1.10.0 also includes other general improvements, bug fixes, and several key documentation updates. See the [CHANGELOG](https://github.com/mongodb/terraform-provider-mongodbatlas/blob/master/CHANGELOG.md) for more specific information.
+
+
+### Helpful Links
+
+* [Report bugs](https://github.com/mongodb/terraform-provider-mongodbatlas/issues)
+
+* [Request Features](https://feedback.mongodb.com/forums/924145-atlas?category_id=370723)
+
+* [Contact Support](https://docs.atlas.mongodb.com/support/) covered by MongoDB Atlas support plans, Developer and above.