Constraints

Column type
Dimension
Feature level
Conditional
Allows nulls
Yes
Data type
JSON
Value format
Key-Value Format

Description

The Tags column represents the set of tags assigned to tag sources that also account for potential provider-defined or user-defined tag evaluations. Tags are commonly used for scenarios like adding business context to billing data to identify and accurately allocate charges. Tags may also be referred to by providers using other terms such as labels.

A tag becomes finalized when a single value is selected from a set of possible tag values assigned to the tag key. When supported by a provider, this can occur when a tag value is set by provider-defined or user-defined rules.

The Tags column adheres to the following requirements:

  • The Tags column MUST be present in the billing data when the provider supports setting user or provider-defined tags.
  • The Tags column MUST contain user-defined and provider-defined tags.
  • The Tags column MUST only contain finalized tags.
  • The Tags column MUST be in Key-Value Format.
  • A Tag key with a non-null value for a given resource SHOULD be included in the tags column.
  • A Tag key with a null value for a given resource MAY be included in the tags column depending on the provider's tag finalization process.
  • A Tag key that does not support a corresponding value, MUST have a corresponding true (boolean) value set.
  • If Tag finalization is supported, providers MUST publish tag finalization methods and semantics within their respective documentation.
  • Providers MUST NOT alter user-defined Tag keys or values.

Provider-defined Tags additionally adhere to the following requirements:

  • Provider-defined tags MUST be prefixed with a provider-specified tag key prefix.
  • Providers SHOULD publish all provider-specified tag key prefixes within their respective documentation.
Read the source on focus.finops.org ↗