Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
# ModifyDBCluster
Memodifikasi pengaturan untuk klaster Amazon DocumentDB. Anda dapat mengubah satu atau lebih parameter konfigurasi basis data dengan menentukan parameter ini dan nilai-nilai baru dalam permintaan.
## Parameter Permintaan
Untuk informasi tentang parameter yang umum untuk semua tindakan, lihat [Parameter Umum](CommonParameters.md).
** DBClusterIdentifier **
Pengidentifikasi klaster untuk klaster yang sedang dimodifikasi. Parameter ini tidak peka huruf besar kecil.
Batas:
+ Harus cocok dengan pengidentifikasi `DBCluster` yang ada.
Tipe: String
Diperlukan: Ya
** AllowMajorVersionUpgrade **
Nilai yang menunjukkan apakah pembaruan versi utama diizinkan.
Batas:
+ Anda harus mengizinkan upgrade versi mayor saat menentukan nilai untuk `EngineVersion` parameter yang merupakan versi mayor yang berbeda dari versi cluster saat ini.
+ Karena beberapa parameter bersifat spesifik versi, mengubahnya memerlukan eksekusi panggilan `ModifyDBCluster` API baru setelah MVU di tempat selesai.
Melakukan MVU secara langsung berdampak pada parameter berikut:
+ `MasterUserPassword`
+ `NewDBClusterIdentifier`
+ `VpcSecurityGroupIds`
+ `Port`
Tipe: Boolean
Wajib: Tidak
** ApplyImmediately **
Nilai yang menentukan apakah perubahan dalam permintaan ini dan perubahan yang tertunda diterapkan secara asinkron sesegera mungkin, terlepas dari pengaturan `PreferredMaintenanceWindow` untuk klaster. Jika parameter ini diatur ke `false`, perubahan ke klaster diterapkan selama jendela pemeliharaan berikutnya.
Parameter `ApplyImmediately` memengaruhi hanya nilai `NewDBClusterIdentifier` dan `MasterUserPassword`. Jika Anda mengatur nilai parameter ini ke `false`, perubahan nilai `NewDBClusterIdentifier` dan `MasterUserPassword` diterapkan selama jendela pemeliharaan berikutnya. Semua perubahan lainnya akan diterapkan dengan segera, terlepas dari nilai parameter `ApplyImmediately`.
Default: `false`
Jenis: Boolean
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
** CloudwatchLogsExportConfiguration **
Pengaturan konfigurasi untuk jenis log yang akan diaktifkan untuk diekspor ke Amazon CloudWatch Logs untuk instance atau cluster tertentu. `DisableLogTypes`Array `EnableLogTypes` dan menentukan log mana yang diekspor (atau tidak diekspor) ke Log. CloudWatch
Tipe: Objek [CloudwatchLogsExportConfiguration](API_CloudwatchLogsExportConfiguration.md)
Wajib: Tidak
** DBClusterParameterGroupName **
Nama grup parameter klaster yang digunakan untuk klaster.
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
** EngineVersion **
Nomor versi mesin basis data yang ingin Anda tingkatkan. Mengubah parameter ini menghasilkan pemadaman. Perubahan diterapkan selama jendela pemeliharaan berikutnya kecuali `ApplyImmediately` diaktifkan.
Untuk daftar semua versi engine yang tersedia untuk Amazon DocumentDB gunakan perintah berikut:
`aws docdb describe-db-engine-versions --engine docdb --query "DBEngineVersions[].EngineVersion"`
Tipe: String
Wajib: Tidak
** ManageMasterUserPassword **
Menentukan apakah akan mengelola kata sandi pengguna utama dengan Amazon Web Services Secrets Manager. Jika klaster tidak mengelola kata sandi pengguna utama dengan Amazon Web Services Secrets Manager, Anda dapat mengaktifkan manajemen ini. Dalam hal ini, Anda tidak dapat menentukan`MasterUserPassword`. Jika cluster sudah mengelola kata sandi pengguna master dengan Amazon Web Services Secrets Manager, dan Anda menentukan bahwa kata sandi pengguna master tidak dikelola dengan Amazon Web Services Secrets Manager, maka Anda harus menentukan`MasterUserPassword`. Dalam hal ini, Amazon DocumentDB menghapus rahasia dan menggunakan kata sandi baru untuk pengguna utama yang ditentukan oleh. `MasterUserPassword`
Tipe: Boolean
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 kedua kondisi berikut terpenuhi:
+ Cluster tidak mengelola kata sandi pengguna utama di Amazon Web Services Secrets Manager. Jika cluster sudah mengelola kata sandi pengguna utama di Amazon Web Services Secrets Manager, Anda tidak dapat mengubah kunci KMS yang digunakan untuk mengenkripsi rahasia.
+ Anda memungkinkan `ManageMasterUserPassword` untuk mengelola kata sandi pengguna utama di Amazon Web Services Secrets Manager. Jika Anda menyalakan `ManageMasterUserPassword` dan 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.
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.
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
** NewDBClusterIdentifier **
Pengidentifikasi klaster baru untuk klaster ketika mengubah nama klaster. Nilai ini disimpan sebagai string huruf kecil.
Kendala:
+ 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-cluster2`
Tipe: String
Wajib: Tidak
** Port **
Nomor port tempat klaster menerima koneksi.
Kendala: Harus berupa nilai dari `1150` hingga `65535`.
Default: Port yang sama dengan klaster asli.
Tipe: Integer
Wajib: Tidak
** PreferredBackupWindow **
Kisaran waktu harian selama backup otomatis dibuat jika backup 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
** RotateMasterUserPassword **
Menentukan apakah akan memutar rahasia yang dikelola oleh Amazon Web Services Secrets Manager untuk kata sandi pengguna utama.
Pengaturan ini hanya berlaku jika kata sandi pengguna utama dikelola oleh Amazon DocumentDB di Amazon Web Services Secrets Manager untuk cluster. Nilai rahasia berisi kata sandi yang diperbarui.
Kendala: Anda harus segera menerapkan perubahan saat memutar kata sandi pengguna utama.
Tipe: Boolean
Wajib: Tidak
** ServerlessV2ScalingConfiguration **
Berisi konfigurasi penskalaan cluster Amazon DocumentDB Tanpa Server.
Tipe: Objek [ServerlessV2ScalingConfiguration](API_ServerlessV2ScalingConfiguration.md)
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 `
Tipe: String
Wajib: Tidak
**VpcSecurityGroupIds. VpcSecurityGroupId.N**
Daftar grup keamanan virtual private cloud (VPC) tempat klaster akan berada.
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 [Jenis 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
** DBSubnetGroupNotFoundFault **
`DBSubnetGroupName` tidak mengacu ke grup subnet yang ada.
Kode Status HTTP: 404
** InvalidDBClusterStateFault **
Klaster tidak dalam status valid.
Kode Status HTTP: 400
** InvalidDBInstanceState **
Instans yang ditentukan tidak dalam status *tersedia*.
Kode Status HTTP: 400
** InvalidDBSecurityGroupState **
Status grup keamanan tidak mengizinkan penghapusan.
Kode Status HTTP: 400
** InvalidDBSubnetGroupStateFault **
Grup subnet tidak dapat dihapus karena sedang digunakan.
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
** 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/ModifyDBCluster)
+ [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/docdb-2014-10-31/ModifyDBCluster)
+ [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/docdb-2014-10-31/ModifyDBCluster)
+ [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/docdb-2014-10-31/ModifyDBCluster)
+ [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/docdb-2014-10-31/ModifyDBCluster)
+ [AWS SDK untuk V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/docdb-2014-10-31/ModifyDBCluster)
+ [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/docdb-2014-10-31/ModifyDBCluster)
+ [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/docdb-2014-10-31/ModifyDBCluster)
+ [AWS SDK untuk Python](https://docs.aws.amazon.com/goto/boto3/docdb-2014-10-31/ModifyDBCluster)
+ [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/docdb-2014-10-31/ModifyDBCluster)