Métodos de API de administración de grupos

Última actualización: 20 de julio de 2024

Rest API métodos para administrar grupos, incluyendo la creación, actualización, listado y eliminación de grupos.

Creación de grupos

Un método POST para crear un nuevo grupo de usuarios.

Solicitud

POST /api/v1/groups/

Cuerpo de solicitud de muestra

 {
    "name" : <string>,
    "description" : <string_may_be_null>,
 }

Respuesta

  {
    "groupId" : <integer>,
    "pid" : <integer>,
    "name" : <string>,
    "description" : <string_may_be_null>,
    "membershipCount" : <integer>,
    "wildcards" : <list of strings>,
    "users" : <list of user IDs>
  }

Actualizar un grupo

Un método PUT para actualizar un grupo de usuarios.

Solicitud

PUT /api/v1/groups/<groupId>

Cuerpo de solicitud de muestra

 {
    "name" : <string>,
    "description" : <string_may_be_null>,
 }

Respuesta

  {
    "groupId" : <integer>,
    "pid" : <integer>,
    "name" : <string>,
    "description" : <string_may_be_null>,
    "membershipCount" : <integer>,
    "wildcards" : <list of strings>,
    "users" : <list of user IDs>
  }

Grupos de lista

Un método GET para enumerar grupos de usuarios.

Solicitud

GET /api/v1/groups/

Respuesta

[
  {
    "groupId" : <integer>,
    "pid" : <integer>,
    "name" : <string>,
    "description" : <string_may_be_null>,
    "membershipCount" : <integer>,
    "wildcards" : <list of strings>,
    "users" : <list of user IDs>
  }, ...
]

Eliminar un grupo

Un método DELETE para eliminar un grupo de usuarios y quitar todos los miembros de ese grupo.

Solicitud

DELETE /api/v1/groups/<groupId>

Devuelve 204 No Content si se realizó correctamente. En caso de conflicto, devuelve 409 Conflict.

Eliminar grupos por lotes

Un método DELETE para eliminar varios grupos de forma masiva y quitar todos los miembros de ese grupo.

Solicitud

DELETE /api/v1/groups/bulk-delete

Devuelve 204 No Content si se realizó correctamente. En caso de conflicto, devuelve 409 Conflict.

Mostrar todos los permisos de un grupo

Un método GET para enumerar los objetos de permiso de un grupo.

Solicitud

GET /api/v1/groups/{groupId}/permissions

Respuesta

[{
 "objectId" : 34,
 "objectType": "SEGMENT",
 "permissions": ["READ", "WRITE", "DELETE", "MAP_TO_MODELS"]
 },

{
 "objectId" : "234",
 "objectType": "TRAIT",
 "permissions": ["READ", "WRITE", "DELETE", "MAP_TO_MODELS"]
 },
 {
 "objectId" : 277,
 "objectType": "SEGMENT",
 "permissions": ["READ", "WRITE", "MAP_TO_MODELS"]
 }
]

Devuelve 400 Bad Request si no se puede obtener acceso al grupo.