Files
api-specs/idn/beta/paths/role-mining-session.yaml
2022-09-02 10:59:29 -04:00

107 lines
2.9 KiB
YAML

patch:
operationId: patchRoleMiningSession
summary: Patch a role mining session
tags:
- IAI Role Mining
description: >-
The method updates an existing role mining session using PATCH. Supports op in {"replace"} and changes to
pruneThreshold and/or minNumIdentitiesInPotentialRole. The potential roles in this role mining session is then
re-calculated.
parameters:
- in: path
name: sessionId
schema:
type: string
required: true
description: The role mining session id to be patched
example: 8c190e67-87aa-4ed9-a90b-d9d5344523fb
requestBody:
required: true
description: Replace pruneThreshold and/or minNumIdentitiesInPotentialRole in role mining session. Update saved status or saved name for a role mining session.
content:
application/json-patch+json:
schema:
type: array
items:
$ref: '../schemas/JsonPatchOperation.yaml'
example:
[
{
"op": "replace",
"path": "/pruneThreshold",
"value": "83"
},
{
"op": "replace",
"path": "/minNumIdentitiesInPotentialRole",
"value": "10"
},
{
"op": "replace",
"path": "/saved",
"value": "false"
},
{
"op": "replace",
"path": "/name",
"value": "RM Session - 07/10/22"
},
{
"op": "add",
"path": "/name",
"value": "RM Session - 07/10/22"
}
]
responses:
"202":
description: Success
$ref: '../../v3/responses/202.yaml'
"400":
$ref: '../../v3/responses/400.yaml'
"401":
$ref: '../../v3/responses/401.yaml'
"403":
$ref: '../../v3/responses/403.yaml'
"404":
$ref: '../../v3/responses/404.yaml'
"429":
$ref: '../../v3/responses/429.yaml'
"500":
$ref: '../../v3/responses/500.yaml'
get:
operationId: getRoleMiningSession
summary: Get a role mining session
tags:
- IAI Role Mining
description: >-
The method retrieves a role mining session.
parameters:
- in: path
name: sessionId
schema:
type: string
required: true
description: The role mining session id to be retrieved.
example: 8c190e67-87aa-4ed9-a90b-d9d5344523fb
responses:
"200":
description: Returns a role mining session
content:
application/json:
schema:
$ref: '../schemas/RoleMiningSessionResponse.yaml'
"400":
$ref: '../../v3/responses/400.yaml'
"401":
$ref: '../../v3/responses/400.yaml'
"403":
$ref: '../../v3/responses/403.yaml'
"404":
$ref: '../../v3/responses/404.yaml'
"429":
$ref: '../../v3/responses/429.yaml'
"500":
$ref: '../../v3/responses/500.yaml'