Para obtener más información sobre las relaciones entre objetos y cómo utilizarlas en la API, ve a la sección Relaciones entre objetos .
Para obtener más información sobre grupos de usuarios de Sever, visita la página de ayuda Administración de usuarios y grupos
Para crear un nuevo grupo de usuarios de Server, utiliza el punto de conexión
POST {baseURL}/v3/usergroups
.
Para crear un nuevo grupo de usuarios de Server, especifica el parámetro contract:
contract (cuerpo): obligatorio. Especifica los parámetros de un grupo de usuarios de Server:
name (cadena): obligatorio. Ingresa un nombre de grupo de usuarios de Server.
role (cadena): obligatorio. Ingresa un rol para este grupo de usuarios de Server. Selecciona entre estas opciones: Sin acceso, Visualizador, Miembro, Creador, Administrador y Evaluado. El rol predeterminado (Evaluado) se evalúa en el tiempo de ejecución. Para obtener más información acerca de los roles y permisos, visita la página Permisos y roles de usuarios .
curl --location --request POST 'http://localhost/webapi/v3/usergroups' \ --header 'Content-Type: application/x-www-form-urlencoded' \ --header 'Authorization: Bearer BearerTokenGoesHere' \ --data-urlencode 'name=Accounting' \ --data-urlencode 'role=Artisan'
Para agregar uno o más usuarios a un grupo de usuarios de Server, utiliza el punto de conexión
POST {baseURL}/v3/usergroups/{id}/users
.
Para agregar usuarios a un grupo de usuarios de Server, especifica los siguientes parámetros:
id (cadena): obligatorio. Ingresa el ID del grupo de usuarios de Server al que deseas agregar usuarios.
userIds (cuerpo): obligatorio. Ingresa los ID de usuario que deseas agregar a este grupo de usuarios de Server.
Para agregar un grupo de Active Directory como miembro de un grupo de usuarios de Server, utiliza el punto de conexión
POST /v3/usergroups/{id}/activedirectorygroups
.
Nota
Este punto de conexión solo se puede usar para las instancias de Server configuradas con autenticación de Windows.
id (cadena): obligatorio. Ingresa el ID de un grupo de usuarios existente de Server al que deseas agregar un grupo de Active Directory.
sid (cadena): obligatorio. Ingresa el identificador de seguridad (SID) del grupo Active Directory. Debes enviar el valor en comillas, por ejemplo “S-My-SID”.
Para buscar usuarios, utiliza el punto de conexión
GET {baseURL}/v3/usergroups
. Utiliza varios parámetros como filtro para buscar a los usuarios.
Nota
Solo se recuperarán los grupos de usuarios de Server. No se devolverán grupos de Active Directory.
No se requieren parámetros.
curl --location --request GET 'http://localhost/webapi/v3/usergroups' \ --header 'Authorization: Bearer BearerTokenGoesHere'
Para recuperar información acerca de un grupo de usuarios de Server específico, utiliza el punto de conexión
GET {baseURL}/v3/usergroups/{id}
.
Nota
Solo funciona para grupos de usuarios de Server. Los grupos de Active Directory no se pueden recuperar desde este punto de conexión.
id (cadena): obligatorio. Ingresa un ID de grupo de usuarios de Server para recuperar información sobre este grupo de usuarios.
curl --location --request GET 'http://localhost/webapi/v3/usergroups/61d58ac83c15317e1a482069' \ --header 'Authorization: Bearer BearerTokenGoesHere'
Para actualizar el nombre y el rol de un grupo de usuarios de Server existente, utiliza el punto de conexión
PUT {baseURL}/v3/usergroups/{id}
.
id (cadena): obligatorio. Ingresa un ID de grupo de usuarios de Server para actualizar este grupo de usuarios.
contract (cuerpo): obligatorio. Para actualizar un grupo de usuarios de Server, se requiere el parámetro contract. Especifica lo siguiente:
name (cadena): obligatorio. Ingresa un nombre de grupo de usuarios de Server.
role (cadena): obligatorio. Puedes seleccionar entre estas opciones: Sin acceso, Visualizador, Miembro, Creador, Administrador y Evaluado. Para obtener más información acerca de los roles y permisos, visita la página Permisos y roles de usuarios .
curl --location --request PUT 'http://localhost/webapi/v3/usergroups/61d58ac83c15317e1a482069' \ --header 'Content-Type: application/x-www-form-urlencoded' \ --header 'Authorization: Bearer BearerTokenGoesHere' \ --data-urlencode 'name=Marketing' \ --data-urlencode 'role=Artisan'
Para quitar un usuario específico de un grupo de usuarios de Server, utiliza el punto de conexión
DELETE {baseURL}/v3/usergroups/{userGroupId}/users/{userId}
.
Nota
Si el usuario no forma parte del grupo, se devolverá la respuesta Aceptar.
userGroupId (cadena): obligatorio. Ingresa el ID del grupo de usuarios de Server desde el que deseas quitar el usuario.
userId (cadena): obligatorio. Ingresa el ID de usuario que deseas quitar del grupo de usuarios de Server.
curl --location --request DELETE 'http://localhost/webapi/v3/usergroups/61d58ac83c15317e1a482069/users/61d564361d6d5da7ad461a32' \ --header 'Authorization: Bearer BearerTokenGoesHere'
Para quitar un grupo de Active Directory como miembro de un grupo de usuarios de Server, utiliza el punto de conexión
DELETE /v3/usergroups/{userGroupId}/activedirectorygroups/{adGroupSid}
.
Nota
Este punto de conexión solo se puede usar para las instancias de Server configuradas con autenticación de Windows.
userGroupId (cadena): obligatorio. Ingresa el identificador del grupo de usuarios de Server desde el que deseas quitar el grupo de Active Directory.
adGroupSid (cadena): obligatorio. Ingresa el identificador de seguridad (SID) del grupo de Active Directory que deseas quitar del grupo de usuarios de Server.
Para eliminar un grupo de usuarios de Server específico del sistema, utiliza el punto de conexión
DELETE {baseURL}/v3/usergroups/{id}
.
Nota
Se devuelve el mensaje de error “400 Solicitud errónea” si el grupo de usuarios de Server no está vacío y el parámetro de consulta forceDelete es falso.
id (cadena): obligatorio. Ingresa el ID del grupo de usuarios de Server que deseas eliminar.
forceDelete (booleano): opcional. Si se establece en verdadero, el grupo de usuarios de Server se eliminará incluso si este grupo de usuarios contiene usuarios.
curl --location --request DELETE 'http://localhost/webapi/v3/usergroups/61d58ac83c15317e1a482069?forceDelete=true' \ --header 'Authorization: Bearer BearerTokenGoesHere'
Si creas un grupo de usuarios de Server, puedes utilizar los objetos creados de la siguiente manera:
Objeto creado: “ id ” (por ejemplo, “id”: “619158e57e607d0011ac3009”)
Puedes usarlo como:
userGroupId si vas a agregar un grupo de usuarios de Server a una colección .
userGroupId si vas a actualizar los permisos de grupo de usuarios de Server de una colección .
userGroupId si vas a quitar un grupo de usuarios de Server de una colección .
userGroupId si deseas compartir una credencial con un grupo de usuarios de Server .
userGroupId si deseas quitar un grupo de usuarios de Server de una credencial .
userGroupId si deseas agregar un grupo de usuarios de Server a una conexión de datos .
userGroupId si deseas quitar un grupo de usuarios de Server de una conexión de datos .
POST /v3/usergroups
DELETE /v3/usergroups/{userGroupId}/users/{userId}
Para obtener más información sobre las solicitudes de Postman, visita la página de ayuda Cómo usar Postman .