Overview

📘
The Virtual Tags Import API allows you to:

Upload large CSV files (up to 5GB) with virtual tag assignments

Choose between adding new tags or replacing all existing tags

Monitor import progress through processing phases

Handle compressed files for faster uploads

Requires Cost Allocation Editor permissions
Maximum file size: 5GB
Rate limit: 2 imports per hour per account
Supported file formats
- CSV - Standard comma separated value file. Extension: .csv
- Compressed CSV - Gzip compressed CSV for large uploads. Extension: .csv.gz

✅
Good to know
The import CSV format is identical to the export format from the virtual tags page.

To update you vTags

Download the CSV from the UI

Modify the virtual tags column according to need

Re-import the modified file

File Structure

Your CSV file must contain exactly 8 columns in the following order:

Column	Name	Required	Max Length	Description
1	Resource Cost	No	-	Cost value (informational only)
2	Resource Name	No	-	Friendly name of the resource
3	Resource ID	Yes	255 chars	Unique identifier for the resource
4	Service	No	-	Cloud service type (e.g., EC2, S3)
5	Region	No	-	Cloud region
6	Linked Account	Yes	64 chars	Cloud account identifier
7	Virtual Tags	No	-	Virtual tags to apply
8	Tags	No	-	Existing resource tags (informational)

Sample CSV

Resource Cost,Resource Name,Resource ID,Service,Region,Linked Account,Virtual Tags,Tags
125.50,web-server-1,i-0abc123def456,EC2,us-east-1,123456789012,Environment:Production;Team:Platform,Name:web-server-1
45.00,db-primary,i-0xyz789ghi012,RDS,us-west-2,123456789012,Environment:Production;Team:Data,Name:db-primary
0,storage-bucket,my-data-bucket,S3,us-east-1,123456789012,CostCenter:Engineering,,