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

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

CreateDBInstance

创建新实例。

请求参数

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

DBClusterIdentifier

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

类型: 字符串

必填 是

DBInstanceClass

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

类型: 字符串

必填 是

DBInstanceIdentifier

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

约束:

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

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

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

示例:mydbinstance

类型: 字符串

必填 是

Engine

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

有效值:docdb

类型: 字符串

必填 是

AutoMinorVersionUpgrade

此参数不适用于 Amazon DocumentDB。无论设置的值如何,Amazon DocumentDB 都不会执行次要版本升级。

默认值:false

类型: 布尔值

必填 否

AvailabilityZone

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

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

示例:us-east-1d

类型: 字符串

必填 否

CopyTagsToSnapshot

指示是否将标签从数据库实例复制到数据库实例快照的值。默认情况下,不复制标签。

类型: 布尔值

必填 否

EnablePerformanceInsights

指示是否为数据库实例启用 Performance Insights。有关更多信息,请参阅 。使用亚马逊Performance Insights.

类型: 布尔值

必填 否

PerformanceInsightsKMSKeyId

用于加密 Performance Insights 数据的 Amazon KMS 密钥标识符。

这些区域有:Amazon KMS密钥标识符是密钥 ARN、密钥 ID、别名 ARN 或者 KMS 密钥的别名。

如果您未指定值 PerformanceInsights自杀KeyId然后 Amazon DocumentDB 将使用您的默认 KMS 密钥。您的Amazon Web Services 科技账户拥有默认。您的Amazon Web Services 账户在每个Amazon Web Services 云科技区域都有不同的默认 KMS 密钥。

类型: 字符串

必填 否

PreferredMaintenanceWindow

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

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

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

有效值:Mon、Fri、Fri、Fri、Fri、Fri、Fri、Th

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

类型: 字符串

必填 否

PromotionTier

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

默认值:1

有效值:0-15

类型: 整数

必填 否

Tags.Tag.N

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

类型: 数组Tag对象

必填 否

响应元素

以下元素由服务返回。

DBInstance

有关实例的详细信息。

类型:DBInstance 对象

错误

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

AuthorizationNotFound

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

Amazon DocumentDB B 也可能无权使用 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 的更多信息,请参阅以下内容: