Você pode escalar a camada do cluster de um cluster gratuito ou de um cluster flexível para um cluster dedicado.
Acesso necessário
Para escalar a camada do cluster, você deve ter pelo menos a função Project Cluster Manager no projeto.
Edições de banco de dados
Você selecionou Atlas Core ou Atlas Infinite quando criou o cluster gratuito ou o cluster flexível. O Atlas armazenou essa seleção e não a aplicou ao cluster Free ou ao próprio cluster Flex, portanto, não alterou o modo como esse cluster funciona.
Para saber mais sobre cada edição, consulte MongoDB Atlas Infinite: Overview e MongoDB Atlas Core: Overview.
Quando você escala a camada do cluster para um cluster dedicado, o Atlas usa a edição que você já especificou e que o Atlas armazenou. Se quiser, você pode selecionar a outra edição nesse ponto.
Por padrão, o Atlas Atlas a camada do cluster para um cluster dedicado no Atlas Core, a menos que você tenha selecionado Atlas Infinite ao criar o cluster Free ou o cluster Flex.
Considerações
O dimensionamento de um cluster gratuito ou de um cluster flexível para um cluster dedicado requer tempo de inatividade. Para evitar a corrupção de dados, interrompa as operações de gravação durante a operação de escala.
Você não pode escalar um cluster dedicado de volta para um cluster gratuito ou um cluster flexível.
Você não pode alterar a edição do banco de dados de um cluster depois de criá-lo, em qualquer direção entre o Atlas Core e o Atlas Infinite.
Procedimento
Para escalar um cluster gratuito ou um cluster flexível para um cluster dedicado, envie uma solicitação para o endpoint de atualização do locatário do tipo de cluster de origem . O campo databaseEdition no corpo da solicitação define a edição do banco de dados do cluster dedicado resultante. Se você omitir databaseEdition, o Atlas dimensionará o cluster para um cluster dedicado no Atlas Core.
Defina o cabeçalho Accept como a versão de recurso do endpoint que você chama: application/vnd.atlas.2023-01-01+json para o endpoint do cluster Free e application/vnd.atlas.2024-11-13+json para o endpoint do cluster Flex.
Para escalar para um cluster dedicado no Atlas Infinite, defina
databaseEditionparaINFINITEno corpo da solicitação:Para um cluster gratuito, envie uma solicitação de
POSTpara /groups/{groupId}/clusters/tenantUpgrade.Para um cluster Flex, envie uma solicitação de
POSTpara /groups/{groupId}/flexClusters:tenantUpgrade.
Para escalar para um cluster dedicado no Atlas Core, omita
databaseEditionou defina-o comoCORE:Para um cluster gratuito, envie uma solicitação de
POSTpara /groups/{groupId}/clusters/tenantUpgrade.Para um cluster Flex, envie uma solicitação de
POSTpara /groups/{groupId}/flexClusters:tenantUpgrade.
Para atualizar a camada do cluster, o tamanho do disco e/ou a versão do MongoDB para um cluster do Atlas M0 ou Flex utilizando o Atlas CLI, execute o seguinte comando:
atlas clusters upgrade [clusterName] [options]
Para saber mais sobre a sintaxe e os parâmetros do comando, consulte a documentação do Atlas CLI para atualização dos clusters do Atlas.
Durante a visualização pública, o atlas clusters upgrade não suporta a escalabilidade para um cluster Atlas Infinite. Esse comando não tem opção de edição de banco de dados , portanto, ele sempre dimensiona um cluster livre ou um cluster flexível para um cluster dedicado no Atlas Core. Se você definir databaseEdition em um arquivo de configuração, o comando descartará o campo e retornará um aviso em vez de um erro.
Em vez disso, use um comando atlas api. Esses comandos enviam o corpo da solicitação para a API de administração do Atlas inalterada, para que o Atlas aplique databaseEdition.
Crie um arquivo payload.json que defina databaseEdition como INFINITE. Substitua os outros valores pela configuração do cluster:
{ "name": "{CLUSTER-NAME}", "databaseEdition": "INFINITE", "providerSettings": { "providerName": "AWS", "instanceSizeName": "M10", "regionName": "US_EAST_1" } }
Para escalar um cluster gratuito, execute o seguinte comando:
atlas api clusters upgradeTenantUpgrade \ --version 2023-01-01 \ --groupId {GROUP-ID} \ --file payload.json
Para escalar um cluster Flex, execute o seguinte comando:
atlas api flexClusters tenantUpgrade \ --version 2024-11-13 \ --groupId {GROUP-ID} \ --file payload.json
Se você omitir databaseEdition, o Atlas usará a edição que você escolheu quando criou o cluster Free ou o cluster Flex.
No Atlas, vá para a página Clusters do seu projeto.
Se ainda não tiver sido exibido, selecione a organização que contém seu projeto no menu Organizations na barra de navegação.
Se ainda não estiver exibido, selecione o projeto desejado no menu Projects na barra de navegação.
Na barra lateral, clique em Clusters sob o título Database.
A página Clusters é exibida.