REST APIs for Oracle Identity Role Intelligence

List entitlements for a candidate role

post

/oiri/api/v1/tasks/{taskId}/candidate-roles/{candidateRoleId}/entitlements/.search

Request

Path Parameters

candidateRoleId: string
taskId: string

Supported Media Types

application/json

Root Schema : schema

Type: object

Show Source

page(optional): object page
recordCount(optional): integer
searchFilters(optional): string
sort(optional): object sort

{
    "properties":{
        "page":{
            "required":[
                "offset",
                "limit"
            ],
            "properties":{
                "offset":{
                    "type":"number"
                },
                "limit":{
                    "type":"number"
                }
            },
            "type":"object"
        },
        "sort":{
            "required":[
                "sortBy",
                "sortOrder"
            ],
            "properties":{
                "sortBy":{
                    "type":"string"
                },
                "sortOrder":{
                    "type":"string"
                }
            },
            "type":"object"
        },
        "searchFilters":{
            "type":"string"
        },
        "recordCount":{
            "type":"integer"
        }
    }
}

Nested Schema : page

Type: object

Show Source

limit: number
offset: number

{
    "required":[
        "offset",
        "limit"
    ],
    "properties":{
        "offset":{
            "type":"number"
        },
        "limit":{
            "type":"number"
        }
    },
    "type":"object"
}

Nested Schema : sort

Type: object

Show Source

sortBy: string
sortOrder: string

{
    "required":[
        "sortBy",
        "sortOrder"
    ],
    "properties":{
        "sortBy":{
            "type":"string"
        },
        "sortOrder":{
            "type":"string"
        }
    },
    "type":"object"
}

Response

Supported Media Types

application/json

200 Response

Root Schema : CandidateRoleListResponse

Type: object

Show Source

candidateRoles(optional): array candidateRoles
recordCount(optional): integer

{
    "properties":{
        "recordCount":{
            "type":"integer"
        },
        "candidateRoles":{
            "type":"array",
            "items":{
                "$ref":"#/components/schemas/CandidateRoleDTO"
            }
        }
    }
}

Nested Schema : candidateRoles

Type: array

Show Source

Array of: object CandidateRoleDTO

{
    "type":"array",
    "items":{
        "$ref":"#/components/schemas/CandidateRoleDTO"
    }
}

Nested Schema : CandidateRoleDTO

Type: object

Show Source

applicationCount(optional): integer
clusterId(optional): integer
confidence(optional): number
createdBy(optional): string
createdDate(optional): string
description(optional): string
entitlementCount(optional): integer
entitlementCoverage(optional): integer
id(optional): string
jobId(optional): string
lastModifiedDate(optional): string
misAlignedEntitlementCount(optional): integer
misAlignedUserCount(optional): integer
name(optional): string
status(optional): string
totalEntitlementCount(optional): integer
totalUserCount(optional): integer
userCount(optional): integer
userCoverage(optional): integer

{
    "properties":{
        "id":{
            "type":"string"
        },
        "name":{
            "type":"string"
        },
        "description":{
            "type":"string"
        },
        "jobId":{
            "type":"string"
        },
        "clusterId":{
            "type":"integer"
        },
        "status":{
            "type":"string"
        },
        "userCount":{
            "type":"integer"
        },
        "entitlementCount":{
            "type":"integer"
        },
        "applicationCount":{
            "type":"integer"
        },
        "totalUserCount":{
            "type":"integer"
        },
        "totalEntitlementCount":{
            "type":"integer"
        },
        "misAlignedUserCount":{
            "type":"integer"
        },
        "misAlignedEntitlementCount":{
            "type":"integer"
        },
        "userCoverage":{
            "type":"integer"
        },
        "entitlementCoverage":{
            "type":"integer"
        },
        "confidence":{
            "type":"number"
        },
        "createdDate":{
            "type":"string"
        },
        "createdBy":{
            "type":"string"
        },
        "lastModifiedDate":{
            "type":"string"
        }
    }
}

Examples

The following example shows how to list the entitlements for a candidate role.

curl -X POST\
-H "Accept: application/json"\
-H "Content-Type: application/json"\
-H "Authorization: Bearer $token"\
"http://localhost:port/oiri/api/v1/tasks/70561adbfdd7474290b77d5903210c6b/candidate-roles/97d40d053dd74a45a6e944f45cbfae6a/entitlements/.search"

Example of the Response Body

The following is an example of the response body in JSON format.

{
"limit": 10,
"offset": 0,
"recordCount": 5,
"count": 5,
"hasMore": false,
"items": [
{
"entitlementKey": "G141",
"entitlementDisplayName": "CN=adbienta11,OU=grps,OU=robert_bi_test,DC=host123,DC=us,DC=example,DC=com",
"applicationName": "BoKS_QA_latest",
"usage": 83.33,
"misalignedCount": null,
"extEntitlementId": "141"
},
{
"entitlementKey": "G142",
"entitlementDisplayName": "CN=adbienta12,OU=grps,OU=robert_bi_test,DC=host123,DC=us,DC=example,DC=com",
"applicationName": "BoKS_QA_latest",
"usage": 83.33,
"misalignedCount": null,
"extEntitlementId": "142"
},
{
"entitlementKey": "G202",
"entitlementDisplayName": "Guest",
"applicationName": "Orahub",
"usage": 66.67,
"misalignedCount": null,
"extEntitlementId": "202"
},
{
"entitlementKey": "G184",
"entitlementDisplayName": "Toshiba",
"applicationName": "Corp Laptop",
"usage": 83.33,
"misalignedCount": null,
"extEntitlementId": "184"
},
{
"entitlementKey": "G206",
"entitlementDisplayName": "Users",
"applicationName": "JIRA",
"usage": 83.33,
"misalignedCount": null,
"extEntitlementId": "206"
}
]
}