GCP discovery › Available cloud discovery patterns › Discovery patterns used by ITOM Visibility › ITOM Visibility › IT Operations Management

Release: Australia · Updated: 2026-03-12 · Official documentation · View source

Google Cloud Platform (GCP) Organization discovery with Patterns

The ServiceNow Discovery application uses the Discover Google Organization discovery pattern to find GCP Organization projects and resources. Discovering some of these resources may require updating to the latest version of the Discovery and Service Mapping Patterns application from the ServiceNow Store.

Request apps on the Store

Visit the ServiceNow Store 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.

Prerequisites

For details on system requirements and family compatibility, view the application listing on the ServiceNow Store website.

GCP Organization structure

Verify that a GCP Organization resource is structured correctly, with projects underneath it in a miscellaneous hierarchy.

Ensure that all projects under the GCP Organization resource have the Compute Engine API enabled.
Service Account user settings

Check that Service Account users have access to the GCP Organization resource node.

Verify that Service Account users are members of all other projects located under the GCP Organization resource node.

Ensure that Service Account users have the following Cloud Identity and Access Management credentials for projects under the GCP Organization resource:
- resourcemanager.folders.list
- resourcemanager.organizations.get
- resourcemanager.projects.get
- resourcemanager.projects.list
- Credentials for API elements
During the discovery, the pattern uses the following API elements. The user that was added to the credentials in the instance must have permissions to send these queries.
- https://cloudresourcemanager.googleapis.com/v1/{name=organizations/*}
- https://cloudresourcemanager.googleapis.com/v1/projects
- https://cloudresourcemanager.googleapis.com/v2/folders:search
- Credentials for creating a discovery schedule
Configure the following credentials:
1. Create GCP credentials.
2. Create a GCP Service Account:
  1. Credentials: The GCP credentials.
  2. Account ID: The Google Service Account ID.
  3. Datacenter type: Select cmdb_ci_google_datacenter.
3. Create a discovery schedule.
4. (Optional) Create a serverless discovery schedule
Create a discovery schedule to perform targeted discovery of GCP Organization resources.
1. Navigate to Discovery > Discovery Schedules.
2. Click New and then fill in the form.

Field	Description
Name	Name for the Discovery schedule. For example, `Discover GCP Organization`.
Discover	Discover type. Select Serverless.
MID Server	Name of the MID Server.
Active	Option for enabling this schedule for discovery. Select this check box to enable discovery.

3.  Right-click the header of the Discovery Schedule form and select **Save**.
4.  Click the **Serverless Execution Patterns** tab, click **New**, and then fill in the form.

Image omitted: serverless-execution-pattern.png
Serverless execution pattern

    |Field|Description|
    |-----|-----------|
    |Name|Name for this Serverless Execution Pattern. For example, `Discover GCP Organization`.|
    |Pattern|Name of the pattern to run: Discover Google Organization.|
    |Proxy Host|Fully qualified domain name of the machine on which you are installing the proxy server. Specify **Global**.|
    |Active|Option for enabling this schedule for discovery. Select this check box to enable discovery.|

5.  Under **Discovery Pattern Launcher Parameters**, configure the following parameters with the relevant values:

    |Parameter|Value|
    |---------|-----|
    |cloud\_account\_id|The Project ID within GCP.|
    |cloud\_cred\_id|The sysid of the GCP credentials.|
    |cloud\_datacenter\_type|`cmdb_ci_google_datacenter`|

Image omitted: discovery-pattern-launcher-params.png
Pattern Launcher Parameters

Customers with early access to the GCP Organization pattern

Verify that the Discover-GCP-SubAccounts scheduled job is not enabled in your instance.
1. Navigate to System Definition > Scheduled Jobs.
2. Click the Discover-GCP-SubAccounts scheduled job.
3. Clear the Active check box, and then click Update.

Data collected by Discovery during horizontal discovery

Table and field	Description
Organization \[cmdb\_ci\_cloud\_org\]
name	The name of the organization resource.
object\_id	The ID of the organization resource.
time	The time the organization resource was created in GCP.
operational\_status	Current operational status. One of the following:- Operational - Non-Operational - Repair in Progress - DR Standby - Ready - Retired
Folder \[cmdb\_ci\_gcp\_folder\]
name	The name of the organization folder.
parent\_id	The ID of the parent resource.
parent\_type	The type of the parent resource. Can be `organization` or `folder`.
time	The time the resource was created in GCP.
status	The status of the folder according to the `lifecycleState` status in GCP.
object\_id	The ID of the organization folder.
Project \[cmdb\_ci\_gcp\_project\]
name	The name of the project.
project\_id	The ID of the project.
parent\_id	The ID of the parent folder resource.
parent\_type	The type of the parent resource. Can be `organization` or `folder`.
time	The time the resource was created in GCP.
operational\_status	The status of the folder according to the `lifecycleState` status in GCP.
object\_id	The ID of the project.
discovery\_credentials	GCP account credentials.
Resource \[cmdb\_key\_value\]
key	The key, or label, associated with the GCP project. For example, `country`.
value	The project label value assigned to the GCP project. For example, `ca`.
configuration\_item	The URL or path of the CI.

CI relationships

CI	Relationship	CI
Cloud Organization [cmdb_ci_cloud_org]	Contained by::Contains	Google Project [cmdb_ci_gcp_project]
Cloud Organization [cmdb_ci_cloud_org]	Contained by::Contains	Service Account
Cloud Organization [cmdb_ci_cloud_org]	Contained by::Contains	Google Folder [cmdb_ci_gcp_folder]
Service Account	Owns::Owned by	Google Project [cmdb_ci_gcp_project]
Google Folder [cmdb_ci_gcp_folder]	Contained by::Contains	Google Project [cmdb_ci_gcp_project]
Google Folder [cmdb_ci_gcp_folder]	Contained by::Contains	Sub Google Folder
Sub Google Folder	Contained by::Contains	Google Project [cmdb_ci_gcp_project]

Parent Topic:Google Cloud Platform (GCP) Cloud discovery using Patterns