REST API for Oracle Identity Governance Self Service

Update Policy Violation Tasks

put

/iam/governance/selfservice/api/v1/policyviolations/{pvid}/causes

Updates the policy violation task by either assigning to another user or taking an action on the task.

Request

Supported Media Types

application/json

Path Parameters

pvid(required): string

Policy violation ID

Root Schema : PolicyViolationTasksPUT

Type: object

Show Source

policyviolationcause: array policyviolationcause

{
    "properties":{
        "policyviolationcause":{
            "type":"array",
            "items":{
                "$ref":"#/definitions/PolicyViolationTaskPUT"
            }
        }
    }
}

Nested Schema : policyviolationcause

Type: array

Show Source

Array of: object PolicyViolationTaskPUT

{
    "type":"array",
    "items":{
        "$ref":"#/definitions/PolicyViolationTaskPUT"
    }
}

Nested Schema : PolicyViolationTaskPUT

Type: object

Show Source

action: string
causeId: string
comment: string
requestId: string
riskAcceptedExpirationDate : string

{
    "properties":{
        "requestId":{
            "type":"string"
        },
        "causeId":{
            "type":"string"
        },
        "action":{
            "type":"string"
        },
        "riskAcceptedExpirationDate ":{
            "type":"string"
        },
        "comment":{
            "type":"string"
        }
    }
}

Response

Supported Media Types

application/json

200 Response

Successful

Headers

ResponseTime: string

Captures the time in milliseconds taken for processing the request.

Root Schema : PolicyViolationTasksPUTResponse

Type: object

Show Source

policyVoilationsResponse: array policyVoilationsResponse

{
    "properties":{
        "policyVoilationsResponse":{
            "type":"array",
            "items":{
                "$ref":"#/definitions/PolicyViolationTaskSinglePUTResponse"
            }
        }
    }
}

Nested Schema : policyVoilationsResponse

Type: array

Show Source

Array of: object PolicyViolationTaskSinglePUTResponse

{
    "type":"array",
    "items":{
        "$ref":"#/definitions/PolicyViolationTaskSinglePUTResponse"
    }
}

Nested Schema : PolicyViolationTaskSinglePUTResponse

Type: object

Show Source

links: array links
reason: string
requestId: string
status: string

{
    "properties":{
        "requestId":{
            "type":"string"
        },
        "reason":{
            "type":"string"
        },
        "status":{
            "type":"string"
        },
        "links":{
            "type":"array",
            "items":{
                "$ref":"#/definitions/LinkDataInstances"
            }
        }
    }
}

Nested Schema : links

Type: array

Show Source

Array of: object LinkDataInstances

{
    "type":"array",
    "items":{
        "$ref":"#/definitions/LinkDataInstances"
    }
}

Nested Schema : LinkDataInstances

Type: object

Show Source

href: string
rel: string

{
    "properties":{
        "rel":{
            "type":"string"
        },
        "href":{
            "type":"string"
        }
    }
}

401 Response

Unauthorized

403 Response

Forbidden

404 Response

Resource not found

500 Response

Internal Server Error

Default Response

Unexpected error

Examples

This example demonstrates the ability to update policy violations causes for a given policy violation task in a single request. The information shown here is against a pseudo system and serves as a prototype.

cURL Example

curl  -H "Content-Type: application/json"  -H "X-Requested-By: <anyvalue>"  -X PUT  -u 
username:password  -d @put.json 
https://pseudo.com/iam/governance/selfservice/api/v1/policyviolations/1CBEF68E0BCC413D81ADA2EE1F
6CFC75/causes

Example of PUT Request Body

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

{
  "policyviolationcause": [
    {
      "requestId": "123",
      "causeId": "7DBE8AB5D3D1493CB6022351E37A8492",
      "action": "FIXED_MANUALLY",
      "comment": "manually fix issue"
    }
  ]
}

Example of PUT Response Body

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

{
    "links": [
        {
            "rel": "self",
            "href": "http://pseudo.com:PORT/iam/governance/selfservice/api/v1/policyviolations/1CBEF68E
0BCC413D81ADA2EE1F6CFC75/causes"
        }
    ],
    "policyVoilationsResponse": [
        {
            "links": [
                {
                    "rel": "self",
                    "href": "http://pseudo.com:PORT/iam/governance/selfservice/api/v1/policyviolations/1CBEF68E
0BCC413D81ADA2EE1F6CFC75/causes/7DBE8AB5D3D1493CB6022351E37A8492"
                }
            ],
            "requestId": "123",
            "causeId": "7DBE8AB5D3D1493CB6022351E37A8492",
            "status": "SUCCESS"
        }
    ]
}