Document what a scope ID is (#509)

microsoft · Dec 19, 2023 · 9894280 · 9894280
1 parent 14443b0
commit 9894280
Show file tree

Hide file tree

Showing 2 changed files with 6 additions and 2 deletions.
diff --git a/docs/finops-hub/README.md b/docs/finops-hub/README.md
@@ -109,7 +109,7 @@ Once deployed, you can report on the data in Power BI or by connecting to the st
    - **File Partitioning** = On
    - **Storage account** = (Use subscription/resource from step 1)
    - **Container** = `msexports`
-   - **Directory** = (Use the resource ID of the scope you're exporting without the first "/")
+   - **Directory** = (Use the resource ID of the scope<sup>1</sup> you're exporting without the first "/")
 
 4. Run your export.
    - Exports can take up to a day to show up after first created.
@@ -122,6 +122,8 @@ Once deployed, you can report on the data in Power BI or by connecting to the st
 
 If you run into any issues, see [Troubleshooting Power BI reports](../resources/troubleshooting.md).
 
+_<sup>1) A "scope" is an Azure construct that contains resources or enables purchasing services, like a resource group, subscription, management group, or billing account. The resource ID for a scope will be the Azure Resource Manager URI that identifies the scope (e.g., "/subscriptions/###" for a subscription or "/providers/Microsoft.Billing/billingAccounts/###" for a billing account). To learn more, see [Understand and work with scopes](https://aka.ms/costmgmt/scopes).</sup>_
+
 <br>
 
 ## 🛫 Get started with hubs

diff --git a/src/templates/finops-hub/README.md b/src/templates/finops-hub/README.md
@@ -70,14 +70,16 @@ If you run into any issues, see [Troubleshooting FinOps hubs](https://aka.ms/fin
    - **File Partitioning** = On
    - **Storage account** = (Use subscription/resource from step 1)
    - **Container** = `msexports`
-   - **Directory** = (Use the resource ID of the scope you're exporting without the first "/")
+   - **Directory** = (Use the resource ID of the scope<sup>1</sup> you're exporting without the first "/")
 4. Run your export using the **Run now** command
    > Your data should be available within 15 minutes or so, depending on how big your account is.
 5. Connect to the data in Azure Data Lake Storage
    > Consider using [available Power BI reports](https://aka.ms/finops/hubs/reports)
 
 If you run into any issues, see [Troubleshooting FinOps hubs](https://aka.ms/finops/hubs/troubleshoot).
 
+_<sup>1) A "scope" is an Azure construct that contains resources or enables purchasing services, like a resource group, subscription, management group, or billing account. The resource ID for a scope will be the Azure Resource Manager URI that identifies the scope (e.g., "/subscriptions/###" for a subscription or "/providers/Microsoft.Billing/billingAccounts/###" for a billing account). To learn more, see [Understand and work with scopes](https://aka.ms/costmgmt/scopes).</sup>_
+
 <br>
 
 ## 🧰 About the FinOps toolkit