Get an Account

get

/access-governance/identities/20250331/identities/{identityId}/accounts/{accountId}

Gets an Account by identifier.

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

Retrieves the Account for the given Account 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 : AccessGovernanceEntity
Type: object
An Access Governance Entity
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

409 Response

Conflict
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 identity account details including account attributes. Use orchestratedSystemIdentityId as the account ID.

cURL Example GET

curl -i -X \
 GET \
 -H \
 "Authorization:Bearer <your access token>" \
 '${service-instance-url}/access-governance/identities/${versionId}/identities/${IdentityId}/accounts/${accountID}'

Example of the Response Code

You'll receive a 200 OK Response Code with the following Response body:

{
  "id": "targetId.account.ICF.da7efca4-xxxx-4d4f-8ad3-c55ac9362de6.a285ce40190faf23401a9e2c3f35682c",
  "type": "ACCOUNT",
  "name": "Bill Clark",
  "timeCreated": "2024-11-08T11:22:55.789Z",
  "timeUpdated": "2024-11-08T11:22:55.789Z",
  "entityType": "ACCOUNT",
  "typeDetails": "https://database-access-management.api.access-governance.oci.oc-test.com/access-governance/identities/20250331/types/agcs.Account?orchestratedSystemId=da7efca4-xxxx-4d4f-8ad3-c55ac9362de6",
  "attributes": [
    {
      "name": "resourceName",
      "value": "Database Access Management"
    },
    {
      "name": "resourceTypeName",
      "value": "DBUM"
    },
    {
      "name": "connectedSystem",
      "value": "Database Access Management"
    },
    {
      "name": "targetType",
      "value": "ICF"
    },
    {
      "name": "targetId",
      "value": "da7efca4-xxxx-4d4f-8ad3-c55ac9362de6"
    }
  ],
  "value": "{\n  \"targetId\": \"da7efca4-xxxx-4d4f-8ad3-c55ac9362de6\",\n  \"identityGlobalId\": \"globalId.125123c3-xxxx-4d6a-b6d4-6c0f6537bad2.55045.02e36bbb4b201421b44aa046b3ceb16a\",\n  \"resourcesId\": \"resource.ICF.da7efca4-xxxx-4d4f-8ad3-c55ac9362de6.153c14344ccda28d2c2106cc5b5a8e4d\",\n  \"identityAccountType\": \"ACCOUNT\",\n  \"name\": \"Bill Clark\",\n  \"status\": \"true\",\n  \"riskSummary\": 0,\n  \"userLogin\": \"Bill Clark\",\n  \"customAttributes\": {\n    \"operationType\": \"CREATE_OR_UPDATE\",\n    \"authenticationType\": \"EXTERNAL\",\n    \"globalDN\": \"cn\\\\u003dBILLCLARK,cn\\\\u003dadmin,dc\\\\u003dcorp,dc\\\\u003dCOM\",\n    \"defaultTablespace\": \"USERS\",\n    \"temporaryTablespace\": \"TEMP\",\n    \"profileName\": \"DEFAULT\",\n    \"accountStatus\": \"OPEN\",\n    \"roles\": [\n      { \"element\": { \"UID\": \"DV_OWNER\", \"roleAdminOption\": \"NO\" } },\n      { \"element\": { \"UID\": \"DV_GOLDENGATE_REDO_ACCESS\", \"roleAdminOption\": \"NO\" } }\n    ]\n  },\n  \"id\": \"targetId.account.ICF.da7efca4-xxxx-4d4f-8ad3-c55ac9362de6.a285ce40190faf23401a9e2c3f35682c\",\n  \"externalId\": \"Bill Clark\",\n  \"schemas\": [],\n  \"meta\": {\n    \"resourceType\": \"ACCOUNT\",\n    \"created\": 1731064975789,\n    \"lastModified\": 1731064975789,\n    \"version\": \"1\",\n    \"location\": \"\"\n  }\n}"
}
  
Back to Top