You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: articles/cost-management-billing/automate/automation-faq.md
+1-1Lines changed: 1 addition & 1 deletion
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -20,7 +20,7 @@ Both are different names for the same dataset. Usage Details is the original nam
20
20
21
21
### Why do I get Usage Details API timeouts?
22
22
23
-
Cost datasets available from the Usage Details API can often be overly large (multiple GBs or more). The larger the size of the dataset that you request, the longer the service takes to compile the data before sending it to you. Because of the delay, synchronous API solutions like the paginated [JSON Usage Details API](/rest/api/consumption/usage-details/list) might timeout before your data is provided. If you encounter timeouts or have processes that frequently need to pull a large amount of cost data, see [Retrieve large cost datasets recurringly with Exports](../costs/tutorial-export-acm-data.md).
23
+
Cost datasets available from the Usage Details API can often be overly large (multiple GBs or more). The larger the size of the dataset that you request, the longer the service takes to compile the data before sending it to you. Because of the delay, synchronous API solutions like the paginated [JSON Usage Details API](/rest/api/consumption/usage-details/list) might time out before your data is provided. If you encounter timeouts or have processes that frequently need to pull a large amount of cost data, see [Retrieve large cost datasets recurringly with Exports](../costs/tutorial-export-acm-data.md).
24
24
25
25
### What is the difference between legacy and modern usage details?
Copy file name to clipboardExpand all lines: articles/cost-management-billing/automate/migrate-consumption-usage-details-api.md
+1-1Lines changed: 1 addition & 1 deletion
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -75,7 +75,7 @@ Enterprise Agreement customers who are using the Consumption Usage Details API h
75
75
}
76
76
```
77
77
78
-
An full example legacy Usage Details record is shown at [Usage Details - List - REST API (Azure Consumption)](/rest/api/consumption/usage-details/list#billingaccountusagedetailslist-legacy)
78
+
A full example legacy Usage Details record is shown at [Usage Details - List - REST API (Azure Consumption)](/rest/api/consumption/usage-details/list#billingaccountusagedetailslist-legacy)
79
79
80
80
The following table provides a mapping between the old and new fields. New properties are available in the CSV files produced by Exports and the Cost Details API. To learn more about the fields, see [Understand usage details fields](understand-usage-details-fields.md).
Copy file name to clipboardExpand all lines: articles/cost-management-billing/automate/migrate-ea-reporting-arm-apis-overview.md
+2-2Lines changed: 2 additions & 2 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -1,7 +1,7 @@
1
1
---
2
2
title: Migrate from EA Reporting to Azure Resource Manager APIs overview
3
3
titleSuffix: Microsoft Cost Management
4
-
description: This article provides and overview about migrating from EA Reporting to Azure Resource Manager APIs.
4
+
description: This article provides an overview about migrating from EA Reporting to Azure Resource Manager APIs.
5
5
author: bandersmsft
6
6
ms.author: banders
7
7
ms.date: 07/15/2022
@@ -25,7 +25,7 @@ The following information describes the differences between the older Reporting
25
25
| Scopes and permissions | All requests are at the enrollment scope. API Key permission assignments will determine whether data for the entire enrollment, a department, or a specific account is returned. No user authentication. | Users or service principals are assigned access to the enrollment, department, or account scope. |
26
26
| URI Endpoint |[https://consumption.azure.com](https://consumption.azure.com/)|[https://management.azure.com](https://management.azure.com/)|
27
27
| Development status | In maintenance mode. On the path to deprecation. | In active development |
28
-
| Available APIs | Limited to what's currently available | Equivalent APIs are available to replace each EA API. Additional [Cost Management APIs](/rest/api/cost-management/) are also available, including: <ul><li>Budgets<li>Alerts<li>Exports</ul>|
28
+
| Available APIs | Limited to what's currently available | Equivalent APIs are available to replace each EA API. Additional [Cost Management APIs](/rest/api/cost-management/) are also available, including: <br>- Budgets<br>- Alerts<br>- Exports |
Copy file name to clipboardExpand all lines: articles/cost-management-billing/automate/migrate-ea-usage-details-api.md
+12-12Lines changed: 12 additions & 12 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -23,8 +23,8 @@ The following table provides a summary of the migration destinations that are av
23
23
24
24
| Solution | Description | Considerations | Onboarding info |
25
25
| --- | --- | --- | --- |
26
-
|**Exports**| Recurring data dumps to storage on a schedule |<ul><li>The most scalable solution for your workloads. <li>Can be configured to use file partitioning for bigger datasets.<li>Great for establishing and growing a cost dataset that can be integrated with your own queryable data stores.<li>Requires access to a storage account that can hold the data.</ul>|<ul><li>[Configure in Azure portal](../costs/tutorial-export-acm-data.md)<li>[Automate Export creation with the API](../costs/ingest-azure-usage-at-scale.md)<li>[Export API Reference](/rest/api/cost-management/exports/create-or-update)</ul>|
27
-
|**Cost Details API**| On demand download |<ul><li>Useful for small cost datasets.<li>Useful for scenarios when Exports to Azure storage aren't feasible due to security or manageability concerns.</ul>|<ul><li>[Get small cost datasets on demand](get-small-usage-datasets-on-demand.md)<li>[Cost Details](/rest/api/cost-management/generate-cost-details-report) API</ul>|
26
+
|**Exports**| Recurring data dumps to storage on a schedule |- The most scalable solution for your workloads.<br> - Can be configured to use file partitioning for bigger datasets.<br> - Great for establishing and growing a cost dataset that can be integrated with your own queryable data stores.<br> -Requires access to a storage account that can hold the data. |- [Configure in Azure portal](../costs/tutorial-export-acm-data.md)<br>[Automate Export creation with the API](../costs/ingest-azure-usage-at-scale.md)<br> - [Export API Reference](/rest/api/cost-management/exports/create-or-update)|
27
+
|**Cost Details API**| On demand download |- Useful for small cost datasets.<br> - Useful for scenarios when Exports to Azure storage aren't feasible due to security or manageability concerns. |- [Get small cost datasets on demand](get-small-usage-datasets-on-demand.md)<br> - [Cost Details](/rest/api/cost-management/generate-cost-details-report) API |
28
28
29
29
Generally we recommend using [Exports](../costs/tutorial-export-acm-data.md) if you have ongoing data ingestion needs and/or a large monthly cost details dataset. For more information, see [Ingest cost details data](automation-ingest-usage-details-overview.md). If you need additional information to help you make a decision for your workload, see [Choose a cost details solution](usage-details-best-practices.md).
30
30
@@ -60,23 +60,23 @@ The table below summarizes the different APIs that you may be using today to ing
|`/v3/enrollments/{enrollmentNumber}/usagedetails/download?billingPeriod={billingPeriod}`|- API method: GET<br> - Synchronous (non polling)<br> - Data format: CSV |
64
+
|`/v3/enrollments/{enrollmentNumber}/usagedetails/download?startTime=2017-01-01&endTime=2017-01-10`|- API method: GET <br> - Synchronous (non polling)<br> - Data format: CSV |
65
+
|`/v3/enrollments/{enrollmentNumber}/usagedetails`|- API method: GET<br> - Synchronous (non polling)<br> - Data format: JSON |
66
+
|`/v3/enrollments/{enrollmentNumber}/billingPeriods/{billingPeriod}/usagedetails`|- API method: GET<br> - Synchronous (non polling)<br> - Data format: JSON |
67
+
|`/v3/enrollments/{enrollmentNumber}/usagedetailsbycustomdate?startTime=2017-01-01&endTime=2017-01-10`|- API method: GET<br> - Synchronous (non polling)<br> - Data format: JSON |
68
+
|`/v3/enrollments/{enrollmentNumber}/usagedetails/submit?billingPeriod={billingPeriod}`|- API method: POST<br> - Asynchronous (polling based)<br> - Data format: CSV |
69
+
|`/v3/enrollments/{enrollmentNumber}/usagedetails/submit?startTime=2017-04-01&endTime=2017-04-10`|- API method: POST<br> - Asynchronous (polling based)<br> - Data format: CSV |
70
70
71
71
## Enterprise Marketplace Store Charge APIs to migrate off
72
72
73
73
In addition to the usage details APIs outlined above, you'll need to migrate off the [Enterprise Marketplace Store Charge APIs](/rest/api/billing/enterprise/billing-enterprise-api-marketplace-storecharge). All Azure and Marketplace charges have been merged into a single file that is available through the new solutions. You can identify which charges are *Azure* versus *Marketplace* charges by using the `PublisherType` field that is available in the new dataset. The table below outlines the applicable APIs. All of the following APIs are behind the *https://consumption.azure.com* endpoint.
Copy file name to clipboardExpand all lines: articles/cost-management-billing/automate/understand-usage-details-fields.md
+15-15Lines changed: 15 additions & 15 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -30,48 +30,48 @@ The following table describes the important terms used in the latest version of
30
30
| Term | Account type | Description |
31
31
| --- | --- | --- |
32
32
| AccountName | EA, pay-as-you-go | Display name of the EA enrollment account or pay-as-you-go billing account. |
33
-
| AccountOwnerId<sup>1</sup>| EA, pay-as-you-go | Unique identifier for the EA enrollment account or pay-as-you-go billing account. |
33
+
| AccountOwnerId¹| EA, pay-as-you-go | Unique identifier for the EA enrollment account or pay-as-you-go billing account. |
34
34
| AdditionalInfo | All | Service-specific metadata. For example, an image type for a virtual machine. |
35
-
| BillingAccountId<sup>1</sup>| All | Unique identifier for the root billing account. |
35
+
| BillingAccountId¹| All | Unique identifier for the root billing account. |
36
36
| BillingAccountName | All | Name of the billing account. |
37
37
| BillingCurrency | All | Currency associated with the billing account. |
38
38
| BillingPeriod | EA, pay-as-you-go | The billing period of the charge. |
39
39
| BillingPeriodEndDate | All | The end date of the billing period. |
40
40
| BillingPeriodStartDate | All | The start date of the billing period. |
41
-
| BillingProfileId<sup>1</sup>| All | Unique identifier of the EA enrollment, pay-as-you-go subscription, MCA billing profile, or AWS consolidated account. |
41
+
| BillingProfileId¹| All | Unique identifier of the EA enrollment, pay-as-you-go subscription, MCA billing profile, or AWS consolidated account. |
42
42
| BillingProfileName | All | Name of the EA enrollment, pay-as-you-go subscription, MCA billing profile, or AWS consolidated account. |
43
43
| ChargeType | All | Indicates whether the charge represents usage (**Usage**), a purchase (**Purchase**), or a refund (**Refund**). |
44
44
| ConsumedService | All | Name of the service the charge is associated with. |
45
-
| CostCenter<sup>1</sup>| EA, MCA | The cost center defined for the subscription for tracking costs (only available in open billing periods for MCA accounts). |
45
+
| CostCenter¹| EA, MCA | The cost center defined for the subscription for tracking costs (only available in open billing periods for MCA accounts). |
46
46
| Cost | EA, pay-as-you-go | See CostInBillingCurrency. |
47
47
| CostInBillingCurrency | MCA | Cost of the charge in the billing currency before credits or taxes. |
48
48
| CostInPricingCurrency | MCA | Cost of the charge in the pricing currency before credits or taxes. |
49
49
| Currency | EA, pay-as-you-go | See `BillingCurrency`. |
50
-
| Date<sup>1</sup>| All | The usage or purchase date of the charge. |
50
+
| Date¹| All | The usage or purchase date of the charge. |
51
51
| EffectivePrice | All | Blended unit price for the period. Blended prices average out any fluctuations in the unit price, like graduated tiering, which lowers the price as quantity increases over time. |
52
52
| ExchangeRateDate | MCA | Date the exchange rate was established. |
53
53
| ExchangeRatePricingToBilling | MCA | Exchange rate used to convert the cost in the pricing currency to the billing currency. |
54
54
| Frequency | All | Indicates whether a charge is expected to repeat. Charges can either happen once (**OneTime**), repeat on a monthly or yearly basis (**Recurring**), or be based on usage (**UsageBased**). |
55
55
| InvoiceId | pay-as-you-go, MCA | The unique document ID listed on the invoice PDF. |
56
56
| InvoiceSection | MCA | See `InvoiceSectionName`. |
57
-
| InvoiceSectionId<sup>1</sup>| EA, MCA | Unique identifier for the EA department or MCA invoice section. |
57
+
| InvoiceSectionId¹| EA, MCA | Unique identifier for the EA department or MCA invoice section. |
58
58
| InvoiceSectionName | EA, MCA | Name of the EA department or MCA invoice section. |
59
59
| IsAzureCreditEligible | All | Indicates if the charge is eligible to be paid for using Azure credits (Values: `True` or `False`). |
60
60
| Location | MCA | Datacenter location where the resource is running. |
61
61
| MeterCategory | All | Name of the classification category for the meter. For example, _Cloud services_ and _Networking_. |
62
-
| MeterId<sup>1</sup>| All | The unique identifier for the meter. |
62
+
| MeterId¹| All | The unique identifier for the meter. |
63
63
| MeterName | All | The name of the meter. |
64
64
| MeterRegion | All | Name of the datacenter location for services priced based on location. See Location. |
65
65
| MeterSubCategory | All | Name of the meter subclassification category. |
66
-
| OfferId<sup>1</sup>| All | Name of the offer purchased. |
66
+
| OfferId¹| All | Name of the offer purchased. |
67
67
| pay-as-you-goPrice | All | Retail price for the resource. |
68
-
| PartNumber<sup>1</sup>| EA, pay-as-you-go | Identifier used to get specific meter pricing. |
68
+
| PartNumber¹| EA, pay-as-you-go | Identifier used to get specific meter pricing. |
69
69
| PlanName | EA, pay-as-you-go | Marketplace plan name. |
70
70
| PreviousInvoiceId | MCA | Reference to an original invoice if the line item is a refund. |
71
71
| PricingCurrency | MCA | Currency used when rating based on negotiated prices. |
72
72
| PricingModel | All | Identifier that indicates how the meter is priced. (Values: `On Demand`, `Reservation`, and `Spot`) |
73
73
| Product | All | Name of the product. |
74
-
| ProductId<sup>1</sup>| MCA | Unique identifier for the product. |
74
+
| ProductId¹| MCA | Unique identifier for the product. |
75
75
| ProductOrderId | All | Unique identifier for the product order. |
76
76
| ProductOrderName | All | Unique name for the product order. |
77
77
| Provider | All | Identifier for product category or Line of Business. For example, Azure, Microsoft 365, and AWS. |
@@ -81,24 +81,24 @@ The following table describes the important terms used in the latest version of
81
81
| ReservationId | EA, MCA | Unique identifier for the purchased reservation instance. |
82
82
| ReservationName | EA, MCA | Name of the purchased reservation instance. |
83
83
| ResourceGroup | All | Name of the [resource group](../../azure-resource-manager/management/overview.md) the resource is in. Not all charges come from resources deployed to resource groups. Charges that don't have a resource group will be shown as null or empty, **Others**, or **Not applicable**. |
84
-
| ResourceId<sup>1</sup>| All | Unique identifier of the [Azure Resource Manager](/rest/api/resources/resources) resource. |
84
+
| ResourceId¹| All | Unique identifier of the [Azure Resource Manager](/rest/api/resources/resources) resource. |
85
85
| ResourceLocation | All | Datacenter location where the resource is running. See `Location`. |
86
86
| ResourceName | EA, pay-as-you-go | Name of the resource. Not all charges come from deployed resources. Charges that don't have a resource type will be shown as null/empty, **Others** , or **Not applicable**. |
87
87
| ResourceType | MCA | Type of resource instance. Not all charges come from deployed resources. Charges that don't have a resource type will be shown as null/empty, **Others** , or **Not applicable**. |
88
88
| ServiceFamily | MCA | Service family that the service belongs to. |
89
-
| ServiceInfo<sup>1</sup>| All | Service-specific metadata. |
89
+
| ServiceInfo¹| All | Service-specific metadata. |
90
90
| ServiceInfo2 | All | Legacy field with optional service-specific metadata. |
91
91
| ServicePeriodEndDate | MCA | The end date of the rating period that defined and locked pricing for the consumed or purchased service. |
92
92
| ServicePeriodStartDate | MCA | The start date of the rating period that defined and locked pricing for the consumed or purchased service. |
93
-
| SubscriptionId<sup>1</sup>| All | Unique identifier for the Azure subscription. |
93
+
| SubscriptionId¹| All | Unique identifier for the Azure subscription. |
94
94
| SubscriptionName | All | Name of the Azure subscription. |
95
-
| Tags<sup>1</sup>| All | Tags assigned to the resource. Doesn't include resource group tags. Can be used to group or distribute costs for internal chargeback. For more information, see [Organize your Azure resources with tags](https://azure.microsoft.com/updates/organize-your-azure-resources-with-tags/). |
95
+
| Tags¹| All | Tags assigned to the resource. Doesn't include resource group tags. Can be used to group or distribute costs for internal chargeback. For more information, see [Organize your Azure resources with tags](https://azure.microsoft.com/updates/organize-your-azure-resources-with-tags/). |
96
96
| Term | All | Displays the term for the validity of the offer. For example: In case of reserved instances, it displays 12 months as the Term. For one-time purchases or recurring purchases, Term is one month (SaaS, Marketplace Support). Not applicable for Azure consumption. |
97
97
| UnitOfMeasure | All | The unit of measure for billing for the service. For example, compute services are billed per hour. |
98
98
| UnitPrice | EA, pay-as-you-go | The price per unit for the charge. |
99
99
| CostAllocationRuleName | EA, MCA | Name of the Cost Allocation rule that's applicable to the record. |
100
100
101
-
<sup>1</sup> Fields used to build a unique ID for a single cost record.
101
+
¹ Fields used to build a unique ID for a single cost record.
102
102
103
103
Some fields might differ in casing and spacing between account types. Older versions of pay-as-you-go cost details files have separate sections for the statement and daily cost.
0 commit comments