

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á.

# Interromper e iniciar um cluster do Amazon DocumentDB
<a name="db-cluster-stop-start"></a>

Interromper e iniciar os clusters do Amazon DocumentDB pode ajudar a gerenciar os custos dos ambientes de teste e desenvolvimento. Em vez de criar e excluir clusters e instâncias toda vez que você usar o Amazon DocumentDB, você pode interromper temporariamente todas as instâncias em seu cluster quando elas não forem necessárias. Depois, é possível iniciá-las novamente, ao retomar os testes.

**Topics**
+ [Visão geral de como interromper e iniciar um cluster](#db-cluster-stop-start-overview)
+ [Operações que você pode realizar em um cluster interrompido](#db-cluster-stopped-operations)

## Visão geral de como interromper e iniciar um cluster
<a name="db-cluster-stop-start-overview"></a>

Durante os períodos nos quais não precisar de um cluster do Amazon DocumentDB, você pode interromper todas as instâncias nesse cluster de uma só vez. Depois, você pode iniciar o cluster novamente a qualquer momento, sempre que precisar usá-lo. Iniciar e interromper simplifica os processos de configuração e destruição dos clusters usados em desenvolvimento, teste ou atividades afins que não exijam disponibilidade contínua. Você pode parar e iniciar um cluster usando o Console de gerenciamento da AWS ou o AWS CLI com uma única ação, independentemente de quantas instâncias estejam no cluster.

Enquanto o cluster estiver interrompido, o volume de armazenamento do cluster permanece inalterado. Serão cobrados somente o armazenamento, as captura de telas manuais e o armazenamento do backup automatizado dentro da janela de retenção especificada. Não haverá cobrança por horas de instância. O Amazon DocumentDB iniciará automaticamente seu cluster depois de sete dias para garantir que ele não perca nenhuma atualização de manutenção necessária. Quando o cluster reiniciar após sete dias, você será cobrado pelas instâncias novamente. Enquanto o cluster é interrompido, não é possível consultar o volume de armazenamento porque a consulta requer que as instâncias estejam no estado disponível.

Quando um cluster do Amazon DocumentDB é interrompido, nem o cluster nem suas instâncias podem ser modificados, de maneira alguma. Isso inclui adicionar ou remover instâncias, ou excluir o cluster.

------
#### [ Using the Console de gerenciamento da AWS ]

O procedimento a seguir mostra como interromper um cluster com uma ou mais instâncias no estado disponível ou iniciar um cluster interrompido.

**Para interromper ou iniciar um cluster do Amazon DocumentDB**

1. [Faça login no e abra Console de gerenciamento da AWS o console do Amazon DocumentDB em https://console.aws.amazon.com /docdb.](https://console.aws.amazon.com/docdb)

1. No painel de navegação, escolha **Clusters**.
**dica**  
Caso não visualize o painel de navegação à esquerda da tela, selecione o ícone do menu (![\[Hamburger menu icon with three horizontal lines.\]](http://docs.aws.amazon.com/pt_br/documentdb/latest/developerguide/images/docdb-menu-icon.png)) no canto superior esquerdo da página.

1. Na lista de clusters, escolha o botão à esquerda do nome do cluster que você deseja interromper ou iniciar.

1. Escolha **Ações** e selecione a ação que deseja executar no cluster.
   + Se você quiser interromper o cluster e ele estiver disponível:

     1. Escolha **Parar**.  
![\[Imagem: interromper um cluster\]](http://docs.aws.amazon.com/pt_br/documentdb/latest/developerguide/images/db-cluster-stop.png)

        Para evitar a ativação do mecanismo de failover, a operação de interrupção interrompe primeiro as instâncias de réplica e, depois, a instância primária.

     1. Na caixa de diálogo de confirmação, confirme se deseja interromper o cluster, escolhendo **Interromper cluster** ou, para manter o cluster em execução, escolha **Cancelar**.  
![\[Imagem: Iniciar um cluster\]](http://docs.aws.amazon.com/pt_br/documentdb/latest/developerguide/images/db-cluster-stop-confirm.png)
   + Se quiser iniciar o cluster e o cluster estiver interrompido, escolha **Iniciar**.  
![\[Imagem: Iniciar um cluster\]](http://docs.aws.amazon.com/pt_br/documentdb/latest/developerguide/images/db-cluster-start.png)

1. Monitore o status do cluster e suas instâncias. Se você iniciou o cluster, poderá retomar o uso do cluster quando ele e suas instâncias estiverem *disponíveis*. Para obter mais informações, consulte [Determinar o status de um cluster](db-cluster-status.md).   
![\[Imagem: status de clusters em interrupção e início\]](http://docs.aws.amazon.com/pt_br/documentdb/latest/developerguide/images/db-cluster-stop-start-status.png)

------
#### [ Using the AWS CLI ]

Os exemplos de código a seguir mostram como interromper um cluster com uma ou mais instâncias no estado disponível ou iniciar um cluster interrompido.

Para interromper um cluster com uma ou mais instâncias disponíveis usando o AWS CLI, use a `stop-db-cluster` operação. Para iniciar um cluster interrompido, use a operação `start-db-cluster`. Ambas as operações usam o parâmetro `--db-cluster-identifier`.

**Parâmetro**
+ **--db-cluster-identifier**—Obrigatório. O nome do cluster a ser interrompido ou iniciado.

**Example — Para interromper um cluster usando o AWS CLI**  
O código a seguir interrompe o cluster `sample-cluster`. O cluster deve ter uma ou mais instâncias no estado disponível.  
Para Linux, macOS ou Unix:  

```
aws docdb stop-db-cluster \
   --db-cluster-identifier sample-cluster
```
Para Windows:  

```
aws docdb stop-db-cluster ^
   --db-cluster-identifier sample-cluster
```

**Example — Para iniciar um cluster usando o AWS CLI**  
O código a seguir inicia o cluster `sample-cluster`. O cluster deve estar interrompido no momento.  
Para Linux, macOS ou Unix:  

```
aws docdb start-db-cluster \
   --db-cluster-identifier sample-cluster
```
Para Windows:  

```
aws docdb start-db-cluster ^
   --db-cluster-identifier sample-cluster
```

------

## Operações que você pode realizar em um cluster interrompido
<a name="db-cluster-stopped-operations"></a>

Enquanto um cluster do Amazon DocumentDB está parado, você pode fazer uma point-in-time restauração em qualquer ponto dentro da janela de retenção automática de backup especificada. Para obter detalhes sobre como fazer uma point-in-time restauração, consulte[Restauração para um ponto no tempo](backup_restore-point_in_time_recovery.md). 

Não é possível modificar a configuração de um cluster do Amazon DocumentDB, ou de qualquer uma de suas instâncias, enquanto o cluster estiver interrompido. Também não é possível adicionar ou remover instâncias do cluster ou excluir o cluster, caso ainda tenha alguma instância associada. Será necessário iniciar o cluster antes de realizar uma dessas ações administrativas.

O Amazon DocumentDB aplicará as manutenções programadas em seu cluster interrompido somente depois que for reiniciado. Após sete dias, o Amazon DocumentDB inicia automaticamente um cluster interrompido, para que não fique muito atrasado em seu status de manutenção. Quando o cluster for reiniciado, você começará a ser cobrado pelas instâncias no cluster novamente.

Enquanto um cluster estiver interrompido, o Amazon DocumentDB não executa quaisquer backups automatizados, nem estende o período de retenção de backup.