THE LINUX FOUNDATION PROJECTS
Docs navigation
On this page

    3.1.5 Allocated Tags

    Dataset: Cost and Usage
    Column Type: Dimension
    Feature Level: Conditional
    Data Type: JSON
    Since: 1.3

    The Allocated Tags column represents the set of tags assigned to tag sources which are specifically applicable to allocated charges resulting from a data generator-calculated split cost allocation.

    3.1.5.1 Requirements

    AllocatedTags adheres to the following requirements:

    • AllocatedTags MUST be present in a Cost and Usage FOCUS dataset when the service provider supports Data Generator-Calculated Split Cost Allocation.
    • AllocatedTags MUST conform to KeyValueFormat requirements.
    • AllocatedTags nullability is defined as follows:
      • AllocatedTags MUST be null when a charge is not related to a data generator-calculated split cost allocation.
      • AllocatedTags MAY be null in all other cases.
    • When AllocatedTags is not null, AllocatedTags adheres to the following additional requirements:
      • AllocatedTags MUST NOT include resource tags already present in Tags.
      • AllocatedTags MUST include all applicable user-defined and data generator-defined tags for the AllocatedResourceId.
      • Tag keys that do not support corresponding values MUST have a corresponding true (boolean) value set.
      • Data generator MUST NOT alter tag values unless applying true (boolean) to valueless tags.
    • Data generator-defined tags adhere to the following additional requirements:
      • Data generator-defined tag keys MUST be prefixed with a predetermined, data generator-specified tag key prefix that is unique to each corresponding provider-specified tag scheme.
      • Data generator SHOULD publish all data generator-specified tag key prefixes within their respective documentation.
    • User-defined tags adhere to the following additional requirements:
      • Data generator MUST prefix all user-defined tags scheme with a predetermined, data generator-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.

    3.1.5.2 Data Generator-Defined vs. User-Defined Tags

    This example illustrates various tags produced from multiple user-defined and data generator-defined tag schemes. The first two tags illustrate examples from two different, user-defined tag schemes. The second tag is produced from a valueless, user-defined tag scheme, so the data generator also applies true as its default value.

    The last two tags illustrate examples from two different, data generator-defined tag schemes.

        {
            "userDefinedTagScheme1/foo": "bar",
            "userDefinedTagScheme2/foo": true,
            "providerDefinedTagScheme1/foo": "bar",
            "providerDefinedTagScheme2/foo": "bar"
        }
    

    3.1.5.5 Description

    A set of tags assigned to tag sources that are applicable to allocated charges in data generator-calculated split cost allocation.

    Constraints

    Property Value
    Column Type Dimension
    Feature Level Conditional
    Allows Nulls Yes
    Data Type JSON
    Value Format Key-Value Format