Get an Orchestrated System
get
/access-governance/service-administration/20250331/orchestratedSystems/{orchestratedSystemId}
Returns details of an orchestrated system with a given ID.
Request
Path Parameters
-
orchestratedSystemId(required): string
The unique id for an Orchestrated System. Available values can be found using the ListOrchestratedSystems operation.
Header Parameters
-
opc-request-id: string
The client request ID for tracing. The only valid characters for request IDs are letters, numbers, underscore, and dash.
Response
Supported Media Types
- application/json
200 Response
Retrieves the Orchestrated System for the given id
Headers
-
opc-request-id: string
Unique Oracle-assigned identifier for the request. If you need to contact Oracle about a particular request, please provide the request ID.
Root Schema : OrchestratedSystem
Type:
objectSummary of the Orchestrated System.
Show Source
-
aggregatedOrchestratedSystemStatus:
object AggregatedOrchestratedSystemStatus
Status of the Orchestrated System.
-
category:
string
Allowed Values:
[ "GOVERNANCE_SYSTEM", "CLOUD_SERVICE_PROVIDER", "DIRECTORY_INTEGRATIONS", "DATABASE_MANAGEMENT", "SAAS_APPLICATIONS", "ORACLE_APPLICATIONS", "EXPRESS" ]Possible category of a Template. -
compartments:
object CompartmentCollection
List of compartment
-
createdBy:
string
Minimum Length:
0Maximum Length:255A user identifier that created the Orchestrated System. -
displayName:
string
Orchestrated System Identifier, can be renamed.
-
domains:
object DomainCollection
List of values (domains for OCI).
-
id(required):
string
Unique identifier that is immutable on creation.
-
lastModifiedBy:
string
Minimum Length:
0Maximum Length:255A user identifier that last modified the Orchestrated System. -
lifecycleState(required):
string
Allowed Values:
[ "ACTIVE", "INACTIVE" ]The current state of the Orchestrated System. -
metaData:
object OrchestratedSystemMetaData
Orchestrated System metadata.
-
mode:
string
Allowed Values:
[ "AUTHORITATIVE", "NONAUTHORITATIVE", "BOTH", "NONE" ]Mode of the Orchestrated System. It can support AUTHORITATIVE, NONAUTHORITATIVE or BOTH -
name:
string
A user-friendly Name provided while creation
-
primaryOwner:
object User
Owner of a resource.
-
timeCreated:
string(date-time)
The time the Orchestrated System was created. An RFC3339 formatted datetime string.
-
timeLastModified:
string(date-time)
The time the the Orchestrated System was last modified. An RFC3339 formatted datetime string.
-
type(required):
string
Allowed Values:
[ "OIG", "OCI", "AZUREAD", "DBUMORADB", "SALESFORCE", "SERVICENOW", "EBSUM", "EBSHRMS", "FA", "MSFTAD", "OID", "OUD", "DBUMMYSQL", "DBUMDB2", "MSTEAMS", "ELOQUA", "NETSUITE", "DBUMMSSQL", "EXPRESSFLATFILE", "GRC", "SIEBELUM", "PRIMAVERA", "PEOPLESOFT", "DBATORACLE", "ARCONPAM", "CERNERMILLENNIUM", "DBATMYSQL", "DBATMSSQL", "CERNERHI", "ZOOM", "JIRA", "WORKDAY", "SAPARIBA", "SUCCESSFACTORS", "SAPS4HANA", "SAPFIELDGLASS", "BEYONDTRUST", "ORACLEEPM", "SAPUM", "DBUMPOSTGRESQL", "AWS", "GOTOMEETING", "ORACLEAPEX", "ORACLECPQ", "ORACLEUNITY", "ORACLEOTMGTM", "ORACLEINFINITY", "WEBEX", "FALEARNING" ]Possible type for the Orchestrated System.
Nested Schema : AggregatedOrchestratedSystemStatus
Type:
objectStatus of the Orchestrated System.
Show Source
-
aggregatedStatus:
string
Allowed Values:
[ "ACTIVE", "DISABLED", "AGENT_NEVER_CONNECTED", "AGENT_DISCONNECTED", "AGENT_VERSION_MISMATCH", "TARGET_CONNECTION_FAILED", "DATA_LOAD_INPROGRESS", "DATA_LOAD_FAILED", "INGESTION_IN_PROGRESS", "INGESTION_FAILED", "LAST_LOAD_SUCCESS", "DATA_PROCESSING_IN_PROGRESS", "DATA_PROCESSING_FAILED", "DRAFT" ]Aggregated status of the Orchestrated System.Example:DATA_LOAD_INPROGRESS -
connectionStatus:
object ConnectionStatus
Status of the agent connection
-
dataLoadStatus(required):
object DataLoadStatus
Status of the data load
Nested Schema : CompartmentCollection
Type:
objectList of compartment
Show Source
-
items(required):
array items
List of compartment summaries
Nested Schema : DomainCollection
Type:
objectList of values (domains for OCI).
Show Source
-
items(required):
array items
List of values.
Nested Schema : OrchestratedSystemMetaData
Type:
objectOrchestrated System metadata.
Show Source
-
accountUpdateEmailReceiver:
string
Allowed Values:
[ "USER", "USER_MANAGER", "BOTH", "NONE" ]Email notification receiver for account update. -
canAgCreateNewAccounts:
boolean
Determines whether Access Governance is allowed to create new accounts.Example:
true -
canBeAuthoritative(required):
boolean
Orchestrated System can support Authoritative Entities.Example:
true -
canBeOrchestratedSystem(required):
boolean
Orchestrated System can support Orchestrated System Entities.Example:
true -
canManageNonAgCreatedAccounts:
boolean
Specifies whether it can manage accounts that were not created by Access Governance.Example:
false -
category(required):
string
Possible category of a Template.
-
isIdentityCollectionSupported(required):
boolean
Orchestrated System can support identity collection.Example:
true -
isNonHumanIdentitySupported(required):
boolean
Orchestrated System can support non-human identity.Example:
true -
isOnpremAgentSupported(required):
boolean
Is on-prem agent supported.Example:
true -
isSchemaDiscoverySupported(required):
boolean
Orchestrated System can support schema discovery.Example:
true -
isSeparationOfDutiesSupported(required):
boolean
Orchestrated System can support Separation of Duties operation.Example:
false -
leaverRequestType:
string
Leaver request type.
-
moverRequestType:
string
Mover request type.
-
notificationSettings:
object NotificationSettings
Setting to enable notification of target events to user
-
ownershipCollectionId:
string
Id of the ownership collection associated with the target.
Nested Schema : User
Type:
objectOwner of a resource.
Show Source
-
displayName:
string
Display name of the owner.
-
id:
string
Global id of the owner.
-
isPrimary:
boolean
Is user a primary owner.
Nested Schema : ConnectionStatus
Type:
objectStatus of the agent connection
Show Source
-
error:
object AggregatedOrchestratedSystemStatusError
Aggregate Orchestrated System Status Error Information.
-
timeLastSuccessfulConnection(required):
string(date-time)
Time of last successful connection.Example:
2022-01-23T10:11:02.565+00:00
Nested Schema : DataLoadStatus
Type:
objectStatus of the data load
Show Source
-
error:
object AggregatedOrchestratedSystemStatusError
Aggregate Orchestrated System Status Error Information.
-
timeDataLoadStarted:
string(date-time)
Time of start of data load.Example:
2022-01-23T10:10:02.565+00:00 -
timeLastSuccessfulDataLoad(required):
string(date-time)
Time of last successful data load.Example:
2022-01-22T10:10:02.565+00:00 -
timeUpcomingDataLoad(required):
string(date-time)
Time of upcoming successful data load.Example:
2022-01-24T10:10:02.565+00:00
Nested Schema : AggregatedOrchestratedSystemStatusError
Type:
objectAggregate Orchestrated System Status Error Information.
Show Source
-
action(required):
string
Recommended action to fix the error.Example:
-
cause(required):
string
A cuase for the error.Example:
-
code(required):
string
A short error code that defines the error, meant for programmatic parsing.Example:
-
message(required):
string
A human-readable error string.Example:
-
type(required):
string
Type of error.Example:
Nested Schema : items
Type:
arrayList of compartment summaries
Show Source
-
Array of:
object CompartmentSummary
The summary of compartment
Nested Schema : CompartmentSummary
Type:
objectThe summary of compartment
Show Source
-
fullName:
string
The full path of the compartment
-
id(required):
string
The ID of the compartment
-
name(required):
string
The name of the compartment
Nested Schema : items
Type:
arrayList of values.
Show Source
-
Array of:
object Domain
A domain for an OCI system.
Nested Schema : Domain
Type:
objectA domain for an OCI system.
Show Source
-
compartmentId:
string
Compartment id of which the domain is part of.
-
description:
string
Description of the domain.
-
displayName:
string
Display name of the domain.
-
id:
string
Id of the domain.
-
name:
string
Name of the domain.
Nested Schema : NotificationSettings
Type:
objectSetting to enable notification of target events to user
Show Source
-
emailCollection:
array emailCollection
List of emails of the users to be notified.
-
notificationUserCollection:
array notificationUserCollection
List of ids of the users to be notified.
Nested Schema : notificationUserCollection
Type:
arrayList of ids of the users to be notified.
Show Source
-
Array of:
object NotificationUser
User to be notified.
Nested Schema : NotificationUser
Type:
objectUser to be notified.
Show Source
-
id:
string
Global id of the user.
-
name:
string
Name of the user.
-
status:
string
Status of the user.
-
subType:
string
Sub-type of the user.
400 Response
Bad Request
Headers
-
opc-request-id: string
Unique Oracle-assigned identifier for the request. If you need to contact Oracle about a particular request, please provide the request ID.
Root Schema : Error
Type:
objectError Information.
Show Source
-
code(required):
string
A short error code that defines the error, meant for programmatic parsing.
-
message(required):
string
A human-readable error string.
401 Response
Unauthorized
Headers
-
opc-request-id: string
Unique Oracle-assigned identifier for the request. If you need to contact Oracle about a particular request, please provide the request ID.
Root Schema : Error
Type:
objectError Information.
Show Source
-
code(required):
string
A short error code that defines the error, meant for programmatic parsing.
-
message(required):
string
A human-readable error string.
404 Response
Not Found
Headers
-
opc-request-id: string
Unique Oracle-assigned identifier for the request. If you need to contact Oracle about a particular request, please provide the request ID.
Root Schema : Error
Type:
objectError Information.
Show Source
-
code(required):
string
A short error code that defines the error, meant for programmatic parsing.
-
message(required):
string
A human-readable error string.
429 Response
Too Many Requests
Headers
-
opc-request-id: string
Unique Oracle-assigned identifier for the request. If you need to contact Oracle about a particular request, please provide the request ID.
Root Schema : Error
Type:
objectError Information.
Show Source
-
code(required):
string
A short error code that defines the error, meant for programmatic parsing.
-
message(required):
string
A human-readable error string.
500 Response
Internal Server Error
Headers
-
opc-request-id: string
Unique Oracle-assigned identifier for the request. If you need to contact Oracle about a particular request, please provide the request ID.
Root Schema : Error
Type:
objectError Information.
Show Source
-
code(required):
string
A short error code that defines the error, meant for programmatic parsing.
-
message(required):
string
A human-readable error string.
Default Response
Unknown Error
Headers
-
opc-request-id: string
Unique Oracle-assigned identifier for the request. If you need to contact Oracle about a particular request, please provide the request ID.
Root Schema : Error
Type:
objectError Information.
Show Source
-
code(required):
string
A short error code that defines the error, meant for programmatic parsing.
-
message(required):
string
A human-readable error string.
Examples
The following example shows how to retrieve an Orchestrated System by submitting a GET request.
cURL Example - Without Query Parameters
curl -i -X GET \ -H "Authorization:Bearer <your access token>" \ '${service-instance-url}/access-governance/service-administration/${versionId}/orchestratedSystems/${orchestratedSystemId}'
Sample GET command using REST Client
curl -i -X GET \ -H "Authorization:Bearer <your access token>" \ '${service-instance-url}/access-governance/service-administration/20250331/orchestratedSystems/51f7bxxb-0xxf-46e2-xxee-cxxxxefebdxa'
Example of the Response Body
The following example shows the contents of the response body in JSON format:
{
"id": "51f7bxxb-0xxf-46e2-xxee-cxxxxefebdxa",
"name": "UA EHR",
"displayName": "UA EHR",
"lifecycleState": "ACTIVE",
"timeCreated": "2024-09-03T07:26:36.148Z",
"createdBy": "BCLARK@TESTMAIL",
"aggregatedOrchestratedSystemStatus": {
"aggregatedStatus": "DRAFT",
"dataLoadStatus": null,
"connectionStatus": null
},
"timeLastModified": "2024-09-03T07:26:40.000Z",
"lastModifiedBy": "AG_System",
"type": "CERNERMILLENNIUM",
"category": "ABC_APPLICATIONS",
"mode": "NONAUTHORITATIVE",
"primaryOwner": {
"id": "globalId.xxxxxc3-eedc-xdxa-b6d4-6c0fxxxxbad2.18.02exxbbb4bxxxxxxbxxaa046b3ceb16a",
"displayName": "Bell Clark",
"isPrimary": true
},
"domains": null
}