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 cluster elastici di Amazon DocumentDB
Per gestire un cluster elastico di Amazon DocumentDB, è necessario disporre di una policy IAM con le autorizzazioni appropriate del piano di controllo di Amazon DocumentDB. Queste autorizzazioni consentono di creare, modificare ed eliminare i cluster. La policy di Amazon Document DBFull Access fornisce tutte le autorizzazioni necessarie per amministrare un cluster elastico Amazon DocumentDB.
I seguenti argomenti mostrano come eseguire varie attività quando si lavora con i cluster elastici di Amazon DocumentDB.
**Topics**
+ [Modifica delle configurazioni dei cluster elastici](#elastic-modify)
+ [Monitoraggio di un cluster elastico](#elastic-monitor)
+ [Eliminazione di un cluster elastico](#elastic-delete)
+ [Gestione delle istantanee dei cluster elastici](elastic-manage-snapshots.md)
+ [Arresto e avvio di un cluster elastico Amazon DocumentDB](elastic-cluster-stop-start.md)
+ [Manutenzione dei cluster elastici di Amazon DocumentDB](elastic-cluster-maintenance.md)
## Modifica delle configurazioni dei cluster elastici
In questa sezione spieghiamo come modificare il cluster elastico, utilizzando Console di gestione AWS o AWS CLI con le seguenti istruzioni.
Uno degli usi principali della modifica del cluster consiste nel ridimensionare gli shard aumentando o diminuendo il numero di frammenti (capacità di calcolo and/or dello shard).
------
#### [ Using the Console di gestione AWS ]
Per modificare una configurazione elastica del cluster utilizzando: Console di gestione AWS
1. Accedi [Console di gestione AWS](https://console.aws.amazon.com/docdb/home?region=us-east-1)e apri la console Amazon DocumentDB.
1. Nel pannello di navigazione scegliere **Cluster**.
**Suggerimento**
Se non vedi il riquadro di navigazione sul lato sinistro dello schermo, scegli l'icona del menu nell'angolo in alto a sinistra del pannello di navigazione.
1. Scegli il nome del cluster che desideri modificare nella colonna Identificatore del **cluster**.
1. Scegli **Modifica**.
1. Modifica i campi che desideri modificare, quindi seleziona **Modifica cluster**.
**Nota**
**In alternativa, puoi accedere alla finestra di dialogo **Modifica cluster** accedendo alla pagina **Cluster**, selezionando la casella accanto al cluster, scegliendo **Azioni**, quindi Modifica.**
------
#### [ Using the AWS CLI ]
Per modificare una configurazione di cluster elastico utilizzando il AWS CLI, utilizza l'`update-cluster`operazione con i seguenti parametri:
+ **--cluster-arn**: obbligatorio. L'identificatore ARN del cluster che si desidera modificare.
+ **--shard-capacity**—Facoltativo. Il numero di v CPUs assegnato a ogni shard. Il massimo è 64. I valori consentiti sono 2, 4, 8, 16, 32, 64.
+ **--shard-count**—Facoltativo. Il numero di shard assegnati al cluster. Il massimo è 32.
+ **--shard-instance**-Count: facoltativo. Il numero di istanze di replica applicabili a tutti gli shard di questo cluster. Il massimo è 16.
+ **--auth-type**—Facoltativo. Il tipo di autenticazione utilizzato per determinare dove recuperare la password utilizzata per accedere al cluster elastico. I tipi validi sono `PLAIN_TEXT` o`SECRET_ARN`.
+ **--admin-user-password**—Facoltativo. La password associata all'utente amministratore.
+ **--vpc-security-group-ids**—Facoltativo. Configura un elenco di gruppi di sicurezza Amazon EC2 e Amazon Virtual Private Cloud (VPC) da associare a questo cluster.
+ **--preferred-maintenance-window**—Facoltativo. Configura l'intervallo di tempo settimanale durante il quale può avvenire la manutenzione del sistema, in UTC (Universal Coordinated Time)
Il formato è:`ddd:hh24:mi-ddd:hh24:mi`. Giorni validi (gdd): lun, mar, mer, gio, ven, sab, dom
L'impostazione predefinita è una finestra di 30 minuti selezionata a caso da un periodo di 8 ore per ogni regione di Amazon Web Services, che si verifica in un giorno casuale della settimana.
Finestra minima di 30 minuti.
+ **--subnet-ids**—Facoltativo. Configura gli ID delle sottoreti di rete.
Nell'esempio seguente, sostituisci ciascuno di essi {{user input placeholder}} con le tue informazioni.
Per Linux, macOS o Unix:
```
aws docdb-elastic update-cluster \
--cluster-arn {{arn:aws:docdb-elastic:us-east-1:477568257630:cluster/b9f1d489-6c3e-4764-bb42-da62ceb7bda2}} \
--shard-capacity {{8}} \
--shard-count {{4}} \
--shard-instance-count {{3}} \
--admin-user-password {{testPassword}} \
--vpc-security-group-ids {{ec-65f40350}} \
--subnet-ids {{subnet-9253c6a3, subnet-9f1b5af9}}
```
Per Windows:
```
aws docdb-elastic update-cluster ^
--cluster-arn {{arn:aws:docdb-elastic:us-east-1:477568257630:cluster/b9f1d489-6c3e-4764-bb42-da62ceb7bda2}} ^
--shard-capacity {{8}} ^
--shard-count {{4}} ^
--shard-instance-count {{3}} ^
--admin-user-password {{testPassword}} ^
--vpc-security-group-ids {{ec-65f40350}} ^
--subnet-ids {{subnet-9253c6a3, subnet-9f1b5af9}}
```
------
Per monitorare lo stato del cluster elastico dopo la modifica, vedi Monitoraggio di un cluster elastico.
## Monitoraggio di un cluster elastico
In questa sezione, spieghiamo come monitorare il cluster elastico, utilizzando Console di gestione AWS o AWS CLI con le seguenti istruzioni.
------
#### [ Using the Console di gestione AWS ]
Per monitorare una configurazione di cluster elastico utilizzando Console di gestione AWS:
1. Accedi [Console di gestione AWS](https://console.aws.amazon.com/docdb/home?region=us-east-1)e apri la console Amazon DocumentDB.
1. Nel pannello di navigazione scegliere **Cluster**.
**Suggerimento**
Se non vedi il riquadro di navigazione sul lato sinistro dello schermo, scegli l'icona del menu nell'angolo in alto a sinistra del pannello di navigazione.
1. Scegli il nome del cluster che desideri monitorare nella colonna Identificatore del **cluster**.
1. Scegli la scheda **Monitoraggio**.
CloudWatch Vengono visualizzati alcuni grafici di Amazon per le seguenti categorie di monitoraggio:
+ Utilizzo delle risorse
+ Throughput
+ Operazioni
+ Sistema
Puoi anche accedere ad Amazon CloudWatch tramite il Console di gestione AWS per configurare il tuo ambiente di monitoraggio per i tuoi cluster elastici.
------
#### [ Using the AWS CLI ]
Per monitorare una configurazione specifica di un cluster elastico utilizzando il AWS CLI, utilizza l'`get-cluster`operazione con i seguenti parametri:
+ **--cluster-arn**: obbligatorio. L'identificatore ARN del cluster per il quale desideri informazioni.
Nell'esempio seguente, sostituisci ciascuno di essi {{user input placeholder}} con le tue informazioni.
Per Linux, macOS o Unix:
```
aws docdb-elastic get-cluster \
--cluster-arn {{arn:aws:docdb-elastic:us-west-2:123456789012:cluster:/68ffcdf8-e3af-40a3-91e4-24736f2dacc9}}
```
Per Windows:
```
aws docdb-elastic get-cluster ^
--cluster-arn {{arn:aws:docdb:-elastic:us-west-2:123456789012:cluster:/68ffcdf8-e3af-40a3-91e4-24736f2dacc9}}
```
L'output di questa operazione è simile al seguente:
```
"cluster": {
...
"clusterArn": "arn:aws:docdb-elastic:us-west-2:123456789012:cluster:/68ffcdf8-e3af-40a3-91e4-24736f2dacc9",
"clusterEndpoint": "stretch-11-477568257630.us-east-1.docdb-elastic.amazonaws.com",
"readerEndpoint": "stretch-11-477568257630-ro.us-east-1.docdb-elastic.amazonaws.com",
"clusterName": "stretch-11",
"shardCapacity": 2,
"shardCount": 3,
"shardInstanceCount: 5,
"status": "ACTIVE",
...
}
```
Per ulteriori informazioni, consulta `DescribeClusterSnapshot` Amazon DocumentDB Resource Management API Reference.
Per visualizzare i dettagli di tutti i cluster elastici che utilizzano il AWS CLI, utilizza l'`list-clusters`operazione con i seguenti parametri:
+ **--next-token**—Facoltativo. Se l'output del numero di elementi (`--max-results`) è inferiore rispetto al numero totale di elementi restituito dalle chiamate API sottostanti, l'output include `NextToken`, che può essere trasferito a un comando successivo per recuperare il set di elementi successivo.
+ **--max-results**—Facoltativo. Il numero totale di elementi da restituire nell'output del comando. Se esistono più risultati rispetto al `max-results` valore specificato, nella risposta viene incluso un token di paginazione (`next-token`) in modo da poter recuperare i risultati rimanenti.
+ Impostazione predefinita: 100
+ Minimo 20, massimo 100
Nell'esempio seguente, sostituisci ciascuno {{user input placeholder}} con le tue informazioni.
Per Linux, macOS o Unix:
```
aws docdb-elastic list-clusters \
--next-token {{eyJNYXJrZXIiOiBudWxsLCAiYm90b190cnVuY2F0ZV9hbW91bnQiOiAxfQ==}} \
--max-results {{2}}
```
Per Windows:
```
aws docdb-elastic list-clusters ^
--next-token {{eyJNYXJrZXIiOiBudWxsLCAiYm90b190cnVuY2F0ZV9hbW91bnQiOiAxfQ==}} ^
--max-results {{2}}
```
L'output di questa operazione è simile al seguente:
```
{
"Clusters": [
{
"ClusterIdentifier":"mycluster-1",
"ClusterArn":"arn:aws:docdb:us-west-2:123456789012:sharded-cluster:sample-cluster"
"Status":"available",
"ClusterEndpoint":"sample-cluster.sharded-cluster-corcjozrlsfc.us-west-2.docdb.amazonaws.com"
}
{
"ClusterIdentifier":"mycluster-2",
"ClusterArn":"arn:aws:docdb:us-west-2:987654321098:sharded-cluster:sample-cluster"
"Status":"available",
"ClusterEndpoint":"sample-cluster2.sharded-cluster-corcjozrlsfc.us-west-2.docdb.amazonaws.com"
}
]
}
```
------
## Eliminazione di un cluster elastico
In questa sezione spieghiamo come eliminare un cluster elastico, utilizzando Console di gestione AWS o AWS CLI con le seguenti istruzioni.
------
#### [ Using the Console di gestione AWS ]
Per eliminare una configurazione di cluster elastico utilizzando Console di gestione AWS:
1. Accedi [Console di gestione AWS](https://console.aws.amazon.com/docdb/home?region=us-east-1)e apri la console Amazon DocumentDB.
1. Nel pannello di navigazione scegliere **Cluster**.
**Suggerimento**
Se non vedi il riquadro di navigazione sul lato sinistro dello schermo, scegli l'icona del menu nell'angolo in alto a sinistra del pannello di navigazione.
1. **Nella tabella con l'elenco dei cluster, seleziona la casella di controllo a sinistra del nome del cluster che desideri eliminare, quindi scegli Azioni.** Dal menu a discesa, scegli **Delete (Elimina)**.
1. Nel cluster **elastico Elimina «nome-cluster»?** **nella finestra di dialogo, scegli Elimina.**
Sono necessari alcuni minuti per l'eliminazione del cluster. Per monitorare lo stato del cluster, consulta [Monitoraggio dello stato di un cluster Amazon DocumentDB](https://docs.aws.amazon.com//documentdb/latest/developerguide/monitoring_docdb-cluster_status.html).
------
#### [ Using the AWS CLI ]
Per eliminare un cluster elastico utilizzando il AWS CLI, utilizza l'`delete-cluster`operazione con i seguenti parametri:
+ **--cluster-arn**: obbligatorio. L'identificatore ARN del cluster che si desidera eliminare.
+ **--no-skip-final-backup**—Facoltativo. Se si desidera un backup finale, è necessario includere questo parametro con un nome per il backup finale. È necessario includere `--final-backup-identifier` o `--skip-final-backup`.
+ **--skip-final-backup**—Facoltativo. Utilizzate questo parametro solo se non desiderate eseguire un backup finale prima di eliminare il cluster. L'impostazione predefinita prevede l'acquisizione di uno snapshot finale
I seguenti esempi di AWS CLI codice eliminano un cluster con un ARN di arn:aws:docdb:us-west- 2:123456789012:sharded-cluster:sample-cluster con un backup finale.
Nell'esempio seguente, sostituisci ciascuno {{user input placeholder}} con le tue informazioni..
Per Linux, macOS o Unix:
```
aws docdb-elastic delete-cluster \
--cluster-arn {{arn:aws:docdb:us-west-2:123456789012:sharded-cluster:sample-cluster}} \
--no-skip-final-backup \
--final-backup-identifier finalArnBU-arn:{{aws:docdb:us-west-2:123456789012:sharded-cluster:sample-cluster}}
```
Per Windows:
```
aws docdb-elastic delete-cluster ^
--cluster-arn {{arn:aws:docdb:us-west-2:123456789012:sharded-cluster:sample-cluster}} ^
--no-skip-final-backup ^
--final-backup-identifier finalArnBU-arn:{{aws:docdb:us-west-2:123456789012:sharded-cluster:sample-cluster}}
```
I seguenti esempi di AWS CLI codice eliminano un cluster con un ARN di arn:aws:docdb:us-west- 2:123456789012:sharded-cluster:sample-cluster senza eseguire un backup finale.
Nell'esempio seguente, sostituisci ciascuno {{user input placeholder}} con le tue informazioni.
Per Linux, macOS o Unix:
```
aws docdb-elastic delete-cluster \
--cluster-arn {{arn:aws:docdb:us-west-2:123456789012:sharded-cluster:sample-cluster}} \
--skip-final-backup \
```
Per Windows:
```
aws docdb-elastic delete-cluster ^
--cluster-arn {{arn:aws:docdb:us-west-2:123456789012:sharded-cluster:sample-cluster}} ^
--skip-final-backup ^
```
L'output dell'`delete-cluster`operazione è una visualizzazione del cluster che si sta eliminando.
Sono necessari alcuni minuti per l'eliminazione del cluster. Per monitorare lo stato del cluster, consulta [Monitoraggio dello stato di un cluster Amazon DocumentDB](https://docs.aws.amazon.com/documentdb/latest/developerguide/monitoring_docdb-cluster_status.html).
------