Excluir um cluster do Amazon DocumentDB

Para determinar se um cluster está com a proteção contra exclusão habilitada:

1. Faça login no e abra AWS Management Console o console do Amazon DocumentDB em https://console.aws.amazon.com /docdb.

2. 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 () no canto superior esquerdo da página.

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

   

4. 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:

1. No painel de navegação, escolha Clusters.

2. Determine se o cluster tem alguma instância verificando a coluna Identificador do cluster para ver as instâncias listadas abaixo dela. 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.

3. 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:

     1. No painel de navegação, escolha Clusters.

     2. Exclua cada uma das instâncias do cluster marcando 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.

        Quando você exclui a última instância, o cluster também será excluído. Para obter mais informações sobre a exclusão de instâncias, consulteExcluir uma instância do Amazon DocumentDB.

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

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

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