Microsoft.Billing (preview:2022-10-05)

2025/10/30 • 4 new, 4 deleted methods

MarkupRules_List (new)
Description :  Retrieve all the active markup rules for the partner billing account/billing profile calling the API.
Reference :  Link ¶

⚼ Request

GET:  /providers/Microsoft.Billing/billingAccounts/{billingAccountId}/billingProfiles/{billingProfileId}/providers/Microsoft.CostManagement/markupRules
{
billingAccountId:
{
Description: BillingAccount ID ,
Required: True ,
}
string ,
billingProfileId:
{
Description: BillingProfile ID ,
Required: True ,
}
string ,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
value:
{
Description: The list of markup rules. ,
Required: False ,
}
[
{
properties:
{
Description: The properties of the markup rule. ,
Required: False ,
}
{
description:
{
Description: The description of the markup rule. ,
Required: False ,
}
string ,
percentage:
{
Description: The markup percentage of the rule. ,
Format: double ,
Required: True ,
}
number ,
startDate:
{
Description: Starting date of the markup rule. ,
Format: date-time ,
Required: True ,
}
string ,
endDate:
{
Description: Ending date of the markup rule. ,
Format: date-time ,
Required: False ,
}
string ,
customerDetails:
{
Description: Customer information for the markup rule. ,
Required: True ,
}
{
billingAccountId:
{
Description: Customer billing account id ,
Required: True ,
}
string ,
billingProfileId:
{
Description: Customer billing profile id ,
Required: True ,
}
string ,
}
,
}
,
}
,
]
,
nextLink:
{
Description: The link (url) to the next page of results. ,
Required: False ,
}
string ,
}

⚐ Response (default)

{
error:
{
Description: The details of the error. ,
Required: False ,
}
{
code:
{
Description: Error code. ,
Required: False ,
}
string ,
message:
{
Description: Error message indicating why the operation failed. ,
Required: False ,
}
string ,
}
,
}
MarkupRules_CreateOrUpdate (new)
Description :  Create or update a markup rule
Reference :  Link ¶

⚼ Request

PUT:  /providers/Microsoft.Billing/billingAccounts/{billingAccountId}/billingProfiles/{billingProfileId}/providers/Microsoft.CostManagement/markupRules/{name}
{
billingAccountId:
{
Description: BillingAccount ID ,
Required: True ,
}
string ,
billingProfileId:
{
Description: BillingProfile ID ,
Required: True ,
}
string ,
name:
{
Description: Markup rule name. ,
Required: True ,
}
string ,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
markupRule:
{
Description: Markup rule to be created or updated. ,
Required: True ,
}
{
properties:
{
Description: The properties of the markup rule. ,
Required: False ,
}
{
description:
{
Description: The description of the markup rule. ,
Required: False ,
}
string ,
percentage:
{
Description: The markup percentage of the rule. ,
Format: double ,
Required: True ,
}
number ,
startDate:
{
Description: Starting date of the markup rule. ,
Format: date-time ,
Required: True ,
}
string ,
endDate:
{
Description: Ending date of the markup rule. ,
Format: date-time ,
Required: False ,
}
string ,
customerDetails:
{
Description: Customer information for the markup rule. ,
Required: True ,
}
{
billingAccountId:
{
Description: Customer billing account id ,
Required: True ,
}
string ,
billingProfileId:
{
Description: Customer billing profile id ,
Required: True ,
}
string ,
}
,
}
,
}
,
}

⚐ Response (200)

{
properties:
{
Description: The properties of the markup rule. ,
Required: False ,
}
{
description:
{
Description: The description of the markup rule. ,
Required: False ,
}
string ,
percentage:
{
Description: The markup percentage of the rule. ,
Format: double ,
Required: True ,
}
number ,
startDate:
{
Description: Starting date of the markup rule. ,
Format: date-time ,
Required: True ,
}
string ,
endDate:
{
Description: Ending date of the markup rule. ,
Format: date-time ,
Required: False ,
}
string ,
customerDetails:
{
Description: Customer information for the markup rule. ,
Required: True ,
}
{
billingAccountId:
{
Description: Customer billing account id ,
Required: True ,
}
string ,
billingProfileId:
{
Description: Customer billing profile id ,
Required: True ,
}
string ,
}
,
}
,
}

⚐ Response (201)

{
properties:
{
Description: The properties of the markup rule. ,
Required: False ,
}
{
description:
{
Description: The description of the markup rule. ,
Required: False ,
}
string ,
percentage:
{
Description: The markup percentage of the rule. ,
Format: double ,
Required: True ,
}
number ,
startDate:
{
Description: Starting date of the markup rule. ,
Format: date-time ,
Required: True ,
}
string ,
endDate:
{
Description: Ending date of the markup rule. ,
Format: date-time ,
Required: False ,
}
string ,
customerDetails:
{
Description: Customer information for the markup rule. ,
Required: True ,
}
{
billingAccountId:
{
Description: Customer billing account id ,
Required: True ,
}
string ,
billingProfileId:
{
Description: Customer billing profile id ,
Required: True ,
}
string ,
}
,
}
,
}

⚐ Response (default)

{
error:
{
Description: The details of the error. ,
Required: False ,
}
{
code:
{
Description: Error code. ,
Required: False ,
}
string ,
message:
{
Description: Error message indicating why the operation failed. ,
Required: False ,
}
string ,
}
,
}
MarkupRules_Get (new)
Description :  Get a markup rule by its rule name.
Reference :  Link ¶

⚼ Request

GET:  /providers/Microsoft.Billing/billingAccounts/{billingAccountId}/billingProfiles/{billingProfileId}/providers/Microsoft.CostManagement/markupRules/{name}
{
billingAccountId:
{
Description: BillingAccount ID ,
Required: True ,
}
string ,
billingProfileId:
{
Description: BillingProfile ID ,
Required: True ,
}
string ,
name:
{
Description: Markup rule name. ,
Required: True ,
}
string ,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
properties:
{
Description: The properties of the markup rule. ,
Required: False ,
}
{
description:
{
Description: The description of the markup rule. ,
Required: False ,
}
string ,
percentage:
{
Description: The markup percentage of the rule. ,
Format: double ,
Required: True ,
}
number ,
startDate:
{
Description: Starting date of the markup rule. ,
Format: date-time ,
Required: True ,
}
string ,
endDate:
{
Description: Ending date of the markup rule. ,
Format: date-time ,
Required: False ,
}
string ,
customerDetails:
{
Description: Customer information for the markup rule. ,
Required: True ,
}
{
billingAccountId:
{
Description: Customer billing account id ,
Required: True ,
}
string ,
billingProfileId:
{
Description: Customer billing profile id ,
Required: True ,
}
string ,
}
,
}
,
}

⚐ Response (default)

{
error:
{
Description: The details of the error. ,
Required: False ,
}
{
code:
{
Description: Error code. ,
Required: False ,
}
string ,
message:
{
Description: Error message indicating why the operation failed. ,
Required: False ,
}
string ,
}
,
}
MarkupRules_Delete (new)
Description :  Delete a markup rule. This will not have an effect on closed month markups
Reference :  Link ¶

⚼ Request

DELETE:  /providers/Microsoft.Billing/billingAccounts/{billingAccountId}/billingProfiles/{billingProfileId}/providers/Microsoft.CostManagement/markupRules/{name}
{
billingAccountId:
{
Description: BillingAccount ID ,
Required: True ,
}
string ,
billingProfileId:
{
Description: BillingProfile ID ,
Required: True ,
}
string ,
name:
{
Description: Markup rule name. ,
Required: True ,
}
string ,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{}

⚐ Response (204)

{}

⚐ Response (default)

{
error:
{
Description: The details of the error. ,
Required: False ,
}
{
code:
{
Description: Error code. ,
Required: False ,
}
string ,
message:
{
Description: Error message indicating why the operation failed. ,
Required: False ,
}
string ,
}
,
}
MarkupRules_List (removed)
Description :  Retrieve all the active markup rules for the partner billing account/billing profile calling the API.
Reference :  Link ¶

⚼ Request

GET:  /providers/Microsoft.Billing/billingAccounts/{billingAccountId}/billingProfiles/{billingProfileId}/providers/Microsoft.CostManagement/markupRules
{
billingAccountId:
{
Description: BillingAccount ID ,
Required: True ,
}
string ,
billingProfileId:
{
Description: BillingProfile ID ,
Required: True ,
}
string ,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
value:
{
Description: The list of markup rules. ,
Required: False ,
}
[
{
properties:
{
Description: The properties of the markup rule. ,
Required: False ,
}
{
description:
{
Description: The description of the markup rule. ,
Required: False ,
}
string ,
percentage:
{
Description: The markup percentage of the rule. ,
Format: double ,
Required: True ,
}
number ,
startDate:
{
Description: Starting date of the markup rule. ,
Format: date-time ,
Required: True ,
}
string ,
endDate:
{
Description: Ending date of the markup rule. ,
Format: date-time ,
Required: False ,
}
string ,
customerDetails:
{
Description: Customer information for the markup rule. ,
Required: True ,
}
{
billingAccountId:
{
Description: Customer billing account id ,
Required: True ,
}
string ,
billingProfileId:
{
Description: Customer billing profile id ,
Required: True ,
}
string ,
}
,
}
,
}
,
]
,
nextLink:
{
Description: The link (url) to the next page of results. ,
Required: False ,
}
string ,
}

⚐ Response (default)

{
error:
{
Description: The details of the error. ,
Required: False ,
}
{
code:
{
Description: Error code. ,
Required: False ,
}
string ,
message:
{
Description: Error message indicating why the operation failed. ,
Required: False ,
}
string ,
}
,
}
MarkupRules_CreateOrUpdate (removed)
Description :  Create or update a markup rule
Reference :  Link ¶

⚼ Request

PUT:  /providers/Microsoft.Billing/billingAccounts/{billingAccountId}/billingProfiles/{billingProfileId}/providers/Microsoft.CostManagement/markupRules/{name}
{
billingAccountId:
{
Description: BillingAccount ID ,
Required: True ,
}
string ,
billingProfileId:
{
Description: BillingProfile ID ,
Required: True ,
}
string ,
name:
{
Description: Markup rule name. ,
Required: True ,
}
string ,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
markupRule:
{
Description: Markup rule to be created or updated. ,
Required: True ,
}
{
properties:
{
Description: The properties of the markup rule. ,
Required: False ,
}
{
description:
{
Description: The description of the markup rule. ,
Required: False ,
}
string ,
percentage:
{
Description: The markup percentage of the rule. ,
Format: double ,
Required: True ,
}
number ,
startDate:
{
Description: Starting date of the markup rule. ,
Format: date-time ,
Required: True ,
}
string ,
endDate:
{
Description: Ending date of the markup rule. ,
Format: date-time ,
Required: False ,
}
string ,
customerDetails:
{
Description: Customer information for the markup rule. ,
Required: True ,
}
{
billingAccountId:
{
Description: Customer billing account id ,
Required: True ,
}
string ,
billingProfileId:
{
Description: Customer billing profile id ,
Required: True ,
}
string ,
}
,
}
,
}
,
}

⚐ Response (200)

{
properties:
{
Description: The properties of the markup rule. ,
Required: False ,
}
{
description:
{
Description: The description of the markup rule. ,
Required: False ,
}
string ,
percentage:
{
Description: The markup percentage of the rule. ,
Format: double ,
Required: True ,
}
number ,
startDate:
{
Description: Starting date of the markup rule. ,
Format: date-time ,
Required: True ,
}
string ,
endDate:
{
Description: Ending date of the markup rule. ,
Format: date-time ,
Required: False ,
}
string ,
customerDetails:
{
Description: Customer information for the markup rule. ,
Required: True ,
}
{
billingAccountId:
{
Description: Customer billing account id ,
Required: True ,
}
string ,
billingProfileId:
{
Description: Customer billing profile id ,
Required: True ,
}
string ,
}
,
}
,
}

⚐ Response (201)

{
properties:
{
Description: The properties of the markup rule. ,
Required: False ,
}
{
description:
{
Description: The description of the markup rule. ,
Required: False ,
}
string ,
percentage:
{
Description: The markup percentage of the rule. ,
Format: double ,
Required: True ,
}
number ,
startDate:
{
Description: Starting date of the markup rule. ,
Format: date-time ,
Required: True ,
}
string ,
endDate:
{
Description: Ending date of the markup rule. ,
Format: date-time ,
Required: False ,
}
string ,
customerDetails:
{
Description: Customer information for the markup rule. ,
Required: True ,
}
{
billingAccountId:
{
Description: Customer billing account id ,
Required: True ,
}
string ,
billingProfileId:
{
Description: Customer billing profile id ,
Required: True ,
}
string ,
}
,
}
,
}

⚐ Response (default)

{
error:
{
Description: The details of the error. ,
Required: False ,
}
{
code:
{
Description: Error code. ,
Required: False ,
}
string ,
message:
{
Description: Error message indicating why the operation failed. ,
Required: False ,
}
string ,
}
,
}
MarkupRules_Get (removed)
Description :  Get a markup rule by its rule name.
Reference :  Link ¶

⚼ Request

GET:  /providers/Microsoft.Billing/billingAccounts/{billingAccountId}/billingProfiles/{billingProfileId}/providers/Microsoft.CostManagement/markupRules/{name}
{
billingAccountId:
{
Description: BillingAccount ID ,
Required: True ,
}
string ,
billingProfileId:
{
Description: BillingProfile ID ,
Required: True ,
}
string ,
name:
{
Description: Markup rule name. ,
Required: True ,
}
string ,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
properties:
{
Description: The properties of the markup rule. ,
Required: False ,
}
{
description:
{
Description: The description of the markup rule. ,
Required: False ,
}
string ,
percentage:
{
Description: The markup percentage of the rule. ,
Format: double ,
Required: True ,
}
number ,
startDate:
{
Description: Starting date of the markup rule. ,
Format: date-time ,
Required: True ,
}
string ,
endDate:
{
Description: Ending date of the markup rule. ,
Format: date-time ,
Required: False ,
}
string ,
customerDetails:
{
Description: Customer information for the markup rule. ,
Required: True ,
}
{
billingAccountId:
{
Description: Customer billing account id ,
Required: True ,
}
string ,
billingProfileId:
{
Description: Customer billing profile id ,
Required: True ,
}
string ,
}
,
}
,
}

⚐ Response (default)

{
error:
{
Description: The details of the error. ,
Required: False ,
}
{
code:
{
Description: Error code. ,
Required: False ,
}
string ,
message:
{
Description: Error message indicating why the operation failed. ,
Required: False ,
}
string ,
}
,
}
MarkupRules_Delete (removed)
Description :  Delete a markup rule. This will not have an effect on closed month markups
Reference :  Link ¶

⚼ Request

DELETE:  /providers/Microsoft.Billing/billingAccounts/{billingAccountId}/billingProfiles/{billingProfileId}/providers/Microsoft.CostManagement/markupRules/{name}
{
billingAccountId:
{
Description: BillingAccount ID ,
Required: True ,
}
string ,
billingProfileId:
{
Description: BillingProfile ID ,
Required: True ,
}
string ,
name:
{
Description: Markup rule name. ,
Required: True ,
}
string ,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{}

⚐ Response (204)

{}

⚐ Response (default)

{
error:
{
Description: The details of the error. ,
Required: False ,
}
{
code:
{
Description: Error code. ,
Required: False ,
}
string ,
message:
{
Description: Error message indicating why the operation failed. ,
Required: False ,
}
string ,
}
,
}