Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

# Memodifikasi parameter cluster Amazon DocumentDB
<a name="cluster_parameter_groups-parameters"></a>

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
<a name="cluster_parameter_groups-describe_details_parameters"></a>

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
<a name="cluster_parameter_groups-modify_parameters"></a>

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"
           }
       ]
   }
   ```

------