Microsoft.Billing (stable:2025-03-01)

2025/03/24 • 8 new methods

CostAllocationRules_List (new)
Description Get the list of all cost allocation rules for a billing account or enterprise enrollment.
Reference Link ¶

⚼ Request

GET:  /providers/Microsoft.Billing/billingAccounts/{billingAccountId}/providers/Microsoft.CostManagement/costAllocationRules
{
api-version: string ,
billingAccountId: string ,
}

⚐ Response (200)

{
value:
[
{
id: string ,
name: string ,
type: string ,
properties:
{
description: string ,
details:
{
sourceResources:
[
string ,
]
,
targetResources:
[
string ,
]
,
}
,
status: enum ,
createdDate: string ,
updatedDate: string ,
}
,
}
,
]
,
nextLink: string ,
}

⚐ Response (default)

{
error:
{
code: string ,
message: string ,
}
,
}
CostAllocationRules_CheckNameAvailability (new)
Description Checks availability and correctness of a name for a cost allocation rule
Reference Link ¶

⚼ Request

POST:  /providers/Microsoft.Billing/billingAccounts/{billingAccountId}/providers/Microsoft.CostManagement/costAllocationRules/checkNameAvailability
{
api-version: string ,
billingAccountId: string ,
costAllocationRuleCheckNameAvailabilityRequest:
{
name: string ,
type: string ,
}
,
}

⚐ Response (200)

{
nameAvailable: boolean ,
reason: enum ,
message: string ,
}

⚐ Response (default)

{
error:
{
code: string ,
message: string ,
}
,
}
CostAllocationRules_Get (new)
Description Get a cost allocation rule by rule name and billing account or enterprise enrollment.
Reference Link ¶

⚼ Request

GET:  /providers/Microsoft.Billing/billingAccounts/{billingAccountId}/providers/Microsoft.CostManagement/costAllocationRules/{ruleName}
{
api-version: string ,
billingAccountId: string ,
ruleName: string ,
}

⚐ Response (200)

{
id: string ,
name: string ,
type: string ,
properties:
{
description: string ,
details:
{
sourceResources:
[
string ,
]
,
targetResources:
[
string ,
]
,
}
,
status: enum ,
createdDate: string ,
updatedDate: string ,
}
,
}

⚐ Response (default)

{
error:
{
code: string ,
message: string ,
}
,
}
CostAllocationRules_CreateOrUpdate (new)
Description Create/Update a rule to allocate cost between different resources within a billing account or enterprise enrollment.
Reference Link ¶

⚼ Request

PUT:  /providers/Microsoft.Billing/billingAccounts/{billingAccountId}/providers/Microsoft.CostManagement/costAllocationRules/{ruleName}
{
api-version: string ,
billingAccountId: string ,
ruleName: string ,
costAllocationRule:
{
id: string ,
name: string ,
type: string ,
properties:
{
description: string ,
details:
{
sourceResources:
[
string ,
]
,
targetResources:
[
string ,
]
,
}
,
status: enum ,
createdDate: string ,
updatedDate: string ,
}
,
}
,
}

⚐ Response (200)

{
id: string ,
name: string ,
type: string ,
properties:
{
description: string ,
details:
{
sourceResources:
[
string ,
]
,
targetResources:
[
string ,
]
,
}
,
status: enum ,
createdDate: string ,
updatedDate: string ,
}
,
}

⚐ Response (201)

{
id: string ,
name: string ,
type: string ,
properties:
{
description: string ,
details:
{
sourceResources:
[
string ,
]
,
targetResources:
[
string ,
]
,
}
,
status: enum ,
createdDate: string ,
updatedDate: string ,
}
,
}

⚐ Response (default)

{
error:
{
code: string ,
message: string ,
}
,
}
CostAllocationRules_Delete (new)
Description Delete cost allocation rule for billing account or enterprise enrollment.
Reference Link ¶

⚼ Request

DELETE:  /providers/Microsoft.Billing/billingAccounts/{billingAccountId}/providers/Microsoft.CostManagement/costAllocationRules/{ruleName}
{
api-version: string ,
billingAccountId: string ,
ruleName: string ,
}

⚐ Response (200)

{}

⚐ Response (204)

{}

⚐ Response (default)

{
error:
{
code: string ,
message: string ,
}
,
}
PriceSheet_DownloadByInvoice (new)
Description Gets a URL to download the pricesheet for an invoice. The operation is supported for billing accounts with agreement type Microsoft Partner Agreement or Microsoft Customer Agreement.
Reference Link ¶

⚼ Request

POST:  /providers/Microsoft.Billing/billingAccounts/{billingAccountName}/billingProfiles/{billingProfileName}/invoices/{invoiceName}/providers/Microsoft.CostManagement/pricesheets/default/download
{
api-version: string ,
billingAccountName: string ,
billingProfileName: string ,
invoiceName: string ,
}

⚐ Response (202)

{
location: string ,
retry-after: string ,
odata-entityid: string ,
}

⚐ Response (200)

{
expiryTime: string ,
validTill: string ,
downloadUrl: string ,
}

⚐ Response (default)

{
error:
{
code: string ,
message: string ,
}
,
}
PriceSheet_DownloadByBillingProfile (new)
Description Gets a URL to download the current month's pricesheet for a billing profile. The operation is supported for billing accounts with agreement type Microsoft Partner Agreement or Microsoft Customer Agreement. You can use the new 2023-09-01 API version for billing periods January 2023 onwards. Azure Reserved Instance (RI) pricing is only available through the new version of the API. Due to Azure product growth, the Azure price sheet download experience in this preview version will be updated from a single csv/json file to a Zip file containing multiple csv/json files, each with max size of 75MB.
Reference Link ¶

⚼ Request

POST:  /providers/Microsoft.Billing/billingAccounts/{billingAccountName}/billingProfiles/{billingProfileName}/providers/Microsoft.CostManagement/pricesheets/default/download
{
api-version: string ,
billingAccountName: string ,
billingProfileName: string ,
}

⚐ Response (202)

{
location: string ,
retry-after: string ,
odata-entityid: string ,
}

⚐ Response (200)

{
expiryTime: string ,
downloadUrl: string ,
downloadFileProperties:
{
billingAccountID: string ,
billingAccountName: string ,
billingProfileId: string ,
billingProfileName: string ,
productOrderName: string ,
serviceFamily: number ,
product: string ,
productId: string ,
skuId: string ,
unitOfMeasure: string ,
meterId: string ,
meterName: string ,
meterType: string ,
meterCategory: string ,
meterSubCategory: string ,
meterRegion: string ,
tierMinimumUnits: string ,
effectiveStartDate: string ,
effectiveEndDate: string ,
unitPrice: string ,
basePrice: string ,
marketPrice: string ,
currency: string ,
billingCurrency: string ,
term: string ,
priceType: string ,
}
,
}

⚐ Response (default)

{
error:
{
code: string ,
message: string ,
}
,
}
PriceSheet_DownloadByBillingAccount (new)
Description Generates the pricesheet for the provided billing period asynchronously based on the Enrollment ID. This is for Enterprise Agreement customers. **Migrate to version 2025-03-01** You can use the 2025-03-01 API version with the new URI: '/providers/Microsoft.Billing/billingAccounts/{billingAccountId}/billingPeriods/{billingPeriodName}/providers/Microsoft.CostManagement/pricesheets/default/download' With a new schema detailed below, the new version of the price sheet provides additional information and includes prices for Azure Reserved Instances (RI) for the current billing period. We recommend downloading an Azure Price Sheet for when entering a new billing period if you would maintain an ongoing record of past Azure Reserved Instance (RI) pricing. The EA Azure price sheet is available for billing periods in the past 13 months. To request a price sheet for a billing period older than 13 months, please contact support. The Azure price sheet download experience has been updated from a single .csv file to a zip file containing multiple .csv files, each with max size of 75MB. The 2023-11-01 version has been upgraded to use http POST method; details can be found below. All versions of the Microsoft.Consumption Azure Price Sheet - Download by Billing Account (including 2022-06-01, 2021-10-01, 2020-01-01-preview, 2019-10-01, 2019-05-01) are scheduled to be retired on 01 June 2026 and will no longer be supported after this date.
Reference Link ¶

⚼ Request

POST:  /providers/Microsoft.Billing/billingAccounts/{billingAccountId}/billingPeriods/{billingPeriodName}/providers/Microsoft.CostManagement/pricesheets/default/download
{
api-version: string ,
billingAccountId: string ,
billingPeriodName: string ,
}

⚐ Response (202)

{
location: string ,
retry-after: string ,
}

⚐ Response (200)

{
status: enum ,
properties:
{
downloadUrl: string ,
validTill: string ,
downloadFileProperties:
{
enrollmentNumber: string ,
serviceFamily: number ,
product: string ,
productId: string ,
skuId: string ,
unitOfMeasure: string ,
meterId: string ,
meterName: string ,
meterType: string ,
offerId: string ,
meterCategory: string ,
meterSubCategory: string ,
meterRegion: string ,
effectiveStartDate: string ,
effectiveEndDate: string ,
unitPrice: string ,
basePrice: string ,
marketPrice: string ,
includedQuantity: string ,
currencyCode: string ,
term: string ,
priceType: string ,
partNumber: string ,
}
,
}
,
}

⚐ Response (default)

{
error:
{
code: string ,
message: string ,
target: string ,
details:
[
string ,
]
,
additionalInfo:
[
{
type: string ,
info: object ,
}
,
]
,
}
,
}