/ /

/ /

Obtenga todas las invitaciones al proyecto

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.

Recupera todas las invitaciones pendientes al proyecto de Cloud Manager especificado.

Roles necesarios

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

Resource

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

GET /groups/{GROUP-ID}/invites

Parámetros de la ruta de solicitud

Elemento de ruta	Tipo	Necesidad	Descripción
ID DE GRUPO	string	Requerido	Cadena de dígitos hexadecimales 24única que identifica el proyecto.

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

Nombre de usuario	string	Opcional	Dirección de correo electrónico del usuario invitado. Esta es la dirección a la que Cloud Manager envió la invitación. Si se omite, Cloud Manager devuelve todas las invitaciones pendientes.

Parámetros del cuerpo de la solicitud

Este punto final no utiliza parámetros del cuerpo de la solicitud HTTP.

Respuesta

El documento JSON de respuesta incluye una matriz de objetos. Cada objeto representa una invitación al proyecto Cloud Manager.

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 de grupo	string	Cadena de dígitos hexadecimales 24única que identifica el proyecto.
nombre del grupo	string	Nombre del proyecto.
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 al proyecto.
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.
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

curl --user "{PUBLIC-KEY}:{PRIVATE-KEY}" --digest --include \
     --header "Accept: application/json" \
     --request GET "https://cloud.mongodb.com/api/public/v1.0/groups/{GROUP-ID}/invites?pretty=true"

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 200 OK
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   {
3     "createdAt": "2021-02-18T18:51:46Z",
4     "expiresAt": "2021-03-20T18:51:46Z",
5     "groupId": "{GROUP-ID}",
6     "groupName": "group",
7     "id": "{INVITATION-ID}",
8     "inviterUsername": "admin@example.com",
9     "roles": [
10       "GROUP_OWNER"
11     ],
12     "username": "jane.smith@example.com"
13   },
14   {
15     "createdAt": "2021-02-18T21:05:40Z",
16     "expiresAt": "2021-03-20T21:05:40Z",
17     "groupId": "{GROUP-ID}",
18     "groupName": "group",
19     "id": "{INVITATION-ID}",
20     "inviterUsername": "admin@example.com",
21     "roles": [
22       "GROUP_READ_ONLY"
23     ],
24     "username": "john.smith@example.com"
25   }
26 ]

Volver

Borrar invitación

Obtenga una invitación

1	[
2	{
3	"createdAt": "2021-02-18T18:51:46Z",
4	"expiresAt": "2021-03-20T18:51:46Z",
5	"groupId": "{GROUP-ID}",
6	"groupName": "group",
7	"id": "{INVITATION-ID}",
8	"inviterUsername": "admin@example.com",
9	"roles": [
10	"GROUP_OWNER"
11	],
12	"username": "jane.smith@example.com"
13	},
14	{
15	"createdAt": "2021-02-18T21:05:40Z",
16	"expiresAt": "2021-03-20T21:05:40Z",
17	"groupId": "{GROUP-ID}",
18	"groupName": "group",
19	"id": "{INVITATION-ID}",
20	"inviterUsername": "admin@example.com",
21	"roles": [
22	"GROUP_READ_ONLY"
23	],
24	"username": "john.smith@example.com"
25	}
26	]