

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à.

# Creazione di gruppi di parametri del cluster Amazon DocumentDB
<a name="cluster_parameter_groups-create"></a>

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

------