本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。
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类型：字符串
必需：否
- CACertificateIdentifier
-
用于数据库实例服务器证书的 CA 证书标识符。
有关更多信息，请参阅 Amazon DocumentDB 开发人员指南中更新您的 Amazon DocumentDB TLS 证书和加密传输中数据。
类型：字符串
必需：否
- CopyTagsToSnapshot
-
指示是否将标签从数据库实例复制到数据库实例快照的值。默认情况下，不复制标签。
类型：布尔值
必需：否
- EnablePerformanceInsights
-
指示是否为数据库实例启用 Performance Insights 的值。有关更多信息，请参阅使用 Amazon Performance Insights。
类型：布尔值
必需：否
- PerformanceInsightsKMSKeyId
-
Performance Insights 数据加密的密 Amazon KMS 钥标识符。
Amazon KMS 密钥标识符是 KMS 密钥的密钥 ARN、密钥 ID、别名 ARN 或 KMS 密钥的别名。
如果您没有为 PerformanceInsights KMS 指定值KeyId，则亚马逊文档数据库将使用您的默认 KMS 密钥。您的 Amazon Web Services 账户有默认 KMS 密钥。您的 Amazon 网络服务账户对每个 Amazon 网络服务区具有不同的默认 KMS 密钥。
类型：字符串
必需：否
- PreferredMaintenanceWindow
-
每周可以进行系统维护的时间范围（采用通用协调时间 (UTC)）。
格式：
ddd:hh24:mi-ddd:hh24:mi默认值是从 8 小时的时间段中随机选择一个 30 分钟的窗口 Amazon Web Services 区域，出现在一周中的随机某一天。
有效日：Mon、Tue、Wed、Thu、Fri、Sat、Sun
约束：至少为 30 分钟的时段。
类型：字符串
必需：否
- PromotionTier
-
该值指定在现有主实例发生故障后将 Amazon DocumentDB 副本提升为主实例的顺序。
默认值：1
有效值：0-15
类型：整数
必需：否
- Tags.Tag.N
-
要分配给实例的标签。您可以为每个实例分配最多 10 个标签。
类型：Tag 对象数组
必需：否
响应元素
服务返回以下元素。
- DBInstance
-
有关实例的详细信息。
类型：DBInstance 对象
错误
有关所有操作的常见错误的信息，请参阅常见错误。
- 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 SDK 中使用此 API 的更多信息，请参阅以下内容：