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á.
# Excluir um cluster do Amazon DocumentDB
Você pode excluir um cluster do Amazon DocumentDB usando o Console de gerenciamento da AWS ou o. AWS CLI Para excluir um cluster, o cluster deve estar no estado *disponível* e não deve ter nenhuma instância associada a ele. Se o cluster foi interrompido, primeiro inicie-o, aguarde até que fique *disponível* e então, exclua-o. Para obter mais informações, consulte [Interromper e iniciar um cluster do Amazon DocumentDB](db-cluster-stop-start.md).
## Deletion protection (Proteção contra exclusão)
Para proteger seu cluster contra a exclusão acidental, você pode habilitar a *proteção contra exclusão*. A proteção contra exclusão está habilitada por padrão ao criar um cluster usando o console. No entanto, a proteção contra exclusão será desabilitada por padrão, se você criar um cluster usando a AWS CLI.
O Amazon DocumentDB aplicará a proteção contra exclusão para um cluster se você executar a operação de exclusão usando o console ou AWS CLI. Se a proteção contra exclusão estiver habilitada, não será possível excluir um cluster. Para excluir um cluster com a projeção contra exclusão habilitada, primeiro é necessário modificar o cluster e desabilitar a proteção contra exclusão.
Ao usar o console com a proteção contra exclusão habilitada em um cluster, não será possível excluir a última instância do cluster, pois isso também excluirá o cluster. É possível excluir a última instância de um cluster protegido contra exclusão usando a AWS CLI. No entanto, o cluster em si ainda existirá e seus dados serão preservados. É possível acessar os dados criando novas instâncias para o cluster. Para obter mais informações sobre como habilitar e desabilitar a proteção contra exclusão, consulte:
+ [Criar um cluster do Amazon DocumentDB](db-cluster-create.md)
+ [Modificar um cluster do Amazon DocumentDB](db-cluster-modify.md)
------
#### [ Using the Console de gerenciamento da AWS ]
Para excluir um cluster usando o Console de gerenciamento da AWS, a proteção contra exclusão deve estar desativada.
**Para determinar se um cluster está com a proteção contra exclusão habilitada:**
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. Observe que, na caixa de navegação Clusters, a coluna **Identificador do cluster** mostra tanto os clusters quanto as instâncias. Suas instâncias estão listadas em clusters, semelhante ao snapshot abaixo.
![\[Imagem: a caixa de navegação Clusters mostrando uma lista dos links de cluster existentes e seus links de instância correspondentes.\]](http://docs.aws.amazon.com/pt_br/documentdb/latest/developerguide/images/clusters.png)
1. Escolha o nome do cluster e selecione a guia **Configuração**. Na seção **Detalhes do cluster**, localize **Proteção contra exclusão**. Se a proteção contra exclusão estiver habilitada, modifique o cluster para desabilitar a proteção contra exclusão. Para obter informações sobre como modificar um cluster, consulte [Modificar um cluster do Amazon DocumentDB](db-cluster-modify.md).
Após desabilitar a **Proteção contra exclusão**, você estará pronto para excluir o cluster.
**Para excluir um cluster:**
1. No painel de navegação, escolha **Clusters**.
1. Determine se o cluster tem instâncias verificando a coluna **Identificador do cluster** para as instâncias lidas abaixo dele. Antes de excluir um cluster, é necessário excluir todas as instâncias. Para obter mais informações, consulte [Excluir uma instância do Amazon DocumentDB](db-instance-delete.md).
1. Dependendo de o cluster ter ou não instâncias, realize uma das seguintes etapas.
+ Se o cluster não tiver instâncias, selecione o botão à esquerda do nome do cluster e escolha **Ações**. No menu suspenso, escolha **Excluir**. Preencha a caixa de diálogo **Excluir ** e escolha **Excluir**.
+ Se o cluster tiver uma ou mais instâncias, faça o seguinte:
1. No painel de navegação, escolha **Clusters**.
1. Exclua cada uma das instâncias do cluster escolhendo a caixa de seleção à esquerda do nome do cluster. Selecione **Ações** e escolha **Excluir**. Preencha a caixa de diálogo **Excluir ** e escolha **Excluir**.
Ao excluir a última instância, o cluster também será excluído. Para obter informações sobre a exclusão de instâncias, consulte [Excluir uma instância do Amazon DocumentDB](db-instance-delete.md).
A exclusão do cluster demora alguns minutos. Para monitorar o status do cluster, consulte [Monitoramento do status de um cluster do Amazon DocumentDB](monitoring_docdb-cluster_status.md).
------
#### [ Using the AWS CLI ]
Não é possível excluir um cluster que tenha instâncias associadas a ele. Para determinar quais instâncias estão associadas ao cluster, execute o comando `describe-db-clusters` e exclua todas as instâncias do cluster. Depois, se necessário, desabilite a proteção contra exclusão no cluster e, finalmente, exclua o cluster.
1. **Primeiro, exclua todas as instâncias do cluster.**
Para determinar quais instâncias você precisa excluir, execute o comando a seguir.
```
aws docdb describe-db-clusters \
--db-cluster-identifier sample-cluster \
--query 'DBClusters[*].[DBClusterIdentifier,DBClusterMembers[*].DBInstanceIdentifier]'
```
A saída dessa operação é semelhante ao seguinte (formato JSON).
```
[
[
"sample-cluster",
[
"sample-instance-1",
"sample-instance-2"
]
]
]
```
Se o cluster que você deseja excluir tiver instâncias, exclua-as conforme abaixo.
```
aws docdb delete-db-instance \
--db-instance-identifier sample-instance
```
1. **Em segundo lugar, desabilite a proteção contra exclusão**.
Usar o AWS CLI para excluir todas as instâncias de um cluster não exclui o cluster. Também é necessário excluir o cluster, mas isso só poderá ser feito se a proteção contra exclusão estiver desabilitada.
Para determinar se o cluster está com a proteção contra exclusão habilitada, execute o comando a seguir.
**dica**
Para ver o status da proteção contra exclusão de todos os clusters do Amazon DocumentDB, omita o parâmetro `--db-cluster-identifier`.
```
aws docdb describe-db-clusters \
--db-cluster-identifier sample-cluster \
--query 'DBClusters[*].[DBClusterIdentifier,DeletionProtection]'
```
A saída dessa operação é semelhante à seguinte.
```
[
[
"sample-cluster",
"true"
]
]
```
Se o cluster estiver com a proteção contra exclusão habilitada, modifique o cluster e desabilite a proteção contra exclusão. Para desabilitar a proteção contra exclusão no cluster, use o comando a seguir.
```
aws docdb modify-db-cluster \
--db-cluster-identifier sample-cluster \
--no-deletion-protection \
--apply-immediately
```
1. **Para finalizar, exclua o cluster.**
Após desabilitar a proteção contra exclusão, você estará pronto para excluir o cluster. Para excluir um cluster, use a operação `delete-db-cluster` com os parâmetros a seguir.
+ **--db-cluster-identifier**—Obrigatório. O identificador do cluster que deseja excluir.
+ **--final-db-snapshot-identifier**— opcional. Se você quiser uma captura de tela final, inclua esse parâmetro com um nome para a captura de tela final. É necessário incluir `--final-db-snapshot-identifier` ou `--skip-final-snapshot`.
Restrições de nomenclatura:
+ O comprimento é de [1 a 63] letras, números ou hifens.
+ O primeiro caractere deve ser uma letra.
+ Não pode terminar com um hífen ou conter dois hifens consecutivos.
+ Deve ser exclusivo para todos os clusters do Amazon RDS, Amazon Neptune e Amazon DocumentDB por região. Conta da AWS
+ **--skip-final-snapshot**— opcional. Use esse parâmetro somente se não quiser obter um captura de tela final antes de excluir seu cluster. A configuração padrão é obter uma captura de tela final. É necessário incluir `--final-db-snapshot-identifier` ou `--skip-final-snapshot`.
O AWS CLI código a seguir exclui o cluster `sample-cluster` com um instantâneo final. A operação falhará se houver instâncias associadas ao cluster ou se a proteção contra exclusão estiver desabilitada.
**Example**
Para Linux, macOS ou Unix:
```
aws docdb delete-db-cluster \
--db-cluster-identifier sample-cluster \
--final-db-snapshot-identifier sample-cluster-final-snapshot
```
Para Windows:
```
aws docdb delete-db-cluster ^
--db-cluster-identifier sample-cluster ^
--final-db-snapshot-identifier sample-cluster-final-snapshot
```
**Example**
O AWS CLI código a seguir exclui o cluster `sample-cluster` sem tirar um instantâneo final.
Para Linux, macOS ou Unix:
```
aws docdb delete-db-cluster \
--db-cluster-identifier sample-cluster \
--skip-final-snapshot
```
Para Windows:
```
aws docdb delete-db-cluster ^
--db-cluster-identifier sample-cluster ^
--skip-final-snapshot
```
A saída da operação `delete-db-cluster` é o cluster que você está excluindo.
A exclusão do cluster demora alguns minutos. Para monitorar o status do cluster, consulte [Monitorar o status de um cluster](monitoring_docdb-cluster_status.md).
------