Skip to content

Commit b889ff4

Browse files
GitHubber17GitHubber17
authored
Merge pull request #94728 from bandersmsft/master
cost mgt - partner article updated
2 parents 131a204 + 149e45c commit b889ff4

File tree

1 file changed

+89
-43
lines changed

1 file changed

+89
-43
lines changed

‎articles/cost-management/get-started-partners.md

Lines changed: 89 additions & 43 deletions
Original file line numberDiff line numberDiff line change
@@ -5,7 +5,7 @@ services: cost-management
55
keywords:
66
author: bandersmsft
77
ms.author: banders
8-
ms.date: 10/22/2019
8+
ms.date: 11/04/2019
99
ms.topic: conceptual
1010
ms.service: cost-management
1111
manager: aparnag
@@ -65,7 +65,7 @@ Use the [amortized cost view](quick-acm-cost-analysis.md#customize-cost-views) i
6565

6666
Use the billing profile scope to view pre-tax costs in the billing currency across all your customers for all products and subscriptions included in an invoice. You can filter costs in a billing profile for a specific invoice using the **InvoiceID** filter. The filter shows the consumption and product purchase costs for a specific invoice. You can also filter the costs for a specific customer on the invoice to see pre-tax costs.
6767

68-
After you onboard customers to a Microsoft Customer Agreement, you receive a invoice that includes all charges for all products (consumption, purchases, and entitlements) for these customers on the Microsoft Customer Agreement. When billed in the same currency, these invoices also include the charges for entitlement and purchased products such as SaaS, Azure Marketplace, and reservations for customers who are still in the CSP offer.
68+
After you onboard customers to a Microsoft Customer Agreement, you receive an invoice that includes all charges for all products (consumption, purchases, and entitlements) for these customers on the Microsoft Customer Agreement. When billed in the same currency, these invoices also include the charges for entitlement and purchased products such as SaaS, Azure Marketplace, and reservations for customers who are still in the CSP offer.
6969

7070
To help reconcile charges against the customer invoice, the billing profile scope enables you to see all costs that accrue for an invoice for your customers. Like the invoice, the scope shows costs for every customer in the new Microsoft Customer Agreement. The scope also shows every charge for customer entitlement products still in the current CSP offer.
7171

@@ -140,24 +140,79 @@ Cost analysis, budgets, and alerts are now available for the subscription and re
140140

141141
Amortized views and actual costs for reserved instances in the RBAC scopes show zero charges. Reserved instance costs are only showing in billing scopes where the purchases were made.
142142

143-
## Analyze costs in Cost Analysis
143+
## Analyze costs in cost analysis
144144

145-
Partners can explore and analyze costs in cost analysis across customers for a specific customer or for an invoice. The filter and group by features allow you to analyze costs by multiple fields, including:
145+
Partners can explore and analyze costs in cost analysis across customers for a specific customer or for an invoice.
146146

147-
| **Field** | **Description** |
147+
The following fields are found in usage detail files and Cost Management APIs. For the following bold fields, you can use filter and group by features in cost analysis to analyze costs by multiple fields.
148+
149+
| **Field name** | **Description** |
148150
| --- | --- |
149-
| PartnerTenantID | Identifier for the partner's Azure Active Directory tenant |
150-
| PartnerName | Name of the partner Azure Active Directory tenant |
151-
| CustomerTenantID | Identifier of the Azure Active Directory tenant of the customer's subscription |
152-
| CustomerName | Name of the Azure Active Directory tenant containing the customer's subscription |
153-
| ResellerMPNID | MPNID for the reseller associated with the subscription |
154-
| subscription ID | Unique Microsoft-generated identifier for the Azure subscription |
155-
| subscriptionName | Name of the Azure subscription |
156-
| billingProfileID | Identifier for the billing profile. It groups costs across invoices in a single billing currency across customers.
157-
| invoiceID | Invoice ID on the invoice where the specific transaction appears |
158-
| resourceGroup | Name of the Azure resource group. Used for resource lifecycle management. |
159-
| partnerEarnedCreditRate | Discount rate applied if there is a partner earned credit (PEC) based on partner admin link access. |
160-
| partnerEarnedCreditApplied | Indicates whether partner earned credit was applied. |
151+
| invoiceId | Invoice ID shown on the invoice for the specific transaction. |
152+
| previousInvoiceID | Reference to an original invoice there is a refund (negative cost). Populated only when there is a refund. |
153+
| billingAccountName | Name of the billing account representing the partner. It accrues all costs across the customers who have onboarded to a Microsoft customer agreement and the CSP customers that have made entitlement purchases like SaaS, Azure Marketplace, and reservations. |
154+
| billingAccountID | Identifier for the billing account representing the partner. |
155+
| billingProfileID | Identifier for the billing profile that groups costs across invoices in a single billing currency across the customers who have onboarded to a Microsoft customer agreement and the CSP customers that have made entitlement purchases like SaaS, Azure Marketplace, and reservations. |
156+
| billingProfileName | Name of the billing profile that groups costs across invoices in a single billing currency across the customers who have onboarded to a Microsoft customer agreement and the CSP customers that have made entitlement purchases like SaaS, Azure Marketplace, and reservations. |
157+
| invoiceSectionName | Name of the project that is being charged in the invoice. Not applicable for Microsoft Customer Agreements onboarded by partners. |
158+
| invoiceSectionID | Identifier of the project that is being charged in the invoice. Not applicable for Microsoft Customer Agreements onboarded by partners. |
159+
| **CustomerTenantID** | Identifier of the Azure Active Directory tenant of the customer's subscription. |
160+
| **CustomerName** | Name of the Azure Active Directory tenant for the customer's subscription. |
161+
| **CustomerTenantDomainName** | Domain name for the Azure Active Directory tenant of the customer's subscription. |
162+
| **PartnerTenantID** | Identifier for the partner's Azure Active Directory tenant. |
163+
| **PartnerName** | Name of the partner Azure Active Directory tenant. |
164+
| **ResellerMPNID** | MPNID for the reseller associated with the subscription. |
165+
| costCenter | Cost center associated to the subscription. |
166+
| billingPeriodStartDate | Billing period start date, as shown on the invoice. |
167+
| billingPeriodEndDate | Billing period end date, as shown on the invoice. |
168+
| servicePeriodStartDate | Start date for the rating period when the service usage was rated for charges. The prices for Azure services are determined for the rating period. |
169+
| servicePeriodEndDate | End date for the period when the service usage was rated for charges. The prices for Azure services are determined based on the rating period. |
170+
| date | For Azure consumption data, it shows date of usage as rated. For reserved instance, it shows the purchased date. For recurring charges and one-time charges such as Marketplace and support, it shows the purchase date. |
171+
| productID | Identifier for the product that has accrued charges by consumption or purchase. It is the concatenated key of productID and SKuID, as shown in the Partner Center. |
172+
| product | Name of the product that has accrued charges by consumption or purchase, as shown on the invoice. |
173+
| serviceFamily | Shows the service family for the product purchased or charged. For example, Storage or Compute. |
174+
| productOrderID | The identifier of the asset or Azure plan name that the subscription belongs to. For example, Azure Plan. |
175+
| productOrderName | The name of the Azure plan that the subscription belongs to. For example, Azure Plan. |
176+
| consumedService | Consumed service (legacy taxonomy) as used in legacy EA usage details. |
177+
| meterID | Metered identifier for measured consumption. |
178+
| meterName | Identifies the name of the meter for measured consumption. |
179+
| meterCategory | Identifies the top-level service for usage. |
180+
| meterSubCategory | Defines the type or subcategory of Azure service that can affect the rate. |
181+
| meterRegion | Identifies the location of the datacenter for certain services that are priced based on datacenter location. |
182+
| subscription ID | Unique Microsoft generated identifier for the Azure subscription. |
183+
| subscriptionName | Name of the Azure subscription. |
184+
| Term | Displays the term for the validity of the offer. For example, reserved instances show 12 months of a yearly term of the reserved instance. For one-time purchases or recurring purchases, the term displays one month for SaaS, Azure Marketplace, and support. Not applicable for Azure consumption. |
185+
| publisherType (firstParty, thirdPartyReseller, thirdPartyAgency) | Type of publisher that identifies the publisher as first party, third-party reseller, or third-party agency. |
186+
| partNumber | Part number for the unused reserved instance and Azure Marketplace services. |
187+
| publisherName | Name of the publisher of the service including Microsoft or third-party publishers. |
188+
| reservationId | Identifier for the reserved instance purchase. |
189+
| reservationName | Name of the reserved instance. |
190+
| reservationOrderId | OrderID for the reserved instance. |
191+
| frequency | Payment frequency for a reserved instance. |
192+
| resourceGroup | Name of the Azure resource group used for lifecycle resource management. |
193+
| instanceID (or) ResourceID | Identifier of the resource instance. |
194+
| resourceLocation | Name of the resource location. |
195+
| Location | Normalized location of the resource. |
196+
| effectivePrice | The effective unit price of the service, in pricing currency. Unique for a product, service family, meter, and offer. Used with pricing in the price sheet for the billing account. When there is tiered pricing or an included quantity, it shows the blended price for consumption. |
197+
| Quantity | Measured quantity purchased or consumed. The amount of the meter used during the billing period. |
198+
| unitOfMeasure | Identifies the unit that the service is charged in. For example, GB and hours. |
199+
| pricingCurrency | The currency defining the unit price. |
200+
| billingCurrency | The currency defining the billed cost |
201+
| chargeType | Defines the type of charge that the cost represents in Azure Cost Management like purchase and refund. |
202+
| costinBillingCurrency | ExtendedCost or blended cost before tax in the billed currency. |
203+
| costinPricingCurrency | ExtendedCost or blended cost before tax in pricing currency to correlate with prices. |
204+
| **costinUSD** | Estimated ExtendedCost or blended cost before tax in USD. |
205+
| **paygCostInBillingCurrency** | Shows costs if pricing is in retail prices. Shows pay-as-you-go prices in the billing currency. Available only at RBAC scopes. |
206+
| **paygCostInUSD** | Shows costs if pricing is in retail prices. Shows pay-as-you-go prices in USD. Available only at RBAC scopes. |
207+
| exchangeRate | Exchange rate used to convert from the pricing currency to the billing currency. |
208+
| exchangeRateDate | The date for the exchange rate that's used to convert from the pricing currency to the billing currency. |
209+
| isAzureCreditEligible | Indicates whether the cost is eligible for payment by Azure credits. |
210+
| serviceInfo1 | Legacy field that captures optional service-specific metadata. |
211+
| serviceInfo2 | Legacy field that captures optional service-specific metadata. |
212+
| additionalInfo | Service-specific metadata. For example, an image type for a virtual machine. |
213+
| tags | Tag that you assign to the meter. Use tags to group billing records. For example, you can use tags to distribute costs by the department that uses the meter. |
214+
| **partnerEarnedCreditRate** | Rate of discount applied if there is a partner earned credit (PEC) based on partner admin link access. |
215+
| **partnerEarnedCreditApplied** | Indicates whether the partner earned credit has been applied. |
161216

162217
In the [cost analysis](quick-acm-cost-analysis.md) view, you can also [save views](quick-acm-cost-analysis.md#saving-and-sharing-customized-views) and export data to [CSV and PNG files](quick-acm-cost-analysis.md#automation-and-offline-analysis).
163218

@@ -198,44 +253,45 @@ APIs at the subscription scope can be called by a partner regardless of the cost
198253
#### To get a list of billing accounts
199254

200255
```
201-
armclient get "providers/Microsoft.billing/billingAccounts?api-version=2019-10-01-preview"
256+
GET https://management.azure.com/providers/Microsoft.Billing/billingAccounts?api-version=2019-10-01-preview
202257
```
203258

204259
#### To get a list of customers
205260

206261
```
207-
armclient get "providers/Microsoft.billing/billingAccounts/XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX:XXXXXXXX-XXXX-XXXX-XXXXXXXXXXXXXXXXX_2019-05-31/customers?api-version=2019-10-01-preview"
262+
GET https://management.azure.com/providers/Microsoft.Billing/billingAccounts/{billingAccountName}/customers?api-version=2019-10-01-preview
208263
```
264+
209265
#### To get a list of subscriptions
210266

211267
```
212-
armclient get "/providers/Microsoft.Billing/billingAccounts/XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX:XXXXXXXX-XXXX-XXXX-XXXXXXXXXXXXXXXXX_2019-05-31/customers/YYYYYYYY-YYYY-YYYY-YYYY-YYYYYYYYYYYY/billingSubscriptions?api-version=2019-10-01-preview"
268+
GET https://management.azure.com/providers/Microsoft.Billing/billingAccounts/{billingAccountName}/billingSubscriptions?api-version=2019-10-01-preview
213269
```
214270

215271
#### To get the policy for customers to view costs
216272

217273
```
218-
armclient get "providers/Microsoft.Billing/billingAccounts/XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX:XXXXXXXX-XXXX-XXXX-XXXXXXXXXXXXXXXXX_2019-05-31/customers/YYYYYYYY-YYYY-YYYY-YYYY-YYYYYYYYYYYY/policies/default?api-version=2019-10-01-preview"
274+
GET https://management.azure.com/providers/Microsoft.Billing/billingAccounts/{billingAccountName}/customers/{customerID}/policies/default?api-version=2019-10-01-preview
219275
```
220276

221277
#### To set the policy for customers to view costs
222278

223279
```
224-
armclient put "providers/Microsoft.Billing/billingAccounts/XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX:XXXXXXXX-XXXX-XXXX-XXXXXXXXXXXXXXXXX_2019-05-31/customers/YYYYYYYY-YYYY-YYYY-YYYY-YYYYYYYYYYYY/policies/default?api-version=2019-10-01-preview" @policy.json
280+
PUT https://management.azure.com/providers/Microsoft.Billing/billingAccounts/{billingAccountName}/customers/{customerID}/policies/default?api-version=2019-10-01-preview
225281
```
226282

227283
#### To get Azure service usage for a billing account
228284

229285
```
230-
armclient GET /providers/Microsoft.Billing/BillingAccounts/XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX:XXXXXXXX-XXXX-XXXX-XXXXXXXXXXXXXXXXX_2019-05-31/providers/Microsoft.Consumption/usageDetails?api-version=2019-10-01
286+
GET https://management.azure.com/providers/Microsoft.Billing/BillingAccounts/{billingAccountName}/providers/Microsoft.Consumption/usageDetails?api-version=2019-10-01
231287
```
232288

233289
#### To download a customer's Azure service usage
234290

235291
The following get call is an asynchronous operation.
236292

237293
```
238-
armclient get providers/Microsoft.Billing/billingAccounts/XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX:XXXXXXXX-XXXX-XXXX-XXXXXXXXXXXXXXXXX_2019-05-31/customers/YYYYYYYY-YYYY-YYYY-YYYY-YYYYYYYYYYYY/providers/Microsoft.Consumption/usageDetails/download?api-version=2019-10-01 -verbose
294+
GET https://management.azure.com/Microsoft.Billing/billingAccounts/{billingAccountName}/customers/{customerID}/providers/Microsoft.Consumption/usageDetails/download?api-version=2019-10-01 -verbose
239295
```
240296

241297
Call the `Location` URI returned in the response to check the operation status. When the status is *Completed*, the `downloadUrl` property contains a link that you can use to download the generated report.
@@ -246,50 +302,40 @@ Call the `Location` URI returned in the response to check the operation status.
246302
First, use the following post.
247303

248304
```
249-
armclient post "/providers/Microsoft.Billing/BillingAccounts/XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX:XXXXXXXX-XXXX-XXXX-XXXXXXXXXXXXXXXXX_2019-05-31/billingProfiles/YYYY-YYYY-YYY-YYYY-YYY/pricesheet/default/download?api-version=2019-10-01-preview&format=csv" -verbose
305+
POST https://management.azure.com/providers/Microsoft.Billing/BillingAccounts/{billingAccountName}/billingProfiles/{billingProfileID}/pricesheet/default/download?api-version=2019-10-01-preview&format=csv" -verbose
250306
```
251307

252308
Then, call the asynchronous operation property value. For example:
253309

254310
```
255-
armclient get "providers/Microsoft.Billing/billingAccounts/XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX:XXXXXXXX-XXXX-XXXX-XXXXXXXXXXXXXXXXX_2019-05-31/billingProfiles/YYYY-YYYY-YYY-YYYY-YYY/pricesheetDownloadOperations/XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX?sessiontoken=0:11186&api-version=2019-10-01-preview"
311+
GET https://management.azure.com/providers/Microsoft.Billing/billingAccounts/{billingAccountName}/billingProfiles/{billingProfileID}/pricesheetDownloadOperations/{operation}?sessiontoken=0:11186&api-version=2019-10-01-preview
256312
```
257313
The preceding get call returns the download link containing the price sheet.
258314

259-
#### To get customer costs for the last two months, sorted by month
260-
261-
```
262-
armclient post providers/microsoft.billing/billingAccounts/XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX:XXXXXXXX-XXXX-XXXX-XXXXXXXXXXXXXXXXX_2019-05-31//providers/microsoft.costmanagement/query?api-version=2019-10-01 @CCMQueryCustomer.json
263-
```
264315

265-
#### To get Azure subscription costs for the last two months, sorted by month
316+
#### To get aggregated costs
266317

267318
```
268-
armclient post providers/microsoft.billing/billingAccounts/XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX:XXXXXXXX-XXXX-XXXX-XXXXXXXXXXXXXXXXX_2019-05-31//providers/microsoft.costmanagement/query?api-version=2019-10-01 @CCMQuerySubscription.json
269-
```
270-
271-
#### To get daily costs for the current month
272-
273-
```
274-
armclient post providers/microsoft.billing/billingAccounts/XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX:XXXXXXXX-XXXX-XXXX-XXXXXXXXXXXXXXXXX_2019-05-31//providers/microsoft.costmanagement/query?api-version=2019-10-01 @CCMQueryDaily.json
319+
POST https://management.azure.com/providers/microsoft.billing/billingAccounts/{billingAccountName}/providers/microsoft.costmanagement/query?api-version=2019-10-01
275320
```
276321

277322
#### Create a budget for a partner
278323

279324
```
280-
armclient put providers/Microsoft.Billing/billingAccounts/XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX:XXXXXXXX-XXXX-XXXX-XXXXXXXXXXXXXXXXX_2019-05-31/providers/Microsoft.CostManagement/budgets/partnerworkshopbudget?api-version=2019-10-01 @budgetCreate.json
325+
PUT https://management.azure.com/providers/Microsoft.Billing/billingAccounts/{billingAccountName}/providers/Microsoft.CostManagement/budgets/partnerworkshopbudget?api-version=2019-10-01
281326
```
282327

283-
284328
#### Create a budget for a customer
285329

286330
```
287-
armclient put providers/Microsoft.Billing/billingAccounts/XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX:XXXXXXXX-XXXX-XXXX-XXXXXXXXXXXXXXXXX_2019-05-31/customers/XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX/providers/Microsoft.Consumption/budgets/test-partner-demo?api-version=2019-10-01 @budgetCreate.json
331+
PUT https://management.azure.com/providers/Microsoft.Billing/billingAccounts/{billingAccountName}/customers/{customerID}/providers/Microsoft.Consumption/budgets/{budgetName}?api-version=2019-10-01
288332
```
333+
289334
#### Delete a budget
290335

291336
```
292-
armclient delete providers/Microsoft.Billing/billingAccounts/XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX:XXXXXXXX-XXXX-XXXX-XXXXXXXXXXXXXXXXX_2019-05-31/providers/Microsoft.CostManagement/budgets/partnerworkshopbudget?api-version=2019-10-01
337+
PUT
338+
https://management.azure.com/providers/Microsoft.Billing/billingAccounts/{billingAccountId}/providers/Microsoft.CostManagement/budgets/{budgetName}?api-version=2019-10-01
293339
```
294340

295341

0 commit comments

Comments
 (0)