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.
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:
- 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:
-
Faça login no e abra Console de gerenciamento da AWS 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 Modificar um cluster do 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 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.
-
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 Clusters.
-
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 <nome-cluster> 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.
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. É 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.
exemplo
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
exemplo
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.
