本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。
CreateDBInstance
创建新的实例。
请求参数
有关所有操作的通用参数的信息，请参阅通用参数。
- DBClusterIdentifier
-
实例所属的集群的标识符。
类型：字符串
必需：是
- DBInstanceClass
-
实例的计算和内存容量；例如，
db.r5.large。类型：字符串
必需：是
- DBInstanceIdentifier
-
实例标识符。该参数作为一个小写字符串存储。
约束：
-
必须包含 1 到 63 个字母、数字或连字符。
-
第一个字符必须是字母。
-
不能以连字符结束或包含两个连续连字符。
例如：
mydbinstance类型：字符串
必需：是
-
- Engine
-
要用于此实例的数据库引擎的名称。
有效值：
docdb类型：字符串
必需：是
- AutoMinorVersionUpgrade
-
此参数不适用于 Amazon DocumentDB。无论设置的值如何，Amazon DocumentDB 都不会执行次要版本升级。
默认：
false类型：布尔值
必需：否
- AvailabilityZone
-
在其中创建了实例的 Amazon EC2 可用区。
默认值：端点的 AWS 区域 中系统随机选择的可用区。
例如：
us-east-1d类型：字符串
必需：否
- CACertificateIdentifier
-
用于数据库实例服务器证书的 CA 证书标识符。
有关更多信息，请参阅 Amazon DocumentDB 开发人员指南中更新您的 Amazon DocumentDB TLS 证书和加密传输中数据。
类型：字符串
必需：否
- CopyTagsToSnapshot
-
指示是否将标签从数据库实例复制到数据库实例快照的值。默认情况下，不复制标签。
类型：布尔值
必需：否
- EnablePerformanceInsights
-
指示是否为数据库实例启用 Performance Insights 的值。有关更多信息，请参阅使用 Amazon Performance Insights。
类型：布尔值
必需：否
- PerformanceInsightsKMSKeyId
-
用于加密 Performance Insights 数据的 AWS KMS 密钥标识符。
AWS KMS 密钥标识符是密钥 ARN、密钥 ID、别名 ARN 或者 KMS 密钥的别名。
如果您没有为 PerformanceInsightsKMSKeyId 指定值，则 Amazon DocumentDB 将使用您的默认 KMS 密钥。您的 Amazon Web Services 账户有默认 KMS 密钥。您的 Amazon 网络服务账户对每个 Amazon 网络服务区具有不同的默认 KMS 密钥。
类型：字符串
必需：否
- PreferredMaintenanceWindow
-
每周可以进行系统维护的时间范围（采用通用协调时间 (UTC)）。
格式：
ddd:hh24:mi-ddd:hh24:mi默认值为每个 AWS 区域 8 小时的时间段中随机选择的 30 分钟时段（随机选取周中的某天进行）。
有效日：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
-
访问 AWS KMS 密钥时发生错误。
HTTP 状态代码：400
- StorageQuotaExceeded
-
该请求会导致您超出跨所有实例可提供的已允许存储量。
HTTP 状态代码：400
- StorageTypeNotSupported
-
指定的
StorageType存储无法与数据库实例关联。HTTP 状态代码：400
另请参阅
有关在特定语言的 AWS SDK 中使用此 API 的更多信息，请参阅以下内容：
