Google Cloud
xAssets includes a built-in integration to import virtual machine instances from a Google Cloud Platform (GCP) account. This page explains what the integration provides and how to configure it.
What the Integration Provides
The GCP integration pulls basic information on each Compute Engine instance in your GCP project into xAssets as asset records. This gives you visibility of your cloud infrastructure alongside on-premises and other cloud assets.
For full hardware and software details on each instance, combine this integration with xAssets Network Discovery, which can scan the instances once they are registered in xAssets.
Prerequisites
- A Google Cloud Platform project with Compute Engine API enabled
- A service account or API key with permission to list Compute Engine instances
- Access to xAssets with permission to create credential packs
- The xAssets Batch Service must be running
Setup
Step 1: Create API Credentials in GCP
- Sign in to the Google Cloud Console
- Navigate to APIs & Services > Credentials
- Create an API key or service account key with Compute Engine read access
- Note the project name and the zone of your instances
Step 2: Create a Credential Pack in xAssets
- Navigate to Discover > Prepare > Credentials
- Click Create Credentials
- Configure the credential pack as follows:
| Field | Value |
|---|---|
| Credential Type | Named Credentials |
| Collection Server | Application Server |
| Pack Name | GoogleCloud |
| Domain | The zone of your Google Cloud instances (e.g., us-central1-a) |
| Username | The GCP project name |
| Password | Your GCP API key |
- Save the credential pack
Step 3: Run the Integration
- Navigate to Discover > Integrations > Get data from Google Cloud
- Select the GoogleCloud credential pack
- The integration runs and creates one asset record per Compute Engine instance
Tip: If you have instances across multiple GCP zones, you may need to run the integration once per zone, or modify the transformation to iterate through zones. Contact xAssets support for guidance on multi-zone configurations.
Related Articles
- Amazon Web Services — similar integration for AWS
- Azure Direct Integration — similar integration for Microsoft Azure
- Transformations Overview — understanding transformations