/ /

Organizaciones

Docs Home

/ /

Organizaciones y equipos

Organizaciones y equipos

Organizaciones

Invitar a un usuario a una organización de Cloud Manager

Cloud Manager dejará de ofrecer compatibilidad con automatización, copias de seguridad y monitorización para MongoDB 3.6 y 4.0 a partir del 30de agosto de 2024. Por favor, Actualice su implementación de MongoDB o migre a Atlas.

Invita a un usuario a la organización Cloud Manager que especifiques.

El usuario debe aceptar la invitación para acceder a la organización Cloud Manager.

Roles necesarios

Puede llamar a este punto final con éxito con el Organization User Admin role.

Resource

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

POST /orgs/{ORG-ID}/invites

Parámetros de la ruta de solicitud

Elemento de ruta	Tipo	Necesidad	Descripción
ORG-ID	string	Requerido	Cadena de dígitos hexadecimales 24única que identifica a la organización.

Parámetros de consulta de solicitud

Los siguientes parámetros de consulta son opcionales:

Nombre

Tipo

Necesidad

Descripción

predeterminado

bonita

booleano

Opcional

Bandera que indica si el cuerpo de la respuesta debe estar en formato prettyprint formato.

false

envolvente

booleano

Opcional

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

Algunos Los clientes de laAPI no pueden acceder a los encabezados de respuesta HTTP ni al código de estado. Para solucionar esto, configure envelope=true en la consulta.

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

Nombre	Descripción
`status`	Código de respuestaHTTP
`content`	Cuerpo de respuesta esperado

false

Parámetros del cuerpo de la solicitud

Body Parameter	Tipo	Necesidad	Descripción
papeles	matriz de cadenas	Requerido	Cloud Manager Roles para asignar al usuario invitado. Si el usuario acepta la invitación, Cloud Manager le asigna estos roles.
ID de equipo	matriz de cadenas	Opcional	Cadenas de dígitos hexadecimales 24únicas que identifican los equipos a los que invita al usuario a unirse.
Nombre de usuario	string	Requerido	Dirección de correo electrónico del usuario invitado. Esta es la dirección a la que Cloud Manager envía la invitación. Si el usuario acepta la invitación, iniciará sesión en Cloud Manager con este nombre de usuario.

Respuesta

Nombre	Tipo	Descripción
creadoEn	string	Marca de tiempo en formato ISO 8601 de fecha y hora en UTC cuando Cloud Manager envió la invitación.
expira en	string	Marca de tiempo en formato ISO 8601 fecha y hora en UTC cuando expira la invitación. Los usuarios tienen 30 días para aceptar una invitación a un proyecto de Cloud Manager.
ID.	string	Cadena de dígitos hexadecimales 24única que identifica la invitación.
inviterUsername	string	Usuario de Cloud Manager que invitó a nombre de usuario a la organización.
orgId	string	Cadena de dígitos hexadecimales 24única que identifica a la organización.
nombre_org	string	Nombre de la organización.
papeles	matriz de cadenas	Roles de Cloud Manager para asignar al usuario invitado. Si el usuario acepta la invitación, Cloud Manager le asigna estos roles.
ID de equipo	matriz de cadenas	Cadenas de dígitos hexadecimales 24únicas que identifican los equipos a los que el usuario fue invitado a unirse.
Nombre de usuario	string	Dirección de correo electrónico a la que Cloud Manager envió la invitación. Si el usuario acepta la invitación, utilizará esta dirección de correo electrónico como su nombre de usuario de Cloud Manager.

Ejemplo de solicitud

1 curl --user "{PUBLIC-KEY}:{PRIVATE-KEY}" --digest --include \
2      --header "Accept: application/json" \
3      --header "Content-Type: application/json" \
4      --request POST "https://cloud.mongodb.com/api/public/v1.0/orgs/{ORG-ID}/invites?pretty=true" \
5      --data '
6        {
7          "roles": [
8             "ORG_MEMBER"
9          ],
10          "username": "wyatt.smith@example.com"
11        }'

Ejemplo de respuesta

Encabezado de respuesta

HTTP/1.1 401 Unauthorized
Content-Type: application/json;charset=ISO-8859-1
Date: {dateInUnixFormat}
WWW-Authenticate: Digest realm="MMS Public API", domain="", nonce="{nonce}", algorithm=MD5, op="auth", stale=false
Content-Length: {requestLengthInBytes}
Connection: keep-alive

HTTP/1.1 201 Created
Vary: Accept-Encoding
Content-Type: application/json
Strict-Transport-Security: max-age=300
Date: {dateInUnixFormat}
Connection: keep-alive
Content-Length: {requestLengthInBytes}
X-MongoDB-Service-Version: gitHash={gitHash}; versionString={ApplicationVersion}

Cuerpo de respuesta

1 {
2   "createdAt": "2021-02-18T21:05:40Z",
3   "expiresAt": "2021-03-20T21:05:40Z",
4   "id": "{INVITATION-ID}",
5   "inviterUsername": "admin@example.com",
6   "orgId": "{ORG-ID}",
7   "orgName": "{ORG-NAME}",
8   "roles": [
9     "ORG_MEMBER"
10   ],
11   "teamIds": [],
12   "username": "wyatt.smith@example.com"
13 }

Volver

Borrar

Borrar invitación

1	curl --user "{PUBLIC-KEY}:{PRIVATE-KEY}" --digest --include \
2	--header "Accept: application/json" \
3	--header "Content-Type: application/json" \
4	--request POST "https://cloud.mongodb.com/api/public/v1.0/orgs/{ORG-ID}/invites?pretty=true" \
5	--data '
6	{
7	"roles": [
8	"ORG_MEMBER"
9	],
10	"username": "wyatt.smith@example.com"
11	}'

1	{
2	"createdAt": "2021-02-18T21:05:40Z",
3	"expiresAt": "2021-03-20T21:05:40Z",
4	"id": "{INVITATION-ID}",
5	"inviterUsername": "admin@example.com",
6	"orgId": "{ORG-ID}",
7	"orgName": "{ORG-NAME}",
8	"roles": [
9	"ORG_MEMBER"
10	],
11	"teamIds": [],
12	"username": "wyatt.smith@example.com"
13	}