1**To restore an Amazon DocumentDB cluster from an automatic or manual snapshot**
2
3The following ``restore-db-cluster-from-snapshot`` example creates a new Amazon DocumentDB cluster named ``sample-cluster-2019-03-16-00-01-restored`` from the snapshot ``rds:sample-cluster-2019-03-16-00-01``. ::
4
5    aws docdb restore-db-cluster-from-snapshot \
6        --db-cluster-identifier sample-cluster-2019-03-16-00-01-restored \
7        --engine docdb \
8        --snapshot-identifier rds:sample-cluster-2019-03-16-00-01
9
10Output::
11
12    {
13        "DBCluster": {
14            "ClusterCreateTime": "2019-03-19T18:45:01.857Z",
15            "HostedZoneId": "ZNKXH85TT8WVW",
16            "Engine": "docdb",
17            "DBClusterMembers": [],
18            "MultiAZ": false,
19            "AvailabilityZones": [
20                "us-west-2a",
21                "us-west-2c",
22                "us-west-2b"
23            ],
24            "StorageEncrypted": false,
25            "ReaderEndpoint": "sample-cluster-2019-03-16-00-01-restored.cluster-ro-corcjozrlsfc.us-west-2.docdb.amazonaws.com",
26            "Endpoint": "sample-cluster-2019-03-16-00-01-restored.cluster-corcjozrlsfc.us-west-2.docdb.amazonaws.com",
27            "Port": 27017,
28            "PreferredBackupWindow": "00:00-00:30",
29            "DBSubnetGroup": "default",
30            "DBClusterIdentifier": "sample-cluster-2019-03-16-00-01-restored",
31            "PreferredMaintenanceWindow": "sat:04:30-sat:05:00",
32            "DBClusterArn": "arn:aws:rds:us-west-2:123456789012:cluster:sample-cluster-2019-03-16-00-01-restored",
33            "DBClusterParameterGroup": "default.docdb3.6",
34            "DbClusterResourceId": "cluster-XOO46Q3RH4LWSYNH3NMZKXPISU",
35            "MasterUsername": "master-user",
36            "EngineVersion": "3.6.0",
37            "BackupRetentionPeriod": 3,
38            "AssociatedRoles": [],
39            "Status": "creating",
40            "VpcSecurityGroups": [
41                {
42                    "Status": "active",
43                    "VpcSecurityGroupId": "sg-77186e0d"
44                }
45            ]
46        }
47    }
48
49
50For more information, see `Restoring from a Cluster Snapshot <https://docs.aws.amazon.com/documentdb/latest/developerguide/backup-restore.restore-from-snapshot.html>`__ in the *Amazon DocumentDB Developer Guide*.
51