vantage_virtual_tag_config (Resource)

​

Overview

​

Example Usage

data "vantage_virtual_tag_configs" "demo" {}
resource "vantage_virtual_tag_config" "demo_virtual_tag_config" {
  key            = "Demo Tag"
  backfill_until = "2024-01-01"
  overridable    = true
  values = [
    {
      name   = "Demo Value 0"
      filter = "(costs.provider = 'aws' AND costs.region = 'us-east-1') OR (costs.provider = 'gcp' AND costs.region = 'us-central1')"
    },
    {
      filter = "(costs.provider = 'aws' AND costs.service = 'AwsApiGateway')"
      cost_metric = {
        aggregation = {
          tag = "environment"
        }
        filter = "(costs.provider = 'aws' AND costs.service = 'AmazonECS')"
      }
    },
    # {
    #   filter = "(costs.provider = 'aws' AND costs.service = 'AmazonECS')"
    #   business_metric_token = ""
    # }
    # Example: apply label_transforms to a business-metric-backed value to
    # split a "&&&"-delimited project label and reformat it into a team tag.
    # {
    #   filter                = "costs.provider = 'aws'"
    #   business_metric_token = "bsnss_mtrc_XXXXXXXX"
    #   label_transforms = [
    #     { type = "split", delimiter = "&&&", index = 0 },
    #     { type = "format", template = "team-{0}" },
    #   ]
    # }
  ]
}

​

Schema

​

Required

• key (String) The key of the VirtualTagConfig.
• overridable (Boolean) Whether the VirtualTagConfig can override a provider-supplied tag on a matching Cost.

​

Optional

• backfill_until (String) The earliest month the VirtualTagConfig should be backfilled to.
• collapsed_tag_keys (Attributes List) Tag keys to collapse values for. (see below for nested schema)
• values (Attributes List) Values for the VirtualTagConfig, with match precedence determined by order in the list. (see below for nested schema)

​

Read-Only

• created_by_token (String) The token of the Creator of the VirtualTagConfig.
• id (String) The id of the VirtualTagConfig.
• token (String) The token of the VirtualTagConfig.

​

Nested Schema for collapsed_tag_keys

• key (String) The tag key to collapse values for.

• filter (String) The VQL filter this collapsed tag key applies to. When set, do not also set providers; include any provider restrictions directly in filter.
• providers (List of String) Provider-only scope for this collapsed tag key. Invalid when filter is set; include provider restrictions in filter instead. Defaults to all providers.

​

Nested Schema for values

• filter (String) The filter query language to apply to the value. Additional documentation available at https://docs.vantage.sh/vql.

• business_metric_token (String) The token of an associated business metric.
• cost_metric (Attributes) (see below for nested schema)
• date_ranges (Attributes List) Date ranges restricting when this value applies. Each range has optional start_date and end_date (inclusive, YYYY-MM-DD). (see below for nested schema)
• display_name (String) The display name for an allocation value (cost_metric or percentages). Invalid when name is set.
• label_key (String) The business metric label key used for this virtual tag value.
• label_transforms (Attributes List) Label transforms applied to business metric labels. (see below for nested schema)
• label_values (List of String) Optional business metric label values. An empty array includes every value for the label key.
• name (String) The name of the value.
• percentages (Attributes List) Labeled percentage allocations for matching costs. (see below for nested schema)
• token (String) The token of the Value.

​

Nested Schema for values.cost_metric

• aggregation (Attributes) (see below for nested schema)
• filter (String) The filter VQL for the cost metric.

​

Nested Schema for values.cost_metric.aggregation

• tag (String) The tag to aggregate on.

​

Nested Schema for values.date_ranges

• end_date (String) Inclusive end date (YYYY-MM-DD), or null for unbounded.
• start_date (String) Inclusive start date (YYYY-MM-DD), or null for unbounded.

​

Nested Schema for values.label_transforms

• type (String) The label transform type.

• delimiter (String) Delimiter used by split transforms.
• index (Number) Zero-based index used by split transforms.
• template (String) Template used by format transforms.

​

Nested Schema for values.percentages

• pct (Number)
• value (String) The tag value associated with a percentage of matched costs.