From 7be8d6f44347bf6fc0f02fa7bc30e8d1747f9994 Mon Sep 17 00:00:00 2001 From: Michael Flanakin Date: Wed, 8 Nov 2023 00:46:50 -0800 Subject: [PATCH] BillingAccountType and SubAccountType --- .../dimensions/billingaccounttype.md | 30 +++++++++++++++++++ specification/dimensions/dimensions.mdpp | 2 ++ specification/dimensions/subaccounttype.md | 30 +++++++++++++++++++ .../dimensions/billingaccounttype.md | 29 ++++++++++++++++++ .../dimensions/subaccounttype.md | 27 +++++++++++++++++ 5 files changed, 118 insertions(+) create mode 100644 specification/dimensions/billingaccounttype.md create mode 100644 specification/dimensions/subaccounttype.md create mode 100644 supporting_content/dimensions/billingaccounttype.md create mode 100644 supporting_content/dimensions/subaccounttype.md diff --git a/specification/dimensions/billingaccounttype.md b/specification/dimensions/billingaccounttype.md new file mode 100644 index 000000000..7a925e6aa --- /dev/null +++ b/specification/dimensions/billingaccounttype.md @@ -0,0 +1,30 @@ +# Billing Account Type + +Billing Account Type is the label the provider uses to describe the kind of the 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 and MUST NOT be null or empty. This column MUST be of type String and MUST NOT be null when BillingAccountId is not null. When BillingAccountId is null, BillingAccountType MUST also be null. Providers MUST use a consistent value-format and a set of values for BillingAccountType values within their cost and usage datasets. + +## 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 required | True | +| Data type | String | +| Allows nulls | False | +| Value format | \ | + +## Introduced (version) + +1.0 diff --git a/specification/dimensions/dimensions.mdpp b/specification/dimensions/dimensions.mdpp index 648093adc..95e4c2a03 100644 --- a/specification/dimensions/dimensions.mdpp +++ b/specification/dimensions/dimensions.mdpp @@ -7,6 +7,7 @@ dimensions to categorize, filter, and reveal details in your data when grouped w !INCLUDE "availabilityzone.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 @@ -29,6 +30,7 @@ dimensions to categorize, filter, and reveal details in your data when grouped w !INCLUDE "servicename.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/ diff --git a/specification/dimensions/subaccounttype.md b/specification/dimensions/subaccounttype.md new file mode 100644 index 000000000..f300dbf9f --- /dev/null +++ b/specification/dimensions/subaccounttype.md @@ -0,0 +1,30 @@ +# Sub Account Type + +Sub Account Type is the label the provider uses to describe the kind of the 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 and MUST NOT be null or empty. This column MUST be of type String and MUST NOT be null when SubAccountId is not null. When SubAccountId is null, SubAccountType MUST also be null. Providers MUST use a consistent value-format and a set of values for SubAccountType values within their cost and usage datasets. + +## 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 required | True | +| Data type | String | +| Allows nulls | False | +| Value format | \ | + +## Introduced (version) + +1.0 diff --git a/supporting_content/dimensions/billingaccounttype.md b/supporting_content/dimensions/billingaccounttype.md new file mode 100644 index 000000000..6e3aa7ba2 --- /dev/null +++ b/supporting_content/dimensions/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/en-us/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" | diff --git a/supporting_content/dimensions/subaccounttype.md b/supporting_content/dimensions/subaccounttype.md new file mode 100644 index 000000000..53e773b6b --- /dev/null +++ b/supporting_content/dimensions/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/en-us/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" |