Para agentes de IA: hay un índice de documentación disponible en https://www.mongodb.com/es/docs/llms.txt — versiones en markdown de todas las páginas están disponibles agregando .md a cualquier ruta URL.

Agregar usuarios existentes a un proyecto

Nota

Grupos y proyectos son términos sinónimos. Su {PROJECT-ID} es el mismo que su ID del grupo. Para los grupos existentes, su ID del grupo sigue siendo el mismo. Esta página utiliza el término más familiar grupo cuando se refiere a descripciones. El punto final permanece como se indica en el documento.

Este recurso agrega usuarios que existen en Cloud Manager a otro proyecto. No crea nuevos usuarios ni los agrega a un proyecto. Por defecto, los usuarios primero reciben una invitación para el Proyecto. Solo puede agregar usuarios directamente a un proyecto si configura el ajuste mms.user.bypassInviteForExistingUsers en true.

URL base: https://cloud.mongodb.com/api/public/v1.0

POST /groups/{PROJECT-ID}/users
Parameter
Tipo
Descripción

PROJECT-ID

string

(Obligatorio). El identificador único del proyecto.

Los siguientes parámetros de query son opcionales:

Nombre
Tipo
Necesidad
Descripción
predeterminado

bonito

booleano

Opcional

Indicador que muestra si se debe devolver el cuerpo de la respuesta en un prettyprint formato.

false

envelope

booleano

Opcional

Bandera que indica si se debe o no envolver la respuesta en un sobre.

Algunos clientes API no pueden acceder a los encabezados de respuesta HTTP ni al código de estado. Para solucionar esto, establezca envelope=true en la query.

Para los endpoints que devuelven un resultado, el cuerpo de la respuesta incluye:

  • status: Código de respuesta HTTP

  • content: Cuerpo de respuesta esperado

false

Nombre
Tipo
Descripción

ID

string

El identificador único de un usuario existente.

Roles

objeto arreglo

Los roles a los que se asigna este usuario.

roles.groupId

string

El identificador único para el rol de proyecto.

roles.roleName

string

El nombre para mostrar del rol de usuario.

Nombre
Tipo
Descripción

Dirección de correo electrónico

string

La dirección de correo electrónico del usuario de Cloud Manager.

Nombre

string

El primer nombre que se muestra para el usuario de Cloud Manager que se ha devuelto.

ID

string

El identificador único para el usuario.

enlaces

objeto arreglo

Uno o más enlaces a subrecursos y/o recursos relacionados. Todos los arreglos links en las respuestas contienen al menos un enlace llamado self. Las relaciones entre las URLse explican en la Especificación de Web Linking.

Apellidos

string

El último apellido mostrado para el usuario de Cloud Manager que fue devuelto.

Roles

objeto arreglo

Los roles a los que se asigna este usuario.

roles.groupId

string

El identificador único para el rol de proyecto.

roles.roleName

string

El nombre para mostrar del rol de usuario.

Nombre de usuario

string

El nombre de usuario de Cloud Manager.

curl --user "{PUBLIC-KEY}:{PRIVATE-KEY}" --digest \ --header "Accept: application/json" \ --header "Content-Type: application/json" \ --include \ --request POST "https://cloud.mongodb.com/api/public/v1.0/groups/{PROJECT-ID}/users?pretty=true" \ --data ' [ { "id": "{USER-ID}", "roles": [{ "roleName": "GROUP_OWNER" }] } ]'

Nota

Debes enviar un arreglo de entidades, incluso si agregas un solo usuario. Para cada usuario que desees agregar, especifica la ID de usuario y los roles que debe poseer el usuario. Para los valores de rol, consulte la descripción del campo roles.roleName en el recurso de usuarios.

Si especificas a un usuario que ya es miembro del proyecto, sus roles existentes se sobrescriben con los permisos especificados.

HTTP/1.1 401 UnauthorizedContent-Type: application/json;charset=ISO-8859-1Date: {dateInUnixFormat}WWW-Authenticate: Digest realm="MMS Public API", domain="", nonce="{nonce}", algorithm=MD5, op="auth", stale=falseContent-Length: {requestLengthInBytes}Connection: keep-alive
HTTP/1.1 200 OKVary: Accept-EncodingContent-Type: application/jsonStrict-Transport-Security: max-age=300Date: {dateInUnixFormat}Connection: keep-aliveContent-Length: {requestLengthInBytes}X-MongoDB-Service-Version: gitHash={gitHash}; versionString={ApplicationVersion}
{ "links" : [ { "href" : "https://cloud.mongodb.com/api/public/v1.0/groups/{PROJECT-ID}/users?pretty=true&pageNum=1&itemsPerPage=100", "rel" : "self" } ], "results" : [ { "emailAddress" : "joe.bloggs@example.com", "firstName" : "Joe", "id" : "{USER-ID}", "lastName" : "Bloggs", "links" : [ { "href" : "https://cloud.mongodb.com/api/public/v1.0/users/{USER-ID}", "rel" : "self" }, { "href" : "https://cloud.mongodb.com/api/public/v1.0/users/{USER-ID}/accessList", "rel" : "http://mms.mongodb.com/accessList" } ], "roles" : [ { "groupId" : "{PROJECT-ID}", "roleName" : "GROUP_OWNER" }, { "groupId" : "{OTHER-PROJECT-ID}", "roleName" : "GROUP_OWNER" } ... ], "username" : "joe.bloggs" }, { "emailAddress" : "jim.bloggs@example.com", "firstName" : "Jim", "id" : "{OTHER-USER-ID}", "lastName" : "Bloggs", "links" : [ { "href" : "https://cloud.mongodb.com/api/public/v1.0/users/{OTHER-USER-ID}", "rel" : "self" }, { "href" : "https://cloud.mongodb.com/api/public/v1.0/users/{OTHER-USER-ID}/accessList", "rel" : "http://mms.mongodb.com/accessList" } ], "roles" : [ { "roleName" : "GLOBAL_READ_ONLY" }, { "groupId" : "{PROJECT-ID}", "roleName" : "GROUP_OWNER" } ], "username" : "jim.bloggs" } ], "totalCount" : 2}