Jump to

• Request
• Response
• Examples

Get Role Mining task details with taskId

get

/oiri/api/v1/tasks/{taskId}

Retrieve the Role Mining tasks details with taskId.

Request

Path Parameters

• taskId: string

There's no request body for this operation.

Back to Top

Response

Supported Media Types

• application/json

200 Response

OK

Body ()

Root Schema : JobDetails

Type: object

Show Source

• createdBy(optional): string
• createdDate(optional): string
• description(optional): string
• finishedData(optional): string
• id(optional): string
• input(optional): object input
• lastUpdatedDate(optional): string
• message(optional): string
• name(optional): string
• output(optional): string
• sourceId(optional): string
• sourceName(optional): string
• startedDate(optional): string
• status(optional): string
• type(optional): string

{
    "properties":{
        "id":{
            "type":"string"
        },
        "sourceId":{
            "type":"string"
        },
        "sourceName":{
            "type":"string"
        },
        "name":{
            "type":"string"
        },
        "description":{
            "type":"string"
        },
        "type":{
            "type":"string"
        },
        "status":{
            "type":"string"
        },
        "message":{
            "type":"string"
        },
        "createdDate":{
            "type":"string"
        },
        "createdBy":{
            "type":"string"
        },
        "lastUpdatedDate":{
            "type":"string"
        },
        "startedDate":{
            "type":"string"
        },
        "finishedData":{
            "type":"string"
        },
        "input":{
            "properties":{
                "name":{
                    "type":"string"
                },
                "description":{
                    "type":"string"
                },
                "candidateRolePrefix":{
                    "type":"string"
                },
                "criteria":{
                    "type":"array",
                    "items":{
                        "$ref":"#/components/schemas/Criteria"
                    }
                },
                "candidateRoleCountIndicator":{
                    "type":"integer"
                }
            },
            "type":"object"
        },
        "output":{
            "type":"string"
        }
    }
}

Nested Schema : input

Type: object

Show Source

• candidateRoleCountIndicator(optional): integer
• candidateRolePrefix(optional): string
• criteria(optional): array criteria
• description(optional): string
• name(optional): string

{
    "properties":{
        "name":{
            "type":"string"
        },
        "description":{
            "type":"string"
        },
        "candidateRolePrefix":{
            "type":"string"
        },
        "criteria":{
            "type":"array",
            "items":{
                "$ref":"#/components/schemas/Criteria"
            }
        },
        "candidateRoleCountIndicator":{
            "type":"integer"
        }
    },
    "type":"object"
}

Nested Schema : criteria

Type: array

Show Source

• Array of: object Criteria

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

Nested Schema : Criteria

Type: object

Show Source

• filter(optional): string
• type(optional): string

{
    "properties":{
        "type":{
            "type":"string"
        },
        "filter":{
            "type":"string"
        }
    }
}

Back to Top

Examples

The following example shows how to retrieve role mining task by task ID.

curl -X GET\
-H "Accept: application/json"\
-H "Authorization: Bearer $token"\
"http://localhost:port/oiri/api/v1/tasks/2"

Example of the Response Body

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

{
"id": "2",
"sourceId": null,
"sourceName": null,
"name": "SampleTask2",
"description": "SampleTask2 desc",
"type": "ROLE_MINING",
"status": "CREATED",
"message": null,
"createdDate": "2021-04-22T07:12:31.436679Z",
"createdBy": "RFROST",
"lastUpdatedDate": "2021-04-22T07:12:31.436679Z",
"startedDate": null,
"finishedData": null,
"input": {
"name": "SampleTask2",
"description": "SampleTask2 desc",
"candidateRolePrefix": "cr",
"criteria": [
{
"type": "user",
"filter": "organization in (\"VisCertOrg\")"
}
],
"candidateRoleCountIndicator": 3
},
"output": null
}

Back to Top