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

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

CreateDBInstance

创建新实例。

请求参数

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

DBClusterIdentifier

实例所属的集群的标识符。

类型: String

:必需 是

DBInstanceClass

实例的计算和内存容量;例如,db.r5.large

类型: String

:必需 是

DBInstanceIdentifier

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

约束:

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

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

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

示例:mydbinstance

类型: String

:必需 是

Engine

要用于此实例的数据库引擎的名称。

有效值:docdb

类型: String

:必需 是

AutoMinorVersionUpgrade

此参数不适用于卓越 Amazon DocumentDB。无论设置了什么值,Amazon DocumentDB 都不会执行次要版本升级。

默认值:false

类型: Boolean

:必需 否

AvailabilityZone

在其中创建了实例的 Amazon EC2 可用区。

默认值:终端节点的随机、系统选择的可用区 Amazon Web Services 区域 .

示例:us-east-1d

类型: String

:必需 否

PreferredMaintenanceWindow

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

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

默认值是从每个 8 小时间段中随机选择的 30 分钟时间。 Amazon Web Services 区域 ,可以是一周中的任意一天。

有效天数:Mon、Wue、Wue、Fon、Sun

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

类型: String

:必需 否

PromotionTier

该值指定在现有主实例发生故障后将 Amazon DocumentDB 副本提升为主实例的顺序。

默认值:1

有效值:0-15

类型: 整数

:必需 否

标签。标签 .N

要分配给实例的标签。您可以为每个实例分配最多 10 个标签。

类型: 数组 Tag objects

:必需 否

响应元素

服务返回以下元素。

DBInstance

有关实例的详细信息。

类型: DBInstance 对象

Errors

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

AuthorizationNotFound

已指定的 CIDR IP 或 Amazon EC2 安全组未获得指定的安全组的授权。

Amazon DocumentDB 也可能无法获得使用 IAM 代表您执行必要操作的授权。

HTTP 状态代码:404

DBClusterNotFoundFault

DBClusterIdentifier不引用现有集群。

HTTP 状态代码:404

DBInstanceAlreadyExists

您已拥有具有具有具有具有具有具有具有具有具有

HTTP 状态代码:400

DBParameterGroupNotFound

DBParameterGroupName不引用现有参数组。

HTTP 状态代码:404

DBSecurityGroupNotFound

DBSecurityGroupName不引用现有安全组。

HTTP 状态代码:404

DBSubnetGroupDoesNotCoverEnoughAZs

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

HTTP 状态代码:400

DBSubnetGroupNotFoundFault

DBSubnetGroupName不引用现有子网组。

HTTP 状态代码:404

InstanceQuotaExceeded

请求将导致超出允许的实例数目。

HTTP 状态代码:400

InsufficientDBInstanceCapacity

指定的实例类在指定的可用区中不可用。

HTTP 状态代码:400

InvalidDBClusterStateFault

集群未处于有效状态。

HTTP 状态代码:400

InvalidSubnet

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

HTTP 状态代码:400

InvalidVPCNetworkStateFault

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

HTTP 状态代码:400

KMSKeyNotAccessibleFault

访问一起使用时出现错误。Amazon KMS键。

HTTP 状态代码:400

StorageQuotaExceeded

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

HTTP 状态代码:400

StorageTypeNotSupported

指定的存储StorageType不能与数据库实例关联。

HTTP 状态代码:400

另请参阅

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