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à.
# Lavorare con Amazon DocumentDB nel Toolkit
Amazon DocumentDB (con compatibilità con MongoDB) è un servizio di database veloce, affidabile e completamente gestito che semplifica la configurazione, il funzionamento e la scalabilità dei database nel cloud. MongoDB-compatible
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](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 da AWS Kit di strumenti
Per accedere ad Amazon DocumentDB con il AWS Toolkit, completa la seguente procedura.
**Accesso ad Amazon DocumentDB in AWS Kit di strumenti**
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 risorse Amazon DocumentDB esistenti.
## Creazione di un cluster basato su istanze.
Per iniziare a lavorare con Amazon DocumentDB, crea un cluster completando la procedura seguente.
**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), 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 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 ** Specifica la crittografia dello storage, 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**
L'avvio del cluster potrebbe richiedere diversi minuti.
## Copiare un endpoint del cluster
Per copiare l'endpoint del tuo cluster Amazon DocumentDB, completa la seguente procedura.
**Copiare un endpoint del cluster**
1. Da AWS Toolkit for Visual Studio Code, espandi ** Amazon DocumentDB ** per visualizzare i tuoi cluster Amazon DocumentDB.
1. Right-click il cluster da cui vuoi copiare i dettagli di connessione, quindi scegli ** Copy 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 seguente procedura.
**Aprire il cluster nel AWS Console**
1. Da AWS Toolkit for Visual Studio Code, espandi ** Amazon DocumentDB ** per visualizzare i tuoi cluster Amazon DocumentDB.
1. Right-click il cluster che desideri visualizzare nella AWS console, quindi scegli ** Apri nel browser. **
1. La AWS console apre il 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. Right-click il 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 tua 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. L'**AWS Explorer ** visualizza lo stato di creazione e si aggiorna quando la nuova istanza è pronta.
## Arresto di un cluster
Arresta il cluster Amazon DocumentDB completando la seguente procedura.
**Nota**
Mentre il cluster è fermo, la maggior parte delle funzionalità di gestione del cluster non sarà disponibile.
**Interruzione 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 interruzione e lasciare il cluster in esecuzione.
1. L'**AWS Explorer ** mostra lo stato del cluster e si aggiorna quando il cluster viene interrotto.
## Riavvio di un'istanza
Il riavvio di un'istanza è utile per risolvere i problemi e apportare modifiche minori senza influire sull'intero cluster. Per riavviare un'istanza 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. Right-click l'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. L'**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. Right-click l'istanza del cluster che desideri eliminare, quindi scegli ** Elimina per aprire la finestra di dialogo ** di conferma delete-cluster-instance in VS Code.
1. Segui la richiesta di conferma, quindi premi il tasto per eliminare l'istanza del **Enter** cluster.
1. L'**AWS Explorer ** mostra lo stato dell'istanza del cluster e si aggiorna quando l'istanza è stata 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. Right-click il cluster per cui desideri visualizzare i tag, quindi scegli Tag... ** **per aprire la finestra di **your cluster name** ** dialogo ** Tag per.
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. Right-click il cluster per cui desideri aggiungere i tag, quindi scegli Tag... ** **per aprire la finestra di **your cluster name** ** dialogo ** Tag for.
1. Scegli il tag ** Aggiungi... **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. Right-click il cluster da cui vuoi 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 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. Right-click l'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. L'**AWS Explorer ** mostra lo stato dell'istanza del cluster e si aggiorna quando la classe dell'istanza è stata aggiornata.