Rest API Métodos para administrar grupos, incluidos crear, actualizar, enumerar y eliminar grupos.
A POST
para crear un nuevo grupo de usuarios.
POST /api/v1/groups/
{
"name" : <string>,
"description" : <string_may_be_null>,
}
{
"groupId" : <integer>,
"pid" : <integer>,
"name" : <string>,
"description" : <string_may_be_null>,
"membershipCount" : <integer>,
"wildcards" : <list of strings>,
"users" : <list of user IDs>
}
A PUT
para actualizar un grupo de usuarios.
PUT /api/v1/groups/
<groupId>
{
"name" : <string>,
"description" : <string_may_be_null>,
}
{
"groupId" : <integer>,
"pid" : <integer>,
"name" : <string>,
"description" : <string_may_be_null>,
"membershipCount" : <integer>,
"wildcards" : <list of strings>,
"users" : <list of user IDs>
}
A GET
para enumerar los grupos de usuarios.
GET /api/v1/groups/
[
{
"groupId" : <integer>,
"pid" : <integer>,
"name" : <string>,
"description" : <string_may_be_null>,
"membershipCount" : <integer>,
"wildcards" : <list of strings>,
"users" : <list of user IDs>
}, ...
]
A DELETE
para eliminar un grupo de usuarios y quitar todos los miembros de ese grupo.
DELETE /api/v1/groups/
<groupId>
Devuelve 204 No Content
si tiene éxito. En caso de conflicto, devuelve 409 Conflict
.
A DELETE
para eliminar varios grupos de forma masiva y eliminar todos los miembros de ese grupo.
DELETE /api/v1/groups/bulk-delete
Devuelve 204 No Content
si tiene éxito. En caso de conflicto, devuelve 409 Conflict
.
A GET
para enumerar los objetos de permiso de un grupo.
GET /api/v1/groups/{groupId}/permissions
[{
"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 el grupo no es accesible.
A PUT
para actualizar los permisos de grupo. Este método sobrescribe los permisos antiguos con los nuevos permisos.
PUT /api/v1/groups/{groupId}/permissions/
[
{ "objectType" : "SEGMENT",
"objectId" : 563,
"permissions" : [ "READ", "WRITE"]
},
{ "objectType" : "SEGMENT",
"objectId" : 2363,
"permissions" : [ "CREATE", "WRITE"]
},
{ "objectType" : "TRAIT",
"objectId" : 83498,
"permissions" : [ "READ", "MAP_TO_SEGMENTS"]
},
{ "objectType" : "DESTINATION",
"objectId" : 304,
"permissions" : [ "READ", "WRITE", "CREATE"]
}
]
La respuesta de ejemplo representa la lista actualizada de objetos de permiso.
Devuelve 200 OK
si tiene éxito. Devuelve 400
si algún permiso dado no es válido. También puede devolver 403
si el usuario que ha iniciado sesión no puede acceder al objeto.