diff --git a/docs/assets/resource-tagging-example.png b/docs/assets/resource-tagging-example.png new file mode 100644 index 000000000..43dc899ed Binary files /dev/null and b/docs/assets/resource-tagging-example.png differ diff --git a/docs/azure-tre-overview/tre-resources-breakdown.md b/docs/azure-tre-overview/tre-resources-breakdown.md index 1a5825795..56b5ad8b4 100644 --- a/docs/azure-tre-overview/tre-resources-breakdown.md +++ b/docs/azure-tre-overview/tre-resources-breakdown.md @@ -73,4 +73,16 @@ A TRE Workspace will be provisioned in a separate Resource Group along with its ## Running costs -The exact running costs will depend on the number of workspaces you have deployed, the workspace services you have enabled within them and the Azure Data center region. You can use the [Azure Pricing Calculator](https://azure.microsoft.com/en-gb/pricing/calculator/) on the above services to get an indicative idea of running costs, or contact your Microsoft representative for further guidance. +The exact running costs will depend on the number of workspaces you have deployed, the workspace services you have enabled within them and the Azure Data center region. You can use the Azure TRE cost API to get a report of the running costs. + +Cost API is based on [Azure Cost Management](https://docs.microsoft.com/en-us/azure/cost-management-billing/) and [TRE Templates azure resource tagging](../tre-workspace-authors/authoring-workspace-templates.md#azure-resources-tagging). + +Cost and usage data is typically available in Cost Management within 8-24 hours. + +Tags aren't applied to historical data, template authors need to make sure all relavent [Azure resources of a TRE resource are tagged as instructed](../tre-workspace-authors/authoring-workspace-templates.md#azure-resources-tagging). + +Cost records might include [multiple currencies](https://azure.microsoft.com/en-us/blog/azure-cost-management-updates-july-2019/#currency) for the same date and TRE resource. + +Once cost data becomes available in Cost Management, it will be retained for at least seven years. Only the last 13 months is available from the TRE Cost API and Azure Portal. For historical data before 13 months, please use [Exports](https://docs.microsoft.com/en-us/azure/cost-management-billing/costs/tutorial-export-acm-data?tabs=azure-portal) or the [UsageDetails API](https://docs.microsoft.com/en-us/rest/api/consumption/usage-details/list?tabs=HTTP). + +For more information please refer to [Azure Cost Management](https://docs.microsoft.com/en-us/azure/cost-management-billing/costs/understand-cost-mgt-data) and Cost API swagger docs. diff --git a/docs/tre-workspace-authors/authoring-workspace-templates.md b/docs/tre-workspace-authors/authoring-workspace-templates.md index e4127012a..b19a9188c 100644 --- a/docs/tre-workspace-authors/authoring-workspace-templates.md +++ b/docs/tre-workspace-authors/authoring-workspace-templates.md @@ -111,6 +111,26 @@ The mandatory parameters for User Resources are: | `tre_id` | string | Unique ID of for the TRE instance. | `tre-dev-42` | | `workspace_id` | string | Unique 4-character long, alphanumeric workspace ID. | `0a9e` | +## Azure Resources Tagging + +TRE Cost Reporting is based on Azure tagging to be able to generate cost report for core services, shared services, workspace, workspace services and user resources. +Templates authors need to make sure that underling Azure resources are tagged with the following tags: + + +|