As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

# Trabalhar com o Amazon DocumentDB no Toolkit
<a name="docdb-overview"></a>

Amazon DocumentDB (compatível com MongoDB) é um serviço de banco de dados confiável e gerenciado que pode ser usado para configurar, operar e escalar bancos de dados compatíveis com o MongoDB na nuvem.

Para obter informações detalhadas sobre o Amazon DocumentDB, informações básicas e tutoriais, consulte o Guia do desenvolvedor do [Amazon DocumentDB.](https://docs.aws.amazon.com//documentdb/latest/developerguide/what-is.html)

As seções a seguir descrevem como trabalhar com objetos do Amazon DocumentDB por meio do AWS Toolkit for Visual Studio Code. 

## Acessando o Amazon DocumentDB a partir do kit de ferramentas AWS
<a name="docdb-overview-access"></a>

Para acessar o Amazon DocumentDB com o AWS Toolkit, conclua o procedimento a seguir.

**Acessando o Amazon DocumentDB no kit de ferramentas AWS**

1. No VS Code, abra AWS Toolkit for Visual Studio Code.

1. No AWS Kit de ferramentas, expanda o **Explorer**.

1. No **Explorer**, expanda o Amazon DocumentDB para exibir seus recursos existentes do Amazon DocumentDB.

## Criando um cluster baseado em instância.
<a name="docdb-overview-create-cluster"></a>

Para começar a trabalhar com o Amazon DocumentDB, crie um cluster concluindo o procedimento a seguir.

**Criando um cluster baseado em instância**

1. Em AWS Toolkit for Visual Studio Code, abra o menu de contexto do Amazon DocumentDB (clique com o botão direito do mouse) e **selecione Create Cluster para abrir a caixa de diálogo Create** **Amazon DocumentDB Cluster no** VS Code.

1. Em **Tipo de cluster**, escolha **Cluster baseado em instância**.

1. Na tela **Nome do cluster**, especifique o nome do seu cluster.

1. Na tela **Selecionar versão do mecanismo**, escolha sua versão preferida do mecanismo Amazon DocumentDB.

1. Nas telas de **nome de usuário e senha** do administrador, especifique um nome de usuário e uma senha de administrador para proteger seu cluster.

1. Na tela **Especificar criptografia de armazenamento**, escolha se deseja ou não criptografar seu cluster.

1. Na tela **Número de instâncias**, configure seu número preferido de instâncias.

1. Na tela **Selecionar classe de instância**, escolha sua classe de instância preferida e continue criando seu novo cluster.
**nota**  
Vários minutos podem ser necessários para o cluster ser iniciado.

## Copiando um endpoint de cluster
<a name="docdb-overview-create-cluster"></a>

Para copiar o endpoint de cluster do Amazon DocumentDB, siga o procedimento a seguir.

**Copiando um endpoint de cluster**

1. A partir de AWS Toolkit for Visual Studio Code, expanda o **Amazon DocumentDB** para exibir seus clusters do Amazon DocumentDB.

1. Clique com o botão direito do mouse no cluster do qual você deseja copiar os detalhes da conexão e escolha **Copiar endpoint** para copiar as informações do endpoint do cluster para sua área de transferência.

1. Seu endpoint de cluster agora pode ser colado em seus documentos.

## Abrir no navegador
<a name="docdb-overview-browser-cluster"></a>

Abra seus clusters do Amazon DocumentDB no AWS console para obter mais recursos de gerenciamento de clusters. Para abrir o AWS console do seu cluster Amazon DocumentDB em seu navegador da web padrão, conclua o procedimento a seguir.

**Abrindo seu cluster no AWS console**

1. A partir de AWS Toolkit for Visual Studio Code, expanda o **Amazon DocumentDB** para exibir seus clusters do Amazon DocumentDB.

1. Clique com o botão direito do mouse no cluster que você deseja visualizar no AWS console e escolha **Abrir no navegador**.

1. O AWS console se abre para o cluster Amazon DocumentDB em seu navegador da web padrão.

## Expandindo um cluster já existente
<a name="docdb-overview-expand-cluster"></a>

Para escalar os clusters do Amazon DocumentDB adicionando instâncias, siga o procedimento a seguir.

**Adicionar uma instância para expandir um cluster**

1. A partir de AWS Toolkit for Visual Studio Code, expanda o **Amazon DocumentDB** para exibir seus clusters do Amazon DocumentDB.

1. Clique com o botão direito do mouse no cluster que você deseja expandir e escolha **Adicionar uma instância** para abrir a caixa de diálogo **Adicionar uma instância** no VS Code.

1. Quando solicitado, insira um nome para sua nova instância no campo de texto e pressione a tecla **Enter** para continuar.

1. Quando solicitado, selecione uma classe de instância na lista para continuar.

1. O **AWS Explorer** exibe o status de criação e as atualizações quando a nova instância está pronta.

## Interromper um cluster
<a name="docdb-overview-stopping-cluster"></a>

Interrompa seu cluster Amazon DocumentDB concluindo o procedimento a seguir.

**nota**  
Enquanto seu cluster estiver parado, a maioria dos recursos de gerenciamento de cluster não estará disponível.

**Interrompendo o cluster do Amazon DocumentDB**

1. A partir de AWS Toolkit for Visual Studio Code, expanda o **Amazon DocumentDB** para exibir seus clusters do Amazon DocumentDB.

1. Escolha o botão **Parar Cluster** localizado ao lado do cluster que você deseja interromper ou clique com o botão direito do mouse no cluster e escolha **Parar Cluster**.

1. Quando solicitado, escolha **Sim** para interromper o cluster ou **Cancelar** para cancelar o processo de interrupção e deixar o cluster em execução.

1. O **AWS Explorer** exibe o status do seu cluster e atualiza quando o cluster é interrompido.

## Reinicializar uma instância
<a name="docdb-overview-reboot-cluster"></a>

A reinicialização de uma instância é útil para solucionar problemas e fazer pequenas alterações sem afetar todo o cluster. Para reinicializar a instância do Amazon DocumentDB, siga o procedimento a seguir.

**Reiniciando uma instância de cluster**

1. A partir de AWS Toolkit for Visual Studio Code, expanda o **Amazon DocumentDB** para exibir seus clusters do Amazon DocumentDB.

1. Clique com o botão direito do mouse na instância do cluster que você deseja reinicializar e escolha **Reinicializar** instância.

1. Quando solicitado, escolha **Sim** para reinicializar sua instância ou **Cancelar** para cancelar o processo de reinicialização e deixar sua instância parada.

1. O **AWS Explorer** exibe o status do seu cluster e atualiza quando sua instância é reinicializada.

## Excluir uma instância
<a name="docdb-overview-delete-cluster"></a>

O procedimento a seguir exclui uma instância de cluster do Amazon DocumentDB.

**nota**  
Excluir uma instância não afeta os dados no cluster. Se você excluir a instância primária, uma das instâncias de réplica assume como instância gravável.

**Excluir uma instância de cluster**

1. A partir de AWS Toolkit for Visual Studio Code, expanda o **Amazon DocumentDB** para exibir seus clusters do Amazon DocumentDB.

1. Clique com o botão direito do mouse na instância do cluster que você deseja excluir e escolha **Excluir** para abrir a caixa de diálogo de delete-cluster-instance confirmação no VS Code.

1. Siga o prompt de confirmação e pressione a tecla **Enter** para excluir sua instância de cluster.

1. O **AWS Explorer** exibe o status da sua instância de cluster e atualiza quando sua instância é excluída.

## Visualização, adição e remoção de tags
<a name="docdb-overview-tags"></a>

As tags são usadas para organizar e rastrear recursos em seu ambiente. Para visualizar ou editar tags associadas ao cluster do Amazon DocumentDB, siga um dos procedimentos a seguir.

**Visualizar o status do cluster**

1. A partir de AWS Toolkit for Visual Studio Code, expanda o **Amazon DocumentDB** para exibir seus clusters do Amazon DocumentDB.

1. Clique com o botão direito do mouse no cluster do qual você deseja visualizar as tags e escolha **Tags** para abrir as **Tags para **your cluster name****.

1. Suas tags são exibidas na janela de diálogo. Se nenhuma tag estiver associada ao seu cluster, a mensagem **[Nenhuma tag atribuída]** será exibida.

**Adicionar tags a um cluster.**

1. A partir de AWS Toolkit for Visual Studio Code, expanda o **Amazon DocumentDB** para exibir seus clusters do Amazon DocumentDB.

1. Clique com o botão direito do mouse no cluster ao qual você deseja adicionar tags e escolha **Tags** para abrir as **Tags para **your cluster name**** diálogo.

1. Escolha a opção **Adicionar tag** para abrir a caixa de diálogo **Adicionar tag** no VS Code.

1. Insira uma nova tag no campo de texto e pressione a tecla **Enter** para continuar.

1. Insira um valor no campo de texto e pressione **Enter** para adicionar o key/value par ao seu cluster.

**Remover tags de seu cluster**

1. A partir de AWS Toolkit for Visual Studio Code, expanda o **Amazon DocumentDB** para exibir seus clusters do Amazon DocumentDB.

1. Clique com o botão direito do mouse no cluster do qual você deseja remover as tags e escolha **Tags** para abrir as **Tags para **your cluster name****.

1. Escolha a tag **Remover** para abrir a caixa de diálogo **Remover uma tag do **your cluster name**** no VS Code.

1. Escolha a tag que você deseja remover da lista fornecida para remover a tag do seu cluster.

## Modificar uma instância
<a name="docdb-overview-instance-class"></a>

Para modificar a classe de uma instância de cluster do Amazon DocumentDB, conclua o procedimento a seguir.

**Modificar uma instância**

1. A partir de AWS Toolkit for Visual Studio Code, expanda o **Amazon DocumentDB** para exibir seus clusters do Amazon DocumentDB.

1. Clique com o botão direito do mouse na instância do cluster que você deseja modificar e escolha **Modificar classe** para abrir a caixa de diálogo **Selecionar classe de instância** no VS Code.

1. Escolha uma nova classe para sua instância na lista para atualizar a classe.

1. O **AWS Explorer** exibe o status da sua instância de cluster e atualiza quando a classe da sua instância é atualizada.