- URL:https://<roles-url>/search(POST only)
- Required Capability:Default administrator role | All authorized privileges
- Version Introduced:10.1
Description
This operation searches a specific role or a group of roles from the role store. The size of the search results can be controlled with the maxCount parameter.
Request parameters
| Parameter | Description |
|---|---|
| filter | A filter string to search the roles. Example |
| maxCount | The maximum size of the result size. Example |
| f | The response format. The default response format is html. Values: html | json | pjson |
Example usage
Below is a sample POST request for search that demonstrate how to return roles that begin with the name 'editors':
POST /webadaptor/admin/security/roles/search HTTP/1.1
Host: machine.domain.com
Content-Type: application/x-www-form-urlencoded
Content-Length: []
filter=editors&maxCount=20&f=jsonJSON Response example
{
"roles": [editors],
"hasMore": false
}