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

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

CreateGlobalCluster

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

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

注意

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

请求参数

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

GlobalClusterIdentifier

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

类型: 字符串

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

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

必需 是

DatabaseName

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

类型: 字符串

必需 否

DeletionProtection

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

类型: Boolean

必需 否

Engine

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

类型: 字符串

必需 否

EngineVersion

全局集群的引擎版本。

类型: 字符串

必需 否

SourceDBClusterIdentifier

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

类型: 字符串

必需 否

StorageEncrypted

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

类型: Boolean

必需 否

响应元素

服务返回以下元素。

GlobalCluster

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

类型:GlobalCluster 对象

错误

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

DBClusterNotFoundFault

DBClusterIdentifier不引用现有集群。

HTTP 状态代码:404

GlobalClusterAlreadyExistsFault

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

HTTP 状态代码:400

GlobalClusterQuotaExceededFault

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

HTTP 状态代码:400

InvalidDBClusterStateFault

集群未处于有效状态。

HTTP 状态代码:400

另请参阅

有关在特定语言的Amazon软件开发工具包中使用此 API 的更多信息,请参阅以下内容: