doc: Add example for mongodbatlas_cloud_backup_schedule to create policies for multiple clusters (#1403)

Author: maastha

examples/atlas-cloud-backup-schedule/README.md

@@ -0,0 +1,62 @@
+# Example - MongoDB Atlas Cloud Backup Schedule for setting up policies for multiple clusters
+
+This project aims to provide an example of using [Cloud Backup Schedule in Atlas](https://docs.atlas.mongodb.com/reference/api/cloud-backup/schedule/modify-one-schedule/).
+
+
+## Dependencies
+
+* Terraform MongoDB Atlas Provider v1.10.0
+* A MongoDB Atlas account 
+
+```
+Terraform v1.10.0
++ provider registry.terraform.io/terraform-providers/mongodbatlas v1.10.0
+```
+
+## Usage
+
+**1\. Ensure your MongoDB Atlas credentials are set up.**
+
+This can be done using environment variables:
+
+```bash
+export MONGODB_ATLAS_PUBLIC_KEY="xxxx"
+export MONGODB_ATLAS_PRIVATE_KEY="xxxx"
+```
+
+... or follow as in the `variables.tf` file and create **terraform.tfvars** file with all the variable values, ex:
+```
+public_key           = "<MONGODB_ATLAS_PUBLIC_KEY>"
+private_key          = "<MONGODB_ATLAS_PRIVATE_KEY>"
+```
+**2\. Update required variables.**
+Now create/update **terraform.tfvars** file with all the variable values and make sure **not to commit it**. For this example, you just need to provide `org_id` and a `project_name`.
+
+**3\. Review the Terraform plan.**
+
+Execute the below command and ensure you are happy with the plan.
+
+``` bash
+$ terraform plan
+```
+This project currently supports the below deployments:
+
+- MongoDB Atlas Project
+- MongoDB Atlas Clusters (3 AWS M10 clusters in various regions) 
+- MongoDB Cloud Backup Schedule(s) with various policies which is set up for each created cluster.
+
+**5\. Execute the Terraform apply.**
+
+Now execute the plan to provision the Federated settings resources.
+
+``` bash
+$ terraform apply
+```
+
+**6\. Destroy the resources.**
+
+Once you are finished your testing, ensure you destroy the resources to avoid unnecessary Atlas charges.
+
+``` bash
+$ terraform destroy
+```

examples/atlas-cloud-backup-schedule/main.tf

@@ -0,0 +1,76 @@
+locals {
+  atlas_clusters = {
+    "cluster_1" = { name = "m10-aws-1e", region = "US_EAST_1" },
+    "cluster_2" = { name = "m10-aws-2e", region = "US_EAST_2" },
+    "cluster_3" = { name = "m10-aws-3w", region = "US_WEST_1" }
+  }
+}
+
+resource "mongodbatlas_project" "atlas-project" {
+  org_id = var.org_id
+  name   = var.project_name
+}
+
+resource "mongodbatlas_advanced_cluster" "automated_backup_test_cluster" {
+  for_each     = local.atlas_clusters
+  project_id   = mongodbatlas_project.atlas-project.id
+  name         = each.value.name
+  cluster_type = "REPLICASET"
+
+  replication_specs {
+    num_shards = 1
+
+    region_configs {
+      electable_specs {
+        instance_size = "M10"
+        node_count    = 3
+      }
+      analytics_specs {
+        instance_size = "M10"
+        node_count    = 1
+      }
+
+      provider_name = "AWS"
+      region_name   = each.value.region
+      priority      = 7
+    }
+  }
+
+  backup_enabled = true # enable cloud backup snapshots
+}
+
+resource "mongodbatlas_cloud_backup_schedule" "test" {
+  for_each     = local.atlas_clusters
+  project_id   = mongodbatlas_project.atlas-project.id
+  cluster_name = mongodbatlas_advanced_cluster.automated_backup_test_cluster[each.key].name
+
+  reference_hour_of_day    = 3
+  reference_minute_of_hour = 45
+  restore_window_days      = 4
+
+  policy_item_hourly {
+    frequency_interval = 1 #accepted values = 1, 2, 4, 6, 8, 12 -> every n hours
+    retention_unit     = "days"
+    retention_value    = 1
+  }
+  policy_item_daily {
+    frequency_interval = 1 #accepted values = 1 -> every 1 day
+    retention_unit     = "days"
+    retention_value    = 2
+  }
+  policy_item_weekly {
+    frequency_interval = 4 # accepted values = 1 to 7 -> every 1=Monday,2=Tuesday,3=Wednesday,4=Thursday,5=Friday,6=Saturday,7=Sunday day of the week
+    retention_unit     = "weeks"
+    retention_value    = 3
+  }
+  policy_item_monthly {
+    frequency_interval = 5 # accepted values = 1 to 28 -> 1 to 28 every nth day of the month  
+    # accepted values = 40 -> every last day of the month
+    retention_unit  = "months"
+    retention_value = 4
+  }
+
+  depends_on = [
+    mongodbatlas_advanced_cluster.automated_backup_test_cluster
+  ]
+}

examples/atlas-cloud-backup-schedule/provider.tf

@@ -0,0 +1,4 @@
+provider "mongodbatlas" {
+  public_key  = var.public_key
+  private_key = var.private_key
+}

examples/atlas-cloud-backup-schedule/variables.tf

@@ -0,0 +1,16 @@
+variable "public_key" {
+  description = "Public API key to authenticate to Atlas"
+  type        = string
+}
+variable "private_key" {
+  description = "Private API key to authenticate to Atlas"
+  type        = string
+}
+variable "project_name" {
+  description = "Atlas project name"
+  type        = string
+}
+variable "org_id" {
+  description = "Atlas organization ID"
+  type        = string
+}

examples/atlas-cloud-backup-schedule/versions.tf

@@ -0,0 +1,9 @@
+terraform {
+  required_providers {
+    mongodbatlas = {
+      source  = "mongodb/mongodbatlas"
+      version = "~> 1.0"
+    }
+  }
+  required_version = ">= 0.13"
+}