Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.
# Modifica dei gruppi di parametri del cluster Amazon DocumentDB
Questa sezione spiega come modificare un gruppo di parametri Amazon DocumentDB *personalizzato*. In Amazon DocumentDB, non è possibile modificare un gruppo di parametri del `default` cluster creato quando si crea per la prima volta un cluster con una nuova versione del motore in una nuova regione. Se il tuo cluster Amazon DocumentDB utilizza il gruppo di parametri del cluster predefinito e desideri modificare un valore al suo interno, devi prima [creare un nuovo gruppo di parametri](https://docs.aws.amazon.com//documentdb/latest/developerguide/cluster_parameter_groups-create.html) o [copiare un gruppo di parametri esistente](https://docs.aws.amazon.com//documentdb/latest/developerguide/cluster_parameter_groups-copy.html), modificarlo e quindi applicare il gruppo di parametri modificato al cluster.
Completa i seguenti passaggi per modificare un gruppo di parametri del cluster personalizzato. La propagazione delle azioni di modifica potrebbe richiedere del tempo. Attendi che il gruppo di parametri del cluster modificato sia disponibile prima di collegarlo al cluster. È possibile utilizzare l' AWS CLI `describe-db-cluster-parameters`operazione Console di gestione AWS o per verificare che il gruppo di parametri del cluster sia stato modificato. Per ulteriori informazioni, consulta [Descrizione dei gruppi di parametri del cluster](cluster_parameter_groups-describe.md).
------
#### [ Using the Console di gestione AWS ]
Segui questi passaggi per modificare un gruppo di parametri Amazon DocumentDB personalizzato. Non puoi modificare un gruppo di parametri `default`. Se desideri modificare un valore nel gruppo di parametri `default`, puoi [copiare il gruppo di parametri del cluster predefinito](https://docs.aws.amazon.com//documentdb/latest/developerguide/cluster_parameter_groups-copy.html), modificarlo e quindi applicare il gruppo di parametri modificato al cluster. Per ulteriori informazioni sull'applicazione dei gruppi di parametri al cluster, consulta [Modifica di un cluster Amazon DocumentDB](db-cluster-modify.md).
**Per modificare un gruppo di parametri del cluster personalizzato**
1. [Accedi a e apri Console di gestione AWS la console Amazon DocumentDB all'indirizzo https://console.aws.amazon.com /docdb.](https://console.aws.amazon.com/docdb)
1. Nel riquadro di navigazione sul lato sinistro della console scegli **Parameter groups (Gruppi di parametri)**. Nell'elenco dei gruppi di parametri, scegli il nome del gruppo di parametri da modificare.
**Suggerimento**
Se il riquadro di navigazione non viene visualizzato sul lato sinistro della schermata, scegliere l'icona del menu (![\[Hamburger menu icon with three horizontal lines.\]](http://docs.aws.amazon.com/it_it/documentdb/latest/developerguide/images/docdb-menu-icon.png)) nell'angolo in alto a sinistra della pagina.
1. Per ogni parametro nel gruppo di parametri che desideri modificare, procedi nel seguente modo:
1. Individua il parametro che vuoi modificare e verifica che sia modificabile controllando se è elencato come `true` nella colonna **Modifiable (Modificabile)**.
1. Se è modificabile, seleziona il parametro e scegli **Edit (Modifica)** in alto a destra nella pagina della console.
1. Nella finestra di dialogo **Modify `` (Modifica)**, apporta le modifiche desiderate. Quindi scegli **Modify cluster parameter (Modifica parametro del cluster)** oppure scegli **Cancel (Annulla)** per annullare le modifiche.
------
#### [ Using the AWS CLI ]
Puoi modificare o modificare qualsiasi parametro modificabile in un gruppo `ApplyMethod` di parametri del cluster Amazon DocumentDB personalizzato utilizzando il. `ParameterValue` `Description` AWS CLI Non puoi apportare modifiche direttamente in un gruppo di parametri del cluster predefinito.
Per modificare i parametri di un gruppo di parametri del cluster personalizzato, utilizza l'operazione `modify-db-cluster-parameter-group` con i parametri seguenti.
+ **--db-cluster-parameter-group-name**: obbligatorio. Il nome del gruppo di parametri del cluster che stai modificando.
+ **--parameters**: obbligatorio. I parametri che stai modificando. Per un elenco dei parametri che si applicano a tutte le istanze in un cluster Amazon DocumentDB, consulta la. [Riferimento ai parametri del cluster Amazon DocumentDB](cluster_parameter_groups-list_of_parameters.md) Ogni voce del parametro deve includere:
+ **ParameterName**— Il nome del parametro che stai modificando.
+ **ParameterValue**— Il nuovo valore per questo parametro.
+ **ApplyMethod**— Come si desidera applicare le modifiche a questo parametro. I valori consentiti sono `immediate` e `pending-reboot`.
**Nota**
I parametri con `ApplyType` per `static` devono avere `ApplyMethod` per `pending-reboot`.
**Example - Modifica del valore di un parametro**
In questo esempio, puoi elencare i valori dei parametri di `sample-parameter-group` e modificare il parametro `tls`. Quindi, dopo 5 minuti, puoi elencare di nuovo i valori dei parametri di `sample-parameter-group` per visualizzare i valori modificati.
1. Elenca i parametri e i relativi valori di `sample-parameter-group`.
Per Linux, macOS o Unix:
```
aws docdb describe-db-cluster-parameters \
--db-cluster-parameter-group-name sample-parameter-group
```
Per Windows:
```
aws docdb describe-db-cluster-parameters ^
--db-cluster-parameter-group-name sample-parameter-group
```
L'aspetto dell'output di questa operazione è simile al seguente (formato 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. Modifica il parametro `tls` in modo che il valore sia `disabled`.
Non puoi modificare `ApplyMethod` perché `ApplyType` è `static`.
Per Linux, macOS o Unix:
```
aws docdb modify-db-cluster-parameter-group \
--db-cluster-parameter-group-name sample-parameter-group \
--parameters "ParameterName"=tls,"ParameterValue"=disabled,"ApplyMethod"=pending-reboot
```
Per Windows:
```
aws docdb modify-db-cluster-parameter-group ^
--db-cluster-parameter-group-name sample-parameter-group ^
--parameters "ParameterName"=tls,"ParameterValue"=disabled,"ApplyMethod"=pending-reboot
```
L'aspetto dell'output di questa operazione è simile al seguente (formato JSON).
```
{
"DBClusterParameterGroupName": "sample-parameter-group"
}
```
1. Attendi almeno 5 minuti.
1. Elenca i valori dei parametri di `sample-parameter-group` per verificare che il parametro `tls` sia stato modificato.
Per Linux, macOS o Unix:
```
aws docdb describe-db-cluster-parameters \
--db-cluster-parameter-group-name sample-parameter-group
```
Per Windows:
```
aws docdb describe-db-cluster-parameters ^
--db-cluster-parameter-group-name sample-parameter-group
```
L'aspetto dell'output di questa operazione è simile al seguente (formato 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"
}
]
}
```
------