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

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

CreateDBCluster

创建新的 Amazon DocumentDB 集群。

请求参数

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

DBClusterIdentifier

集群标识符。该参数作为一个小写字符串存储。

约束:

  • 必须包含 1 到 63 个字母、数字或连字符。

  • 第一个字符必须是字母。

  • 不能以连字符结束或包含两个连续连字符。

例如:my-cluster

类型: 字符串

:必需 是

Engine

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

有效值:docdb

类型: 字符串

:必需 是

MasterUsername

集群的主用户名称。

约束:

  • 必须为 1 到 63 个字母或数字。

  • 第一个字符必须是字母。

  • 不能是所选数据库引擎的保留字。

类型: 字符串

:必需 是

MasterUserPassword

主数据库用户的密码。此密码可以包含除正斜杠 (/)、双引号 (") 或 @ 符号之外的任何可打印的 ASCII 字符。

约束:必须包含 8 到 100 个字符。

类型: 字符串

:必需 是

可用性区域。可用性区。n

可在其中创建集群中的实例的 Amazon EC2 可用区的列表。

类型: 字符串数组

:必需 否

BackupRetentionPeriod

自动备份的保留天数。您必须指定最小值 1。

默认值:1

约束:

  • 必须为介于 1 和 35 之间的值。

类型: 整数

:必需 否

DBClusterParameterGroupName

要与此集群关联的集群参数组的名称。

类型: 字符串

:必需 否

DBSubnetGroupName

要与此集群关联的子网组。

约束:必须与现有 DBSubnetGroup 的名称匹配。不能是默认值。

例如:mySubnetgroup

类型: 字符串

:必需 否

DeletionProtection

指定是否可以删除此集群。如果DeletionProtection,则无法删除集群,除非集群被修改并DeletionProtection已禁用。DeletionProtection防止意外删除集群。

类型: Boolean

:必需 否

启用观察日志性别端口。成员。n

需要启用以导出到 Amazon CloudWatch Logs 的日志类型的列表。您可以启用审核日志或分析器日志。有关更多信息,请参阅 。审核 Amazon DocumentDB 事件分析 Amazon DocumentDB 操作

类型: 字符串数组

:必需 否

EngineVersion

要使用的数据库引擎的版本号。--engine-version 将默认为最新的主引擎版本。对于生产工作负载,我们建议使用预期的主引擎版本明确声明此参数。

类型: 字符串

:必需 否

KmsKeyId

已加密集群的 AWS KMS 密钥标识符。

AWS KMS 密钥标识符是 AWS KMS 加密密钥的 Amazon 资源名称 (ARN)。如果使用拥有用于加密新集群的 AWS KMS 加密密钥的同一 AWS 账户创建集群,则可以使用 AWS KMS 密钥别名而不是 AWS KMS 加密密钥的 ARN。

未在 KmsKeyId 中指定加密密钥时:

  • 如果 StorageEncrypted 参数为 true,则 Amazon DocumentDB 将使用您的默认加密密钥。

AWS KMS 将为您的 AWS 账户创建默认加密密钥。您的 AWS 账户在每个 AWS 区域都有一个不同的默认加密密钥。

类型: 字符串

:必需 否

端口

集群中的实例接受连接的端口号。

类型: 整数

:必需 否

PreferredBackupWindow

使用 BackupRetentionPeriod 参数启用了自动备份时,自动执行备份的日常时间范围。

默认值是从每个 AWS 区域的 8 小时时间段中随机选择的 30 分钟时间。

约束:

  • 必须采用 hh24:mi-hh24:mi 格式。

  • 必须采用通用协调时间 (UTC)。

  • 不得与首选维护时段冲突。

  • 必须至少为 30 分钟。

类型: 字符串

:必需 否

PreferredMaintenanceWindow

可进行系统维护的每周时间范围(采用通用协调时间 (UTC))。

格式:ddd:hh24:mi-ddd:hh24:mi

默认值是每个 AWS 区域 8 小时的时间段中随机选择的 30 分钟时段(随机选取周中的某天进行)。

有效天:Mon、Tue、Wue、Tue、Tue、Tue、Fat、Sun

约束:至少为 30 分钟的时段。

类型: 字符串

:必需 否

PreSignedUrl

当前不支持。

类型: 字符串

:必需 否

StorageEncrypted

指定集群是否已加密。

类型: Boolean

:必需 否

标签。标签 .N

要分配给集群的标签。

类型: 数组数组Tagobjects

:必需 否

VPC 安全组。VPC 安全组。n

要与此集群关联的 EC2 VPC 安全组的列表。

类型: 字符串数组

:必需 否

响应元素

服务返回以下元素。

DBCluster

有关集群的详细信息。

类型:DBCluster 对象

Errors

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

DBClusterAlreadyExistsFault

您已拥有具有给定标识符的集群。

HTTP 状态代码:400

DBClusterNotFoundFault

DBClusterIdentifier不引用现有集群。

HTTP 状态代码:404

未找到数据库集群参数组

DBClusterParameterGroupName不引用现有集群参数组。

HTTP 状态代码:404

DBClusterQuotaExceededFault

无法创建集群,因为您已达到允许的最大集群配额。

HTTP 状态代码:403

找到迪宾斯坦森

DBInstanceIdentifier不引用现有实例。

HTTP 状态代码:404

DBSubnetGroupDoesNotCoverEnoughAZs

除非只有一个可用区,否则子网应至少包含两个可用区。

HTTP 状态代码:400

DBSubnetGroupNotFoundFault

DBSubnetGroupName不引用现有子网组。

HTTP 状态代码:404

存储容量不足

当前操作没有足够的可用存储空间。通过更新子网组来使用具有更多可用存储空间的不同可用区,可以解决此错误。

HTTP 状态代码:400

InvalidDBClusterStateFault

集群未处于有效状态。

HTTP 状态代码:400

无法生效的国家

指定的实例不在available状态。

HTTP 状态代码:400

InvalidDBSubnetGroupStateFault

无法删除子网组,因为它正在使用中。

HTTP 状态代码:400

InvalidSubnet

请求的子网无效,或者请求的多个子网并非全部位于同一个常见虚拟私有云 (VPC) 中。

HTTP 状态代码:400

InvalidVPCNetworkStateFault

由于所做的更改,子网组在创建后并不会覆盖所有可用区。

HTTP 状态代码:400

KMSKeyNotAccessibleFault

访问 AWS KMS 密钥时发生错误。

HTTP 状态代码:400

已超出存储时间

请求将导致您超过所有实例中可用的允许存储量。

HTTP 状态代码:400

另请参阅

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