Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
# CreateDBCluster
Membuat klaster Amazon DocumentDB baru.
## Parameter Permintaan
Untuk informasi tentang parameter yang umum untuk semua tindakan, lihat [Parameter Umum](CommonParameters.md).
** DBClusterIdentifier **
Pengidentifikasi klaster. 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: `my-cluster`
Tipe: String
Diperlukan: Ya
** Engine **
Nama mesin basis data yang akan digunakan untuk klaster ini.
Nilai yang valid: `docdb`
Tipe: String
Diperlukan: Ya
**AvailabilityZones. AvailabilityZone.N**
Daftar Availability Zone Amazon EC2 tempat instans dalam klaster dapat dibuat.
Tipe: Array string
Wajib: Tidak
** BackupRetentionPeriod **
Jumlah hari penyimpanan cadangan otomatis. Anda harus menentukan nilai minimum 1.
Default: 1
Batas:
+ Harus berupa nilai dari 1 hingga 35.
Tipe: Integer
Wajib: Tidak
** DBClusterParameterGroupName **
Nama grup parameter klaster yang akan dikaitkan dengan klaster ini.
Tipe: String
Wajib: Tidak
** DBSubnetGroupName **
Grup subnet yang akan dikaitkan dengan klaster ini.
Batas: Harus cocok dengan nama `DBSubnetGroup` yang ada. Tidak harus default.
Contoh: `mySubnetgroup`
Tipe: String
Wajib: Tidak
** DeletionProtection **
Menentukan apakah klaster ini dapat dihapus. Jika `DeletionProtection` diaktifkan, klaster tidak dapat dihapus kecuali jika diubah dan `DeletionProtection` dinonaktifkan. `DeletionProtection` melindungi klaster agar tidak terhapus secara tidak sengaja.
Tipe: Boolean
Wajib: Tidak
**EnableCloudwatchLogsExports.member.n**
Daftar jenis log yang perlu diaktifkan untuk mengekspor ke Amazon CloudWatch Logs. Anda dapat mengaktifkan log audit atau log profiler. Untuk informasi selengkapnya, lihat [Peristiwa Pengauditan Amazon DocumentDB](https://docs.aws.amazon.com/documentdb/latest/developerguide/event-auditing.html) dan [Operasi Pembuatan Profil Amazon DocumentDB](https://docs.aws.amazon.com/documentdb/latest/developerguide/profiling.html).
Tipe: Array string
Wajib: Tidak
** EngineVersion **
Nomor versi mesin basis data yang akan digunakan. `--engine-version` akan menjadi default ke versi mesin utama terbaru. Untuk beban kerja produksi, kami sarankan nyatakan parameter ini secara eksplisit dengan versi mesin utama yang dimaksud.
Tipe: String
Wajib: Tidak
** GlobalClusterIdentifier **
Pengidentifikasi klaster dari klaster global baru.
Tipe: String
Batasan Panjang: Panjang minimum 1. Panjang maksimum 255.
Pola: `[A-Za-z][0-9A-Za-z-:._]*`
Wajib: Tidak
** KmsKeyId **
Pengidentifikasi AWS KMS kunci untuk cluster terenkripsi.
Pengidentifikasi AWS KMS kunci adalah Amazon Resource Name (ARN) untuk kunci enkripsi AWS KMS . Jika Anda membuat cluster menggunakan yang sama Akun AWS yang memiliki kunci AWS KMS enkripsi yang digunakan untuk mengenkripsi cluster baru, Anda dapat menggunakan alias AWS KMS kunci alih-alih ARN untuk kunci enkripsi. AWS KMS
Jika kunci enkripsi tidak ditentukan dalam `KmsKeyId`:
+ Jika parameter `StorageEncrypted` adalah `true`, Amazon DocumentDB menggunakan kunci enkripsi default Anda.
AWS KMS membuat kunci enkripsi default untuk Anda Akun AWS. Anda Akun AWS memiliki kunci enkripsi default yang berbeda untuk masing-masing Wilayah AWS.
Tipe: String
Wajib: Tidak
** ManageMasterUserPassword **
Menentukan apakah akan mengelola kata sandi pengguna utama dengan Amazon Web Services Secrets Manager.
Kendala: Anda tidak dapat mengelola kata sandi pengguna utama dengan Amazon Web Services Secrets Manager jika `MasterUserPassword` ditentukan.
Tipe: Boolean
Wajib: Tidak
** MasterUsername **
Nama pengguna utama untuk klaster.
Batas:
+ Harus dari 1 hingga 63 huruf atau angka.
+ Karakter pertama harus berupa surat.
+ Tidak dapat menjadi kata yang direservasi untuk mesin basis data yang dipilih.
Tipe: String
Wajib: Tidak
** MasterUserPassword **
Kata sandi untuk pengguna basis data utama. Kata sandi ini dapat berisi karakter ASCII apa pun yang dapat dicetak kecuali garis miring (/), tanda kutip ganda ("), atau simbol "at" (@).
Kendala: Harus berisi dari 8 hingga 100 karakter.
Tipe: String
Wajib: Tidak
** MasterUserSecretKmsKeyId **
Pengidentifikasi kunci Amazon Web Services KMS untuk mengenkripsi rahasia yang dibuat dan dikelola secara otomatis di Amazon Web Services Secrets Manager. Pengaturan ini hanya berlaku jika kata sandi pengguna utama dikelola oleh Amazon DocumentDB di Amazon Web Services Secrets Manager untuk cluster DB.
Pengidentifikasi kunci Amazon Web Services KMS adalah kunci ARN, ID kunci, alias ARN, atau nama alias untuk kunci KMS. Untuk menggunakan kunci KMS di akun Amazon Web Services yang berbeda, tentukan kunci ARN atau alias ARN.
Jika Anda tidak menentukan`MasterUserSecretKmsKeyId`, maka kunci `aws/secretsmanager` KMS digunakan untuk mengenkripsi rahasia. Jika rahasianya ada di akun Amazon Web Services yang berbeda, maka Anda tidak dapat menggunakan kunci `aws/secretsmanager` KMS untuk mengenkripsi rahasia, dan Anda harus menggunakan kunci KMS yang dikelola pelanggan.
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
** NetworkType **
Jenis jaringan cluster.
Jenis jaringan ditentukan oleh yang `DBSubnetGroup` ditentukan untuk cluster. A hanya `DBSubnetGroup` dapat mendukung IPv4 protokol atau IPv4 dan IPv6 protokol ()`DUAL`.
Untuk informasi selengkapnya, lihat [cluster DocumentDB di VPC di Panduan Pengembang Amazon DocumentDB](https://docs.aws.amazon.com/documentdb/latest/developerguide/vpc-clusters.html).
Nilai Valid: `IPV4` \$1 `DUAL`
Tipe: String
Wajib: Tidak
** Port **
Nomor port tempat instans dalam klaster menerima koneksi.
Tipe: Integer
Wajib: Tidak
** PreferredBackupWindow **
Rentang waktu harian selama pencadangan otomatis dibuat jika pencadangan otomatis diaktifkan menggunakan parameter `BackupRetentionPeriod`.
Defaultnya adalah jendela 30 menit yang dipilih secara acak dari blok waktu 8 jam untuk masing-masing. Wilayah AWS
Batas:
+ Harus dalam format `hh24:mi-hh24:mi`.
+ Harus dalam Waktu Universal Terkoordinasi (UTC).
+ Tidak boleh bertentangan dengan jendela pemeliharaan yang diinginkan.
+ Harus setidaknya 30 menit.
Tipe: String
Wajib: Tidak
** PreferredMaintenanceWindow **
Rentang waktu mingguan selama pemeliharaan sistem dapat terjadi, 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
** PreSignedUrl **
Saat ini tidak didukung.
Tipe: String
Wajib: Tidak
** ServerlessV2ScalingConfiguration **
Berisi konfigurasi penskalaan cluster Amazon DocumentDB Tanpa Server.
Tipe: Objek [ServerlessV2ScalingConfiguration](API_ServerlessV2ScalingConfiguration.md)
Wajib: Tidak
** StorageEncrypted **
Menentukan apakah klaster dienkripsi.
Tipe: Boolean
Wajib: Tidak
** StorageType **
Jenis penyimpanan untuk dikaitkan dengan cluster DB.
Untuk informasi tentang jenis penyimpanan untuk klaster Amazon DocumentDB, lihat Konfigurasi penyimpanan klaster di Panduan Pengembang *Amazon* DocumentDB.
Nilai yang valid untuk jenis penyimpanan - `standard | iopt1`
Nilai default adalah `standard `
Saat Anda membuat klaster Amazon DocumentDB dengan jenis penyimpanan disetel `iopt1` ke, jenis penyimpanan dikembalikan dalam respons. Jenis penyimpanan tidak dikembalikan saat Anda mengaturnya`standard`.
Tipe: String
Wajib: Tidak
**Tags.Tag.N**
Tag yang akan ditetapkan ke klaster.
Tipe: Array objek [Tag](API_Tag.md)
Wajib: Tidak
**VpcSecurityGroupIds. VpcSecurityGroupId.N**
Sebuah daftar grup keamanan VPC EC2 untuk dikaitkan dengan kluster ini.
Tipe: Array string
Wajib: Tidak
## Elemen Respons
Elemen berikut dikembalikan oleh layanan.
** DBCluster **
Informasi mendetail tentang klaster.
Tipe: Objek [DBCluster](API_DBCluster.md)
## Kesalahan
Untuk informasi tentang kesalahan yang umum untuk semua tindakan, lihat [Kesalahan Umum](CommonErrors.md).
** DBClusterAlreadyExistsFault **
Anda sudah memiliki klaster dengan pengidentifikasi yang diberikan.
Kode Status HTTP: 400
** DBClusterNotFoundFault **
`DBClusterIdentifier` tidak mengacu ke sebuah klaster yang ada.
Kode Status HTTP: 404
** DBClusterParameterGroupNotFound **
`DBClusterParameterGroupName` tidak mengacu ke grup parameter klaster yang ada.
Kode Status HTTP: 404
** DBClusterQuotaExceededFault **
Klaster tidak dapat dibuat karena Anda telah mencapai kuota maksimum klaster yang diizinkan.
Kode Status HTTP: 403
** DBInstanceNotFound **
`DBInstanceIdentifier` tidak mengacu ke sebuah instans 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
** GlobalClusterNotFoundFault **
`GlobalClusterIdentifier` tidak mengacu ke sebuah klaster global yang ada.
Kode Status HTTP: 404
** InsufficientStorageClusterCapacity **
Tidak ada cukup penyimpanan yang tersedia untuk tindakan saat ini. Anda mungkin dapat mengatasi kesalahan ini dengan memperbarui grup subnet Anda untuk menggunakan Availability Zone berbeda yang memiliki lebih banyak penyimpanan yang tersedia.
Kode Status HTTP: 400
** InvalidDBClusterStateFault **
Klaster tidak dalam status valid.
Kode Status HTTP: 400
** InvalidDBInstanceState **
Instans yang ditentukan tidak dalam status *tersedia*.
Kode Status HTTP: 400
** InvalidDBSubnetGroupStateFault **
Grup subnet tidak dapat dihapus karena sedang digunakan.
Kode Status HTTP: 400
** InvalidGlobalClusterStateFault **
Operasi yang diminta tidak dapat dilakukan saat klaster dalam keadaan ini.
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
** NetworkTypeNotSupported **
Jenis jaringan tidak didukung oleh salah satu `DBSubnetGroup` atau versi mesin DB.
Kode Status HTTP: 400
** StorageQuotaExceeded **
Permintaan akan menyebabkan Anda melebihi jumlah penyimpanan yang diizinkan yang tersedia di semua instans.
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/CreateDBCluster)
+ [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/docdb-2014-10-31/CreateDBCluster)
+ [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/docdb-2014-10-31/CreateDBCluster)
+ [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/docdb-2014-10-31/CreateDBCluster)
+ [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/docdb-2014-10-31/CreateDBCluster)
+ [AWS SDK untuk V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/docdb-2014-10-31/CreateDBCluster)
+ [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/docdb-2014-10-31/CreateDBCluster)
+ [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/docdb-2014-10-31/CreateDBCluster)
+ [AWS SDK untuk Python](https://docs.aws.amazon.com/goto/boto3/docdb-2014-10-31/CreateDBCluster)
+ [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/docdb-2014-10-31/CreateDBCluster)