---
sourceDocument: Australia IT Operations Management
sourceDocumentLink: https://www.servicenow.com/docs/r/it-operations-management

 Release :

    - australia

ft:locale :

    - en-US

ft:publication_title :

    - Australia IT Operations Management

ft:clusterId :

    - itom

bundleId :

    - itom

workflow :

    - Technology


---

# OCI discovery

# Oracle Cloud Infrastructure (OCI) discovery {#ariaid-title1}

* Release version: Australia
* 
* Updated March 12, 2026
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 5 minutes to read

ServiceNow
Discovery uses the Oracle Cloud Infrastructure (OCI) discovery patterns to provide real-time elasticity for enterprise applications by combining Oracle autonomous services, integrated security, and cloud compute.
Discovering some of these resources may require updating to the latest version of the Discovery and Service Mapping Patterns application from the ServiceNow Store.
Starting with version 1.29.0, Discovery and Service Mapping Patterns supports the discovery of OCI GovCloud accounts.

## Request apps on the Store {#oracle-cloud-infrastructure-discovery__section_sv2_vw5_5mb}

Visit the [ServiceNow Store](https://store.servicenow.com/sn_appstore_store.do#!/store/home) to view all the available apps, and for information about submitting requests to the store. For cumulative release notes information for all released apps, see the [ServiceNow Store version history release notes](https://www.servicenow.com/docs/r/store-release-notes/sn-store-release-notes.html).{#oracle-cloud-infrastructure-discovery__inline-send-to-store}

## Prerequisites {#oracle-cloud-infrastructure-discovery__section_wlw_2t2_v4b}

Verify that the following applications are installed
:   Verify that the following applications are installed and up to date:

    * Cloud Access Interface (starting from version 1.0.0)
    * Visibility Content
    * CMDB CI Class Models
    * Discovery and Service Mapping Patterns
    {#oracle-cloud-infrastructure-discovery__ul_qds_gc2_zfc}

Configure Oracle API credentials
:   Ensure that your OCI credentials are configured and that your private and public keys are converted to the RSA format. For more information, see [Create Oracle API credentials](https://www.servicenow.com/docs/SQ511VUJ1WvRnZvupznXcQ "Create Oracle API credentials on the ServiceNow AI Platform to enable access to your Oracle resources during Oracle discovery.").

Create OCI service account
:   For more information, see [Create OCI service accounts](https://www.servicenow.com/docs/Mfvl~mYZP9TwzjqAPuihqA "Create Oracle Cloud Infrastructure (OCI) service accounts on the ServiceNow AI Platform to access your Oracle account during Oracle discovery.").

Create a cloud discovery schedule
:   To run a cloud discovery at scale, see [Create an OCI Discovery schedule in Discovery Admin Workspace](https://www.servicenow.com/docs/WRMF530a1n9BFD6MPbyNTA "Use the Discovery Admin Workspace dashboard to create an Oracle Cloud Infrastructure (OCI) Discovery schedule.").

:   Create a discovery schedule to run LDCs on.

    1. Navigate to DiscoveryDiscovery Schedules.
    2. Select Cloud Discovery.
    3. In the Provider field, select OCI. Fill in the form to create an account or select an existing one. For more information, see [Create OCI service accounts](https://www.servicenow.com/docs/Mfvl~mYZP9TwzjqAPuihqA "Create Oracle Cloud Infrastructure (OCI) service accounts on the ServiceNow AI Platform to access your Oracle account during Oracle discovery.").
    4. On the Select Datacenters page, filter which LDCs you want to run the discovery.
    5. When you're finished, navigate to the Create Schedule page and select Finish and Run.
    {#oracle-cloud-infrastructure-discovery__ol_o3q_dx2_v4b}

(Optional) Populate Service Account and Logical Datacenter fields in cloud CIs
:   Starting with Discovery and Service Mapping Patterns version 1.30.2, you can improve query performance by populating Service Account and Logical Datacenter fields directly in cloud CIs. For more information, see [Improved query performance with direct field population in CI tables](https://www.servicenow.com/docs/dikZ2lIS1bNpgxWtTOukSQ "The Populate Service Account and LDC IN CMDB scheduled job populates the Service Account and Logical Datacenter fields in cloud configuration item (CI) tables, and the Virtual Machine Object field in the Hardware [cmdb_ci_hardware] table. This direct population reduces query complexity and improves query performance.").

## Verify the REST API Permissions {#oracle-cloud-infrastructure-discovery__id_idw_sbb_f1c}

Download the [Cloud Discovery patterns spreadsheet](https://downloads.docs.servicenow.com/resource/enus/api/servicenow-discovery-patterns-api-details.xlsx) so you can grant user permissions required for running the Discovery patterns. In addition to permissions, the spreadsheet also includes useful information such as pattern names, types, CI Classes, and links to vendor documentation. New patterns are available
quarterly, so check periodically to be sure you have the latest version of the spreadsheet.{#oracle-cloud-infrastructure-discovery__cloud-discovery-api-paragraph}

## Data collected by Discovery during horizontal discovery {#oracle-cloud-infrastructure-discovery__section_rcg_yx2_v4b}

The discovered Oracle configuration data includes the following table and fields.
{#oracle-cloud-infrastructure-discovery__table_w2j_l53_2nb__entry__2}

| Field | Description |
|-|-|
| Cloud Database (cmdb_ci_cloud_database) ||
| name | The name of the database. |
| object_id | Unique identifier of the database. |
| operational_status | Operational status of the database. |
| vendor | The vendor, Oracle. |
| type | The Oracle database type. |
| version | Version of the database. |
| state | State of the database. |
| comments | The attribute is issued for the delete strategy. |
| install_status | Install status. |
| Image​ (cmdb_ci_os_template) ||
| name | The image name. |
| object_id | Unique identifier of the image. |
| version | The version of the guest OS. |
| guest_os | The name of the guest OS. |
| Service Account (cmdb_ci_cloud_service_account) ||
| name | The account name. |
| datacenter_type | Datacenter type. |
| account_id | Unique identifier of the account. |
| object_id | Unique identifier of the account (same value as the account id). |
| discovery_credentials | The credentials related to the service account. |
| is_master_account | true when it is the root compartment. false when it is not the root compartment. |
| Network (cmdb_ci_network) ||
| name | The network name. |
| object_id | Unique identifier of the network. |
| cidr | The cidr of the network. |
| domain_name | The domain name. |
| state | The state of the network. |
| NIC (cmdb_ci_nic) ||
| name | The NIC name. |
| object_id | Unique identifier of the NIC. |
| public_ip | The public IP address. |
| mac_address | The MAC address. |
| primary | Set true/false according to the setup. |
| private_ip | The private ip address. |
| state | The state of the NIC. |
| Storage Volume (cmdb_ci_storage_volume) ||
| name | The name of the storage volume. |
| object_id | Unique identifier of storage volume. |
| state | The state of the storage volume. |
| volume_id | Unique identifier of the storage volume (same value as the account id). |
| size | The storage volume size. |
| size_bytes | The storage volume size in bytes. |
| Subnet (cmdb_ci_cloud_subnet) ||
| name | The name of the subnet. |
| object_id | Unique identifier of subnet. |
| cidr | The cidr of the subnet. |
| domain_name | The domain name. |
| state | The state of the subnet. |
| Virtual Machine (cmdb_ci_vm_instance) ||
| name | The VM name. |
| object_id | Unique identifier of VM. |
| state | The state of the VM. |
| memory | Memory size. |
| cpus | Number of CPUs. |
[ ]

{#oracle-cloud-infrastructure-discovery__table_w2j_l53_2nb}

Tags are populated to the cmdb_key_value table and related to the
relevant cmdb ci resource. In order to support it, the extension sections were created for
the following resources:

* Autonomous DB
* Exadata DB
* Image
* Network
* NIC
* Storage Volume
* Account
* Subnet
* Virtual Machine
{#oracle-cloud-infrastructure-discovery__ul_exk_s1k_x4b}

## CI Relationships {#oracle-cloud-infrastructure-discovery__section_k4m_x1f_v4b}

{#oracle-cloud-infrastructure-discovery__table_gfy_npd_x4b__entry__3}

| CI | Relationship | CI |
|-|-|-|
| cmdb_ci_oci_datacenter | Contains::Contained by | cmdb_ci_availablity_zone |
[Table 1. Relationships discovered using the Oracle OCI - Availability Domain (LP) pattern]

{#oracle-cloud-infrastructure-discovery__table_gfy_npd_x4b}  
{#oracle-cloud-infrastructure-discovery__table_ybq_1qd_x4b__entry__3}

| CI | Relationship | CI |
|-|-|-|
| cmdb_ci_vm_instance | Use End Point To::Use End Point From | cmdb_ci_endpoint_block |
| cmdb_ci_endpoint_block | Implement End Point To::Implement End Point From | cmdb_ci_storage_volume |
[Table 2. Relationships discovered using the Oracle OCI - Block (LP) pattern]

{#oracle-cloud-infrastructure-discovery__table_ybq_1qd_x4b}  
{#oracle-cloud-infrastructure-discovery__table_rsx_jqd_x4b__entry__3}

| CI | Relationship | CI |
|-|-|-|
| cmdb_ci_oci_datacenter | Contains::Contained by | cmdb_ci_availability_zone |
[Table 3. Relationships discovered using the Oracle OCI - Fault Domain (LP) pattern]

{#oracle-cloud-infrastructure-discovery__table_rsx_jqd_x4b}  
Note:  
When configuring a Cloud Discovery scheduler for part of the LDCs, the Oracle OCI - Fault Domain (LP) pattern will not trigger.  
{#oracle-cloud-infrastructure-discovery__table_zkv_brd_x4b__entry__3}

| CI | Relationship | CI |
|-|-|-|
| cmdb_ci_os_template | Hosted on::Hosts | cmdb_ci_oci_datacenter |
[Table 4. Relationships using the Oracle OCI - Image (LP) pattern]

{#oracle-cloud-infrastructure-discovery__table_zkv_brd_x4b}  
{#oracle-cloud-infrastructure-discovery__table_m4p_grd_x4b__entry__3}

| CI | Relationship | CI |
|-|-|-|
| cmdb_ci_oci_datacenter | Hosted on::Hosts | cmdb_ci_cloud_service_account |
[Table 5. Relationships discovered using the Oracle OCI - LDC (LP) pattern]

{#oracle-cloud-infrastructure-discovery__table_m4p_grd_x4b}  
{#oracle-cloud-infrastructure-discovery__table_hps_lrd_x4b__entry__3}

| CI | Relationship | CI |
|-|-|-|
| cmdb_ci_network | Hosted on::Hosts | cmdb_ci_oci_datacenter |
[Table 6. Relationships discovered using the Oracle OCI - Network (LP) pattern]

{#oracle-cloud-infrastructure-discovery__table_hps_lrd_x4b}  
{#oracle-cloud-infrastructure-discovery__table_jtg_dtm_pu832__entry__3}

| CI | Relationship | CI |
|-|-|-|
| cmdb_ci_vm_instance | Use End Point To::Use End Point From | cmdb_ci_endpoint_subnet |
| cmdb_ci_vm_instance | Use End Point To::Use End Point From | cmdb_ci_endpoint_vnic |
| cmdb_ci_endpoint_vnic | Implement End Point To::Implement End Point From | cmdb_ci_nic |
| cmdb_ci_cloud_subnet | Implement End Point To::Implement End Point From | cmdb_ci_endpoint_subnet |
[Table 7. Relationships discovered using the Oracle OCI - NIC Attachment (LP) pattern]

{#oracle-cloud-infrastructure-discovery__table_jtg_dtm_pu832}  
{#oracle-cloud-infrastructure-discovery__table_oj1_vrd_x4b__entry__3}

| CI | Relationship | CI |
|-|-|-|
| cmdb_ci_nic | Hosted on::Hosts | cmdb_ci_oci_datacenter |
[Table 8. Relationships discovered using the Oracle OCI - NIC (LP) pattern]

{#oracle-cloud-infrastructure-discovery__table_oj1_vrd_x4b}  
{#oracle-cloud-infrastructure-discovery__table_uwq_zrd_x4b__entry__3}

| CI | Relationship | CI |
|-|-|-|
| cmdb_ci_availablity_zone | Contains::Contained by | cmdb_ci_storage_volume |
| cmdb_ci_storage_volume | Hosted on::Hosts | cmdb_ci_oci_datacenter |
[Table 9. Relationships using the Oracle OCI - Storage Volume (LP) pattern]

{#oracle-cloud-infrastructure-discovery__table_uwq_zrd_x4b}  
{#oracle-cloud-infrastructure-discovery__table_edt_gsd_x4b__entry__3}

| CI | Relationship | CI |
|-|-|-|
| cmdb_ci_network | Contains::Contained by | cmdb_ci_cloud_subnet |
[Table 10. Relationships discovered using the Oracle OCI - Subnet (LP) pattern]

{#oracle-cloud-infrastructure-discovery__table_edt_gsd_x4b}
* **[OCI virtual machine pattern-based discovery](https://www.servicenow.com/docs/dgCz8TFhrulh3kdWjtrBVw)**   
  Discovery and Service Mapping Patterns finds OCI virtual machines (VMs) on your cloud environment. Discovering some of these resources may require updating to the latest version of the Discovery and Service Mapping Patterns application from the ServiceNow Store.

*[\>]: and then