From c106f541db95d6db2242e9c3f0fa83c9467380db Mon Sep 17 00:00:00 2001
From: Christopher Harris <cnharris@gmail.com>
Date: Thu, 18 Apr 2024 10:02:45 -0700
Subject: [PATCH] Add CommitmentEligibilityName column

---
 specification/columns/columns.mdpp            |  1 +
 .../columns/commitmenteligibilityname.md      | 44 +++++++++++++++++++
 .../columns/commitmentdiscounttype.md         |  1 +
 .../columns/commitmenteligibilityname.md      | 25 +++++++++++
 4 files changed, 71 insertions(+)
 create mode 100644 specification/columns/commitmenteligibilityname.md
 create mode 100644 supporting_content/columns/commitmenteligibilityname.md

diff --git a/specification/columns/columns.mdpp b/specification/columns/columns.mdpp
index 57af24748..5c4c4646b 100644
--- a/specification/columns/columns.mdpp
+++ b/specification/columns/columns.mdpp
@@ -20,6 +20,7 @@ The FOCUS specification defines a group of columns that provide qualitative valu
 !INCLUDE "commitmentdiscountid.md",1
 !INCLUDE "commitmentdiscountname.md",1
 !INCLUDE "commitmentdiscounttype.md",1
+!INCLUDE "commitmenteligibilityname.md",1
 !INCLUDE "contractedcost.md",1
 !INCLUDE "contractedunitprice.md",1
 !INCLUDE "effectivecost.md",1
diff --git a/specification/columns/commitmenteligibilityname.md b/specification/columns/commitmenteligibilityname.md
new file mode 100644
index 000000000..e9ea2074a
--- /dev/null
+++ b/specification/columns/commitmenteligibilityname.md
@@ -0,0 +1,44 @@
+# Commitment Eligibility Name
+
+Commitment Eligibility Name is the string value representing whether an on-demand, usage-based charge is eligible for one or more commitment-based discounts.
+
+CommitmentEligibilityName MUST be present in the billing data when the provider supports *commitment-based discounts*.
+
+A CommitmentEligibilityName value MUST be applied to a [*row*](#glossary:row) when a row's ChargeCategory is *Usage*, ChargeSubCategory is *On-Demand* and the SkuId is eligible for one or more commitments offered by the provider.
+
+In all other cases, CommitmentEligibilityName MUST be null.
+
+## Column ID
+
+CommitmentEligibilityName
+
+## Display Name
+
+Commitment Eligibility Name
+
+## Description
+
+The string value representing whether an on-demand, usage-based charge is eligible for one or more commitment-based discounts.
+
+## Content constraints
+
+| Constraint      | Value          |
+|:----------------|:---------------|
+| Column type     | Dimension      |
+| Feature level   | Conditional    |
+| Allows nulls    | True           |
+| Data type       | String         |
+| Value format    | Allowed values |
+
+Allowed values:
+
+| Value       | Description                   |
+|:------------|:------------------------------|
+| Resource    | On-demand, usage-based charges that are eligible for commitments matching a resource or particular set of resource's operations. |
+| Spend       | On-demand, usage-based charges that are eligible for commitments applied towards a monetary goal. |
+| Other       | On-demand, usage-based charges that are eligible for provider-specific commitments that are not resource or spend specific. |
+| Multiple    | On-demand, usage-based charges that are eligible for 2 or more a *Resource*, *Spend*, and/or *Other* commitment-based discounts. |
+
+## Introduced (version)
+
+1.1
diff --git a/supporting_content/columns/commitmentdiscounttype.md b/supporting_content/columns/commitmentdiscounttype.md
index f64a7f538..eb6897cab 100644
--- a/supporting_content/columns/commitmentdiscounttype.md
+++ b/supporting_content/columns/commitmentdiscounttype.md
@@ -18,6 +18,7 @@ Examples of found in available data sets:
 | AWS | Savings Plan |
 | AWS | Capacity Blocks for ML |
 | Google Cloud | Committed Use Discount (CUD) |
+| Google Cloud | Flex Committed Use Discount (Flex CUD) |
 | Google Cloud | BigQuery Reservations |
 | Microsoft | Savings Plan |
 | Microsoft | Reservation |
diff --git a/supporting_content/columns/commitmenteligibilityname.md b/supporting_content/columns/commitmenteligibilityname.md
new file mode 100644
index 000000000..cd364a027
--- /dev/null
+++ b/supporting_content/columns/commitmenteligibilityname.md
@@ -0,0 +1,25 @@
+# Column: CommitmentEligibilityName
+
+## Example provider mappings
+
+| Provider  | Data set                 | Column        |
+| --------- | ------------------------ | ------------- |
+| AWS       | CUR                      | Not available |
+| GCP       | Big Query Billing Export | Not available |
+| Microsoft | Cost details             | Not available |
+
+## Example usage scenarios
+
+Examples of found in available data sets:
+
+| Provider | Example Values                             | Commitment Eligibility Name |
+|----------|--------------------------------------------------------------------------|
+| AWS | Reserved Instances (RI)                         | Resource                    |
+| AWS | Savings Plan                                    | Spend                       |
+| Google Cloud | Committed Use Discount (CUD)           | Resource                    |
+| Google Cloud | Flex Committed Use Discount (Flex CUD) | Resource                    |
+| Google Cloud | BigQuery Reservations                  | Resource                    |
+| Microsoft | Reservation                               | Resource                    |
+| Microsoft | Savings Plan                              | Spend                       |
+
+Additionally, typical SaaS annual commits should also fall under *Spend*.
\ No newline at end of file