本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。
CreateGlobalCluster
创建可以跨多个 Amazon Web Services 区域 的 Amazon DocumentDB 全局集群。该全局群集包含一个具有读写能力的主集群和只读辅助群集。全球集群使用基于存储的跨区域快速复制，延迟小于一秒，使用专用基础设施，不影响您的工作负载性能。
您可以创建最初为空的全局集群，然后向其中添加主集群和辅助集群。或者，您可以在创建操作期间指定现有集群，而这个集群将成为全局群集的主集群。
注意
该操作仅适用于 Amazon DocumentDB 集群。
请求参数
有关所有操作的通用参数的信息，请参阅通用参数。
- GlobalClusterIdentifier
-
新全局集群的集群标识符。
类型：字符串
长度限制：最小长度为 1。最大长度为 255。
模式：
[A-Za-z][0-9A-Za-z-:._]*必需：是
- DatabaseName
-
数据库的名称，最多 64 个字母和数字字符。如果您不提供名称，Amazon DocumentDB 就不会在您正在创建的全局集群中创建数据库。
类型：字符串
必需：否
- DeletionProtection
-
新全局集群的删除保护设置。在启用删除保护时，无法删除全局集群。
类型：布尔值
必需：否
- Engine
-
用于此集群的数据库引擎的名称。
类型：字符串
必需：否
- EngineVersion
-
全局集群的引擎版本。
类型：字符串
必需：否
- SourceDBClusterIdentifier
-
要用作全局集群的主集群的 Amazon 资源名称（ARN）。此参数为可选的。
类型：字符串
必需：否
- StorageEncrypted
-
新全局集群的存储加密设置。
类型：布尔值
必需：否
响应元素
服务返回以下元素。
- GlobalCluster
-
一种表示 Amazon DocumentDB 全球集群的数据类型。
类型：GlobalCluster 对象
错误
有关所有操作的常见错误的信息，请参阅常见错误。
- DBClusterNotFoundFault
-
DBClusterIdentifier并不引用现有集群。HTTP 状态代码：404
- GlobalClusterAlreadyExistsFault
-
GlobalClusterIdentifier已经存在。选择一个新的全局群集标识符（唯一名称）创建新的全局群集。HTTP 状态代码：400
- GlobalClusterQuotaExceededFault
-
该账户的全局集群数目已处于允许的最大值。
HTTP 状态代码：400
- InvalidDBClusterStateFault
-
集群未处于有效状态。
HTTP 状态代码：400
另请参阅
有关在特定语言的 Amazon SDK 中使用此 API 的更多信息，请参阅以下内容：