Interromper e iniciar um cluster elástico do Amazon DocumentDB - Amazon DocumentDB

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

Interromper e iniciar um cluster elástico do Amazon DocumentDB

Interromper e iniciar clusters elásticos do Amazon DocumentDB pode ajudar a gerenciar os custos dos ambientes de teste e desenvolvimento. Em vez de criar e excluir clusters elásticos toda vez que você usar o Amazon DocumentDB, você pode interromper temporariamente seu cluster quando não for necessário. Depois, é possível iniciá-lo novamente, ao retomar os testes.

Visão geral de como interromper e iniciar um cluster elástico

Durante os períodos nos quais não precisar de um cluster elástico do Amazon DocumentDB, você pode interromper o cluster. Depois, você pode iniciar o cluster novamente a qualquer momento, sempre que precisar usá-lo. Iniciar e interromper simplifica os processos de configuração e destruição dos clusters elásticos usados em desenvolvimento, teste ou atividades afins que não exijam disponibilidade contínua. Você pode parar e iniciar um cluster elástico usando o AWS Management Console ou o AWS CLI com uma única ação.

Enquanto o cluster elástico estiver interrompido, o volume de armazenamento do cluster permanecerá inalterado. Serão cobrados somente o armazenamento, as captura de telas manuais e o armazenamento do backup automatizado dentro da janela de retenção especificada. O Amazon DocumentDB iniciará automaticamente seu cluster elástico depois de sete dias para garantir que ele não perca nenhuma atualização de manutenção necessária. Quando o cluster reiniciar após sete dias, você começará a ser cobrado pelo uso do cluster elástico novamente. Enquanto o cluster está interrompido, não é possível consultar o volume de armazenamento porque a consulta requer que o cluster esteja no estado disponível.

Quando um cluster elástico do Amazon DocumentDB é interrompido, não pode ser modificado de maneira alguma. Isso inclui sua exclusão.

Using the AWS Management Console

O procedimento a seguir mostra como interromper um cluster elástico com no estado disponível ou iniciar um cluster elástico interrompido.

Para interromper ou iniciar um cluster elástico do Amazon DocumentDB
  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 (Hamburger menu icon with three horizontal lines.) no canto superior esquerdo da página.

  3. Na lista de clusters, escolha o botão à esquerda do nome do cluster que você deseja interromper ou iniciar.

    Um cluster da lista Clusters, com a caixa de seleção marcada à esquerda do nome do cluster.
  4. Escolha Ações e selecione a ação que deseja executar no cluster.

    • Se você quiser interromper o cluster e ele estiver disponível:

      1. Escolha Parar.

        A lista suspensa Ações com a opção Parar selecionada.
      2. Na caixa de diálogo de confirmação, confirme se deseja interromper o cluster elástico escolhendo Interromper cluster ou, para manter o cluster em execução, escolha Cancelar.

        Caixa de diálogo de confirmação para interromper um cluster, com os botões Cancelar e Parar agrupamento na parte inferior.
    • Se quiser iniciar o cluster e o cluster estiver interrompido, escolha Iniciar.

      A lista suspensa Ações com a opção Iniciar selecionada.
  5. Monitorar o status do cluster elástico. Se você iniciou o cluster, poderá retomar seu uso quando ele estiver disponível. Para obter mais informações, consulte Determinar o status de um cluster.

    Coluna de status na tabela Clusters mostrando os status disponíveis e iniciais.
Using the AWS CLI

Os exemplos de código a seguir mostram como interromper um cluster elástico no estado ativo ou disponível ou iniciar um cluster elástico interrompido.

Para parar um cluster elástico usando o AWS CLI, use a stop-cluster operação. Para iniciar um cluster interrompido, use a operação start-cluster. Ambas as operações usam o parâmetro --cluster-arn.

Parâmetro:
  • --cluster-arn—Obrigatório. O identificador ARN do cluster elástico que deseja interromper ou iniciar.

exemplo — Para parar um cluster elástico usando o AWS CLI

No exemplo a seguir, substitua cada user input placeholder por suas próprias informações.

O código a seguir interrompe o cluster elástico com o ARN arn:aws:docdb-elastic:us-east-1:477568257630:cluster/b9f1d489-6c3e-4764-bb42-da62ceb7bda2.

nota

O cluster elástico deve estar no estado ativo ou disponível.

Para Linux, macOS ou Unix:

aws docdb-elastic stop-cluster \ --cluster-arn arn:aws:docdb-elastic:us-east-1:477568257630:cluster/b9f1d489-6c3e-4764-bb42-da62ceb7bda2

Para Windows:

aws docdb-elastic stop-cluster ^ --cluster-arn arn:aws:docdb-elastic:us-east-1:477568257630:cluster/b9f1d489-6c3e-4764-bb42-da62ceb7bda2
exemplo — Para iniciar um cluster elástico usando o AWS CLI

No exemplo a seguir, substitua cada user input placeholder por suas próprias informações.

O código a seguir inicia o cluster elástico com o ARN arn:aws:docdb-elastic:us-east-1:477568257630:cluster/b9f1d489-6c3e-4764-bb42-da62ceb7bda2.

nota

O cluster elástico deve estar interrompido no momento.

Para Linux, macOS ou Unix:

aws docdb-elastic start-cluster \ --cluster-arn arn:aws:docdb-elastic:us-east-1:477568257630:cluster/b9f1d489-6c3e-4764-bb42-da62ceb7bda2

Para Windows:

aws docdb-elastic start-cluster ^ --cluster-arn arn:aws:docdb-elastic:us-east-1:477568257630:cluster/b9f1d489-6c3e-4764-bb42-da62ceb7bda2

Operações que você pode realizar em um cluster elástico interrompido

Não é possível modificar a configuração de um cluster elástico do Amazon DocumentDB enquanto o cluster estiver interrompido. Você deverá iniciar o cluster antes de realizar uma dessas ações administrativas.

O Amazon DocumentDB aplicará as manutenções programadas em seu cluster elástico interrompido somente depois que for reiniciado. Após sete dias, o Amazon DocumentDB inicia automaticamente um cluster elástico interrompido, para que não fique muito atrasado em seu status de manutenção. Quando o cluster elástico for reiniciado, você começará a ser cobrado pelos fragmentos no cluster novamente.

Enquanto um cluster elástico estiver interrompido, o Amazon DocumentDB não executa quaisquer backups automatizados, nem estende o período de retenção de backup.