aws docdb create-global-cluster
Creates an Amazon DocumentDB global cluster that can span multiple multiple Amazon Web Services Regions. AWS CLI reference
1 example 7 options Its page in the AWS CLI reference
Examples
To create a global DB cluster
The following create-global-cluster example creates an Amazon DocumentDB global DB cluster that uses the specified cluster as its primary cluster.
aws docdb create-global-cluster --global-cluster-identifier docdb-global-cluster --source-db-cluster-identifier arn:aws:rds:us-west-2:123456789012:cluster:docdb-primary-clusterIdentify--global-cluster-identifierThe cluster identifier of the new global cluster.--source-db-cluster-identifierThe Amazon Resource Name (ARN) to use as the primary cluster of the global cluster.Its output
{
"GlobalCluster": {
"GlobalClusterIdentifier": "docdb-global-cluster",
"GlobalClusterResourceId": "cluster-a1b2c3d4e5f6a7b8",
"GlobalClusterArn": "arn:aws:rds::123456789012:global-cluster:docdb-global-cluster",
"Status": "available",
"Engine": "docdb",
"EngineVersion": "8.0.0",
"StorageEncrypted": true,
"DeletionProtection": false,
"GlobalClusterMembers": [
{
"DBClusterArn": "arn:aws:rds:us-west-2:123456789012:cluster:docdb-primary-cluster",
"Readers": [],
"IsWriter": true,
"SynchronizationStatus": "connected"
}
],
"TagList": []
}
}For more information, see Creating an Amazon DocumentDB global cluster in the Amazon DocumentDB Developer Guide.
Options
--database-nameThe name for your database of up to 64 alpha-numeric characters.--deletion-protectionThe deletion protection setting for the new global cluster.--engine-versionThe engine version of the global cluster.--engineThe name of the database engine to be used for this cluster.--global-cluster-identifierThe cluster identifier of the new global cluster.--source-db-cluster-identifierThe Amazon Resource Name (ARN) to use as the primary cluster of the global cluster.--storage-encryptedThe storage encryption setting for the new global cluster.