Tags
Tags · Cost and Usage dataset
- Feature level
- Conditional
- Data type
- JSON
- Allows nulls
- Yes
- Column type
- Dimension
What it is
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 cost and usage data to identify and accurately allocate charges. Tags may also be referred to by data generators 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 data generator, this can occur when a tag value is set by provider-defined or user-defined rules.
Requirements (21)
Verbatim from the specification. These are the statements the validator checks against.
- Tags MUST be of type JSON Object (serialized as a String where necessary).
- Tags MUST conform to StringHandling requirements.
- Tags MUST conform to KeyValueFormat requirements.
- Tags MAY be null.
- When Tags is not null, Tags MUST adhere to the following requirements:
- Tags MUST include all user-defined and provider-defined tags.
- Tags MUST only include finalized tags.
- Tags SHOULD include tag keys with corresponding non-null values for a given resource.
- Tags MAY include tag keys with a null value for a given resource depending on the data generator's tag finalization process.
- Tag keys that do not support corresponding values, MUST have a corresponding true (boolean) value set.
- Tag values MUST match the provided values unless true (boolean) is applied to valueless tags.
- Provider-defined tags MUST adhere to the following requirements:
- Provider-defined tag keys MUST be prefixed with a predetermined, provider-specified tag key prefix that is unique to each corresponding provider-specified tag scheme.
- Provider-specified tag key prefixes SHOULD be publicly documented.
- User-defined tags MUST adhere to the following requirements:
- User-defined tag keys in all but one user-defined tag scheme MUST include a predetermined, provider-specified tag key prefix that is unique to each corresponding user-defined tag scheme when the data generator has more than one user-defined tag scheme.
- User-defined tag keys MUST NOT include a tag scheme-specific prefix when the data generator has only one user-defined tag scheme.
- Reserved tag key prefixes MUST be prevented from being used as prefixes for any user-defined tag keys within a prefixless user-defined tag scheme.
- Tag finalization documentation MUST adhere to the following requirements:
- Tag finalization documentation SHOULD include tag finalization methods and semantics.
- Tag finalization documentation SHOULD be accessible to practitioners.
Check your own export
The FOCUS 1.4 validator checks this column and 122 others against your file, in your browser, with no size cap and nothing uploaded.
Other Cost and Usage columns
Definition taken from the FOCUS 1.4 specification. FOCUS is published by the FinOps Foundation under CC BY 4.0.
One column is a definition. A pipeline is a project.
Finitizer ingests FOCUS from every provider you run and reports across all of them.