Actualiza una invitación pendiente al proyecto Cloud Manager que especifiques.
Roles necesarios
Puede llamar exitosamente a este endpoint con la
Project User Admin role.
Resource
URL base: https://cloud.mongodb.com/api/public/v1.0
PATCH /groups/{GROUP-ID}/invites
Parámetros de la ruta de solicitud
Elemento de ruta | Tipo | Necesidad | Descripción |
|---|---|---|---|
ID del grupo | string | Requerido | string única de 24 dígitos hexadecimales que identifica el Proyecto. |
Parámetros de Solicitud Query
Los siguientes parámetros de query son opcionales:
Nombre | Tipo | Necesidad | Descripción | predeterminado | ||||||
|---|---|---|---|---|---|---|---|---|---|---|
bonito | booleano | Opcional | Indicador que señala si el cuerpo de respuesta debe estar en un prettyprint formato. |
| ||||||
envelope | 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 endpoints que devuelven un resultado, el cuerpo de la respuesta incluye:
|
|
Parámetros del cuerpo de la solicitud
Body Parameter | Tipo | Necesidad | Descripción |
|---|---|---|---|
Roles | Arreglo de cadenas | Requerido | Cloud Manager roles para asignar al usuario invitado. Si el usuario acepta la invitación, Cloud Manager le asigna estos roles. IMPORTANTE: Cloud Manager reemplaza los roles de la invitación con los que proporcione en esta solicitud. Asegúrese de incluir todos los roles que desea asignar al usuario en esta solicitud. |
Nombre de usuario | string | Requerido | Nombre de usuario del usuario cuya invitación desea actualizar. En Cloud Manager, el nombre de usuario de un usuario invitado es la dirección de correo electrónico a la que Cloud Manager envió la invitación. |
Respuesta
Nombre | Tipo | Descripción |
|---|---|---|
creado a las | string | Marca de tiempo en ISO 8601 formato de fecha y hora en UTC cuando Cloud Manager envió la invitación. |
expira en | string | Marca de tiempo en ISO 8601 formato de fecha y hora en UTC cuando la invitación vence. Los usuarios tienen 30 días para aceptar una invitación a un proyecto de Cloud Manager. |
ID del grupo | string | string única de 24 dígitos hexadecimales que identifica el Proyecto. |
groupName | string | Nombre del proyecto. |
ID | string | string única de 24 dígitos hexadecimales que identifica la invitación. |
inviterUsername | string | Usuario de Cloud Manager que invitó a nombre de usuario al proyecto. |
Roles | Arreglo de cadenas | Cloud Manager roles 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, utiliza esta dirección de correo electrónico como su nombre de usuario de Cloud Manager. |
Solicitud de ejemplo
1 curl --user "{PUBLIC-KEY}:{PRIVATE-KEY}" --digest --include \ 2 --header "Accept: application/json" \ 3 --header "Content-Type: application/json" \ 4 --request PATCH "https://cloud.mongodb.com/api/public/v1.0/groups/{GROUP-ID}/invites/{INVITATION-ID}?pretty=true" \ 5 --data ' 6 { 7 "roles": [ 8 "GROUP_OWNER" 9 ], 10 "username": "jane.smith@example.com" 11 }'
Respuesta de ejemplo
Encabezado de respuesta
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
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}
Respuesta del cuerpo
1 { 2 "createdAt": "2021-02-18T18:51:46Z", 3 "expiresAt": "2021-03-20T18:51:46Z", 4 "groupId": "{GROUP-ID}", 5 "groupName": "group", 6 "id": "{INVITATION-ID}", 7 "inviterUsername": "admin@example.com", 8 "roles": [ 9 "GROUP_OWNER" 10 ], 11 "username": "jane.smith@example.com" 12 }