This page describes how to get started with Cloud Asset Inventory and services
by exporting asset metadata at a point in time using the
gcloud asset commands.
The Cloud SDK provides the
gcloud command-line tool to interact
with Cloud Asset Inventory and other Google Cloud services.
Before you begin
gcloudtool uses the Cloud Asset API to access Google Cloud. You must enable the API before you can use the
gcloudtool to access Cloud Asset Inventory. Note that the API only needs to be enabled on the project you'll be running Cloud Asset API commands from.
Enable the Cloud Asset Inventory API
- Install the Cloud SDK on your local client.
Getting started with the gcloud command-line tool
To get started with the
gcloud tool, review the
Cloud SDK Documentation. You can get help for the tool, resources, and commands by using the
gcloud asset --help
The help displayed with the
--help flag is also available in the Cloud SDK
To call the Cloud Asset API, you need to configure either a user account or a service account.
Configuring a user account
Log in with your user account using the following command.
gcloud auth login USER_ACCOUNT_EMAIL
Optional. If the target project you want to call the Cloud Asset API on isn't the same as your Cloud Asset Inventory enabled project, specify your project with the following command.
gcloud asset --billing-project PROJECT_ID
Grant your user account the
cloudasset.viewerCloud IAM role on the project whose metadata you want to export. This project can be the same as your Cloud Asset API enabled project.
gcloud projects add-iam-policy-binding EXPORT_TARGET_PROJECT_ID \ --member user:USER_ACCOUNT_EMAIL \ --role roles/cloudasset.viewer
Configuring a service account
This service account should be created for the project you're running Cloud Asset API commands from.
If you don't already have a service account, in the project that is Cloud Asset API enabled, create a new service account with the following command.
gcloud iam service-accounts create SERVICE_ACCOUNT_NAME \ --display-name "SERVICE_ACCOUNT_DISPLAY_NAME"
Create a private key for your service account.
gcloud iam service-accounts keys create YOUR_FILE_PATH/key.json \ --iam-account SERVICE_ACCOUNT_NAME@PROJECT_ID.iam.gserviceaccount.com
Activate your service account for use with the
gcloudtool with the following command.
gcloud auth activate-service-account SERVICE_ACCOUNT_NAME@PROJECT_ID.iam.gserviceaccount.com \ --key-file=YOUR_FILE_PATH/key.json
Grant your new service account the
cloudasset.viewerCloud IAM role on a project whose metadata you want to export. This project can be the same as your Cloud Asset API enabled project.
gcloud projects add-iam-policy-binding EXPORT_TARGET_PROJECT_ID \ --member serviceAccount:SERVICE_ACCOUNT_NAME@PROJECT_ID.iam.gserviceaccount.com \ --role roles/cloudasset.viewer
Exporting an asset snapshot to Cloud Storage
To Export all the asset metadata at a given timestamp to a Cloud Storage file, follow the process below.
Note that the Cloud Storage bucket you use to store exported metadata must be in the Cloud Asset API enabled project you're running the export from.
Create a new bucket if your project doesn't have an existing Cloud Storage bucket that is available to store exported data.
Exports asset metadata within your project with the following command. This stores the exported snapshot in a Cloud Storage bucket at
gcloud asset export \ --content-type resource \ --project PROJECT_ID \ --snapshot-time SNAPSHOT_TIME \ --output-path "gs://YOUR_BUCKET/NEW_FILE"
- PROJECT_ID is the ID of the project that is having its metadata exported. This project can be either the Cloud Asset API enabled project you're running the export from, or a different project.
- SNAPSHOT_TIME is optional. The value must be current time or a time in the past that you want to take a snapshot of your assets at. By default, a snapshot is taken at the current time.
Optional. Run the command displayed in the
gcloudtool that appears after running the export command to check the status of the export.
gcloud asset operations describe projects/PROJECT_ID/operations/ExportAssets/CONTENT_TYPE/OPERATION_NUMBER
Viewing an asset snapshot
Open the new file you exported your metadata to.
The export lists the assets and their resource names.