/ /

Organizaciones

Docs Home

/ /

Organizaciones y equipos

Organizaciones y equipos

Organizaciones

Invitación a actualizar una organización

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.

Actualiza una invitación pendiente a la organización Cloud Manager que especifique.

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

PATCH /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. 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
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 PATCH "https://cloud.mongodb.com/api/public/v1.0/orgs/{ORG-ID}/invites?pretty=true" \
5      --data '
6        {
7          "roles": [
8            "ORG_OWNER"
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 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    "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_OWNER"
10    ],
11    "teamIds": [],
12    "username": "wyatt.smith@example.com"
13 }

Volver

Actualizar por ID de invitación

Equipos

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/orgs/{ORG-ID}/invites?pretty=true" \
5	--data '
6	{
7	"roles": [
8	"ORG_OWNER"
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_OWNER"
10	],
11	"teamIds": [],
12	"username": "wyatt.smith@example.com"
13	}