Criar um usuário da nuvem MongoDB
Obsoleto(a)
Cria uma conta de usuário do MongoDB Cloud. Uma conta de usuário do MongoDB Cloud concede acesso apenas ao aplicativo do MongoDB Cloud. Para conceder acesso ao banco de dados, crie um usuário de banco de dados. O MongoDB Cloud envia um e-mail para os usuários que você especificar, convidando-os para participar do projeto. Os usuários convidados não terão acesso ao projeto até que aceitem o convite. Os convites expiram após 30 dias.
O MongoDB Cloud limita a adesão de usuários do MongoDB Cloud a um máximo de 250 por equipe. O MongoDB Cloud limita a adesão de usuários do MongoDB Cloud a 500 por projeto e 500 por organização, o que inclui a adesão combinada de todos os projetos na organização. O MongoDB Cloud emitirá um erro se uma operação exceder esses limites. Por exemplo, se você tiver uma organização com cinco projetos e cada projeto tiver 100 usuários do MongoDB Cloud, e cada usuário pertencer a apenas um projeto, não será possível adicionar nenhum usuário a essa organização sem primeiro remover os usuários existentes da organização.
Para usar este recurso, a conta de serviço ou a chave de API solicitante pode ter qualquer função.
parâmetros de query
-
Sinalizador que indica se o aplicativo empacota a resposta em um objeto JSON
envelope
. Alguns clientes de API não podem acessar os cabeçalhos de resposta HTTP ou o código de status. Para corrigir isso, defina envelope=true na consulta. Os endpoints que retornam uma lista de resultados usam o objeto de resultados como um envelope. O aplicativo adiciona o parâmetro de status ao corpo da resposta.O valor padrão é
false
. -
Sinalizador que indica se o corpo da resposta deve estar no formato prettyprint.
O valor padrão é
false
.Prettyprint
corpo, corpo
Obrigatório
Conta de usuário do MongoDB Cloud a ser criada.
-
Dois caracteres alfabéticos que identificam a localização geográfica do usuário do MongoDB Cloud. Este parâmetro utiliza o formato de código ISO 3166-1a2.
O formato deve corresponder ao seguinte padrão:
^([A-Z]{2})$
. -
Nome que pertence ao usuário do MongoDB Cloud.
-
Sobrenome que pertence ao usuário MongoDB Cloud.
-
Número de celular que pertence ao usuário MongoDB Cloud.
O formato deve corresponder ao seguinte padrão:
(?:(?:\\+?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})$
. -
Senha aplicada com o nome de usuário para conectar ao MongoDB Cloud. O MongoDB Cloud não retorna esse parâmetro, exceto em resposta à criação de um novo usuário do MongoDB Cloud. Somente o usuário do MongoDB Cloud pode atualizar sua senha depois que ela tiver sido definida no console do MongoDB Cloud.
O comprimento mínimo é
8
. -
Lista de objetos que exibem as roles do usuário do MongoDB Cloud e a organização ou projeto correspondente ao qual essa role se aplica. Uma role pode se aplicar a uma organização ou a um projeto, mas não a ambos.
As roles do usuário da MongoDB Cloud e a organização ou projeto correspondente ao qual essa role se aplica. Cada função pode ser aplicada a uma organização ou a um projeto , mas não a ambos.
-
Endereço de e-mail que representa o nome de usuário do MongoDB Cloud.
atlas api mongoDbCloudUsers createUser --help
import (
"os"
"context"
"log"
sdk "go.mongodb.org/atlas-sdk/v20250312001/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-03-12+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-03-12+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": "ORG_MEMBER"
}
],
"username": "hello@example.com"
}
{
"country": "string",
"createdAt": "2025-05-04T09:42:00Z",
"emailAddress": "hello@example.com",
"firstName": "string",
"id": "32b6e34b3d91647abb20e7b8",
"lastAuth": "2025-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": "ORG_MEMBER"
}
],
"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"
}