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:
object
Summary 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:
0
Maximum Length:255
A 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:
0
Maximum Length:255
A 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" ]
Possible type for the Orchestrated System.
Nested Schema : AggregatedOrchestratedSystemStatus
Type:
object
Status 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:
object
List of compartment
Show Source
-
items(required):
array items
List of compartment summaries
Nested Schema : DomainCollection
Type:
object
List of values (domains for OCI).
Show Source
-
items(required):
array items
List of values.
Nested Schema : OrchestratedSystemMetaData
Type:
object
Orchestrated 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:
object
Owner 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:
object
Status 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:
object
Status 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:
object
Aggregate 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:
array
List of compartment summaries
Show Source
-
Array of:
object CompartmentSummary
The summary of compartment
Nested Schema : CompartmentSummary
Type:
object
The 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:
array
List of values.
Show Source
-
Array of:
object Domain
A domain for an OCI system.
Nested Schema : Domain
Type:
object
A 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:
object
Setting 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:
array
List of ids of the users to be notified.
Show Source
-
Array of:
object NotificationUser
User to be notified.
Nested Schema : NotificationUser
Type:
object
User 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:
object
Error 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:
object
Error 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:
object
Error 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:
object
Error 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:
object
Error 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:
object
Error 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 }