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

# CreateDBInstance
<a name="API_CreateDBInstance"></a>

创建新的实例。

## 请求参数
<a name="API_CreateDBInstance_RequestParameters"></a>

 有关所有操作的通用参数的信息，请参阅[通用参数](CommonParameters.md)。

 ** 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 证书](https://docs.aws.amazon.com/documentdb/latest/developerguide/ca_cert_rotation.html)和[加密传输中数据](https://docs.aws.amazon.com/documentdb/latest/developerguide/security.encryption.ssl.html)。  
类型：字符串  
必需：否

 ** CopyTagsToSnapshot **   
指示是否将标签从数据库实例复制到数据库实例快照的值。默认情况下，不复制标签。  
类型：布尔值  
必需：否

 ** EnablePerformanceInsights **   
指示是否为数据库实例启用 Performance Insights 的值。有关更多信息，请参阅[使用 Amazon Performance Insights](https://docs.aws.amazon.com/documentdb/latest/developerguide/performance-insights.html)。  
类型：布尔值  
必需：否

 ** PerformanceInsightsKMSKeyId **   
Performance Insights 数据加密的密 AWS KMS 钥标识符。  
 AWS KMS 密钥标识符是 KMS 密钥的密钥 ARN、密钥 ID、别名 ARN 或 KMS 密钥的别名。  
如果您没有为 PerformanceInsights KMSKey ID 指定值，则亚马逊文档数据库将使用您的默认 KMS 密钥。您的 Amazon Web Services 账户有默认 KMS 密钥。您的 Amazon 网络服务账户对每个 Amazon 网络服务区具有不同的默认 KMS 密钥。  
类型：字符串  
必需：否

 ** PreferredMaintenanceWindow **   
每周可以进行系统维护的时间范围（采用通用协调时间 (UTC)）。  
 格式：`ddd:hh24:mi-ddd:hh24:mi`  
默认值是从 8 小时的时间段中随机选择一个 30 分钟的窗口 AWS 区域，出现在一周中的随机某一天。  
有效日：Mon、Tue、Wed、Thu、Fri、Sat、Sun  
约束：至少为 30 分钟的时段。  
类型：字符串  
必需：否

 ** PromotionTier **   
该值指定在现有主实例发生故障后将 Amazon DocumentDB 副本提升为主实例的顺序。  
默认：1  
有效值：0-15  
类型：整数  
必需：否

 **Tags.Tag.N**   
要分配给实例的标签。您可以为每个实例分配最多 10 个标签。  
类型：[Tag](API_Tag.md) 对象数组  
必需：否

## 响应元素
<a name="API_CreateDBInstance_ResponseElements"></a>

服务返回以下元素。

 ** DBInstance **   
有关实例的详细信息。  
类型：[DBInstance](API_DBInstance.md) 对象

## 错误
<a name="API_CreateDBInstance_Errors"></a>

有关所有操作的常见错误的信息，请参阅[常见错误](CommonErrors.md)。

 ** 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

## 另请参阅
<a name="API_CreateDBInstance_SeeAlso"></a>

有关以特定语言之一使用此 API 的更多信息 AWS SDKs，请参阅以下内容：
+  [AWS 命令行界面 V2](https://docs.aws.amazon.com/goto/cli2/docdb-2014-10-31/CreateDBInstance) 
+  [AWS 适用于.NET 的 SDK V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/docdb-2014-10-31/CreateDBInstance) 
+  [AWS 适用于 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/docdb-2014-10-31/CreateDBInstance) 
+  [AWS 适用于 Go v2 的 SDK](https://docs.aws.amazon.com/goto/SdkForGoV2/docdb-2014-10-31/CreateDBInstance) 
+  [AWS 适用于 Java 的 SDK V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/docdb-2014-10-31/CreateDBInstance) 
+  [AWS JavaScript V3 版软件开发工具包](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/docdb-2014-10-31/CreateDBInstance) 
+  [AWS 适用于 Kotlin 的 SDK](https://docs.aws.amazon.com/goto/SdkForKotlin/docdb-2014-10-31/CreateDBInstance) 
+  [AWS 适用于 PHP 的 SDK V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/docdb-2014-10-31/CreateDBInstance) 
+  [AWS Python 软件开发工具包](https://docs.aws.amazon.com/goto/boto3/docdb-2014-10-31/CreateDBInstance) 
+  [AWS 适用于 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/docdb-2014-10-31/CreateDBInstance)