List privileges
get
https://EM_HOST:EM_CONSOLE_HTTPS_PORT/em/api/privileges
The API returns list of privileges ordered by name (ascending) by default.
Request
Query Parameters
-
limit: integer
Minimum Value:
1
Maximum Value:2000
For list pagination. The maximum number of results per page, or items to return in a paginated "List" call. The api will return no more than the number specified as limit, but might not return that exact number.Default Value:20
-
name: string
Exact Name of Privilege to be filteredExample:
MANAGE_JOB
-
nameContains: string
Part of Privilege Name used to filter PrivilegesExample:
MANAGE_JOB
-
page: string
System generated page token of a page.
-
secureResourceType: string
SecureResource Type of PrivilegeAllowed Values:
[ "ALL", "SYSTEM", "<Any SecureResourceType like TARGET, JOB etc>" ]
Example:JOB
-
sort: string
The order of the result set with direction. Allowed sort field is name. Allowed directions are DESC and ASCExample:
name:DESC
There's no request body for this operation.
Back to TopResponse
Supported Media Types
- application/json
200 Response
List of Privileges returned successfully
Root Schema : PrivilegeCollection
Type:
object
This is the representation of list of Privileges.
Show Source
-
count(required): integer
The number of privilegesExample:
20
-
items(required): array
items
The privilege list
-
links(required):
links
The result set navigation links
Nested Schema : items
Type:
array
The privilege list
Show Source
-
Array of:
object PrivilegeSummary
It represents a Privilege
Nested Schema : links
Type:
object
The result set navigation links
Show Source
-
next: object
Link
A link referencing a REST API.
-
previous: object
Link
A link referencing a REST API.
-
self: object
Link
A link referencing a REST API.
Nested Schema : PrivilegeSummary
Type:
object
It represents a Privilege
Show Source
-
applicableTypes: array
applicableTypes
SecureResource Type for which the privilege is applicable.
-
description: string
Description of PrivilegeExample:
Ability to perform various operations except edit and delete on job
-
displayName: string
Display Name of PrivilegeExample:
Manage
-
includedPrivileges: array
includedPrivileges
Privileges which are already part of this privilege
-
isDefault: boolean
Default privilege when a SecureResource is picked up for a Non-Super AdministratorExample:
true
-
isDefaultToSuperUser: boolean
Default privilege when a SecureResource is picked up for a Super AdministratorExample:
false
-
isGrantedToSuperUser: boolean
Privilege is granted to Super User or notExample:
false
-
name: string
Name of PrivilegeExample:
MANAGE_JOB
-
privilegeRequiredToGrant: string
Privilege required to grant this privilegeExample:
GRANT_VIEW_JOB
-
scope: string
Scope of PrivilegeExample:
Resource
-
secureResourceType: string
SecureResource Type of PrivilegeExample:
JOB
-
secureResourceTypeDescription: string
Description of SecureResource typeExample:
Security class defines the access model behaviour for job
-
secureResourceTypeDisplayName: string
Display Name of SecureResource TypeExample:
Job System
Nested Schema : applicableTypes
Type:
array
SecureResource Type for which the privilege is applicable.
Show Source
-
Array of:
string
Example:
oracle_database
Nested Schema : includedPrivileges
Type:
array
Privileges which are already part of this privilege
Show Source
-
Array of:
string
Example:
VIEW_JOB
401 Response
Unauthorized
Root Schema : ErrorResponse
Type:
object
Response sent back in the case of an error.
Show Source
-
code: string
Status code of the error.Example:
IllegalArgument
-
message: string
A descriptive error message.Example:
argument given is not supported
403 Response
Forbidden
Root Schema : MissingPrivErrorResponse
Type:
object
Response sent back as an Error in case required privileges are missing
Show Source
-
missingPrivileges: array
missingPrivileges
Privileges which are missing due to that the Error is occurred. This will have privilege internal name and display name only in the Privilege object
Match All
Response sent back as an Error in case required privileges are missing
Show Source
-
object
ErrorResponse
Response sent back in the case of an error.
Nested Schema : missingPrivileges
Type:
array
Privileges which are missing due to that the Error is occurred. This will have privilege internal name and display name only in the Privilege object
Show Source
-
Array of:
object MissingPrivilegeSummary
It represents a Privilege which is missing on a Resource to view or manage it.
Nested Schema : ErrorResponse
Type:
object
Response sent back in the case of an error.
Show Source
-
code: string
Status code of the error.Example:
IllegalArgument
-
message: string
A descriptive error message.Example:
argument given is not supported
Nested Schema : MissingPrivilegeSummary
Type:
object
It represents a Privilege which is missing on a Resource to view or manage it.
Show Source
-
displayName: string
Display Name of PrivilegeExample:
Manage
-
name: string
Name of PrivilegeExample:
MANAGE_JOB
500 Response
Internal Server Error
Root Schema : ErrorResponse
Type:
object
Response sent back in the case of an error.
Show Source
-
code: string
Status code of the error.Example:
IllegalArgument
-
message: string
A descriptive error message.Example:
argument given is not supported
503 Response
Service Unavailable
Root Schema : ErrorResponse
Type:
object
Response sent back in the case of an error.
Show Source
-
code: string
Status code of the error.Example:
IllegalArgument
-
message: string
A descriptive error message.Example:
argument given is not supported
Default Response
Unexpected Error
Root Schema : ErrorResponse
Type:
object
Response sent back in the case of an error.
Show Source
-
code: string
Status code of the error.Example:
IllegalArgument
-
message: string
A descriptive error message.Example:
argument given is not supported