Microsoft.CostManagement (preview:2019-04-01)

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

Views_List (new)
Description :  Lists all views by tenant and object.
Reference :  Link ¶

⚼ Request

GET:  /providers/Microsoft.CostManagement/views
{
api-version:
{
Description: Version of the API to be used with the client request. The current version is 2019-04-01-preview ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
value:
{
Description: The list of views. ,
Required: False ,
}
[
{
properties:
{
Description: The properties of the view. ,
Required: False ,
}
{
displayName:
{
Description: User input name of the view. Required. ,
Required: False ,
}
string ,
scope:
{
Description: Cost Management scope to save the view on. This includes 'subscriptions/{subscriptionId}' for subscription scope, 'subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}' for resourceGroup scope, 'providers/Microsoft.Billing/billingAccounts/{billingAccountId}' for Billing Account scope, 'providers/Microsoft.Billing/billingAccounts/{billingAccountId}/departments/{departmentId}' for Department scope, 'providers/Microsoft.Billing/billingAccounts/{billingAccountId}/enrollmentAccounts/{enrollmentAccountId}' for EnrollmentAccount scope, 'providers/Microsoft.Billing/billingAccounts/{billingAccountId}/billingProfiles/{billingProfileId}' for BillingProfile scope, 'providers/Microsoft.Billing/billingAccounts/{billingAccountId}/invoiceSections/{invoiceSectionId}' for InvoiceSection scope, 'providers/Microsoft.Management/managementGroups/{managementGroupId}' for Management Group scope, '/providers/Microsoft.CostManagement/externalBillingAccounts/{externalBillingAccountName}' for ExternalBillingAccount scope, and '/providers/Microsoft.CostManagement/externalSubscriptions/{externalSubscriptionName}' for ExternalSubscription scope. ,
Required: False ,
}
string ,
createdOn:
{
Description: Date the user created this view. ,
Format: date-time ,
Required: False ,
}
string ,
modifiedOn:
{
Description: Date when the user last modified this view. ,
Format: date-time ,
Required: False ,
}
string ,
query:
{
Description: Query body configuration. Required. ,
Required: False ,
}
{
type:
{
Description: The type of the report. Usage represents actual usage, forecast represents forecasted data and UsageAndForecast represents both usage and forecasted data. Actual usage and forecasted data can be differentiated based on dates. ,
Enum:
{
Usage: No description available. ,
}
,
Required: True ,
}
enum ,
timeframe:
{
Description: The time frame for pulling data for the report. If custom, then a specific time period must be provided. ,
Enum:
{
WeekToDate: No description available. ,
MonthToDate: No description available. ,
YearToDate: No description available. ,
Custom: No description available. ,
}
,
Required: True ,
}
enum ,
timePeriod:
{
Description: Has time period for pulling data for the report. ,
Required: False ,
}
{
from:
{
Description: The start date to pull data from. ,
Format: date-time ,
Required: True ,
}
string ,
to:
{
Description: The end date to pull data to. ,
Format: date-time ,
Required: True ,
}
string ,
}
,
dataset:
{
Description: Has definition for data in this report config. ,
Required: False ,
}
{
granularity:
{
Description: The granularity of rows in the report. ,
Enum:
{
Daily: No description available. ,
Monthly: No description available. ,
}
,
Required: False ,
}
enum ,
configuration:
{
Description: Has configuration information for the data in the report. The configuration will be ignored if aggregation and grouping are provided. ,
Required: False ,
}
{
columns:
{
Description: Array of column names to be included in the report. Any valid report column name is allowed. If not provided, then report includes all columns. ,
Required: False ,
}
[
string ,
]
,
}
,
aggregation:
{
Description: Dictionary of aggregation expression to use in the report. The key of each item in the dictionary is the alias for the aggregated column. Report can have up to 2 aggregation clauses. ,
Required: False ,
}
object ,
grouping:
{
Description: Array of group by expression to use in the report. Report can have up to 2 group by clauses. ,
Required: False ,
}
[
{
type:
{
Description: Has type of the column to group. ,
Enum:
{
Tag: No description available. ,
Dimension: No description available. ,
}
,
Required: True ,
}
enum ,
name:
{
Description: The name of the column to group. This version supports subscription lowest possible grain. ,
Required: True ,
}
string ,
}
,
]
,
sorting:
{
Description: Array of order by expression to use in the report. ,
Required: False ,
}
[
{
direction:
{
Description: Direction of sort. ,
Enum:
{
Ascending: No description available. ,
Descending: No description available. ,
}
,
Required: False ,
}
enum ,
name:
{
Description: The name of the column to sort. ,
Required: True ,
}
string ,
}
,
]
,
filter:
{
Description: Has filter expression to use in the report. ,
Required: False ,
}
{
and:
{
Description: The logical "AND" expression. Must have at least 2 items. ,
Required: False ,
}
[
string ,
]
,
or:
{
Description: The logical "OR" expression. Must have at least 2 items. ,
Required: False ,
}
[
string ,
]
,
not:
{
Required: False ,
}
string ,
dimension:
{
Description: Has comparison expression for a dimension ,
Required: False ,
}
{
name:
{
Description: The name of the column to use in comparison. ,
Required: True ,
}
string ,
operator:
{
Description: The operator to use for comparison. ,
Enum:
{
In: No description available. ,
Contains: No description available. ,
}
,
Required: True ,
}
enum ,
values:
{
Description: Array of values to use for comparison ,
Required: True ,
}
[
string ,
]
,
}
,
tag:
{
Description: Has comparison expression for a tag ,
Required: False ,
}
{
name:
{
Description: The name of the column to use in comparison. ,
Required: True ,
}
string ,
operator:
{
Description: The operator to use for comparison. ,
Enum:
{
In: No description available. ,
Contains: No description available. ,
}
,
Required: True ,
}
enum ,
values:
{
Description: Array of values to use for comparison ,
Required: True ,
}
[
string ,
]
,
}
,
}
,
}
,
}
,
chart:
{
Description: Chart type of the main view in Cost Analysis. Required. ,
Enum:
{
Area: No description available. ,
Line: No description available. ,
StackedColumn: No description available. ,
GroupedColumn: No description available. ,
Table: No description available. ,
}
,
Required: False ,
}
enum ,
accumulated:
{
Description: Show costs accumulated over time. ,
Enum:
{
true: No description available. ,
false: No description available. ,
}
,
Required: False ,
}
enum ,
metric:
{
Description: Metric to use when displaying costs. ,
Enum:
{
ActualCost: No description available. ,
AmortizedCost: No description available. ,
AHUB: No description available. ,
}
,
Required: False ,
}
enum ,
kpis:
{
Description: List of KPIs to show in Cost Analysis UI. ,
Required: False ,
}
[
{
type:
{
Description: KPI type (Forecast, Budget). ,
Enum:
{
Forecast: No description available. ,
Budget: No description available. ,
}
,
Required: False ,
}
enum ,
id:
{
Description: ID of resource related to metric (budget). ,
Required: False ,
}
string ,
enabled:
{
Description: show the KPI in the UI? ,
Required: False ,
}
boolean ,
}
,
]
,
pivots:
{
Description: Configuration of 3 sub-views in the Cost Analysis UI. ,
Required: False ,
}
[
{
type:
{
Description: Data type to show in view. ,
Enum:
{
Dimension: No description available. ,
TagKey: No description available. ,
}
,
Required: False ,
}
enum ,
name:
{
Description: Data field to show in view. ,
Required: False ,
}
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: A machine readable error code. ,
Required: False ,
}
string ,
message:
{
Description: A human readable error message. ,
Required: False ,
}
string ,
target:
{
Description: Indicates which property in the request is responsible for the error. ,
Required: False ,
}
string ,
details:
{
Description: error details. ,
Required: False ,
}
[
{
code:
{
Description: A machine readable error code. ,
Required: False ,
}
string ,
message:
{
Description: A human readable error message. ,
Required: False ,
}
string ,
target:
{
Description: Indicates which property in the request is responsible for the error. ,
Required: False ,
}
string ,
}
,
]
,
}
,
}
Views_ListByScope (new)
Description :  Lists all views at the given scope.
Reference :  Link ¶

⚼ Request

GET:  /{scope}/providers/Microsoft.CostManagement/views
{
scope:
{
Description: The scope associated with view operations. This includes 'subscriptions/{subscriptionId}' for subscription scope, 'subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}' for resourceGroup scope, 'providers/Microsoft.Billing/billingAccounts/{billingAccountId}' for Billing Account scope, 'providers/Microsoft.Billing/billingAccounts/{billingAccountId}/departments/{departmentId}' for Department scope, 'providers/Microsoft.Billing/billingAccounts/{billingAccountId}/enrollmentAccounts/{enrollmentAccountId}' for EnrollmentAccount scope, 'providers/Microsoft.Billing/billingAccounts/{billingAccountId}/billingProfiles/{billingProfileId}' for BillingProfile scope, 'providers/Microsoft.Billing/billingAccounts/{billingAccountId}/invoiceSections/{invoiceSectionId}' for InvoiceSection scope, 'providers/Microsoft.Management/managementGroups/{managementGroupId}' for Management Group scope, 'providers/Microsoft.CostManagement/externalBillingAccounts/{externalBillingAccountName}' for External Billing Account scope and 'providers/Microsoft.CostManagement/externalSubscriptions/{externalSubscriptionName}' for External Subscription scope. ,
Required: True ,
}
string ,
api-version:
{
Description: Version of the API to be used with the client request. The current version is 2019-04-01-preview ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
value:
{
Description: The list of views. ,
Required: False ,
}
[
{
properties:
{
Description: The properties of the view. ,
Required: False ,
}
{
displayName:
{
Description: User input name of the view. Required. ,
Required: False ,
}
string ,
scope:
{
Description: Cost Management scope to save the view on. This includes 'subscriptions/{subscriptionId}' for subscription scope, 'subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}' for resourceGroup scope, 'providers/Microsoft.Billing/billingAccounts/{billingAccountId}' for Billing Account scope, 'providers/Microsoft.Billing/billingAccounts/{billingAccountId}/departments/{departmentId}' for Department scope, 'providers/Microsoft.Billing/billingAccounts/{billingAccountId}/enrollmentAccounts/{enrollmentAccountId}' for EnrollmentAccount scope, 'providers/Microsoft.Billing/billingAccounts/{billingAccountId}/billingProfiles/{billingProfileId}' for BillingProfile scope, 'providers/Microsoft.Billing/billingAccounts/{billingAccountId}/invoiceSections/{invoiceSectionId}' for InvoiceSection scope, 'providers/Microsoft.Management/managementGroups/{managementGroupId}' for Management Group scope, '/providers/Microsoft.CostManagement/externalBillingAccounts/{externalBillingAccountName}' for ExternalBillingAccount scope, and '/providers/Microsoft.CostManagement/externalSubscriptions/{externalSubscriptionName}' for ExternalSubscription scope. ,
Required: False ,
}
string ,
createdOn:
{
Description: Date the user created this view. ,
Format: date-time ,
Required: False ,
}
string ,
modifiedOn:
{
Description: Date when the user last modified this view. ,
Format: date-time ,
Required: False ,
}
string ,
query:
{
Description: Query body configuration. Required. ,
Required: False ,
}
{
type:
{
Description: The type of the report. Usage represents actual usage, forecast represents forecasted data and UsageAndForecast represents both usage and forecasted data. Actual usage and forecasted data can be differentiated based on dates. ,
Enum:
{
Usage: No description available. ,
}
,
Required: True ,
}
enum ,
timeframe:
{
Description: The time frame for pulling data for the report. If custom, then a specific time period must be provided. ,
Enum:
{
WeekToDate: No description available. ,
MonthToDate: No description available. ,
YearToDate: No description available. ,
Custom: No description available. ,
}
,
Required: True ,
}
enum ,
timePeriod:
{
Description: Has time period for pulling data for the report. ,
Required: False ,
}
{
from:
{
Description: The start date to pull data from. ,
Format: date-time ,
Required: True ,
}
string ,
to:
{
Description: The end date to pull data to. ,
Format: date-time ,
Required: True ,
}
string ,
}
,
dataset:
{
Description: Has definition for data in this report config. ,
Required: False ,
}
{
granularity:
{
Description: The granularity of rows in the report. ,
Enum:
{
Daily: No description available. ,
Monthly: No description available. ,
}
,
Required: False ,
}
enum ,
configuration:
{
Description: Has configuration information for the data in the report. The configuration will be ignored if aggregation and grouping are provided. ,
Required: False ,
}
{
columns:
{
Description: Array of column names to be included in the report. Any valid report column name is allowed. If not provided, then report includes all columns. ,
Required: False ,
}
[
string ,
]
,
}
,
aggregation:
{
Description: Dictionary of aggregation expression to use in the report. The key of each item in the dictionary is the alias for the aggregated column. Report can have up to 2 aggregation clauses. ,
Required: False ,
}
object ,
grouping:
{
Description: Array of group by expression to use in the report. Report can have up to 2 group by clauses. ,
Required: False ,
}
[
{
type:
{
Description: Has type of the column to group. ,
Enum:
{
Tag: No description available. ,
Dimension: No description available. ,
}
,
Required: True ,
}
enum ,
name:
{
Description: The name of the column to group. This version supports subscription lowest possible grain. ,
Required: True ,
}
string ,
}
,
]
,
sorting:
{
Description: Array of order by expression to use in the report. ,
Required: False ,
}
[
{
direction:
{
Description: Direction of sort. ,
Enum:
{
Ascending: No description available. ,
Descending: No description available. ,
}
,
Required: False ,
}
enum ,
name:
{
Description: The name of the column to sort. ,
Required: True ,
}
string ,
}
,
]
,
filter:
{
Description: Has filter expression to use in the report. ,
Required: False ,
}
{
and:
{
Description: The logical "AND" expression. Must have at least 2 items. ,
Required: False ,
}
[
string ,
]
,
or:
{
Description: The logical "OR" expression. Must have at least 2 items. ,
Required: False ,
}
[
string ,
]
,
not:
{
Required: False ,
}
string ,
dimension:
{
Description: Has comparison expression for a dimension ,
Required: False ,
}
{
name:
{
Description: The name of the column to use in comparison. ,
Required: True ,
}
string ,
operator:
{
Description: The operator to use for comparison. ,
Enum:
{
In: No description available. ,
Contains: No description available. ,
}
,
Required: True ,
}
enum ,
values:
{
Description: Array of values to use for comparison ,
Required: True ,
}
[
string ,
]
,
}
,
tag:
{
Description: Has comparison expression for a tag ,
Required: False ,
}
{
name:
{
Description: The name of the column to use in comparison. ,
Required: True ,
}
string ,
operator:
{
Description: The operator to use for comparison. ,
Enum:
{
In: No description available. ,
Contains: No description available. ,
}
,
Required: True ,
}
enum ,
values:
{
Description: Array of values to use for comparison ,
Required: True ,
}
[
string ,
]
,
}
,
}
,
}
,
}
,
chart:
{
Description: Chart type of the main view in Cost Analysis. Required. ,
Enum:
{
Area: No description available. ,
Line: No description available. ,
StackedColumn: No description available. ,
GroupedColumn: No description available. ,
Table: No description available. ,
}
,
Required: False ,
}
enum ,
accumulated:
{
Description: Show costs accumulated over time. ,
Enum:
{
true: No description available. ,
false: No description available. ,
}
,
Required: False ,
}
enum ,
metric:
{
Description: Metric to use when displaying costs. ,
Enum:
{
ActualCost: No description available. ,
AmortizedCost: No description available. ,
AHUB: No description available. ,
}
,
Required: False ,
}
enum ,
kpis:
{
Description: List of KPIs to show in Cost Analysis UI. ,
Required: False ,
}
[
{
type:
{
Description: KPI type (Forecast, Budget). ,
Enum:
{
Forecast: No description available. ,
Budget: No description available. ,
}
,
Required: False ,
}
enum ,
id:
{
Description: ID of resource related to metric (budget). ,
Required: False ,
}
string ,
enabled:
{
Description: show the KPI in the UI? ,
Required: False ,
}
boolean ,
}
,
]
,
pivots:
{
Description: Configuration of 3 sub-views in the Cost Analysis UI. ,
Required: False ,
}
[
{
type:
{
Description: Data type to show in view. ,
Enum:
{
Dimension: No description available. ,
TagKey: No description available. ,
}
,
Required: False ,
}
enum ,
name:
{
Description: Data field to show in view. ,
Required: False ,
}
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: A machine readable error code. ,
Required: False ,
}
string ,
message:
{
Description: A human readable error message. ,
Required: False ,
}
string ,
target:
{
Description: Indicates which property in the request is responsible for the error. ,
Required: False ,
}
string ,
details:
{
Description: error details. ,
Required: False ,
}
[
{
code:
{
Description: A machine readable error code. ,
Required: False ,
}
string ,
message:
{
Description: A human readable error message. ,
Required: False ,
}
string ,
target:
{
Description: Indicates which property in the request is responsible for the error. ,
Required: False ,
}
string ,
}
,
]
,
}
,
}
Views_Get (new)
Description :  Gets the view by view name.
Reference :  Link ¶

⚼ Request

GET:  /providers/Microsoft.CostManagement/views/{viewName}
{
api-version:
{
Description: Version of the API to be used with the client request. The current version is 2019-04-01-preview ,
Required: True ,
}
string ,
viewName:
{
Description: View name ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
properties:
{
Description: The properties of the view. ,
Required: False ,
}
{
displayName:
{
Description: User input name of the view. Required. ,
Required: False ,
}
string ,
scope:
{
Description: Cost Management scope to save the view on. This includes 'subscriptions/{subscriptionId}' for subscription scope, 'subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}' for resourceGroup scope, 'providers/Microsoft.Billing/billingAccounts/{billingAccountId}' for Billing Account scope, 'providers/Microsoft.Billing/billingAccounts/{billingAccountId}/departments/{departmentId}' for Department scope, 'providers/Microsoft.Billing/billingAccounts/{billingAccountId}/enrollmentAccounts/{enrollmentAccountId}' for EnrollmentAccount scope, 'providers/Microsoft.Billing/billingAccounts/{billingAccountId}/billingProfiles/{billingProfileId}' for BillingProfile scope, 'providers/Microsoft.Billing/billingAccounts/{billingAccountId}/invoiceSections/{invoiceSectionId}' for InvoiceSection scope, 'providers/Microsoft.Management/managementGroups/{managementGroupId}' for Management Group scope, '/providers/Microsoft.CostManagement/externalBillingAccounts/{externalBillingAccountName}' for ExternalBillingAccount scope, and '/providers/Microsoft.CostManagement/externalSubscriptions/{externalSubscriptionName}' for ExternalSubscription scope. ,
Required: False ,
}
string ,
createdOn:
{
Description: Date the user created this view. ,
Format: date-time ,
Required: False ,
}
string ,
modifiedOn:
{
Description: Date when the user last modified this view. ,
Format: date-time ,
Required: False ,
}
string ,
query:
{
Description: Query body configuration. Required. ,
Required: False ,
}
{
type:
{
Description: The type of the report. Usage represents actual usage, forecast represents forecasted data and UsageAndForecast represents both usage and forecasted data. Actual usage and forecasted data can be differentiated based on dates. ,
Enum:
{
Usage: No description available. ,
}
,
Required: True ,
}
enum ,
timeframe:
{
Description: The time frame for pulling data for the report. If custom, then a specific time period must be provided. ,
Enum:
{
WeekToDate: No description available. ,
MonthToDate: No description available. ,
YearToDate: No description available. ,
Custom: No description available. ,
}
,
Required: True ,
}
enum ,
timePeriod:
{
Description: Has time period for pulling data for the report. ,
Required: False ,
}
{
from:
{
Description: The start date to pull data from. ,
Format: date-time ,
Required: True ,
}
string ,
to:
{
Description: The end date to pull data to. ,
Format: date-time ,
Required: True ,
}
string ,
}
,
dataset:
{
Description: Has definition for data in this report config. ,
Required: False ,
}
{
granularity:
{
Description: The granularity of rows in the report. ,
Enum:
{
Daily: No description available. ,
Monthly: No description available. ,
}
,
Required: False ,
}
enum ,
configuration:
{
Description: Has configuration information for the data in the report. The configuration will be ignored if aggregation and grouping are provided. ,
Required: False ,
}
{
columns:
{
Description: Array of column names to be included in the report. Any valid report column name is allowed. If not provided, then report includes all columns. ,
Required: False ,
}
[
string ,
]
,
}
,
aggregation:
{
Description: Dictionary of aggregation expression to use in the report. The key of each item in the dictionary is the alias for the aggregated column. Report can have up to 2 aggregation clauses. ,
Required: False ,
}
object ,
grouping:
{
Description: Array of group by expression to use in the report. Report can have up to 2 group by clauses. ,
Required: False ,
}
[
{
type:
{
Description: Has type of the column to group. ,
Enum:
{
Tag: No description available. ,
Dimension: No description available. ,
}
,
Required: True ,
}
enum ,
name:
{
Description: The name of the column to group. This version supports subscription lowest possible grain. ,
Required: True ,
}
string ,
}
,
]
,
sorting:
{
Description: Array of order by expression to use in the report. ,
Required: False ,
}
[
{
direction:
{
Description: Direction of sort. ,
Enum:
{
Ascending: No description available. ,
Descending: No description available. ,
}
,
Required: False ,
}
enum ,
name:
{
Description: The name of the column to sort. ,
Required: True ,
}
string ,
}
,
]
,
filter:
{
Description: Has filter expression to use in the report. ,
Required: False ,
}
{
and:
{
Description: The logical "AND" expression. Must have at least 2 items. ,
Required: False ,
}
[
string ,
]
,
or:
{
Description: The logical "OR" expression. Must have at least 2 items. ,
Required: False ,
}
[
string ,
]
,
not:
{
Required: False ,
}
string ,
dimension:
{
Description: Has comparison expression for a dimension ,
Required: False ,
}
{
name:
{
Description: The name of the column to use in comparison. ,
Required: True ,
}
string ,
operator:
{
Description: The operator to use for comparison. ,
Enum:
{
In: No description available. ,
Contains: No description available. ,
}
,
Required: True ,
}
enum ,
values:
{
Description: Array of values to use for comparison ,
Required: True ,
}
[
string ,
]
,
}
,
tag:
{
Description: Has comparison expression for a tag ,
Required: False ,
}
{
name:
{
Description: The name of the column to use in comparison. ,
Required: True ,
}
string ,
operator:
{
Description: The operator to use for comparison. ,
Enum:
{
In: No description available. ,
Contains: No description available. ,
}
,
Required: True ,
}
enum ,
values:
{
Description: Array of values to use for comparison ,
Required: True ,
}
[
string ,
]
,
}
,
}
,
}
,
}
,
chart:
{
Description: Chart type of the main view in Cost Analysis. Required. ,
Enum:
{
Area: No description available. ,
Line: No description available. ,
StackedColumn: No description available. ,
GroupedColumn: No description available. ,
Table: No description available. ,
}
,
Required: False ,
}
enum ,
accumulated:
{
Description: Show costs accumulated over time. ,
Enum:
{
true: No description available. ,
false: No description available. ,
}
,
Required: False ,
}
enum ,
metric:
{
Description: Metric to use when displaying costs. ,
Enum:
{
ActualCost: No description available. ,
AmortizedCost: No description available. ,
AHUB: No description available. ,
}
,
Required: False ,
}
enum ,
kpis:
{
Description: List of KPIs to show in Cost Analysis UI. ,
Required: False ,
}
[
{
type:
{
Description: KPI type (Forecast, Budget). ,
Enum:
{
Forecast: No description available. ,
Budget: No description available. ,
}
,
Required: False ,
}
enum ,
id:
{
Description: ID of resource related to metric (budget). ,
Required: False ,
}
string ,
enabled:
{
Description: show the KPI in the UI? ,
Required: False ,
}
boolean ,
}
,
]
,
pivots:
{
Description: Configuration of 3 sub-views in the Cost Analysis UI. ,
Required: False ,
}
[
{
type:
{
Description: Data type to show in view. ,
Enum:
{
Dimension: No description available. ,
TagKey: No description available. ,
}
,
Required: False ,
}
enum ,
name:
{
Description: Data field to show in view. ,
Required: False ,
}
string ,
}
,
]
,
}
,
}

⚐ Response (default)

{
error:
{
Description: The details of the error. ,
Required: False ,
}
{
code:
{
Description: A machine readable error code. ,
Required: False ,
}
string ,
message:
{
Description: A human readable error message. ,
Required: False ,
}
string ,
target:
{
Description: Indicates which property in the request is responsible for the error. ,
Required: False ,
}
string ,
details:
{
Description: error details. ,
Required: False ,
}
[
{
code:
{
Description: A machine readable error code. ,
Required: False ,
}
string ,
message:
{
Description: A human readable error message. ,
Required: False ,
}
string ,
target:
{
Description: Indicates which property in the request is responsible for the error. ,
Required: False ,
}
string ,
}
,
]
,
}
,
}
Views_CreateOrUpdate (new)
Description :  The operation to create or update a view. Update operation requires latest eTag to be set in the request. You may obtain the latest eTag by performing a get operation. Create operation does not require eTag.
Reference :  Link ¶

⚼ Request

PUT:  /providers/Microsoft.CostManagement/views/{viewName}
{
api-version:
{
Description: Version of the API to be used with the client request. The current version is 2019-04-01-preview ,
Required: True ,
}
string ,
viewName:
{
Description: View name ,
Required: True ,
}
string ,
parameters:
{
Description: Parameters supplied to the CreateOrUpdate View operation. ,
Required: True ,
}
{
properties:
{
Description: The properties of the view. ,
Required: False ,
}
{
displayName:
{
Description: User input name of the view. Required. ,
Required: False ,
}
string ,
scope:
{
Description: Cost Management scope to save the view on. This includes 'subscriptions/{subscriptionId}' for subscription scope, 'subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}' for resourceGroup scope, 'providers/Microsoft.Billing/billingAccounts/{billingAccountId}' for Billing Account scope, 'providers/Microsoft.Billing/billingAccounts/{billingAccountId}/departments/{departmentId}' for Department scope, 'providers/Microsoft.Billing/billingAccounts/{billingAccountId}/enrollmentAccounts/{enrollmentAccountId}' for EnrollmentAccount scope, 'providers/Microsoft.Billing/billingAccounts/{billingAccountId}/billingProfiles/{billingProfileId}' for BillingProfile scope, 'providers/Microsoft.Billing/billingAccounts/{billingAccountId}/invoiceSections/{invoiceSectionId}' for InvoiceSection scope, 'providers/Microsoft.Management/managementGroups/{managementGroupId}' for Management Group scope, '/providers/Microsoft.CostManagement/externalBillingAccounts/{externalBillingAccountName}' for ExternalBillingAccount scope, and '/providers/Microsoft.CostManagement/externalSubscriptions/{externalSubscriptionName}' for ExternalSubscription scope. ,
Required: False ,
}
string ,
createdOn:
{
Description: Date the user created this view. ,
Format: date-time ,
Required: False ,
}
string ,
modifiedOn:
{
Description: Date when the user last modified this view. ,
Format: date-time ,
Required: False ,
}
string ,
query:
{
Description: Query body configuration. Required. ,
Required: False ,
}
{
type:
{
Description: The type of the report. Usage represents actual usage, forecast represents forecasted data and UsageAndForecast represents both usage and forecasted data. Actual usage and forecasted data can be differentiated based on dates. ,
Enum:
{
Usage: No description available. ,
}
,
Required: True ,
}
enum ,
timeframe:
{
Description: The time frame for pulling data for the report. If custom, then a specific time period must be provided. ,
Enum:
{
WeekToDate: No description available. ,
MonthToDate: No description available. ,
YearToDate: No description available. ,
Custom: No description available. ,
}
,
Required: True ,
}
enum ,
timePeriod:
{
Description: Has time period for pulling data for the report. ,
Required: False ,
}
{
from:
{
Description: The start date to pull data from. ,
Format: date-time ,
Required: True ,
}
string ,
to:
{
Description: The end date to pull data to. ,
Format: date-time ,
Required: True ,
}
string ,
}
,
dataset:
{
Description: Has definition for data in this report config. ,
Required: False ,
}
{
granularity:
{
Description: The granularity of rows in the report. ,
Enum:
{
Daily: No description available. ,
Monthly: No description available. ,
}
,
Required: False ,
}
enum ,
configuration:
{
Description: Has configuration information for the data in the report. The configuration will be ignored if aggregation and grouping are provided. ,
Required: False ,
}
{
columns:
{
Description: Array of column names to be included in the report. Any valid report column name is allowed. If not provided, then report includes all columns. ,
Required: False ,
}
[
string ,
]
,
}
,
aggregation:
{
Description: Dictionary of aggregation expression to use in the report. The key of each item in the dictionary is the alias for the aggregated column. Report can have up to 2 aggregation clauses. ,
Required: False ,
}
object ,
grouping:
{
Description: Array of group by expression to use in the report. Report can have up to 2 group by clauses. ,
Required: False ,
}
[
{
type:
{
Description: Has type of the column to group. ,
Enum:
{
Tag: No description available. ,
Dimension: No description available. ,
}
,
Required: True ,
}
enum ,
name:
{
Description: The name of the column to group. This version supports subscription lowest possible grain. ,
Required: True ,
}
string ,
}
,
]
,
sorting:
{
Description: Array of order by expression to use in the report. ,
Required: False ,
}
[
{
direction:
{
Description: Direction of sort. ,
Enum:
{
Ascending: No description available. ,
Descending: No description available. ,
}
,
Required: False ,
}
enum ,
name:
{
Description: The name of the column to sort. ,
Required: True ,
}
string ,
}
,
]
,
filter:
{
Description: Has filter expression to use in the report. ,
Required: False ,
}
{
and:
{
Description: The logical "AND" expression. Must have at least 2 items. ,
Required: False ,
}
[
string ,
]
,
or:
{
Description: The logical "OR" expression. Must have at least 2 items. ,
Required: False ,
}
[
string ,
]
,
not:
{
Required: False ,
}
string ,
dimension:
{
Description: Has comparison expression for a dimension ,
Required: False ,
}
{
name:
{
Description: The name of the column to use in comparison. ,
Required: True ,
}
string ,
operator:
{
Description: The operator to use for comparison. ,
Enum:
{
In: No description available. ,
Contains: No description available. ,
}
,
Required: True ,
}
enum ,
values:
{
Description: Array of values to use for comparison ,
Required: True ,
}
[
string ,
]
,
}
,
tag:
{
Description: Has comparison expression for a tag ,
Required: False ,
}
{
name:
{
Description: The name of the column to use in comparison. ,
Required: True ,
}
string ,
operator:
{
Description: The operator to use for comparison. ,
Enum:
{
In: No description available. ,
Contains: No description available. ,
}
,
Required: True ,
}
enum ,
values:
{
Description: Array of values to use for comparison ,
Required: True ,
}
[
string ,
]
,
}
,
}
,
}
,
}
,
chart:
{
Description: Chart type of the main view in Cost Analysis. Required. ,
Enum:
{
Area: No description available. ,
Line: No description available. ,
StackedColumn: No description available. ,
GroupedColumn: No description available. ,
Table: No description available. ,
}
,
Required: False ,
}
enum ,
accumulated:
{
Description: Show costs accumulated over time. ,
Enum:
{
true: No description available. ,
false: No description available. ,
}
,
Required: False ,
}
enum ,
metric:
{
Description: Metric to use when displaying costs. ,
Enum:
{
ActualCost: No description available. ,
AmortizedCost: No description available. ,
AHUB: No description available. ,
}
,
Required: False ,
}
enum ,
kpis:
{
Description: List of KPIs to show in Cost Analysis UI. ,
Required: False ,
}
[
{
type:
{
Description: KPI type (Forecast, Budget). ,
Enum:
{
Forecast: No description available. ,
Budget: No description available. ,
}
,
Required: False ,
}
enum ,
id:
{
Description: ID of resource related to metric (budget). ,
Required: False ,
}
string ,
enabled:
{
Description: show the KPI in the UI? ,
Required: False ,
}
boolean ,
}
,
]
,
pivots:
{
Description: Configuration of 3 sub-views in the Cost Analysis UI. ,
Required: False ,
}
[
{
type:
{
Description: Data type to show in view. ,
Enum:
{
Dimension: No description available. ,
TagKey: No description available. ,
}
,
Required: False ,
}
enum ,
name:
{
Description: Data field to show in view. ,
Required: False ,
}
string ,
}
,
]
,
}
,
}
,
}

⚐ Response (200)

{
properties:
{
Description: The properties of the view. ,
Required: False ,
}
{
displayName:
{
Description: User input name of the view. Required. ,
Required: False ,
}
string ,
scope:
{
Description: Cost Management scope to save the view on. This includes 'subscriptions/{subscriptionId}' for subscription scope, 'subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}' for resourceGroup scope, 'providers/Microsoft.Billing/billingAccounts/{billingAccountId}' for Billing Account scope, 'providers/Microsoft.Billing/billingAccounts/{billingAccountId}/departments/{departmentId}' for Department scope, 'providers/Microsoft.Billing/billingAccounts/{billingAccountId}/enrollmentAccounts/{enrollmentAccountId}' for EnrollmentAccount scope, 'providers/Microsoft.Billing/billingAccounts/{billingAccountId}/billingProfiles/{billingProfileId}' for BillingProfile scope, 'providers/Microsoft.Billing/billingAccounts/{billingAccountId}/invoiceSections/{invoiceSectionId}' for InvoiceSection scope, 'providers/Microsoft.Management/managementGroups/{managementGroupId}' for Management Group scope, '/providers/Microsoft.CostManagement/externalBillingAccounts/{externalBillingAccountName}' for ExternalBillingAccount scope, and '/providers/Microsoft.CostManagement/externalSubscriptions/{externalSubscriptionName}' for ExternalSubscription scope. ,
Required: False ,
}
string ,
createdOn:
{
Description: Date the user created this view. ,
Format: date-time ,
Required: False ,
}
string ,
modifiedOn:
{
Description: Date when the user last modified this view. ,
Format: date-time ,
Required: False ,
}
string ,
query:
{
Description: Query body configuration. Required. ,
Required: False ,
}
{
type:
{
Description: The type of the report. Usage represents actual usage, forecast represents forecasted data and UsageAndForecast represents both usage and forecasted data. Actual usage and forecasted data can be differentiated based on dates. ,
Enum:
{
Usage: No description available. ,
}
,
Required: True ,
}
enum ,
timeframe:
{
Description: The time frame for pulling data for the report. If custom, then a specific time period must be provided. ,
Enum:
{
WeekToDate: No description available. ,
MonthToDate: No description available. ,
YearToDate: No description available. ,
Custom: No description available. ,
}
,
Required: True ,
}
enum ,
timePeriod:
{
Description: Has time period for pulling data for the report. ,
Required: False ,
}
{
from:
{
Description: The start date to pull data from. ,
Format: date-time ,
Required: True ,
}
string ,
to:
{
Description: The end date to pull data to. ,
Format: date-time ,
Required: True ,
}
string ,
}
,
dataset:
{
Description: Has definition for data in this report config. ,
Required: False ,
}
{
granularity:
{
Description: The granularity of rows in the report. ,
Enum:
{
Daily: No description available. ,
Monthly: No description available. ,
}
,
Required: False ,
}
enum ,
configuration:
{
Description: Has configuration information for the data in the report. The configuration will be ignored if aggregation and grouping are provided. ,
Required: False ,
}
{
columns:
{
Description: Array of column names to be included in the report. Any valid report column name is allowed. If not provided, then report includes all columns. ,
Required: False ,
}
[
string ,
]
,
}
,
aggregation:
{
Description: Dictionary of aggregation expression to use in the report. The key of each item in the dictionary is the alias for the aggregated column. Report can have up to 2 aggregation clauses. ,
Required: False ,
}
object ,
grouping:
{
Description: Array of group by expression to use in the report. Report can have up to 2 group by clauses. ,
Required: False ,
}
[
{
type:
{
Description: Has type of the column to group. ,
Enum:
{
Tag: No description available. ,
Dimension: No description available. ,
}
,
Required: True ,
}
enum ,
name:
{
Description: The name of the column to group. This version supports subscription lowest possible grain. ,
Required: True ,
}
string ,
}
,
]
,
sorting:
{
Description: Array of order by expression to use in the report. ,
Required: False ,
}
[
{
direction:
{
Description: Direction of sort. ,
Enum:
{
Ascending: No description available. ,
Descending: No description available. ,
}
,
Required: False ,
}
enum ,
name:
{
Description: The name of the column to sort. ,
Required: True ,
}
string ,
}
,
]
,
filter:
{
Description: Has filter expression to use in the report. ,
Required: False ,
}
{
and:
{
Description: The logical "AND" expression. Must have at least 2 items. ,
Required: False ,
}
[
string ,
]
,
or:
{
Description: The logical "OR" expression. Must have at least 2 items. ,
Required: False ,
}
[
string ,
]
,
not:
{
Required: False ,
}
string ,
dimension:
{
Description: Has comparison expression for a dimension ,
Required: False ,
}
{
name:
{
Description: The name of the column to use in comparison. ,
Required: True ,
}
string ,
operator:
{
Description: The operator to use for comparison. ,
Enum:
{
In: No description available. ,
Contains: No description available. ,
}
,
Required: True ,
}
enum ,
values:
{
Description: Array of values to use for comparison ,
Required: True ,
}
[
string ,
]
,
}
,
tag:
{
Description: Has comparison expression for a tag ,
Required: False ,
}
{
name:
{
Description: The name of the column to use in comparison. ,
Required: True ,
}
string ,
operator:
{
Description: The operator to use for comparison. ,
Enum:
{
In: No description available. ,
Contains: No description available. ,
}
,
Required: True ,
}
enum ,
values:
{
Description: Array of values to use for comparison ,
Required: True ,
}
[
string ,
]
,
}
,
}
,
}
,
}
,
chart:
{
Description: Chart type of the main view in Cost Analysis. Required. ,
Enum:
{
Area: No description available. ,
Line: No description available. ,
StackedColumn: No description available. ,
GroupedColumn: No description available. ,
Table: No description available. ,
}
,
Required: False ,
}
enum ,
accumulated:
{
Description: Show costs accumulated over time. ,
Enum:
{
true: No description available. ,
false: No description available. ,
}
,
Required: False ,
}
enum ,
metric:
{
Description: Metric to use when displaying costs. ,
Enum:
{
ActualCost: No description available. ,
AmortizedCost: No description available. ,
AHUB: No description available. ,
}
,
Required: False ,
}
enum ,
kpis:
{
Description: List of KPIs to show in Cost Analysis UI. ,
Required: False ,
}
[
{
type:
{
Description: KPI type (Forecast, Budget). ,
Enum:
{
Forecast: No description available. ,
Budget: No description available. ,
}
,
Required: False ,
}
enum ,
id:
{
Description: ID of resource related to metric (budget). ,
Required: False ,
}
string ,
enabled:
{
Description: show the KPI in the UI? ,
Required: False ,
}
boolean ,
}
,
]
,
pivots:
{
Description: Configuration of 3 sub-views in the Cost Analysis UI. ,
Required: False ,
}
[
{
type:
{
Description: Data type to show in view. ,
Enum:
{
Dimension: No description available. ,
TagKey: No description available. ,
}
,
Required: False ,
}
enum ,
name:
{
Description: Data field to show in view. ,
Required: False ,
}
string ,
}
,
]
,
}
,
}

⚐ Response (201)

{
properties:
{
Description: The properties of the view. ,
Required: False ,
}
{
displayName:
{
Description: User input name of the view. Required. ,
Required: False ,
}
string ,
scope:
{
Description: Cost Management scope to save the view on. This includes 'subscriptions/{subscriptionId}' for subscription scope, 'subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}' for resourceGroup scope, 'providers/Microsoft.Billing/billingAccounts/{billingAccountId}' for Billing Account scope, 'providers/Microsoft.Billing/billingAccounts/{billingAccountId}/departments/{departmentId}' for Department scope, 'providers/Microsoft.Billing/billingAccounts/{billingAccountId}/enrollmentAccounts/{enrollmentAccountId}' for EnrollmentAccount scope, 'providers/Microsoft.Billing/billingAccounts/{billingAccountId}/billingProfiles/{billingProfileId}' for BillingProfile scope, 'providers/Microsoft.Billing/billingAccounts/{billingAccountId}/invoiceSections/{invoiceSectionId}' for InvoiceSection scope, 'providers/Microsoft.Management/managementGroups/{managementGroupId}' for Management Group scope, '/providers/Microsoft.CostManagement/externalBillingAccounts/{externalBillingAccountName}' for ExternalBillingAccount scope, and '/providers/Microsoft.CostManagement/externalSubscriptions/{externalSubscriptionName}' for ExternalSubscription scope. ,
Required: False ,
}
string ,
createdOn:
{
Description: Date the user created this view. ,
Format: date-time ,
Required: False ,
}
string ,
modifiedOn:
{
Description: Date when the user last modified this view. ,
Format: date-time ,
Required: False ,
}
string ,
query:
{
Description: Query body configuration. Required. ,
Required: False ,
}
{
type:
{
Description: The type of the report. Usage represents actual usage, forecast represents forecasted data and UsageAndForecast represents both usage and forecasted data. Actual usage and forecasted data can be differentiated based on dates. ,
Enum:
{
Usage: No description available. ,
}
,
Required: True ,
}
enum ,
timeframe:
{
Description: The time frame for pulling data for the report. If custom, then a specific time period must be provided. ,
Enum:
{
WeekToDate: No description available. ,
MonthToDate: No description available. ,
YearToDate: No description available. ,
Custom: No description available. ,
}
,
Required: True ,
}
enum ,
timePeriod:
{
Description: Has time period for pulling data for the report. ,
Required: False ,
}
{
from:
{
Description: The start date to pull data from. ,
Format: date-time ,
Required: True ,
}
string ,
to:
{
Description: The end date to pull data to. ,
Format: date-time ,
Required: True ,
}
string ,
}
,
dataset:
{
Description: Has definition for data in this report config. ,
Required: False ,
}
{
granularity:
{
Description: The granularity of rows in the report. ,
Enum:
{
Daily: No description available. ,
Monthly: No description available. ,
}
,
Required: False ,
}
enum ,
configuration:
{
Description: Has configuration information for the data in the report. The configuration will be ignored if aggregation and grouping are provided. ,
Required: False ,
}
{
columns:
{
Description: Array of column names to be included in the report. Any valid report column name is allowed. If not provided, then report includes all columns. ,
Required: False ,
}
[
string ,
]
,
}
,
aggregation:
{
Description: Dictionary of aggregation expression to use in the report. The key of each item in the dictionary is the alias for the aggregated column. Report can have up to 2 aggregation clauses. ,
Required: False ,
}
object ,
grouping:
{
Description: Array of group by expression to use in the report. Report can have up to 2 group by clauses. ,
Required: False ,
}
[
{
type:
{
Description: Has type of the column to group. ,
Enum:
{
Tag: No description available. ,
Dimension: No description available. ,
}
,
Required: True ,
}
enum ,
name:
{
Description: The name of the column to group. This version supports subscription lowest possible grain. ,
Required: True ,
}
string ,
}
,
]
,
sorting:
{
Description: Array of order by expression to use in the report. ,
Required: False ,
}
[
{
direction:
{
Description: Direction of sort. ,
Enum:
{
Ascending: No description available. ,
Descending: No description available. ,
}
,
Required: False ,
}
enum ,
name:
{
Description: The name of the column to sort. ,
Required: True ,
}
string ,
}
,
]
,
filter:
{
Description: Has filter expression to use in the report. ,
Required: False ,
}
{
and:
{
Description: The logical "AND" expression. Must have at least 2 items. ,
Required: False ,
}
[
string ,
]
,
or:
{
Description: The logical "OR" expression. Must have at least 2 items. ,
Required: False ,
}
[
string ,
]
,
not:
{
Required: False ,
}
string ,
dimension:
{
Description: Has comparison expression for a dimension ,
Required: False ,
}
{
name:
{
Description: The name of the column to use in comparison. ,
Required: True ,
}
string ,
operator:
{
Description: The operator to use for comparison. ,
Enum:
{
In: No description available. ,
Contains: No description available. ,
}
,
Required: True ,
}
enum ,
values:
{
Description: Array of values to use for comparison ,
Required: True ,
}
[
string ,
]
,
}
,
tag:
{
Description: Has comparison expression for a tag ,
Required: False ,
}
{
name:
{
Description: The name of the column to use in comparison. ,
Required: True ,
}
string ,
operator:
{
Description: The operator to use for comparison. ,
Enum:
{
In: No description available. ,
Contains: No description available. ,
}
,
Required: True ,
}
enum ,
values:
{
Description: Array of values to use for comparison ,
Required: True ,
}
[
string ,
]
,
}
,
}
,
}
,
}
,
chart:
{
Description: Chart type of the main view in Cost Analysis. Required. ,
Enum:
{
Area: No description available. ,
Line: No description available. ,
StackedColumn: No description available. ,
GroupedColumn: No description available. ,
Table: No description available. ,
}
,
Required: False ,
}
enum ,
accumulated:
{
Description: Show costs accumulated over time. ,
Enum:
{
true: No description available. ,
false: No description available. ,
}
,
Required: False ,
}
enum ,
metric:
{
Description: Metric to use when displaying costs. ,
Enum:
{
ActualCost: No description available. ,
AmortizedCost: No description available. ,
AHUB: No description available. ,
}
,
Required: False ,
}
enum ,
kpis:
{
Description: List of KPIs to show in Cost Analysis UI. ,
Required: False ,
}
[
{
type:
{
Description: KPI type (Forecast, Budget). ,
Enum:
{
Forecast: No description available. ,
Budget: No description available. ,
}
,
Required: False ,
}
enum ,
id:
{
Description: ID of resource related to metric (budget). ,
Required: False ,
}
string ,
enabled:
{
Description: show the KPI in the UI? ,
Required: False ,
}
boolean ,
}
,
]
,
pivots:
{
Description: Configuration of 3 sub-views in the Cost Analysis UI. ,
Required: False ,
}
[
{
type:
{
Description: Data type to show in view. ,
Enum:
{
Dimension: No description available. ,
TagKey: No description available. ,
}
,
Required: False ,
}
enum ,
name:
{
Description: Data field to show in view. ,
Required: False ,
}
string ,
}
,
]
,
}
,
}

⚐ Response (default)

{
error:
{
Description: The details of the error. ,
Required: False ,
}
{
code:
{
Description: A machine readable error code. ,
Required: False ,
}
string ,
message:
{
Description: A human readable error message. ,
Required: False ,
}
string ,
target:
{
Description: Indicates which property in the request is responsible for the error. ,
Required: False ,
}
string ,
details:
{
Description: error details. ,
Required: False ,
}
[
{
code:
{
Description: A machine readable error code. ,
Required: False ,
}
string ,
message:
{
Description: A human readable error message. ,
Required: False ,
}
string ,
target:
{
Description: Indicates which property in the request is responsible for the error. ,
Required: False ,
}
string ,
}
,
]
,
}
,
}
Views_Delete (new)
Description :  The operation to delete a view.
Reference :  Link ¶

⚼ Request

DELETE:  /providers/Microsoft.CostManagement/views/{viewName}
{
api-version:
{
Description: Version of the API to be used with the client request. The current version is 2019-04-01-preview ,
Required: True ,
}
string ,
viewName:
{
Description: View name ,
Required: True ,
}
string ,
}

⚐ Response (200)

{}

⚐ Response (204)

{}

⚐ Response (default)

{
error:
{
Description: The details of the error. ,
Required: False ,
}
{
code:
{
Description: A machine readable error code. ,
Required: False ,
}
string ,
message:
{
Description: A human readable error message. ,
Required: False ,
}
string ,
target:
{
Description: Indicates which property in the request is responsible for the error. ,
Required: False ,
}
string ,
details:
{
Description: error details. ,
Required: False ,
}
[
{
code:
{
Description: A machine readable error code. ,
Required: False ,
}
string ,
message:
{
Description: A human readable error message. ,
Required: False ,
}
string ,
target:
{
Description: Indicates which property in the request is responsible for the error. ,
Required: False ,
}
string ,
}
,
]
,
}
,
}
Views_GetByScope (new)
Description :  Gets the view for the defined scope by view name.
Reference :  Link ¶

⚼ Request

GET:  /{scope}/providers/Microsoft.CostManagement/views/{viewName}
{
scope:
{
Description: The scope associated with view operations. This includes 'subscriptions/{subscriptionId}' for subscription scope, 'subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}' for resourceGroup scope, 'providers/Microsoft.Billing/billingAccounts/{billingAccountId}' for Billing Account scope, 'providers/Microsoft.Billing/billingAccounts/{billingAccountId}/departments/{departmentId}' for Department scope, 'providers/Microsoft.Billing/billingAccounts/{billingAccountId}/enrollmentAccounts/{enrollmentAccountId}' for EnrollmentAccount scope, 'providers/Microsoft.Billing/billingAccounts/{billingAccountId}/billingProfiles/{billingProfileId}' for BillingProfile scope, 'providers/Microsoft.Billing/billingAccounts/{billingAccountId}/invoiceSections/{invoiceSectionId}' for InvoiceSection scope, 'providers/Microsoft.Management/managementGroups/{managementGroupId}' for Management Group scope, 'providers/Microsoft.CostManagement/externalBillingAccounts/{externalBillingAccountName}' for External Billing Account scope and 'providers/Microsoft.CostManagement/externalSubscriptions/{externalSubscriptionName}' for External Subscription scope. ,
Required: True ,
}
string ,
api-version:
{
Description: Version of the API to be used with the client request. The current version is 2019-04-01-preview ,
Required: True ,
}
string ,
viewName:
{
Description: View name ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
properties:
{
Description: The properties of the view. ,
Required: False ,
}
{
displayName:
{
Description: User input name of the view. Required. ,
Required: False ,
}
string ,
scope:
{
Description: Cost Management scope to save the view on. This includes 'subscriptions/{subscriptionId}' for subscription scope, 'subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}' for resourceGroup scope, 'providers/Microsoft.Billing/billingAccounts/{billingAccountId}' for Billing Account scope, 'providers/Microsoft.Billing/billingAccounts/{billingAccountId}/departments/{departmentId}' for Department scope, 'providers/Microsoft.Billing/billingAccounts/{billingAccountId}/enrollmentAccounts/{enrollmentAccountId}' for EnrollmentAccount scope, 'providers/Microsoft.Billing/billingAccounts/{billingAccountId}/billingProfiles/{billingProfileId}' for BillingProfile scope, 'providers/Microsoft.Billing/billingAccounts/{billingAccountId}/invoiceSections/{invoiceSectionId}' for InvoiceSection scope, 'providers/Microsoft.Management/managementGroups/{managementGroupId}' for Management Group scope, '/providers/Microsoft.CostManagement/externalBillingAccounts/{externalBillingAccountName}' for ExternalBillingAccount scope, and '/providers/Microsoft.CostManagement/externalSubscriptions/{externalSubscriptionName}' for ExternalSubscription scope. ,
Required: False ,
}
string ,
createdOn:
{
Description: Date the user created this view. ,
Format: date-time ,
Required: False ,
}
string ,
modifiedOn:
{
Description: Date when the user last modified this view. ,
Format: date-time ,
Required: False ,
}
string ,
query:
{
Description: Query body configuration. Required. ,
Required: False ,
}
{
type:
{
Description: The type of the report. Usage represents actual usage, forecast represents forecasted data and UsageAndForecast represents both usage and forecasted data. Actual usage and forecasted data can be differentiated based on dates. ,
Enum:
{
Usage: No description available. ,
}
,
Required: True ,
}
enum ,
timeframe:
{
Description: The time frame for pulling data for the report. If custom, then a specific time period must be provided. ,
Enum:
{
WeekToDate: No description available. ,
MonthToDate: No description available. ,
YearToDate: No description available. ,
Custom: No description available. ,
}
,
Required: True ,
}
enum ,
timePeriod:
{
Description: Has time period for pulling data for the report. ,
Required: False ,
}
{
from:
{
Description: The start date to pull data from. ,
Format: date-time ,
Required: True ,
}
string ,
to:
{
Description: The end date to pull data to. ,
Format: date-time ,
Required: True ,
}
string ,
}
,
dataset:
{
Description: Has definition for data in this report config. ,
Required: False ,
}
{
granularity:
{
Description: The granularity of rows in the report. ,
Enum:
{
Daily: No description available. ,
Monthly: No description available. ,
}
,
Required: False ,
}
enum ,
configuration:
{
Description: Has configuration information for the data in the report. The configuration will be ignored if aggregation and grouping are provided. ,
Required: False ,
}
{
columns:
{
Description: Array of column names to be included in the report. Any valid report column name is allowed. If not provided, then report includes all columns. ,
Required: False ,
}
[
string ,
]
,
}
,
aggregation:
{
Description: Dictionary of aggregation expression to use in the report. The key of each item in the dictionary is the alias for the aggregated column. Report can have up to 2 aggregation clauses. ,
Required: False ,
}
object ,
grouping:
{
Description: Array of group by expression to use in the report. Report can have up to 2 group by clauses. ,
Required: False ,
}
[
{
type:
{
Description: Has type of the column to group. ,
Enum:
{
Tag: No description available. ,
Dimension: No description available. ,
}
,
Required: True ,
}
enum ,
name:
{
Description: The name of the column to group. This version supports subscription lowest possible grain. ,
Required: True ,
}
string ,
}
,
]
,
sorting:
{
Description: Array of order by expression to use in the report. ,
Required: False ,
}
[
{
direction:
{
Description: Direction of sort. ,
Enum:
{
Ascending: No description available. ,
Descending: No description available. ,
}
,
Required: False ,
}
enum ,
name:
{
Description: The name of the column to sort. ,
Required: True ,
}
string ,
}
,
]
,
filter:
{
Description: Has filter expression to use in the report. ,
Required: False ,
}
{
and:
{
Description: The logical "AND" expression. Must have at least 2 items. ,
Required: False ,
}
[
string ,
]
,
or:
{
Description: The logical "OR" expression. Must have at least 2 items. ,
Required: False ,
}
[
string ,
]
,
not:
{
Required: False ,
}
string ,
dimension:
{
Description: Has comparison expression for a dimension ,
Required: False ,
}
{
name:
{
Description: The name of the column to use in comparison. ,
Required: True ,
}
string ,
operator:
{
Description: The operator to use for comparison. ,
Enum:
{
In: No description available. ,
Contains: No description available. ,
}
,
Required: True ,
}
enum ,
values:
{
Description: Array of values to use for comparison ,
Required: True ,
}
[
string ,
]
,
}
,
tag:
{
Description: Has comparison expression for a tag ,
Required: False ,
}
{
name:
{
Description: The name of the column to use in comparison. ,
Required: True ,
}
string ,
operator:
{
Description: The operator to use for comparison. ,
Enum:
{
In: No description available. ,
Contains: No description available. ,
}
,
Required: True ,
}
enum ,
values:
{
Description: Array of values to use for comparison ,
Required: True ,
}
[
string ,
]
,
}
,
}
,
}
,
}
,
chart:
{
Description: Chart type of the main view in Cost Analysis. Required. ,
Enum:
{
Area: No description available. ,
Line: No description available. ,
StackedColumn: No description available. ,
GroupedColumn: No description available. ,
Table: No description available. ,
}
,
Required: False ,
}
enum ,
accumulated:
{
Description: Show costs accumulated over time. ,
Enum:
{
true: No description available. ,
false: No description available. ,
}
,
Required: False ,
}
enum ,
metric:
{
Description: Metric to use when displaying costs. ,
Enum:
{
ActualCost: No description available. ,
AmortizedCost: No description available. ,
AHUB: No description available. ,
}
,
Required: False ,
}
enum ,
kpis:
{
Description: List of KPIs to show in Cost Analysis UI. ,
Required: False ,
}
[
{
type:
{
Description: KPI type (Forecast, Budget). ,
Enum:
{
Forecast: No description available. ,
Budget: No description available. ,
}
,
Required: False ,
}
enum ,
id:
{
Description: ID of resource related to metric (budget). ,
Required: False ,
}
string ,
enabled:
{
Description: show the KPI in the UI? ,
Required: False ,
}
boolean ,
}
,
]
,
pivots:
{
Description: Configuration of 3 sub-views in the Cost Analysis UI. ,
Required: False ,
}
[
{
type:
{
Description: Data type to show in view. ,
Enum:
{
Dimension: No description available. ,
TagKey: No description available. ,
}
,
Required: False ,
}
enum ,
name:
{
Description: Data field to show in view. ,
Required: False ,
}
string ,
}
,
]
,
}
,
}

⚐ Response (default)

{
error:
{
Description: The details of the error. ,
Required: False ,
}
{
code:
{
Description: A machine readable error code. ,
Required: False ,
}
string ,
message:
{
Description: A human readable error message. ,
Required: False ,
}
string ,
target:
{
Description: Indicates which property in the request is responsible for the error. ,
Required: False ,
}
string ,
details:
{
Description: error details. ,
Required: False ,
}
[
{
code:
{
Description: A machine readable error code. ,
Required: False ,
}
string ,
message:
{
Description: A human readable error message. ,
Required: False ,
}
string ,
target:
{
Description: Indicates which property in the request is responsible for the error. ,
Required: False ,
}
string ,
}
,
]
,
}
,
}
Views_CreateOrUpdateByScope (new)
Description :  The operation to create or update a view. Update operation requires latest eTag to be set in the request. You may obtain the latest eTag by performing a get operation. Create operation does not require eTag.
Reference :  Link ¶

⚼ Request

PUT:  /{scope}/providers/Microsoft.CostManagement/views/{viewName}
{
scope:
{
Description: The scope associated with view operations. This includes 'subscriptions/{subscriptionId}' for subscription scope, 'subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}' for resourceGroup scope, 'providers/Microsoft.Billing/billingAccounts/{billingAccountId}' for Billing Account scope, 'providers/Microsoft.Billing/billingAccounts/{billingAccountId}/departments/{departmentId}' for Department scope, 'providers/Microsoft.Billing/billingAccounts/{billingAccountId}/enrollmentAccounts/{enrollmentAccountId}' for EnrollmentAccount scope, 'providers/Microsoft.Billing/billingAccounts/{billingAccountId}/billingProfiles/{billingProfileId}' for BillingProfile scope, 'providers/Microsoft.Billing/billingAccounts/{billingAccountId}/invoiceSections/{invoiceSectionId}' for InvoiceSection scope, 'providers/Microsoft.Management/managementGroups/{managementGroupId}' for Management Group scope, 'providers/Microsoft.CostManagement/externalBillingAccounts/{externalBillingAccountName}' for External Billing Account scope and 'providers/Microsoft.CostManagement/externalSubscriptions/{externalSubscriptionName}' for External Subscription scope. ,
Required: True ,
}
string ,
api-version:
{
Description: Version of the API to be used with the client request. The current version is 2019-04-01-preview ,
Required: True ,
}
string ,
viewName:
{
Description: View name ,
Required: True ,
}
string ,
parameters:
{
Description: Parameters supplied to the CreateOrUpdate View operation. ,
Required: True ,
}
{
properties:
{
Description: The properties of the view. ,
Required: False ,
}
{
displayName:
{
Description: User input name of the view. Required. ,
Required: False ,
}
string ,
scope:
{
Description: Cost Management scope to save the view on. This includes 'subscriptions/{subscriptionId}' for subscription scope, 'subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}' for resourceGroup scope, 'providers/Microsoft.Billing/billingAccounts/{billingAccountId}' for Billing Account scope, 'providers/Microsoft.Billing/billingAccounts/{billingAccountId}/departments/{departmentId}' for Department scope, 'providers/Microsoft.Billing/billingAccounts/{billingAccountId}/enrollmentAccounts/{enrollmentAccountId}' for EnrollmentAccount scope, 'providers/Microsoft.Billing/billingAccounts/{billingAccountId}/billingProfiles/{billingProfileId}' for BillingProfile scope, 'providers/Microsoft.Billing/billingAccounts/{billingAccountId}/invoiceSections/{invoiceSectionId}' for InvoiceSection scope, 'providers/Microsoft.Management/managementGroups/{managementGroupId}' for Management Group scope, '/providers/Microsoft.CostManagement/externalBillingAccounts/{externalBillingAccountName}' for ExternalBillingAccount scope, and '/providers/Microsoft.CostManagement/externalSubscriptions/{externalSubscriptionName}' for ExternalSubscription scope. ,
Required: False ,
}
string ,
createdOn:
{
Description: Date the user created this view. ,
Format: date-time ,
Required: False ,
}
string ,
modifiedOn:
{
Description: Date when the user last modified this view. ,
Format: date-time ,
Required: False ,
}
string ,
query:
{
Description: Query body configuration. Required. ,
Required: False ,
}
{
type:
{
Description: The type of the report. Usage represents actual usage, forecast represents forecasted data and UsageAndForecast represents both usage and forecasted data. Actual usage and forecasted data can be differentiated based on dates. ,
Enum:
{
Usage: No description available. ,
}
,
Required: True ,
}
enum ,
timeframe:
{
Description: The time frame for pulling data for the report. If custom, then a specific time period must be provided. ,
Enum:
{
WeekToDate: No description available. ,
MonthToDate: No description available. ,
YearToDate: No description available. ,
Custom: No description available. ,
}
,
Required: True ,
}
enum ,
timePeriod:
{
Description: Has time period for pulling data for the report. ,
Required: False ,
}
{
from:
{
Description: The start date to pull data from. ,
Format: date-time ,
Required: True ,
}
string ,
to:
{
Description: The end date to pull data to. ,
Format: date-time ,
Required: True ,
}
string ,
}
,
dataset:
{
Description: Has definition for data in this report config. ,
Required: False ,
}
{
granularity:
{
Description: The granularity of rows in the report. ,
Enum:
{
Daily: No description available. ,
Monthly: No description available. ,
}
,
Required: False ,
}
enum ,
configuration:
{
Description: Has configuration information for the data in the report. The configuration will be ignored if aggregation and grouping are provided. ,
Required: False ,
}
{
columns:
{
Description: Array of column names to be included in the report. Any valid report column name is allowed. If not provided, then report includes all columns. ,
Required: False ,
}
[
string ,
]
,
}
,
aggregation:
{
Description: Dictionary of aggregation expression to use in the report. The key of each item in the dictionary is the alias for the aggregated column. Report can have up to 2 aggregation clauses. ,
Required: False ,
}
object ,
grouping:
{
Description: Array of group by expression to use in the report. Report can have up to 2 group by clauses. ,
Required: False ,
}
[
{
type:
{
Description: Has type of the column to group. ,
Enum:
{
Tag: No description available. ,
Dimension: No description available. ,
}
,
Required: True ,
}
enum ,
name:
{
Description: The name of the column to group. This version supports subscription lowest possible grain. ,
Required: True ,
}
string ,
}
,
]
,
sorting:
{
Description: Array of order by expression to use in the report. ,
Required: False ,
}
[
{
direction:
{
Description: Direction of sort. ,
Enum:
{
Ascending: No description available. ,
Descending: No description available. ,
}
,
Required: False ,
}
enum ,
name:
{
Description: The name of the column to sort. ,
Required: True ,
}
string ,
}
,
]
,
filter:
{
Description: Has filter expression to use in the report. ,
Required: False ,
}
{
and:
{
Description: The logical "AND" expression. Must have at least 2 items. ,
Required: False ,
}
[
string ,
]
,
or:
{
Description: The logical "OR" expression. Must have at least 2 items. ,
Required: False ,
}
[
string ,
]
,
not:
{
Required: False ,
}
string ,
dimension:
{
Description: Has comparison expression for a dimension ,
Required: False ,
}
{
name:
{
Description: The name of the column to use in comparison. ,
Required: True ,
}
string ,
operator:
{
Description: The operator to use for comparison. ,
Enum:
{
In: No description available. ,
Contains: No description available. ,
}
,
Required: True ,
}
enum ,
values:
{
Description: Array of values to use for comparison ,
Required: True ,
}
[
string ,
]
,
}
,
tag:
{
Description: Has comparison expression for a tag ,
Required: False ,
}
{
name:
{
Description: The name of the column to use in comparison. ,
Required: True ,
}
string ,
operator:
{
Description: The operator to use for comparison. ,
Enum:
{
In: No description available. ,
Contains: No description available. ,
}
,
Required: True ,
}
enum ,
values:
{
Description: Array of values to use for comparison ,
Required: True ,
}
[
string ,
]
,
}
,
}
,
}
,
}
,
chart:
{
Description: Chart type of the main view in Cost Analysis. Required. ,
Enum:
{
Area: No description available. ,
Line: No description available. ,
StackedColumn: No description available. ,
GroupedColumn: No description available. ,
Table: No description available. ,
}
,
Required: False ,
}
enum ,
accumulated:
{
Description: Show costs accumulated over time. ,
Enum:
{
true: No description available. ,
false: No description available. ,
}
,
Required: False ,
}
enum ,
metric:
{
Description: Metric to use when displaying costs. ,
Enum:
{
ActualCost: No description available. ,
AmortizedCost: No description available. ,
AHUB: No description available. ,
}
,
Required: False ,
}
enum ,
kpis:
{
Description: List of KPIs to show in Cost Analysis UI. ,
Required: False ,
}
[
{
type:
{
Description: KPI type (Forecast, Budget). ,
Enum:
{
Forecast: No description available. ,
Budget: No description available. ,
}
,
Required: False ,
}
enum ,
id:
{
Description: ID of resource related to metric (budget). ,
Required: False ,
}
string ,
enabled:
{
Description: show the KPI in the UI? ,
Required: False ,
}
boolean ,
}
,
]
,
pivots:
{
Description: Configuration of 3 sub-views in the Cost Analysis UI. ,
Required: False ,
}
[
{
type:
{
Description: Data type to show in view. ,
Enum:
{
Dimension: No description available. ,
TagKey: No description available. ,
}
,
Required: False ,
}
enum ,
name:
{
Description: Data field to show in view. ,
Required: False ,
}
string ,
}
,
]
,
}
,
}
,
}

⚐ Response (200)

{
properties:
{
Description: The properties of the view. ,
Required: False ,
}
{
displayName:
{
Description: User input name of the view. Required. ,
Required: False ,
}
string ,
scope:
{
Description: Cost Management scope to save the view on. This includes 'subscriptions/{subscriptionId}' for subscription scope, 'subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}' for resourceGroup scope, 'providers/Microsoft.Billing/billingAccounts/{billingAccountId}' for Billing Account scope, 'providers/Microsoft.Billing/billingAccounts/{billingAccountId}/departments/{departmentId}' for Department scope, 'providers/Microsoft.Billing/billingAccounts/{billingAccountId}/enrollmentAccounts/{enrollmentAccountId}' for EnrollmentAccount scope, 'providers/Microsoft.Billing/billingAccounts/{billingAccountId}/billingProfiles/{billingProfileId}' for BillingProfile scope, 'providers/Microsoft.Billing/billingAccounts/{billingAccountId}/invoiceSections/{invoiceSectionId}' for InvoiceSection scope, 'providers/Microsoft.Management/managementGroups/{managementGroupId}' for Management Group scope, '/providers/Microsoft.CostManagement/externalBillingAccounts/{externalBillingAccountName}' for ExternalBillingAccount scope, and '/providers/Microsoft.CostManagement/externalSubscriptions/{externalSubscriptionName}' for ExternalSubscription scope. ,
Required: False ,
}
string ,
createdOn:
{
Description: Date the user created this view. ,
Format: date-time ,
Required: False ,
}
string ,
modifiedOn:
{
Description: Date when the user last modified this view. ,
Format: date-time ,
Required: False ,
}
string ,
query:
{
Description: Query body configuration. Required. ,
Required: False ,
}
{
type:
{
Description: The type of the report. Usage represents actual usage, forecast represents forecasted data and UsageAndForecast represents both usage and forecasted data. Actual usage and forecasted data can be differentiated based on dates. ,
Enum:
{
Usage: No description available. ,
}
,
Required: True ,
}
enum ,
timeframe:
{
Description: The time frame for pulling data for the report. If custom, then a specific time period must be provided. ,
Enum:
{
WeekToDate: No description available. ,
MonthToDate: No description available. ,
YearToDate: No description available. ,
Custom: No description available. ,
}
,
Required: True ,
}
enum ,
timePeriod:
{
Description: Has time period for pulling data for the report. ,
Required: False ,
}
{
from:
{
Description: The start date to pull data from. ,
Format: date-time ,
Required: True ,
}
string ,
to:
{
Description: The end date to pull data to. ,
Format: date-time ,
Required: True ,
}
string ,
}
,
dataset:
{
Description: Has definition for data in this report config. ,
Required: False ,
}
{
granularity:
{
Description: The granularity of rows in the report. ,
Enum:
{
Daily: No description available. ,
Monthly: No description available. ,
}
,
Required: False ,
}
enum ,
configuration:
{
Description: Has configuration information for the data in the report. The configuration will be ignored if aggregation and grouping are provided. ,
Required: False ,
}
{
columns:
{
Description: Array of column names to be included in the report. Any valid report column name is allowed. If not provided, then report includes all columns. ,
Required: False ,
}
[
string ,
]
,
}
,
aggregation:
{
Description: Dictionary of aggregation expression to use in the report. The key of each item in the dictionary is the alias for the aggregated column. Report can have up to 2 aggregation clauses. ,
Required: False ,
}
object ,
grouping:
{
Description: Array of group by expression to use in the report. Report can have up to 2 group by clauses. ,
Required: False ,
}
[
{
type:
{
Description: Has type of the column to group. ,
Enum:
{
Tag: No description available. ,
Dimension: No description available. ,
}
,
Required: True ,
}
enum ,
name:
{
Description: The name of the column to group. This version supports subscription lowest possible grain. ,
Required: True ,
}
string ,
}
,
]
,
sorting:
{
Description: Array of order by expression to use in the report. ,
Required: False ,
}
[
{
direction:
{
Description: Direction of sort. ,
Enum:
{
Ascending: No description available. ,
Descending: No description available. ,
}
,
Required: False ,
}
enum ,
name:
{
Description: The name of the column to sort. ,
Required: True ,
}
string ,
}
,
]
,
filter:
{
Description: Has filter expression to use in the report. ,
Required: False ,
}
{
and:
{
Description: The logical "AND" expression. Must have at least 2 items. ,
Required: False ,
}
[
string ,
]
,
or:
{
Description: The logical "OR" expression. Must have at least 2 items. ,
Required: False ,
}
[
string ,
]
,
not:
{
Required: False ,
}
string ,
dimension:
{
Description: Has comparison expression for a dimension ,
Required: False ,
}
{
name:
{
Description: The name of the column to use in comparison. ,
Required: True ,
}
string ,
operator:
{
Description: The operator to use for comparison. ,
Enum:
{
In: No description available. ,
Contains: No description available. ,
}
,
Required: True ,
}
enum ,
values:
{
Description: Array of values to use for comparison ,
Required: True ,
}
[
string ,
]
,
}
,
tag:
{
Description: Has comparison expression for a tag ,
Required: False ,
}
{
name:
{
Description: The name of the column to use in comparison. ,
Required: True ,
}
string ,
operator:
{
Description: The operator to use for comparison. ,
Enum:
{
In: No description available. ,
Contains: No description available. ,
}
,
Required: True ,
}
enum ,
values:
{
Description: Array of values to use for comparison ,
Required: True ,
}
[
string ,
]
,
}
,
}
,
}
,
}
,
chart:
{
Description: Chart type of the main view in Cost Analysis. Required. ,
Enum:
{
Area: No description available. ,
Line: No description available. ,
StackedColumn: No description available. ,
GroupedColumn: No description available. ,
Table: No description available. ,
}
,
Required: False ,
}
enum ,
accumulated:
{
Description: Show costs accumulated over time. ,
Enum:
{
true: No description available. ,
false: No description available. ,
}
,
Required: False ,
}
enum ,
metric:
{
Description: Metric to use when displaying costs. ,
Enum:
{
ActualCost: No description available. ,
AmortizedCost: No description available. ,
AHUB: No description available. ,
}
,
Required: False ,
}
enum ,
kpis:
{
Description: List of KPIs to show in Cost Analysis UI. ,
Required: False ,
}
[
{
type:
{
Description: KPI type (Forecast, Budget). ,
Enum:
{
Forecast: No description available. ,
Budget: No description available. ,
}
,
Required: False ,
}
enum ,
id:
{
Description: ID of resource related to metric (budget). ,
Required: False ,
}
string ,
enabled:
{
Description: show the KPI in the UI? ,
Required: False ,
}
boolean ,
}
,
]
,
pivots:
{
Description: Configuration of 3 sub-views in the Cost Analysis UI. ,
Required: False ,
}
[
{
type:
{
Description: Data type to show in view. ,
Enum:
{
Dimension: No description available. ,
TagKey: No description available. ,
}
,
Required: False ,
}
enum ,
name:
{
Description: Data field to show in view. ,
Required: False ,
}
string ,
}
,
]
,
}
,
}

⚐ Response (201)

{
properties:
{
Description: The properties of the view. ,
Required: False ,
}
{
displayName:
{
Description: User input name of the view. Required. ,
Required: False ,
}
string ,
scope:
{
Description: Cost Management scope to save the view on. This includes 'subscriptions/{subscriptionId}' for subscription scope, 'subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}' for resourceGroup scope, 'providers/Microsoft.Billing/billingAccounts/{billingAccountId}' for Billing Account scope, 'providers/Microsoft.Billing/billingAccounts/{billingAccountId}/departments/{departmentId}' for Department scope, 'providers/Microsoft.Billing/billingAccounts/{billingAccountId}/enrollmentAccounts/{enrollmentAccountId}' for EnrollmentAccount scope, 'providers/Microsoft.Billing/billingAccounts/{billingAccountId}/billingProfiles/{billingProfileId}' for BillingProfile scope, 'providers/Microsoft.Billing/billingAccounts/{billingAccountId}/invoiceSections/{invoiceSectionId}' for InvoiceSection scope, 'providers/Microsoft.Management/managementGroups/{managementGroupId}' for Management Group scope, '/providers/Microsoft.CostManagement/externalBillingAccounts/{externalBillingAccountName}' for ExternalBillingAccount scope, and '/providers/Microsoft.CostManagement/externalSubscriptions/{externalSubscriptionName}' for ExternalSubscription scope. ,
Required: False ,
}
string ,
createdOn:
{
Description: Date the user created this view. ,
Format: date-time ,
Required: False ,
}
string ,
modifiedOn:
{
Description: Date when the user last modified this view. ,
Format: date-time ,
Required: False ,
}
string ,
query:
{
Description: Query body configuration. Required. ,
Required: False ,
}
{
type:
{
Description: The type of the report. Usage represents actual usage, forecast represents forecasted data and UsageAndForecast represents both usage and forecasted data. Actual usage and forecasted data can be differentiated based on dates. ,
Enum:
{
Usage: No description available. ,
}
,
Required: True ,
}
enum ,
timeframe:
{
Description: The time frame for pulling data for the report. If custom, then a specific time period must be provided. ,
Enum:
{
WeekToDate: No description available. ,
MonthToDate: No description available. ,
YearToDate: No description available. ,
Custom: No description available. ,
}
,
Required: True ,
}
enum ,
timePeriod:
{
Description: Has time period for pulling data for the report. ,
Required: False ,
}
{
from:
{
Description: The start date to pull data from. ,
Format: date-time ,
Required: True ,
}
string ,
to:
{
Description: The end date to pull data to. ,
Format: date-time ,
Required: True ,
}
string ,
}
,
dataset:
{
Description: Has definition for data in this report config. ,
Required: False ,
}
{
granularity:
{
Description: The granularity of rows in the report. ,
Enum:
{
Daily: No description available. ,
Monthly: No description available. ,
}
,
Required: False ,
}
enum ,
configuration:
{
Description: Has configuration information for the data in the report. The configuration will be ignored if aggregation and grouping are provided. ,
Required: False ,
}
{
columns:
{
Description: Array of column names to be included in the report. Any valid report column name is allowed. If not provided, then report includes all columns. ,
Required: False ,
}
[
string ,
]
,
}
,
aggregation:
{
Description: Dictionary of aggregation expression to use in the report. The key of each item in the dictionary is the alias for the aggregated column. Report can have up to 2 aggregation clauses. ,
Required: False ,
}
object ,
grouping:
{
Description: Array of group by expression to use in the report. Report can have up to 2 group by clauses. ,
Required: False ,
}
[
{
type:
{
Description: Has type of the column to group. ,
Enum:
{
Tag: No description available. ,
Dimension: No description available. ,
}
,
Required: True ,
}
enum ,
name:
{
Description: The name of the column to group. This version supports subscription lowest possible grain. ,
Required: True ,
}
string ,
}
,
]
,
sorting:
{
Description: Array of order by expression to use in the report. ,
Required: False ,
}
[
{
direction:
{
Description: Direction of sort. ,
Enum:
{
Ascending: No description available. ,
Descending: No description available. ,
}
,
Required: False ,
}
enum ,
name:
{
Description: The name of the column to sort. ,
Required: True ,
}
string ,
}
,
]
,
filter:
{
Description: Has filter expression to use in the report. ,
Required: False ,
}
{
and:
{
Description: The logical "AND" expression. Must have at least 2 items. ,
Required: False ,
}
[
string ,
]
,
or:
{
Description: The logical "OR" expression. Must have at least 2 items. ,
Required: False ,
}
[
string ,
]
,
not:
{
Required: False ,
}
string ,
dimension:
{
Description: Has comparison expression for a dimension ,
Required: False ,
}
{
name:
{
Description: The name of the column to use in comparison. ,
Required: True ,
}
string ,
operator:
{
Description: The operator to use for comparison. ,
Enum:
{
In: No description available. ,
Contains: No description available. ,
}
,
Required: True ,
}
enum ,
values:
{
Description: Array of values to use for comparison ,
Required: True ,
}
[
string ,
]
,
}
,
tag:
{
Description: Has comparison expression for a tag ,
Required: False ,
}
{
name:
{
Description: The name of the column to use in comparison. ,
Required: True ,
}
string ,
operator:
{
Description: The operator to use for comparison. ,
Enum:
{
In: No description available. ,
Contains: No description available. ,
}
,
Required: True ,
}
enum ,
values:
{
Description: Array of values to use for comparison ,
Required: True ,
}
[
string ,
]
,
}
,
}
,
}
,
}
,
chart:
{
Description: Chart type of the main view in Cost Analysis. Required. ,
Enum:
{
Area: No description available. ,
Line: No description available. ,
StackedColumn: No description available. ,
GroupedColumn: No description available. ,
Table: No description available. ,
}
,
Required: False ,
}
enum ,
accumulated:
{
Description: Show costs accumulated over time. ,
Enum:
{
true: No description available. ,
false: No description available. ,
}
,
Required: False ,
}
enum ,
metric:
{
Description: Metric to use when displaying costs. ,
Enum:
{
ActualCost: No description available. ,
AmortizedCost: No description available. ,
AHUB: No description available. ,
}
,
Required: False ,
}
enum ,
kpis:
{
Description: List of KPIs to show in Cost Analysis UI. ,
Required: False ,
}
[
{
type:
{
Description: KPI type (Forecast, Budget). ,
Enum:
{
Forecast: No description available. ,
Budget: No description available. ,
}
,
Required: False ,
}
enum ,
id:
{
Description: ID of resource related to metric (budget). ,
Required: False ,
}
string ,
enabled:
{
Description: show the KPI in the UI? ,
Required: False ,
}
boolean ,
}
,
]
,
pivots:
{
Description: Configuration of 3 sub-views in the Cost Analysis UI. ,
Required: False ,
}
[
{
type:
{
Description: Data type to show in view. ,
Enum:
{
Dimension: No description available. ,
TagKey: No description available. ,
}
,
Required: False ,
}
enum ,
name:
{
Description: Data field to show in view. ,
Required: False ,
}
string ,
}
,
]
,
}
,
}

⚐ Response (default)

{
error:
{
Description: The details of the error. ,
Required: False ,
}
{
code:
{
Description: A machine readable error code. ,
Required: False ,
}
string ,
message:
{
Description: A human readable error message. ,
Required: False ,
}
string ,
target:
{
Description: Indicates which property in the request is responsible for the error. ,
Required: False ,
}
string ,
details:
{
Description: error details. ,
Required: False ,
}
[
{
code:
{
Description: A machine readable error code. ,
Required: False ,
}
string ,
message:
{
Description: A human readable error message. ,
Required: False ,
}
string ,
target:
{
Description: Indicates which property in the request is responsible for the error. ,
Required: False ,
}
string ,
}
,
]
,
}
,
}
Views_DeleteByScope (new)
Description :  The operation to delete a view.
Reference :  Link ¶

⚼ Request

DELETE:  /{scope}/providers/Microsoft.CostManagement/views/{viewName}
{
scope:
{
Description: The scope associated with view operations. This includes 'subscriptions/{subscriptionId}' for subscription scope, 'subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}' for resourceGroup scope, 'providers/Microsoft.Billing/billingAccounts/{billingAccountId}' for Billing Account scope, 'providers/Microsoft.Billing/billingAccounts/{billingAccountId}/departments/{departmentId}' for Department scope, 'providers/Microsoft.Billing/billingAccounts/{billingAccountId}/enrollmentAccounts/{enrollmentAccountId}' for EnrollmentAccount scope, 'providers/Microsoft.Billing/billingAccounts/{billingAccountId}/billingProfiles/{billingProfileId}' for BillingProfile scope, 'providers/Microsoft.Billing/billingAccounts/{billingAccountId}/invoiceSections/{invoiceSectionId}' for InvoiceSection scope, 'providers/Microsoft.Management/managementGroups/{managementGroupId}' for Management Group scope, 'providers/Microsoft.CostManagement/externalBillingAccounts/{externalBillingAccountName}' for External Billing Account scope and 'providers/Microsoft.CostManagement/externalSubscriptions/{externalSubscriptionName}' for External Subscription scope. ,
Required: True ,
}
string ,
api-version:
{
Description: Version of the API to be used with the client request. The current version is 2019-04-01-preview ,
Required: True ,
}
string ,
viewName:
{
Description: View name ,
Required: True ,
}
string ,
}

⚐ Response (200)

{}

⚐ Response (204)

{}

⚐ Response (default)

{
error:
{
Description: The details of the error. ,
Required: False ,
}
{
code:
{
Description: A machine readable error code. ,
Required: False ,
}
string ,
message:
{
Description: A human readable error message. ,
Required: False ,
}
string ,
target:
{
Description: Indicates which property in the request is responsible for the error. ,
Required: False ,
}
string ,
details:
{
Description: error details. ,
Required: False ,
}
[
{
code:
{
Description: A machine readable error code. ,
Required: False ,
}
string ,
message:
{
Description: A human readable error message. ,
Required: False ,
}
string ,
target:
{
Description: Indicates which property in the request is responsible for the error. ,
Required: False ,
}
string ,
}
,
]
,
}
,
}
Budgets_List (new)
Description :  Lists all budgets for the defined scope.
Reference :  Link ¶

⚼ Request

GET:  /{scope}/providers/Microsoft.CostManagement/budgets
{
scope:
{
Description: The scope associated with budget operations. This includes '/subscriptions/{subscriptionId}/' for subscription scope, '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}' for resourceGroup scope, '/providers/Microsoft.Billing/billingAccounts/{billingAccountId}' for Billing Account scope, '/providers/Microsoft.Billing/billingAccounts/{billingAccountId}/departments/{departmentId}' for Department scope, '/providers/Microsoft.Billing/billingAccounts/{billingAccountId}/enrollmentAccounts/{enrollmentAccountId}' for EnrollmentAccount scope, '/providers/Microsoft.Management/managementGroups/{managementGroupId}' for Management Group scope, '/providers/Microsoft.Billing/billingAccounts/{billingAccountId}/billingProfiles/{billingProfileId}' for billingProfile scope, 'providers/Microsoft.Billing/billingAccounts/{billingAccountId}/invoiceSections/{invoiceSectionId}' for invoiceSection scope. ,
Required: True ,
}
string ,
api-version:
{
Description: Version of the API to be used with the client request. The current version is 2019-04-01-preview ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
value:
{
Description: The list of budgets. ,
Required: False ,
}
[
{
properties:
{
Description: The properties of the budget. ,
Required: False ,
}
{
category:
{
Description: The category of the budget, whether the budget tracks cost or usage. ,
Enum:
{
Cost: No description available. ,
Usage: No description available. ,
}
,
Required: True ,
}
enum ,
amount:
{
Description: The total amount of cost to track with the budget ,
Format: decimal ,
Required: True ,
}
number ,
timeGrain:
{
Description: The time covered by a budget. Tracking of the amount will be reset based on the time grain. ,
Enum:
{
Monthly: No description available. ,
Quarterly: No description available. ,
Annually: No description available. ,
}
,
Required: True ,
}
enum ,
timePeriod:
{
Description: Has start and end date of the budget. The start date must be first of the month and should be less than the end date. Budget start date must be on or after June 1, 2017. Future start date should not be more than three months. Past start date should be selected within the timegrain period. There are no restrictions on the end date. ,
Required: True ,
}
{
startDate:
{
Description: The start date for the budget. ,
Format: date-time ,
Required: True ,
}
string ,
endDate:
{
Description: The end date for the budget. If not provided, we default this to 10 years from the start date. ,
Format: date-time ,
Required: False ,
}
string ,
}
,
filter:
{
Description: May be used to filter budgets. ,
Required: False ,
}
{
and:
{
Description: The logical "AND" expression. Must have at least 2 items. ,
Required: False ,
}
[
string ,
]
,
or:
{
Description: The logical "OR" expression. Must have at least 2 items. ,
Required: False ,
}
[
string ,
]
,
not:
{
Required: False ,
}
string ,
dimension:
{
Description: Has comparison expression for a dimension ,
Required: False ,
}
{
name:
{
Description: The name of the column to use in comparison. ,
Required: True ,
}
string ,
operator:
{
Description: The operator to use for comparison. ,
Enum:
{
In: No description available. ,
Contains: No description available. ,
}
,
Required: True ,
}
enum ,
values:
{
Description: Array of values to use for comparison ,
Required: True ,
}
[
string ,
]
,
}
,
tag:
{
Description: Has comparison expression for a tag ,
Required: False ,
}
{
name:
{
Description: The name of the column to use in comparison. ,
Required: True ,
}
string ,
operator:
{
Description: The operator to use for comparison. ,
Enum:
{
In: No description available. ,
Contains: No description available. ,
}
,
Required: True ,
}
enum ,
values:
{
Description: Array of values to use for comparison ,
Required: True ,
}
[
string ,
]
,
}
,
}
,
currentSpend:
{
Description: The current amount of cost which is being tracked for a budget. ,
Required: False ,
}
{
amount:
{
Description: The total amount of cost which is being tracked by the budget. ,
Format: decimal ,
Required: False ,
}
number ,
unit:
{
Description: The unit of measure for the budget amount. ,
Required: False ,
}
string ,
}
,
notifications:
{
Description: Dictionary of notifications associated with the budget. Budget can have up to five notifications. ,
Required: False ,
}
object ,
}
,
}
,
]
,
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: A machine readable error code. ,
Required: False ,
}
string ,
message:
{
Description: A human readable error message. ,
Required: False ,
}
string ,
target:
{
Description: Indicates which property in the request is responsible for the error. ,
Required: False ,
}
string ,
details:
{
Description: error details. ,
Required: False ,
}
[
{
code:
{
Description: A machine readable error code. ,
Required: False ,
}
string ,
message:
{
Description: A human readable error message. ,
Required: False ,
}
string ,
target:
{
Description: Indicates which property in the request is responsible for the error. ,
Required: False ,
}
string ,
}
,
]
,
}
,
}
Budget_Get (new)
Description :  Gets the budget for the scope by budget name.
Reference :  Link ¶

⚼ Request

GET:  /{scope}/providers/Microsoft.CostManagement/budgets/{budgetName}
{
scope:
{
Description: The scope associated with budget operations. This includes '/subscriptions/{subscriptionId}/' for subscription scope, '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}' for resourceGroup scope, '/providers/Microsoft.Billing/billingAccounts/{billingAccountId}' for Billing Account scope, '/providers/Microsoft.Billing/billingAccounts/{billingAccountId}/departments/{departmentId}' for Department scope, '/providers/Microsoft.Billing/billingAccounts/{billingAccountId}/enrollmentAccounts/{enrollmentAccountId}' for EnrollmentAccount scope, '/providers/Microsoft.Management/managementGroups/{managementGroupId}' for Management Group scope, '/providers/Microsoft.Billing/billingAccounts/{billingAccountId}/billingProfiles/{billingProfileId}' for billingProfile scope, 'providers/Microsoft.Billing/billingAccounts/{billingAccountId}/invoiceSections/{invoiceSectionId}' for invoiceSection scope. ,
Required: True ,
}
string ,
api-version:
{
Description: Version of the API to be used with the client request. The current version is 2019-04-01-preview ,
Required: True ,
}
string ,
budgetName:
{
Description: Budget Name. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
properties:
{
Description: The properties of the budget. ,
Required: False ,
}
{
category:
{
Description: The category of the budget, whether the budget tracks cost or usage. ,
Enum:
{
Cost: No description available. ,
Usage: No description available. ,
}
,
Required: True ,
}
enum ,
amount:
{
Description: The total amount of cost to track with the budget ,
Format: decimal ,
Required: True ,
}
number ,
timeGrain:
{
Description: The time covered by a budget. Tracking of the amount will be reset based on the time grain. ,
Enum:
{
Monthly: No description available. ,
Quarterly: No description available. ,
Annually: No description available. ,
}
,
Required: True ,
}
enum ,
timePeriod:
{
Description: Has start and end date of the budget. The start date must be first of the month and should be less than the end date. Budget start date must be on or after June 1, 2017. Future start date should not be more than three months. Past start date should be selected within the timegrain period. There are no restrictions on the end date. ,
Required: True ,
}
{
startDate:
{
Description: The start date for the budget. ,
Format: date-time ,
Required: True ,
}
string ,
endDate:
{
Description: The end date for the budget. If not provided, we default this to 10 years from the start date. ,
Format: date-time ,
Required: False ,
}
string ,
}
,
filter:
{
Description: May be used to filter budgets. ,
Required: False ,
}
{
and:
{
Description: The logical "AND" expression. Must have at least 2 items. ,
Required: False ,
}
[
string ,
]
,
or:
{
Description: The logical "OR" expression. Must have at least 2 items. ,
Required: False ,
}
[
string ,
]
,
not:
{
Required: False ,
}
string ,
dimension:
{
Description: Has comparison expression for a dimension ,
Required: False ,
}
{
name:
{
Description: The name of the column to use in comparison. ,
Required: True ,
}
string ,
operator:
{
Description: The operator to use for comparison. ,
Enum:
{
In: No description available. ,
Contains: No description available. ,
}
,
Required: True ,
}
enum ,
values:
{
Description: Array of values to use for comparison ,
Required: True ,
}
[
string ,
]
,
}
,
tag:
{
Description: Has comparison expression for a tag ,
Required: False ,
}
{
name:
{
Description: The name of the column to use in comparison. ,
Required: True ,
}
string ,
operator:
{
Description: The operator to use for comparison. ,
Enum:
{
In: No description available. ,
Contains: No description available. ,
}
,
Required: True ,
}
enum ,
values:
{
Description: Array of values to use for comparison ,
Required: True ,
}
[
string ,
]
,
}
,
}
,
currentSpend:
{
Description: The current amount of cost which is being tracked for a budget. ,
Required: False ,
}
{
amount:
{
Description: The total amount of cost which is being tracked by the budget. ,
Format: decimal ,
Required: False ,
}
number ,
unit:
{
Description: The unit of measure for the budget amount. ,
Required: False ,
}
string ,
}
,
notifications:
{
Description: Dictionary of notifications associated with the budget. Budget can have up to five notifications. ,
Required: False ,
}
object ,
}
,
}

⚐ Response (default)

{
error:
{
Description: The details of the error. ,
Required: False ,
}
{
code:
{
Description: A machine readable error code. ,
Required: False ,
}
string ,
message:
{
Description: A human readable error message. ,
Required: False ,
}
string ,
target:
{
Description: Indicates which property in the request is responsible for the error. ,
Required: False ,
}
string ,
details:
{
Description: error details. ,
Required: False ,
}
[
{
code:
{
Description: A machine readable error code. ,
Required: False ,
}
string ,
message:
{
Description: A human readable error message. ,
Required: False ,
}
string ,
target:
{
Description: Indicates which property in the request is responsible for the error. ,
Required: False ,
}
string ,
}
,
]
,
}
,
}
Budget_CreateOrUpdate (new)
Description :  The operation to create or update a budget. Update operation requires latest eTag to be set in the request mandatorily. You may obtain the latest eTag by performing a get operation. Create operation does not require eTag.
Reference :  Link ¶

⚼ Request

PUT:  /{scope}/providers/Microsoft.CostManagement/budgets/{budgetName}
{
scope:
{
Description: The scope associated with budget operations. This includes '/subscriptions/{subscriptionId}/' for subscription scope, '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}' for resourceGroup scope, '/providers/Microsoft.Billing/billingAccounts/{billingAccountId}' for Billing Account scope, '/providers/Microsoft.Billing/billingAccounts/{billingAccountId}/departments/{departmentId}' for Department scope, '/providers/Microsoft.Billing/billingAccounts/{billingAccountId}/enrollmentAccounts/{enrollmentAccountId}' for EnrollmentAccount scope, '/providers/Microsoft.Management/managementGroups/{managementGroupId}' for Management Group scope, '/providers/Microsoft.Billing/billingAccounts/{billingAccountId}/billingProfiles/{billingProfileId}' for billingProfile scope, 'providers/Microsoft.Billing/billingAccounts/{billingAccountId}/invoiceSections/{invoiceSectionId}' for invoiceSection scope. ,
Required: True ,
}
string ,
api-version:
{
Description: Version of the API to be used with the client request. The current version is 2019-04-01-preview ,
Required: True ,
}
string ,
budgetName:
{
Description: Budget Name. ,
Required: True ,
}
string ,
parameters:
{
Description: Parameters supplied to the Create Budget operation. ,
Required: False ,
}
{
properties:
{
Description: The properties of the budget. ,
Required: False ,
}
{
category:
{
Description: The category of the budget, whether the budget tracks cost or usage. ,
Enum:
{
Cost: No description available. ,
Usage: No description available. ,
}
,
Required: True ,
}
enum ,
amount:
{
Description: The total amount of cost to track with the budget ,
Format: decimal ,
Required: True ,
}
number ,
timeGrain:
{
Description: The time covered by a budget. Tracking of the amount will be reset based on the time grain. ,
Enum:
{
Monthly: No description available. ,
Quarterly: No description available. ,
Annually: No description available. ,
}
,
Required: True ,
}
enum ,
timePeriod:
{
Description: Has start and end date of the budget. The start date must be first of the month and should be less than the end date. Budget start date must be on or after June 1, 2017. Future start date should not be more than three months. Past start date should be selected within the timegrain period. There are no restrictions on the end date. ,
Required: True ,
}
{
startDate:
{
Description: The start date for the budget. ,
Format: date-time ,
Required: True ,
}
string ,
endDate:
{
Description: The end date for the budget. If not provided, we default this to 10 years from the start date. ,
Format: date-time ,
Required: False ,
}
string ,
}
,
filter:
{
Description: May be used to filter budgets. ,
Required: False ,
}
{
and:
{
Description: The logical "AND" expression. Must have at least 2 items. ,
Required: False ,
}
[
string ,
]
,
or:
{
Description: The logical "OR" expression. Must have at least 2 items. ,
Required: False ,
}
[
string ,
]
,
not:
{
Required: False ,
}
string ,
dimension:
{
Description: Has comparison expression for a dimension ,
Required: False ,
}
{
name:
{
Description: The name of the column to use in comparison. ,
Required: True ,
}
string ,
operator:
{
Description: The operator to use for comparison. ,
Enum:
{
In: No description available. ,
Contains: No description available. ,
}
,
Required: True ,
}
enum ,
values:
{
Description: Array of values to use for comparison ,
Required: True ,
}
[
string ,
]
,
}
,
tag:
{
Description: Has comparison expression for a tag ,
Required: False ,
}
{
name:
{
Description: The name of the column to use in comparison. ,
Required: True ,
}
string ,
operator:
{
Description: The operator to use for comparison. ,
Enum:
{
In: No description available. ,
Contains: No description available. ,
}
,
Required: True ,
}
enum ,
values:
{
Description: Array of values to use for comparison ,
Required: True ,
}
[
string ,
]
,
}
,
}
,
currentSpend:
{
Description: The current amount of cost which is being tracked for a budget. ,
Required: False ,
}
{
amount:
{
Description: The total amount of cost which is being tracked by the budget. ,
Format: decimal ,
Required: False ,
}
number ,
unit:
{
Description: The unit of measure for the budget amount. ,
Required: False ,
}
string ,
}
,
notifications:
{
Description: Dictionary of notifications associated with the budget. Budget can have up to five notifications. ,
Required: False ,
}
object ,
}
,
}
,
}

⚐ Response (200)

{
properties:
{
Description: The properties of the budget. ,
Required: False ,
}
{
category:
{
Description: The category of the budget, whether the budget tracks cost or usage. ,
Enum:
{
Cost: No description available. ,
Usage: No description available. ,
}
,
Required: True ,
}
enum ,
amount:
{
Description: The total amount of cost to track with the budget ,
Format: decimal ,
Required: True ,
}
number ,
timeGrain:
{
Description: The time covered by a budget. Tracking of the amount will be reset based on the time grain. ,
Enum:
{
Monthly: No description available. ,
Quarterly: No description available. ,
Annually: No description available. ,
}
,
Required: True ,
}
enum ,
timePeriod:
{
Description: Has start and end date of the budget. The start date must be first of the month and should be less than the end date. Budget start date must be on or after June 1, 2017. Future start date should not be more than three months. Past start date should be selected within the timegrain period. There are no restrictions on the end date. ,
Required: True ,
}
{
startDate:
{
Description: The start date for the budget. ,
Format: date-time ,
Required: True ,
}
string ,
endDate:
{
Description: The end date for the budget. If not provided, we default this to 10 years from the start date. ,
Format: date-time ,
Required: False ,
}
string ,
}
,
filter:
{
Description: May be used to filter budgets. ,
Required: False ,
}
{
and:
{
Description: The logical "AND" expression. Must have at least 2 items. ,
Required: False ,
}
[
string ,
]
,
or:
{
Description: The logical "OR" expression. Must have at least 2 items. ,
Required: False ,
}
[
string ,
]
,
not:
{
Required: False ,
}
string ,
dimension:
{
Description: Has comparison expression for a dimension ,
Required: False ,
}
{
name:
{
Description: The name of the column to use in comparison. ,
Required: True ,
}
string ,
operator:
{
Description: The operator to use for comparison. ,
Enum:
{
In: No description available. ,
Contains: No description available. ,
}
,
Required: True ,
}
enum ,
values:
{
Description: Array of values to use for comparison ,
Required: True ,
}
[
string ,
]
,
}
,
tag:
{
Description: Has comparison expression for a tag ,
Required: False ,
}
{
name:
{
Description: The name of the column to use in comparison. ,
Required: True ,
}
string ,
operator:
{
Description: The operator to use for comparison. ,
Enum:
{
In: No description available. ,
Contains: No description available. ,
}
,
Required: True ,
}
enum ,
values:
{
Description: Array of values to use for comparison ,
Required: True ,
}
[
string ,
]
,
}
,
}
,
currentSpend:
{
Description: The current amount of cost which is being tracked for a budget. ,
Required: False ,
}
{
amount:
{
Description: The total amount of cost which is being tracked by the budget. ,
Format: decimal ,
Required: False ,
}
number ,
unit:
{
Description: The unit of measure for the budget amount. ,
Required: False ,
}
string ,
}
,
notifications:
{
Description: Dictionary of notifications associated with the budget. Budget can have up to five notifications. ,
Required: False ,
}
object ,
}
,
}

⚐ Response (201)

{
properties:
{
Description: The properties of the budget. ,
Required: False ,
}
{
category:
{
Description: The category of the budget, whether the budget tracks cost or usage. ,
Enum:
{
Cost: No description available. ,
Usage: No description available. ,
}
,
Required: True ,
}
enum ,
amount:
{
Description: The total amount of cost to track with the budget ,
Format: decimal ,
Required: True ,
}
number ,
timeGrain:
{
Description: The time covered by a budget. Tracking of the amount will be reset based on the time grain. ,
Enum:
{
Monthly: No description available. ,
Quarterly: No description available. ,
Annually: No description available. ,
}
,
Required: True ,
}
enum ,
timePeriod:
{
Description: Has start and end date of the budget. The start date must be first of the month and should be less than the end date. Budget start date must be on or after June 1, 2017. Future start date should not be more than three months. Past start date should be selected within the timegrain period. There are no restrictions on the end date. ,
Required: True ,
}
{
startDate:
{
Description: The start date for the budget. ,
Format: date-time ,
Required: True ,
}
string ,
endDate:
{
Description: The end date for the budget. If not provided, we default this to 10 years from the start date. ,
Format: date-time ,
Required: False ,
}
string ,
}
,
filter:
{
Description: May be used to filter budgets. ,
Required: False ,
}
{
and:
{
Description: The logical "AND" expression. Must have at least 2 items. ,
Required: False ,
}
[
string ,
]
,
or:
{
Description: The logical "OR" expression. Must have at least 2 items. ,
Required: False ,
}
[
string ,
]
,
not:
{
Required: False ,
}
string ,
dimension:
{
Description: Has comparison expression for a dimension ,
Required: False ,
}
{
name:
{
Description: The name of the column to use in comparison. ,
Required: True ,
}
string ,
operator:
{
Description: The operator to use for comparison. ,
Enum:
{
In: No description available. ,
Contains: No description available. ,
}
,
Required: True ,
}
enum ,
values:
{
Description: Array of values to use for comparison ,
Required: True ,
}
[
string ,
]
,
}
,
tag:
{
Description: Has comparison expression for a tag ,
Required: False ,
}
{
name:
{
Description: The name of the column to use in comparison. ,
Required: True ,
}
string ,
operator:
{
Description: The operator to use for comparison. ,
Enum:
{
In: No description available. ,
Contains: No description available. ,
}
,
Required: True ,
}
enum ,
values:
{
Description: Array of values to use for comparison ,
Required: True ,
}
[
string ,
]
,
}
,
}
,
currentSpend:
{
Description: The current amount of cost which is being tracked for a budget. ,
Required: False ,
}
{
amount:
{
Description: The total amount of cost which is being tracked by the budget. ,
Format: decimal ,
Required: False ,
}
number ,
unit:
{
Description: The unit of measure for the budget amount. ,
Required: False ,
}
string ,
}
,
notifications:
{
Description: Dictionary of notifications associated with the budget. Budget can have up to five notifications. ,
Required: False ,
}
object ,
}
,
}

⚐ Response (default)

{
error:
{
Description: The details of the error. ,
Required: False ,
}
{
code:
{
Description: A machine readable error code. ,
Required: False ,
}
string ,
message:
{
Description: A human readable error message. ,
Required: False ,
}
string ,
target:
{
Description: Indicates which property in the request is responsible for the error. ,
Required: False ,
}
string ,
details:
{
Description: error details. ,
Required: False ,
}
[
{
code:
{
Description: A machine readable error code. ,
Required: False ,
}
string ,
message:
{
Description: A human readable error message. ,
Required: False ,
}
string ,
target:
{
Description: Indicates which property in the request is responsible for the error. ,
Required: False ,
}
string ,
}
,
]
,
}
,
}
Budget_Delete (new)
Description :  The operation to delete a budget.
Reference :  Link ¶

⚼ Request

DELETE:  /{scope}/providers/Microsoft.CostManagement/budgets/{budgetName}
{
scope:
{
Description: The scope associated with budget operations. This includes '/subscriptions/{subscriptionId}/' for subscription scope, '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}' for resourceGroup scope, '/providers/Microsoft.Billing/billingAccounts/{billingAccountId}' for Billing Account scope, '/providers/Microsoft.Billing/billingAccounts/{billingAccountId}/departments/{departmentId}' for Department scope, '/providers/Microsoft.Billing/billingAccounts/{billingAccountId}/enrollmentAccounts/{enrollmentAccountId}' for EnrollmentAccount scope, '/providers/Microsoft.Management/managementGroups/{managementGroupId}' for Management Group scope, '/providers/Microsoft.Billing/billingAccounts/{billingAccountId}/billingProfiles/{billingProfileId}' for billingProfile scope, 'providers/Microsoft.Billing/billingAccounts/{billingAccountId}/invoiceSections/{invoiceSectionId}' for invoiceSection scope. ,
Required: True ,
}
string ,
api-version:
{
Description: Version of the API to be used with the client request. The current version is 2019-04-01-preview ,
Required: True ,
}
string ,
budgetName:
{
Description: Budget Name. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{}

⚐ Response (204)

{}

⚐ Response (default)

{
error:
{
Description: The details of the error. ,
Required: False ,
}
{
code:
{
Description: A machine readable error code. ,
Required: False ,
}
string ,
message:
{
Description: A human readable error message. ,
Required: False ,
}
string ,
target:
{
Description: Indicates which property in the request is responsible for the error. ,
Required: False ,
}
string ,
details:
{
Description: error details. ,
Required: False ,
}
[
{
code:
{
Description: A machine readable error code. ,
Required: False ,
}
string ,
message:
{
Description: A human readable error message. ,
Required: False ,
}
string ,
target:
{
Description: Indicates which property in the request is responsible for the error. ,
Required: False ,
}
string ,
}
,
]
,
}
,
}
Operations_List (new)
Description :  Lists all of the available consumption REST API operations.
Reference :  Link ¶

⚼ Request

GET:  /providers/Microsoft.CostManagement/operations
{
api-version:
{
Description: Version of the API to be used with the client request. The current version is 2019-04-01-preview ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
value:
{
Description: List of cost management operations supported by the Microsoft.CostManagement resource provider. ,
Required: False ,
}
[
{
name:
{
Description: Operation name: {provider}/{resource}/{operation}. ,
Required: False ,
}
string ,
display:
{
Description: The object that represents the operation. ,
Required: False ,
}
{
provider:
{
Description: Service provider: Microsoft.CostManagement. ,
Required: False ,
}
string ,
resource:
{
Description: Resource on which the operation is performed: Dimensions, Query. ,
Required: False ,
}
string ,
operation:
{
Description: Operation type: Read, write, delete, etc. ,
Required: False ,
}
string ,
}
,
}
,
]
,
nextLink:
{
Description: URL to get the next set of operation list results if there are any. ,
Required: False ,
}
string ,
}

⚐ Response (default)

{
error:
{
Description: The details of the error. ,
Required: False ,
}
{
code:
{
Description: A machine readable error code. ,
Required: False ,
}
string ,
message:
{
Description: A human readable error message. ,
Required: False ,
}
string ,
target:
{
Description: Indicates which property in the request is responsible for the error. ,
Required: False ,
}
string ,
details:
{
Description: error details. ,
Required: False ,
}
[
{
code:
{
Description: A machine readable error code. ,
Required: False ,
}
string ,
message:
{
Description: A human readable error message. ,
Required: False ,
}
string ,
target:
{
Description: Indicates which property in the request is responsible for the error. ,
Required: False ,
}
string ,
}
,
]
,
}
,
}
Views_List (removed)
Description :  Lists all views by tenant and object.
Reference :  Link ¶

⚼ Request

GET:  /providers/Microsoft.CostManagement/views
{
api-version:
{
Description: Version of the API to be used with the client request. The current version is 2019-04-01-preview ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
value:
{
Description: The list of views. ,
Required: False ,
}
[
{
properties:
{
Description: The properties of the view. ,
Required: False ,
}
{
displayName:
{
Description: User input name of the view. Required. ,
Required: False ,
}
string ,
scope:
{
Description: Cost Management scope to save the view on. This includes 'subscriptions/{subscriptionId}' for subscription scope, 'subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}' for resourceGroup scope, 'providers/Microsoft.Billing/billingAccounts/{billingAccountId}' for Billing Account scope, 'providers/Microsoft.Billing/billingAccounts/{billingAccountId}/departments/{departmentId}' for Department scope, 'providers/Microsoft.Billing/billingAccounts/{billingAccountId}/enrollmentAccounts/{enrollmentAccountId}' for EnrollmentAccount scope, 'providers/Microsoft.Billing/billingAccounts/{billingAccountId}/billingProfiles/{billingProfileId}' for BillingProfile scope, 'providers/Microsoft.Billing/billingAccounts/{billingAccountId}/invoiceSections/{invoiceSectionId}' for InvoiceSection scope, 'providers/Microsoft.Management/managementGroups/{managementGroupId}' for Management Group scope, '/providers/Microsoft.CostManagement/externalBillingAccounts/{externalBillingAccountName}' for ExternalBillingAccount scope, and '/providers/Microsoft.CostManagement/externalSubscriptions/{externalSubscriptionName}' for ExternalSubscription scope. ,
Required: False ,
}
string ,
createdOn:
{
Description: Date the user created this view. ,
Format: date-time ,
Required: False ,
}
string ,
modifiedOn:
{
Description: Date when the user last modified this view. ,
Format: date-time ,
Required: False ,
}
string ,
query:
{
Description: Query body configuration. Required. ,
Required: False ,
}
{
type:
{
Description: The type of the report. Usage represents actual usage, forecast represents forecasted data and UsageAndForecast represents both usage and forecasted data. Actual usage and forecasted data can be differentiated based on dates. ,
Enum:
{
Usage: No description available. ,
}
,
Required: True ,
}
enum ,
timeframe:
{
Description: The time frame for pulling data for the report. If custom, then a specific time period must be provided. ,
Enum:
{
WeekToDate: No description available. ,
MonthToDate: No description available. ,
YearToDate: No description available. ,
Custom: No description available. ,
}
,
Required: True ,
}
enum ,
timePeriod:
{
Description: Has time period for pulling data for the report. ,
Required: False ,
}
{
from:
{
Description: The start date to pull data from. ,
Format: date-time ,
Required: True ,
}
string ,
to:
{
Description: The end date to pull data to. ,
Format: date-time ,
Required: True ,
}
string ,
}
,
dataset:
{
Description: Has definition for data in this report config. ,
Required: False ,
}
{
granularity:
{
Description: The granularity of rows in the report. ,
Enum:
{
Daily: No description available. ,
Monthly: No description available. ,
}
,
Required: False ,
}
enum ,
configuration:
{
Description: Has configuration information for the data in the report. The configuration will be ignored if aggregation and grouping are provided. ,
Required: False ,
}
{
columns:
{
Description: Array of column names to be included in the report. Any valid report column name is allowed. If not provided, then report includes all columns. ,
Required: False ,
}
[
string ,
]
,
}
,
aggregation:
{
Description: Dictionary of aggregation expression to use in the report. The key of each item in the dictionary is the alias for the aggregated column. Report can have up to 2 aggregation clauses. ,
Required: False ,
}
object ,
grouping:
{
Description: Array of group by expression to use in the report. Report can have up to 2 group by clauses. ,
Required: False ,
}
[
{
type:
{
Description: Has type of the column to group. ,
Enum:
{
Tag: No description available. ,
Dimension: No description available. ,
}
,
Required: True ,
}
enum ,
name:
{
Description: The name of the column to group. This version supports subscription lowest possible grain. ,
Required: True ,
}
string ,
}
,
]
,
sorting:
{
Description: Array of order by expression to use in the report. ,
Required: False ,
}
[
{
direction:
{
Description: Direction of sort. ,
Enum:
{
Ascending: No description available. ,
Descending: No description available. ,
}
,
Required: False ,
}
enum ,
name:
{
Description: The name of the column to sort. ,
Required: True ,
}
string ,
}
,
]
,
filter:
{
Description: Has filter expression to use in the report. ,
Required: False ,
}
{
and:
{
Description: The logical "AND" expression. Must have at least 2 items. ,
Required: False ,
}
[
string ,
]
,
or:
{
Description: The logical "OR" expression. Must have at least 2 items. ,
Required: False ,
}
[
string ,
]
,
not:
{
Required: False ,
}
string ,
dimension:
{
Description: Has comparison expression for a dimension ,
Required: False ,
}
{
name:
{
Description: The name of the column to use in comparison. ,
Required: True ,
}
string ,
operator:
{
Description: The operator to use for comparison. ,
Enum:
{
In: No description available. ,
Contains: No description available. ,
}
,
Required: True ,
}
enum ,
values:
{
Description: Array of values to use for comparison ,
Required: True ,
}
[
string ,
]
,
}
,
tag:
{
Description: Has comparison expression for a tag ,
Required: False ,
}
{
name:
{
Description: The name of the column to use in comparison. ,
Required: True ,
}
string ,
operator:
{
Description: The operator to use for comparison. ,
Enum:
{
In: No description available. ,
Contains: No description available. ,
}
,
Required: True ,
}
enum ,
values:
{
Description: Array of values to use for comparison ,
Required: True ,
}
[
string ,
]
,
}
,
}
,
}
,
}
,
chart:
{
Description: Chart type of the main view in Cost Analysis. Required. ,
Enum:
{
Area: No description available. ,
Line: No description available. ,
StackedColumn: No description available. ,
GroupedColumn: No description available. ,
Table: No description available. ,
}
,
Required: False ,
}
enum ,
accumulated:
{
Description: Show costs accumulated over time. ,
Enum:
{
true: No description available. ,
false: No description available. ,
}
,
Required: False ,
}
enum ,
metric:
{
Description: Metric to use when displaying costs. ,
Enum:
{
ActualCost: No description available. ,
AmortizedCost: No description available. ,
AHUB: No description available. ,
}
,
Required: False ,
}
enum ,
kpis:
{
Description: List of KPIs to show in Cost Analysis UI. ,
Required: False ,
}
[
{
type:
{
Description: KPI type (Forecast, Budget). ,
Enum:
{
Forecast: No description available. ,
Budget: No description available. ,
}
,
Required: False ,
}
enum ,
id:
{
Description: ID of resource related to metric (budget). ,
Required: False ,
}
string ,
enabled:
{
Description: show the KPI in the UI? ,
Required: False ,
}
boolean ,
}
,
]
,
pivots:
{
Description: Configuration of 3 sub-views in the Cost Analysis UI. ,
Required: False ,
}
[
{
type:
{
Description: Data type to show in view. ,
Enum:
{
Dimension: No description available. ,
TagKey: No description available. ,
}
,
Required: False ,
}
enum ,
name:
{
Description: Data field to show in view. ,
Required: False ,
}
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: A machine readable error code. ,
Required: False ,
}
string ,
message:
{
Description: A human readable error message. ,
Required: False ,
}
string ,
target:
{
Description: Indicates which property in the request is responsible for the error. ,
Required: False ,
}
string ,
details:
{
Description: error details. ,
Required: False ,
}
[
{
code:
{
Description: A machine readable error code. ,
Required: False ,
}
string ,
message:
{
Description: A human readable error message. ,
Required: False ,
}
string ,
target:
{
Description: Indicates which property in the request is responsible for the error. ,
Required: False ,
}
string ,
}
,
]
,
}
,
}
Views_ListByScope (removed)
Description :  Lists all views at the given scope.
Reference :  Link ¶

⚼ Request

GET:  /{scope}/providers/Microsoft.CostManagement/views
{
scope:
{
Description: The scope associated with view operations. This includes 'subscriptions/{subscriptionId}' for subscription scope, 'subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}' for resourceGroup scope, 'providers/Microsoft.Billing/billingAccounts/{billingAccountId}' for Billing Account scope, 'providers/Microsoft.Billing/billingAccounts/{billingAccountId}/departments/{departmentId}' for Department scope, 'providers/Microsoft.Billing/billingAccounts/{billingAccountId}/enrollmentAccounts/{enrollmentAccountId}' for EnrollmentAccount scope, 'providers/Microsoft.Billing/billingAccounts/{billingAccountId}/billingProfiles/{billingProfileId}' for BillingProfile scope, 'providers/Microsoft.Billing/billingAccounts/{billingAccountId}/invoiceSections/{invoiceSectionId}' for InvoiceSection scope, 'providers/Microsoft.Management/managementGroups/{managementGroupId}' for Management Group scope, 'providers/Microsoft.CostManagement/externalBillingAccounts/{externalBillingAccountName}' for External Billing Account scope and 'providers/Microsoft.CostManagement/externalSubscriptions/{externalSubscriptionName}' for External Subscription scope. ,
Required: True ,
}
string ,
api-version:
{
Description: Version of the API to be used with the client request. The current version is 2019-04-01-preview ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
value:
{
Description: The list of views. ,
Required: False ,
}
[
{
properties:
{
Description: The properties of the view. ,
Required: False ,
}
{
displayName:
{
Description: User input name of the view. Required. ,
Required: False ,
}
string ,
scope:
{
Description: Cost Management scope to save the view on. This includes 'subscriptions/{subscriptionId}' for subscription scope, 'subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}' for resourceGroup scope, 'providers/Microsoft.Billing/billingAccounts/{billingAccountId}' for Billing Account scope, 'providers/Microsoft.Billing/billingAccounts/{billingAccountId}/departments/{departmentId}' for Department scope, 'providers/Microsoft.Billing/billingAccounts/{billingAccountId}/enrollmentAccounts/{enrollmentAccountId}' for EnrollmentAccount scope, 'providers/Microsoft.Billing/billingAccounts/{billingAccountId}/billingProfiles/{billingProfileId}' for BillingProfile scope, 'providers/Microsoft.Billing/billingAccounts/{billingAccountId}/invoiceSections/{invoiceSectionId}' for InvoiceSection scope, 'providers/Microsoft.Management/managementGroups/{managementGroupId}' for Management Group scope, '/providers/Microsoft.CostManagement/externalBillingAccounts/{externalBillingAccountName}' for ExternalBillingAccount scope, and '/providers/Microsoft.CostManagement/externalSubscriptions/{externalSubscriptionName}' for ExternalSubscription scope. ,
Required: False ,
}
string ,
createdOn:
{
Description: Date the user created this view. ,
Format: date-time ,
Required: False ,
}
string ,
modifiedOn:
{
Description: Date when the user last modified this view. ,
Format: date-time ,
Required: False ,
}
string ,
query:
{
Description: Query body configuration. Required. ,
Required: False ,
}
{
type:
{
Description: The type of the report. Usage represents actual usage, forecast represents forecasted data and UsageAndForecast represents both usage and forecasted data. Actual usage and forecasted data can be differentiated based on dates. ,
Enum:
{
Usage: No description available. ,
}
,
Required: True ,
}
enum ,
timeframe:
{
Description: The time frame for pulling data for the report. If custom, then a specific time period must be provided. ,
Enum:
{
WeekToDate: No description available. ,
MonthToDate: No description available. ,
YearToDate: No description available. ,
Custom: No description available. ,
}
,
Required: True ,
}
enum ,
timePeriod:
{
Description: Has time period for pulling data for the report. ,
Required: False ,
}
{
from:
{
Description: The start date to pull data from. ,
Format: date-time ,
Required: True ,
}
string ,
to:
{
Description: The end date to pull data to. ,
Format: date-time ,
Required: True ,
}
string ,
}
,
dataset:
{
Description: Has definition for data in this report config. ,
Required: False ,
}
{
granularity:
{
Description: The granularity of rows in the report. ,
Enum:
{
Daily: No description available. ,
Monthly: No description available. ,
}
,
Required: False ,
}
enum ,
configuration:
{
Description: Has configuration information for the data in the report. The configuration will be ignored if aggregation and grouping are provided. ,
Required: False ,
}
{
columns:
{
Description: Array of column names to be included in the report. Any valid report column name is allowed. If not provided, then report includes all columns. ,
Required: False ,
}
[
string ,
]
,
}
,
aggregation:
{
Description: Dictionary of aggregation expression to use in the report. The key of each item in the dictionary is the alias for the aggregated column. Report can have up to 2 aggregation clauses. ,
Required: False ,
}
object ,
grouping:
{
Description: Array of group by expression to use in the report. Report can have up to 2 group by clauses. ,
Required: False ,
}
[
{
type:
{
Description: Has type of the column to group. ,
Enum:
{
Tag: No description available. ,
Dimension: No description available. ,
}
,
Required: True ,
}
enum ,
name:
{
Description: The name of the column to group. This version supports subscription lowest possible grain. ,
Required: True ,
}
string ,
}
,
]
,
sorting:
{
Description: Array of order by expression to use in the report. ,
Required: False ,
}
[
{
direction:
{
Description: Direction of sort. ,
Enum:
{
Ascending: No description available. ,
Descending: No description available. ,
}
,
Required: False ,
}
enum ,
name:
{
Description: The name of the column to sort. ,
Required: True ,
}
string ,
}
,
]
,
filter:
{
Description: Has filter expression to use in the report. ,
Required: False ,
}
{
and:
{
Description: The logical "AND" expression. Must have at least 2 items. ,
Required: False ,
}
[
string ,
]
,
or:
{
Description: The logical "OR" expression. Must have at least 2 items. ,
Required: False ,
}
[
string ,
]
,
not:
{
Required: False ,
}
string ,
dimension:
{
Description: Has comparison expression for a dimension ,
Required: False ,
}
{
name:
{
Description: The name of the column to use in comparison. ,
Required: True ,
}
string ,
operator:
{
Description: The operator to use for comparison. ,
Enum:
{
In: No description available. ,
Contains: No description available. ,
}
,
Required: True ,
}
enum ,
values:
{
Description: Array of values to use for comparison ,
Required: True ,
}
[
string ,
]
,
}
,
tag:
{
Description: Has comparison expression for a tag ,
Required: False ,
}
{
name:
{
Description: The name of the column to use in comparison. ,
Required: True ,
}
string ,
operator:
{
Description: The operator to use for comparison. ,
Enum:
{
In: No description available. ,
Contains: No description available. ,
}
,
Required: True ,
}
enum ,
values:
{
Description: Array of values to use for comparison ,
Required: True ,
}
[
string ,
]
,
}
,
}
,
}
,
}
,
chart:
{
Description: Chart type of the main view in Cost Analysis. Required. ,
Enum:
{
Area: No description available. ,
Line: No description available. ,
StackedColumn: No description available. ,
GroupedColumn: No description available. ,
Table: No description available. ,
}
,
Required: False ,
}
enum ,
accumulated:
{
Description: Show costs accumulated over time. ,
Enum:
{
true: No description available. ,
false: No description available. ,
}
,
Required: False ,
}
enum ,
metric:
{
Description: Metric to use when displaying costs. ,
Enum:
{
ActualCost: No description available. ,
AmortizedCost: No description available. ,
AHUB: No description available. ,
}
,
Required: False ,
}
enum ,
kpis:
{
Description: List of KPIs to show in Cost Analysis UI. ,
Required: False ,
}
[
{
type:
{
Description: KPI type (Forecast, Budget). ,
Enum:
{
Forecast: No description available. ,
Budget: No description available. ,
}
,
Required: False ,
}
enum ,
id:
{
Description: ID of resource related to metric (budget). ,
Required: False ,
}
string ,
enabled:
{
Description: show the KPI in the UI? ,
Required: False ,
}
boolean ,
}
,
]
,
pivots:
{
Description: Configuration of 3 sub-views in the Cost Analysis UI. ,
Required: False ,
}
[
{
type:
{
Description: Data type to show in view. ,
Enum:
{
Dimension: No description available. ,
TagKey: No description available. ,
}
,
Required: False ,
}
enum ,
name:
{
Description: Data field to show in view. ,
Required: False ,
}
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: A machine readable error code. ,
Required: False ,
}
string ,
message:
{
Description: A human readable error message. ,
Required: False ,
}
string ,
target:
{
Description: Indicates which property in the request is responsible for the error. ,
Required: False ,
}
string ,
details:
{
Description: error details. ,
Required: False ,
}
[
{
code:
{
Description: A machine readable error code. ,
Required: False ,
}
string ,
message:
{
Description: A human readable error message. ,
Required: False ,
}
string ,
target:
{
Description: Indicates which property in the request is responsible for the error. ,
Required: False ,
}
string ,
}
,
]
,
}
,
}
Views_Get (removed)
Description :  Gets the view by view name.
Reference :  Link ¶

⚼ Request

GET:  /providers/Microsoft.CostManagement/views/{viewName}
{
api-version:
{
Description: Version of the API to be used with the client request. The current version is 2019-04-01-preview ,
Required: True ,
}
string ,
viewName:
{
Description: View name ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
properties:
{
Description: The properties of the view. ,
Required: False ,
}
{
displayName:
{
Description: User input name of the view. Required. ,
Required: False ,
}
string ,
scope:
{
Description: Cost Management scope to save the view on. This includes 'subscriptions/{subscriptionId}' for subscription scope, 'subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}' for resourceGroup scope, 'providers/Microsoft.Billing/billingAccounts/{billingAccountId}' for Billing Account scope, 'providers/Microsoft.Billing/billingAccounts/{billingAccountId}/departments/{departmentId}' for Department scope, 'providers/Microsoft.Billing/billingAccounts/{billingAccountId}/enrollmentAccounts/{enrollmentAccountId}' for EnrollmentAccount scope, 'providers/Microsoft.Billing/billingAccounts/{billingAccountId}/billingProfiles/{billingProfileId}' for BillingProfile scope, 'providers/Microsoft.Billing/billingAccounts/{billingAccountId}/invoiceSections/{invoiceSectionId}' for InvoiceSection scope, 'providers/Microsoft.Management/managementGroups/{managementGroupId}' for Management Group scope, '/providers/Microsoft.CostManagement/externalBillingAccounts/{externalBillingAccountName}' for ExternalBillingAccount scope, and '/providers/Microsoft.CostManagement/externalSubscriptions/{externalSubscriptionName}' for ExternalSubscription scope. ,
Required: False ,
}
string ,
createdOn:
{
Description: Date the user created this view. ,
Format: date-time ,
Required: False ,
}
string ,
modifiedOn:
{
Description: Date when the user last modified this view. ,
Format: date-time ,
Required: False ,
}
string ,
query:
{
Description: Query body configuration. Required. ,
Required: False ,
}
{
type:
{
Description: The type of the report. Usage represents actual usage, forecast represents forecasted data and UsageAndForecast represents both usage and forecasted data. Actual usage and forecasted data can be differentiated based on dates. ,
Enum:
{
Usage: No description available. ,
}
,
Required: True ,
}
enum ,
timeframe:
{
Description: The time frame for pulling data for the report. If custom, then a specific time period must be provided. ,
Enum:
{
WeekToDate: No description available. ,
MonthToDate: No description available. ,
YearToDate: No description available. ,
Custom: No description available. ,
}
,
Required: True ,
}
enum ,
timePeriod:
{
Description: Has time period for pulling data for the report. ,
Required: False ,
}
{
from:
{
Description: The start date to pull data from. ,
Format: date-time ,
Required: True ,
}
string ,
to:
{
Description: The end date to pull data to. ,
Format: date-time ,
Required: True ,
}
string ,
}
,
dataset:
{
Description: Has definition for data in this report config. ,
Required: False ,
}
{
granularity:
{
Description: The granularity of rows in the report. ,
Enum:
{
Daily: No description available. ,
Monthly: No description available. ,
}
,
Required: False ,
}
enum ,
configuration:
{
Description: Has configuration information for the data in the report. The configuration will be ignored if aggregation and grouping are provided. ,
Required: False ,
}
{
columns:
{
Description: Array of column names to be included in the report. Any valid report column name is allowed. If not provided, then report includes all columns. ,
Required: False ,
}
[
string ,
]
,
}
,
aggregation:
{
Description: Dictionary of aggregation expression to use in the report. The key of each item in the dictionary is the alias for the aggregated column. Report can have up to 2 aggregation clauses. ,
Required: False ,
}
object ,
grouping:
{
Description: Array of group by expression to use in the report. Report can have up to 2 group by clauses. ,
Required: False ,
}
[
{
type:
{
Description: Has type of the column to group. ,
Enum:
{
Tag: No description available. ,
Dimension: No description available. ,
}
,
Required: True ,
}
enum ,
name:
{
Description: The name of the column to group. This version supports subscription lowest possible grain. ,
Required: True ,
}
string ,
}
,
]
,
sorting:
{
Description: Array of order by expression to use in the report. ,
Required: False ,
}
[
{
direction:
{
Description: Direction of sort. ,
Enum:
{
Ascending: No description available. ,
Descending: No description available. ,
}
,
Required: False ,
}
enum ,
name:
{
Description: The name of the column to sort. ,
Required: True ,
}
string ,
}
,
]
,
filter:
{
Description: Has filter expression to use in the report. ,
Required: False ,
}
{
and:
{
Description: The logical "AND" expression. Must have at least 2 items. ,
Required: False ,
}
[
string ,
]
,
or:
{
Description: The logical "OR" expression. Must have at least 2 items. ,
Required: False ,
}
[
string ,
]
,
not:
{
Required: False ,
}
string ,
dimension:
{
Description: Has comparison expression for a dimension ,
Required: False ,
}
{
name:
{
Description: The name of the column to use in comparison. ,
Required: True ,
}
string ,
operator:
{
Description: The operator to use for comparison. ,
Enum:
{
In: No description available. ,
Contains: No description available. ,
}
,
Required: True ,
}
enum ,
values:
{
Description: Array of values to use for comparison ,
Required: True ,
}
[
string ,
]
,
}
,
tag:
{
Description: Has comparison expression for a tag ,
Required: False ,
}
{
name:
{
Description: The name of the column to use in comparison. ,
Required: True ,
}
string ,
operator:
{
Description: The operator to use for comparison. ,
Enum:
{
In: No description available. ,
Contains: No description available. ,
}
,
Required: True ,
}
enum ,
values:
{
Description: Array of values to use for comparison ,
Required: True ,
}
[
string ,
]
,
}
,
}
,
}
,
}
,
chart:
{
Description: Chart type of the main view in Cost Analysis. Required. ,
Enum:
{
Area: No description available. ,
Line: No description available. ,
StackedColumn: No description available. ,
GroupedColumn: No description available. ,
Table: No description available. ,
}
,
Required: False ,
}
enum ,
accumulated:
{
Description: Show costs accumulated over time. ,
Enum:
{
true: No description available. ,
false: No description available. ,
}
,
Required: False ,
}
enum ,
metric:
{
Description: Metric to use when displaying costs. ,
Enum:
{
ActualCost: No description available. ,
AmortizedCost: No description available. ,
AHUB: No description available. ,
}
,
Required: False ,
}
enum ,
kpis:
{
Description: List of KPIs to show in Cost Analysis UI. ,
Required: False ,
}
[
{
type:
{
Description: KPI type (Forecast, Budget). ,
Enum:
{
Forecast: No description available. ,
Budget: No description available. ,
}
,
Required: False ,
}
enum ,
id:
{
Description: ID of resource related to metric (budget). ,
Required: False ,
}
string ,
enabled:
{
Description: show the KPI in the UI? ,
Required: False ,
}
boolean ,
}
,
]
,
pivots:
{
Description: Configuration of 3 sub-views in the Cost Analysis UI. ,
Required: False ,
}
[
{
type:
{
Description: Data type to show in view. ,
Enum:
{
Dimension: No description available. ,
TagKey: No description available. ,
}
,
Required: False ,
}
enum ,
name:
{
Description: Data field to show in view. ,
Required: False ,
}
string ,
}
,
]
,
}
,
}

⚐ Response (default)

{
error:
{
Description: The details of the error. ,
Required: False ,
}
{
code:
{
Description: A machine readable error code. ,
Required: False ,
}
string ,
message:
{
Description: A human readable error message. ,
Required: False ,
}
string ,
target:
{
Description: Indicates which property in the request is responsible for the error. ,
Required: False ,
}
string ,
details:
{
Description: error details. ,
Required: False ,
}
[
{
code:
{
Description: A machine readable error code. ,
Required: False ,
}
string ,
message:
{
Description: A human readable error message. ,
Required: False ,
}
string ,
target:
{
Description: Indicates which property in the request is responsible for the error. ,
Required: False ,
}
string ,
}
,
]
,
}
,
}
Views_CreateOrUpdate (removed)
Description :  The operation to create or update a view. Update operation requires latest eTag to be set in the request. You may obtain the latest eTag by performing a get operation. Create operation does not require eTag.
Reference :  Link ¶

⚼ Request

PUT:  /providers/Microsoft.CostManagement/views/{viewName}
{
api-version:
{
Description: Version of the API to be used with the client request. The current version is 2019-04-01-preview ,
Required: True ,
}
string ,
viewName:
{
Description: View name ,
Required: True ,
}
string ,
parameters:
{
Description: Parameters supplied to the CreateOrUpdate View operation. ,
Required: True ,
}
{
properties:
{
Description: The properties of the view. ,
Required: False ,
}
{
displayName:
{
Description: User input name of the view. Required. ,
Required: False ,
}
string ,
scope:
{
Description: Cost Management scope to save the view on. This includes 'subscriptions/{subscriptionId}' for subscription scope, 'subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}' for resourceGroup scope, 'providers/Microsoft.Billing/billingAccounts/{billingAccountId}' for Billing Account scope, 'providers/Microsoft.Billing/billingAccounts/{billingAccountId}/departments/{departmentId}' for Department scope, 'providers/Microsoft.Billing/billingAccounts/{billingAccountId}/enrollmentAccounts/{enrollmentAccountId}' for EnrollmentAccount scope, 'providers/Microsoft.Billing/billingAccounts/{billingAccountId}/billingProfiles/{billingProfileId}' for BillingProfile scope, 'providers/Microsoft.Billing/billingAccounts/{billingAccountId}/invoiceSections/{invoiceSectionId}' for InvoiceSection scope, 'providers/Microsoft.Management/managementGroups/{managementGroupId}' for Management Group scope, '/providers/Microsoft.CostManagement/externalBillingAccounts/{externalBillingAccountName}' for ExternalBillingAccount scope, and '/providers/Microsoft.CostManagement/externalSubscriptions/{externalSubscriptionName}' for ExternalSubscription scope. ,
Required: False ,
}
string ,
createdOn:
{
Description: Date the user created this view. ,
Format: date-time ,
Required: False ,
}
string ,
modifiedOn:
{
Description: Date when the user last modified this view. ,
Format: date-time ,
Required: False ,
}
string ,
query:
{
Description: Query body configuration. Required. ,
Required: False ,
}
{
type:
{
Description: The type of the report. Usage represents actual usage, forecast represents forecasted data and UsageAndForecast represents both usage and forecasted data. Actual usage and forecasted data can be differentiated based on dates. ,
Enum:
{
Usage: No description available. ,
}
,
Required: True ,
}
enum ,
timeframe:
{
Description: The time frame for pulling data for the report. If custom, then a specific time period must be provided. ,
Enum:
{
WeekToDate: No description available. ,
MonthToDate: No description available. ,
YearToDate: No description available. ,
Custom: No description available. ,
}
,
Required: True ,
}
enum ,
timePeriod:
{
Description: Has time period for pulling data for the report. ,
Required: False ,
}
{
from:
{
Description: The start date to pull data from. ,
Format: date-time ,
Required: True ,
}
string ,
to:
{
Description: The end date to pull data to. ,
Format: date-time ,
Required: True ,
}
string ,
}
,
dataset:
{
Description: Has definition for data in this report config. ,
Required: False ,
}
{
granularity:
{
Description: The granularity of rows in the report. ,
Enum:
{
Daily: No description available. ,
Monthly: No description available. ,
}
,
Required: False ,
}
enum ,
configuration:
{
Description: Has configuration information for the data in the report. The configuration will be ignored if aggregation and grouping are provided. ,
Required: False ,
}
{
columns:
{
Description: Array of column names to be included in the report. Any valid report column name is allowed. If not provided, then report includes all columns. ,
Required: False ,
}
[
string ,
]
,
}
,
aggregation:
{
Description: Dictionary of aggregation expression to use in the report. The key of each item in the dictionary is the alias for the aggregated column. Report can have up to 2 aggregation clauses. ,
Required: False ,
}
object ,
grouping:
{
Description: Array of group by expression to use in the report. Report can have up to 2 group by clauses. ,
Required: False ,
}
[
{
type:
{
Description: Has type of the column to group. ,
Enum:
{
Tag: No description available. ,
Dimension: No description available. ,
}
,
Required: True ,
}
enum ,
name:
{
Description: The name of the column to group. This version supports subscription lowest possible grain. ,
Required: True ,
}
string ,
}
,
]
,
sorting:
{
Description: Array of order by expression to use in the report. ,
Required: False ,
}
[
{
direction:
{
Description: Direction of sort. ,
Enum:
{
Ascending: No description available. ,
Descending: No description available. ,
}
,
Required: False ,
}
enum ,
name:
{
Description: The name of the column to sort. ,
Required: True ,
}
string ,
}
,
]
,
filter:
{
Description: Has filter expression to use in the report. ,
Required: False ,
}
{
and:
{
Description: The logical "AND" expression. Must have at least 2 items. ,
Required: False ,
}
[
string ,
]
,
or:
{
Description: The logical "OR" expression. Must have at least 2 items. ,
Required: False ,
}
[
string ,
]
,
not:
{
Required: False ,
}
string ,
dimension:
{
Description: Has comparison expression for a dimension ,
Required: False ,
}
{
name:
{
Description: The name of the column to use in comparison. ,
Required: True ,
}
string ,
operator:
{
Description: The operator to use for comparison. ,
Enum:
{
In: No description available. ,
Contains: No description available. ,
}
,
Required: True ,
}
enum ,
values:
{
Description: Array of values to use for comparison ,
Required: True ,
}
[
string ,
]
,
}
,
tag:
{
Description: Has comparison expression for a tag ,
Required: False ,
}
{
name:
{
Description: The name of the column to use in comparison. ,
Required: True ,
}
string ,
operator:
{
Description: The operator to use for comparison. ,
Enum:
{
In: No description available. ,
Contains: No description available. ,
}
,
Required: True ,
}
enum ,
values:
{
Description: Array of values to use for comparison ,
Required: True ,
}
[
string ,
]
,
}
,
}
,
}
,
}
,
chart:
{
Description: Chart type of the main view in Cost Analysis. Required. ,
Enum:
{
Area: No description available. ,
Line: No description available. ,
StackedColumn: No description available. ,
GroupedColumn: No description available. ,
Table: No description available. ,
}
,
Required: False ,
}
enum ,
accumulated:
{
Description: Show costs accumulated over time. ,
Enum:
{
true: No description available. ,
false: No description available. ,
}
,
Required: False ,
}
enum ,
metric:
{
Description: Metric to use when displaying costs. ,
Enum:
{
ActualCost: No description available. ,
AmortizedCost: No description available. ,
AHUB: No description available. ,
}
,
Required: False ,
}
enum ,
kpis:
{
Description: List of KPIs to show in Cost Analysis UI. ,
Required: False ,
}
[
{
type:
{
Description: KPI type (Forecast, Budget). ,
Enum:
{
Forecast: No description available. ,
Budget: No description available. ,
}
,
Required: False ,
}
enum ,
id:
{
Description: ID of resource related to metric (budget). ,
Required: False ,
}
string ,
enabled:
{
Description: show the KPI in the UI? ,
Required: False ,
}
boolean ,
}
,
]
,
pivots:
{
Description: Configuration of 3 sub-views in the Cost Analysis UI. ,
Required: False ,
}
[
{
type:
{
Description: Data type to show in view. ,
Enum:
{
Dimension: No description available. ,
TagKey: No description available. ,
}
,
Required: False ,
}
enum ,
name:
{
Description: Data field to show in view. ,
Required: False ,
}
string ,
}
,
]
,
}
,
}
,
}

⚐ Response (200)

{
properties:
{
Description: The properties of the view. ,
Required: False ,
}
{
displayName:
{
Description: User input name of the view. Required. ,
Required: False ,
}
string ,
scope:
{
Description: Cost Management scope to save the view on. This includes 'subscriptions/{subscriptionId}' for subscription scope, 'subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}' for resourceGroup scope, 'providers/Microsoft.Billing/billingAccounts/{billingAccountId}' for Billing Account scope, 'providers/Microsoft.Billing/billingAccounts/{billingAccountId}/departments/{departmentId}' for Department scope, 'providers/Microsoft.Billing/billingAccounts/{billingAccountId}/enrollmentAccounts/{enrollmentAccountId}' for EnrollmentAccount scope, 'providers/Microsoft.Billing/billingAccounts/{billingAccountId}/billingProfiles/{billingProfileId}' for BillingProfile scope, 'providers/Microsoft.Billing/billingAccounts/{billingAccountId}/invoiceSections/{invoiceSectionId}' for InvoiceSection scope, 'providers/Microsoft.Management/managementGroups/{managementGroupId}' for Management Group scope, '/providers/Microsoft.CostManagement/externalBillingAccounts/{externalBillingAccountName}' for ExternalBillingAccount scope, and '/providers/Microsoft.CostManagement/externalSubscriptions/{externalSubscriptionName}' for ExternalSubscription scope. ,
Required: False ,
}
string ,
createdOn:
{
Description: Date the user created this view. ,
Format: date-time ,
Required: False ,
}
string ,
modifiedOn:
{
Description: Date when the user last modified this view. ,
Format: date-time ,
Required: False ,
}
string ,
query:
{
Description: Query body configuration. Required. ,
Required: False ,
}
{
type:
{
Description: The type of the report. Usage represents actual usage, forecast represents forecasted data and UsageAndForecast represents both usage and forecasted data. Actual usage and forecasted data can be differentiated based on dates. ,
Enum:
{
Usage: No description available. ,
}
,
Required: True ,
}
enum ,
timeframe:
{
Description: The time frame for pulling data for the report. If custom, then a specific time period must be provided. ,
Enum:
{
WeekToDate: No description available. ,
MonthToDate: No description available. ,
YearToDate: No description available. ,
Custom: No description available. ,
}
,
Required: True ,
}
enum ,
timePeriod:
{
Description: Has time period for pulling data for the report. ,
Required: False ,
}
{
from:
{
Description: The start date to pull data from. ,
Format: date-time ,
Required: True ,
}
string ,
to:
{
Description: The end date to pull data to. ,
Format: date-time ,
Required: True ,
}
string ,
}
,
dataset:
{
Description: Has definition for data in this report config. ,
Required: False ,
}
{
granularity:
{
Description: The granularity of rows in the report. ,
Enum:
{
Daily: No description available. ,
Monthly: No description available. ,
}
,
Required: False ,
}
enum ,
configuration:
{
Description: Has configuration information for the data in the report. The configuration will be ignored if aggregation and grouping are provided. ,
Required: False ,
}
{
columns:
{
Description: Array of column names to be included in the report. Any valid report column name is allowed. If not provided, then report includes all columns. ,
Required: False ,
}
[
string ,
]
,
}
,
aggregation:
{
Description: Dictionary of aggregation expression to use in the report. The key of each item in the dictionary is the alias for the aggregated column. Report can have up to 2 aggregation clauses. ,
Required: False ,
}
object ,
grouping:
{
Description: Array of group by expression to use in the report. Report can have up to 2 group by clauses. ,
Required: False ,
}
[
{
type:
{
Description: Has type of the column to group. ,
Enum:
{
Tag: No description available. ,
Dimension: No description available. ,
}
,
Required: True ,
}
enum ,
name:
{
Description: The name of the column to group. This version supports subscription lowest possible grain. ,
Required: True ,
}
string ,
}
,
]
,
sorting:
{
Description: Array of order by expression to use in the report. ,
Required: False ,
}
[
{
direction:
{
Description: Direction of sort. ,
Enum:
{
Ascending: No description available. ,
Descending: No description available. ,
}
,
Required: False ,
}
enum ,
name:
{
Description: The name of the column to sort. ,
Required: True ,
}
string ,
}
,
]
,
filter:
{
Description: Has filter expression to use in the report. ,
Required: False ,
}
{
and:
{
Description: The logical "AND" expression. Must have at least 2 items. ,
Required: False ,
}
[
string ,
]
,
or:
{
Description: The logical "OR" expression. Must have at least 2 items. ,
Required: False ,
}
[
string ,
]
,
not:
{
Required: False ,
}
string ,
dimension:
{
Description: Has comparison expression for a dimension ,
Required: False ,
}
{
name:
{
Description: The name of the column to use in comparison. ,
Required: True ,
}
string ,
operator:
{
Description: The operator to use for comparison. ,
Enum:
{
In: No description available. ,
Contains: No description available. ,
}
,
Required: True ,
}
enum ,
values:
{
Description: Array of values to use for comparison ,
Required: True ,
}
[
string ,
]
,
}
,
tag:
{
Description: Has comparison expression for a tag ,
Required: False ,
}
{
name:
{
Description: The name of the column to use in comparison. ,
Required: True ,
}
string ,
operator:
{
Description: The operator to use for comparison. ,
Enum:
{
In: No description available. ,
Contains: No description available. ,
}
,
Required: True ,
}
enum ,
values:
{
Description: Array of values to use for comparison ,
Required: True ,
}
[
string ,
]
,
}
,
}
,
}
,
}
,
chart:
{
Description: Chart type of the main view in Cost Analysis. Required. ,
Enum:
{
Area: No description available. ,
Line: No description available. ,
StackedColumn: No description available. ,
GroupedColumn: No description available. ,
Table: No description available. ,
}
,
Required: False ,
}
enum ,
accumulated:
{
Description: Show costs accumulated over time. ,
Enum:
{
true: No description available. ,
false: No description available. ,
}
,
Required: False ,
}
enum ,
metric:
{
Description: Metric to use when displaying costs. ,
Enum:
{
ActualCost: No description available. ,
AmortizedCost: No description available. ,
AHUB: No description available. ,
}
,
Required: False ,
}
enum ,
kpis:
{
Description: List of KPIs to show in Cost Analysis UI. ,
Required: False ,
}
[
{
type:
{
Description: KPI type (Forecast, Budget). ,
Enum:
{
Forecast: No description available. ,
Budget: No description available. ,
}
,
Required: False ,
}
enum ,
id:
{
Description: ID of resource related to metric (budget). ,
Required: False ,
}
string ,
enabled:
{
Description: show the KPI in the UI? ,
Required: False ,
}
boolean ,
}
,
]
,
pivots:
{
Description: Configuration of 3 sub-views in the Cost Analysis UI. ,
Required: False ,
}
[
{
type:
{
Description: Data type to show in view. ,
Enum:
{
Dimension: No description available. ,
TagKey: No description available. ,
}
,
Required: False ,
}
enum ,
name:
{
Description: Data field to show in view. ,
Required: False ,
}
string ,
}
,
]
,
}
,
}

⚐ Response (201)

{
properties:
{
Description: The properties of the view. ,
Required: False ,
}
{
displayName:
{
Description: User input name of the view. Required. ,
Required: False ,
}
string ,
scope:
{
Description: Cost Management scope to save the view on. This includes 'subscriptions/{subscriptionId}' for subscription scope, 'subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}' for resourceGroup scope, 'providers/Microsoft.Billing/billingAccounts/{billingAccountId}' for Billing Account scope, 'providers/Microsoft.Billing/billingAccounts/{billingAccountId}/departments/{departmentId}' for Department scope, 'providers/Microsoft.Billing/billingAccounts/{billingAccountId}/enrollmentAccounts/{enrollmentAccountId}' for EnrollmentAccount scope, 'providers/Microsoft.Billing/billingAccounts/{billingAccountId}/billingProfiles/{billingProfileId}' for BillingProfile scope, 'providers/Microsoft.Billing/billingAccounts/{billingAccountId}/invoiceSections/{invoiceSectionId}' for InvoiceSection scope, 'providers/Microsoft.Management/managementGroups/{managementGroupId}' for Management Group scope, '/providers/Microsoft.CostManagement/externalBillingAccounts/{externalBillingAccountName}' for ExternalBillingAccount scope, and '/providers/Microsoft.CostManagement/externalSubscriptions/{externalSubscriptionName}' for ExternalSubscription scope. ,
Required: False ,
}
string ,
createdOn:
{
Description: Date the user created this view. ,
Format: date-time ,
Required: False ,
}
string ,
modifiedOn:
{
Description: Date when the user last modified this view. ,
Format: date-time ,
Required: False ,
}
string ,
query:
{
Description: Query body configuration. Required. ,
Required: False ,
}
{
type:
{
Description: The type of the report. Usage represents actual usage, forecast represents forecasted data and UsageAndForecast represents both usage and forecasted data. Actual usage and forecasted data can be differentiated based on dates. ,
Enum:
{
Usage: No description available. ,
}
,
Required: True ,
}
enum ,
timeframe:
{
Description: The time frame for pulling data for the report. If custom, then a specific time period must be provided. ,
Enum:
{
WeekToDate: No description available. ,
MonthToDate: No description available. ,
YearToDate: No description available. ,
Custom: No description available. ,
}
,
Required: True ,
}
enum ,
timePeriod:
{
Description: Has time period for pulling data for the report. ,
Required: False ,
}
{
from:
{
Description: The start date to pull data from. ,
Format: date-time ,
Required: True ,
}
string ,
to:
{
Description: The end date to pull data to. ,
Format: date-time ,
Required: True ,
}
string ,
}
,
dataset:
{
Description: Has definition for data in this report config. ,
Required: False ,
}
{
granularity:
{
Description: The granularity of rows in the report. ,
Enum:
{
Daily: No description available. ,
Monthly: No description available. ,
}
,
Required: False ,
}
enum ,
configuration:
{
Description: Has configuration information for the data in the report. The configuration will be ignored if aggregation and grouping are provided. ,
Required: False ,
}
{
columns:
{
Description: Array of column names to be included in the report. Any valid report column name is allowed. If not provided, then report includes all columns. ,
Required: False ,
}
[
string ,
]
,
}
,
aggregation:
{
Description: Dictionary of aggregation expression to use in the report. The key of each item in the dictionary is the alias for the aggregated column. Report can have up to 2 aggregation clauses. ,
Required: False ,
}
object ,
grouping:
{
Description: Array of group by expression to use in the report. Report can have up to 2 group by clauses. ,
Required: False ,
}
[
{
type:
{
Description: Has type of the column to group. ,
Enum:
{
Tag: No description available. ,
Dimension: No description available. ,
}
,
Required: True ,
}
enum ,
name:
{
Description: The name of the column to group. This version supports subscription lowest possible grain. ,
Required: True ,
}
string ,
}
,
]
,
sorting:
{
Description: Array of order by expression to use in the report. ,
Required: False ,
}
[
{
direction:
{
Description: Direction of sort. ,
Enum:
{
Ascending: No description available. ,
Descending: No description available. ,
}
,
Required: False ,
}
enum ,
name:
{
Description: The name of the column to sort. ,
Required: True ,
}
string ,
}
,
]
,
filter:
{
Description: Has filter expression to use in the report. ,
Required: False ,
}
{
and:
{
Description: The logical "AND" expression. Must have at least 2 items. ,
Required: False ,
}
[
string ,
]
,
or:
{
Description: The logical "OR" expression. Must have at least 2 items. ,
Required: False ,
}
[
string ,
]
,
not:
{
Required: False ,
}
string ,
dimension:
{
Description: Has comparison expression for a dimension ,
Required: False ,
}
{
name:
{
Description: The name of the column to use in comparison. ,
Required: True ,
}
string ,
operator:
{
Description: The operator to use for comparison. ,
Enum:
{
In: No description available. ,
Contains: No description available. ,
}
,
Required: True ,
}
enum ,
values:
{
Description: Array of values to use for comparison ,
Required: True ,
}
[
string ,
]
,
}
,
tag:
{
Description: Has comparison expression for a tag ,
Required: False ,
}
{
name:
{
Description: The name of the column to use in comparison. ,
Required: True ,
}
string ,
operator:
{
Description: The operator to use for comparison. ,
Enum:
{
In: No description available. ,
Contains: No description available. ,
}
,
Required: True ,
}
enum ,
values:
{
Description: Array of values to use for comparison ,
Required: True ,
}
[
string ,
]
,
}
,
}
,
}
,
}
,
chart:
{
Description: Chart type of the main view in Cost Analysis. Required. ,
Enum:
{
Area: No description available. ,
Line: No description available. ,
StackedColumn: No description available. ,
GroupedColumn: No description available. ,
Table: No description available. ,
}
,
Required: False ,
}
enum ,
accumulated:
{
Description: Show costs accumulated over time. ,
Enum:
{
true: No description available. ,
false: No description available. ,
}
,
Required: False ,
}
enum ,
metric:
{
Description: Metric to use when displaying costs. ,
Enum:
{
ActualCost: No description available. ,
AmortizedCost: No description available. ,
AHUB: No description available. ,
}
,
Required: False ,
}
enum ,
kpis:
{
Description: List of KPIs to show in Cost Analysis UI. ,
Required: False ,
}
[
{
type:
{
Description: KPI type (Forecast, Budget). ,
Enum:
{
Forecast: No description available. ,
Budget: No description available. ,
}
,
Required: False ,
}
enum ,
id:
{
Description: ID of resource related to metric (budget). ,
Required: False ,
}
string ,
enabled:
{
Description: show the KPI in the UI? ,
Required: False ,
}
boolean ,
}
,
]
,
pivots:
{
Description: Configuration of 3 sub-views in the Cost Analysis UI. ,
Required: False ,
}
[
{
type:
{
Description: Data type to show in view. ,
Enum:
{
Dimension: No description available. ,
TagKey: No description available. ,
}
,
Required: False ,
}
enum ,
name:
{
Description: Data field to show in view. ,
Required: False ,
}
string ,
}
,
]
,
}
,
}

⚐ Response (default)

{
error:
{
Description: The details of the error. ,
Required: False ,
}
{
code:
{
Description: A machine readable error code. ,
Required: False ,
}
string ,
message:
{
Description: A human readable error message. ,
Required: False ,
}
string ,
target:
{
Description: Indicates which property in the request is responsible for the error. ,
Required: False ,
}
string ,
details:
{
Description: error details. ,
Required: False ,
}
[
{
code:
{
Description: A machine readable error code. ,
Required: False ,
}
string ,
message:
{
Description: A human readable error message. ,
Required: False ,
}
string ,
target:
{
Description: Indicates which property in the request is responsible for the error. ,
Required: False ,
}
string ,
}
,
]
,
}
,
}
Views_Delete (removed)
Description :  The operation to delete a view.
Reference :  Link ¶

⚼ Request

DELETE:  /providers/Microsoft.CostManagement/views/{viewName}
{
api-version:
{
Description: Version of the API to be used with the client request. The current version is 2019-04-01-preview ,
Required: True ,
}
string ,
viewName:
{
Description: View name ,
Required: True ,
}
string ,
}

⚐ Response (200)

{}

⚐ Response (204)

{}

⚐ Response (default)

{
error:
{
Description: The details of the error. ,
Required: False ,
}
{
code:
{
Description: A machine readable error code. ,
Required: False ,
}
string ,
message:
{
Description: A human readable error message. ,
Required: False ,
}
string ,
target:
{
Description: Indicates which property in the request is responsible for the error. ,
Required: False ,
}
string ,
details:
{
Description: error details. ,
Required: False ,
}
[
{
code:
{
Description: A machine readable error code. ,
Required: False ,
}
string ,
message:
{
Description: A human readable error message. ,
Required: False ,
}
string ,
target:
{
Description: Indicates which property in the request is responsible for the error. ,
Required: False ,
}
string ,
}
,
]
,
}
,
}
Views_GetByScope (removed)
Description :  Gets the view for the defined scope by view name.
Reference :  Link ¶

⚼ Request

GET:  /{scope}/providers/Microsoft.CostManagement/views/{viewName}
{
scope:
{
Description: The scope associated with view operations. This includes 'subscriptions/{subscriptionId}' for subscription scope, 'subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}' for resourceGroup scope, 'providers/Microsoft.Billing/billingAccounts/{billingAccountId}' for Billing Account scope, 'providers/Microsoft.Billing/billingAccounts/{billingAccountId}/departments/{departmentId}' for Department scope, 'providers/Microsoft.Billing/billingAccounts/{billingAccountId}/enrollmentAccounts/{enrollmentAccountId}' for EnrollmentAccount scope, 'providers/Microsoft.Billing/billingAccounts/{billingAccountId}/billingProfiles/{billingProfileId}' for BillingProfile scope, 'providers/Microsoft.Billing/billingAccounts/{billingAccountId}/invoiceSections/{invoiceSectionId}' for InvoiceSection scope, 'providers/Microsoft.Management/managementGroups/{managementGroupId}' for Management Group scope, 'providers/Microsoft.CostManagement/externalBillingAccounts/{externalBillingAccountName}' for External Billing Account scope and 'providers/Microsoft.CostManagement/externalSubscriptions/{externalSubscriptionName}' for External Subscription scope. ,
Required: True ,
}
string ,
api-version:
{
Description: Version of the API to be used with the client request. The current version is 2019-04-01-preview ,
Required: True ,
}
string ,
viewName:
{
Description: View name ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
properties:
{
Description: The properties of the view. ,
Required: False ,
}
{
displayName:
{
Description: User input name of the view. Required. ,
Required: False ,
}
string ,
scope:
{
Description: Cost Management scope to save the view on. This includes 'subscriptions/{subscriptionId}' for subscription scope, 'subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}' for resourceGroup scope, 'providers/Microsoft.Billing/billingAccounts/{billingAccountId}' for Billing Account scope, 'providers/Microsoft.Billing/billingAccounts/{billingAccountId}/departments/{departmentId}' for Department scope, 'providers/Microsoft.Billing/billingAccounts/{billingAccountId}/enrollmentAccounts/{enrollmentAccountId}' for EnrollmentAccount scope, 'providers/Microsoft.Billing/billingAccounts/{billingAccountId}/billingProfiles/{billingProfileId}' for BillingProfile scope, 'providers/Microsoft.Billing/billingAccounts/{billingAccountId}/invoiceSections/{invoiceSectionId}' for InvoiceSection scope, 'providers/Microsoft.Management/managementGroups/{managementGroupId}' for Management Group scope, '/providers/Microsoft.CostManagement/externalBillingAccounts/{externalBillingAccountName}' for ExternalBillingAccount scope, and '/providers/Microsoft.CostManagement/externalSubscriptions/{externalSubscriptionName}' for ExternalSubscription scope. ,
Required: False ,
}
string ,
createdOn:
{
Description: Date the user created this view. ,
Format: date-time ,
Required: False ,
}
string ,
modifiedOn:
{
Description: Date when the user last modified this view. ,
Format: date-time ,
Required: False ,
}
string ,
query:
{
Description: Query body configuration. Required. ,
Required: False ,
}
{
type:
{
Description: The type of the report. Usage represents actual usage, forecast represents forecasted data and UsageAndForecast represents both usage and forecasted data. Actual usage and forecasted data can be differentiated based on dates. ,
Enum:
{
Usage: No description available. ,
}
,
Required: True ,
}
enum ,
timeframe:
{
Description: The time frame for pulling data for the report. If custom, then a specific time period must be provided. ,
Enum:
{
WeekToDate: No description available. ,
MonthToDate: No description available. ,
YearToDate: No description available. ,
Custom: No description available. ,
}
,
Required: True ,
}
enum ,
timePeriod:
{
Description: Has time period for pulling data for the report. ,
Required: False ,
}
{
from:
{
Description: The start date to pull data from. ,
Format: date-time ,
Required: True ,
}
string ,
to:
{
Description: The end date to pull data to. ,
Format: date-time ,
Required: True ,
}
string ,
}
,
dataset:
{
Description: Has definition for data in this report config. ,
Required: False ,
}
{
granularity:
{
Description: The granularity of rows in the report. ,
Enum:
{
Daily: No description available. ,
Monthly: No description available. ,
}
,
Required: False ,
}
enum ,
configuration:
{
Description: Has configuration information for the data in the report. The configuration will be ignored if aggregation and grouping are provided. ,
Required: False ,
}
{
columns:
{
Description: Array of column names to be included in the report. Any valid report column name is allowed. If not provided, then report includes all columns. ,
Required: False ,
}
[
string ,
]
,
}
,
aggregation:
{
Description: Dictionary of aggregation expression to use in the report. The key of each item in the dictionary is the alias for the aggregated column. Report can have up to 2 aggregation clauses. ,
Required: False ,
}
object ,
grouping:
{
Description: Array of group by expression to use in the report. Report can have up to 2 group by clauses. ,
Required: False ,
}
[
{
type:
{
Description: Has type of the column to group. ,
Enum:
{
Tag: No description available. ,
Dimension: No description available. ,
}
,
Required: True ,
}
enum ,
name:
{
Description: The name of the column to group. This version supports subscription lowest possible grain. ,
Required: True ,
}
string ,
}
,
]
,
sorting:
{
Description: Array of order by expression to use in the report. ,
Required: False ,
}
[
{
direction:
{
Description: Direction of sort. ,
Enum:
{
Ascending: No description available. ,
Descending: No description available. ,
}
,
Required: False ,
}
enum ,
name:
{
Description: The name of the column to sort. ,
Required: True ,
}
string ,
}
,
]
,
filter:
{
Description: Has filter expression to use in the report. ,
Required: False ,
}
{
and:
{
Description: The logical "AND" expression. Must have at least 2 items. ,
Required: False ,
}
[
string ,
]
,
or:
{
Description: The logical "OR" expression. Must have at least 2 items. ,
Required: False ,
}
[
string ,
]
,
not:
{
Required: False ,
}
string ,
dimension:
{
Description: Has comparison expression for a dimension ,
Required: False ,
}
{
name:
{
Description: The name of the column to use in comparison. ,
Required: True ,
}
string ,
operator:
{
Description: The operator to use for comparison. ,
Enum:
{
In: No description available. ,
Contains: No description available. ,
}
,
Required: True ,
}
enum ,
values:
{
Description: Array of values to use for comparison ,
Required: True ,
}
[
string ,
]
,
}
,
tag:
{
Description: Has comparison expression for a tag ,
Required: False ,
}
{
name:
{
Description: The name of the column to use in comparison. ,
Required: True ,
}
string ,
operator:
{
Description: The operator to use for comparison. ,
Enum:
{
In: No description available. ,
Contains: No description available. ,
}
,
Required: True ,
}
enum ,
values:
{
Description: Array of values to use for comparison ,
Required: True ,
}
[
string ,
]
,
}
,
}
,
}
,
}
,
chart:
{
Description: Chart type of the main view in Cost Analysis. Required. ,
Enum:
{
Area: No description available. ,
Line: No description available. ,
StackedColumn: No description available. ,
GroupedColumn: No description available. ,
Table: No description available. ,
}
,
Required: False ,
}
enum ,
accumulated:
{
Description: Show costs accumulated over time. ,
Enum:
{
true: No description available. ,
false: No description available. ,
}
,
Required: False ,
}
enum ,
metric:
{
Description: Metric to use when displaying costs. ,
Enum:
{
ActualCost: No description available. ,
AmortizedCost: No description available. ,
AHUB: No description available. ,
}
,
Required: False ,
}
enum ,
kpis:
{
Description: List of KPIs to show in Cost Analysis UI. ,
Required: False ,
}
[
{
type:
{
Description: KPI type (Forecast, Budget). ,
Enum:
{
Forecast: No description available. ,
Budget: No description available. ,
}
,
Required: False ,
}
enum ,
id:
{
Description: ID of resource related to metric (budget). ,
Required: False ,
}
string ,
enabled:
{
Description: show the KPI in the UI? ,
Required: False ,
}
boolean ,
}
,
]
,
pivots:
{
Description: Configuration of 3 sub-views in the Cost Analysis UI. ,
Required: False ,
}
[
{
type:
{
Description: Data type to show in view. ,
Enum:
{
Dimension: No description available. ,
TagKey: No description available. ,
}
,
Required: False ,
}
enum ,
name:
{
Description: Data field to show in view. ,
Required: False ,
}
string ,
}
,
]
,
}
,
}

⚐ Response (default)

{
error:
{
Description: The details of the error. ,
Required: False ,
}
{
code:
{
Description: A machine readable error code. ,
Required: False ,
}
string ,
message:
{
Description: A human readable error message. ,
Required: False ,
}
string ,
target:
{
Description: Indicates which property in the request is responsible for the error. ,
Required: False ,
}
string ,
details:
{
Description: error details. ,
Required: False ,
}
[
{
code:
{
Description: A machine readable error code. ,
Required: False ,
}
string ,
message:
{
Description: A human readable error message. ,
Required: False ,
}
string ,
target:
{
Description: Indicates which property in the request is responsible for the error. ,
Required: False ,
}
string ,
}
,
]
,
}
,
}
Views_CreateOrUpdateByScope (removed)
Description :  The operation to create or update a view. Update operation requires latest eTag to be set in the request. You may obtain the latest eTag by performing a get operation. Create operation does not require eTag.
Reference :  Link ¶

⚼ Request

PUT:  /{scope}/providers/Microsoft.CostManagement/views/{viewName}
{
scope:
{
Description: The scope associated with view operations. This includes 'subscriptions/{subscriptionId}' for subscription scope, 'subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}' for resourceGroup scope, 'providers/Microsoft.Billing/billingAccounts/{billingAccountId}' for Billing Account scope, 'providers/Microsoft.Billing/billingAccounts/{billingAccountId}/departments/{departmentId}' for Department scope, 'providers/Microsoft.Billing/billingAccounts/{billingAccountId}/enrollmentAccounts/{enrollmentAccountId}' for EnrollmentAccount scope, 'providers/Microsoft.Billing/billingAccounts/{billingAccountId}/billingProfiles/{billingProfileId}' for BillingProfile scope, 'providers/Microsoft.Billing/billingAccounts/{billingAccountId}/invoiceSections/{invoiceSectionId}' for InvoiceSection scope, 'providers/Microsoft.Management/managementGroups/{managementGroupId}' for Management Group scope, 'providers/Microsoft.CostManagement/externalBillingAccounts/{externalBillingAccountName}' for External Billing Account scope and 'providers/Microsoft.CostManagement/externalSubscriptions/{externalSubscriptionName}' for External Subscription scope. ,
Required: True ,
}
string ,
api-version:
{
Description: Version of the API to be used with the client request. The current version is 2019-04-01-preview ,
Required: True ,
}
string ,
viewName:
{
Description: View name ,
Required: True ,
}
string ,
parameters:
{
Description: Parameters supplied to the CreateOrUpdate View operation. ,
Required: True ,
}
{
properties:
{
Description: The properties of the view. ,
Required: False ,
}
{
displayName:
{
Description: User input name of the view. Required. ,
Required: False ,
}
string ,
scope:
{
Description: Cost Management scope to save the view on. This includes 'subscriptions/{subscriptionId}' for subscription scope, 'subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}' for resourceGroup scope, 'providers/Microsoft.Billing/billingAccounts/{billingAccountId}' for Billing Account scope, 'providers/Microsoft.Billing/billingAccounts/{billingAccountId}/departments/{departmentId}' for Department scope, 'providers/Microsoft.Billing/billingAccounts/{billingAccountId}/enrollmentAccounts/{enrollmentAccountId}' for EnrollmentAccount scope, 'providers/Microsoft.Billing/billingAccounts/{billingAccountId}/billingProfiles/{billingProfileId}' for BillingProfile scope, 'providers/Microsoft.Billing/billingAccounts/{billingAccountId}/invoiceSections/{invoiceSectionId}' for InvoiceSection scope, 'providers/Microsoft.Management/managementGroups/{managementGroupId}' for Management Group scope, '/providers/Microsoft.CostManagement/externalBillingAccounts/{externalBillingAccountName}' for ExternalBillingAccount scope, and '/providers/Microsoft.CostManagement/externalSubscriptions/{externalSubscriptionName}' for ExternalSubscription scope. ,
Required: False ,
}
string ,
createdOn:
{
Description: Date the user created this view. ,
Format: date-time ,
Required: False ,
}
string ,
modifiedOn:
{
Description: Date when the user last modified this view. ,
Format: date-time ,
Required: False ,
}
string ,
query:
{
Description: Query body configuration. Required. ,
Required: False ,
}
{
type:
{
Description: The type of the report. Usage represents actual usage, forecast represents forecasted data and UsageAndForecast represents both usage and forecasted data. Actual usage and forecasted data can be differentiated based on dates. ,
Enum:
{
Usage: No description available. ,
}
,
Required: True ,
}
enum ,
timeframe:
{
Description: The time frame for pulling data for the report. If custom, then a specific time period must be provided. ,
Enum:
{
WeekToDate: No description available. ,
MonthToDate: No description available. ,
YearToDate: No description available. ,
Custom: No description available. ,
}
,
Required: True ,
}
enum ,
timePeriod:
{
Description: Has time period for pulling data for the report. ,
Required: False ,
}
{
from:
{
Description: The start date to pull data from. ,
Format: date-time ,
Required: True ,
}
string ,
to:
{
Description: The end date to pull data to. ,
Format: date-time ,
Required: True ,
}
string ,
}
,
dataset:
{
Description: Has definition for data in this report config. ,
Required: False ,
}
{
granularity:
{
Description: The granularity of rows in the report. ,
Enum:
{
Daily: No description available. ,
Monthly: No description available. ,
}
,
Required: False ,
}
enum ,
configuration:
{
Description: Has configuration information for the data in the report. The configuration will be ignored if aggregation and grouping are provided. ,
Required: False ,
}
{
columns:
{
Description: Array of column names to be included in the report. Any valid report column name is allowed. If not provided, then report includes all columns. ,
Required: False ,
}
[
string ,
]
,
}
,
aggregation:
{
Description: Dictionary of aggregation expression to use in the report. The key of each item in the dictionary is the alias for the aggregated column. Report can have up to 2 aggregation clauses. ,
Required: False ,
}
object ,
grouping:
{
Description: Array of group by expression to use in the report. Report can have up to 2 group by clauses. ,
Required: False ,
}
[
{
type:
{
Description: Has type of the column to group. ,
Enum:
{
Tag: No description available. ,
Dimension: No description available. ,
}
,
Required: True ,
}
enum ,
name:
{
Description: The name of the column to group. This version supports subscription lowest possible grain. ,
Required: True ,
}
string ,
}
,
]
,
sorting:
{
Description: Array of order by expression to use in the report. ,
Required: False ,
}
[
{
direction:
{
Description: Direction of sort. ,
Enum:
{
Ascending: No description available. ,
Descending: No description available. ,
}
,
Required: False ,
}
enum ,
name:
{
Description: The name of the column to sort. ,
Required: True ,
}
string ,
}
,
]
,
filter:
{
Description: Has filter expression to use in the report. ,
Required: False ,
}
{
and:
{
Description: The logical "AND" expression. Must have at least 2 items. ,
Required: False ,
}
[
string ,
]
,
or:
{
Description: The logical "OR" expression. Must have at least 2 items. ,
Required: False ,
}
[
string ,
]
,
not:
{
Required: False ,
}
string ,
dimension:
{
Description: Has comparison expression for a dimension ,
Required: False ,
}
{
name:
{
Description: The name of the column to use in comparison. ,
Required: True ,
}
string ,
operator:
{
Description: The operator to use for comparison. ,
Enum:
{
In: No description available. ,
Contains: No description available. ,
}
,
Required: True ,
}
enum ,
values:
{
Description: Array of values to use for comparison ,
Required: True ,
}
[
string ,
]
,
}
,
tag:
{
Description: Has comparison expression for a tag ,
Required: False ,
}
{
name:
{
Description: The name of the column to use in comparison. ,
Required: True ,
}
string ,
operator:
{
Description: The operator to use for comparison. ,
Enum:
{
In: No description available. ,
Contains: No description available. ,
}
,
Required: True ,
}
enum ,
values:
{
Description: Array of values to use for comparison ,
Required: True ,
}
[
string ,
]
,
}
,
}
,
}
,
}
,
chart:
{
Description: Chart type of the main view in Cost Analysis. Required. ,
Enum:
{
Area: No description available. ,
Line: No description available. ,
StackedColumn: No description available. ,
GroupedColumn: No description available. ,
Table: No description available. ,
}
,
Required: False ,
}
enum ,
accumulated:
{
Description: Show costs accumulated over time. ,
Enum:
{
true: No description available. ,
false: No description available. ,
}
,
Required: False ,
}
enum ,
metric:
{
Description: Metric to use when displaying costs. ,
Enum:
{
ActualCost: No description available. ,
AmortizedCost: No description available. ,
AHUB: No description available. ,
}
,
Required: False ,
}
enum ,
kpis:
{
Description: List of KPIs to show in Cost Analysis UI. ,
Required: False ,
}
[
{
type:
{
Description: KPI type (Forecast, Budget). ,
Enum:
{
Forecast: No description available. ,
Budget: No description available. ,
}
,
Required: False ,
}
enum ,
id:
{
Description: ID of resource related to metric (budget). ,
Required: False ,
}
string ,
enabled:
{
Description: show the KPI in the UI? ,
Required: False ,
}
boolean ,
}
,
]
,
pivots:
{
Description: Configuration of 3 sub-views in the Cost Analysis UI. ,
Required: False ,
}
[
{
type:
{
Description: Data type to show in view. ,
Enum:
{
Dimension: No description available. ,
TagKey: No description available. ,
}
,
Required: False ,
}
enum ,
name:
{
Description: Data field to show in view. ,
Required: False ,
}
string ,
}
,
]
,
}
,
}
,
}

⚐ Response (200)

{
properties:
{
Description: The properties of the view. ,
Required: False ,
}
{
displayName:
{
Description: User input name of the view. Required. ,
Required: False ,
}
string ,
scope:
{
Description: Cost Management scope to save the view on. This includes 'subscriptions/{subscriptionId}' for subscription scope, 'subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}' for resourceGroup scope, 'providers/Microsoft.Billing/billingAccounts/{billingAccountId}' for Billing Account scope, 'providers/Microsoft.Billing/billingAccounts/{billingAccountId}/departments/{departmentId}' for Department scope, 'providers/Microsoft.Billing/billingAccounts/{billingAccountId}/enrollmentAccounts/{enrollmentAccountId}' for EnrollmentAccount scope, 'providers/Microsoft.Billing/billingAccounts/{billingAccountId}/billingProfiles/{billingProfileId}' for BillingProfile scope, 'providers/Microsoft.Billing/billingAccounts/{billingAccountId}/invoiceSections/{invoiceSectionId}' for InvoiceSection scope, 'providers/Microsoft.Management/managementGroups/{managementGroupId}' for Management Group scope, '/providers/Microsoft.CostManagement/externalBillingAccounts/{externalBillingAccountName}' for ExternalBillingAccount scope, and '/providers/Microsoft.CostManagement/externalSubscriptions/{externalSubscriptionName}' for ExternalSubscription scope. ,
Required: False ,
}
string ,
createdOn:
{
Description: Date the user created this view. ,
Format: date-time ,
Required: False ,
}
string ,
modifiedOn:
{
Description: Date when the user last modified this view. ,
Format: date-time ,
Required: False ,
}
string ,
query:
{
Description: Query body configuration. Required. ,
Required: False ,
}
{
type:
{
Description: The type of the report. Usage represents actual usage, forecast represents forecasted data and UsageAndForecast represents both usage and forecasted data. Actual usage and forecasted data can be differentiated based on dates. ,
Enum:
{
Usage: No description available. ,
}
,
Required: True ,
}
enum ,
timeframe:
{
Description: The time frame for pulling data for the report. If custom, then a specific time period must be provided. ,
Enum:
{
WeekToDate: No description available. ,
MonthToDate: No description available. ,
YearToDate: No description available. ,
Custom: No description available. ,
}
,
Required: True ,
}
enum ,
timePeriod:
{
Description: Has time period for pulling data for the report. ,
Required: False ,
}
{
from:
{
Description: The start date to pull data from. ,
Format: date-time ,
Required: True ,
}
string ,
to:
{
Description: The end date to pull data to. ,
Format: date-time ,
Required: True ,
}
string ,
}
,
dataset:
{
Description: Has definition for data in this report config. ,
Required: False ,
}
{
granularity:
{
Description: The granularity of rows in the report. ,
Enum:
{
Daily: No description available. ,
Monthly: No description available. ,
}
,
Required: False ,
}
enum ,
configuration:
{
Description: Has configuration information for the data in the report. The configuration will be ignored if aggregation and grouping are provided. ,
Required: False ,
}
{
columns:
{
Description: Array of column names to be included in the report. Any valid report column name is allowed. If not provided, then report includes all columns. ,
Required: False ,
}
[
string ,
]
,
}
,
aggregation:
{
Description: Dictionary of aggregation expression to use in the report. The key of each item in the dictionary is the alias for the aggregated column. Report can have up to 2 aggregation clauses. ,
Required: False ,
}
object ,
grouping:
{
Description: Array of group by expression to use in the report. Report can have up to 2 group by clauses. ,
Required: False ,
}
[
{
type:
{
Description: Has type of the column to group. ,
Enum:
{
Tag: No description available. ,
Dimension: No description available. ,
}
,
Required: True ,
}
enum ,
name:
{
Description: The name of the column to group. This version supports subscription lowest possible grain. ,
Required: True ,
}
string ,
}
,
]
,
sorting:
{
Description: Array of order by expression to use in the report. ,
Required: False ,
}
[
{
direction:
{
Description: Direction of sort. ,
Enum:
{
Ascending: No description available. ,
Descending: No description available. ,
}
,
Required: False ,
}
enum ,
name:
{
Description: The name of the column to sort. ,
Required: True ,
}
string ,
}
,
]
,
filter:
{
Description: Has filter expression to use in the report. ,
Required: False ,
}
{
and:
{
Description: The logical "AND" expression. Must have at least 2 items. ,
Required: False ,
}
[
string ,
]
,
or:
{
Description: The logical "OR" expression. Must have at least 2 items. ,
Required: False ,
}
[
string ,
]
,
not:
{
Required: False ,
}
string ,
dimension:
{
Description: Has comparison expression for a dimension ,
Required: False ,
}
{
name:
{
Description: The name of the column to use in comparison. ,
Required: True ,
}
string ,
operator:
{
Description: The operator to use for comparison. ,
Enum:
{
In: No description available. ,
Contains: No description available. ,
}
,
Required: True ,
}
enum ,
values:
{
Description: Array of values to use for comparison ,
Required: True ,
}
[
string ,
]
,
}
,
tag:
{
Description: Has comparison expression for a tag ,
Required: False ,
}
{
name:
{
Description: The name of the column to use in comparison. ,
Required: True ,
}
string ,
operator:
{
Description: The operator to use for comparison. ,
Enum:
{
In: No description available. ,
Contains: No description available. ,
}
,
Required: True ,
}
enum ,
values:
{
Description: Array of values to use for comparison ,
Required: True ,
}
[
string ,
]
,
}
,
}
,
}
,
}
,
chart:
{
Description: Chart type of the main view in Cost Analysis. Required. ,
Enum:
{
Area: No description available. ,
Line: No description available. ,
StackedColumn: No description available. ,
GroupedColumn: No description available. ,
Table: No description available. ,
}
,
Required: False ,
}
enum ,
accumulated:
{
Description: Show costs accumulated over time. ,
Enum:
{
true: No description available. ,
false: No description available. ,
}
,
Required: False ,
}
enum ,
metric:
{
Description: Metric to use when displaying costs. ,
Enum:
{
ActualCost: No description available. ,
AmortizedCost: No description available. ,
AHUB: No description available. ,
}
,
Required: False ,
}
enum ,
kpis:
{
Description: List of KPIs to show in Cost Analysis UI. ,
Required: False ,
}
[
{
type:
{
Description: KPI type (Forecast, Budget). ,
Enum:
{
Forecast: No description available. ,
Budget: No description available. ,
}
,
Required: False ,
}
enum ,
id:
{
Description: ID of resource related to metric (budget). ,
Required: False ,
}
string ,
enabled:
{
Description: show the KPI in the UI? ,
Required: False ,
}
boolean ,
}
,
]
,
pivots:
{
Description: Configuration of 3 sub-views in the Cost Analysis UI. ,
Required: False ,
}
[
{
type:
{
Description: Data type to show in view. ,
Enum:
{
Dimension: No description available. ,
TagKey: No description available. ,
}
,
Required: False ,
}
enum ,
name:
{
Description: Data field to show in view. ,
Required: False ,
}
string ,
}
,
]
,
}
,
}

⚐ Response (201)

{
properties:
{
Description: The properties of the view. ,
Required: False ,
}
{
displayName:
{
Description: User input name of the view. Required. ,
Required: False ,
}
string ,
scope:
{
Description: Cost Management scope to save the view on. This includes 'subscriptions/{subscriptionId}' for subscription scope, 'subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}' for resourceGroup scope, 'providers/Microsoft.Billing/billingAccounts/{billingAccountId}' for Billing Account scope, 'providers/Microsoft.Billing/billingAccounts/{billingAccountId}/departments/{departmentId}' for Department scope, 'providers/Microsoft.Billing/billingAccounts/{billingAccountId}/enrollmentAccounts/{enrollmentAccountId}' for EnrollmentAccount scope, 'providers/Microsoft.Billing/billingAccounts/{billingAccountId}/billingProfiles/{billingProfileId}' for BillingProfile scope, 'providers/Microsoft.Billing/billingAccounts/{billingAccountId}/invoiceSections/{invoiceSectionId}' for InvoiceSection scope, 'providers/Microsoft.Management/managementGroups/{managementGroupId}' for Management Group scope, '/providers/Microsoft.CostManagement/externalBillingAccounts/{externalBillingAccountName}' for ExternalBillingAccount scope, and '/providers/Microsoft.CostManagement/externalSubscriptions/{externalSubscriptionName}' for ExternalSubscription scope. ,
Required: False ,
}
string ,
createdOn:
{
Description: Date the user created this view. ,
Format: date-time ,
Required: False ,
}
string ,
modifiedOn:
{
Description: Date when the user last modified this view. ,
Format: date-time ,
Required: False ,
}
string ,
query:
{
Description: Query body configuration. Required. ,
Required: False ,
}
{
type:
{
Description: The type of the report. Usage represents actual usage, forecast represents forecasted data and UsageAndForecast represents both usage and forecasted data. Actual usage and forecasted data can be differentiated based on dates. ,
Enum:
{
Usage: No description available. ,
}
,
Required: True ,
}
enum ,
timeframe:
{
Description: The time frame for pulling data for the report. If custom, then a specific time period must be provided. ,
Enum:
{
WeekToDate: No description available. ,
MonthToDate: No description available. ,
YearToDate: No description available. ,
Custom: No description available. ,
}
,
Required: True ,
}
enum ,
timePeriod:
{
Description: Has time period for pulling data for the report. ,
Required: False ,
}
{
from:
{
Description: The start date to pull data from. ,
Format: date-time ,
Required: True ,
}
string ,
to:
{
Description: The end date to pull data to. ,
Format: date-time ,
Required: True ,
}
string ,
}
,
dataset:
{
Description: Has definition for data in this report config. ,
Required: False ,
}
{
granularity:
{
Description: The granularity of rows in the report. ,
Enum:
{
Daily: No description available. ,
Monthly: No description available. ,
}
,
Required: False ,
}
enum ,
configuration:
{
Description: Has configuration information for the data in the report. The configuration will be ignored if aggregation and grouping are provided. ,
Required: False ,
}
{
columns:
{
Description: Array of column names to be included in the report. Any valid report column name is allowed. If not provided, then report includes all columns. ,
Required: False ,
}
[
string ,
]
,
}
,
aggregation:
{
Description: Dictionary of aggregation expression to use in the report. The key of each item in the dictionary is the alias for the aggregated column. Report can have up to 2 aggregation clauses. ,
Required: False ,
}
object ,
grouping:
{
Description: Array of group by expression to use in the report. Report can have up to 2 group by clauses. ,
Required: False ,
}
[
{
type:
{
Description: Has type of the column to group. ,
Enum:
{
Tag: No description available. ,
Dimension: No description available. ,
}
,
Required: True ,
}
enum ,
name:
{
Description: The name of the column to group. This version supports subscription lowest possible grain. ,
Required: True ,
}
string ,
}
,
]
,
sorting:
{
Description: Array of order by expression to use in the report. ,
Required: False ,
}
[
{
direction:
{
Description: Direction of sort. ,
Enum:
{
Ascending: No description available. ,
Descending: No description available. ,
}
,
Required: False ,
}
enum ,
name:
{
Description: The name of the column to sort. ,
Required: True ,
}
string ,
}
,
]
,
filter:
{
Description: Has filter expression to use in the report. ,
Required: False ,
}
{
and:
{
Description: The logical "AND" expression. Must have at least 2 items. ,
Required: False ,
}
[
string ,
]
,
or:
{
Description: The logical "OR" expression. Must have at least 2 items. ,
Required: False ,
}
[
string ,
]
,
not:
{
Required: False ,
}
string ,
dimension:
{
Description: Has comparison expression for a dimension ,
Required: False ,
}
{
name:
{
Description: The name of the column to use in comparison. ,
Required: True ,
}
string ,
operator:
{
Description: The operator to use for comparison. ,
Enum:
{
In: No description available. ,
Contains: No description available. ,
}
,
Required: True ,
}
enum ,
values:
{
Description: Array of values to use for comparison ,
Required: True ,
}
[
string ,
]
,
}
,
tag:
{
Description: Has comparison expression for a tag ,
Required: False ,
}
{
name:
{
Description: The name of the column to use in comparison. ,
Required: True ,
}
string ,
operator:
{
Description: The operator to use for comparison. ,
Enum:
{
In: No description available. ,
Contains: No description available. ,
}
,
Required: True ,
}
enum ,
values:
{
Description: Array of values to use for comparison ,
Required: True ,
}
[
string ,
]
,
}
,
}
,
}
,
}
,
chart:
{
Description: Chart type of the main view in Cost Analysis. Required. ,
Enum:
{
Area: No description available. ,
Line: No description available. ,
StackedColumn: No description available. ,
GroupedColumn: No description available. ,
Table: No description available. ,
}
,
Required: False ,
}
enum ,
accumulated:
{
Description: Show costs accumulated over time. ,
Enum:
{
true: No description available. ,
false: No description available. ,
}
,
Required: False ,
}
enum ,
metric:
{
Description: Metric to use when displaying costs. ,
Enum:
{
ActualCost: No description available. ,
AmortizedCost: No description available. ,
AHUB: No description available. ,
}
,
Required: False ,
}
enum ,
kpis:
{
Description: List of KPIs to show in Cost Analysis UI. ,
Required: False ,
}
[
{
type:
{
Description: KPI type (Forecast, Budget). ,
Enum:
{
Forecast: No description available. ,
Budget: No description available. ,
}
,
Required: False ,
}
enum ,
id:
{
Description: ID of resource related to metric (budget). ,
Required: False ,
}
string ,
enabled:
{
Description: show the KPI in the UI? ,
Required: False ,
}
boolean ,
}
,
]
,
pivots:
{
Description: Configuration of 3 sub-views in the Cost Analysis UI. ,
Required: False ,
}
[
{
type:
{
Description: Data type to show in view. ,
Enum:
{
Dimension: No description available. ,
TagKey: No description available. ,
}
,
Required: False ,
}
enum ,
name:
{
Description: Data field to show in view. ,
Required: False ,
}
string ,
}
,
]
,
}
,
}

⚐ Response (default)

{
error:
{
Description: The details of the error. ,
Required: False ,
}
{
code:
{
Description: A machine readable error code. ,
Required: False ,
}
string ,
message:
{
Description: A human readable error message. ,
Required: False ,
}
string ,
target:
{
Description: Indicates which property in the request is responsible for the error. ,
Required: False ,
}
string ,
details:
{
Description: error details. ,
Required: False ,
}
[
{
code:
{
Description: A machine readable error code. ,
Required: False ,
}
string ,
message:
{
Description: A human readable error message. ,
Required: False ,
}
string ,
target:
{
Description: Indicates which property in the request is responsible for the error. ,
Required: False ,
}
string ,
}
,
]
,
}
,
}
Views_DeleteByScope (removed)
Description :  The operation to delete a view.
Reference :  Link ¶

⚼ Request

DELETE:  /{scope}/providers/Microsoft.CostManagement/views/{viewName}
{
scope:
{
Description: The scope associated with view operations. This includes 'subscriptions/{subscriptionId}' for subscription scope, 'subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}' for resourceGroup scope, 'providers/Microsoft.Billing/billingAccounts/{billingAccountId}' for Billing Account scope, 'providers/Microsoft.Billing/billingAccounts/{billingAccountId}/departments/{departmentId}' for Department scope, 'providers/Microsoft.Billing/billingAccounts/{billingAccountId}/enrollmentAccounts/{enrollmentAccountId}' for EnrollmentAccount scope, 'providers/Microsoft.Billing/billingAccounts/{billingAccountId}/billingProfiles/{billingProfileId}' for BillingProfile scope, 'providers/Microsoft.Billing/billingAccounts/{billingAccountId}/invoiceSections/{invoiceSectionId}' for InvoiceSection scope, 'providers/Microsoft.Management/managementGroups/{managementGroupId}' for Management Group scope, 'providers/Microsoft.CostManagement/externalBillingAccounts/{externalBillingAccountName}' for External Billing Account scope and 'providers/Microsoft.CostManagement/externalSubscriptions/{externalSubscriptionName}' for External Subscription scope. ,
Required: True ,
}
string ,
api-version:
{
Description: Version of the API to be used with the client request. The current version is 2019-04-01-preview ,
Required: True ,
}
string ,
viewName:
{
Description: View name ,
Required: True ,
}
string ,
}

⚐ Response (200)

{}

⚐ Response (204)

{}

⚐ Response (default)

{
error:
{
Description: The details of the error. ,
Required: False ,
}
{
code:
{
Description: A machine readable error code. ,
Required: False ,
}
string ,
message:
{
Description: A human readable error message. ,
Required: False ,
}
string ,
target:
{
Description: Indicates which property in the request is responsible for the error. ,
Required: False ,
}
string ,
details:
{
Description: error details. ,
Required: False ,
}
[
{
code:
{
Description: A machine readable error code. ,
Required: False ,
}
string ,
message:
{
Description: A human readable error message. ,
Required: False ,
}
string ,
target:
{
Description: Indicates which property in the request is responsible for the error. ,
Required: False ,
}
string ,
}
,
]
,
}
,
}
Budgets_List (removed)
Description :  Lists all budgets for the defined scope.
Reference :  Link ¶

⚼ Request

GET:  /{scope}/providers/Microsoft.CostManagement/budgets
{
scope:
{
Description: The scope associated with budget operations. This includes '/subscriptions/{subscriptionId}/' for subscription scope, '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}' for resourceGroup scope, '/providers/Microsoft.Billing/billingAccounts/{billingAccountId}' for Billing Account scope, '/providers/Microsoft.Billing/billingAccounts/{billingAccountId}/departments/{departmentId}' for Department scope, '/providers/Microsoft.Billing/billingAccounts/{billingAccountId}/enrollmentAccounts/{enrollmentAccountId}' for EnrollmentAccount scope, '/providers/Microsoft.Management/managementGroups/{managementGroupId}' for Management Group scope, '/providers/Microsoft.Billing/billingAccounts/{billingAccountId}/billingProfiles/{billingProfileId}' for billingProfile scope, 'providers/Microsoft.Billing/billingAccounts/{billingAccountId}/invoiceSections/{invoiceSectionId}' for invoiceSection scope. ,
Required: True ,
}
string ,
api-version:
{
Description: Version of the API to be used with the client request. The current version is 2019-04-01-preview ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
value:
{
Description: The list of budgets. ,
Required: False ,
}
[
{
properties:
{
Description: The properties of the budget. ,
Required: False ,
}
{
category:
{
Description: The category of the budget, whether the budget tracks cost or usage. ,
Enum:
{
Cost: No description available. ,
Usage: No description available. ,
}
,
Required: True ,
}
enum ,
amount:
{
Description: The total amount of cost to track with the budget ,
Format: decimal ,
Required: True ,
}
number ,
timeGrain:
{
Description: The time covered by a budget. Tracking of the amount will be reset based on the time grain. ,
Enum:
{
Monthly: No description available. ,
Quarterly: No description available. ,
Annually: No description available. ,
}
,
Required: True ,
}
enum ,
timePeriod:
{
Description: Has start and end date of the budget. The start date must be first of the month and should be less than the end date. Budget start date must be on or after June 1, 2017. Future start date should not be more than three months. Past start date should be selected within the timegrain period. There are no restrictions on the end date. ,
Required: True ,
}
{
startDate:
{
Description: The start date for the budget. ,
Format: date-time ,
Required: True ,
}
string ,
endDate:
{
Description: The end date for the budget. If not provided, we default this to 10 years from the start date. ,
Format: date-time ,
Required: False ,
}
string ,
}
,
filter:
{
Description: May be used to filter budgets. ,
Required: False ,
}
{
and:
{
Description: The logical "AND" expression. Must have at least 2 items. ,
Required: False ,
}
[
string ,
]
,
or:
{
Description: The logical "OR" expression. Must have at least 2 items. ,
Required: False ,
}
[
string ,
]
,
not:
{
Required: False ,
}
string ,
dimension:
{
Description: Has comparison expression for a dimension ,
Required: False ,
}
{
name:
{
Description: The name of the column to use in comparison. ,
Required: True ,
}
string ,
operator:
{
Description: The operator to use for comparison. ,
Enum:
{
In: No description available. ,
Contains: No description available. ,
}
,
Required: True ,
}
enum ,
values:
{
Description: Array of values to use for comparison ,
Required: True ,
}
[
string ,
]
,
}
,
tag:
{
Description: Has comparison expression for a tag ,
Required: False ,
}
{
name:
{
Description: The name of the column to use in comparison. ,
Required: True ,
}
string ,
operator:
{
Description: The operator to use for comparison. ,
Enum:
{
In: No description available. ,
Contains: No description available. ,
}
,
Required: True ,
}
enum ,
values:
{
Description: Array of values to use for comparison ,
Required: True ,
}
[
string ,
]
,
}
,
}
,
currentSpend:
{
Description: The current amount of cost which is being tracked for a budget. ,
Required: False ,
}
{
amount:
{
Description: The total amount of cost which is being tracked by the budget. ,
Format: decimal ,
Required: False ,
}
number ,
unit:
{
Description: The unit of measure for the budget amount. ,
Required: False ,
}
string ,
}
,
notifications:
{
Description: Dictionary of notifications associated with the budget. Budget can have up to five notifications. ,
Required: False ,
}
object ,
}
,
}
,
]
,
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: A machine readable error code. ,
Required: False ,
}
string ,
message:
{
Description: A human readable error message. ,
Required: False ,
}
string ,
target:
{
Description: Indicates which property in the request is responsible for the error. ,
Required: False ,
}
string ,
details:
{
Description: error details. ,
Required: False ,
}
[
{
code:
{
Description: A machine readable error code. ,
Required: False ,
}
string ,
message:
{
Description: A human readable error message. ,
Required: False ,
}
string ,
target:
{
Description: Indicates which property in the request is responsible for the error. ,
Required: False ,
}
string ,
}
,
]
,
}
,
}
Budget_Get (removed)
Description :  Gets the budget for the scope by budget name.
Reference :  Link ¶

⚼ Request

GET:  /{scope}/providers/Microsoft.CostManagement/budgets/{budgetName}
{
scope:
{
Description: The scope associated with budget operations. This includes '/subscriptions/{subscriptionId}/' for subscription scope, '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}' for resourceGroup scope, '/providers/Microsoft.Billing/billingAccounts/{billingAccountId}' for Billing Account scope, '/providers/Microsoft.Billing/billingAccounts/{billingAccountId}/departments/{departmentId}' for Department scope, '/providers/Microsoft.Billing/billingAccounts/{billingAccountId}/enrollmentAccounts/{enrollmentAccountId}' for EnrollmentAccount scope, '/providers/Microsoft.Management/managementGroups/{managementGroupId}' for Management Group scope, '/providers/Microsoft.Billing/billingAccounts/{billingAccountId}/billingProfiles/{billingProfileId}' for billingProfile scope, 'providers/Microsoft.Billing/billingAccounts/{billingAccountId}/invoiceSections/{invoiceSectionId}' for invoiceSection scope. ,
Required: True ,
}
string ,
api-version:
{
Description: Version of the API to be used with the client request. The current version is 2019-04-01-preview ,
Required: True ,
}
string ,
budgetName:
{
Description: Budget Name. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
properties:
{
Description: The properties of the budget. ,
Required: False ,
}
{
category:
{
Description: The category of the budget, whether the budget tracks cost or usage. ,
Enum:
{
Cost: No description available. ,
Usage: No description available. ,
}
,
Required: True ,
}
enum ,
amount:
{
Description: The total amount of cost to track with the budget ,
Format: decimal ,
Required: True ,
}
number ,
timeGrain:
{
Description: The time covered by a budget. Tracking of the amount will be reset based on the time grain. ,
Enum:
{
Monthly: No description available. ,
Quarterly: No description available. ,
Annually: No description available. ,
}
,
Required: True ,
}
enum ,
timePeriod:
{
Description: Has start and end date of the budget. The start date must be first of the month and should be less than the end date. Budget start date must be on or after June 1, 2017. Future start date should not be more than three months. Past start date should be selected within the timegrain period. There are no restrictions on the end date. ,
Required: True ,
}
{
startDate:
{
Description: The start date for the budget. ,
Format: date-time ,
Required: True ,
}
string ,
endDate:
{
Description: The end date for the budget. If not provided, we default this to 10 years from the start date. ,
Format: date-time ,
Required: False ,
}
string ,
}
,
filter:
{
Description: May be used to filter budgets. ,
Required: False ,
}
{
and:
{
Description: The logical "AND" expression. Must have at least 2 items. ,
Required: False ,
}
[
string ,
]
,
or:
{
Description: The logical "OR" expression. Must have at least 2 items. ,
Required: False ,
}
[
string ,
]
,
not:
{
Required: False ,
}
string ,
dimension:
{
Description: Has comparison expression for a dimension ,
Required: False ,
}
{
name:
{
Description: The name of the column to use in comparison. ,
Required: True ,
}
string ,
operator:
{
Description: The operator to use for comparison. ,
Enum:
{
In: No description available. ,
Contains: No description available. ,
}
,
Required: True ,
}
enum ,
values:
{
Description: Array of values to use for comparison ,
Required: True ,
}
[
string ,
]
,
}
,
tag:
{
Description: Has comparison expression for a tag ,
Required: False ,
}
{
name:
{
Description: The name of the column to use in comparison. ,
Required: True ,
}
string ,
operator:
{
Description: The operator to use for comparison. ,
Enum:
{
In: No description available. ,
Contains: No description available. ,
}
,
Required: True ,
}
enum ,
values:
{
Description: Array of values to use for comparison ,
Required: True ,
}
[
string ,
]
,
}
,
}
,
currentSpend:
{
Description: The current amount of cost which is being tracked for a budget. ,
Required: False ,
}
{
amount:
{
Description: The total amount of cost which is being tracked by the budget. ,
Format: decimal ,
Required: False ,
}
number ,
unit:
{
Description: The unit of measure for the budget amount. ,
Required: False ,
}
string ,
}
,
notifications:
{
Description: Dictionary of notifications associated with the budget. Budget can have up to five notifications. ,
Required: False ,
}
object ,
}
,
}

⚐ Response (default)

{
error:
{
Description: The details of the error. ,
Required: False ,
}
{
code:
{
Description: A machine readable error code. ,
Required: False ,
}
string ,
message:
{
Description: A human readable error message. ,
Required: False ,
}
string ,
target:
{
Description: Indicates which property in the request is responsible for the error. ,
Required: False ,
}
string ,
details:
{
Description: error details. ,
Required: False ,
}
[
{
code:
{
Description: A machine readable error code. ,
Required: False ,
}
string ,
message:
{
Description: A human readable error message. ,
Required: False ,
}
string ,
target:
{
Description: Indicates which property in the request is responsible for the error. ,
Required: False ,
}
string ,
}
,
]
,
}
,
}
Budget_CreateOrUpdate (removed)
Description :  The operation to create or update a budget. Update operation requires latest eTag to be set in the request mandatorily. You may obtain the latest eTag by performing a get operation. Create operation does not require eTag.
Reference :  Link ¶

⚼ Request

PUT:  /{scope}/providers/Microsoft.CostManagement/budgets/{budgetName}
{
scope:
{
Description: The scope associated with budget operations. This includes '/subscriptions/{subscriptionId}/' for subscription scope, '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}' for resourceGroup scope, '/providers/Microsoft.Billing/billingAccounts/{billingAccountId}' for Billing Account scope, '/providers/Microsoft.Billing/billingAccounts/{billingAccountId}/departments/{departmentId}' for Department scope, '/providers/Microsoft.Billing/billingAccounts/{billingAccountId}/enrollmentAccounts/{enrollmentAccountId}' for EnrollmentAccount scope, '/providers/Microsoft.Management/managementGroups/{managementGroupId}' for Management Group scope, '/providers/Microsoft.Billing/billingAccounts/{billingAccountId}/billingProfiles/{billingProfileId}' for billingProfile scope, 'providers/Microsoft.Billing/billingAccounts/{billingAccountId}/invoiceSections/{invoiceSectionId}' for invoiceSection scope. ,
Required: True ,
}
string ,
api-version:
{
Description: Version of the API to be used with the client request. The current version is 2019-04-01-preview ,
Required: True ,
}
string ,
budgetName:
{
Description: Budget Name. ,
Required: True ,
}
string ,
parameters:
{
Description: Parameters supplied to the Create Budget operation. ,
Required: False ,
}
{
properties:
{
Description: The properties of the budget. ,
Required: False ,
}
{
category:
{
Description: The category of the budget, whether the budget tracks cost or usage. ,
Enum:
{
Cost: No description available. ,
Usage: No description available. ,
}
,
Required: True ,
}
enum ,
amount:
{
Description: The total amount of cost to track with the budget ,
Format: decimal ,
Required: True ,
}
number ,
timeGrain:
{
Description: The time covered by a budget. Tracking of the amount will be reset based on the time grain. ,
Enum:
{
Monthly: No description available. ,
Quarterly: No description available. ,
Annually: No description available. ,
}
,
Required: True ,
}
enum ,
timePeriod:
{
Description: Has start and end date of the budget. The start date must be first of the month and should be less than the end date. Budget start date must be on or after June 1, 2017. Future start date should not be more than three months. Past start date should be selected within the timegrain period. There are no restrictions on the end date. ,
Required: True ,
}
{
startDate:
{
Description: The start date for the budget. ,
Format: date-time ,
Required: True ,
}
string ,
endDate:
{
Description: The end date for the budget. If not provided, we default this to 10 years from the start date. ,
Format: date-time ,
Required: False ,
}
string ,
}
,
filter:
{
Description: May be used to filter budgets. ,
Required: False ,
}
{
and:
{
Description: The logical "AND" expression. Must have at least 2 items. ,
Required: False ,
}
[
string ,
]
,
or:
{
Description: The logical "OR" expression. Must have at least 2 items. ,
Required: False ,
}
[
string ,
]
,
not:
{
Required: False ,
}
string ,
dimension:
{
Description: Has comparison expression for a dimension ,
Required: False ,
}
{
name:
{
Description: The name of the column to use in comparison. ,
Required: True ,
}
string ,
operator:
{
Description: The operator to use for comparison. ,
Enum:
{
In: No description available. ,
Contains: No description available. ,
}
,
Required: True ,
}
enum ,
values:
{
Description: Array of values to use for comparison ,
Required: True ,
}
[
string ,
]
,
}
,
tag:
{
Description: Has comparison expression for a tag ,
Required: False ,
}
{
name:
{
Description: The name of the column to use in comparison. ,
Required: True ,
}
string ,
operator:
{
Description: The operator to use for comparison. ,
Enum:
{
In: No description available. ,
Contains: No description available. ,
}
,
Required: True ,
}
enum ,
values:
{
Description: Array of values to use for comparison ,
Required: True ,
}
[
string ,
]
,
}
,
}
,
currentSpend:
{
Description: The current amount of cost which is being tracked for a budget. ,
Required: False ,
}
{
amount:
{
Description: The total amount of cost which is being tracked by the budget. ,
Format: decimal ,
Required: False ,
}
number ,
unit:
{
Description: The unit of measure for the budget amount. ,
Required: False ,
}
string ,
}
,
notifications:
{
Description: Dictionary of notifications associated with the budget. Budget can have up to five notifications. ,
Required: False ,
}
object ,
}
,
}
,
}

⚐ Response (200)

{
properties:
{
Description: The properties of the budget. ,
Required: False ,
}
{
category:
{
Description: The category of the budget, whether the budget tracks cost or usage. ,
Enum:
{
Cost: No description available. ,
Usage: No description available. ,
}
,
Required: True ,
}
enum ,
amount:
{
Description: The total amount of cost to track with the budget ,
Format: decimal ,
Required: True ,
}
number ,
timeGrain:
{
Description: The time covered by a budget. Tracking of the amount will be reset based on the time grain. ,
Enum:
{
Monthly: No description available. ,
Quarterly: No description available. ,
Annually: No description available. ,
}
,
Required: True ,
}
enum ,
timePeriod:
{
Description: Has start and end date of the budget. The start date must be first of the month and should be less than the end date. Budget start date must be on or after June 1, 2017. Future start date should not be more than three months. Past start date should be selected within the timegrain period. There are no restrictions on the end date. ,
Required: True ,
}
{
startDate:
{
Description: The start date for the budget. ,
Format: date-time ,
Required: True ,
}
string ,
endDate:
{
Description: The end date for the budget. If not provided, we default this to 10 years from the start date. ,
Format: date-time ,
Required: False ,
}
string ,
}
,
filter:
{
Description: May be used to filter budgets. ,
Required: False ,
}
{
and:
{
Description: The logical "AND" expression. Must have at least 2 items. ,
Required: False ,
}
[
string ,
]
,
or:
{
Description: The logical "OR" expression. Must have at least 2 items. ,
Required: False ,
}
[
string ,
]
,
not:
{
Required: False ,
}
string ,
dimension:
{
Description: Has comparison expression for a dimension ,
Required: False ,
}
{
name:
{
Description: The name of the column to use in comparison. ,
Required: True ,
}
string ,
operator:
{
Description: The operator to use for comparison. ,
Enum:
{
In: No description available. ,
Contains: No description available. ,
}
,
Required: True ,
}
enum ,
values:
{
Description: Array of values to use for comparison ,
Required: True ,
}
[
string ,
]
,
}
,
tag:
{
Description: Has comparison expression for a tag ,
Required: False ,
}
{
name:
{
Description: The name of the column to use in comparison. ,
Required: True ,
}
string ,
operator:
{
Description: The operator to use for comparison. ,
Enum:
{
In: No description available. ,
Contains: No description available. ,
}
,
Required: True ,
}
enum ,
values:
{
Description: Array of values to use for comparison ,
Required: True ,
}
[
string ,
]
,
}
,
}
,
currentSpend:
{
Description: The current amount of cost which is being tracked for a budget. ,
Required: False ,
}
{
amount:
{
Description: The total amount of cost which is being tracked by the budget. ,
Format: decimal ,
Required: False ,
}
number ,
unit:
{
Description: The unit of measure for the budget amount. ,
Required: False ,
}
string ,
}
,
notifications:
{
Description: Dictionary of notifications associated with the budget. Budget can have up to five notifications. ,
Required: False ,
}
object ,
}
,
}

⚐ Response (201)

{
properties:
{
Description: The properties of the budget. ,
Required: False ,
}
{
category:
{
Description: The category of the budget, whether the budget tracks cost or usage. ,
Enum:
{
Cost: No description available. ,
Usage: No description available. ,
}
,
Required: True ,
}
enum ,
amount:
{
Description: The total amount of cost to track with the budget ,
Format: decimal ,
Required: True ,
}
number ,
timeGrain:
{
Description: The time covered by a budget. Tracking of the amount will be reset based on the time grain. ,
Enum:
{
Monthly: No description available. ,
Quarterly: No description available. ,
Annually: No description available. ,
}
,
Required: True ,
}
enum ,
timePeriod:
{
Description: Has start and end date of the budget. The start date must be first of the month and should be less than the end date. Budget start date must be on or after June 1, 2017. Future start date should not be more than three months. Past start date should be selected within the timegrain period. There are no restrictions on the end date. ,
Required: True ,
}
{
startDate:
{
Description: The start date for the budget. ,
Format: date-time ,
Required: True ,
}
string ,
endDate:
{
Description: The end date for the budget. If not provided, we default this to 10 years from the start date. ,
Format: date-time ,
Required: False ,
}
string ,
}
,
filter:
{
Description: May be used to filter budgets. ,
Required: False ,
}
{
and:
{
Description: The logical "AND" expression. Must have at least 2 items. ,
Required: False ,
}
[
string ,
]
,
or:
{
Description: The logical "OR" expression. Must have at least 2 items. ,
Required: False ,
}
[
string ,
]
,
not:
{
Required: False ,
}
string ,
dimension:
{
Description: Has comparison expression for a dimension ,
Required: False ,
}
{
name:
{
Description: The name of the column to use in comparison. ,
Required: True ,
}
string ,
operator:
{
Description: The operator to use for comparison. ,
Enum:
{
In: No description available. ,
Contains: No description available. ,
}
,
Required: True ,
}
enum ,
values:
{
Description: Array of values to use for comparison ,
Required: True ,
}
[
string ,
]
,
}
,
tag:
{
Description: Has comparison expression for a tag ,
Required: False ,
}
{
name:
{
Description: The name of the column to use in comparison. ,
Required: True ,
}
string ,
operator:
{
Description: The operator to use for comparison. ,
Enum:
{
In: No description available. ,
Contains: No description available. ,
}
,
Required: True ,
}
enum ,
values:
{
Description: Array of values to use for comparison ,
Required: True ,
}
[
string ,
]
,
}
,
}
,
currentSpend:
{
Description: The current amount of cost which is being tracked for a budget. ,
Required: False ,
}
{
amount:
{
Description: The total amount of cost which is being tracked by the budget. ,
Format: decimal ,
Required: False ,
}
number ,
unit:
{
Description: The unit of measure for the budget amount. ,
Required: False ,
}
string ,
}
,
notifications:
{
Description: Dictionary of notifications associated with the budget. Budget can have up to five notifications. ,
Required: False ,
}
object ,
}
,
}

⚐ Response (default)

{
error:
{
Description: The details of the error. ,
Required: False ,
}
{
code:
{
Description: A machine readable error code. ,
Required: False ,
}
string ,
message:
{
Description: A human readable error message. ,
Required: False ,
}
string ,
target:
{
Description: Indicates which property in the request is responsible for the error. ,
Required: False ,
}
string ,
details:
{
Description: error details. ,
Required: False ,
}
[
{
code:
{
Description: A machine readable error code. ,
Required: False ,
}
string ,
message:
{
Description: A human readable error message. ,
Required: False ,
}
string ,
target:
{
Description: Indicates which property in the request is responsible for the error. ,
Required: False ,
}
string ,
}
,
]
,
}
,
}
Budget_Delete (removed)
Description :  The operation to delete a budget.
Reference :  Link ¶

⚼ Request

DELETE:  /{scope}/providers/Microsoft.CostManagement/budgets/{budgetName}
{
scope:
{
Description: The scope associated with budget operations. This includes '/subscriptions/{subscriptionId}/' for subscription scope, '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}' for resourceGroup scope, '/providers/Microsoft.Billing/billingAccounts/{billingAccountId}' for Billing Account scope, '/providers/Microsoft.Billing/billingAccounts/{billingAccountId}/departments/{departmentId}' for Department scope, '/providers/Microsoft.Billing/billingAccounts/{billingAccountId}/enrollmentAccounts/{enrollmentAccountId}' for EnrollmentAccount scope, '/providers/Microsoft.Management/managementGroups/{managementGroupId}' for Management Group scope, '/providers/Microsoft.Billing/billingAccounts/{billingAccountId}/billingProfiles/{billingProfileId}' for billingProfile scope, 'providers/Microsoft.Billing/billingAccounts/{billingAccountId}/invoiceSections/{invoiceSectionId}' for invoiceSection scope. ,
Required: True ,
}
string ,
api-version:
{
Description: Version of the API to be used with the client request. The current version is 2019-04-01-preview ,
Required: True ,
}
string ,
budgetName:
{
Description: Budget Name. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{}

⚐ Response (204)

{}

⚐ Response (default)

{
error:
{
Description: The details of the error. ,
Required: False ,
}
{
code:
{
Description: A machine readable error code. ,
Required: False ,
}
string ,
message:
{
Description: A human readable error message. ,
Required: False ,
}
string ,
target:
{
Description: Indicates which property in the request is responsible for the error. ,
Required: False ,
}
string ,
details:
{
Description: error details. ,
Required: False ,
}
[
{
code:
{
Description: A machine readable error code. ,
Required: False ,
}
string ,
message:
{
Description: A human readable error message. ,
Required: False ,
}
string ,
target:
{
Description: Indicates which property in the request is responsible for the error. ,
Required: False ,
}
string ,
}
,
]
,
}
,
}
Operations_List (removed)
Description :  Lists all of the available consumption REST API operations.
Reference :  Link ¶

⚼ Request

GET:  /providers/Microsoft.CostManagement/operations
{
api-version:
{
Description: Version of the API to be used with the client request. The current version is 2019-04-01-preview ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
value:
{
Description: List of cost management operations supported by the Microsoft.CostManagement resource provider. ,
Required: False ,
}
[
{
name:
{
Description: Operation name: {provider}/{resource}/{operation}. ,
Required: False ,
}
string ,
display:
{
Description: The object that represents the operation. ,
Required: False ,
}
{
provider:
{
Description: Service provider: Microsoft.CostManagement. ,
Required: False ,
}
string ,
resource:
{
Description: Resource on which the operation is performed: Dimensions, Query. ,
Required: False ,
}
string ,
operation:
{
Description: Operation type: Read, write, delete, etc. ,
Required: False ,
}
string ,
}
,
}
,
]
,
nextLink:
{
Description: URL to get the next set of operation list results if there are any. ,
Required: False ,
}
string ,
}

⚐ Response (default)

{
error:
{
Description: The details of the error. ,
Required: False ,
}
{
code:
{
Description: A machine readable error code. ,
Required: False ,
}
string ,
message:
{
Description: A human readable error message. ,
Required: False ,
}
string ,
target:
{
Description: Indicates which property in the request is responsible for the error. ,
Required: False ,
}
string ,
details:
{
Description: error details. ,
Required: False ,
}
[
{
code:
{
Description: A machine readable error code. ,
Required: False ,
}
string ,
message:
{
Description: A human readable error message. ,
Required: False ,
}
string ,
target:
{
Description: Indicates which property in the request is responsible for the error. ,
Required: False ,
}
string ,
}
,
]
,
}
,
}