FOCUS #317: BillingAccountType and SubAccountType

specification/columns/billingaccounttype.md

@@ -0,0 +1,31 @@
+# Billing Account Type
+
+Billing Account Type is the label the provider uses to describe the kind of [*billing account*](#glossary:billing-account). Billing Account Type is a readable display name and not a code. Billing Account Type is commonly used for scenarios like mapping FOCUS constructs to provider constructs and summarizing costs across providers.
+
+The BillingAccountType column MUST be present in the billing data. This column MUST be of type String, MUST be null when [BillingAccountId](#billingaccountid) is null, and MUST NOT be null when BillingAccountId is not null. BillingAccountType MUST be a consistent, readable display value within the billing data.
+
+## Column ID
+
+BillingAccountType
+
+## Display Name
+
+Billing Account Type
+
+## Description
+
+Label the provider uses to describe the kind of billing account.
+
+## Content Constraints
+
+| Constraint      | Value            |
+| :-------------- | :--------------- |
+| Column type     | Dimension        |
+| Column required | True             |
+| Allows nulls    | False            |
+| Data type       | String           |
+| Value format    | \<not specified> |
+
+## Introduced (version)
+
+1.0

specification/columns/columns.mdpp

@@ -6,6 +6,7 @@ The FOCUS specification defines a group of columns that provide qualitative valu
 !INCLUDE "billedcost.md",1
 !INCLUDE "billingaccountid.md",1
 !INCLUDE "billingaccountname.md",1
+!INCLUDE "billingaccounttype.md",1
 !INCLUDE "billingcurrency.md",1
 !INCLUDE "billingperiodend.md",1
 !INCLUDE "billingperiodstart.md",1
@@ -44,6 +45,7 @@ The FOCUS specification defines a group of columns that provide qualitative valu
 !INCLUDE "skupriceid.md",1
 !INCLUDE "subaccountid.md",1
 !INCLUDE "subaccountname.md",1
+!INCLUDE "subaccounttype.md",1
 !INCLUDE "tags.md",1
 
 [FODOFC]: https://www.finops.org/framework/capabilities/

specification/columns/commitmentdiscounttype.md

@@ -2,7 +2,7 @@
 
 Commitment Discount Type is a provider-assigned name to identify the type of [*commitment-based discount*](#glossary:commitment-based-discount) applied to the [*row*](#glossary:row).
 
-The CommitmentDiscountType column MUST be present in the billing data when the provider supports *commitment-based discounts*. This column MUST be of type String, MUST be null when [CommitmentDiscountId](#commitmentdiscountid) is null, and MUST NOT be null when CommitmentDiscountId is not null.
+The CommitmentDiscountType column MUST be present in the billing data when the provider supports *commitment-based discounts*. This column MUST be of type String, MUST be null when [CommitmentDiscountId](#commitmentdiscountid) is null, and MUST NOT be null when CommitmentDiscountId is not null. CommitmentDiscountType MUST be a consistent, readable display value within the billing data.
 
 ## Column ID
 
@@ -16,7 +16,7 @@ Commitment Discount Type
 
 A provider-assigned identifier for the type of *commitment-based discount* applied to the *row*.
 
-## Content constraints
+## Content Constraints
 
 | Constraint      | Value            |
 |:----------------|:-----------------|

specification/columns/subaccounttype.md

@@ -0,0 +1,31 @@
+# Sub Account Type
+
+Sub Account Type is the label the provider uses to describe the kind of [*sub account*](#glossary:sub-account). Sub Account Type is a readable display name and not a code. Sub Account Type is commonly used for scenarios like mapping FOCUS constructs to provider constructs and summarizing costs across providers.
+
+The SubAccountType column MUST be present in the billing data. This column MUST be of type String, MUST be null when [SubAccountId](#subaccountid) is null, and MUST NOT be null when SubAccountId is not null. SubAccountType MUST be a consistent, readable display value within the billing data.
+
+## Column ID
+
+SubAccountType
+
+## Display Name
+
+Sub Account Type
+
+## Description
+
+Label the provider uses to describe the kind of sub account.
+
+## Content Constraints
+
+| Constraint      | Value            |
+| :-------------- | :--------------- |
+| Column type     | Dimension        |
+| Column required | True             |
+| Allows nulls    | True             |
+| Data type       | String           |
+| Value format    | \<not specified> |
+
+## Introduced (version)
+
+1.0

supporting_content/columns/billingaccounttype.md

@@ -0,0 +1,29 @@
+# Column: BillingAccountType
+
+## Example provider mappings
+
+Current column mappings found in available data sets:
+
+| Provider  | Data set                | Column        |
+| --------- | ----------------------- | ------------- |
+| AWS       | CUR                     | Not available |
+| GCP       | BigQuery Billing Export | Not available |
+| Microsoft | Cost details            | Not available |
+
+## Documentation
+
+- GCP: [Resource Hierarchy](https://cloud.google.com/resource-manager/docs/cloud-platform-resource-hierarchy#resource-hierarchy-detail)
+- Azure: [Organizing resources](https://learn.microsoft.com/azure/cost-management-billing/manage/view-all-accounts)
+- AWS: [Org Concepts](https://docs.aws.amazon.com/organizations/latest/userguide/orgs_getting-started_concepts.html)
+
+## Example usage scenarios
+
+Current terms used by providers:
+
+| Provider  | Scenario      | Value                |
+| --------- | ------------- | -------------------- |
+| AWS       | Not available | "Management Account" |
+| GCP       | Not available | "Billing Account"    |
+| Microsoft | EA            | "Billing Account"    |
+| Microsoft | MCA/MPA       | "Billing Profile"    |
+| Microsoft | Other         | "Subscription"       |

supporting_content/columns/subaccounttype.md

@@ -0,0 +1,27 @@
+# Column: SubAccountType
+
+## Example provider mappings
+
+Current column mappings found in available data sets:
+
+| Provider  | Data set                | Column        |
+| --------- | ----------------------- | ------------- |
+| AWS       | CUR                     | Not available |
+| GCP       | BigQuery Billing Export | Not available |
+| Microsoft | Cost details            | Not available |
+
+## Documentation
+
+- GCP: [Resource Hierarchy](https://cloud.google.com/resource-manager/docs/cloud-platform-resource-hierarchy#resource-hierarchy-detail)
+- Azure: [Organizing resources](https://learn.microsoft.com/azure/cost-management-billing/manage/view-all-accounts)
+- AWS: [Org Concepts](https://docs.aws.amazon.com/organizations/latest/userguide/orgs_getting-started_concepts.html)
+
+## Example usage scenarios
+
+Current terms used by providers:
+
+| Provider  | Value            |
+| --------- | ---------------- |
+| AWS       | "Member Account" |
+| GCP       | "Project"        |
+| Microsoft | "Subscription"   |