Actualiza la configuración de la organización. Para usar este recurso, la cuenta de servicio o la clave API solicitante debe tener el rol de propietario de la organización.
Parámetros de ruta
-
Cadena 24hexadecimal única que identifica la organización que contiene sus proyectos. Utilice el
/orgspunto de conexión para recuperar todas las organizaciones a las que el usuario autenticado tiene acceso.El formato debe coincidir con el siguiente patrón:
^([a-f0-9]{24})$.
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 para actualizar la configuración de la organización especificada.
-
Bandera que indica si se debe requerir que las operaciones de API se originen desde una dirección IP agregada a la lista de acceso de API para la organización especificada.
-
Define la configuración del tiempo de espera de sesión para administrar las sesiones de usuario a nivel de organización. Si se establece como nulo, el valor del campo no se establece y se aplica la configuración de tiempo de espera predeterminada.
-
Indicador que indica si esta organización tiene acceso a funciones de IA generativa. Esta configuración solo se aplica a Atlas Commercial y está habilitada de forma predeterminada. Una vez activada, los propietarios de proyectos podrán habilitar o deshabilitar funciones de IA individuales a nivel de proyecto.
El valor predeterminado es
true.Preguntas frecuentes sobre IA generativa -
Número que representa el período máximo antes del vencimiento en horas para los nuevos secretos de la cuenta de servicio de API de administración de Atlas dentro de la organización especificada.
El valor mínimo es
8, el valor máximo es8760. -
Marca que indica si se requiere que los usuarios configuren laautenticación multifactor (MFA) antes de acceder a la organización especificada. Para obtener más información, consulte: https://www.mongodb.com/es/docs/atlas/security-multi-factor-authentication/.
-
Marca que indica si se debe impedir que el soporte técnico de MongoDB acceda a la infraestructura de Atlas y a los registros del clúster de cualquier implementación de la organización especificada sin permiso explícito. Una vez activada esta opción, puede otorgar 24al soporte técnico de MongoDB un acceso de omisión de horas a la implementación de Atlas para resolver problemas de soporte. Para obtener más información, consulte: https://www.mongodb.com/es/docs/atlas/security-restrict-support-access/.
-
Cadena que especifica una única dirección de correo electrónico para que la organización especificada reciba notificaciones relacionadas con la seguridad. Especificar un contacto de seguridad no le otorga autorización ni acceso a Atlas para tomar decisiones o aprobaciones de seguridad. Una cadena vacía es válida y borra el contacto de seguridad existente (si lo hay).
-
Bandera que indica si los espacios de trabajo de Atlas Stream Processing de un grupo en esta organización pueden crear conexiones con los clústeres de otros grupos en la misma organización.
atlas api organizations updateOrgSettings --help
import (
"os"
"context"
"log"
sdk "go.mongodb.org/atlas-sdk/v20230201001/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.UpdateOrgSettingsApiParams{}
sdkResp, httpResp, err := client.OrganizationsApi.
UpdateOrgSettingsWithParams(ctx, params).
Execute()
}
curl --include --header "Authorization: Bearer ${ACCESS_TOKEN}" \
--header "Accept: application/vnd.atlas.2023-02-01+json" \
--header "Content-Type: application/json" \
-X PATCH "https://cloud.mongodb.com/api/atlas/v2/orgs/{orgId}/settings" \
-d '{ <Payload> }'
curl --user "${PUBLIC_KEY}:${PRIVATE_KEY}" \
--digest --include \
--header "Accept: application/vnd.atlas.2023-02-01+json" \
--header "Content-Type: application/json" \
-X PATCH "https://cloud.mongodb.com/api/atlas/v2/orgs/{orgId}/settings" \
-d '{ <Payload> }'
{
"apiAccessListRequired": true,
"customSessionTimeouts": {
"absoluteSessionTimeoutInSeconds": 42,
"idleSessionTimeoutInSeconds": 42
},
"genAIFeaturesEnabled": true,
"maxServiceAccountSecretValidityInHours": 42,
"multiFactorAuthRequired": true,
"restrictEmployeeAccess": true,
"securityContact": "string",
"streamsCrossGroupEnabled": true
}
{
"apiAccessListRequired": true,
"customSessionTimeouts": {
"absoluteSessionTimeoutInSeconds": 42,
"idleSessionTimeoutInSeconds": 42
},
"genAIFeaturesEnabled": true,
"maxServiceAccountSecretValidityInHours": 42,
"multiFactorAuthRequired": true,
"restrictEmployeeAccess": true,
"securityContact": "string",
"streamsCrossGroupEnabled": true
}
{
"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": 429,
"detail": "(This is just an example, the exception may not be related to this endpoint)",
"reason": "Too Many Requests",
"errorCode": "RATE_LIMITED"
}
{
"error": 500,
"detail": "(This is just an example, the exception may not be related to this endpoint)",
"reason": "Internal Server Error",
"errorCode": "UNEXPECTED_ERROR"
}