1. Oracle Access Governance REST APIs
  2. Tasks
  3. AccessReviews

Get details of an access review

get

/access-governance/access-reviews/20250331/accessReviews/{accessReviewId}

Returns details of the access review for a given accessReviewId.

Request

Path Parameters
Header Parameters
  • The client request ID for tracing. The only valid characters for request IDs are letters, numbers, underscore, and dash.
Back to Top

Response

Supported Media Types

200 Response

The access review.
Headers
  • For optimistic concurrency control. See `if-match`.
  • Unique Oracle-assigned identifier for the request. If you need to contact Oracle about a particular request, please provide the request ID.
Body ()
Root Schema : AccessReview
Type: object
The access review task.
Show Source
Nested Schema : AdditionalAttributes
Type: object
Additional attributes.
Show Source
Nested Schema : assignmentAttributes
Type: array
The attributes of the assignment.
Show Source
Nested Schema : entityAttributes
Type: array
The attributes of the entity.
Show Source
Nested Schema : EscalationDetails
Type: object
escalation details object.
Show Source
Nested Schema : AssignmentAttribute
Type: object
The assignment attribute.
Show Source
  • Allowed Values: [ "PERMISSIONS", "ROLES", "RESOURCES", "POLICY_COUNT", "ROLE_COUNT", "PERMISSION_TYPE", "GRANTED_PERMISSION_TYPE", "OWNERSHIP_COLLECTION_ID" ]
    The type of the assignment attribute.
  • values
    The value of the assignment attribute.
Nested Schema : values
Type: array
The value of the assignment attribute.
Show Source
Nested Schema : ValueDetail
Type: object
The assignment attribute.
Show Source
Nested Schema : EntityAttribute
Type: object
The entity attribute.
Show Source
  • The display name of the entity attribute.
  • The format for date custom attribute, null for others.
  • Is the attribute custom attribute or not.
  • The name of the entity attribute.
  • Allowed Values: [ "TENANCY_NAME", "COMPARTMENT_NAME", "COMPARTMENT_FULL_NAME", "CREATED_BY", "PRIMARY_OWNER", "CREATED_ON", "DOMAIN_NAME", "SHARED_WITH_ORCHESTRATED_SYSTEM", "FIRST_NAME", "LAST_NAME", "ORCHESTRATED_SYSTEM_ID", "ORCHESTRATED_SYSTEM_NAME", "ORPHAN_INSIGHT", "IDENTITY_ATTRIBUTE", "ORCHESTRATED_SYSTEM_TYPE", "ORCHESTRATED_SYSTEM_MODE" ]
    The type of the entity attribute.
  • values
    The list of entity attribute values.
Nested Schema : values
Type: array
The list of entity attribute values.
Show Source

400 Response

Bad Request
Headers
  • Unique Oracle-assigned identifier for the request. If you need to contact Oracle about a particular request, please provide the request ID.
Body ()
Root Schema : Error
Type: object
Error Information.
Show Source

401 Response

Unauthorized
Headers
  • Unique Oracle-assigned identifier for the request. If you need to contact Oracle about a particular request, please provide the request ID.
Body ()
Root Schema : Error
Type: object
Error Information.
Show Source

404 Response

Not Found
Headers
  • Unique Oracle-assigned identifier for the request. If you need to contact Oracle about a particular request, please provide the request ID.
Body ()
Root Schema : Error
Type: object
Error Information.
Show Source

429 Response

Too Many Requests
Headers
  • Unique Oracle-assigned identifier for the request. If you need to contact Oracle about a particular request, please provide the request ID.
Body ()
Root Schema : Error
Type: object
Error Information.
Show Source

500 Response

Internal Server Error
Headers
  • Unique Oracle-assigned identifier for the request. If you need to contact Oracle about a particular request, please provide the request ID.
Body ()
Root Schema : Error
Type: object
Error Information.
Show Source

Default Response

Unknown Error
Headers
  • Unique Oracle-assigned identifier for the request. If you need to contact Oracle about a particular request, please provide the request ID.
Body ()
Root Schema : Error
Type: object
Error Information.
Show Source
Back to Top

Examples

The following example shows how to retrieve a details for a specific access review task. Replace placeholder values with actual values before running the sample command.

cURL Example - Without Query Parameters

curl -i -X GET \
   -H "Authorization:Bearer <your access token>" \
 '${service-instance-url}/access-governance/access-reviews/${version}/accessReviews/${accessReviewId}'

Example of the Response Body

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

{
  "id": "ocid1.agcsreviewtask.oc1.iad.amaxxaaapzw5rdxxgmvpxxqbljwzv4rhmihoxro33shataodffzkn7nx2wr2a",
  "entityName": "Jordan Pierce",
  "entityType": "USER",
  "entityAttributes": [
    {
      "type": "IDENTITY_ATTRIBUTE",
      "values": [
        "resource.OCI.f10xxf64-7c18-42de-a146-f55c8c363xxx.5d8f1ba6c8cd8a851e469fc65bc74f53"
      ],
      "name": "compartmentId",
      "displayName": "Compartment ID",
      "format": null,
      "isCustom": false
    },
    {
      "type": "IDENTITY_ATTRIBUTE",
      "values": [
        "false"
      ],
      "name": "agDelegation.hasDelegations",
      "displayName": "Delegation",
      "format": null,
      "isCustom": false
    },
    {
      "type": "IDENTITY_ATTRIBUTE",
      "values": [
        "resource.OCI.f10xxf64-7c18-42de-a146-f55c8c363xxx.ef9e00dc885c34b5390ee1e8bf65d933"
      ],
      "name": "domainId",
      "displayName": "Domain ID",
      "format": null,
      "isCustom": false
    },
    {
      "type": "IDENTITY_ATTRIBUTE",
      "values": [
        "ocid1.domain.oc1..aaaaaxxxyrdl7hgnjeqbpi4nvt72hxtki4uw7o5zif4j3zfh7zpfc6truzoq"
      ],
      "name": "domainOCID",
      "displayName": "Domain OCID",
      "format": null,
      "isCustom": false
    },
    {
      "type": "IDENTITY_ATTRIBUTE",
      "values": [
        "jordan.pierce@acmecloud.io"
      ],
      "name": "primaryEmail",
      "displayName": "Email",
      "format": null,
      "isCustom": false
    },
    {
      "type": "PRIMARY_OWNER",
      "values": [
        null
      ],
      "name": "PrimaryOwner",
      "displayName": "Primary owner",
      "format": null,
      "isCustom": false
    },
    {
      "type": "IDENTITY_ATTRIBUTE",
      "values": [
        "iad:us-ashburn-1"
      ],
      "name": "region",
      "displayName": "Region",
      "format": null,
      "isCustom": false
    }
  ],
  "assignmentId": "376a72xx-e735-4949-b406-f941f0cfxxxx",
  "assignmentName": "InfraAuditRole_Prod",
  "assignmentType": "ROLE",
  "assignmentDescription": "Access role for auditing infrastructure resources",
  "assignmentAttributes": [
    {
      "type": "PERMISSIONS",
      "values": [
        {
          "id": "e350xxxx-3bcd-4dbe-89d6-e0748435xxxx",
          "name": "ViewCompartmentUsage"
        },
        {
          "id": "1c57xxxx-f45e-4225-9cd5-f190b73axxxx",
          "name": "ManageIAMPolicies"
        },
        {
          "id": "a773xxxx-a71c-4719-95b9-cb79212exxxx",
          "name": "AuditDataFlow"
        },
        {
          "id": "e2fexxxx-c65e-4100-98be-1e8999b4xxxx",
          "name": "FullLogAnalyticsAccess"
        }
      ]
    }
  ],
  "recommendation": "REVIEW",
  "campaignName": "InfraOps_EntitlementReview Q2 FY26",
  "daysRemaining": 3624,
  "accountType": "SERVICE",
  "timeGranted": "2024-10-25T03:31:00.000Z",
  "grantType": "REQUEST",
  "level": 1,
  "justificationRule": "REQUIRE_FOR_ALL",
  "templateType": "AG",
  "campaignType": "ACCESS",
  "delegatedBy": null,
  "delegatedTo": null,
  "hasSupportStatement": false,
  "escalatedBy": null,
  "escalatedTo": null,
  "isReassignable": true,
  "reassignedBy": null,
  "additionalAttributes": null
}
Back to Top