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á.
Excluindo um cluster do Amazon DocumentDB
Você pode excluir um cluster do Amazon DocumentDB usando o AWS Management Console 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 ter mais informações, consulte Interrompendo e iniciando um cluster Amazon DocumentDB.
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. Você pode 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. Você pode 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:
- Using the AWS Management Console
-
Para excluir um cluster usando o AWS Management Console, a proteção contra exclusão deve estar desativada.
Para determinar se um cluster está com a proteção contra exclusão habilitada:
-
Faça login no e abra AWS Management Console o console do Amazon DocumentDB em https://console.aws.amazon.com/docdb.
-
No painel de navegação, escolha Clusters.
Caso não visualize o painel de navegação à esquerda da tela, selecione o ícone do menu (
) no canto superior esquerdo da página.
-
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.
-
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 Modificação de um cluster Amazon DocumentDB.
Após desabilitar a Proteção contra exclusão, você estará pronto para excluir o cluster.
Para excluir um cluster:
-
No painel de navegação, escolha Clusters.
-
Determine se o cluster tem instâncias verificando a coluna Instâncias. Antes de excluir um cluster, é necessário excluir todas as instâncias. Para ter mais informações, consulte Excluindo uma instância do Amazon DocumentDB .
-
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 <nome-cluster> e escolha Excluir.
Se o cluster tiver uma ou mais instâncias, faça o seguinte:
-
No painel de navegação, escolha Instâncias.
-
Exclua cada uma das instâncias do cluster. Ao excluir a última instância, o cluster também será excluído. Para obter informações sobre como excluir instâncias, consulte Excluindo uma instância do Amazon DocumentDB .
A exclusão do cluster demora alguns minutos. Para monitorar o status do cluster, consulte Monitoramento do status de um cluster do Amazon DocumentDB.
- 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.
-
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
-
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.
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
-
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. Você deve 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 podem terminar com um hífen ou conter dois hífens 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. Você deve 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.
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
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.
