

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

# Descrizione dei gruppi di parametri del cluster Amazon DocumentDB
<a name="cluster_parameter_groups-describe"></a>

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

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

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

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

------