atualização do cluster do Atlas
Atualize a camada, o tamanho do disco e/ou a versão do MongoDB de um cluster compartilhado.
Este comando não está disponível para clusters dedicados.
Para utilizar este comando, você deve autenticar com uma conta de usuário ou uma chave de API com o role de Gerenciador de cluster do projeto.
Sintaxe
atlas clusters upgrade [clusterName] [options]
argumentos
Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
clusterName | string | false | Nome do cluster para atualizar. |
Opções
Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
--disableTerminationProtection | false | Desabilita a proteção contra encerramento para o cluster. Você pode excluir um cluster com a proteção de encerramento desabilitada. Mutuamente exclusivo com --enableTerminationProtection, --file. | |
--diskSizeGB | float | false | Capacidade, em gigabytes, do volume raiz do host. Mutuamente exclusivo com --file. |
--enableTerminationProtection | false | Habilita a proteção contra encerramento para seu cluster. Não é possível excluir um cluster com a proteção de encerramento habilitada. Mutuamente exclusivo com --disableTerminationProtection, --file. | |
-f, --file | string | false | Caminho para um arquivo de configuração JSON opcional que define as configurações do agrupamento. Para saber mais sobre arquivos de configuração de cluster para Atlas CLI, consulte https://dochub.mongodb.org/core/cluster-config-file-atlascli. Mutuamente exclusivo com --tier, --diskSizeGB, --mdbVersion, --enableTerminationProtection, --disableTerminationProtection, --tag. |
-h, --help | false | ajuda para atualização | |
--mdbVersion | string | false | Versão MongoDB principal do cluster. Mutuamente exclusivo com --file. |
-o, --output | string | false | Formato de saída. Os valores válidos são JSON, json-path, go-template ou go-template-file. Para ver o resultado completo, use a opção -o JSON. |
--projectId | string | false | String hexadecimal que identifica o projeto a ser usado. Esta opção substitui as configurações no arquivo de configuração ou variável de ambiente. |
--tag | chave=valor | false | Lista que contém pares de valor-chave entre 1 e 255 caracteres de comprimento para marcar e categorizar o cluster. A transferência desse sinalizador substitui os dados preexistentes. Mutuamente exclusivo com --file. |
--tier | string | false | Camada para cada servidor que contém dados no cluster. Para saber mais sobre camadas de cluster, consulte https://dochub.mongodb.org/core/cluster-tier-atlas. Mutuamente exclusivo com --file. |
Opções herdadas
Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
-P, --profile | string | false | Nome do perfil a ser usado no arquivo de configuração. Para saber mais sobre perfis para o Atlas CLI, consulte https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. |
Saída
Se o comando for bem-sucedido, a CLI retornará uma saída semelhante à amostra a seguir. Os valores entre colchetes representam seus valores.
Upgrading cluster '<Name>'.
Exemplos
# Upgrade the tier, disk size, and MongoDB version for the shared cluster named myCluster in the project with the ID 5e2211c17a3e5a48f5497de3: atlas cluster upgrade myCluster --projectId 5e2211c17a3e5a48f5497de3 --tier M50 --diskSizeGB 20 --mdbVersion 7.0 --tag env=dev