本文属于机器翻译版本。若本译文内容与英语原文存在差异,则一律以英文原文为准。
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 的更多信息,请参阅以下内容: