Get All Default Roles of a Service
Request
GET <REST API URL>/services/{service id}/defaultroles?fields=string&$skip=int&$top=int&query=string&orderBy=string
Parameter | Description |
---|---|
| Optional. Returns only the specified subset of the fields for each DefaultRole. Use Fields Syntax to define the subset. |
| Optional. Lets you set a number of DefaultRoles to skip before returning the first one. |
| Optional. Lets you set the maximum number of DefaultRoles to return. |
| Optional. Lets you specify a search query to filter the returned results. See Query Syntax for the definition of supported logical operations syntax. For the DefaultRoles, the following fields and tuples are supported: has: permission — Default roles with some permissions id: value — Service default role with the given ID key: value — Default roles with the given key name: value — Default roles with the given name permission: permission — Default roles that include the given permission has: permission — Roles with some permissions id: value — Role with the given ID key: roleKey — Role with the given key name: roleName — Role with the given name permission: permission — Roles that includes the given permission permission(key: permissionKey, service: service) — Roles that includes the given permission permission(service: service) — Roles that have at least one permission from service |
| Optional. Returns the list of DefaultRoles sorted by a specified field. See Sorting Syntax for details. DefaultRoles support ordering by the following fields: key, name, key, name |
Response
Response Code | Meaning |
---|---|
200 OK | Successful request. |
400 Bad Request | At least one of the request parameters is invalid. For example, a required field in the passed JSON object is missing. For details, check the error message in the response. |
403 Forbidden | The requester has no access to the requested resource. |
404 Not Found | The requested resource was not found. |
500 Internal Server Error | Failed to process request because of the server error. For details, check the error message in the response. |
Response body
{
"skip": int,
"top": int,
"total": int,
"defaultroles": [role, ...]
}