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 AWS Management Console e abra 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 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 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 Instâncias.

     2. 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 Excluir 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 a AWS CLI para excluir todas as instâncias de um cluster não excluirá 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 a 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 no Amazon RDS, Amazon Neptune e Amazon DocumentDB porConta da AWS, por Região.

   • --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 seguinte código da AWS CLI exclui o cluster sample-cluster com uma captura de tela 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 seguinte código da AWS CLI exclui o cluster sample-cluster sem realizar uma captura de tela 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.