dimensions

Creates, updates, deletes, gets or lists a dimensions resource.

Overview

Name	dimensions
Type	Resource
Id	azure.cost_management.dimensions

Fields

The following fields are returned by SELECT queries:

list

OK. The request has succeeded.

Name	Datatype	Description
id	string	Resource Id.
name	string	Resource name.
eTag	string	ETag of the resource.
location	string	Location of the resource.
properties	object	Dimension properties. (title: Dimension properties)
sku	string	SKU of the resource.
tags	object	Resource tags.
type	string	Resource type.

Methods

The following methods are available for this resource:

Name	Accessible by	Required Params	Optional Params	Description
list	select	scope	$filter, $expand, $skiptoken, $top	Lists the dimensions by the defined scope.
by_external_cloud_provider_type	exec	externalCloudProviderType, externalCloudProviderId	$filter, $expand, $skiptoken, $top	Lists the dimensions by the external cloud provider type.

Parameters

Parameters can be passed in the WHERE clause of a query. Check the Methods section to see which parameters are required or optional for each operation.

Name	Datatype	Description
externalCloudProviderId	string	This can be '{externalSubscriptionId}' for linked account or '{externalBillingAccountId}' for consolidated account used with dimension/query operations.
externalCloudProviderType	string	The external cloud provider type associated with dimension/query operations. This includes 'externalSubscriptions' for linked account and 'externalBillingAccounts' for consolidated account.
scope	string	The scope associated with dimension 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}/billingProfiles/{billingProfileId}/invoiceSections/{invoiceSectionId}' for invoiceSection scope, and 'providers/Microsoft.Billing/billingAccounts/{billingAccountId}/customers/{customerId}' specific for partners.
$expand	string	May be used to expand the properties/data within a dimension category. By default, data is not included when listing dimensions.
$filter	string	May be used to filter dimensions by properties/category, properties/usageStart, properties/usageEnd. Supported operators are 'eq','lt', 'gt', 'le', 'ge'.
$skiptoken	string	Skiptoken is only used if a previous operation returned a partial result. If a previous response contains a nextLink element, the value of the nextLink element will include a skiptoken parameter that specifies a starting point to use for subsequent calls.
$top	integer (int32)	May be used to limit the number of results to the most recent N dimension data.

SELECT examples

list

Lists the dimensions by the defined scope.

SELECT
id,
name,
eTag,
location,
properties,
sku,
tags,
type
FROM azure.cost_management.dimensions
WHERE scope = '{{ scope }}' -- required
AND $filter = '{{ $filter }}'
AND $expand = '{{ $expand }}'
AND $skiptoken = '{{ $skiptoken }}'
AND $top = '{{ $top }}'
;

Lifecycle Methods

by_external_cloud_provider_type

Lists the dimensions by the external cloud provider type.

EXEC azure.cost_management.dimensions.by_external_cloud_provider_type 
@externalCloudProviderType='{{ externalCloudProviderType }}' --required, 
@externalCloudProviderId='{{ externalCloudProviderId }}' --required, 
@$filter='{{ $filter }}', 
@$expand='{{ $expand }}', 
@$skiptoken='{{ $skiptoken }}', 
@$top='{{ $top }}'
;