Setting Permissions

PUT is implemented as a synonym of POST for the permission service. Both will create an explicit permission for a given role or user on a resource, overriding the previous explicit permission for the same role or user. To set a permission use either method and include the permission descriptors (objectPermissionImpl) such as those returned by the GET method.

Method

URL

PUT or

POST

http://<host>:<port>/jasperserver[-pro]/rest/permission/path/to/resource/

Content-Type

Content

text/plain

A well-formed XML entityResource that defines the permissions you want to set.

Return Value on Success

Typical Return Value on Failure

200 OK

404 Not Found – When the specified resource URI is not found in the repository.

Setting a permission creates an explicit permission for the given user or role. To reset the inherited permission value, remove the explicit permission with the DELETE method. This method does not take a permission descriptor, instead specify the roles and users to reset to the inherited permission as parameters.

Method

URL

DELETE

http://<host>:<port>/jasperserver[-pro]/rest/permission/path/to/resource/?<argument>

Argument

Type/Value

Description

roles

String

A comma-separated list of role names. The access permission for the specified roles will revert to the resource’s inherited permission for those roles.

users

String

A comma-separated list of user IDs. The access permission for the specified users will revert to the resource’s inherited permission for those users.

Return Value on Success

Typical Return Values on Failure

200 OK

404 Not Found – When the specified resource URI is not found in the repository.

Version: 
Feedback