Actualiza la configuración avanzada de un clúster del proyecto especificado. Los clústeres contienen un grupo de hosts que mantienen el mismo conjunto de datos. La configuración avanzada incluye la configuración de lectura/escritura, los límites de índice y registro de operaciones, y otras configuraciones de la base de datos. Para usar este recurso, la cuenta de servicio o la clave API solicitantes deben tener el rol de administrador de clústeres de proyectos. Esta función no está disponible para clústeres gratuitos M0, clústeres de nivel compartido M2 y M5, clústeres flexibles ni clústeres sin servidor. Versiones obsoletas: v2-{2023-01-01}
Parámetros de ruta
-
Cadena 24hexadecimal única que identifica su proyecto. Utilice el punto de conexión /groups para recuperar todos los proyectos a los que el usuario autenticado tiene acceso.
NOTA: Grupos y proyectos son términos sinónimos. El ID de tu grupo es el mismo que el de tu proyecto. Para los grupos existentes, el ID de tu grupo/proyecto permanece igual. El recurso y los puntos finales correspondientes usan el término "grupos".
El formato debe coincidir con el siguiente patrón:
^([a-f0-9]{24})$. -
Etiqueta legible por humanos que identifica el clúster.
El formato debe coincidir con el siguiente patrón:
^[a-zA-Z0-9][a-zA-Z0-9-]*$.
Parámetros de consulta
-
Indicador que indica si la aplicación encapsula la respuesta en un objeto JSON
envelope. Algunos clientes de la API no pueden acceder a los encabezados de respuesta HTTP ni al código de estado. Para solucionar esto, configure envelope=true en la consulta. Los endpoints que devuelven una lista de resultados utilizan el objeto de resultados como encapsulado. La aplicación añade el parámetro de estado al cuerpo de la respuesta.El valor predeterminado es
false. -
Bandera que indica si el cuerpo de la respuesta debe estar en formato prettyprint.
El valor predeterminado es
false.Impresión bonita
Cuerpo
Requerido
Detalles de configuración avanzada para agregar a un clúster en el proyecto especificado.
-
El tiempo mínimo de retención de imágenes previas y posteriores en segundos.
El valor predeterminado es
-1.Esta opción corresponde a... -
Número de subprocesos en el fragmento de origen y el fragmento receptor para la migración de fragmentos. El número de subprocesos no debe superar la mitad del número total de núcleos de CPU en el clúster fragmentado.
Esta opción corresponde a... -
Lista de conjuntos de cifrado OpenSSL personalizados para TLS 1.2. Este campo solo es válido cuando
tlsCipherConfigModese establece enCUSTOM.Los valores son
TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384oTLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256. -
Lista de conjuntos de cifrado OpenSSL personalizados para TLS 1.3. Este campo solo es válido cuando
tlsCipherConfigModese establece enCUSTOM.No más de
4elementos. Los valores sonTLS_AES_256_GCM_SHA384,TLS_CHACHA20_POLY1305_SHA256,TLS_AES_128_GCM_SHA256oTLS_AES_128_CCM_SHA256. -
Límite de tiempo predeterminado en milisegundos para que se completen las operaciones de lectura individuales.
Esta opción corresponde a... -
Nivel predeterminado de reconocimiento solicitado a MongoDB para operaciones de escritura cuando el controlador no especifica ninguna.
Esta opción corresponde a... -
Marca que indica si el clúster permite la ejecución de operaciones que ejecutan JavaScript en el servidor. Al usar 8.0+, recomendamos deshabilitar JavaScript en el servidor y usar operadores de canalización de agregación como una alternativa más eficiente.
Esta opción corresponde a mod... -
Versión mínima de Seguridad de la Capa de Transporte (TLS) que el clúster acepta para las conexiones entrantes. Los clústeres que usan TLS 1.0 o 1.1 deberían considerar configurar TLS 1.2 como la versión mínima del protocolo TLS.
Los valores son
TLS1_0,TLS1_1,TLS1_2oTLS1_3.Esta opción corresponde a... -
Bandera que indica si el clúster deshabilita la ejecución de cualquier consulta que requiera un escaneo de colección para devolver resultados.
Esta opción corresponde a... -
Ventana mínima de retención del registro de operaciones del clúster, expresada en horas. Un valor nulo indica que el clúster utiliza la ventana mínima de retención predeterminada que calcula MongoDB Cloud.
Esta opción corresponde a... -
Límite de almacenamiento del registro de operaciones del clúster, expresado en megabytes. Un valor nulo indica que el clúster utiliza el tamaño predeterminado del registro de operaciones calculado por MongoDB Cloud.
Esta opción corresponde a... -
Puede configurarse en 1 (deshabilitado) o 3 (habilitado). Si se configura en 3, Atlas incluirá la salida
$queryStatsredactada y anonimizada en los registros de MongoDB. La salida$queryStatsno contiene literales ni valores de campo. Habilitar esta configuración podría afectar el rendimiento del clúster.Esta opción corresponde a... -
Intervalo en segundos en el que el proceso mongosqld vuelve a muestrear los datos para crear su esquema relacional.
El valor mínimo es
0. El valor por defecto es0.Esta opción corresponde a... -
Número de documentos por base de datos a muestrear al recopilar información del esquema.
El valor mínimo es
0.Esta opción corresponde a... -
Modo de configuración del conjunto de cifrado TLS. El modo predeterminado utiliza los conjuntos de cifrado predeterminados. El modo personalizado permite especificar conjuntos de cifrado personalizados para TLS 1.2 y TLS 1.3.
Los valores son
CUSTOMoDEFAULT. -
Duración, en segundos, de las transacciones multidocumento. Atlas considera vencidas las transacciones que superan este límite y las cancela mediante un proceso de limpieza periódico.
El valor mínimo es
1.Esta opción corresponde a...
atlas api clusters updateProcessArgs --helpimport (
"os"
"context"
"log"
sdk "go.mongodb.org/atlas-sdk/v20250219001/admin"
)
func main() {
ctx := context.Background()
clientID := os.Getenv("MONGODB_ATLAS_CLIENT_ID")
clientSecret := os.Getenv("MONGODB_ATLAS_CLIENT_SECRET")
// See https://dochub.mongodb.org/core/atlas-go-sdk-oauth
client, err := sdk.NewClient(sdk.UseOAuthAuth(clientID, clientSecret))
if err != nil {
log.Fatalf("Error: %v", err)
}
params = &sdk.UpdateGroupClusterProcessArgsApiParams{}
sdkResp, httpResp, err := client.ClustersApi.
UpdateGroupClusterProcessArgsWithParams(ctx, params).
Execute()
}
curl --include --header "Authorization: Bearer ${ACCESS_TOKEN}" \
--header "Accept: application/vnd.atlas.2025-02-19+json" \
--header "Content-Type: application/json" \
-X PATCH "https://cloud.mongodb.com/api/atlas/v2/groups/{groupId}/clusters/{clusterName}/processArgs" \
-d '{ <Payload> }'curl --user "${PUBLIC_KEY}:${PRIVATE_KEY}" \
--digest --include \
--header "Accept: application/vnd.atlas.2025-02-19+json" \
--header "Content-Type: application/json" \
-X PATCH "https://cloud.mongodb.com/api/atlas/v2/groups/{groupId}/clusters/{clusterName}/processArgs" \
-d '{ <Payload> }'{
"changeStreamOptionsPreAndPostImagesExpireAfterSeconds": -1,
"chunkMigrationConcurrency": 42,
"customOpensslCipherConfigTls12": [
"TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384"
],
"customOpensslCipherConfigTls13": [
"TLS_AES_256_GCM_SHA384"
],
"defaultMaxTimeMS": 42,
"defaultWriteConcern": "string",
"javascriptEnabled": true,
"minimumEnabledTlsProtocol": "TLS1_0",
"noTableScan": true,
"oplogMinRetentionHours": 42.0,
"oplogSizeMB": 42,
"queryStatsLogVerbosity": 42,
"sampleRefreshIntervalBIConnector": 0,
"sampleSizeBIConnector": 42,
"tlsCipherConfigMode": "CUSTOM",
"transactionLifetimeLimitSeconds": 42
}{
"changeStreamOptionsPreAndPostImagesExpireAfterSeconds": -1,
"chunkMigrationConcurrency": 42,
"customOpensslCipherConfigTls12": [
"TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384"
],
"customOpensslCipherConfigTls13": [
"TLS_AES_256_GCM_SHA384"
],
"defaultMaxTimeMS": 42,
"defaultWriteConcern": "string",
"javascriptEnabled": true,
"minimumEnabledTlsProtocol": "TLS1_0",
"noTableScan": true,
"oplogMinRetentionHours": 42.0,
"oplogSizeMB": 42,
"queryStatsLogVerbosity": 42,
"sampleRefreshIntervalBIConnector": 0,
"sampleSizeBIConnector": 42,
"tlsCipherConfigMode": "CUSTOM",
"transactionLifetimeLimitSeconds": 42
}{
"error": 400,
"detail": "(This is just an example, the exception may not be related to this endpoint) No provider AWS exists.",
"reason": "Bad Request",
"errorCode": "VALIDATION_ERROR"
}{
"error": 401,
"detail": "(This is just an example, the exception may not be related to this endpoint)",
"reason": "Unauthorized",
"errorCode": "NOT_ORG_GROUP_CREATOR"
}{
"error": 403,
"detail": "(This is just an example, the exception may not be related to this endpoint)",
"reason": "Forbidden",
"errorCode": "CANNOT_CHANGE_GROUP_NAME"
}{
"error": 404,
"detail": "(This is just an example, the exception may not be related to this endpoint) Cannot find resource AWS",
"reason": "Not Found",
"errorCode": "RESOURCE_NOT_FOUND"
}{
"error": 500,
"detail": "(This is just an example, the exception may not be related to this endpoint)",
"reason": "Internal Server Error",
"errorCode": "UNEXPECTED_ERROR"
}