Merge pull request #291861 from bandersmsft/cloud-footprint-update

MCM - Cloud footprint update

Author: PMEds28

articles/cost-management-billing/manage/discover-cloud-footprint.md

@@ -3,7 +3,7 @@ title: Discover your Microsoft cloud footprint FAQ
 description: This article helps to answer frequently asked questions that customers have about their Microsoft cloud footprint.
 author: bandersmsft
 ms.author: banders
-ms.date: 09/17/2024
+ms.date: 12/11/2024
 ms.topic: conceptual
 ms.service: cost-management-billing
 ms.subservice: cost-management
@@ -60,13 +60,13 @@ Microsoft 365 customers can use the following information to view their billing
 
 ## How can I view every billing account created for a tenant?
 
-Global Administrators can view all direct billing accounts at the organization level and can elevate their billing account permissions. Purchases made for individual use by non-administrators are only visible to and managed by the original purchaser.
+Global Administrators can view all direct billing accounts at the organization level and can elevate their billing account permissions. Purchases made for individual use by users that aren't administrators are only visible to and managed by the original purchaser.
 
 For more information, see [Elevate access to manage billing accounts](elevate-access-global-admin.md).
 
 ## How can I view employees participating in other tenants?
 
-Global Administrators can view log data showing employee activity in other tenants. For more information, see [Cross-tenant access activity workbook in Azure AD](/entra/identity/monitoring-health/workbook-cross-tenant-access-activity).
+Global Administrators can view log data showing employee activity in other tenants. For more information, see [Cross-tenant access activity workbook](/entra/identity/monitoring-health/workbook-cross-tenant-access-activity).
 
 ## How do I view my partner billing information?
 
@@ -75,7 +75,7 @@ As a partner, you can see your partner billing account, billing group, and assoc
 - [View your billing accounts in Azure portal](view-all-accounts.md#microsoft-partner-agreement)
 - [Get started with your Microsoft Partner Agreement billing account](../understand/mpa-overview.md)
 
-A customer can’t view the billing account or billing group that’s managed by a partner because the partner makes purchases on behalf of their customer.
+A customer can’t view the billing account or billing group managed by a partner because the partner makes purchases on behalf of their customer.
 
 ## How do I view my organization’s billing account and tenant information?
 
@@ -99,13 +99,69 @@ The article provides details about all types of Azure accounts.
 
 ## How do I manage purchases that I made myself?
 
-Administrators can manage trials and purchases that they made, and self-service purchases and trials made by non-administrators. For more information, see [Manage self-service purchases and trials (for admins)](/microsoft-365/commerce/subscriptions/manage-self-service-purchases-admins).
+Administrators can manage trials and purchases that they made, and self-service purchases and trials made by users that aren't administrators. For more information, see [Manage self-service purchases and trials (for admins)](/microsoft-365/commerce/subscriptions/manage-self-service-purchases-admins).
 
 ## How can I get a list of subscriptions and tenants for a billing account?
 
-You can view the tenants associated with a subscription in the Azure portal on the **Subscriptions** page under **Cost Management + Billing**.
-
-## How can I view the Azure tenant that I am currently signed in to?
+In the Azure portal, you can view the tenants associated with a subscription on the **Subscriptions** page under **Cost Management + Billing**.
+
+Programmatically, you can use the publicly available API to get billing accounts that returns all associated billing subscriptions. The API also supports an optional header that returns all tenant IDs associated with the billing account. For more information, see [Billing Subscriptions - List By Billing Account](/rest/api/billing/billing-subscriptions/list-by-billing-account).
+
+CLI snippet:
+
+```azurecli
+# login 
+az login 
+# Get BillingAccounts 
+az rest --method get --url 	https://management.azure.com/providers/Microsoft.Billing/billingAccounts?api-version=2024-04-01
+ 
+ 
+# Get BillingSubscriptions with provisioning tenant 
+az rest --method get --url 	https://management.azure.com/providers/Microsoft.Billing/billingAccounts/<BillingAccountId>/billingSubscriptions?api-version=2024-04-01 --headers x-ms-service-tenant-info=true 
+```
+
+Sample call:
+
+```azurecli
+az rest --method get --url 'https://management.azure.com/providers/Microsoft.Billing/billingAccounts/aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb:bbbbbbbb-1111-2222-3333-cccccccccccc_2019-05-31/billingSubscriptions?api-version=2024-04-01' --headers x-ms-service-tenant-info=true
+```
+
+Sample response:
+
+```json
+{  
+  "value": [
+    {
+      "id": "/providers/Microsoft.Billing/billingAccounts/aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb:bbbbbbbb-1111-2222-3333-cccccccccccc_2019-05-31/billingSubscriptions/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e",
+      "name": "aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e",
+      "properties": {
+        "autoRenew": "Off",
+        "billingFrequency": "P1M",
+        "billingProfileDisplayName": "Contoso Partner & Field Experiences",
+        "billingProfileId": "/providers/Microsoft.Billing/billingAccounts/aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb:bbbbbbbb-1111-2222-3333-cccccccccccc_2019-05-31/billingProfiles/CustomerLedAccount_BG3",
+        "billingProfileName": "ContosoAccount_BG3",
+        "displayName": "Test sub for Ingestion",
+        "invoiceSectionDisplayName": "Contoso Ingestion Publishing Service",
+        "invoiceSectionId": "/providers/Microsoft.Billing/billingAccounts/aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb:bbbbbbbb-1111-2222-3333-cccccccccccc_2019-05-31/billingProfiles/CustomerLedAccount_BG3/invoiceSections/AAAA-BBBB-CCC-DDD",
+        "invoiceSectionName": "AAAA-BBBB-CCC-DDD",
+        "operationStatus": "None",
+        "productCategory": "UsageBased",
+        "productType": "Usage based",
+        "productTypeId": "DZH318Z0BPS6",
+        "provisioningTenantId": "aaaabbbb-0000-cccc-1111-dddd2222eeee",
+        "purchaseDate": "2020-10-26T16:55:39.4792007Z",
+        "quantity": 1,
+        "skuDescription": "Microsoft Azure Plan",
+        "skuId": "0001",
+        "status": "Active",
+        "subscriptionId": "aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e"
+      },
+      "type": "Microsoft.Billing/billingAccounts/billingSubscriptions"
+    }
+}
+```
+
+## How can I view the Azure tenant that I'm currently signed in to?
 
 You can view your tenant information in the Azure portal using the information at [Manage Azure portal settings and preferences](/azure/azure-portal/set-preferences).
 
@@ -152,7 +208,7 @@ You can view tenants with B2B relationships in the [Cross-tenant access activity
 
 ## How can I take over unmanaged directories owned by my organization?
 
-Review the domains in your registrar that aren’t verified to your tenant. If you can’t register a domain that you reserved in your registrar, it might be associated with an unmanaged directory. Global administrators can claim or take over unmanaged directories (also called _unmanaged tenants_) that were created by members of their organization through free sign-up offers. If your registrar shows you pay for a domain that isn’t part of your home tenant, it might be used in an unmanaged directory. For more information, see [Admin takeover of an unmanaged directory](/entra/identity/users/domains-admin-takeover).
+Review the domains in your registrar that aren’t verified to your tenant. If you can’t register a domain that you reserved in your registrar, it might be associated with an unmanaged directory. Global administrators can claim or take over unmanaged directories (also called _unmanaged tenants_). Members of their organization potentially created them through free sign-up offers. If your registrar shows you pay for a domain that isn’t part of your home tenant, it might be used in an unmanaged directory. For more information, see [Admin takeover of an unmanaged directory](/entra/identity/users/domains-admin-takeover).
 
 ## How can I regain access to a tenant owned by my organization?
 
@@ -169,7 +225,7 @@ You can also restrict subscriptions from moving from one tenant to another. It
 
 ## How can I review audit logs for tenants created by users in my organization?
 
-You can view audit logs in the Microsoft Entra admin center. Events relating to tenant creation are tagged as Directory Management. For more information, see [Azure Active Directory (Azure AD) audit activity reference](/azure/active-directory/reports-monitoring/reference-audit-activities).
+You can view audit logs in the Microsoft Entra admin center. Events relating to tenant creation are tagged as Directory Management. For more information, see [Microsoft Entra audit log categories and activities](/entra/identity/monitoring-health/reference-audit-activities).
 
 To learn about notifications for audit log events, follow the tutorial in [Enable security notifications for audit log events](/entra/identity/authentication/tutorial-enable-security-notifications-for-audit-logs).