CreateGlobalCluster - Amazon Neptune
Services or capabilities described in Amazon Web Services documentation might vary by Region. To see the differences applicable to the China Regions, see Getting Started with Amazon Web Services in China (PDF).


Creates a Neptune global database spread across multiple Amazon Regions. The global database contains a single primary cluster with read-write capability, and read-only secondary clusters that receive data from the primary cluster through high-speed replication performed by the Neptune storage subsystem.

You can create a global database that is initially empty, and then add a primary cluster and secondary clusters to it, or you can specify an existing Neptune cluster during the create operation to become the primary cluster of the global database.

Request Parameters

For information about the parameters that are common to all actions, see Common Parameters.


The deletion protection setting for the new global database. The global database can't be deleted when deletion protection is enabled.

Type: Boolean

Required: No


The name of the database engine to be used in the global database.

Valid values: neptune

Type: String

Required: No


The Neptune engine version to be used by the global database.

Valid values: or above.

Type: String

Required: No


The cluster identifier of the new global database cluster.

Type: String

Length Constraints: Minimum length of 1. Maximum length of 255.

Pattern: [A-Za-z][0-9A-Za-z-:._]*

Required: Yes


(Optional) The Amazon Resource Name (ARN) of an existing Neptune DB cluster to use as the primary cluster of the new global database.

Type: String

Required: No


The storage encryption setting for the new global database cluster.

Type: Boolean

Required: No

Response Elements

The following element is returned by the service.


Contains the details of an Amazon Neptune global database.

This data type is used as a response element for the CreateGlobalCluster, DescribeGlobalClusters, ModifyGlobalCluster, DeleteGlobalCluster, FailoverGlobalCluster, and RemoveFromGlobalCluster actions.

Type: GlobalCluster object


For information about the errors that are common to all actions, see Common Errors.


DBClusterIdentifier does not refer to an existing DB cluster.

HTTP Status Code: 404


The GlobalClusterIdentifier already exists. Choose a new global database identifier (unique name) to create a new global database cluster.

HTTP Status Code: 400


The number of global database clusters for this account is already at the maximum allowed.

HTTP Status Code: 400


The DB cluster is not in a valid state.

HTTP Status Code: 400

See Also

For more information about using this API in one of the language-specific Amazon SDKs, see the following: