Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
# CreateDBInstance
Membuat instans baru.
## Parameter Permintaan
Untuk informasi tentang parameter yang umum untuk semua tindakan, lihat [Parameter Umum](CommonParameters.md).
** DBClusterIdentifier **
Pengidentifikasi klaster tempat instans akan berada.
Tipe: String
Diperlukan: Ya
** DBInstanceClass **
Kapasitas komputasi dan memori instans; misalnya, `db.r5.large`.
Tipe: String
Diperlukan: Ya
** DBInstanceIdentifier **
Pengidentifikasi instans. Parameter ini disimpan sebagai string huruf kecil.
Batas:
+ Harus berisi 1 hingga 63 huruf, angka, atau tanda hubung.
+ Karakter pertama harus berupa surat.
+ Tidak dapat diakhiri dengan tanda hubung atau mengandung dua tanda hubung berturut-turut.
Contoh: `mydbinstance`
Tipe: String
Diperlukan: Ya
** Engine **
Nama mesin basis data yang akan digunakan untuk instans ini.
Nilai valid: `docdb`
Tipe: String
Diperlukan: Ya
** AutoMinorVersionUpgrade **
Parameter ini tidak berlaku untuk Amazon DocumentDB. Amazon DocumentDB tidak melakukan peningkatan versi minor terlepas dari nilai yang ditetapkan.
Default: `false`
Jenis: Boolean
Wajib: Tidak
** AvailabilityZone **
Availability Zone Amazon EC2 tempat instans dibuat.
Default: Availability Zone acak yang dipilih sistem di titik akhir. Wilayah AWS
Contoh: `us-east-1d`
Tipe: String
Wajib: Tidak
** CACertificateIdentifier **
Pengidentifikasi sertifikat CA yang akan digunakan untuk sertifikat server instans DB.
*Untuk informasi selengkapnya, lihat [Memperbarui Sertifikat Amazon DocumentDB TLS Anda](https://docs.aws.amazon.com/documentdb/latest/developerguide/ca_cert_rotation.html) [dan Mengenkripsi Data dalam Transit di](https://docs.aws.amazon.com/documentdb/latest/developerguide/security.encryption.ssl.html) Panduan Pengembang Amazon DocumentDB.*
Tipe: String
Wajib: Tidak
** CopyTagsToSnapshot **
Nilai yang menunjukkan apakah akan menyalin tanda dari instans DB untuk snapshot instans DB. Secara default, tanda tidak disalin.
Tipe: Boolean
Wajib: Tidak
** EnablePerformanceInsights **
Nilai yang menunjukkan apakah akan mengaktifkan Performance Insights untuk Instans DB. Untuk informasi selengkapnya, lihat [Menggunakan Amazon Performance Insights](https://docs.aws.amazon.com/documentdb/latest/developerguide/performance-insights.html).
Tipe: Boolean
Wajib: Tidak
** PerformanceInsightsKMSKeyId **
Pengenal AWS KMS kunci untuk enkripsi data Performance Insights.
Pengidentifikasi AWS KMS kunci adalah kunci ARN, ID kunci, alias ARN, atau nama alias untuk kunci KMS.
Jika Anda tidak menentukan nilai untuk PerformanceInsights KMSKey Id, maka Amazon DocumentDB menggunakan kunci KMS default Anda. Ada kunci KMS default untuk akun Amazon Web Services Anda. Akun Amazon Web Services Anda memiliki kunci KMS default yang berbeda untuk setiap wilayah Amazon Web Services.
Tipe: String
Wajib: Tidak
** PreferredMaintenanceWindow **
Rentang waktu setiap minggu untuk melakukan pemeliharaan sistem, dalam Waktu Universal Terkoordinasi (UTC).
Format: `ddd:hh24:mi-ddd:hh24:mi`
Defaultnya adalah jendela 30 menit yang dipilih secara acak dari blok waktu 8 jam untuk masing-masing Wilayah AWS, terjadi pada hari acak dalam seminggu.
Hari yang valid: Sen, Sel, Rab, Kam, Jum, Sab, Min
Kendala: Minimum 30 menit jendela.
Tipe: String
Wajib: Tidak
** PromotionTier **
Nilai yang menentukan urutan di mana replika Amazon DocumentDB dipromosikan ke instans primer setelah kegagalan instans primer yang ada.
Default: 1
Nilai yang valid: 0-15
Tipe: Integer
Wajib: Tidak
**Tags.Tag.N**
Tag yang akan ditetapkan ke instans. Anda dapat menetapkan hingga 10 tag ke sebuah instans.
Tipe: Array objek [Tag](API_Tag.md)
Wajib: Tidak
## Elemen Respons
Elemen berikut dikembalikan oleh layanan.
** DBInstance **
Informasi mendetail tentang sebuah instans.
Tipe: Objek [DBInstance](API_DBInstance.md)
## Kesalahan
Untuk informasi tentang kesalahan yang umum untuk semua tindakan, lihat [Kesalahan Umum](CommonErrors.md).
** AuthorizationNotFound **
Grup keamanan CIDR IP atau Amazon EC2 yang ditentukan tidak diotorisasi untuk grup keamanan yang ditentukan.
Amazon DocumentDB juga mungkin tidak diizinkan untuk melakukan tindakan yang diperlukan atas nama Anda menggunakan IAM.
Kode Status HTTP: 404
** DBClusterNotFoundFault **
`DBClusterIdentifier` tidak mengacu ke sebuah klaster yang ada.
Kode Status HTTP: 404
** DBInstanceAlreadyExists **
Anda sudah memiliki instans dengan pengidentifikasi yang diberikan.
Kode Status HTTP: 400
** DBParameterGroupNotFound **
`DBParameterGroupName` tidak mengacu ke grup parameter yang ada.
Kode Status HTTP: 404
** DBSecurityGroupNotFound **
`DBSecurityGroupName` tidak mengacu ke grup keamanan yang ada.
Kode Status HTTP: 404
** DBSubnetGroupDoesNotCoverEnoughAZs **
Subnet dalam grup subnet harus mencakup setidaknya dua Availability Zone kecuali hanya ada satu Availability Zone.
Kode Status HTTP: 400
** DBSubnetGroupNotFoundFault **
`DBSubnetGroupName` tidak mengacu ke grup subnet yang ada.
Kode Status HTTP: 404
** InstanceQuotaExceeded **
Permintaan akan menyebabkan Anda melebihi jumlah instans yang diizinkan.
Kode Status HTTP: 400
** InsufficientDBInstanceCapacity **
Kelas instans yang ditentukan tidak tersedia di Availability Zone yang ditentukan.
Kode Status HTTP: 400
** InvalidDBClusterStateFault **
Klaster tidak dalam status valid.
Kode Status HTTP: 400
** InvalidSubnet **
Subnet yang diminta tidak valid, atau beberapa subnet yang diminta tidak semuanya berada dalam virtual private cloud (VPC) yang umum.
Kode Status HTTP: 400
** InvalidVPCNetworkStateFault **
Grup subnet tidak mencakup semua Availability Zone setelah dibuat karena perubahan yang dibuat.
Kode Status HTTP: 400
** KMSKeyNotAccessibleFault **
Terjadi kesalahan saat mengakses AWS KMS kunci.
Kode Status HTTP: 400
** StorageQuotaExceeded **
Permintaan akan menyebabkan Anda melebihi jumlah penyimpanan yang diizinkan yang tersedia di semua instans.
Kode Status HTTP: 400
** StorageTypeNotSupported **
Penyimpanan `StorageType` yang ditentukan tidak dapat dikaitkan dengan instans DB.
Kode Status HTTP: 400
## Lihat Juga
Untuk informasi selengkapnya tentang penggunaan API ini di salah satu bahasa khusus AWS SDKs, lihat berikut ini:
+ [AWS Antarmuka Baris Perintah V2](https://docs.aws.amazon.com/goto/cli2/docdb-2014-10-31/CreateDBInstance)
+ [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/docdb-2014-10-31/CreateDBInstance)
+ [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/docdb-2014-10-31/CreateDBInstance)
+ [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/docdb-2014-10-31/CreateDBInstance)
+ [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/docdb-2014-10-31/CreateDBInstance)
+ [AWS SDK untuk V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/docdb-2014-10-31/CreateDBInstance)
+ [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/docdb-2014-10-31/CreateDBInstance)
+ [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/docdb-2014-10-31/CreateDBInstance)
+ [AWS SDK untuk Python](https://docs.aws.amazon.com/goto/boto3/docdb-2014-10-31/CreateDBInstance)
+ [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/docdb-2014-10-31/CreateDBInstance)