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à.
# Gestione dei gruppi di parametri del cluster Amazon DocumentDB
Puoi gestire la configurazione del motore Amazon DocumentDB utilizzando i parametri in un gruppo di parametri del cluster. Un *gruppo di parametri del cluster* è una raccolta di valori di configurazione di Amazon DocumentDB che semplificano la gestione dei parametri dei cluster Amazon DocumentDB. I gruppi di parametri del cluster fungono da container per i valori di configurazione del motore applicati a tutte le istanze nel cluster.
In questa sezione viene descritto come creare, visualizzare e modificare i gruppi di parametri del cluster. Viene inoltre illustrato come puoi individuare a quale gruppo di parametri è associato a un determinato cluster.
**Topics**
+ [Descrizione dei gruppi di parametri del cluster](cluster_parameter_groups-describe.md)
+ [Creazione di gruppi di parametri del cluster](cluster_parameter_groups-create.md)
+ [Modifica dei gruppi di parametri del cluster](cluster_parameter_groups-modify.md)
+ [Modifica dei cluster per utilizzare gruppi di parametri di cluster personalizzati](cluster_parameter_groups-modify_clusters.md)
+ [Copia dei gruppi di parametri del cluster](cluster_parameter_groups-copy.md)
+ [Reimpostazione dei gruppi di parametri del cluster](cluster_parameter_groups-reset.md)
+ [Eliminazione di gruppi di parametri del cluster](cluster_parameter_groups-delete.md)
+ [Riferimento ai parametri del cluster](cluster_parameter_groups-list_of_parameters.md)
# Descrizione dei gruppi di parametri del cluster Amazon DocumentDB
Un gruppo di parametri del `default` cluster viene creato automaticamente quando si crea il primo cluster Amazon DocumentDB in una nuova regione o si utilizza un nuovo motore. I cluster successivi, creati nella stessa regione e con la stessa versione del motore, vengono creati con il `default` gruppo di parametri del cluster.
**Topics**
+ [Descrizione dei dettagli di un gruppo di parametri del cluster](#cluster_parameter_groups-describe_details)
+ [Determinazione del gruppo di parametri di un cluster](#cluster_parameter_groups-determine)
+ [Determinazione dei cluster e delle istanze associati a un gruppo di parametri del cluster](#cluster_parameter_groups-count)
## Descrizione dei dettagli di un gruppo di parametri del cluster Amazon DocumentDB
Per descrivere i dettagli di un determinato gruppo di parametri del cluster, completa i seguenti passaggi utilizzando Console di gestione AWS o il AWS Command Line Interface (AWS CLI).
------
#### [ Using the Console di gestione AWS ]
****
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 scegliere **Parameter groups (Gruppi di parametri)**.
**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. Nel riquadro **Parameter groups (Gruppi di parametri)**, selezionare il gruppo di parametri del cluster di cui si desidera visualizzare i dettagli.
1. La pagina risultante mostra i parametri, l'attività recente e i tag del gruppo di parametri.
+ In **Cluster parameters (Parametri cluster)** puoi vedere il nome, il valore corrente, i valori consentiti, il tipo di dati e la descrizione del parametro e specifica se il parametro è modificabile. Puoi modificare i singoli parametri selezionando il parametro e scegliendo **Edit (Modifica)** nella sezione **Cluster parameters (Parametri cluster)**. Per ulteriori informazioni, consulta [Modifica dei parametri del cluster Amazon DocumentDB](cluster_parameter_groups-parameters.md).
+ In **Recent events (Eventi recenti)**, puoi vedere gli eventi più recenti per questo gruppo di parametri. Puoi filtrare questi eventi utilizzando la barra di ricerca in questa sezione. Per ulteriori informazioni, consulta [Gestione degli eventi di Amazon DocumentDB](managing-events.md).
+ In **Tags (Tag)** puoi visualizzare i tag di questo gruppo di parametri del cluster. Puoi aggiungere o rimuovere i tag scegliendo **Edit (Modifica)** nella sezione **Tags (Tag)**. Per ulteriori informazioni, consulta [Etichettatura delle risorse di Amazon DocumentDB](tagging.md).
------
#### [ Using the AWS CLI ]
Puoi utilizzare il `describe-db-cluster-parameter-groups` AWS CLI comando per visualizzare Amazon Resource Name (ARN), famiglia, descrizione e nome di un singolo gruppo di parametri del cluster o di tutti i gruppi di parametri del cluster di cui disponi per Amazon DocumentDB. Puoi anche utilizzare il `describe-db-cluster-parameters` AWS CLI comando per visualizzare i parametri e i relativi dettagli all'interno di un singolo gruppo di parametri del cluster.
+ **--describe-db-cluster-parameter-groups**— Per visualizzare un elenco di tutti i gruppi di parametri del cluster e i relativi dettagli.
+ **--db-cluster-parameter-group-name**— Facoltativo. Il nome del gruppo di parametri del cluster da descrivere. Se questo parametro viene omesso, vengono descritti tutti i gruppi di parametri del cluster.
+ **--describe-db-cluster-parameters**— Per elencare tutti i parametri all'interno di un gruppo di parametri e i relativi valori.
+ **--db-cluster-parameter-group name**: obbligatorio. Il nome del gruppo di parametri del cluster da descrivere.
**Example**
Il codice seguente elenca fino a 100 gruppi di parametri del cluster con relativi ARN, famiglia, descrizione e nome.
```
aws docdb describe-db-cluster-parameter-groups
```
L'aspetto dell'output di questa operazione è simile al seguente (formato 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**
Il codice seguente elenca l'ARN, la famiglia, la descrizione e il nome per `sample-parameter-group`.
Per Linux, macOS o Unix:
```
aws docdb describe-db-cluster-parameter-groups \
--db-cluster-parameter-group-name sample-parameter-group
```
Per Windows:
```
aws docdb describe-db-cluster-parameter-groups ^
--db-cluster-parameter-group-name sample-parameter-group
```
L'aspetto dell'output di questa operazione è simile al seguente (formato 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**
Il codice seguente elenca i valori dei parametri in `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": [
{
"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"
}
]
}
```
------
## Determinazione del gruppo di parametri di un cluster Amazon DocumentDB
Per determinare quale gruppo di parametri è associato a un particolare cluster, completa i passaggi seguenti utilizzando Console di gestione AWS o il AWS CLI.
------
#### [ Using the Console di gestione AWS ]
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 pannello di navigazione a sinistra, seleziona **Cluster**.
1. Dall'elenco dei cluster seleziona il nome del cluster desiderato.
1. La pagina risultante mostra i dettagli del cluster selezionato. Scorri verso il basso fino a **Cluster details (Dettagli del cluster)**. Nella parte inferiore della sezione, individua il nome del gruppo di parametri sotto **Cluster parameter group (Gruppo di parametri del cluster)**.
![\[Screenshot: visualizzazione del gruppo di parametri di un cluster.\]](http://docs.aws.amazon.com/it_it/documentdb/latest/developerguide/images/docdb-determine-parameter-group.png)
------
#### [ Using the AWS CLI ]
Il AWS CLI codice seguente determina quale gruppo di parametri governa il cluster. `sample-cluster`
```
aws docdb describe-db-clusters \
--db-cluster-identifier sample-cluster \
--query 'DBClusters[*].[DBClusterIdentifier,DBClusterParameterGroup]'
```
L'aspetto dell'output di questa operazione è simile al seguente (formato JSON).
```
[
[
"sample-cluster",
"sample-parameter-group"
]
]
```
------
## Determinazione di cluster e istanze associati a un gruppo di parametri del cluster Amazon DocumentDB
Per determinare il numero di cluster e istanze associati a ciascun gruppo di parametri, completa i passaggi seguenti utilizzando. AWS CLI
------
#### [ Using the AWS CLI ]
Il AWS CLI codice seguente determina a quanti cluster e istanze sono associati. `sample-parameter-group`
Per Linux, macOS o 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
}) | .[]'
```
Per 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
}) | .[]'
```
L'aspetto dell'output di questa operazione è simile al seguente (formato JSON).
```
{
"parameter_group_name": "sample-parameter-group",
"total_clusters": 50,
"total_instances": 150
}
```
------
# Creazione di gruppi di parametri del cluster Amazon DocumentDB
Gruppi di parametri di cluster predefiniti come `default.docdb5.0``default.docdb4.0`, o`default.docdb3.6`, vengono creati quando crei un cluster con una nuova versione del motore e in una nuova regione. I cluster successivi creati in questa regione e con la stessa versione del motore ereditano il gruppo di parametri del `default` cluster. Una volta creati, i gruppi di `default` parametri non possono essere eliminati o rinominati. Puoi modificare il comportamento del motore delle istanze del cluster creando un gruppo di parametri personalizzato con valori di parametri preferiti e collegandolo al tuo cluster Amazon DocumentDB.
La seguente procedura ti guida nella creazione di un gruppo di parametri del cluster personalizzato. Quindi puoi [modificare i parametri all'interno del gruppo](https://docs.aws.amazon.com//documentdb/latest/developerguide/cluster_parameter_groups-modify.html).
**Nota**
Dopo aver creato un gruppo di parametri del cluster, devi attendere almeno 5 minuti prima di poterlo utilizzare. Ciò consente ad Amazon DocumentDB di completare completamente l'`create`azione prima che il gruppo di parametri del cluster venga utilizzato per un nuovo cluster. È possibile utilizzare l'`describe-db-cluster-parameter-groups` AWS CLI operazione Console di gestione AWS o per verificare che il gruppo di parametri del cluster sia stato creato. Per ulteriori informazioni, consulta [Descrizione dei gruppi di parametri del cluster Amazon DocumentDB](cluster_parameter_groups-describe.md).
------
#### [ Using the Console di gestione AWS ]
**Per creare un gruppo di parametri del cluster**
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 scegliere **Parameter groups (Gruppi di parametri)**.
**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. Nel riquadro **Cluster parameter groups (Gruppi di parametri del cluster)**, scegliere **Create (Crea)**.
1. Nel riquadro **Create cluster parameter group (Crea gruppo di parametri del cluster)** immettere quanto segue:
1. **Nuovo nome del gruppo di parametri del cluster**: inserisci un nome per il gruppo di parametri del cluster. Ad esempio, `sample-parameter-group`. I gruppi di parametri del cluster hanno i seguenti vincoli di denominazione:
+ La lunghezza è compresa tra 1 e 255 caratteri alfanumerici.
+ Il primo carattere deve essere una lettera.
+ Non può terminare con un trattino o contenere due trattini consecutivi.
1. **Famiglia**: scegli una versione di DocumentDB che intendi utilizzare per il tuo cluster.
1. **Descrizione**: fornisce una descrizione per questo gruppo di parametri del cluster.
1. Per creare il gruppo di parametri del cluster, scegli **Create (Crea)**. Per annullare l'operazione, scegli **Cancel (Annulla)**.
1. Dopo aver scelto **Create (Crea)**, nella parte superiore della pagina viene visualizzato il testo seguente per verificare che il gruppo di parametri del cluster sia stato creato:
```
Successfully created cluster parameter group 'sample-parameter-group'.
```
------
#### [ Using the AWS CLI ]
Per creare un nuovo gruppo di parametri del cluster per i cluster Amazon DocumentDB 4.0, utilizza l' AWS CLI `create-db-cluster-parameter-group`operazione con i seguenti parametri:
+ **--db-cluster-parameter-group-name**— Il nome del gruppo di parametri del cluster personalizzato. Ad esempio, `sample-parameter-group`.
+ **--db-cluster-parameter-group-family**— La famiglia di gruppi di parametri del cluster utilizzata come modello per il gruppo di parametri di cluster personalizzato.
+ **--description**— La descrizione fornita dall'utente per questo gruppo di parametri del cluster. L'esempio seguente utilizza "`Custom docdb4.0 parameter group`».
Per Linux, macOS o 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"
```
Per 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"
```
L'aspetto dell'output di questa operazione è simile al seguente (formato JSON).
```
{
"DBClusterParameterGroup": {
"DBClusterParameterGroupName": "sample-parameter-group",
"DBParameterGroupFamily": "docdb5.0",
"Description": "Custom docdb4.0 parameter group",
"DBClusterParameterGroupArn": "sample-parameter-group-arn"
}
}
```
------
# 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"
}
]
}
```
------
# Modifica dei cluster Amazon DocumentDB per utilizzare gruppi di parametri di cluster personalizzati
Quando crei un cluster Amazon DocumentDB, viene creato automaticamente un gruppo di `default.docdb4.0` parametri per quel cluster. Non è consentito modificare il gruppo di parametri `default`. Puoi invece modificare il tuo cluster Amazon DocumentDB per associarvi un nuovo gruppo di parametri personalizzato.
Questa sezione spiega come modificare un cluster Amazon DocumentDB esistente per utilizzare un gruppo di parametri del cluster personalizzato utilizzando Console di gestione AWS and the AWS Command Line Interface ()AWS CLI.
------
#### [ Using the Console di gestione AWS ]
**Per modificare un cluster Amazon DocumentDB per utilizzare un nuovo gruppo di parametri di cluster non predefinito**
1. Prima di iniziare, assicurati di aver creato un cluster Amazon DocumentDB e un gruppo di parametri del cluster. Vedere [Creazione di un cluster Amazon DocumentDB](db-cluster-create.md) e [Creazione di gruppi di parametri del cluster Amazon DocumentDB](cluster_parameter_groups-create.md) per ulteriori istruzioni.
1. Dopo aver creato il gruppo di parametri del cluster, apri la console Amazon DocumentDB all'indirizzo. [https://console.aws.amazon.com/docdb](https://console.aws.amazon.com/docdb) Nel riquadro di navigazione scegliere **Clusters (Cluster)** per aggiungere il nuovo gruppo di parametri a un cluster.
1. Scegliere il cluster a cui si desidera associare il gruppo di parametri. Scegliere **Actions (Operazioni)**, quindi scegliere **Modify (Modifica)** per modificare il cluster.
1. In **Cluster options (Opzioni cluster)**, scegliere il nuovo gruppo di parametri a cui si desidera associare il cluster.
1. Scegliere **Continue (Continua)** per visualizzare un riepilogo delle modifiche.
1. Dopo aver verificato le modifiche, è possibile applicarle immediatamente o durante la successiva finestra di manutenzione in **Scheduling of modifications (Pianificazione delle modifiche)**.
1. Scegliere **Modify cluster (Modifica cluster)** per aggiornare il cluster con il nuovo gruppo di parametri.
------
#### [ Using the AWS CLI ]
Prima di iniziare, assicurati di aver creato un cluster Amazon DocumentDB e un gruppo di parametri del cluster. È possibile [creare un cluster Amazon DocumentDB](https://docs.aws.amazon.com//documentdb/latest/developerguide/db-cluster-create.html) utilizzando l' AWS CLI `create-db-cluster`operazione. È possibile [creare un gruppo di parametri del cluster](https://docs.aws.amazon.com//documentdb/latest/developerguide/cluster_parameter_groups-create.html) utilizzando l' AWS CLI `create-db-cluster-parameter-group`operazione.
Per aggiungere il nuovo gruppo di parametri del cluster al cluster, utilizzare l' AWS CLI `modify-db-cluster`operazione con i seguenti parametri.
+ **-- db-cluster-identifier** — Il nome del cluster (ad esempio,`sample-cluster`).
+ **-- db-cluster-parameter-group -name** — Il nome del gruppo di parametri a cui desiderate associare il cluster (ad esempio,`sample-parameter-group`).
**Example**
```
aws docdb modify-db-cluster \
--db-cluster-identifier sample-cluster \
--db-cluster-parameter-group-name sample-parameter-group
```
L'aspetto dell'output di questa operazione è simile al seguente (formato JSON).
```
"DBCluster": {
"AvailabilityZones": [
"us-west-2c",
"us-west-2b",
"us-west-2a"
],
"BackupRetentionPeriod": 1,
"DBClusterIdentifier": "sample-cluster",
"DBClusterParameterGroup": "sample-parameter-group",
"DBSubnetGroup": "default",
...
}
```
------
# Copia dei gruppi di parametri del cluster Amazon DocumentDB
Puoi creare una copia di un gruppo di parametri del cluster in Amazon DocumentDB utilizzando Console di gestione AWS o il AWS Command Line Interface ()AWS CLI.
------
#### [ Using the Console di gestione AWS ]
La procedura seguente ti guida nella creazione di un nuovo gruppo di parametri del cluster eseguendo una copia di un gruppo di parametri cluster esistente.
**Per copiare un gruppo di parametri del cluster**
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 scegliere **Parameter groups (Gruppi di parametri)**.
1. Nel riquadro **Cluster parameter groups (Gruppi di parametri del cluster)**, scegliere il nome del gruppo di parametri del cluster di cui si desidera visualizzare i dettagli.
1. Scegliere **Actions (Operazioni)**, quindi scegliere **Copy (Copia)** per copiare il gruppo di parametri.
1. In **Copy options (Opzioni copia)**, immettere un nome e una descrizione per il nuovo gruppo di parametri del cluster. Quindi scegliere **Copy (Copia)** per salvare le modifiche.
------
#### [ Using the AWS CLI ]
Per copiare un gruppo di parametri del cluster, utilizza l'operazione `copy-db-cluster-parameter-group` con i parametri seguenti.
+ **--source-db-cluster-parameter-group-identifier**: obbligatorio. Il nome o l'Amazon Resource Name (ARN) del gruppo di parametri del cluster da copiare.
Se i gruppi di parametri del cluster di origine e di destinazione coincidono Regione AWS, l'identificatore può essere un nome o un ARN.
Se i gruppi di parametri del cluster di origine e di destinazione sono diversi Regioni AWS, l'identificatore deve essere un ARN.
+ **--target-db-cluster-parameter-group-identifier**: obbligatorio. Il nome o l'ARN della copia del gruppo di parametri del cluster.
Vincoli:
+ Non può essere null o vuoto.
+ Deve contenere da 1 a 255 lettere, numeri o trattini.
+ Il primo carattere deve essere una lettera.
+ Non può terminare con un trattino o contenere due trattini consecutivi.
+ **--target-db-cluster-parameter-group-description**: obbligatorio. Una descrizione per la copia del gruppo di parametri del cluster fornita dall'utente.
**Example**
Il codice seguente crea una copia di `sample-parameter-group`, denominandola `sample-parameter-group-copy`.
Per Linux, macOS o 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"
```
Per 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"
```
L'aspetto dell'output di questa operazione è simile al seguente (formato 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"
}
}
```
------
# Reimpostazione dei gruppi di parametri del cluster Amazon DocumentDB
Puoi ripristinare alcuni o tutti i valori dei parametri di un gruppo di parametri del cluster Amazon DocumentDB ai valori predefiniti utilizzando Console di gestione AWS o the AWS Command Line Interface (AWS CLI) per reimpostare il gruppo di parametri del cluster.
------
#### [ Using the Console di gestione AWS ]
Attieniti alla seguente procedura per reimpostare alcuni o tutti i valori di un parametro di un gruppo di parametri del cluster ai valori predefiniti.
**Per reimpostare i valori dei parametri di un gruppo di parametri del cluster**
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)**.
1. Nel riquadro **Cluster parameter groups (Gruppi di parametri del cluster)**, scegliere il nome del gruppo di parametri del cluster da reimpostare.
1. Scegliere **Actions (Operazioni)**, quindi scegliere **Reset (Reimposta)** per reimpostare il gruppo di parametri.
1. Nella pagina di **conferma della reimpostazione del gruppo di parametri del cluster** restituita, confermare che si desidera reimpostare i valori predefiniti di tutti i parametri del cluster per il gruppo di parametri. Quindi scegliere **Reset (Reimposta)** per reimpostare il gruppo di parametri. È anche possibile selezionare **Cancel (Annulla)** per annullare le modifiche.
------
#### [ Using the AWS CLI ]
Per reimpostare alcuni o tutti i valori di un parametro di un gruppo di parametri del cluster ai valori predefiniti, puoi utilizzare l'operazione `reset-db-cluster-parameter-group` con i parametri seguenti.
+ **--db-cluster-parameter-group-name**: obbligatorio. Il nome del gruppo di parametri del cluster da reimpostare.
+ **--parameters**— Facoltativo. Un elenco di `ParameterName` e `ApplyMethod` nel gruppo di parametri del cluster da ripristinare ai valori predefiniti. I parametri statici devono essere impostati su `pending-reboot` per essere applicati al successivo riavvio dell'istanza o quando viene eseguita la richiesta`reboot-db-instance`. Devi chiamare `reboot-db-instance` per ogni istanza nel cluster a cui desideri applicare il parametro statico aggiornato.
Questo parametro e `--reset-all-parameters` sono reciprocamente esclusivi: puoi utilizzarne uno solo, non entrambi.
+ **--reset-all-parameters**oppure **--no-reset-all-parameters** — Facoltativo. Specifica se ripristinare tutti i parametri (`--reset-all-parameters`) o solo alcuni (`--no-reset-all-parameters`) ai valori predefiniti. Il parametro `--reset-all-parameters` e `--parameters` sono reciprocamente esclusivi: puoi utilizzarne uno solo, non entrambi.
Quando reimposti l'intero gruppo, i parametri dinamici vengono aggiornati immediatamente. I parametri statici devono essere impostati su `pending-reboot` per essere applicati al successivo riavvio dell'istanza o quando viene eseguita la richiesta `reboot-db-instance`. Devi chiamare `reboot-db-instance` per ogni istanza nel cluster a cui desideri applicare il parametro statico aggiornato.
**Example**
**Esempio 1: reimpostazione di tutti i parametri ai valori predefiniti**
Il codice seguente reimposta tutti i parametri nel gruppo di parametri del cluster `sample-parameter-group` ai valori predefiniti.
Per Linux, macOS o Unix:
```
aws docdb reset-db-cluster-parameter-group \
--db-cluster-parameter-group-name sample-parameter-group \
--reset-all-parameters
```
Per Windows:
```
aws docdb reset-db-cluster-parameter-group ^
--db-cluster-parameter-group-name sample-parameter-group ^
--reset-all-parameters
```
**Esempio 2: reimpostazione di parametri specifici ai valori predefiniti**
Il codice seguente reimposta il parametro `tls` nel gruppo di parametri del cluster `sample-parameter-group` al valore predefinito.
Per Linux, macOS o 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
```
Per 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
```
L'aspetto dell'output di questa operazione è simile al seguente (formato JSON).
```
{
"DBClusterParameterGroupName": "sample-parameter-group"
}
```
**Riavvio di un'istanza cluster**
Prima di modificare il valore di un parametro statico, l'istanza cluster deve essere riavviata. Riavvia ogni istanza nel cluster a cui desideri applicare il parametro statico aggiornato.
Per Linux, macOS o Unix:
```
aws docdb reboot-db-instance \
--db-instance-identifier sample-cluster-instance
```
Per Windows:
```
aws docdb reboot-db-instance ^
--db-instance-identifier sample-cluster-instance
```
------
# Eliminazione di gruppi di parametri del cluster Amazon DocumentDB
Puoi eliminare un gruppo di parametri del cluster Amazon DocumentDB personalizzato utilizzando Console di gestione AWS o il AWS Command Line Interface ()AWS CLI. Non è possibile eliminare il gruppo di parametri del cluster `default.docdb4.0`.
------
#### [ Using the Console di gestione AWS ]
**Per eliminare un gruppo di parametri del cluster**
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 scegliere **Parameter groups (Gruppi di parametri)**.
**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. Nel riquadro **Parameter groups (Gruppi di parametri)** scegli il pulsante di opzione a sinistra del gruppo di parametri del cluster da eliminare.
1. Scegli **Azioni**, quindi **Elimina**.
1. Nel riquadro di conferma **Delete (Elimina)** scegliere **Delete (Elimina)** per eliminare il gruppo di parametri del cluster. **Per mantenere il gruppo di parametri del cluster, scegli Annulla.**
------
#### [ Using the AWS CLI ]
Per eliminare un gruppo di parametri del cluster, utilizza l'operazione `delete-db-cluster-parameter-group` con il parametro seguente.
+ **--db-cluster-parameter-group-name**: obbligatorio. Il nome del gruppo di parametri del cluster da eliminare. Deve essere un gruppo di parametri del cluster esistente. *Non è possibile eliminare il gruppo di parametri del cluster `default.docdb4.0`. *
**Example - Eliminazione di un gruppo di parametri del cluster**
L'esempio seguente descrive le tre fasi che consentono di eliminare un gruppo di parametri del cluster:
1. Ricerca del nome del gruppo di parametri del cluster da eliminare.
1. Eliminazione del gruppo di parametri del cluster specificato.
1. Verifica dell'avvenuta eliminazione del gruppo di parametri del cluster.
**1. Cerca il nome del gruppo di parametri del cluster da eliminare.**
Il codice seguente elenca i nomi di tutti i gruppi di parametri del cluster.
Per Linux, macOS o Unix:
```
aws docdb describe-db-cluster-parameter-groups \
--query 'DBClusterParameterGroups[*].[DBClusterParameterGroupName]'
```
Per Windows:
```
aws docdb describe-db-cluster-parameter-groups ^
--query 'DBClusterParameterGroups[*].[DBClusterParameterGroupName]'
```
L'output dell'operazione precedente è un elenco dei nomi dei gruppi di parametri del cluster simile al seguente (formato JSON).
```
[
[
"default.docdb4.0"
],
[
"sample-parameter-group"
],
[
"sample-parameter-group-copy"
]
]
```
**2. Elimina un gruppo di parametri del cluster specifico.**
Il codice seguente elimina il gruppo di parametri del cluster `sample-parameter-group-copy`.
Per Linux, macOS o Unix:
```
aws docdb delete-db-cluster-parameter-group \
--db-cluster-parameter-group-name sample-parameter-group-copy
```
Per Windows:
```
aws docdb delete-db-cluster-parameter-group ^
--db-cluster-parameter-group-name sample-parameter-group-copy
```
Questa operazione non produce alcun output.
**3. Verifica dell'avvenuta eliminazione del gruppo di parametri del cluster specificato.**
Il codice seguente elenca i nomi di tutti i gruppi di parametri del cluster rimanenti.
Per Linux, macOS o Unix:
```
aws docdb describe-db-cluster-parameter-groups \
--query 'DBClusterParameterGroups[*].[DBClusterParameterGroupName]'
```
Per Windows:
```
aws docdb describe-db-cluster-parameter-groups ^
--query 'DBClusterParameterGroups[*].[DBClusterParameterGroupName]'
```
L'output dell'operazione precedente è un elenco dei gruppi di parametri del cluster simile al seguente (formato JSON). Il gruppo di parametri del cluster appena eliminato non deve comparire nell'elenco.
L'aspetto dell'output di questa operazione è simile al seguente (formato JSON).
```
[
[
"default.docdb4.0"
],
[
"sample-parameter-group"
]
]
```
------
# Riferimento ai parametri del cluster Amazon DocumentDB
Quando modifichi un parametro dinamico e salvi il gruppo di parametri del cluster, la modifica viene applicata immediatamente, indipendentemente dall'impostazione *Apply Immediately (Applica immediatamente)*. Quando modifichi un parametro statico e salvi il gruppo di parametri del cluster, la modifica del parametro viene applicata dopo che avrai riavviato manualmente l'istanza. Puoi riavviare un'istanza utilizzando la console Amazon DocumentDB o chiamando esplicitamente. `reboot-db-instance`
La tabella seguente mostra i parametri che si applicano a tutte le istanze in un cluster Amazon DocumentDB.
**Parametri a livello di cluster Amazon DocumentDB**
| Parametro | Valore predefinito | Valori validi | Modificabile | Applica tipo | Tipo di dati | Description |
| --- | --- | --- | --- | --- | --- | --- |
| audit\$1logs | disabled | abilitati, disabilitati, ddl, dml\$1read, dml\$1write, all, none | Sì | Dinamico | Stringa | Definisce se i log CloudWatch di controllo di Amazon sono abilitati. [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/documentdb/latest/developerguide/cluster_parameter_groups-list_of_parameters.html) |
| change\$1stream\$1log\$1retention\$1duration | 10800 | 3600-604800 | Sì | Dinamico | Numero intero | Definisce la durata del tempo (in secondi) in cui il registro del flusso di modifiche viene mantenuto e può essere consumato. |
| default\$1collection\$1compression | disabled | abilitato, disabilitato (Amazon DocumentDB 5.0)/zstd, lz4, nessuno (Amazon Document 2.0) DB8 | Sì | Dinamico | Stringa | Definisce l'impostazione di compressione predefinita per le nuove raccolte in un cluster [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/documentdb/latest/developerguide/cluster_parameter_groups-list_of_parameters.html) |
| profiler | disabled | abilitato, disabilitato | Sì | Dinamico | Stringa | Abilita il profiling per operazioni lente. [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/documentdb/latest/developerguide/cluster_parameter_groups-list_of_parameters.html) |
| profiler\$1sampling\$1rate | 1.0 | 0,0 - 1,0 | Sì | Dinamico | Float | Definisce la frequenza di campionamento per le operazioni registrate. |
| profiler\$1threshold\$1ms | 100 | 50-2147483646 | Sì | Dinamico | Numero intero | Definisce la soglia per profiler. [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/documentdb/latest/developerguide/cluster_parameter_groups-list_of_parameters.html) |
| planner\$1version | 3.0 | 1,0, 2,0, 3,0 | Sì | Dinamico | Float | Definisce la versione del pianificatore di query da utilizzare per le query.[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/documentdb/latest/developerguide/cluster_parameter_groups-list_of_parameters.html) |
| tls | abilitato | abilitato, disabilitato, fips-140-3, tls1.2\$1, tls1.3\$1 | Sì | Statico | Stringa | Definisce se sono necessarie connessioni Transport Layer Security (TLS). [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/documentdb/latest/developerguide/cluster_parameter_groups-list_of_parameters.html) |
| ttl\$1monitor | abilitato | abilitato, disabilitato | Sì | Dinamico | Stringa | Definisce se il monitoraggio Time to Live (TTL) è abilitato per il cluster. [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/documentdb/latest/developerguide/cluster_parameter_groups-list_of_parameters.html) |
# Modifica dei parametri del cluster Amazon DocumentDB
In Amazon DocumentDB, *i gruppi di parametri del cluster* *sono costituiti da parametri* che si applicano a tutte le istanze create nel cluster. Per i gruppi di parametri del cluster personalizzati, puoi modificare un valore di parametro in qualsiasi momento o reimpostare tutti i valori dei parametri sulle impostazioni predefinite per i gruppi di parametri creati. Questa sezione descrive come visualizzare i parametri che costituiscono un gruppo di parametri del cluster Amazon DocumentDB e i relativi valori e come modificare o aggiornare questi valori.
I parametri possono essere *dinamici* o *statici*. Quando modifichi un parametro dinamico e salvi il gruppo di parametri del cluster, la modifica viene applicata immediatamente, indipendentemente dall'impostazione `Apply Immediately`. Quando modifichi un parametro statico e salvi il gruppo di parametri del cluster, la modifica del parametro viene applicata solo dopo che avrai riavviato manualmente le istanze.
## Visualizzazione dei parametri di un gruppo di parametri del cluster Amazon DocumentDB
Puoi visualizzare i parametri di un cluster Amazon DocumentDB e i relativi valori utilizzando o. Console di gestione AWS AWS CLI
------
#### [ Using the Console di gestione AWS ]
**Per visualizzare i dettagli di un gruppo di parametri del cluster**
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 scegliere **Parameter groups (Gruppi di parametri)**.
**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. Nel riquadro **Parameter groups (Gruppi di parametri)**, scegli il nome del gruppo di parametri del cluster di cui desideri visualizzare i dettagli.
1. La pagina risultante mostra i seguenti valori per ciascun parametro: nome del parametro, valore corrente, valori consentiti, se il parametro è modificabile, tipo di applicazione, tipo di dati e descrizione.
![\[Screenshot: nomi e valori dei parametri.\]](http://docs.aws.amazon.com/it_it/documentdb/latest/developerguide/images/docdb-determine-parameter-value.png)
------
#### [ Using the AWS CLI ]
Per visualizzare i parametri e i valori di un gruppo di parametri del cluster, utilizza l'operazione `describe-db-cluster-parameters` con i parametri seguenti.
+ **--db-cluster-parameter-group-name**: obbligatorio. Il nome del gruppo di parametri del cluster di cui ottenere un elenco di parametri dettagliato.
+ **--source**— Facoltativo. Se fornito, restituisce solo i parametri per una determinata origine. Le origini dei parametri possono essere `engine-default`, `system` o `user`.
**Example**
Il codice seguente elenca i parametri e i relativi valori per il gruppo di parametri `custom3-6-param-grp`. Per ulteriori informazioni sul gruppo di parametri, ometti la riga `--query`. Per informazioni su tutti i gruppi di parametri, ometti la riga `--db-cluster-parameter-group-name`.
Per Linux, macOS o Unix:
```
aws docdb describe-db-cluster-parameters \
--db-cluster-parameter-group-name custom3-6-param-grp \
--query 'Parameters[*].[ParameterName,ParameterValue]'
```
Per Windows:
```
aws docdb describe-db-cluster-parameters ^
--db-cluster-parameter-group-name custom3-6-param-grp ^
--query 'Parameters[*].[ParameterName,ParameterValue]'
```
L'aspetto dell'output di questa operazione è simile al seguente (formato JSON).
```
[
[
"audit_logs",
"disabled"
],
[
"tls",
"enabled"
],
[
"ttl_monitor",
"enabled"
]
]
```
------
## Modifica dei parametri di un gruppo di parametri del cluster Amazon DocumentDB
Puoi modificare i parametri di un gruppo di parametri utilizzando o. Console di gestione AWS AWS CLI
------
#### [ Using the Console di gestione AWS ]
**Per aggiornare i parametri di un gruppo di parametri del cluster**
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 scegliere **Parameter groups (Gruppi di parametri)**.
**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. Nel riquadro **Parameter groups (Gruppi di parametri)** scegliere il gruppo di parametri del cluster di cui si desidera aggiornare i parametri.
1. La pagina risultante mostra i parametri e i relativi dettagli corrispondenti per questo gruppo di parametri del cluster. Selezionare un parametro da aggiornare.
1. In alto a destra della pagina, scegliere **Edit (Modifica)** per modificare il valore del parametro. Per ulteriori informazioni sui tipi di parametri del cluster, consulta [Riferimento ai parametri del cluster Amazon DocumentDB](cluster_parameter_groups-list_of_parameters.md).
1. Apportare la modifica, quindi scegliere **Modify cluster parameter (Modifica parametro cluster)** per salvare le modifiche. Per annullare le modifiche, selezionare **Cancel (Annulla)**.
------
#### [ Using the AWS CLI ]
Per modificare i parametri di un gruppo di parametri del cluster, utilizzare 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. Il parametro o i parametri che stai modificando. 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`.
**Per modificare i valori dei parametri di un gruppo di parametri del cluster (AWS CLI)**
L'esempio seguente cambia il parametro `tls`.
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 relativo 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 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": [
{
"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"
}
]
}
```
------