그룹 만들기, 업데이트, 목록 작성, 삭제 등 그룹을 관리하는 나머지 API 메서드를 사용합니다.
새 사용자 그룹을 만드는 POST
메서드입니다.
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>
}
사용자 그룹을 업데이트하는 PUT
메서드입니다.
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>
}
사용자 그룹을 나열하는 GET
메서드입니다.
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>
}, ...
]
사용자 그룹을 삭제하고 해당 그룹에서 모든 구성원을 제거하는 DELETE
메서드입니다.
DELETE /api/v1/groups/
<groupId>
성공하면 204 No Content
을 반환합니다. 충돌의 경우 409 Conflict
을 반환합니다.
여러 그룹을 일괄적으로 삭제하고 해당 그룹에서 모든 구성원을 제거하는 DELETE
메서드입니다.
DELETE /api/v1/groups/bulk-delete
성공하면 204 No Content
을 반환합니다. 충돌의 경우 409 Conflict
을 반환합니다.
그룹에 있는 권한 개체를 나열하는 GET
메서드입니다.
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"]
}
]
그룹에 액세스할 수 없는 경우 400 Bad Request
을 반환합니다.
그룹 권한을 업데이트하는 PUT
메서드입니다. 이 메서드는 이전 권한을 새 권한으로 덮어씁니다.
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"]
}
]
샘플 응답은 업데이트된 권한 객체 목록을 나타냅니다.
성공하면 200 OK
을 반환합니다. 주어진 권한이 잘못된 경우 400
을 반환합니다. 로그인한 사용자가 개체를 액세스할 수 없는 경우 403
을 반환할 수도 있습니다.