REST API for Oracle Identity Governance Self Service

Return the specified certification task details.

get

/iam/governance/selfservice/api/v1/certifications/{certid}/tasks/{taskid}

Returns the specified certification task details.

Request

Supported Media Types

application/json

Path Parameters

certid: string

Certification ID
taskid: string

Certification Tasks ID

Response

Supported Media Types

application/json

200 Response

Successful

Headers

ResponseTime: string

Captures the time in milliseconds taken for processing the request.

Root Schema : SingleCertTaskDetails

Type: object

Show Source

certificateInstance(optional): object CertificationInstance
comment(optional): string
reviewer(optional): object TaskReviewer
startDate(optional): string
status(optional): string
taskName(optional): string

{
    "properties":{
        "certificateInstance":{
            "$ref":"#/definitions/CertificationInstance"
        },
        "taskName":{
            "type":"string"
        },
        "status":{
            "type":"string"
        },
        "reviewer":{
            "$ref":"#/definitions/TaskReviewer"
        },
        "startDate":{
            "type":"string"
        },
        "comment":{
            "type":"string"
        }
    }
}

Nested Schema : CertificationInstance

Type: object

Show Source

id(optional): string
links(optional): array links

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

Nested Schema : TaskReviewer

Type: object

Show Source

links(optional): array links
reviewerId(optional): string

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

Nested Schema : links

Type: array

Show Source

[0]: object LinkDataInstances

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

Nested Schema : LinkDataInstances

Type: object

Show Source

href(optional): string
rel(optional): string

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

Nested Schema : links

Type: array

Show Source

[0]: object LinkDataInstances

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

401 Response

Unauthorized

404 Response

Requested entity not found

500 Response

Internal Server Error

Default Response

Unexpected error

Examples

This example retrieves the information for a given task for a given certification. 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/certifications/91/tasks/91/tasks/1b160469-3efc-4c9f-aead-4440e8cabe7e

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/certifications/91/tasks/1b160469-3efc-4c9f-aead-4440e8cabe7e"
    }
  ],
  "taskId": "1b160469-3efc-4c9f-aead-4440e8cabe7e",
  "taskName": "entitlement_cert_user [ System Administrator ] ",
  "reviewer": {
    "links": [
      {
        "rel": "reviewer",
        "href": "http://pseudo.com/iam/governance/selfservice/api/v1/users/1"
      }
    ],
    "id": "1",
    "displayName": "System Administrator"
  },
  "status": 1,
  "certificationInstance": {
    "id": "91"
  },
  "startDate": 1461156004321,
  "certificationState": "11",
  "certLineItems": {
    "links": [
      {
        "rel": "self",
        "href": "http://pseudo.com/iam/governance/selfservice/api/v1/certifications/91/tasks/1b160469-3efc-4c9f-aead-4440e8cabe7e/lineitems"
      }
    ],
    "certLineItemList": [
      {
        "links": [
          {
            "rel": "self",
            "href": "http://pseudo.com/iam/governance/selfservice/api/v1/certifications/91/tasks/1b160469-3efc-4c9f-aead-4440e8cabe7e/lineitems/16"
          }
        ],
        "entityId": 16
      },
      {
        "links": [
          {
            "rel": "self",
            "href": "http://pseudo.com/iam/governance/selfservice/api/v1/certifications/91/tasks/1b160469-3efc-4c9f-aead-4440e8cabe7e/lineitems/15"
          }
        ],
        "entityId": 15
      }
    ]
  }
}