本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。
CreateDBInstance
建立新執行個體。
請求參數
如需所有動作的一般參數資訊，請參閱《Common Parameters》。
- 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 文件資料庫 TLS 憑證和加密傳輸中的資料。
類型：字串
必要：否
- CopyTagsToSnapshot
-
值，指示是否將標籤從資料庫執行個體複製到資料庫執行個體快照。根據預設，不會複製標籤。
類型：布林值
必要：否
- EnablePerformanceInsights
-
指示是否啟用資料庫執行個體績效詳情的值。如需詳細資訊，請參閱使用 Amazon 績效詳情。
類型：布林值
必要：否
- PerformanceInsightsKMSKeyId
-
用於加密 Performance Insights 資料的 AWS KMS 金鑰識別碼。
金 AWS KMS 鑰識別碼是 KMS 金鑰的金鑰 ARN、金鑰識別碼、別名 ARN 或別名。
如果您沒有為 PerformanceInsights KMS 指定值KeyId，則 Amazon DocumentDB 會使用您的預設 KMS 金鑰。您的 Amazon Web Services 帳戶有一個默認的 KMS 密鑰。您的 Amazon Web Services 帳戶對每個亞 Amazon Web Services 區域都有不同的預設 KMS 金鑰。
類型：字串
必要：否
- PreferredMaintenanceWindow
-
每週可能進行系統維護的時間範圍，以國際標準時間 (UTC) 表示。
格式：
ddd:hh24:mi-ddd:hh24:mi預設值是從 8 小時的時間段中隨機選取 30 分鐘的時段 AWS 區域，每個時段出現在一週的隨機日期。
有效日：星期一、星期二、星期三、星期四、星期五、星期六、星期日
限制條件：必須至少是 30 分鐘的時段。
類型：字串
必要：否
- PromotionTier
-
一個值，指定 Amazon DocumentDB 複本在現有主執行個體發生故障後提升為主執行個體的順序。
預設：1
有效值：0 至 15
類型：整數
必要：否
- 標籤. 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 的詳細資訊，請參閱下列內容：
