Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
# Mengelola grup parameter cluster Amazon DocumentDB
Anda dapat mengelola konfigurasi mesin Amazon DocumentDB dengan menggunakan parameter dalam grup parameter klaster. *Grup parameter klaster* adalah kumpulan nilai konfigurasi Amazon DocumentDB yang mempermudah pengelolaan parameter klaster Amazon DocumentDB Anda. Grup parameter klaster bertindak sebagai kontainer untuk nilai konfigurasi mesin yang diterapkan ke semua instans dalam klaster.
Bagian ini menjelaskan cara membuat, melihat, dan mengubah grup parameter klaster. Ini juga menunjukkan bagaimana Anda dapat menentukan grup parameter klaster mana yang dikaitkan dengan klaster tertentu.
**Topics**
+ [Menjelaskan kelompok parameter cluster](cluster_parameter_groups-describe.md)
+ [Membuat kelompok parameter cluster](cluster_parameter_groups-create.md)
+ [Memodifikasi kelompok parameter cluster](cluster_parameter_groups-modify.md)
+ [Memodifikasi cluster untuk menggunakan kelompok parameter cluster yang disesuaikan](cluster_parameter_groups-modify_clusters.md)
+ [Menyalin kelompok parameter cluster](cluster_parameter_groups-copy.md)
+ [Menyetel ulang kelompok parameter cluster](cluster_parameter_groups-reset.md)
+ [Menghapus grup parameter cluster](cluster_parameter_groups-delete.md)
+ [Referensi parameter cluster](cluster_parameter_groups-list_of_parameters.md)
# Menjelaskan grup parameter cluster Amazon DocumentDB
Grup parameter `default` cluster dibuat secara otomatis saat Anda membuat klaster Amazon DocumentDB pertama di wilayah baru atau menggunakan mesin baru. Cluster berikutnya, yang dibuat di wilayah yang sama dan memiliki versi mesin yang sama, dibuat dengan grup parameter `default` cluster.
**Topics**
+ [Menjelaskan rincian kelompok parameter cluster](#cluster_parameter_groups-describe_details)
+ [Menentukan kelompok parameter cluster](#cluster_parameter_groups-determine)
+ [Menentukan cluster dan instance yang terkait dengan grup parameter cluster](#cluster_parameter_groups-count)
## Menjelaskan detail grup parameter cluster Amazon DocumentDB
Untuk menjelaskan rincian kelompok parameter cluster yang diberikan, selesaikan langkah-langkah berikut menggunakan Konsol Manajemen AWS atau AWS Command Line Interface (AWS CLI).
------
#### [ Using the Konsol Manajemen AWS ]
****
1. [Masuk ke Konsol Manajemen AWS, dan buka konsol Amazon DocumentDB di /docdb. https://console.aws.amazon.com](https://console.aws.amazon.com/docdb)
1. Di panel navigasi, pilih **Grup parameter**.
**Tip**
Jika Anda tidak melihat panel navigasi di sisi kiri layar, pilih ikon menu (![\[Hamburger menu icon with three horizontal lines.\]](http://docs.aws.amazon.com/id_id/documentdb/latest/developerguide/images/docdb-menu-icon.png)) di pojok kiri atas halaman.
1. Di panel **Grup parameter klaster** , pilih nama grup parameter yang ingin Anda lihat detailnya.
1. Halaman yang dihasilkan menunjukkan parameter grup parameter, aktivitas terbaru, dan tag.
+ Di bawah **Parameter klaster**, Anda dapat melihat nama parameter, nilai saat ini, nilai yang diizinkan, apakah parameter dapat dimodifikasi, jenis penerapannya, tipe data, dan deskripsinya. Anda dapat mengubah parameter individual dengan memilih parameter lalu memilih **Edit** di bagian **Parameter klaster**. Untuk informasi selengkapnya, lihat [Memodifikasi parameter cluster Amazon DocumentDB](cluster_parameter_groups-parameters.md).
+ Di bawah **Peristiwa terbaru**, Anda dapat melihat peristiwa terbaru untuk grup parameter ini. Anda dapat memfilter acara ini menggunakan bar pencarian di bagian ini. Untuk informasi selengkapnya, lihat [Mengelola acara Amazon DocumentDB](managing-events.md).
+ Di bawah **Tag**, Anda dapat melihat tag yang ada di grup parameter klaster ini. Anda dapat menambah atau menghapus tag dengan memilih **Edit** di bagian **Tag**. Untuk informasi selengkapnya, lihat [Menandai sumber daya Amazon DocumentDB](tagging.md).
------
#### [ Using the AWS CLI ]
Anda dapat menggunakan `describe-db-cluster-parameter-groups` AWS CLI perintah untuk melihat Amazon Resource Name (ARN), keluarga, deskripsi, dan nama grup parameter cluster tunggal atau semua grup parameter cluster yang Anda miliki untuk Amazon DocumentDB. Anda juga dapat menggunakan `describe-db-cluster-parameters` AWS CLI perintah untuk melihat parameter dan detailnya di dalam grup parameter cluster tunggal.
+ **--describe-db-cluster-parameter-groups** — Untuk melihat daftar semua grup parameter klaster dan detailnya.
+ **--db-cluster-parameter-group-name** – Opsional. Nama grup parameter klaster yang ingin Anda jelaskan. Jika parameter ini dihilangkan, semua grup parameter klaster akan dijelaskan.
+ **--describe-db-cluster-parameters** — Untuk membuat daftar semua parameter di dalam grup parameter dan nilainya.
+ **--db-cluster-parameter-group name** — Diperlukan. Nama grup parameter klaster yang ingin Anda jelaskan.
**Example**
Kode berikut mencantumkan hingga 100 grup parameter klaster dan ARN, keluarga, deskripsi, dan namanya.
```
aws docdb describe-db-cluster-parameter-groups
```
Output dari operasi ini terlihat seperti berikut (format JSON).
```
{
"DBClusterParameterGroups": [
{
"DBClusterParameterGroupArn": "arn:aws:rds:us-east-1:012345678912:cluster-pg:default.docdb4.0",
"DBParameterGroupFamily": "docdb4.0",
"Description": "Default cluster parameter group for docdb4.0",
"DBClusterParameterGroupName": "default.docdb4.0"
},
{
"DBClusterParameterGroupArn": "arn:aws:rds:us-east-1:012345678912:cluster-pg:sample-parameter-group",
"DBParameterGroupFamily": "docdb4.0",
"Description": "Custom docdb4.0 parameter group",
"DBClusterParameterGroupName": "sample-parameter-group"
}
]
}
```
**Example**
Kode berikut mencantumkan ARN, keluarga, deskripsi, dan nama untuk `sample-parameter-group`.
Untuk Linux, macOS, atau Unix:
```
aws docdb describe-db-cluster-parameter-groups \
--db-cluster-parameter-group-name sample-parameter-group
```
Untuk Windows:
```
aws docdb describe-db-cluster-parameter-groups ^
--db-cluster-parameter-group-name sample-parameter-group
```
Output dari operasi ini terlihat seperti berikut (format JSON).
```
{
"DBClusterParameterGroups": [
{
"DBClusterParameterGroupArn": "arn:aws:rds:us-east-1:123456789012:cluster-pg:sample-parameter-group",
"Description": "Custom docdb4.0 parameter group",
"DBParameterGroupFamily": "docdb4.0",
"DBClusterParameterGroupName": "sample-parameter-group"
}
]
}
```
**Example**
Kode berikut mencantumkan nilai parameter dalam `sample-parameter-group`.
Untuk Linux, macOS, atau Unix:
```
aws docdb describe-db-cluster-parameters \
--db-cluster-parameter-group-name sample-parameter-group
```
Untuk Windows:
```
aws docdb describe-db-cluster-parameters ^
--db-cluster-parameter-group-name sample-parameter-group
```
Output dari operasi ini terlihat seperti berikut (format JSON).
```
{
"Parameters": [
{
"ParameterName": "audit_logs",
"ParameterValue": "disabled",
"Description": "Enables auditing on cluster.",
"Source": "system",
"ApplyType": "dynamic",
"DataType": "string",
"AllowedValues": "enabled,disabled",
"IsModifiable": true,
"ApplyMethod": "pending-reboot"
},
{
"ParameterName": "change_stream_log_retention_duration",
"ParameterValue": "17777",
"Description": "Duration of time in seconds that the change stream log is retained and can be consumed.",
"Source": "user",
"ApplyType": "dynamic",
"DataType": "integer",
"AllowedValues": "3600-86400",
"IsModifiable": true,
"ApplyMethod": "pending-reboot"
}
]
}
```
------
## Menentukan grup parameter cluster Amazon DocumentDB
Untuk menentukan kelompok parameter mana yang terkait dengan cluster tertentu, selesaikan langkah-langkah berikut menggunakan Konsol Manajemen AWS atau AWS CLI.
------
#### [ Using the Konsol Manajemen AWS ]
1. [Masuk ke Konsol Manajemen AWS, dan buka konsol Amazon DocumentDB di /docdb. https://console.aws.amazon.com](https://console.aws.amazon.com/docdb)
1. Di panel navigasi kiri, pilih **Klaster**.
1. Dalam daftar klaster, pilih nama klaster yang Anda minati.
1. Halaman yang dihasilkan menunjukkan detail klaster yang Anda pilih. Gulir ke bawah ke **Detail klaster**. Di bagian bawah bagian tersebut, temukan nama grup parameter di bawah **Grup parameter klaster**.
![\[Tangkapan layar: Menampilkan grup parameter klaster.\]](http://docs.aws.amazon.com/id_id/documentdb/latest/developerguide/images/docdb-determine-parameter-group.png)
------
#### [ Using the AWS CLI ]
AWS CLI Kode berikut menentukan kelompok parameter mana yang mengatur cluster`sample-cluster`.
```
aws docdb describe-db-clusters \
--db-cluster-identifier sample-cluster \
--query 'DBClusters[*].[DBClusterIdentifier,DBClusterParameterGroup]'
```
Keluaran dari operasi ini terlihat seperti berikut ini (format JSON).
```
[
[
"sample-cluster",
"sample-parameter-group"
]
]
```
------
## Menentukan cluster dan instance yang terkait dengan grup parameter cluster Amazon DocumentDB
Untuk menentukan berapa banyak cluster dan instance yang terkait dengan setiap grup parameter, selesaikan langkah-langkah berikut menggunakan. AWS CLI
------
#### [ Using the AWS CLI ]
AWS CLI Kode berikut menentukan berapa banyak cluster dan instance yang terkait dengannya. `sample-parameter-group`
Untuk Linux, macOS, atau Unix:
```
aws docdb describe-db-clusters \
--query 'DBClusters[*].[DBClusterParameterGroup,DBClusterIdentifier,DBClusterMembers[*].DBInstanceIdentifier]' \
--output json | \
jq -r 'group_by(.[0]) | map({
parameter_group_name: .[0][0],
total_clusters: length,
total_instances: map(.[2] | length) | add // 0
}) | .[]'
```
Untuk Windows:
```
aws docdb describe-db-clusters ^
--query 'DBClusters[*].[DBClusterParameterGroup,DBClusterIdentifier,DBClusterMembers[*].DBInstanceIdentifier]' ^
--output json | ^
jq -r 'group_by(.[0]) | map({
parameter_group_name: .[0][0],
total_clusters: length,
total_instances: map(.[2] | length) | add // 0
}) | .[]'
```
Keluaran dari operasi ini terlihat seperti berikut ini (format JSON).
```
{
"parameter_group_name": "sample-parameter-group",
"total_clusters": 50,
"total_instances": 150
}
```
------
# Membuat grup parameter cluster Amazon DocumentDB
Grup parameter cluster default seperti`default.docdb5.0`,`default.docdb4.0`, atau`default.docdb3.6`, dibuat saat Anda membuat klaster dengan versi mesin baru dan di wilayah baru. Cluster berikutnya dibuat di wilayah ini dan dengan versi mesin yang sama mewarisi grup parameter `default` cluster. Setelah dibuat, grup `default` parameter tidak dapat dihapus atau diganti namanya. Anda dapat memodifikasi perilaku engine instance cluster dengan membuat grup parameter kustom dengan nilai parameter pilihan dan melampirkannya ke cluster Amazon DocumentDB Anda.
Prosedur berikut memandu Anda melalui pembuatan grup parameter cluster kustom. Anda kemudian dapat [mengubah parameter dalam grup parameter tersebut](https://docs.aws.amazon.com//documentdb/latest/developerguide/cluster_parameter_groups-modify.html).
**catatan**
Setelah Anda membuat grup parameter klaster, Anda harus menunggu setidaknya 5 menit sebelum menggunakan grup parameter tersebut. Ini memungkinkan Amazon DocumentDB untuk menyelesaikan tindakan `create` sepenuhnya sebelum grup parameter klaster digunakan untuk klaster baru. Anda dapat menggunakan Konsol Manajemen AWS atau `describe-db-cluster-parameter-groups` AWS CLI operasi untuk memverifikasi bahwa grup parameter cluster Anda telah dibuat. Untuk informasi selengkapnya, lihat [Menjelaskan grup parameter cluster Amazon DocumentDB](cluster_parameter_groups-describe.md).
------
#### [ Using the Konsol Manajemen AWS ]
**Untuk membuat grup parameter klaster**
1. [Masuk ke Konsol Manajemen AWS, dan buka konsol Amazon DocumentDB di /docdb. https://console.aws.amazon.com](https://console.aws.amazon.com/docdb)
1. Di panel navigasi, pilih **Grup parameter**.
**Tip**
Jika Anda tidak melihat panel navigasi di sisi kiri layar, pilih ikon menu (![\[Hamburger menu icon with three horizontal lines.\]](http://docs.aws.amazon.com/id_id/documentdb/latest/developerguide/images/docdb-menu-icon.png)) di pojok kiri atas halaman.
1. Di panel **Grup parameter klaster**, pilih **Buat**.
1. Di panel **Buat grup parameter klaster**, masukkan berikut ini:
1. **Nama grup parameter cluster baru** - Masukkan nama untuk grup parameter cluster. Misalnya, `sample-parameter-group`. Grup parameter klaster memiliki batasan penamaan berikut:
+ Panjangnya [1–255] karakter alfanumerik.
+ Karakter pertama harus berupa huruf.
+ Tidak dapat diakhiri dengan tanda hubung atau berisi dua tanda hubung berurutan.
1. **Keluarga** - Pilih versi DocumentDB yang ingin Anda gunakan untuk cluster Anda.
1. **Deskripsi** — Memberikan deskripsi untuk grup parameter klaster ini.
1. Untuk membuat grup parameter klaster, pilih **Buat**. Untuk membatalkan operasi, pilih **Batal**.
1. Setelah Anda memilih **Buat**, teks berikut akan muncul di bagian atas halaman untuk memverifikasi bahwa grup parameter klaster Anda telah berhasil dibuat:
```
Successfully created cluster parameter group 'sample-parameter-group'.
```
------
#### [ Using the AWS CLI ]
Untuk membuat grup parameter cluster baru untuk cluster Amazon DocumentDB 4.0, gunakan operasi AWS CLI `create-db-cluster-parameter-group` dengan parameter berikut:
+ **--db-cluster-parameter-group-name** — Nama grup parameter klaster kustom. Misalnya, `sample-parameter-group`.
+ **--db-cluster-parameter-group-family** — Keluarga grup parameter klaster yang digunakan sebagai templat untuk grup parameter klaster kustom.
+ **--description** — Deskripsi yang diberikan pengguna untuk grup parameter klaster ini. Contoh berikut menggunakan "`Custom docdb4.0 parameter group`”.
Untuk Linux, macOS, atau Unix:
**Example**
```
aws docdb create-db-cluster-parameter-group \
--db-cluster-parameter-group-name sample-parameter-group \
--db-parameter-group-family docdb5.0 \
--description "Custom docdb5.0 parameter group"
```
Untuk Windows:
```
aws docdb create-db-cluster-parameter-group ^
--db-cluster-parameter-group-name sample-parameter-group ^
--db-parameter-group-family docdb5.0 ^
--description "Custom docdb5.0 parameter group"
```
Output dari operasi ini terlihat seperti berikut (format JSON).
```
{
"DBClusterParameterGroup": {
"DBClusterParameterGroupName": "sample-parameter-group",
"DBParameterGroupFamily": "docdb5.0",
"Description": "Custom docdb4.0 parameter group",
"DBClusterParameterGroupArn": "sample-parameter-group-arn"
}
}
```
------
# Memodifikasi grup parameter cluster Amazon DocumentDB
Bagian ini menjelaskan cara memodifikasi grup parameter Amazon DocumentDB *kustom*. Di Amazon DocumentDB, Anda tidak dapat memodifikasi `default` grup parameter cluster yang dibuat saat pertama kali membuat klaster dengan versi engine baru di wilayah baru. Jika klaster Amazon DocumentDB Anda menggunakan grup parameter klaster default dan Anda ingin mengubah nilai di dalamnya, Anda harus terlebih dahulu [ membuat grup parameter baru](https://docs.aws.amazon.com//documentdb/latest/developerguide/cluster_parameter_groups-create.html) atau [ menyalin grup parameter yang ada](https://docs.aws.amazon.com//documentdb/latest/developerguide/cluster_parameter_groups-copy.html), memodifikasinya, lalu menerapkan grup parameter yang dimodifikasi ke klaster Anda.
Selesaikan langkah-langkah berikut untuk memodifikasi grup parameter cluster kustom. Memodifikasi tindakan bisa memakan waktu beberapa saat untuk disebarkan. Harap tunggu grup paramater cluster yang dimodifikasi tersedia sebelum melampirkannya ke cluster Anda. Anda dapat menggunakan Konsol Manajemen AWS atau AWS CLI `describe-db-cluster-parameters` operasi untuk memverifikasi bahwa grup parameter cluster Anda telah dimodifikasi. Untuk informasi selengkapnya, lihat [Menjelaskan kelompok parameter cluster](cluster_parameter_groups-describe.md).
------
#### [ Using the Konsol Manajemen AWS ]
Ikuti langkah-langkah ini untuk mengubah grup parameter Amazon DocumentDB kustom. Anda tidak dapat mengubah grup parameter `default`. Jika Anda ingin mengubah nilai dalam grup parameter `default`, Anda dapat [menyalin grup parameter klaster default](https://docs.aws.amazon.com//documentdb/latest/developerguide/cluster_parameter_groups-copy.html), memodifikasinya, lalu menerapkan grup parameter yang dimodifikasi ke klaster Anda. Untuk informasi selengkapnya tentang menerapkan grup parameter ke klaster Anda, lihat [Memodifikasi cluster Amazon DocumentDB](db-cluster-modify.md).
**Untuk mengubah grup parameter klaster kustom**
1. [Masuk ke Konsol Manajemen AWS, dan buka konsol Amazon DocumentDB di /docdb. https://console.aws.amazon.com](https://console.aws.amazon.com/docdb)
1. Di panel navigasi di sisi kiri konsol tersebut, pilih **Grup parameter**. Dalam daftar grup parameter, pilih nama grup parameter yang ingin Anda ubah.
**Tip**
Jika Anda tidak melihat panel navigasi di sisi kiri layar, pilih ikon menu (![\[Hamburger menu icon with three horizontal lines.\]](http://docs.aws.amazon.com/id_id/documentdb/latest/developerguide/images/docdb-menu-icon.png)) di pojok kiri atas halaman.
1. Untuk setiap parameter dalam grup parameter yang ingin Anda ubah, lakukan hal berikut:
1. Temukan parameter yang ingin Anda ubah, dan verifikasi bahwa parameter tersebut dapat dimodifikasi dengan memeriksa apakah parameter tersebut terdaftar sebagai `true` di bawah kolom yang **Dapat dimodifikasi**.
1. Jika dapat dimodifikasi, pilih parameter dan pilih **Edit** dari kanan atas halaman konsol tersebut.
1. Dalam kotak dialog **Modifikasi ``**, buat perubahan yang Anda inginkan. Kemudian pilih **Ubah parameter klaster**, atau pilih **Batal** untuk membuang perubahan.
------
#### [ Using the AWS CLI ]
Anda dapat memodifikasi `ParameterValue`, `Description`, atau `ApplyMethod` dari parameter apa pun yang dapat dimodifikasi di dalam grup parameter klaster Amazon DocumentDB kustom menggunakan AWS CLI. Anda tidak dapat membuat modifikasi langsung ke grup parameter klaster default.
Untuk mengubah parameter grup parameter klaster kustom, gunakan operasi `modify-db-cluster-parameter-group` dengan parameter berikut.
+ **--db-cluster-parameter-group-name** — Diperlukan. Nama grup parameter klaster yang Anda modifikasi.
+ **--parameters** — Diperlukan. Parameter yang Anda modifikasi. Untuk daftar parameter yang berlaku untuk semua instans di klaster Amazon DocumentDB, lihat [Referensi parameter cluster Amazon DocumentDB](cluster_parameter_groups-list_of_parameters.md). Setiap entri parameter harus menyertakan hal berikut:
+ **ParameterName** — Nama parameter yang Anda ubah.
+ **ParameterValue** — Nilai baru untuk parameter ini.
+ **ApplyMethod** — Bagaimana Anda ingin perubahan pada parameter ini diterapkan. Nilai yang diizinkan adalah `immediate` dan `pending-reboot`.
**catatan**
Parameter dengan `ApplyType` dari `static` harus memiliki `ApplyMethod` dari `pending-reboot`.
**Example - Memodifikasi nilai parameter**
Dalam contoh ini, Anda mencantumkan nilai parameter `sample-parameter-group` dan memodifikasi parameter `tls`. Kemudian, setelah menunggu 5 menit, Anda kembali mencantumkan nilai parameter `sample-parameter-group` untuk melihat nilai parameter yang diubah.
1. Buat daftar parameter dan nilai `sample-parameter-group` mereka.
Untuk Linux, macOS, atau Unix:
```
aws docdb describe-db-cluster-parameters \
--db-cluster-parameter-group-name sample-parameter-group
```
Untuk Windows:
```
aws docdb describe-db-cluster-parameters ^
--db-cluster-parameter-group-name sample-parameter-group
```
Output dari operasi ini terlihat seperti berikut (format JSON).
```
{
"Parameters": [
{
"Source": "system",
"ApplyType": "static",
"AllowedValues": "disabled,enabled",
"ParameterValue": "enabled",
"ApplyMethod": "pending-reboot",
"DataType": "string",
"ParameterName": "tls",
"IsModifiable": true,
"Description": "Config to enable/disable TLS"
},
{
"Source": "user",
"ApplyType": "dynamic",
"AllowedValues": "disabled,enabled",
"ParameterValue": "enabled",
"ApplyMethod": "pending-reboot",
"DataType": "string",
"ParameterName": "ttl_monitor",
"IsModifiable": true,
"Description": "Enables TTL Monitoring"
}
]
}
```
1. Ubah parameter `tls` sehingga nilainya menjadi `disabled` .
Anda tidak dapat mengubah `ApplyMethod` karena `ApplyType` adalah `static`.
Untuk Linux, macOS, atau Unix:
```
aws docdb modify-db-cluster-parameter-group \
--db-cluster-parameter-group-name sample-parameter-group \
--parameters "ParameterName"=tls,"ParameterValue"=disabled,"ApplyMethod"=pending-reboot
```
Untuk Windows:
```
aws docdb modify-db-cluster-parameter-group ^
--db-cluster-parameter-group-name sample-parameter-group ^
--parameters "ParameterName"=tls,"ParameterValue"=disabled,"ApplyMethod"=pending-reboot
```
Output dari operasi ini terlihat seperti berikut (format JSON).
```
{
"DBClusterParameterGroupName": "sample-parameter-group"
}
```
1. Tunggu paling tidak 5 menit.
1. Buat daftar nilai parameter `sample-parameter-group` untuk memverifikasi bahwa parameter `tls` telah dimodifikasi.
Untuk Linux, macOS, atau Unix:
```
aws docdb describe-db-cluster-parameters \
--db-cluster-parameter-group-name sample-parameter-group
```
Untuk Windows:
```
aws docdb describe-db-cluster-parameters ^
--db-cluster-parameter-group-name sample-parameter-group
```
Keluaran dari operasi ini terlihat seperti berikut ini (format JSON).
```
{
"Parameters": [
{
"ParameterValue": "false",
"ParameterName": "enable_audit_logs",
"ApplyType": "dynamic",
"DataType": "string",
"Description": "Enables auditing on cluster.",
"AllowedValues": "true,false",
"Source": "system",
"IsModifiable": true,
"ApplyMethod": "pending-reboot"
},
{
"ParameterValue": "disabled",
"ParameterName": "tls",
"ApplyType": "static",
"DataType": "string",
"Description": "Config to enable/disable TLS",
"AllowedValues": "disabled,enabled",
"Source": "system",
"IsModifiable": true,
"ApplyMethod": "pending-reboot"
}
]
}
```
------
# Memodifikasi cluster Amazon DocumentDB untuk menggunakan grup parameter cluster kustom
Saat Anda membuat klaster Amazon DocumentDB, grup parameter `default.docdb4.0` secara otomatis dibuat untuk klaster tersebut. Anda tidak dapat mengubah grup parameter klaster `default`. Sebagai gantinya, Anda dapat memodifikasi klaster Amazon DocumentDB untuk mengaitkan grup parameter baru yang disesuaikan dengan itu.
Bagian ini menjelaskan cara memodifikasi klaster Amazon DocumentDB yang ada untuk menggunakan grup parameter cluster kustom menggunakan Konsol Manajemen AWS dan AWS Command Line Interface ().AWS CLI
------
#### [ Using the Konsol Manajemen AWS ]
**Untuk memodifikasi klaster Amazon DocumentDB untuk menggunakan grup parameter klaster bukan-default yang baru**
1. Sebelum Anda mulai, pastikan Anda telah membuat klaster Amazon DocumentDB dan grup parameter klaster. Lihat [Membuat cluster Amazon DocumentDB](db-cluster-create.md) dan [Membuat grup parameter cluster Amazon DocumentDB](cluster_parameter_groups-create.md) untuk instruksi lebih lanjut.
1. Setelah membuat grup parameter klaster Anda, buka konsol Amazon DocumentDB di [https://console.aws.amazon.com/docdb](https://console.aws.amazon.com/docdb). Di panel navigasi, pilih **Klaster** untuk menambahkan grup parameter baru Anda ke sebuah klaster.
1. Pilih klaster yang ingin Anda kaitkan dengan grup parameter Anda. Pilih **Tindakan**, lalu pilih **Ubah** untuk mengubah klaster Anda.
1. Di bawah **Opsi klaster**, pilih grup parameter baru yang ingin Anda kaitkan dengan klaster Anda.
1. Pilih **Lanjutkan** untuk melihat ringkasan dari modifikasi Anda.
1. Setelah memverifikasi perubahan Anda, Anda dapat menerapkannya segera atau selama jendela pemeliharaan berikutnya di bawah **Penjadwalan modifikasi**.
1. Pilih **Ubah klaster** untuk memperbarui klaster Anda dengan grup parameter baru Anda.
------
#### [ Using the AWS CLI ]
Sebelum Anda memulai, pastikan Anda telah membuat klaster Amazon DocumentDB dan grup parameter klaster. Anda dapat [membuat cluster Amazon DocumentDB](https://docs.aws.amazon.com//documentdb/latest/developerguide/db-cluster-create.html) menggunakan operasi. AWS CLI `create-db-cluster` Anda dapat [membuat grup parameter cluster](https://docs.aws.amazon.com//documentdb/latest/developerguide/cluster_parameter_groups-create.html) menggunakan AWS CLI `create-db-cluster-parameter-group` operasi.
Untuk menambahkan grup parameter cluster baru Anda ke cluster Anda, gunakan AWS CLI `modify-db-cluster` operasi dengan parameter berikut.
+ **-- db-cluster-identifier** — Nama cluster Anda (misalnya,`sample-cluster`).
+ **-- db-cluster-parameter-group -name** — Nama grup parameter yang ingin Anda kaitkan dengan cluster Anda (misalnya,`sample-parameter-group`).
**Example**
```
aws docdb modify-db-cluster \
--db-cluster-identifier sample-cluster \
--db-cluster-parameter-group-name sample-parameter-group
```
Keluaran dari operasi ini terlihat seperti berikut ini (format JSON).
```
"DBCluster": {
"AvailabilityZones": [
"us-west-2c",
"us-west-2b",
"us-west-2a"
],
"BackupRetentionPeriod": 1,
"DBClusterIdentifier": "sample-cluster",
"DBClusterParameterGroup": "sample-parameter-group",
"DBSubnetGroup": "default",
...
}
```
------
# Menyalin grup parameter cluster Amazon DocumentDB
Anda dapat membuat salinan grup parameter cluster di Amazon DocumentDB menggunakan Konsol Manajemen AWS atau AWS Command Line Interface ().AWS CLI
------
#### [ Using the Konsol Manajemen AWS ]
Prosedur berikut memandu Anda membuat grup parameter klaster baru dengan membuat salinan grup parameter klaster yang ada.
**Untuk menyalin grup parameter klaster**
1. [Masuk ke Konsol Manajemen AWS, dan buka konsol Amazon DocumentDB di /docdb. https://console.aws.amazon.com](https://console.aws.amazon.com/docdb)
1. Di panel navigasi, pilih **Grup parameter**.
1. Di panel **Grup parameter klaster**, pilih nama grup parameter klaster yang ingin Anda salin.
1. Pilih **Tindakan**, lalu pilih **Salin** untuk menyalin grup parameter tersebut.
1. Di bawah **Opsi salin**, masukkan nama dan deskripsi untuk grup parameter klaster baru. Kemudian pilih **Salin** untuk menyimpan perubahan Anda.
------
#### [ Using the AWS CLI ]
Untuk membuat salinan grup parameter klaster, gunakan operasi `copy-db-cluster-parameter-group` dengan parameter berikut.
+ **--source-db-cluster-parameter-group-identifier** — Diperlukan. Nama atau Amazon Resource Name (ARN) dari grup parameter klaster yang ingin Anda buat salinannya.
Jika kelompok parameter cluster sumber dan target sama Wilayah AWS, pengenal dapat berupa nama atau ARN.
Jika kelompok parameter cluster sumber dan target berbeda Wilayah AWS, pengenal harus ARN.
+ **--target-db-cluster-parameter-group-identifier** — Diperlukan. Nama atau ARN salinan grup parameter klaster.
Batas:
+ Tidak dapat berupa null, kosong, atau blank.
+ Harus berisi 1-255 huruf, angka, atau tanda hubung.
+ Karakter pertama harus berupa huruf.
+ Tidak dapat diakhiri dengan tanda hubung atau berisi dua tanda hubung berurutan.
+ **--target-db-cluster-parameter-group-description** — Diperlukan. Deskripsi yang diberikan pengguna untuk salinan grup parameter klaster.
**Example**
Kode berikut membuat salinan `sample-parameter-group`, menamai salinan `sample-parameter-group-copy`.
Untuk Linux, macOS, atau Unix:
```
aws docdb copy-db-cluster-parameter-group \
--source-db-cluster-parameter-group-identifier sample-parameter-group \
--target-db-cluster-parameter-group-identifier sample-parameter-group-copy \
--target-db-cluster-parameter-group-description "Copy of sample-parameter-group"
```
Untuk Windows:
```
aws docdb copy-db-cluster-parameter-group ^
--source-db-cluster-parameter-group-identifier sample-parameter-group ^
--target-db-cluster-parameter-group-identifier sample-parameter-group-copy ^
--target-db-cluster-parameter-group-description "Copy of sample-parameter-group"
```
Output dari operasi ini terlihat seperti berikut (format JSON).
```
{
"DBClusterParameterGroup": {
"DBClusterParameterGroupArn": "arn:aws:rds:us-east-1:123456789012:cluster-pg:sample-parameter-group-copy",
"DBClusterParameterGroupName": "sample-parameter-group-copy",
"DBParameterGroupFamily": "docdb4.0",
"Description": "Copy of sample-parameter-group"
}
}
```
------
# Menyetel ulang grup parameter cluster Amazon DocumentDB
Anda dapat mengatur ulang beberapa atau semua nilai parameter grup parameter klaster Amazon DocumentDB ke nilai defaultnya dengan menggunakan Konsol Manajemen AWS atau AWS Command Line Interface AWS CLI() untuk mengatur ulang grup parameter cluster.
------
#### [ Using the Konsol Manajemen AWS ]
Ikuti langkah-langkah ini untuk mengatur ulang beberapa atau semua nilai parameter grup parameter klaster ke nilai defaultnya.
**Untuk mengatur ulang nilai parameter grup parameter klaster**
1. [Masuk ke Konsol Manajemen AWS, dan buka konsol Amazon DocumentDB di /docdb. https://console.aws.amazon.com](https://console.aws.amazon.com/docdb)
1. Di panel navigasi di sisi kiri konsol tersebut, pilih **Grup parameter**.
1. Di panel **Grup parameter klaster**, pilih nama grup parameter klaster yang ingin Anda atur ulang.
1. Pilih **Tindakan**, lalu pilih **Atur Ulang** untuk mengatur ulang grup parameter tersebut.
1. Pada halaman **Konfirmasi reset grup parameter klaster** yang dihasilkan, konfirmasi bahwa Anda ingin mengatur ulang semua parameter klaster untuk grup parameter tersebut ke defaultnya. Kemudian pilih **Atur ulang** untuk mengatur ulang grup parameter Anda. Anda juga dapat memilih **Batal** untuk membuang perubahan Anda.
------
#### [ Using the AWS CLI ]
Untuk mereset beberapa atau semua nilai parameter grup parameter klaster ke nilai defaultnya, gunakan operasi `reset-db-cluster-parameter-group` dengan parameter berikut.
+ **--db-cluster-parameter-group-name** — Diperlukan. Nama grup parameter klaster yang akan diatur ulang.
+ **--parameters** – Opsional. Daftar `ParameterName` dan `ApplyMethod` dalam grup parameter klaster untuk diatur ulang ke nilai defaultnya. Parameter statis harus disetel ke `pending-reboot` agar berlaku pada mulai ulang instans atau permintaan `reboot-db-instance` berikutnya. Anda harus memanggil `reboot-db-instance` untuk setiap instans di klaster yang Anda inginkan untuk menerapkan parameter statis yang diperbarui.
Parameter ini dan `--reset-all-parameters` saling eksklusif: Anda dapat menggunakan salah satunya tetapi tidak keduanya.
+ **--reset-all-parameters** atau **--no-reset-all-parameters** — Opsional. Menentukan apakah akan mengatur ulang semua parameter (`--reset-all-parameters` atau hanya beberapa parameter (`--no-reset-all-parameters`) ke nilai defaultnya. Parameter `--reset-all-parameters` dan `--parameters` saling eksklusif: Anda dapat menggunakan salah satunya tetapi tidak keduanya.
Saat Anda mengatur ulang seluruh grup, parameter dinamis segera diperbarui. Parameter statis diatur ke `pending-reboot` untuk diterapkan pada mulai ulang instans atau permintaan `reboot-db-instance` berikutnya. Anda harus memanggil `reboot-db-instance` untuk setiap instans di klaster yang Anda inginkan untuk menerapkan parameter statis yang diperbarui.
**Example**
**Contoh 1: Mengatur ulang semua parameter ke nilai defaultnya**
Kode berikut mengatur ulang semua parameter di grup parameter klaster `sample-parameter-group` nilai defaultnya.
Untuk Linux, macOS, atau Unix:
```
aws docdb reset-db-cluster-parameter-group \
--db-cluster-parameter-group-name sample-parameter-group \
--reset-all-parameters
```
Untuk Windows:
```
aws docdb reset-db-cluster-parameter-group ^
--db-cluster-parameter-group-name sample-parameter-group ^
--reset-all-parameters
```
**Contoh 2: Mengatur ulang parameter yang ditentukan ke nilai defaultnya**
Kode berikut mengatur ulang parameter `tls` di grup parameter klaster `sample-parameter-group` ke nilai defaultnya.
Untuk Linux, macOS, atau Unix:
```
aws docdb reset-db-cluster-parameter-group \
--db-cluster-parameter-group-name sample-parameter-group \
--no-reset-all-parameters \
--parameters ParameterName=tls,ApplyMethod=pending-reboot
```
Untuk Windows:
```
aws docdb reset-db-cluster-parameter-group ^
--db-cluster-parameter-group-name sample-parameter-group ^
--no-reset-all-parameters ^
--parameters ParameterName=tls,ApplyMethod=pending-reboot
```
Output dari operasi ini terlihat seperti berikut (format JSON).
```
{
"DBClusterParameterGroupName": "sample-parameter-group"
}
```
**Melakukan reboot instans klaster**
Sebelum nilai parameter statis diubah, instans klaster harus di-boot ulang. Reboot setiap instans di klaster Anda yang Anda inginkan untuk menerapkan parameter statis yang diperbarui.
Untuk Linux, macOS, atau Unix:
```
aws docdb reboot-db-instance \
--db-instance-identifier sample-cluster-instance
```
Untuk Windows:
```
aws docdb reboot-db-instance ^
--db-instance-identifier sample-cluster-instance
```
------
# Menghapus grup parameter cluster Amazon DocumentDB
Anda dapat menghapus grup parameter cluster Amazon DocumentDB kustom menggunakan Konsol Manajemen AWS atau AWS Command Line Interface ().AWS CLI Anda tidak dapat menghapus grup parameter klaster `default.docdb4.0`.
------
#### [ Using the Konsol Manajemen AWS ]
**Untuk menghapus grup parameter klaster**
1. [Masuk ke Konsol Manajemen AWS, dan buka konsol Amazon DocumentDB di /docdb. https://console.aws.amazon.com](https://console.aws.amazon.com/docdb)
1. Di panel navigasi, pilih **Grup parameter**.
**Tip**
Jika Anda tidak melihat panel navigasi di sisi kiri layar, pilih ikon menu (![\[Hamburger menu icon with three horizontal lines.\]](http://docs.aws.amazon.com/id_id/documentdb/latest/developerguide/images/docdb-menu-icon.png)) di pojok kiri atas halaman.
1. Di panel **Grup parameter**, pilih tombol radio di sebelah kiri grup parameter klaster yang ingin Anda hapus.
1. Pilih **Tindakan**, lalu pilih **Hapus**.
1. Di panel konfirmasi **Hapus**, pilih **Hapus** untuk menghapus grup parameter klaster. Untuk mempertahankan grup parameter klaster, pilih **Batal**.
------
#### [ Using the AWS CLI ]
Untuk menghapus grup parameter klaster, gunakan operasi `delete-db-cluster-parameter-group` dengan parameter berikut.
+ **--db-cluster-parameter-group-name** — Diperlukan. Nama grup parameter klaster yang akan dihapus. Ini harus menjadi grup parameter klaster yang sudah ada. *Anda tidak dapat menghapus grup parameter `default.docdb4.0` cluster.*
**Example - Menghapus grup parameter klaster**
Contoh berikut memandu Anda menjalani tiga langkah untuk menghapus grup parameter klaster:
1. Menemukan nama grup parameter klaster yang ingin Anda hapus.
1. Menghapus grup parameter klaster yang ditentukan.
1. Memverifikasi bahwa grup parameter klaster telah dihapus.
**1. Temukan nama grup parameter klaster yang ingin Anda hapus.**
Kode berikut mencantumkan nama semua grup parameter klaster.
Untuk Linux, macOS, atau Unix:
```
aws docdb describe-db-cluster-parameter-groups \
--query 'DBClusterParameterGroups[*].[DBClusterParameterGroupName]'
```
Untuk Windows:
```
aws docdb describe-db-cluster-parameter-groups ^
--query 'DBClusterParameterGroups[*].[DBClusterParameterGroupName]'
```
Output dari operasi sebelumnya adalah daftar nama grup parameter klaster yang mirip dengan berikut ini (format JSON).
```
[
[
"default.docdb4.0"
],
[
"sample-parameter-group"
],
[
"sample-parameter-group-copy"
]
]
```
**2. Menghapus grup parameter klaster tertentu.**
Kode berikut menghapus grup parameter klaster `sample-parameter-group-copy`.
Untuk Linux, macOS, atau Unix:
```
aws docdb delete-db-cluster-parameter-group \
--db-cluster-parameter-group-name sample-parameter-group-copy
```
Untuk Windows:
```
aws docdb delete-db-cluster-parameter-group ^
--db-cluster-parameter-group-name sample-parameter-group-copy
```
Tidak ada output dari operasi ini.
**3. Verifikasi bahwa grup parameter klaster yang ditentukan telah dihapus.**
Kode berikut mencantumkan nama semua grup parameter klaster yang tersisa.
Untuk Linux, macOS, atau Unix:
```
aws docdb describe-db-cluster-parameter-groups \
--query 'DBClusterParameterGroups[*].[DBClusterParameterGroupName]'
```
Untuk Windows:
```
aws docdb describe-db-cluster-parameter-groups ^
--query 'DBClusterParameterGroups[*].[DBClusterParameterGroupName]'
```
Output dari operasi sebelumnya adalah daftar grup parameter klaster yang mirip dengan berikut ini (format JSON). Grup parameter klaster yang baru saja Anda hapus tidak boleh ada dalam daftar.
Output dari operasi ini terlihat seperti berikut (format JSON).
```
[
[
"default.docdb4.0"
],
[
"sample-parameter-group"
]
]
```
------
# Referensi parameter cluster Amazon DocumentDB
Saat Anda mengubah parameter dinamis dan menyimpan grup parameter klaster, perubahan akan segera diterapkan terlepas dari pengaturan *Terapkan segera*. Saat Anda mengubah parameter statis dan menyimpan grup parameter klaster, perubahan parameter akan berlaku setelah Anda melakukan reboot instans secara manual. Anda dapat melakukan reboot instans menggunakan konsol Amazon DocumentDB atau dengan memanggil `reboot-db-instance` secara eksplisit.
Tabel berikut menunjukkan parameter yang berlaku untuk semua instans di klaster Amazon DocumentDB.
**Parameter tingkat klaster Amazon DocumentDB**
| Parameter | Nilai default | Nilai valid | Dapat diubah | Tipe Penerapan | Tipe data | Deskripsi |
| --- | --- | --- | --- | --- | --- | --- |
| audit\$1logs | dinonaktifkan | diaktifkan, dinonaktifkan, ddl, dml\$1read, dml\$1write, semua, tidak ada | Ya | Dinamis | String | Menentukan apakah log CloudWatch audit Amazon diaktifkan. [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/documentdb/latest/developerguide/cluster_parameter_groups-list_of_parameters.html) |
| change\$1stream\$1log\$1retention\$1duration | 10800 | 3600-604800 | Ya | Dinamis | Bilangan Bulat | Menentukan durasi waktu (dalam detik) bahwa log aliran perubahan dipertahankan dan dapat digunakan. |
| default\$1collection\$1compression | dinonaktifkan | diaktifkan, dinonaktifkan (Amazon DocumentDB 5.0) /zstd, lz4, tidak ada (Dokumen Amazon .0) DB8 | Ya | Dinamis | String | Mendefinisikan pengaturan kompresi default untuk koleksi baru dalam sebuah cluster [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/documentdb/latest/developerguide/cluster_parameter_groups-list_of_parameters.html) |
| profiler | dinonaktifkan | diaktifkan, dinonaktifkan | Ya | Dinamis | String | Mengaktifkan pembuatan profil untuk operasi yang lambat. [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/documentdb/latest/developerguide/cluster_parameter_groups-list_of_parameters.html) |
| profiler\$1sampling\$1rate | 1.0 | 0,0-1,0 | Ya | Dinamis | Desimal | Menentukan laju pengambilan sampel untuk operasi yang dicatat. |
| profiler\$1threshold\$1ms | 100 | 50-2147483646 | Ya | Dinamis | Bilangan Bulat | Mendefinisikan ambang batas untuk profiler. [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/documentdb/latest/developerguide/cluster_parameter_groups-list_of_parameters.html) |
| planner\$1version | 3.0 | 1.0, 2.0, 3.0 | Ya | Dinamis | Desimal | Mendefinisikan versi perencana kueri yang akan digunakan untuk kueri.[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/documentdb/latest/developerguide/cluster_parameter_groups-list_of_parameters.html) |
| tls | diaktifkan | diaktifkan, dinonaktifkan, fips-140-3, tls1.2 \$1, tls1.3 \$1 | Ya | Statis | String | Menentukan apakah koneksi Transport Layer Security (TLS) diperlukan. [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/documentdb/latest/developerguide/cluster_parameter_groups-list_of_parameters.html) |
| ttl\$1monitor | diaktifkan | diaktifkan, dinonaktifkan | Ya | Dinamis | String | Menentukan apakah pemantauan Time to Live (TTL) diaktifkan untuk klaster. [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/documentdb/latest/developerguide/cluster_parameter_groups-list_of_parameters.html) |
# Memodifikasi parameter cluster Amazon DocumentDB
Di Amazon DocumentDB, *grup parameter klaster* terdiri dari *parameter* yang berlaku untuk semua instans yang Anda buat di klaster. Untuk grup parameter klaster kustom, Anda dapat mengubah nilai parameter kapan saja atau mengatur ulang semua nilai parameter ke default untuk grup parameter yang Anda buat. Bagian ini menjelaskan cara melihat parameter yang membentuk grup parameter klaster Amazon DocumentDB dan nilainya, dan bagaimana Anda dapat mengubah atau memperbarui nilai ini.
Parameter bisa *dinamis* atau *statis*. Saat Anda mengubah parameter dinamis dan menyimpan grup parameter klaster, perubahan akan segera diterapkan terlepas dari pengaturan `Apply Immediately`. Saat Anda mengubah parameter statis dan menyimpan grup parameter klaster, perubahan parameter hanya berlaku setelah Anda melakukan reboot instans secara manual.
## Melihat parameter grup parameter cluster Amazon DocumentDB
Anda dapat melihat parameter cluster Amazon DocumentDB dan nilainya menggunakan atau. Konsol Manajemen AWS AWS CLI
------
#### [ Using the Konsol Manajemen AWS ]
**Untuk melihat detail grup parameter klaster**
1. [Masuk ke Konsol Manajemen AWS, dan buka konsol Amazon DocumentDB di /docdb. https://console.aws.amazon.com](https://console.aws.amazon.com/docdb)
1. Di panel navigasi, pilih **Grup parameter**.
**Tip**
Jika Anda tidak melihat panel navigasi di sisi kiri layar, pilih ikon menu (![\[Hamburger menu icon with three horizontal lines.\]](http://docs.aws.amazon.com/id_id/documentdb/latest/developerguide/images/docdb-menu-icon.png)) di pojok kiri atas halaman.
1. Di panel **Grup parameter**, pilih nama grup parameter klaster yang ingin Anda lihat detailnya.
1. Halaman yang dihasilkan menunjukkan nilai berikut untuk setiap parameter: nama parameter, nilai saat ini, nilai yang diizinkan, apakah parameter dapat dimodifikasi, jenis penerapan, tipe data, dan deskripsi.
![\[Tangkapan layar: Nama dan nilai parameter.\]](http://docs.aws.amazon.com/id_id/documentdb/latest/developerguide/images/docdb-determine-parameter-value.png)
------
#### [ Using the AWS CLI ]
Untuk melihat parameter grup parameter klaster dan nilainya, gunakan operasi `describe-db-cluster-parameters` dengan parameter berikut.
+ **--db-cluster-parameter-group-name** — Diperlukan. Nama grup parameter klaster yang Anda inginkan daftar parameternya secara mendetail.
+ **--source** – Opsional. Jika disediakan, mengembalikan hanya parameter untuk sumber tertentu. Sumber parameter dapat berupa `engine-default`, `system`, atau `user`.
**Example**
Kode berikut mencantumkan parameter dan nilainya untuk grup parameter `custom3-6-param-grp`. Untuk informasi lebih lanjut tentang grup parameter, hilangkan garis `--query`. Untuk informasi tentang semua grup parameter, hilangkan garis `--db-cluster-parameter-group-name`.
Untuk Linux, macOS, atau Unix:
```
aws docdb describe-db-cluster-parameters \
--db-cluster-parameter-group-name custom3-6-param-grp \
--query 'Parameters[*].[ParameterName,ParameterValue]'
```
Untuk Windows:
```
aws docdb describe-db-cluster-parameters ^
--db-cluster-parameter-group-name custom3-6-param-grp ^
--query 'Parameters[*].[ParameterName,ParameterValue]'
```
Output dari operasi ini terlihat seperti berikut (format JSON).
```
[
[
"audit_logs",
"disabled"
],
[
"tls",
"enabled"
],
[
"ttl_monitor",
"enabled"
]
]
```
------
## Memodifikasi parameter grup parameter cluster Amazon DocumentDB
Anda dapat memodifikasi parameter grup parameter menggunakan Konsol Manajemen AWS atau AWS CLI.
------
#### [ Using the Konsol Manajemen AWS ]
**Untuk memperbarui parameter grup parameter klaster**
1. [Masuk ke Konsol Manajemen AWS, dan buka konsol Amazon DocumentDB di /docdb. https://console.aws.amazon.com](https://console.aws.amazon.com/docdb)
1. Di panel navigasi, pilih **Grup parameter**.
**Tip**
Jika Anda tidak melihat panel navigasi di sisi kiri layar, pilih ikon menu (![\[Hamburger menu icon with three horizontal lines.\]](http://docs.aws.amazon.com/id_id/documentdb/latest/developerguide/images/docdb-menu-icon.png)) di pojok kiri atas halaman.
1. Di panel **Grup parameter**, pilih grup parameter klaster yang ingin Anda perbarui parameternya.
1. Halaman yang dihasilkan menunjukkan parameter dan detail yang sesuai untuk grup parameter klaster ini. Pilih parameter untuk diperbarui.
1. Di kanan atas halaman, pilih **Edit** untuk mengubah nilai parameter. Untuk informasi selengkapnya tentang tipe parameter klaster, lihat [Referensi parameter cluster Amazon DocumentDB](cluster_parameter_groups-list_of_parameters.md).
1. Buat perubahan Anda, lalu pilih **Ubah parameter klaster** untuk menyimpan perubahan. Untuk membuang perubahan Anda, pilih **Batal**.
------
#### [ Using the AWS CLI ]
Untuk mengubah parameter grup parameter klaster, gunakan operasi `modify-db-cluster-parameter-group` dengan parameter berikut:
+ **--db-cluster-parameter-group-name** — Diperlukan. Nama grup parameter klaster yang Anda modifikasi.
+ **--parameters** — Diperlukan. Parameter atau parameter yang Anda modifikasi. Setiap entri parameter harus menyertakan hal berikut:
+ **ParameterName** — Nama parameter yang Anda ubah.
+ **ParameterValue** — Nilai baru untuk parameter ini.
+ **ApplyMethod** — Bagaimana Anda ingin perubahan pada parameter ini diterapkan. Nilai yang diizinkan adalah `immediate` dan `pending-reboot`.
**catatan**
Parameter dengan `ApplyType` dari `static` harus memiliki `ApplyMethod` dari `pending-reboot`.
**Untuk mengubah nilai parameter grup parameter klaster (AWS CLI)**
Contoh berikut mengubah parameter `tls`.
1. **Buat daftar parameter dan nilainya `sample-parameter-group`**
Untuk Linux, macOS, atau Unix:
```
aws docdb describe-db-cluster-parameters \
--db-cluster-parameter-group-name sample-parameter-group
```
Untuk Windows:
```
aws docdb describe-db-cluster-parameters ^
--db-cluster-parameter-group-name sample-parameter-group
```
Output dari operasi ini terlihat seperti berikut (format JSON).
```
{
"Parameters": [
{
"Source": "system",
"ApplyType": "static",
"AllowedValues": "disabled,enabled",
"ParameterValue": "enabled",
"ApplyMethod": "pending-reboot",
"DataType": "string",
"ParameterName": "tls",
"IsModifiable": true,
"Description": "Config to enable/disable TLS"
},
{
"Source": "user",
"ApplyType": "dynamic",
"AllowedValues": "disabled,enabled",
"ParameterValue": "enabled",
"ApplyMethod": "pending-reboot",
"DataType": "string",
"ParameterName": "ttl_monitor",
"IsModifiable": true,
"Description": "Enables TTL Monitoring"
}
]
}
```
1. **Ubah parameter `tls` sehingga nilainya menjadi `disabled`**. Anda tidak dapat mengubah `ApplyMethod` karena `ApplyType` adalah `static`.
Untuk Linux, macOS, atau Unix:
```
aws docdb modify-db-cluster-parameter-group \
--db-cluster-parameter-group-name sample-parameter-group \
--parameters "ParameterName"=tls,ParameterValue=disabled,ApplyMethod=pending-reboot"
```
Untuk Windows:
```
aws docdb modify-db-cluster-parameter-group ^
--db-cluster-parameter-group-name sample-parameter-group ^
--parameters "ParameterName=tls,ParameterValue=disabled,ApplyMethod=pending-reboot"
```
Output dari operasi ini terlihat seperti berikut (format JSON).
```
{
"DBClusterParameterGroupName": "sample-parameter-group"
}
```
1. **Tunggu setidaknya 5 menit.**
1. **Buat daftar nilai parameter dari`sample-parameter-group`.**
Untuk Linux, macOS, atau Unix:
```
aws docdb describe-db-cluster-parameters \
--db-cluster-parameter-group-name sample-parameter-group
```
Untuk Windows:
```
aws docdb describe-db-cluster-parameters ^
--db-cluster-parameter-group-name sample-parameter-group
```
Output dari operasi ini terlihat seperti berikut (format JSON).
```
{
"Parameters": [
{
"ParameterName": "audit_logs",
"ParameterValue": "disabled",
"Description": "Enables auditing on cluster.",
"Source": "system",
"ApplyType": "dynamic",
"DataType": "string",
"AllowedValues": "enabled,disabled",
"IsModifiable": true,
"ApplyMethod": "pending-reboot"
},
{
"ParameterName": "tls",
"ParameterValue": "disabled",
"Description": "Config to enable/disable TLS",
"Source": "user",
"ApplyType": "static",
"DataType": "string",
"AllowedValues": "disabled,enabled",
"IsModifiable": true,
"ApplyMethod": "pending-reboot"
}
]
}
```
------