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

 Release :

    - australia

ft:locale :

    - en-US

ft:publication_title :

    - Australia IT Operations Management

ft:clusterId :

    - itom

bundleId :

    - itom

workflow :

    - Technology


---

# OCI sub account

# OCI sub account pattern-based discovery {#ariaid-title1}

Release version: Australia  
Updated October 29, 2026  
![](https://www.servicenow.com/docs/portal-asset/ico-clock) 2 minutes to read
Summarize  
![AI sparkle icon](https://servicenow.com/docs/portal-asset/ai-sparkle-icon) Summarized using AI  
This content was generated using new OpenAI-powered functionality. Results are provided on an as is basis and are not guaranteed to be accurate or complete.  

## Summary of OCI sub account pattern-based discovery

OCI sub account pattern-based discovery enables ServiceNow customers to detect and map Oracle Cloud Infrastructure (OCI) sub accounts (compartments) within their cloud environment.
This functionality helps populate the Configuration Management Database (CMDB) with detailed compartment and account data, facilitating better cloud resource management and visibility.
Show full answer Show less  

## Key Features

* **Pattern-Based Discovery:** Utilizes Discovery and Service Mapping Patterns to find OCI sub accounts efficiently.
* **REST API Permissions:** Requires proper REST API permissions for running discovery patterns. Customers should download and consult the Cloud Discovery patterns spreadsheet for necessary permissions, pattern details, and vendor documentation.
* **Quarterly Updates:** New discovery patterns are released quarterly, so customers should periodically update to the latest Discovery and Service Mapping Patterns application and spreadsheet.
* **OCI Discovery Prerequisites:** Customers must verify and meet OCI discovery prerequisites, including configuring service accounts and supporting GovCloud by specifying datacenter URLs.
* **Data Collection:** When running the Oracle OCI - Sub Account (LP) pattern, discovery collects and records compartment details such as name, OCID, account identifiers, datacenter type/URL, organization ID, and status indicators in the CMDB Cloud Service Account table.
* **CI Relationships and References:** The pattern establishes relationships between cloud service accounts, including parent and child (sub account) references, enhancing CMDB data structure and traceability.
* **OCI Tag Discovery:** Tags associated with OCI compartments are collected and stored in the Key Value \[cmdbkeyvalue\] table, linked to the relevant cloud service account CIs.

## Key Outcomes

* Comprehensive discovery and mapping of OCI compartments increase accuracy and completeness of cloud resource data in the CMDB.
* Enables organizations to manage OCI sub accounts effectively by providing critical account metadata and hierarchical relationships.
* Supports governance and operational visibility, including in specialized environments like OCI GovCloud.
* Facilitates tag-based management and reporting by capturing OCI tags in structured CMDB key-value pairs.  
Discovery and Service Mapping Patterns finds sub accounts (compartments) in your OCI environment. Discovering some of these resources might require updating to the latest version of the Discovery and Service Mapping Patterns application from the ServiceNow Store.

## Pattern-based discovery and mapping requirements {#oracle-sub-account-pattern__section_subaccount_reqs}

Verify the REST API permissions
:   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-sub-account-pattern__cloud-discovery-api-ph-short-prereq}

Verify the OCI discovery prerequisites
:   For more information, see the prerequisites section in [Oracle Cloud Infrastructure (OCI) discovery](https://www.servicenow.com/docs/cQhDQlR5AKA0e3vdDdSSGg "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 might require updating to the latest version of the Discovery and Service Mapping Patterns application from the ServiceNow Store.").

Configure the Discovery schedule to support GovCloud
:   Discovering OCI GovCloud accounts requires using a datacenter URL when setting up an 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.").

## Data collected by Discovery during horizontal discovery {#oracle-sub-account-pattern__section_subaccount_data}

Discovery populates the data in the CMDB when running the Oracle OCI - Sub Account (LP) pattern.  
{#oracle-sub-account-pattern__table_subaccount_service_account__entry__2}

| Field | Description |
|-|-|
| Name \[name\] | Name of the compartment. |
| Object ID \[object_id\] | Oracle Cloud Identifier (OCID) of the compartment. |
| Account Id \[account_id\] | Unique identifier of the account. * For sub accounts: the value is the OCID of the compartment * For the management account: the value is the account ID of the tenancy that you entered when you added the account {#oracle-sub-account-pattern__ul_qrk_ktp_clc} |
| Datacenter Type \[datacenter_type\] | Type of datacenter that the account belongs to. The value is set to OCI Datacenter \[cmdb_ci_oci_datacenter\]. |
| Datacenter URL \[datacenter_url\] | URL of the datacenter. The value is inherited from the management account. |
| Organization Id \[organization_id\] | Organization ID. The value is inherited from the management account. |
| Is management account \[is_master_account\] | Indicator of whether the account is the management account. * For sub accounts: the value is false * For the management account: the value is true {#oracle-sub-account-pattern__ul_tvl_ptp_clc} |
| Parent account \[parent_account\] | Reference to the Cloud Service Account \[cmdb_ci_cloud_service_account\] table. |
| Install Status \[install_status\] | Install status of the resource. Default value is Installed. |
| Operational status \[operational_status\] | Operational status of the resource. Default value is Operational. |
[Table 1. Cloud Service Account \[cmdb_ci_cloud_service_account\]]

{#oracle-sub-account-pattern__table_subaccount_service_account}

## CI relationships and references {#oracle-sub-account-pattern__section_subaccount_relationships}

The Oracle OCI - Sub Account (LP) pattern creates the following relationships and references to support OCI sub account discovery. References link to records in other tables and don't appear in the CI Relationship \[cmdb_rel_ci\] table.  
{#oracle-sub-account-pattern__table_subaccount_ci_relationships__entry__3}

| CI | Relationship | CI |
|-|-|-|
| Cloud Service Account \[cmdb_ci_cloud_service_account\] | Members::Member of | Cloud Service Account \[cmdb_ci_cloud_service_account\] |
[Table 2. CI relationships]

{#oracle-sub-account-pattern__table_subaccount_ci_relationships}  
{#oracle-sub-account-pattern__table_subaccount_ci_references__entry__3}

| CI | Field | Referenced CI |
|-|-|-|
| Cloud Service Account \[cmdb_ci_cloud_service_account\] | Parent account \[parent_account\] | Cloud Service Account \[cmdb_ci_cloud_service_account\] |
| Key Value \[cmdb_key_value\] | Configuration item \[configuration_item\] | Cloud Service Account \[cmdb_ci_cloud_service_account\] |
[Table 3. CI references]

{#oracle-sub-account-pattern__table_subaccount_ci_references}

## OCI tag discovery {#oracle-sub-account-pattern__section_subaccount_tags}

The pattern extension section collects tags and populates them in the Key Value \[cmdb_key_value\] table.  
{#oracle-sub-account-pattern__table_subaccount_key_value__entry__2}

| Field | Description |
|-|-|
| Key \[key\] | Tag name. |
| Value \[value\] | Tag value. |
| Configuration item \[configuration_item\] | Reference to the Cloud Service Account \[cmdb_ci_cloud_service_account\] table. |
[Table 4. Key Value \[cmdb_key_value\]]

{#oracle-sub-account-pattern__table_subaccount_key_value}