Crea una cuenta de usuario de MongoDB Cloud. Una cuenta de usuario de MongoDB Cloud otorga acceso únicamente a la aplicación MongoDB Cloud. Para otorgar acceso a la base de datos, cree un usuario de base de datos. MongoDB Cloud envía un correo electrónico a los usuarios que especifique, invitándolos a unirse al proyecto. Los usuarios invitados no tienen acceso al proyecto hasta que aceptan la invitación. Las invitaciones caducan después de 30 días.
MongoDB Cloud limita la membresía de usuario de MongoDB nube a un máximo de 250 usuarios de MongoDB nube por equipo. MongoDB nube limita la membresía de usuario de MongoDB nube a 500 usuarios de MongoDB nube por Proyecto y 500 usuarios de MongoDB nube por organización, lo que incluye la membresía combinada de todos los Proyectos en la organización. MongoDB nube genera un error si una operación supera estos límites. Por ejemplo, si tienes una organización con cinco Proyectos, y cada Proyecto tiene 100 usuarios de MongoDB nube, y cada usuario de MongoDB nube pertenece solo a un Proyecto, no puedes agregar ningún usuario de MongoDB nube a esta organización sin antes remover los usuarios existentes de MongoDB nube de la organización.
Para utilizar este recurso, la cuenta de servicio o la clave API solicitante puede tener cualquier rol.
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
Cuenta de usuario de MongoDB Cloud para crear.
-
Dos caracteres alfabéticos que identifican la ubicación geográfica del usuario de MongoDB Cloud. Este parámetro utiliza el formato de código ISO 3166-1a2.
El formato debe coincidir con el siguiente patrón:
^([A-Z]{2})$. -
Nombre o nombre de pila que pertenece al usuario de MongoDB Cloud.
-
Apellido, nombre de familia o apellido que pertenece al usuario de MongoDB Cloud.
-
Número de teléfono móvil que pertenece al usuario de MongoDB Cloud.
El formato debe coincidir con el siguiente patrón:
(?:(?:\\+?1\\s*(?:[.-]\\s*)?)?(?:(\\s*([2-9]1[02-9]|[2-9][02-8]1|[2-9][02-8][02-9])\\s*)|([2-9]1[02-9]|[2-9][02-8]1|[2-9][02-8][02-9]))\\s*(?:[.-]\\s*)?)([2-9]1[02-9]|[2-9][02-9]1|[2-9][02-9]{2})\\s*(?:[.-]\\s*)?([0-9]{4})$. -
Contraseña aplicada con el nombre de usuario para iniciar sesión en MongoDB Cloud. MongoDB Cloud no devuelve este parámetro, excepto al crear un nuevo usuario. Solo el usuario de MongoDB Cloud puede actualizar su contraseña después de configurarla desde la consola.
La longitud mínima es
8. -
Lista de objetos que muestran los roles del usuario de MongoDB Cloud y la organización o el proyecto correspondientes a los que corresponde dicho rol. Un rol puede aplicarse a una organización o a un proyecto, pero no a ambos.
Roles de usuario de MongoDB Cloud y la organización o proyecto correspondiente al que corresponde cada rol. Cada rol puede aplicarse a una organización o a un proyecto, pero no a ambos.
-
Dirección de correo electrónico que representa el nombre de usuario del usuario de MongoDB Cloud.
atlas api mongoDbCloudUsers createUser --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.CreateUserApiParams{}
sdkResp, httpResp, err := client.MongoDBCloudUsersApi.
CreateUserWithParams(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 POST "https://cloud.mongodb.com/api/atlas/v2/users" \
-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 POST "https://cloud.mongodb.com/api/atlas/v2/users" \
-d '{ <Payload> }'{
"country": "string",
"firstName": "string",
"lastName": "string",
"mobileNumber": "string",
"password": "string",
"roles": [
{
"groupId": "32b6e34b3d91647abb20e7b8",
"orgId": "32b6e34b3d91647abb20e7b8",
"roleName": "string"
}
],
"username": "hello@example.com"
}{
"country": "string",
"createdAt": "2026-05-04T09:42:00Z",
"emailAddress": "hello@example.com",
"firstName": "string",
"id": "32b6e34b3d91647abb20e7b8",
"lastAuth": "2026-05-04T09:42:00Z",
"lastName": "string",
"links": [
{
"href": "https://cloud.mongodb.com/api/atlas",
"rel": "self"
}
],
"mobileNumber": "string",
"password": "string",
"roles": [
{
"groupId": "32b6e34b3d91647abb20e7b8",
"orgId": "32b6e34b3d91647abb20e7b8",
"roleName": "string"
}
],
"teamIds": [
"32b6e34b3d91647abb20e7b8"
],
"username": "hello@example.com"
}{
"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"
}