---
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 OS image

# OCI OS image pattern-based discovery {#ariaid-title1}

Release version: Australia  
Updated September 10, 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 OS image pattern-based discovery

OCI OS image pattern-based discovery enables ServiceNow customers to identify and catalog Oracle Cloud Infrastructure (OCI) operating system images within their cloud environment.
This is achieved through Discovery and Service Mapping Patterns that scan the OCI account and populate relevant data into ServiceNow's Configuration Management Database (CMDB).
Show full answer Show less  
The discovery leverages two primary patterns:

* **Oracle OCI - Image (LP) pattern:** Discovers OCI OS images and stores them in the Image \[cmdbciostemplate\] table.
* **Oracle OCI - Cloud OS Image (LP) pattern:** When enabled, discovered OS images are stored in the Cloud Image \[cmdbcicloudosimage\] table to avoid excessive records in the Image table.

## Key Features

* **REST API Permissions:** Customers should verify and grant necessary permissions for Discovery to run successfully, using a downloadable spreadsheet that details required permissions, pattern names, CI classes, and vendor documentation.
* **OCI Discovery Prerequisites:** Ensure all prerequisites for Oracle Cloud Infrastructure discovery are met, including setting up the Discovery schedule to support GovCloud environments by using appropriate datacenter URLs when configuring OCI service accounts.
* **Data Population:** Discovered OS images populate key fields such as Name, Object ID, Guest OS type, Version, Provider (OCI), Install Status, and Operational Status within the CMDB tables.
* **CI Relationships and References:** The discovery process establishes relationships between OS images and OCI datacenters, as well as references to configuration items, enhancing data integrity and traceability.
* **OCI Tag Discovery:** Tags associated with OCI OS images are collected and stored in the Key Value \[cmdbkeyvalue\] table, linking tag names and values with the corresponding OS image records.

## What Customers Can Expect

By implementing OCI OS image pattern-based discovery, customers can expect accurate and organized tracking of OCI OS images within their CMDB. This facilitates better cloud resource management, reduces clutter by using the appropriate CMDB tables, and supports comprehensive relationship mapping for improved visibility and governance of OCI assets. Regular updates to Discovery patterns ensure compatibility with the evolving OCI environment.  
Discovery and Service Mapping Patterns finds OCI OS images on your cloud 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 overview {#oracle-os-image-pattern__section_overview}

Discovery uses the Oracle OCI - Image (LP) pattern to discover OCI OS images from your Oracle account.

When using the Image \[cmdb_ci_os_template\] table to store Cloud OS images, you may notice an unusually large number of records. To avoid this issue, you can store the discovered OS images in the Cloud Image \[cmdb_ci_cloud_os_image\] table. When enabled, Discovery launches the Oracle OCI - Cloud OS Image (LP) pattern, which populates the Cloud Image \[cmdb_ci_cloud_os_image\] table. For more information, see [Enable Cloud OS Image discovery](https://www.servicenow.com/docs/AM9L2gpoJH8rga6KPXl_5g "Enable the Cloud OS Image [cmdb_ci_cloud_os_image] table to store the cloud OS image records for Amazon AWS Cloud, Microsoft Azure Cloud, Google Cloud Platform (GCP), Oracle Cloud Infrastructure (OCI), and IBM Cloud.").

## Pattern-based discovery and mapping requirements {#oracle-os-image-pattern__section_rpj_fj2_bgc}

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-os-image-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-os-image-pattern__section_ggp_ql2_bgc}

Discovery populates the data in the CMDB when running the OCI OS image patterns.  
{#oracle-os-image-pattern__table_mkf_2hc_dgc__entry__2}

| Field | Description |
|-|-|
| Name \[name\] | Name of the image resource. |
| Object ID \[object_id\] | A unique identifier, allocated by Oracle Cloud Infrastructure for this resource. |
| Guest OS \[guest_os\] | Operating system type of the image. |
| Version \[version\] | Version of the operating system. |
| Provider \[provider\] | The cloud provider, which is OCI. This field is only populated in the Cloud Image \[cmdb_ci_cloud_os_image\] 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. Image \[cmdb_ci_os_template\] or Cloud Image \[cmdb_ci_cloud_os_image\]]

{#oracle-os-image-pattern__table_mkf_2hc_dgc}

## CI relationships and references {#oracle-os-image-pattern__section_dc4_ghc_dgc}

The OCI OS image patterns create the following relationships and references to support OCI OS image discovery. References link to records in other tables and don't appear in the CI Relationship \[cmdb_rel_ci\] table.  
{#oracle-os-image-pattern__table_bkg_jhc_dgc__entry__3}

| CI | Relationship | CI |
|-|-|-|
| Image \[cmdb_ci_os_template\] or Cloud Image \[cmdb_ci_cloud_os_image\] | Hosted on::Hosts | OCI Datacenter \[cmdb_ci_oci_datacenter\] |
[Table 2. CI relationships]

{#oracle-os-image-pattern__table_bkg_jhc_dgc}  
{#oracle-os-image-pattern__table_ci_references__entry__3}

| CI | Field | Referenced CI |
|-|-|-|
| Key Value \[cmdb_key_value\] | Configuration item \[configuration_item\] | Image \[cmdb_ci_os_template\] or Cloud Image \[cmdb_ci_cloud_os_image\] |
[Table 3. CI references]

{#oracle-os-image-pattern__table_ci_references}

## OCI tag discovery {#oracle-os-image-pattern__section_lyw_zhc_dgc}

The OCI OS image patterns collect tags and populate them in the Key Value \[cmdb_key_value\] table.  
{#oracle-os-image-pattern__table_ojy_vss_5hc__entry__2}

| Field | Description |
|-|-|
| Key \[key\] | Tag name. |
| Value \[value\] | Tag value. |
| Configuration item \[configuration_item\] | References the Image \[cmdb_ci_os_template\] or Cloud Image \[cmdb_ci_cloud_os_image\] table. |
[Table 4. Key Value \[cmdb_key_value\]]

{#oracle-os-image-pattern__table_ojy_vss_5hc}