THE LINUX FOUNDATION PROJECTS
Docs navigation
On this page

    3.52 SKU Price Details

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

    SKU Price Details represent a list of SKU Price properties (key-value pairs) associated with a specific SKU Price ID. These properties include qualitative and quantitative properties of a SKUs (e.g., functionality and technical specifications), along with core stable pricing properties (e.g., pricing terms, tiers, etc.), excluding dynamic or negotiable pricing elements such as unit price amounts, currency (and related exchange rates), temporal validity (e.g., effective dates), and contract- or negotiation-specific factors (e.g., contract or account identifiers, and negotiable discounts).

    The composition of properties associated with a specific SKU Price may differ across providers and across SKUs within the same provider. However, the exclusion of dynamic or negotiable pricing properties should ensure that all charges with the same SKU Price ID share the same SKU Price Details, i.e., that SKU Price Details remains consistent across different billing periods and billing accounts within a provider.

    SKU Price Details helps practitioners understand and distinguish SKU Prices, each identified by a SKU Price ID and associated with a used or purchased resource or service. It can also help determine the quantity of units for a property when it holds a numeric value (e.g., CoreCount), even when its unit differs from the one in which the SKU is priced and charged, thus supporting FinOps capabilities like unit economics. Additionally, the SKU Price Details may be used to analyze costs based on pricing properties such as terms and tiers.

    The SkuPriceDetails column adheres to the following requirements:

    • SkuPriceDetails MUST be present in a FOCUS dataset when the provider supports unit pricing concepts and publishes price lists, publicly or as part of contracting.
    • SkuPriceDetails MUST conform to KeyValueFormat requirements.
    • SkuPriceDetails property keys SHOULD conform to PascalCase format.
    • SkuPriceDetails nullability is defined as follows:
      • SkuPriceDetails MUST be null when SkuPriceId is null.
      • SkuPriceDetails MAY be null when SkuPriceId is not null.
    • When SkuPriceDetails is not null, SkuPriceDetails adheres to the following additional requirements:
      • SkuPriceDetails MUST be associated with a given SkuPriceId.
      • SkuPriceDetails MUST NOT include properties that are not applicable to the corresponding SkuPriceId.
      • SkuPriceDetails SHOULD include all FOCUS-defined SKU Price properties listed below that are applicable to the corresponding SkuPriceId.
      • SkuPriceDetails MUST include the FOCUS-defined SKU Price property when an equivalent property is included as a Provider-defined property.
      • SkuPriceDetails MAY include properties that are already captured in other dedicated columns.
      • SkuPriceDetails properties for a given SkuPriceId adhere to the following additional requirements:
        • Existing SkuPriceDetails properties SHOULD remain consistent over time.
        • Existing SkuPriceDetails properties SHOULD NOT be removed.
        • Additional SkuPriceDetails properties MAY be added over time.
      • Property key SHOULD remain consistent across comparable SKUs having that property, and the values for this key SHOULD remain in a consistent format.
      • Property key MUST begin with the string "x_" unless it is a FOCUS-defined property.
      • Property value MUST represent the value for a single PricingUnit when the property holds a numeric value.
    • FOCUS-defined SKU Price properties adhere to the following additional requirements:
      • Property key MUST match the spelling and casing specified for the FOCUS-defined property.
      • Property value MUST be of the type specified for that property.
      • Property value MUST represent the value for a single PricingUnit, denominated in the unit of measure specified for that property when the property holds a numeric value.

    3.52.1 Examples

    {
        "StorageClass": "Archive",
        "CoreCount": 4,
        "x_PremiumProcessing": true,
    }
    

    3.52.4 Description

    A set of properties of a SKU Price ID which are meaningful and common to all instances of that SKU Price ID.

    Constraints

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