Você pode dimensionar a camada do cluster de um cluster Free ou de um cluster Flex para um cluster dedicado.
Acesso necessário
Para dimensionar a camada do cluster, você deve ter pelo menos a função Project Cluster Manager para o projeto.
Edições de banco de dados
Você selecionou o Atlas Core ou o Atlas Infinite ao criar o cluster Free ou o cluster Flex. O Atlas armazenou essa seleção e não a aplicou ao cluster Free ou ao cluster Flex em si, portanto, isso não alterou o funcionamento desse cluster.
Para aprender mais sobre cada edição, consulte MongoDB Atlas Infinite: Visão geral e MongoDB Atlas Core: Visão geral.
Ao dimensionar a camada do cluster para um cluster dedicado, o Atlas usa a edição que você já especificou e que o Atlas armazenou. Se desejar, você pode selecionar a outra edição nesse ponto.
A seleção do Atlas Infinite é opcional. Por padrão, o Atlas dimensiona a camada do cluster para um cluster dedicado no Atlas Core, a menos que você tenha selecionado o Atlas Infinite ao criar o cluster Free ou o cluster Flex.
Considerações
O dimensionamento de um cluster Free ou de um cluster Flex para um cluster dedicado requer tempo de inatividade. Para evitar a corrupção de dados, interrompa as operações de gravar durante a operação de dimensionar.
Não é possível dimensionar um cluster dedicado de volta para um cluster gratuito ou um cluster flexível.
Não é possível alterar a edição do banco de dados de um cluster após a criação, em qualquer direção entre o Atlas Core e o Atlas Infinite.
Procedimento
Para dimensionar um cluster Free ou um cluster Flex para um cluster dedicado, envie uma solicitação ao ponto de extremidade de atualização de locatário para o seu 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 dimensiona o cluster para um cluster dedicado no Atlas Core.
Defina o cabeçalho Accept para a versão do recurso do ponto de extremidade que você chamar: application/vnd.atlas.2023-01-01+json para o ponto de extremidade do cluster Free e application/vnd.atlas.2024-11-13+json para o ponto de extremidade do cluster Flex.
Para dimensionar para um cluster dedicado no Atlas Infinite, defina
databaseEditioncomoINFINITEno corpo da solicitação:For a Free cluster, send a
POSTrequest to /groups/{groupId}/clusters/tenantUpgrade.For a Flex cluster, send a
POSTrequest to /groups/{groupId}/flexClusters:tenantUpgrade.
Para dimensionar para um cluster dedicado no Atlas Core, omita
databaseEditionou defina-o comoCORE:For a Free cluster, send a
POSTrequest to /groups/{groupId}/clusters/tenantUpgrade.For a Flex cluster, send a
POSTrequest to /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]
To learn more about the command syntax and parameters, see the Atlas CLI documentation for atlas clusters upgrade.
Durante a pré-visualização pública, atlas clusters upgrade não oferece suporte ao dimensionamento 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 gratuito ou um cluster Flex 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.
Use um comando atlas api em vez disso. Esses comandos enviam o corpo da sua solicitação para a Atlas Administration API sem alterações, portanto, o Atlas aplica databaseEdition.
Crie um arquivo payload.json que defina databaseEdition como INFINITE. Substitua os outros valores pela configuração do seu cluster:
{ "name": "{CLUSTER-NAME}", "databaseEdition": "INFINITE", "providerSettings": { "providerName": "AWS", "instanceSizeName": "M10", "regionName": "US_EAST_1" } }
Para dimensionar um cluster Free, execute o seguinte comando:
atlas api clusters upgradeTenantUpgrade \ --version 2023-01-01 \ --groupId {GROUP-ID} \ --file payload.json
Para dimensionar 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 ao criar 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.