CreateGlobalCluster - Amazon DocumentDB
Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异,请参阅中国的 Amazon Web Services 服务入门

本文属于机器翻译版本。若本译文内容与英语原文存在差异,则一律以英文原文为准。

CreateGlobalCluster

创建一个 Amazon DocumentDB 全局集群,该集群可以跨越多个 Amazon Web Services 区域 。全局群集包含一个具有读写功能的主群集,以及向上提供只读辅助群集。全局群集使用基于存储的快速复制,延迟时间不到一秒,使用专用基础架构,而不会影响您的工作负载的性能。

您可以创建最初为空的全局集群,然后向其中添加主集群和辅助集群。或者,您可以在创建操作期间指定现有集群,并且此集群将成为全局集群的主集群。

注意

此操作仅适用于 Amazon DocumentDBCluster 集群。

请求参数

有关所有操作通用的参数的信息,请参阅常见参数

GlobalClusterIdentifier

新全局集群的集群标识符。

类型: 字符串

长度约束:最小长度为 1。长度上限为 255。

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

:必需 是

DatabaseName

数据库的名称,最多 64 个字母和数字字符。如果您不提供名称,Amazon DocumentDB 就不会在您正在创建的全局集群中创建数据库。

类型: 字符串

:必需 否

DeletionProtection

新全局集群的删除保护设置。在启用删除保护时,无法删除全局集群。

类型: Boolean

:必需 否

Engine

要用于此集群的数据库引擎的名称。

类型: 字符串

:必需 否

EngineVersion

全局集群的引擎版本。

类型: 字符串

:必需 否

SourceDBClusterIdentifier

用作全局集群的主集群的 Amazon 资源名称 (ARN)。此参数为可选项。

类型: 字符串

:必需 否

StorageEncrypted

新全局集群的存储加密设置。

类型: Boolean

:必需 否

响应元素

服务返回以下元素。

全局集群

表示 Amazon DocumentDB 全局集群的数据类型。

类型:GlobalCluster 对象

Errors

有关所有操作常见错误的信息,请参阅常见错误

DBClusterNotFoundFault

DBClusterIdentifier不引用现有集群。

HTTP 状态代码:404

全局群集已准备就绪存在错误

这些区域有:GlobalClusterIdentifier已存在。选择新的全局集群标识符(唯一名称)以创建新的全局集群。

HTTP 状态代码:400

全局群集配额超出错误

此帐户的全局集群数量已达到允许的最大数量。

HTTP 状态代码:400

InvalidDBClusterStateFault

集群未处于有效状态。

HTTP 状态代码:400