REST API for Oracle Identity Governance Self Service

  1. REST API for Oracle Identity Governance Self Service
  2. Tasks
  3. AdminRole

Get Admin Role Based on Admin Role ID

get

/iam/governance/selfservice/api/v1/adminroles/{adminroleid}

Returns the admin role details of the specified admin role id. The attributes that are to be returned can be specified as part of the query parameter named "fields". For example: The URI to get the name and description attributes only for a particular admin role is /adminroles/{adminroleid}?fields=displayName, description. The attributes are to be specified in a Comma-separated list.

Request

Supported Media Types
  • application/json
Path Parameters
Query Parameters
  • Attributes to be returned in the result. Comma-separated attributes are accepted. Sample value for supported attributes is "ROLE_ID, ROLE_NAME, ROLE_DISPLAY_NAME, DESCRIPTION and CUSTOM"
Back to Top

Response

Supported Media Types
  • application/json

200 Response

Successful
Headers
Body (
  1. AdminRole
)
Root Schema : AdminRole
Type: object
Show Source
  • custom: string
  • delayedEvaluationSet: string
  • description: string
  • displayName: string
  • id: string
  • links: array links
  • name: string
  • scoped: string
Nested Schema : LinkDataInstances
Type: object
Show Source
  • href: string
  • rel: string

401 Response

Unauthorized

404 Response

Requested entity not found

500 Response

Internal Server Error
Back to Top

Examples

This example retrieves the information for a given admin role. The information shown here is against a pseudo system and serves as a prototype.

cuRL Example

curl  -H "Content-Type: application/json"  -X GET  -u username:password  https://pseudo.com/iam/governance/selfservice/api/v1/adminroles/12

Example of GET Response Body

The following example shows the contents of the response body in JSON format.

{
  "links": [
    {
      "rel": "self",
      "href": "http://pseudo.com/iam/governance/selfservice/api/v1/adminroles/12"
    }
  ],
  "id": "12",
  "name": "OrclOIMApplicationInstanceViewerRole",
  "description": "Role can view assigned application instances.",
  "displayName": "Application Instance Viewer",
  "delayedEvaluationSet": true,
  "scoped": true,
  "custom": false
}
Back to Top