Modificar la configuración del clúster especificado.
Puede especificar modificaciones en un archivo de configuración JSON con el indicador --file.
No puedes cambiar el nombre del clúster ni degradar la versión de MongoDB de tu clúster.
Solo se puede actualizar un conjunto de réplicas en un clúster de un solo fragmento; no se puede actualizar un conjunto de réplicas en un clúster de varios fragmentos. Para obtener más información, consulte https://www.mongodb.com/es/docs/atlas/scale-cluster/#convert-a-replica-set-to-a-sharded-cluster y https://www.mongodb.com/es/docs/upcoming/tutorial/convert-replica-set-to-replicated-shard-cluster.
Nota sobre la obsolescencia: Los2 niveles M y M5 ya no se utilizan; al seleccionar M2 o M,5 se creará un nivel FLEX. Para consultar la guía de migración, visite: https://dochub.mongodb.org/core/flex-migration.n
Para usar este comando, debes autenticarte con una cuenta de usuario, una cuenta de servicio o una clave de API con el rol de administrador de clúster del Proyecto. Atlas es compatible con este comando solo para clústeres M10+
Sintaxis
atlas clusters update [clusterName] [options]
Arguments
Nombre | Tipo | Requerido | Descripción |
|---|---|---|---|
nombre del clúster | string | false | Nombre del clúster a actualizar. |
opciones
Nombre | Tipo | Requerido | Descripción |
|---|---|---|---|
--autoScalingMode | string | false | Modo de escalado del clúster. Los valores válidos son clusterWideScaling o independentShardScaling. Mutuamente excluyente con --file. |
--disableTerminationProtection | false | Desactiva la protección contra la terminación del clúster. Puedes eliminar un clúster con la protección contra la terminación desactivada. Mutuamente excluyente con --enableTerminationProtection, --file. | |
--diskSizeGB | float | false | Capacidad, en gigabytes, del volumen raíz del host. Mutuamente excluyente con --file. |
--enableTerminationProtection | false | Habilita la protección contra la terminación del clúster. No se puede eliminar un clúster con esta protección habilitada. Mutuamente excluyente con --disableTerminationProtection, --file. | |
-f, --file | string | false | Ruta a un archivo de configuración JSON opcional que define la configuración del clúster. Nota: Los campos no compatibles del archivo JSON se ignoran. Para obtener más información sobre los archivos de configuración del clúster para la CLI de Atlas, consulte https://dochub.mongodb.org/core/cluster-config-file-atlascli. Mutuamente excluyente con --tier, --diskSizeGB, --enableTerminationProtection, --disableTerminationProtection, --tag, --autoScalingMode. |
-h, --ayuda | false | ayuda para actualizar | |
--mdbVersion | string | false | Versión principal de MongoDB del clúster. |
-o, --output | string | false | Formato de salida. Los valores válidos son json, json-path, go-template o go-template-file. Para ver la salida completa, use la opción -o json. |
--projectId | string | false | Cadena hexadecimal que identifica el proyecto que se utilizará. Esta opción anula la configuración del archivo de configuración o la variable de entorno. |
--tag | clave=valor | false | Lista que contiene pares clave-valor de entre 1 y 255 caracteres para etiquetar y categorizar el clúster. Al pasar esta bandera, se reemplazan los datos preexistentes. Mutuamente excluyente con --file. |
--tier | string | false | Nivel para cada servidor que almacena datos en el clúster. Para obtener más información sobre los niveles de clúster, consulta https://dochub.mongodb.org/core/cluster-tier-atlas. Mutuamente excluyente con --file. |
Opciones heredadas
Nombre | Tipo | Requerido | Descripción |
|---|---|---|---|
-P, --profile | string | false | Nombre del perfil que se usará en el archivo de configuración. Para obtener más información sobre los perfiles de la CLI de Atlas, consulte https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. |
Salida
Si el comando se ejecuta correctamente, la CLI devuelve un resultado similar al siguiente ejemplo. Los valores entre paréntesis representan sus valores.
Updating cluster '<Name>'.
Ejemplos
# Update the tier for a cluster named myCluster for the project with ID 5e2211c17a3e5a48f5497de3: atlas cluster update myCluster --projectId 5e2211c17a3e5a48f5497de3 --tier M50
# Replace tags cluster named myCluster for the project with ID 5e2211c17a3e5a48f5497de3: atlas cluster update myCluster --projectId 5e2211c17a3e5a48f5497de3 --tag key1=value1
# Remove all tags from cluster named myCluster for the project with ID 5e2211c17a3e5a48f5497de3: atlas cluster update myCluster --projectId 5e2211c17a3e5a48f5497de3 --tag =
# Update the disk size for a cluster named myCluster for the project with ID 5e2211c17a3e5a48f5497de3: atlas cluster update myCluster --projectId 5e2211c17a3e5a48f5497de3 --diskSizeGB 20
# Update the MongoDB version for a cluster named myCluster for the project with ID 5e2211c17a3e5a48f5497de3: atlas cluster update myCluster --projectId 5e2211c17a3e5a48f5497de3 --mdbVersion 5.0
# Use a configuration file named cluster-config.json to update a cluster named myCluster for the project with ID 5e2211c17a3e5a48f5497de3: atlas cluster update myCluster --projectId 5e2211c17a3e5a48f5497de3 --file cluster-config.json --output json