Merge pull request #275488 from bandersmsft/acrolinx-may-2024

MCM - Acrolinx fixes

Author: denrea

articles/cost-management-billing/automate/get-usage-details-legacy-customer.md

@@ -4,7 +4,7 @@ titleSuffix: Microsoft Cost Management
 description: This article explains how you get cost data if you have a MOSP pay-as-you-go subscription.
 author: bandersmsft
 ms.author: banders
-ms.date: 11/17/2023
+ms.date: 05/14/2024
 ms.topic: conceptual
 ms.service: cost-management-billing
 ms.subservice: cost-management
@@ -13,22 +13,22 @@ ms.reviewer: jojoh
 
 # Get cost details for a pay-as-you-go subscription
 
-If you have an MSDN, Microsoft Online Service Program (MOSP) pay-as-you-go, or Visual Studio Azure subscription, we recommend that you use [Exports](../costs/tutorial-export-acm-data.md) or the [Exports API](../costs/ingest-azure-usage-at-scale.md) to get cost details data (formerly known as usage details). The [Cost Details](/rest/api/cost-management/generate-cost-details-report) API report isn't supported for your subscription type yet.
+If your subscription is through Microsoft Online Service Program (MOSP) pay-as-you-go, or Visual Studio, we suggest using [Exports](../costs/tutorial-export-acm-data.md) or the [Exports API](../costs/ingest-azure-usage-at-scale.md) to access detailed cost data, previously referred to as usage details. The [Cost Details](/rest/api/cost-management/generate-cost-details-report) API report isn't supported for your subscription type yet.
 
-If you need to download small datasets and you don't want to use Azure Storage, you can also use the Consumption Usage Details API. Instructions about how to use the API are below. 
+If you need to download small datasets and you don't want to use Azure Storage, you can also use the Consumption Usage Details API. To use the API, read the following instructions.
 
 > [!NOTE]
-> The API is deprecated for all customers except those with MSDN, pay-as-you-go and Visual Studio subscriptions. If you're an EA or MCA customer don't use this API. 
+> The API is deprecated for all customers except those with pay-as-you-go and Visual Studio subscriptions. If you're an EA or MCA customer don't use this API.
 
-The date that the API will be turned off is still being determined. The [Cost Details](/rest/api/cost-management/generate-cost-details-report) API will be updated to support MSDN, pay-as-you-go and Visual studio subscriptions prior to the deprecation of the Consumption Usage Details API.
+The exact date for discontinuing the API is undetermined. Before the Consumption Usage Details API is deprecated, the [Cost Details](/rest/api/cost-management/generate-cost-details-report) API will get updates to support both pay-as-you-go and Visual Studio subscriptions.
 
 ## Example Consumption Usage Details API requests
 
 The following example requests are used by Microsoft customers to address common scenarios.
 
 ### Get usage details for a scope during a specific date range
 
-The data that's returned by the request corresponds to the date when the data was received by the billing system. It might include costs from multiple invoices. The call to use varies by your subscription type.
+The data that gets returned by the request corresponds to the date when the data got received by the billing system. It might include costs from multiple invoices. The call to use varies by your subscription type.
 
 For pay-as-you-go subscriptions, use the following call.
 

articles/cost-management-billing/automate/partner-automation.md

@@ -4,7 +4,7 @@ titleSuffix: Microsoft Cost Management
 description: This article explains how Microsoft partners and their customers can use Cost Management APIs for common tasks.
 author: bandersmsft
 ms.author: banders
-ms.date: 11/17/2023
+ms.date: 05/14/2024
 ms.topic: conceptual
 ms.service: cost-management-billing
 ms.subservice: cost-management
@@ -13,13 +13,13 @@ ms.reviewer: jojoh
 
 # Automation for partners
 
-Azure Cost Management is natively available for direct partners who have onboarded their customers to a Microsoft Customer Agreement and have [purchased an Azure Plan](/partner-center/purchase-azure-plan). Partners and their customers can use Cost Management APIs common tasks. For more information about non-automation scenarios, see [Cost Management for Partners](../costs/get-started-partners.md).
+Microsoft Cost Management is natively available for direct partners who onboarded their customers to a Microsoft Customer Agreement and [purchased an Azure Plan](/partner-center/purchase-azure-plan). Partners and their customers can use Cost Management APIs common tasks. For more information about nonautomation scenarios, see [Cost Management for Partners](../costs/get-started-partners.md).
 
-## Azure Cost Management APIs - Direct and indirect providers
+## Microsoft Cost Management APIs - Direct and indirect providers
 
 Partners with access to billing scopes in a partner tenant can use the following APIs to view invoiced costs.
 
-APIs at the subscription scope can be called by a partner regardless of the cost policy, as long as they have access to the subscription. Other users with access to the subscription, like the customer or reseller, can call the APIs only after the partner enables the cost policy for the customer tenant.
+Partners can call APIs at the subscription scope regardless of the cost policy, as long as they have access to the subscription. Other users with access to the subscription, like the customer or reseller, can call the APIs only after the partner enables the cost policy for the customer tenant.
 
 ### To get a list of billing accounts
 
@@ -39,7 +39,7 @@ GET https://management.azure.com/providers/Microsoft.Billing/billingAccounts/{bi
 GET https://management.azure.com/providers/Microsoft.Billing/billingAccounts/{billingAccountName}/billingSubscriptions?api-version=2019-10-01-preview 
 ```
 
-### To get a list of invoices for a period of time
+### To get a list of invoices for a specific period
 
 ```http
 GET https://management.azure.com/providers/Microsoft.Billing/billingAccounts/{billingAccountName}/invoices?api-version=2019-10-01-preview&periodStartDate={periodStartDate}&periodEndDate={periodEndDate} 
@@ -50,7 +50,7 @@ The API call returns an array of invoices that has elements similar to the follo
    {      "id": "/providers/Microsoft.Billing/billingAccounts/{billingAccountID}/billingProfiles/{BillingProfileID}/invoices/{InvoiceID}",      "name": "{InvoiceID}",      "properties": {        "amountDue": {          "currency": "USD",          "value": x.xx        },        ...    } 
 ```
 
-Use the preceding returned ID field value and replace it in the following example as the scope to query for usage details.
+To query for usage details, use the preceding returned ID field value and replace it in the following example as the scope.
 
 ```http
 GET https://management.azure.com/{id}/providers/Microsoft.Consumption/UsageDetails?api-version=2019-10-01 
@@ -122,6 +122,6 @@ DELETE https://management.azure.com/providers/Microsoft.Billing/billingAccounts/
 
 - Learn more about Cost Management automation at [Cost Management automation overview](automation-overview.md).
 Automation scenarios.
-- [Get started with Azure Cost Management for partners](../costs/get-started-partners.md#cost-management-rest-apis).
+- [Get started with Cost Management for partners](../costs/get-started-partners.md#cost-management-rest-apis).
 - [Retrieve large usage datasets with exports](../costs/ingest-azure-usage-at-scale.md).
 - [Understand usage details fields](understand-usage-details-fields.md). 

articles/cost-management-billing/automate/usage-details-best-practices.md

@@ -4,7 +4,7 @@ titleSuffix: Microsoft Cost Management
 description: This article describes best practices recommended by Microsoft when you work with data in cost details files.
 author: bandersmsft
 ms.author: banders
-ms.date: 11/17/2023
+ms.date: 05/14/2024
 ms.topic: conceptual
 ms.service: cost-management-billing
 ms.subservice: cost-management
@@ -13,11 +13,11 @@ ms.reviewer: jojoh
 
 # Choose a cost details solution
 
-There are multiple ways to work with the cost details dataset (formerly referred to as usage details). If your organization has a large Azure presence across many resources or subscriptions, you'll have a large amount of cost details data. Excel often can't load such large files. In this situation, we recommend the options below.
+There are multiple ways to work with the cost details dataset (formerly referred to as usage details). If your organization has a large Azure presence across many resources or subscriptions, you might have a large amount of cost details data. Excel often can't load such large files. In this situation, we recommend the following options.
 
 ## Exports
 
-Exports are recurring data dumps to storage that can be configured to run on a custom schedule. We recommend Exports as the solution to ingest cost details data. It's the most scalable for large enterprises. Exports are [configured in the Azure portal](../costs/tutorial-export-acm-data.md) or using the [Exports API](/rest/api/cost-management/exports). Review the considerations below for analyzing whether this solution is best for your particular data ingestion workload.
+Exports are recurring data dumps to storage that can be configured to run on a custom schedule. We recommend Exports as the solution to ingest cost details data. It's the most scalable for large enterprises. Exports are [configured in the Azure portal](../costs/tutorial-export-acm-data.md) or using the [Exports API](/rest/api/cost-management/exports). Review the following considerations to analyze whether this solution is best for your particular data ingestion workload.
 
 - Exports are most scalable solution for your workloads.
 - Can be configured to use file partitioning for bigger datasets.
@@ -28,34 +28,34 @@ To learn more about how to properly call the API and ingest cost details at scal
 
 ## Cost Details API
 
-The [Cost Details](/rest/api/cost-management/generate-cost-details-report) API is the go to solution for on demand download of the cost details dataset. Review the considerations below to analyze whether this solution is best for your particular data ingestion workload.
+The [Cost Details](/rest/api/cost-management/generate-cost-details-report) API is the go to solution for on demand download of the cost details dataset. Review the following considerations to analyze whether this solution is best for your particular data ingestion workload.
 
-- Useful for small cost datasets. Exports scale better than the API. The API may not be a good solution if you need to ingest many gigabytes worth of cost data month over month. A GB of cost details data is roughly 1 million rows of data.
+- Useful for small cost datasets. Exports scale better than the API. The API might not be a good solution if you need to ingest many gigabytes worth of cost data month over month. A GB of cost details data is roughly 1 million rows of data.
 - Useful for scenarios when Exports to Azure storage aren't feasible due to security or manageability concerns.
 
-If the Cost Details API is your chosen solution, review the best practices to call the API below.
+If the Cost Details API is your chosen solution, review the best practices to call the following API.
 
-- If you want to get the latest cost data, we recommend that you query at most once per day. Reports are refreshed every four hours. If you call more frequently, you'll receive identical data.
-- Once you download your cost data for historical invoices, the charges won't change unless you're explicitly notified. We recommend caching your cost data in a queryable store on to prevent repeated calls for identical data.
+- If you want to get the latest cost data, we recommend that you query at most once per day. Reports are refreshed every four hours. If you call more frequently, you receive identical data.
+- Once you download your cost data for historical invoices, the charges don't change unless you're explicitly notified. We recommend caching your cost data in a queryable store on to prevent repeated calls for identical data.
 - Chunk your calls into small date ranges to get more manageable files that you can download. For example, we recommend chunking by day or by week if you have large Azure usage files month-to-month. 
 - If you have scopes with a large amount of usage data (for example a Billing Account), consider placing multiple calls to child scopes so you get more manageable files that you can download.
-- If you're bound by rate limits at a lower scope, consider calling a higher scope to download data.
+- If you get bound by rate limits at a lower scope, consider calling a higher scope to download data.
 - If your dataset is more than 2 GB month-to-month, consider using [exports](../costs/tutorial-export-acm-data.md) as a more scalable solution.
 
 To learn more about how to properly call the [Cost Details](/rest/api/cost-management/generate-cost-details-report) API, see [Get small usage data sets on demand](get-small-usage-datasets-on-demand.md).
 
-The Cost Details API is only available for customers with an Enterprise Agreement or Microsoft Customer Agreement. If you're an MSDN, pay-as-you-go or Visual Studio customer, see [Get usage details for pay-as-you-go subscriptions](get-usage-details-legacy-customer.md).
+The Cost Details API is only available for customers with an Enterprise Agreement or Microsoft Customer Agreement. If you're a pay-as-you-go or Visual Studio customer, see [Get usage details for pay-as-you-go subscriptions](get-usage-details-legacy-customer.md).
 
 ## Power BI
 
-Power BI is another solution that's used to work with cost details data. The following Power BI solutions are available:
+Power BI is another solution that you can use to work with cost details data. The following Power BI solutions are available:
 
-- Azure Cost Management Template App: - If you're an Enterprise Agreement or Microsoft Customer Agreement customer, you can use the Power BI template app to analyze costs for your billing account. It includes predefined reports that are built on top of the cost details dataset, among others. For more information, see [Analyze Azure costs with the Power BI template app](../costs/analyze-cost-data-azure-cost-management-power-bi-template-app.md).
-- Azure Cost Management Connector: - If you want to analyze your data daily, you can use the [Power BI data connector](/power-bi/connect-data/desktop-connect-azure-cost-management) to get data for detailed analysis. Any reports that you create are kept up to date by the connector as more costs accrue.
+- Cost Management Template App: - If you're an Enterprise Agreement or Microsoft Customer Agreement customer, you can use the Power BI template app to analyze costs for your billing account. It includes predefined reports that are built on top of the cost details dataset, among others. For more information, see [Analyze Azure costs with the Power BI template app](../costs/analyze-cost-data-azure-cost-management-power-bi-template-app.md).
+- Cost Management Connector: - If you want to analyze your data daily, you can use the [Power BI data connector](/power-bi/connect-data/desktop-connect-azure-cost-management) to get data for detailed analysis. Any reports that you create are kept up to date with the connector as more costs accrue.
 
 ## Azure portal download
 
-Only [download your usage from the Azure portal](../understand/download-azure-daily-usage.md) if you have a small cost details dataset that is capable of being loaded in Excel. Cost files that are larger than one or 2 GB may take an exceedingly long time to generate on demand from the Azure portal. They'll take longer to transfer over a network to your local computer. We recommend using one of the above solutions if you have a large monthly usage dataset.
+Only [download your usage from the Azure portal](../understand/download-azure-daily-usage.md) if you have a small cost details dataset that is capable of being loaded in Excel. Cost files that are larger than one or 2 GB might take an exceedingly long time to generate on demand from the Azure portal. They take longer to transfer over a network to your local computer. We recommend using one of the above solutions if you have a large monthly usage dataset.
 
 ## Related content