Package com.atlassian.bamboo.plugins.rest.permission

Class GlobalPermissionsResource

java.lang.Object

com.atlassian.bamboo.plugins.rest.permission.GlobalPermissionsResource

All Implemented Interfaces:

PermissionsResource

@Path("permissions/global")
@Produces("application/json")
@Consumes("application/json")
public class GlobalPermissionsResource
extends Object
implements PermissionsResource

REST endpoint to manage user/group global permissions in Bamboo.

Since:

6.2

Field Summary

Fields inherited from interface com.atlassian.bamboo.plugins.rest.permission.PermissionsResource

ROLE_ANONYMOUS, ROLE_LOGGED_IN

Method Summary

Modifier and Type	Method	Description
boolean	addAnonymousPermissions(String key)
boolean	addGroupPermissions(String ignore, String group, List<BambooPermission> permissionsToAdd)
boolean	addLoggedInPermissions(String ignore, List<BambooPermission> permissionsToAdd)
jakarta.ws.rs.core.Response	addPermissionsForGroup(String ignore, String group, List<String> permissionsToAdd)	Adds given permissions to group Returns status code 204 Response.Status.NO_CONTENT if any permission was added or status code 304 Response.Status.NOT_MODIFIED if given permissions were already added
jakarta.ws.rs.core.Response	addPermissionsForRole(String ignore, String role, List<String> permissionsToAdd)	Adds given permissions to role Returns status code 204 Response.Status.NO_CONTENT if any permission was added or status code 304 Response.Status.NOT_MODIFIED if all permissions were already added
jakarta.ws.rs.core.Response	addPermissionsForUser(String ignore, String username, List<String> permissionsToAdd)	Adds given permissions to user Returns status code 204 Response.Status.NO_CONTENT if any permission was added or status code 304 Response.Status.NOT_MODIFIED if given permissions were already added
boolean	addUserPermissions(String ignore, String username, List<BambooPermission> permissionsToAdd)
List<BambooPermission>	getAnonymousPermissions(String key)
RestPageModel<RestGroup>	getAvailableGroups(String ignore, String nameFilter, PageRequest pageRequest, ExpansionParam expansion, jakarta.ws.rs.core.UriInfo uriInfo)	Returns a paged list of groups RestGroup for which no permissions was defined.
RestPageModel<RestUser>	getAvailableUsers(String ignore, String nameFilter, PageRequest pageRequest, ExpansionParam expansion, jakarta.ws.rs.core.UriInfo uriInfo)	Returns a paged list of users RestUser for which no permissions was defined.
List<BambooPermission>	getGroupPermissions(String ignore, String group)
List<BambooPermission>	getLoggedInPermissions(String ignore)
List<BambooPermission>	getUserPermissions(String ignore, String username)
default boolean	isPermissionVisible(@NotNull BambooPermission permission)
RestPageModel<RestGroupPermission>	listGroupPermissions(String ignore, String nameFilter, PageRequest pageRequest, ExpansionParam expansion, jakarta.ws.rs.core.UriInfo uriInfo)	Returns a paged list of groups RestGroupPermission with non empty permissions
Iterable<String>	listGroupsWithPermissions(String ignore)
RestPageModel<RestRolePermission>	listRolePermissions(String ignore, PageRequest pageRequest, ExpansionParam expansion, jakarta.ws.rs.core.UriInfo uriInfo)	Returns a paged list of roles RestRolePermission with non empty permissions
RestPageModel<RestUserPermission>	listUserPermissions(String ignore, String nameFilter, PageRequest pageRequest, ExpansionParam expansion, jakarta.ws.rs.core.UriInfo uriInfo)	Returns a paged list of users RestUserPermission with non empty permissions
Iterable<String>	listUsersWithPermissions(String ignore)
Collection<BambooPermission>	permissionDependencies(@NotNull BambooPermission permission)
boolean	removeAnonymousPermissions(String key)
boolean	removeGroupPermissions(String ignore, String group, List<BambooPermission> permissionsToRemove)
boolean	removeLoggedInPermissions(String ignore, List<BambooPermission> permissionsToRemove)
jakarta.ws.rs.core.Response	removePermissionsForGroup(String ignore, String group, List<String> permissionsToRemove)	Removes given permissions from group Returns status code 204 Response.Status.NO_CONTENT if any permission was removed or status code 304 Response.Status.NOT_MODIFIED if given permissions were not present
jakarta.ws.rs.core.Response	removePermissionsForRole(String ignore, String role, List<String> permissionsToRemove)	Removes given permissions from role Returns status code 204 Response.Status.NO_CONTENT if any permission was removed or status code 304 Response.Status.NOT_MODIFIED if given permissions were not present
jakarta.ws.rs.core.Response	removePermissionsForUser(String ignore, String username, List<String> permissionsToRemove)	Removes given permissions from user Returns status code 204 Response.Status.NO_CONTENT if any permission was removed or status code 304 Response.Status.NOT_MODIFIED if given permissions were not present
boolean	removeUserPermissions(String ignore, String username, List<BambooPermission> permissionsToRemove)
Collection<BambooPermission>	supportedPermissions()
Set<String>	supportedRoles()

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Method Details

listUserPermissions

@GET
@Path("users")
public RestPageModel<RestUserPermission> listUserPermissions(@QueryParam("ignore")
 String ignore,
 @QueryParam("name")
 String nameFilter,
 @BeanParam
 PageRequest pageRequest,
 @BeanParam
 ExpansionParam expansion,
 @Context
 jakarta.ws.rs.core.UriInfo uriInfo)

Description copied from interface: PermissionsResource

Returns a paged list of users RestUserPermission with non empty permissions

Specified by:

listUserPermissions in interface PermissionsResource

addPermissionsForUser

@PUT
@Path("users/{name : (.+)?}")
public jakarta.ws.rs.core.Response addPermissionsForUser(@QueryParam("ignore")
 String ignore,
 @PathParam("name")
 String username,
 List<String> permissionsToAdd)

Description copied from interface: PermissionsResource

Adds given permissions to user Returns status code 204 Response.Status.NO_CONTENT if any permission was added or status code 304 Response.Status.NOT_MODIFIED if given permissions were already added

Specified by:

addPermissionsForUser in interface PermissionsResource

removePermissionsForUser

@DELETE
@Path("users/{name : (.+)?}")
public jakarta.ws.rs.core.Response removePermissionsForUser(@QueryParam("ignore")
 String ignore,
 @PathParam("name")
 String username,
 List<String> permissionsToRemove)

Description copied from interface: PermissionsResource

Removes given permissions from user Returns status code 204 Response.Status.NO_CONTENT if any permission was removed or status code 304 Response.Status.NOT_MODIFIED if given permissions were not present

Specified by:

removePermissionsForUser in interface PermissionsResource

getAvailableUsers

@GET
@Path("available-users")
public RestPageModel<RestUser> getAvailableUsers(@QueryParam("ignore")
 String ignore,
 @QueryParam("name")
 String nameFilter,
 @BeanParam
 PageRequest pageRequest,
 @BeanParam
 ExpansionParam expansion,
 @Context
 jakarta.ws.rs.core.UriInfo uriInfo)

Description copied from interface: PermissionsResource

Returns a paged list of users RestUser for which no permissions was defined. Allows to filter by user name

Specified by:

getAvailableUsers in interface PermissionsResource

listGroupPermissions

@GET
@Path("groups")
public RestPageModel<RestGroupPermission> listGroupPermissions(@QueryParam("ignore")
 String ignore,
 @QueryParam("name")
 String nameFilter,
 @BeanParam
 PageRequest pageRequest,
 @BeanParam
 ExpansionParam expansion,
 @Context
 jakarta.ws.rs.core.UriInfo uriInfo)

Description copied from interface: PermissionsResource

Returns a paged list of groups RestGroupPermission with non empty permissions

Specified by:

listGroupPermissions in interface PermissionsResource

addPermissionsForGroup

@PUT
@Path("groups/{name : (.+)?}")
public jakarta.ws.rs.core.Response addPermissionsForGroup(@QueryParam("ignore")
 String ignore,
 @PathParam("name")
 String group,
 List<String> permissionsToAdd)

Description copied from interface: PermissionsResource

Adds given permissions to group Returns status code 204 Response.Status.NO_CONTENT if any permission was added or status code 304 Response.Status.NOT_MODIFIED if given permissions were already added

Specified by:

addPermissionsForGroup in interface PermissionsResource

removePermissionsForGroup

@DELETE
@Path("groups/{name : (.+)?}")
public jakarta.ws.rs.core.Response removePermissionsForGroup(@QueryParam("ignore")
 String ignore,
 @PathParam("name")
 String group,
 List<String> permissionsToRemove)

Description copied from interface: PermissionsResource

Removes given permissions from group Returns status code 204 Response.Status.NO_CONTENT if any permission was removed or status code 304 Response.Status.NOT_MODIFIED if given permissions were not present

Specified by:

removePermissionsForGroup in interface PermissionsResource

getAvailableGroups

@GET
@Path("available-groups")
public RestPageModel<RestGroup> getAvailableGroups(@QueryParam("ignore")
 String ignore,
 @QueryParam("name")
 String nameFilter,
 @BeanParam
 PageRequest pageRequest,
 @BeanParam
 ExpansionParam expansion,
 @Context
 jakarta.ws.rs.core.UriInfo uriInfo)

Description copied from interface: PermissionsResource

Returns a paged list of groups RestGroup for which no permissions was defined. Allows to filter by group name

Specified by:

getAvailableGroups in interface PermissionsResource

listRolePermissions

@GET
@Path("roles")
public RestPageModel<RestRolePermission> listRolePermissions(@QueryParam("ignore")
 String ignore,
 @BeanParam
 PageRequest pageRequest,
 @BeanParam
 ExpansionParam expansion,
 @Context
 jakarta.ws.rs.core.UriInfo uriInfo)

Description copied from interface: PermissionsResource

Returns a paged list of roles RestRolePermission with non empty permissions

Specified by:

listRolePermissions in interface PermissionsResource

addPermissionsForRole

@PUT
@Path("roles/{name : (.+)?}")
public jakarta.ws.rs.core.Response addPermissionsForRole(@QueryParam("ignore")
 String ignore,
 @PathParam("name")
 String role,
 List<String> permissionsToAdd)

Description copied from interface: PermissionsResource

Adds given permissions to role Returns status code 204 Response.Status.NO_CONTENT if any permission was added or status code 304 Response.Status.NOT_MODIFIED if all permissions were already added

Specified by:

addPermissionsForRole in interface PermissionsResource

removePermissionsForRole

@DELETE
@Path("roles/{name : (.+)?}")
public jakarta.ws.rs.core.Response removePermissionsForRole(@QueryParam("ignore")
 String ignore,
 @PathParam("name")
 String role,
 List<String> permissionsToRemove)

Description copied from interface: PermissionsResource

Removes given permissions from role Returns status code 204 Response.Status.NO_CONTENT if any permission was removed or status code 304 Response.Status.NOT_MODIFIED if given permissions were not present

Specified by:

removePermissionsForRole in interface PermissionsResource

supportedRoles

public Set<String> supportedRoles()

supportedPermissions

public Collection<BambooPermission> supportedPermissions()

permissionDependencies

public Collection<BambooPermission> permissionDependencies(@NotNull
 @NotNull BambooPermission permission)

listUsersWithPermissions

public Iterable<String> listUsersWithPermissions(String ignore)

getUserPermissions

public List<BambooPermission> getUserPermissions(String ignore,
 String username)

addUserPermissions

public boolean addUserPermissions(String ignore,
 String username,
 List<BambooPermission> permissionsToAdd)

removeUserPermissions

public boolean removeUserPermissions(String ignore,
 String username,
 List<BambooPermission> permissionsToRemove)

listGroupsWithPermissions

public Iterable<String> listGroupsWithPermissions(String ignore)

getGroupPermissions

public List<BambooPermission> getGroupPermissions(String ignore,
 String group)

addGroupPermissions

public boolean addGroupPermissions(String ignore,
 String group,
 List<BambooPermission> permissionsToAdd)

removeGroupPermissions

public boolean removeGroupPermissions(String ignore,
 String group,
 List<BambooPermission> permissionsToRemove)

getLoggedInPermissions

public List<BambooPermission> getLoggedInPermissions(String ignore)

addLoggedInPermissions

public boolean addLoggedInPermissions(String ignore,
 List<BambooPermission> permissionsToAdd)

removeLoggedInPermissions

public boolean removeLoggedInPermissions(String ignore,
 List<BambooPermission> permissionsToRemove)

getAnonymousPermissions

public List<BambooPermission> getAnonymousPermissions(String key)

addAnonymousPermissions

public boolean addAnonymousPermissions(String key)

removeAnonymousPermissions

public boolean removeAnonymousPermissions(String key)

isPermissionVisible

default boolean isPermissionVisible(@NotNull
 @NotNull BambooPermission permission)