

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 un cluster Amazon DocumentDB
<a name="db-cluster-create"></a>

Un cluster Amazon DocumentDB è costituito da istanze e un volume del cluster che rappresenta i dati del cluster. Il volume cluster viene replicato in sei modi su tre zone di disponibilità come un unico volume virtuale. Il cluster contiene un'istanza primaria e, facoltativamente, fino a 15 istanze di replica. 

Le seguenti sezioni mostrano come creare un cluster Amazon DocumentDB utilizzando il o il Console di gestione AWS . AWS CLI Puoi quindi aggiungere al cluster istanze di replica aggiuntive. Quando utilizzi la console per creare il tuo cluster Amazon DocumentDB, contemporaneamente viene creata automaticamente un'istanza primaria. Se utilizzi il AWS CLI per creare il tuo cluster Amazon DocumentDB, dopo che lo stato del cluster è * disponibile*, devi creare l'istanza primaria per quel cluster.

## Prerequisiti
<a name="db-cluster-create-prerequisites"></a>

Di seguito sono riportati i prerequisiti per la creazione di un cluster Amazon DocumentDB.

Se non ne hai uno Account AWS, completa i seguenti passaggi per crearne uno.

**Per iscriverti a Account AWS**

1. Aprire [https://portal.aws.amazon.com/billing/signup](https://portal.aws.amazon.com/billing/signup).

1. Segui le istruzioni online.

   Nel corso della procedura di registrazione riceverai una telefonata o un messaggio di testo e ti verrà chiesto di inserire un codice di verifica attraverso la tastiera del telefono.

   Quando ti iscrivi a un Account AWS, *Utente root dell’account AWS* viene creato un. L’utente root dispone dell’accesso a tutte le risorse e tutti i Servizi AWS nell’account. Come best practice di sicurezza, assegna l’accesso amministrativo a un utente e utilizza solo l’utente root per eseguire [attività che richiedono l’accesso di un utente root](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_root-user.html#root-user-tasks).

### Prerequisiti per VPC
<a name="db-cluster-create-prerequisites-vpc"></a>

Puoi creare un cluster Amazon DocumentDB solo in un Amazon Virtual Private Cloud (Amazon VPC). Il tuo Amazon VPC deve avere almeno una sottorete in ciascuna di almeno due zone di disponibilità per poterlo utilizzare con un cluster Amazon DocumentDB. Distribuendo le istanze del cluster tra le zone di disponibilità, ti assicuri che le istanze siano disponibili nel cluster nell'improbabile caso di errore di una zona di disponibilità.

### Prerequisiti della sottorete
<a name="db-cluster-create-prerequisites-subnet-groups"></a>

Quando crei un cluster Amazon DocumentDB, devi scegliere un VPC e il corrispondente gruppo di sottorete all'interno di quel VPC per avviare il cluster. Le sottoreti determinano la zona di disponibilità e l'intervallo IP all'interno della zona di disponibilità che desideri utilizzare per avviare un'istanza. In questa documentazione i termini *sottorete* e *zona di disponibilità* saranno utilizzati indifferentemente. Un gruppo di sottoreti è un set di sottoreti denominato (o zone di disponibilità). Ciò che un gruppo di sottorete ti consente di fare è specificare le zone di disponibilità da utilizzare per avviare le istanze Amazon DocumentDB. Ad esempio, per avere alta disponibilità in un cluster con tre istanze, è consigliabile effettuare il provisioning di ciascuna di queste istanze in zone di disponibilità separate. In questo modo, se una singola zona di disponibilità non funziona, sarà interessata solo una singola istanza.

Le istanze Amazon DocumentDB possono attualmente essere assegnate a un massimo di tre zone di disponibilità. Anche se un gruppo di sottoreti ha più di tre sottoreti, puoi utilizzarne solo tre per creare un cluster Amazon DocumentDB. Di conseguenza, quando crei un gruppo di sottoreti, è consigliabile scegliere solo le tre sottoreti in cui desideri distribuire le tue istanze. Negli Stati Uniti orientali (Virginia settentrionale), il tuo gruppo di sottoreti può avere sei sottoreti (o zone di disponibilità). Tuttavia, quando viene effettuato il provisioning di un cluster Amazon DocumentDB, Amazon DocumentDB sceglie tre di quelle zone di disponibilità che utilizza per il provisioning delle istanze. 

Ad esempio, supponiamo che durante la creazione di un cluster, Amazon DocumentDB scelga le zone di disponibilità {1A, 1B e 1C}. Se tenti di creare un'istanza nella zona di disponibilità {1D}, la chiamata API non riesce. Tuttavia, se scegli di creare un'istanza senza specificare una particolare zona di disponibilità, Amazon DocumentDB sceglie una zona di disponibilità per tuo conto. Amazon DocumentDB utilizza un algoritmo per bilanciare il carico delle istanze tra le zone di disponibilità per aiutarti a raggiungere un'elevata disponibilità. Ad esempio, se viene effettuato il provisioning di tre istanze, per impostazione predefinita il provisioning viene effettuato nelle tre zone di disponibilità e non in una sola di esse.

**Raccomandazioni:**
+ A meno che non si abbia un motivo specifico, creare sempre un gruppo di sottoreti con tre sottoreti. In questo modo si assicura che i cluster con tre o più istanze possano ottenere una disponibilità più elevata in quanto ne verrà effettuato il provisioning su tre zone di disponibilità.
+ Distribuisci sempre le istanze in più zone di disponibilità per ottenere una disponibilità più elevata. Non posizionare mai tutte le istanze di un cluster in una singola zona di disponibilità.
+ Poiché gli eventi di failover possono verificarsi in qualsiasi momento, non devi presumere che un'istanza primaria o le istanze di replica siano sempre in una determinata zona di disponibilità.

### Prerequisiti aggiuntivi
<a name="db-cluster-create-prerequisites-additional"></a>

Di seguito sono riportati alcuni prerequisiti aggiuntivi per la creazione di un cluster Amazon DocumentDB:
+ Se ti connetti AWS utilizzando credenziali AWS Identity and Access Management (IAM), il tuo account IAM deve disporre di politiche IAM che concedano le autorizzazioni necessarie per eseguire le operazioni di Amazon DocumentDB.

  Se utilizzi un account IAM per accedere alla console Amazon DocumentDB, devi prima accedere Console di gestione AWS con il tuo account IAM. Quindi accedi alla console Amazon DocumentDB all'indirizzo. [ https://console.aws.amazon.com/docdb ](https://console.aws.amazon.com/docdb)
+ Per personalizzare i parametri di configurazione per il cluster, devi specificare un gruppo di parametri del cluster e un gruppo di parametri con le impostazioni dei parametri richieste. Per informazioni sulla creazione o la modifica di un gruppo di parametri del cluster o un gruppo di parametri, consulta [Gestione dei gruppi di parametri del cluster Amazon DocumentDB](cluster_parameter_groups.md).
+ È necessario determinare il numero di TCP/IP porta che si desidera specificare per il cluster. I firewall di alcune aziende bloccano le connessioni alle porte predefinite per Amazon DocumentDB. Se il firewall della tua azienda blocca la porta predefinita, scegli un'altra porta per il cluster. Tutte le istanze in un cluster utilizzano la stessa porta.

## Creazione di un cluster e di un'istanza primaria utilizzando Console di gestione AWS
<a name="db-cluster-create-con"></a>

Le seguenti procedure descrivono come utilizzare la console per avviare un cluster Amazon DocumentDB con una o più istanze.

### Crea un cluster: utilizzando le impostazioni predefinite
<a name="db-cluster-create-con-basic"></a>

**Per creare un cluster con istanze utilizzando le impostazioni predefinite utilizzando 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. Se desideri creare il tuo cluster in una regione Regione AWS diversa da quella degli Stati Uniti orientali (Virginia settentrionale), scegli la regione dall'elenco nella sezione in alto a destra della console.

1. Nel riquadro di navigazione scegliere **Clusters (Cluster)**, quindi **Create (Crea)**.
**Suggerimento**  
Se il riquadro di navigazione non viene visualizzato sul lato sinistro della schermata, scegliere l'icona del menu (![Menu button.](https://docs.aws.amazon.com/it_it/documentdb/latest/devguide/images/docdb-menu-icon.png)) nell'angolo in alto a sinistra della pagina.

1. Nella ** pagina ** Crea cluster Amazon DocumentDB, completa il riquadro di configurazione. ** **

   1. **Identificatore del cluster**: accetta il nome fornito da Amazon DocumentDB o inserisci un nome per il tuo cluster; ad esempio,. **sample-cluster**

      Vincoli per la denominazione del cluster:
      + La lunghezza è di [1—63] lettere, numeri o trattini. 
      + Il primo carattere deve essere una lettera.
      + Non può terminare con un trattino o contenere due trattini consecutivi.
      + Deve essere univoco per tutti i cluster di Amazon RDS, Neptune e Amazon DocumentDB per regione. Account AWS

   1. **Versione del motore**: accetta la versione predefinita del motore 5.0.0 o, facoltativamente, scegli 8.0.0, 4.0.0 o 3.6.0.

   1. **Classe di istanza**: accettate l'impostazione predefinita o scegliete la classe di istanza `db.r5.large` desiderata dall'elenco.

   1. **Numero di istanze**: nell'elenco, scegli il numero di istanze che desideri creare con questo cluster. La prima istanza è l'istanza primaria, tutte le altre sono istanze di replica di sola lettura. È possibile aggiungere ed eliminare le istanze in un secondo momento, se necessario. Per impostazione predefinita, un cluster Amazon DocumentDB viene avviato con tre istanze (una primaria e due repliche).

1. Completa la sezione di configurazione dello storage del ** cluster. **

   Scegli ** Amazon DocumentDB Standard ** (impostazione predefinita) o ** Amazon I/O-Optimized ** DocumentDB. Per ulteriori informazioni, consulta [Configurazioni di storage del cluster Amazon DocumentDB](db-cluster-storage-configs.md).

1. Compila il riquadro **Authentication (Autenticazione)**.

   1. **Nome utente**: inserisci un nome per l'utente principale. Per accedere al cluster, è necessario utilizzare il nome utente principale.

      Vincoli principali per la denominazione degli utenti:
      + La lunghezza è di [1—63] caratteri alfanumerici.
      + Il primo carattere deve essere una lettera.
      + Non può essere una parola riservata del motore di database.

   1. Scegliete una delle seguenti opzioni di password:
      + **Gestito in AWS Secrets Manager**: scegli questa opzione se desideri AWS Secrets Manager gestire automaticamente la password dell'utente principale.

        Se scegli questa opzione, configura la chiave KMS creandone una tua o utilizzando una chiave creata da Secrets Manager.
      + **Gestito automaticamente**: scegli questa opzione se desideri gestire automaticamente la tua password utente principale. Se scegli questa opzione, inserisci una password per l'utente principale e confermala. Per accedere al cluster, è necessario utilizzare la password per l'utente principale.

        Vincoli per la password:
        + La lunghezza è di [8-100] caratteri ASCII stampabili.
        + È possibile utilizzare qualsiasi carattere ASCII stampabile eccetto i seguenti:
          + **/** (barra)
          + **"** (virgolette doppie)
          + **@** (simbolo chiocciola)

1. Nella parte inferiore della schermata, scegli uno dei seguenti:
   + Per creare subito il cluster, scegli **Create cluster (Crea cluster)**.
   + Per non creare il cluster, scegli **Cancel (Annulla)**.
   + Per configurare ulteriormente il cluster prima di crearlo, scegliere **Show additional configurations (Mostra configurazioni aggiuntive)**, quindi continuare in [Crea un cluster: configurazioni aggiuntive](#db-cluster-create-con-additional-configs).

     Le configurazioni comprese nella sezione **Additional Configurations (Configurazioni aggiuntive)** sono:
     + **Impostazioni di rete**: l'impostazione predefinita prevede l'utilizzo del gruppo di sicurezza `default` VPC.
     + **Opzioni del cluster**: l'impostazione predefinita prevede l'utilizzo della porta 27017 e del gruppo di parametri predefinito.
     + **Crittografia**: l'impostazione predefinita prevede l'attivazione della crittografia tramite la chiave. `(default) aws/rds`
**Importante**  
Una volta che un cluster è crittografato, non può essere decrittografato.
     + **Backup**: l'impostazione predefinita prevede la conservazione dei backup per 1 giorno e la scelta della finestra di backup da parte di Amazon DocumentDB.
     + **Esportazioni di log**: l'impostazione predefinita è di non esportare i log di controllo in Logs. CloudWatch 
     + **Manutenzione**: l'impostazione predefinita prevede che Amazon DocumentDB scelga la finestra di manutenzione.
     + **Protezione dall'eliminazione**: proteggi il tuo cluster dall'eliminazione accidentale. L'impostazione predefinita per i cluster creati utilizzando la console è *abilitata*.

     Se accetti le impostazioni predefinite ora, potrai modificare la maggior parte di esse successivamente modificando il cluster.

1. Abilita la connessione in entrata per il gruppo di sicurezza del cluster.

   Se non hai modificato le impostazioni predefinite per il tuo cluster, hai creato un cluster utilizzando il gruppo di sicurezza predefinito per il VPC predefinito nella regione specificata. Per connetterti ad Amazon DocumentDB, devi abilitare le connessioni in entrata sulla porta 27017 (o sulla porta di tua scelta) per il gruppo di sicurezza del cluster.

   **Per aggiungere una connessione in entrata al gruppo di sicurezza del cluster**

   1. Accedi Console di gestione AWS e apri la console Amazon EC2 all'indirizzo. [ https://console.aws.amazon.com/ec2/ ](https://console.aws.amazon.com/ec2/)

   1. Nella sezione **Resources (Risorse)** della finestra principale, selezionare **Security groups (Gruppi di sicurezza)**.  
![Immagine: elenco delle risorse che evidenzia l'opzione di collegamento ai gruppi di sicurezza.](https://docs.aws.amazon.com/it_it/documentdb/latest/devguide/images/docdb-ec2-security-groups.png)

   1. Dall'elenco di gruppi di sicurezza, individuare il gruppo di sicurezza utilizzato quando si crea il cluster (è probabile che il gruppo di sicurezza *predefinito* ) e scegliere la casella a sinistra del nome del gruppo di sicurezza.  
![Immagine: elenco dei gruppi di sicurezza che evidenzia un gruppo di sicurezza con la casella selezionata.](https://docs.aws.amazon.com/it_it/documentdb/latest/devguide/images/docdb-ec2-default-sg.png)

   1. Dal menu **Actions (Operazioni)** , scegliere **Edit inbound rules (Modifica regole in entrata)**, quindi scegliere o inserire i vincoli della regola.

      1. **Tipo**: dall'elenco, scegli il protocollo da aprire al traffico di rete.

      1. **Protocollo**: dall'elenco, scegli il tipo di protocollo.

      1. **Intervallo di porte**: per una regola personalizzata, inserisci un numero di porta o un intervallo di porte. Assicurati che il numero di porta o l'intervallo includa la porta specificata quando hai creato il cluster (valore predefinito: 27017).

      1. **Fonte**: specifica il traffico che può raggiungere l'istanza. Dall'elenco, scegliere l'origine del traffico. Se scegli ** Personalizzato**, specifica un singolo indirizzo IP o un intervallo di indirizzi IP in notazione CIDR (ad esempio, 203.0.113). 5/32).

      1. **Descrizione**: immettere una descrizione per questa regola.

      1. Dopo aver creato la regola, scegliere **Save (Salva)**.

### Crea un cluster: configurazioni aggiuntive
<a name="db-cluster-create-con-additional-configs"></a>

Se desideri accettare le impostazioni predefinite per il cluster, puoi ignorare le seguenti fasi e scegliere **Create cluster (Crea cluster)**. 

1. Completa il riquadro **Network settings (Impostazioni di rete)**.  
![Screenshot che mostra il riquadro delle impostazioni di rete e le fasi per la configurazione delle impostazioni di rete.](https://docs.aws.amazon.com/it_it/documentdb/latest/devguide/images/create-db-cluster-console-network-settings.png)

   1. **Virtual Private Cloud (VPC)**: nell'elenco, scegli Amazon VPC in cui desideri avviare questo cluster.

   1. **Gruppo di sottorete**: nell'elenco, scegli il gruppo di sottorete che desideri utilizzare per questo cluster.

   1. **Gruppi di sicurezza VPC**: nell'elenco, scegli il gruppo di sicurezza VPC per questo cluster.

1. Completa il riquadro **Cluster options (Opzioni cluster)**.  
![Screenshot che mostra il riquadro delle opzioni cluster con le fasi per la configurazione delle impostazioni dei cluster.](https://docs.aws.amazon.com/it_it/documentdb/latest/devguide/images/create-db-cluster-console-cluster-options.png)

   1. **Porta del database**: utilizza le frecce su e giù per impostare la TCP/IP porta che le applicazioni utilizzeranno per connettersi alla tua istanza.

   1. **Gruppo di parametri del cluster**: nell'elenco dei gruppi di parametri, scegli il gruppo di parametri del cluster per questo cluster.

1. Completa il riquadro **Encryption (Crittografia)**.  
![Screenshot del riquadro di crittografia che mostra le fasi per la crittografia del cluster.](https://docs.aws.amazon.com/it_it/documentdb/latest/devguide/images/encrypt-at-rest.png)

   1. **Encryption-at-rest**—Scegli una delle seguenti opzioni:
      + **Abilita crittografia**: impostazione predefinita. Tutti i dati inattivi vengono crittografati. Se scegli di crittografare i dati, non è possibile annullare questa operazione.
      + **Disattiva la crittografia**: i dati non sono crittografati.

   1. **AWS Chiave KMS**: disponibile solo se stai crittografando i tuoi dati. Scegliere nell'elenco la chiave che si desidera utilizzare per crittografare i dati nel cluster. Il valore predefinito è `(default) aws/rds`.

      Se si sceglie **Enter a key ARN (Immetti ARN chiave)**, è necessario immettere un Amazon Resource Name (ARN) per la chiave.

1. Completa il riquadro **Backup**.  
![Screenshot del riquadro Backup che mostra le fasi per la configurazione della finestra di backup del cluster.](https://docs.aws.amazon.com/it_it/documentdb/latest/devguide/images/create-db-cluster-console-backup.png)

   1. **Periodo di conservazione dei backup**: nell'elenco, scegli il numero di giorni per conservare i backup automatici di questo cluster prima di eliminarli.

   1. **Finestra di backup**: imposta l'ora e la durata giornaliere durante le quali Amazon DocumentDB deve effettuare i backup di questo cluster.

      1. **Ora di inizio**: nel primo elenco, scegli l'ora di inizio (UTC) per l'avvio dei backup automatici. Dal secondo elenco scegli il minuto dell'ora in cui desideri inizino i backup automatici.

      1. **Durata**: nell'elenco, scegli il numero di ore da assegnare alla creazione di backup automatici.

1. Completa il ** riquadro Esportazioni dei ** log selezionando i tipi di log che desideri esportare in Logs. CloudWatch   
![Screenshot del riquadro delle esportazioni di log che mostra le fasi per configurare il logging DML del cluster.](https://docs.aws.amazon.com/it_it/documentdb/latest/devguide/images/create-db-cluster-console-log-exports.png)
   + **Log di controllo**: seleziona questa opzione per abilitare l'esportazione dei log di controllo in Amazon CloudWatch Logs. Se selezioni **Audit logs (Log di audit)**, devi abilitare `audit_logs` nel gruppo personalizzato di parametri del cluster. Per ulteriori informazioni, consulta [Verifica degli eventi di Amazon DocumentDB](event-auditing.md).
   + **Log del profiler**: seleziona questa opzione per abilitare l'esportazione dei log delle operazioni del profiler in Amazon Logs. CloudWatch Se selezioni **Profiler logs (Log del profiler)**, devi anche modificare i seguenti parametri nel gruppo personalizzato dei parametri del cluster:
     + `profiler``enabled`—Impostato su.
     + `profiler_threshold_ms`—Impostato su un valore `[0-INT_MAX]` per impostare la soglia per le operazioni di profilazione.
     + `profiler_sampling_rate`—Impostare un valore per `[0.0-1.0]` impostare la percentuale di operazioni lente da profilare.

     Per ulteriori informazioni, consulta [Profilazione delle operazioni di Amazon DocumentDB](profiling.md).

1. Compilare il riquadro **Maintenance (Manutenzione)**.  
![Screenshot del riquadro Maintenance (Manutenzione) che mostra le fasi per la configurazione della finestra di manutenzione del cluster.](https://docs.aws.amazon.com/it_it/documentdb/latest/devguide/images/create-db-cluster-console-maintenance.png)

   1. Scegli una delle seguenti opzioni
     + **Seleziona finestra**: puoi specificare il giorno della settimana, l'ora di inizio UTC e la durata in cui Amazon DocumentDB deve eseguire la manutenzione sul tuo cluster.

       1. **Giorno di inizio**: nell'elenco, scegli il giorno della settimana in cui iniziare la manutenzione del cluster.

       1. **Ora di inizio**: negli elenchi, scegli l'ora e il minuto (UTC) per iniziare la manutenzione.

       1. **Durata**: nell'elenco, scegli quanto tempo dedicare alla manutenzione del cluster. Se la manutenzione non può essere completata nel tempo specificato, il processo di manutenzione proseguirà oltre l'orario indicato fino al completamento.
     + **Nessuna preferenza**: Amazon DocumentDB sceglie il giorno della settimana, l'ora di inizio e la durata per eseguire la manutenzione.

1. Per aggiungere uno o più tag a questo cluster, completare il riquadro **Tags (Tag)**.  
![Schermata del selettore dell'abilitazione della protezione, che è selezionato.](https://docs.aws.amazon.com/it_it/documentdb/latest/devguide/images/create-db-cluster-console-tags.png)

   Per ogni tag che si desidera aggiungere al cluster, ripetere i seguenti passaggi. Puoi averne fino a 10 su un cluster.

   1. Scegli **Aggiungi tag**.

   1. Digita il tag **Key (Chiave)**.

   1. Opzionalmente digita il **Value (Valore)** del tag.

   Per rimuovere un tag, scegli **Remove (Rimuovi)**.

1. Quando si crea un cluster utilizzando la console, la **Deletion Protection (Protezione dall'eliminazione)** viene abilitata per impostazione predefinita. Per disabilitare la protezione dall'eliminazione, deseleziona **Enable deletion protection (Abilita la protezione dall'eliminazione)**. Quando abilitata, la protezione dall'eliminazione impedisce che un cluster venga eliminato. Per eliminare un cluster protetto dall'eliminazione, è necessario prima modificare il cluster per disabilitare la protezione dall'eliminazione.  
![Schermata del selettore dell'abilitazione della protezione, che è selezionato.](https://docs.aws.amazon.com/it_it/documentdb/latest/devguide/images/create-db-cluster-console-deletion-protection.png)

   Per ulteriori informazioni sulla protezione dall'eliminazione, consultare [Eliminazione di un cluster Amazon DocumentDB](db-cluster-delete.md).

1. Per creare il cluster, scegli **Create cluster (Crea cluster)**. Altrimenti, scegli **Cancel** (Annulla).

## Creazione di un cluster utilizzando AWS CLI
<a name="db-cluster-create-cli"></a>

Le seguenti procedure descrivono come utilizzare il per AWS CLI avviare un cluster Amazon DocumentDB e creare una replica Amazon DocumentDB.

**Parameters**
+ **--db-cluster-identifier**: obbligatorio. Una stringa di lettere minuscole che identifica il cluster.    
[See the AWS documentation website for more details](http://docs.aws.amazon.com/it_it/documentdb/latest/devguide/db-cluster-create.html)
+ **--engine**: obbligatorio. Deve essere **docdb**.
+ **--deletion-protection \| --no-deletion-protection**—Facoltativo. Quando è abilitata la protezione dall'eliminazione, questa impedisce che il cluster venga eliminato. Quando si utilizza il AWS CLI, l'impostazione predefinita prevede la disattivazione della protezione da eliminazione.

  Per ulteriori informazioni sulla protezione dall'eliminazione, consultare [Eliminazione di un cluster Amazon DocumentDB](db-cluster-delete.md).
+ **--storage-type standard \| iopt1**—Facoltativo. Default: **standard**. La configurazione di archiviazione del cluster. I valori validi sono `standard` (Standard) o `iopt1` (I/O-optimized).
+ **--master-username**: obbligatorio. Il nome utilizzato per autenticare l'utente.    
[See the AWS documentation website for more details](http://docs.aws.amazon.com/it_it/documentdb/latest/devguide/db-cluster-create.html)
+ **--master-user-password**—Facoltativo. La password utilizzata per autenticare l'utente.    
[See the AWS documentation website for more details](http://docs.aws.amazon.com/it_it/documentdb/latest/devguide/db-cluster-create.html)
+ **--manage-master-user-password**—Opzionale. Amazon DocumentDB genera la password dell'utente principale e la gestisce per tutto il suo ciclo di vita in Secrets Manager.

Per parametri aggiuntivi, consulta CreateDBCluster. [https://docs.aws.amazon.com/documentdb/latest/APIReference/API_CreateDBCluster.html](https://docs.aws.amazon.com/documentdb/latest/APIReference/API_CreateDBCluster.html)

**Per avviare un cluster Amazon DocumentDB utilizzando AWS CLI**

Per creare un cluster Amazon DocumentDB, chiama. `create-db-cluster` AWS CLI Il AWS CLI comando seguente crea un cluster Amazon DocumentDB denominato `sample-cluster` con la protezione dall'eliminazione abilitata. Per ulteriori informazioni sulla protezione dall'eliminazione, consulta. [Eliminazione di un cluster Amazon DocumentDB](db-cluster-delete.md)

Inoltre, `--engine-version` è un parametro opzionale che per impostazione predefinita è l'ultima versione principale del motore. L'attuale versione predefinita del motore è 5.0.0 (nota: Amazon DocumentDB 8.0 è disponibile ma deve essere specificata esplicitamente). Quando vengono rilasciate nuove versioni principali del motore, la versione predefinita del motore `--engine-version` verrà aggiornata per riflettere l'ultima versione principale del motore. Di conseguenza, per i carichi di lavoro di produzione, e in particolare quelli che dipendono da script, automazione o CloudFormation modelli, specifica esplicitamente la versione `--engine-version` principale prevista.

**Nota**  
Se non `vpc-security-group-id` viene specificato un valore `db-subnet-group-name` o, Amazon DocumentDB utilizzerà il gruppo di sottorete e il gruppo di sicurezza Amazon VPC predefiniti per la regione specificata.

Per Linux, macOS o Unix:

```
aws docdb create-db-cluster \
      --db-cluster-identifier {{sample-cluster}} \
      --engine docdb \
      --engine-version 5.0.0 \
      --deletion-protection \
      --master-username {{masteruser}} \
      --master-user-password {{password}}
```

Per Windows:

```
aws docdb create-db-cluster ^
      --db-cluster-identifier {{sample-cluster}} ^
      --engine docdb ^
      --engine-version 5.0.0 ^
      --deletion-protection ^
      --master-username {{masteruser}} ^
      --master-user-password {{password}}
```

L'aspetto dell'output di questa operazione è simile al seguente (formato JSON).

```
{
    "DBCluster": {
        "StorageEncrypted": false,
        "DBClusterMembers": [],
        "Engine": "docdb",
        "DeletionProtection" : "enabled",
        "ClusterCreateTime": "2018-11-26T17:15:19.885Z",
        "DBSubnetGroup": "default",
        "EngineVersion": "5.0.0",
        "MasterUsername": "{{masteruser}}",
        "BackupRetentionPeriod": 1,
        "DBClusterArn": "arn:aws:rds:us-east-1:123456789012:cluster:sample-cluster",
        "DBClusterIdentifier": "sample-cluster",
        "MultiAZ": false,
        "DBClusterParameterGroup": "default.docdb5.0",
        "PreferredBackupWindow": "09:12-09:42",
        "DbClusterResourceId": "cluster-KQSGI4MHU4NTDDRVNLNTU7XVAY",
        "PreferredMaintenanceWindow": "tue:04:17-tue:04:47",
        "Port": 27017,
        "Status": "creating",
        "ReaderEndpoint": "sample-cluster.cluster-ro-sfcrlcjcoroz.us-east-1.docdb.amazonaws.com",
        "AssociatedRoles": [],
        "HostedZoneId": "ZNKXTT8WH85VW",
        "VpcSecurityGroups": [
            {
                "VpcSecurityGroupId": "sg-77186e0d",
                "Status": "active"
            }
        ],
        "AvailabilityZones": [
            "us-east-1a",
            "us-east-1c",
            "us-east-1e"
        ],
        "Endpoint": "sample-cluster.cluster-sfcrlcjcoroz.us-east-1.docdb.amazonaws.com"
    }
}
```

La creazione del cluster richiede diversi minuti. Puoi utilizzare Console di gestione AWS o AWS CLI per monitorare lo stato del tuo cluster. Per ulteriori informazioni, consulta [Monitoraggio dello stato di un cluster Amazon DocumentDB](monitoring_docdb-cluster_status.md). 

**Importante**  
Quando si utilizza il AWS CLI per creare un cluster Amazon DocumentDB, non viene creata alcuna istanza. Di conseguenza, devi creare esplicitamente un'istanza primaria e le eventuali istanze di replica di cui hai bisogno. Puoi utilizzare la console o AWS CLI creare le istanze. Per ulteriori informazioni, consulta [Aggiungere un'istanza Amazon DocumentDB a un cluster](db-instance-add.md). 

Per ulteriori informazioni, consulta [ CreateDBCluster ](https://docs.aws.amazon.com/documentdb/latest/APIReference/API_CreateDBCluster.html) nell'API Reference di * Amazon DocumentDB. * 