Get an Access Bundle

get

/access-governance/access-controls/20250331/accessBundles/{accessBundleId}

Returns details of an access bundle with a given ID.

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 Bundle for the given id
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 : AccessBundle
Type: object
Access Bundle object.
Show Source
Nested Schema : AccessGuardrailDetails
Type: object
Access Guardrail object.
Show Source
Nested Schema : AccessBundleTimeLimit
Type: object
Time limit definition. Only one of daysLimit, hoursLimit, or dateTimeLimit should be specified.
Show Source
Nested Schema : IdInfo
Type: object
Generic identifying information object.
Show Source
Nested Schema : customAttributes
Type: object
Metadata associated with the access bundle.
Show Source
Nested Schema : OrchestratedSystemAttributeSummary
Type: object
Account & permission attributes.
Show Source
Nested Schema : owners
Type: array
List of owner entities.
Show Source
Nested Schema : permissions
Type: array
List of permissions
Show Source
Nested Schema : tags
Type: array
List of tags attached to the Access Bundle.
Show Source
Nested Schema : AccessBundleTimeLimitDays
Type: object
Time limit definition in days.
Show Source
Nested Schema : AccessBundleTimeLimitHours
Type: object
Time limit definition in hours.
Show Source
Nested Schema : accountAttributes
Type: array
List of Orchestrated System account attributes.
Show Source
Nested Schema : permissionAttributes
Type: array
List of Orchestrated System permission attributes.
Show Source
Nested Schema : OrchestratedSystemAttributeDataSummary
Type: object
Orchestrated System Attributes
Show Source
Nested Schema : children
Type: array
nested attributes
Show Source
Nested Schema : values
Type: array
Attribute Values
Show Source
Nested Schema : NestedAttributesSummary
Type: object
Nested set of Orchestrated System attributes
Show Source
Nested Schema : items
Type: array
Orchestrated System attributes
Show Source
Nested Schema : OwnerSummary
Type: object
Owner entity object
Show Source
Nested Schema : PermissionSummary
Type: object
Description of Permission.
Show Source
Nested Schema : PermissionTypeSummary
Type: object
PermissionType Summary.
Show Source
Nested Schema : ResourceSummary
Type: object
Resource Summary.
Show Source
Nested Schema : customAttributes
Type: object
Metadata associated with the resource
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 Bundle. 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-controls/${version}/accessBundles/${accessBundleID}'

Example of the Response Body

The following example shows the contents of the response body in JSON format, including a list of all available access bundles:

{
  "accessBundleType" : "PERMISSION_BUNDLE",
  "id" : "cbcf4668-4fed-4f70-8692-6xxxxxxxx",
  "name" : "Administer, Management, Sql, Xdbadmin, Wm_Admin_Role ('ag-api-demo-DBUM' system)",
  "displayName" : "Administer, Management, Sql, Xdbadmin, Wm_Admin_Role ('ag-api-demo-DBUM' system)",
  "description" : "Bundle for 'ag-api-demo-DBUM-DBUM' system having key terms: 'Administer, Wm_Admin_Role, Xs_Cache_Admin'",
  "tags" : [ "DBUM"],
  "timeCreated" : "2025-02-24T22:45:02.155Z",
  "timeUpdated" : "2025-03-18T16:20:19.819Z",
  "createdBy" : {
    "id" : "globalId.ICF.Non-Human-Test-Nov02.8xxxxxxxxxxxf4aa551989b7ec",
    "name" : "Abel Maclead",
    "displayName" : "Abel Maclead"
  },
  "updatedBy" : {
    "id" : "globalId.ICF.Non-Human-Test-Nov02.84923636exxxxxxxxxxec",
    "name" : "Abel Maclead",
    "displayName" : "Abel Maclead"
  },
  "requestableBy" : {
    "id" : "ANY",
    "name" : "Anyone",
    "displayName" : "Anyone"
  },
  "status" : "ACTIVE",
  "approvalWorkflowId" : {
    "id" : "NO_APPROVAL_REQUIRED",
    "name" : "No Approval Required",
    "displayName" : "No Approval Required"
  },
  "orchestratedSystem" : {
    "id" : "07cfd352-a6a1-42ae-9409-731cb41a74fc",
    "name" : "ag-api-demo-3-DBUM",
    "displayName" : "ag-api-demo-DBUM-DBUM"
  },
  "orchestratedSystemType" : "ICF",
  "ownershipCollectionId" : "d830b750-cee1-44f1-a5b8-cbxxxxxea6",
  "owners" : [ {
    "id" : "globalId.ICF.Non-Human-Test-Nov02.84923636xxxxxxxxxxxec",
    "name" : "Ama Maclead",
    "isPrimary" : true
  } ],
  "externalId" : "4354203e-910d-4cc8-ab3f-xxxx48023b94",
  "cloudAccountName" : null,
  "domainName" : null,
  "resourceType" : null,
  "compartmentName" : null,
  "compartmentFqn" : null,
  "customAttributes" : { },
  "permissions" : [ {
    "id" : "roles.ICF.ag-api-demo-DBUM-DBUM.d58d0fe8974dd1cb97xxxxxxx",
    "name" : "AUTHENTICATEDUSER",
    "description" : null,
    "type" : "ENTITLEMENTS",
    "timeCreated" : "2024-10-06T07:34:30.633Z",
    "timeUpdated" : null,
    "resource" : {
      "id" : "resource.ICF.ag-api-demo-DBUM-DBUM.7e083f9851db103540xxxxxxxx",
      "name" : "ag-api-demo-DBUM-DBUM",
      "displayName" : "ag-api-demo-DBUM-DBUM",
      "type" : "DBUM",
      "customAttributes" : null
    },
    "permissionType" : {
      "id" : "etype.ICF.ag-api-demo-DBUM-DBUM.6ae3be9a18b9aae2f8baxxxxxx",
      "name" : "icf.connector.entitlement.type.roles",
      "displayName" : "Role",
      "externalId" : "roles"
    }
  }, {
    "id" : "roles.ICF.ag-api-demo-DBUM-DBUM.9690282467b46e171f1c0xxxxxx",
    "name" : "XS_CACHE_ADMIN",
    "description" : null,
    "type" : "ENTITLEMENTS",
    "timeCreated" : "2024-10-06T07:34:29.043Z",
    "timeUpdated" : null,
    "resource" : {
      "id" : "resource.ICF.ag-api-demo-DBUM-DBUM.123456xxxxxxxxxxxxxxxx",
      "name" : "ag-api-demo-DBUM-DBUM",
      "displayName" : "ag-api-demo-DBUM-DBUM",
      "type" : "DBUM",
      "customAttributes" : null
    },
    "permissionType" : {
      "id" : "etype.ICF.ag-api-demo-DBUM-DBUM.6ae3be9a18bxxxxxxxxxxxx",
      "name" : "icf.connector.entitlement.type.roles",
      "displayName" : "Role",
      "externalId" : "roles"
    }
  }, {
    "id" : "roles.ICF.ag-api-demo-DBUM-DBUM.c554da3bb5e17e380affd24bb461d522",
    "name" : "XS_SESSION_ADMIN",
    "description" : null,
    "type" : "ENTITLEMENTS",
    "timeCreated" : "2024-10-06T07:34:29.042Z",
    "timeUpdated" : null,
    "resource" : {
      "id" : "resource.ICF.ag-api-demo-DBUM-DBUM.7e083f9851db1035408a877c654d28bd",
      "name" : "ag-api-demo-DBUM-DBUM",
      "displayName" : "ag-api-demo-DBUM-DBUM",
      "type" : "DBUM",
      "customAttributes" : null
    },
    "permissionType" : {
      "id" : "etype.ICF.ag-api-demo-DBUM-DBUM.6ae3be9a18b9aae2f8ba02e7f8908eaf",
      "name" : "icf.connector.entitlement.type.roles",
      "displayName" : "Role",
      "externalId" : "roles"
    }
  }, {
    "id" : "roles.ICF.ag-api-demo-DBUM-DBUM.af0048cc3156c0d61bb4dd704d5a3502",
    "name" : "WM_ADMIN_ROLE",
    "description" : null,
    "type" : "ENTITLEMENTS",
    "timeCreated" : "2024-10-06T07:34:30.634Z",
    "timeUpdated" : null,
    "resource" : {
      "id" : "resource.ICF.ag-api-demo-DBUM-DBUM.7e083f9851db1035408a877c654d28bd",
      "name" : "ag-api-demo-DBUM-DBUM",
      "displayName" : "ag-api-demo-DBUM-DBUM",
      "type" : "DBUM",
      "customAttributes" : null
    },
    "permissionType" : {
      "id" : "etype.ICF.ag-api-demo-DBUM.6ae3be9a18b9aae2f8ba02e7f8908eaf",
      "name" : "icf.connector.entitlement.type.roles",
      "displayName" : "Role",
      "externalId" : "roles"
    }
  }, {
    "id" : "privileges.ICF.ag-api-demo-DBUM-DBUM.34ac64704d5894a58xxxxxxxx",
    "name" : "CREATE USER",
    "description" : null,
    "type" : "ENTITLEMENTS",
    "timeCreated" : "2024-10-06T07:34:29.080Z",
    "timeUpdated" : null,
    "resource" : {
      "id" : "resource.ICF.ag-api-demo-DBUM.7e083f9851db103xxxxxxxxx",
      "name" : "ag-api-demo-DBUM",
      "displayName" : "ag-api-demo-DBUM",
      "type" : "DBUM",
      "customAttributes" : null
    },
    "permissionType" : {
      "id" : "etype.ICF.ag-api-demo-DBUM.d1ecb6a39a6fd079c76bxxxxxxxx",
      "name" : "icf.connector.entitlement.type.privileges",
      "displayName" : "Privilege",
      "externalId" : "privileges"
    }
  }
  } ]
}
Back to Top