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à.
# Utilizzo di Amazon DocumentDB nel Toolkit
Amazon DocumentDB (compatibile con MongoDB) è un servizio di database veloce, affidabile e completamente gestito che semplifica la configurazione, il funzionamento e la scalabilità dei database compatibili con MongoDB nel cloud.
[Per informazioni dettagliate su Amazon DocumentDB, informazioni introduttive e tutorial, consulta la Amazon DocumentDB Developer Guide.](https://docs.aws.amazon.com//documentdb/latest/developerguide/what-is.html)
Le seguenti sezioni descrivono come lavorare con Amazon DocumentDB con. AWS Toolkit for Visual Studio Code
## Accesso ad Amazon DocumentDB dal Toolkit AWS
Per accedere ad Amazon DocumentDB con il AWS Toolkit, completa la seguente procedura.
**Accesso ad Amazon DocumentDB nel Toolkit AWS**
1. Da VS Code, apri. AWS Toolkit for Visual Studio Code
1. Dal AWS Toolkit, espandi **Explorer**.
1. Da **Explorer**, espandi Amazon DocumentDB per visualizzare le tue risorse Amazon DocumentDB esistenti.
## Creazione di un cluster basato su istanze.
Per iniziare a lavorare con Amazon DocumentDB, crea un cluster completando la seguente procedura.
**Creazione di un cluster basato su istanze**
1. Da AWS Toolkit for Visual Studio Code, apri il menu contestuale per (fai clic con il pulsante destro del mouse) per Amazon DocumentDB, quindi seleziona **Crea cluster** per aprire la finestra di dialogo **Crea cluster Amazon DocumentDB** in VS Code.
1. Dalla schermata del **tipo di cluster**, scegli **Instance Based** Cluster.
1. Dalla schermata del **nome del cluster**, specifica un nome per il tuo nuovo cluster.
1. Dalla schermata **Seleziona la versione del motore**, scegli la versione del motore Amazon DocumentDB preferita.
1. Dalle schermate del **nome utente e della password** dell'amministratore, specifica un nome utente e una password di amministratore per proteggere il cluster.
1. Dalla schermata **Specify Storage encryption**, scegli se crittografare o meno il cluster.
1. Dalla schermata **Numero di istanze**, configura il numero di istanze che preferisci.
1. Dalla schermata **Seleziona la classe di istanza**, scegli la classe di istanza preferita, quindi procedi con la creazione del nuovo cluster.
**Nota**
Potrebbero essere necessari diversi minuti per avviare il cluster.
## Copia di un endpoint del cluster
Per copiare l'endpoint del cluster Amazon DocumentDB, completa la seguente procedura.
**Copia di un endpoint del cluster**
1. Da AWS Toolkit for Visual Studio Code, espandi **Amazon DocumentDB** per visualizzare i tuoi cluster Amazon DocumentDB.
1. Fai clic con il pulsante destro del mouse sul cluster da cui desideri copiare i dettagli di connessione, quindi scegli **Copia endpoint per copiare** le informazioni sull'endpoint del cluster negli appunti.
1. L'endpoint del cluster può ora essere incollato nei documenti.
## Apri nel browser
Apri i cluster Amazon DocumentDB nella AWS console per ulteriori funzionalità di gestione dei cluster. Per aprire la AWS console del cluster Amazon DocumentDB nel browser Web predefinito, completa la procedura seguente.
**Apertura del cluster nella console AWS**
1. Da AWS Toolkit for Visual Studio Code, espandi **Amazon DocumentDB** per visualizzare i tuoi cluster Amazon DocumentDB.
1. Fai clic con il pulsante destro del mouse sul cluster che desideri visualizzare nella AWS console, quindi scegli **Apri** nel browser.
1. La AWS console si apre sul cluster Amazon DocumentDB nel browser Web predefinito.
## Espansione di un cluster esistente
Per scalare i cluster Amazon DocumentDB aggiungendo istanze, completa la seguente procedura.
**Aggiungere un'istanza per espandere il cluster**
1. Da AWS Toolkit for Visual Studio Code, espandi **Amazon DocumentDB** per visualizzare i tuoi cluster Amazon DocumentDB.
1. Fai clic con il pulsante destro del mouse sul cluster che desideri espandere e scegli **Aggiungi un'istanza** per aprire la finestra di dialogo **Aggiungi un'istanza** in VS Code.
1. Quando richiesto, inserisci un nome per la nuova istanza nel campo di testo, quindi premi il **Enter** tasto per continuare.
1. Quando richiesto, seleziona una classe di istanza dall'elenco per continuare.
1. **AWS Explorer** visualizza lo stato di creazione e si aggiorna quando la nuova istanza è pronta.
## Arresto di un cluster
Arresta il tuo cluster Amazon DocumentDB completando la seguente procedura.
**Nota**
Quando il cluster è fermo, la maggior parte delle funzionalità di gestione del cluster non sarà disponibile.
**Arresto del cluster Amazon DocumentDB**
1. Da AWS Toolkit for Visual Studio Code, espandi **Amazon DocumentDB** per visualizzare i tuoi cluster Amazon DocumentDB.
1. **Scegli il pulsante **Stop Cluster situato accanto al cluster** che desideri interrompere o fai clic con il pulsante destro del mouse sul cluster e scegli Stop Cluster.**
1. Quando richiesto, scegli **Sì** per interrompere il cluster o **Annulla per annullare** il processo di arresto e lasciare il cluster in esecuzione.
1. **AWS Explorer** visualizza lo stato del cluster e si aggiorna quando il cluster si arresta.
## Riavvio di un'istanza
Il riavvio di un'istanza è utile per la risoluzione dei problemi e per apportare modifiche minori senza influire sull'intero cluster. Per riavviare un'istanza di Amazon DocumentDB, completa la seguente procedura.
**Riavvio di un'istanza cluster**
1. Da AWS Toolkit for Visual Studio Code, espandi **Amazon DocumentDB** per visualizzare i tuoi cluster Amazon DocumentDB.
1. **Fai clic con il pulsante destro del mouse sull'istanza del cluster che desideri riavviare, quindi scegli Reboot Instance.**
1. Quando richiesto, scegli **Sì** per riavviare l'istanza o **Annulla per annullare** il processo di riavvio e lasciare l'istanza interrotta.
1. **AWS Explorer** mostra lo stato del cluster e si aggiorna quando l'istanza viene riavviata.
## Eliminazione di un'istanza
Per eliminare un'istanza del cluster Amazon DocumentDB, completa la seguente procedura.
**Nota**
L'eliminazione di un'istanza non ha alcun impatto sui dati del cluster. Se elimini l'istanza principale, una delle istanze di replica assume il ruolo di istanza scrivibile.
**Eliminazione di un'istanza del cluster**
1. Da AWS Toolkit for Visual Studio Code, espandi **Amazon DocumentDB** per visualizzare i tuoi cluster Amazon DocumentDB.
1. Fai clic con il pulsante destro del mouse sull'istanza del cluster che desideri eliminare, quindi scegli **Elimina** per aprire la finestra di dialogo di delete-cluster-instance conferma in VS Code.
1. Segui la richiesta di conferma, quindi premi il **Enter** tasto per eliminare l'istanza del cluster.
1. **AWS Explorer** visualizza lo stato dell'istanza del cluster e si aggiorna quando l'istanza viene eliminata.
## Visualizzazione, aggiunta e rimozione di tag
I tag vengono utilizzati per organizzare e tenere traccia delle risorse all'interno dell'ambiente. Per visualizzare o modificare i tag associati al tuo cluster Amazon DocumentDB, completa una delle seguenti procedure.
**Visualizzazione dei tag del cluster**
1. Da AWS Toolkit for Visual Studio Code, espandi **Amazon DocumentDB** per visualizzare i tuoi cluster Amazon DocumentDB.
1. **Fai clic con il pulsante destro del mouse sul cluster di cui desideri visualizzare i tag, quindi scegli Tag...** per aprire la finestra di **your cluster name** dialogo **Tag for**.
1. I tag vengono visualizzati nella finestra di dialogo, se nessun tag è associato al cluster, viene visualizzato il messaggio **[Nessun tag assegnato]**.
**Aggiungere tag al cluster**
1. Da AWS Toolkit for Visual Studio Code, espandi **Amazon DocumentDB** per visualizzare i tuoi cluster Amazon DocumentDB.
1. **Fai clic con il pulsante destro del mouse sul cluster a cui desideri aggiungere i tag, quindi scegli Tag...** per aprire la finestra di **your cluster name** dialogo **Tag for**.
1. Scegli il pulsante **Aggiungi tag...** pulsante per aprire la finestra di dialogo **Aggiungi tag** in VS Code.
1. Inserisci un nuovo tag nel campo di testo, quindi premi il tasto **Invio** per continuare.
1. Inserisci un valore nel campo di testo, quindi premi **Invio** per aggiungere la key/value coppia al cluster.
**Rimuovere i tag dal cluster**
1. Da AWS Toolkit for Visual Studio Code, espandi **Amazon DocumentDB** per visualizzare i tuoi cluster Amazon DocumentDB.
1. **Fai clic con il pulsante destro del mouse sul cluster da cui desideri rimuovere i tag, quindi scegli Tag...** per aprire la finestra di **your cluster name** dialogo **Tag for**.
1. Scegli il pulsante **Rimuovi tag...** pulsante per aprire la finestra di **your cluster name** dialogo **Rimuovi un tag da** in VS Code.
1. Scegli il tag che desideri rimuovere dall'elenco fornito per rimuovere il tag dal tuo cluster.
## Modifica di una classe di istanza
Per modificare la classe di un'istanza del cluster Amazon DocumentDB, completa la seguente procedura.
**Modifica di una classe di istanza**
1. Da AWS Toolkit for Visual Studio Code, espandi **Amazon DocumentDB** per visualizzare i tuoi cluster Amazon DocumentDB.
1. **Fai clic con il pulsante destro del mouse sull'istanza del cluster che desideri modificare, quindi scegli Modifica classe...** per aprire la finestra di dialogo **Seleziona la classe di istanza** in VS Code.
1. Scegli una nuova classe per la tua istanza dall'elenco per aggiornare la classe.
1. **AWS Explorer** visualizza lo stato dell'istanza del cluster e si aggiorna quando la classe dell'istanza viene aggiornata.