Share via

Dimensions - List

  • Reference
Service:
Cost Management
API Version:
2024-08-01

Lists the dimensions by the defined scope.

GET https://management.azure.com/{scope}/providers/Microsoft.CostManagement/dimensions?api-version=2024-08-01
With optional parameters: 
GET https://management.azure.com/{scope}/providers/Microsoft.CostManagement/dimensions?api-version=2024-08-01&$filter={$filter}&$expand={$expand}&$skiptoken={$skiptoken}&$top={$top}

URI Parameters

Name In Required Type Description
scope
 path True

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.
api-version
 query True

string

minLength: 1

The API version to use for this operation.
$expand
 query

string

May be used to expand the properties/data within a dimension category. By default, data is not included when listing dimensions.
$filter
 query

string

May be used to filter dimensions by properties/category, properties/usageStart, properties/usageEnd. Supported operators are 'eq','lt', 'gt', 'le', 'ge'.
$skiptoken
 query

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
 query

integer (int32)

minimum: 1
maximum: 1000

May be used to limit the number of results to the most recent N dimension data.

Responses

Name Type Description
200 OK

DimensionsListResult

OK. The request has succeeded.
204 No Content

No Content. Resource is not available.
Other Status Codes

ErrorResponse

Error response describing why the operation failed.

Security

azure_auth

Azure Active Directory OAuth2 Flow.

Type: oauth2
Flow: implicit
Authorization URL: https://login.microsoftonline.com/common/oauth2/authorize

Scopes

Name Description
user_impersonation impersonate your user account

Examples

BillingAccountDimensionsList-Legacy
BillingAccountDimensionsList-MCA
BillingAccountDimensionsListExpandAndTop-Legacy
BillingAccountDimensionsListExpandAndTop-MCA
BillingAccountDimensionsListWithFilter-Legacy
BillingAccountDimensionsListWithFilter-MCA
BillingProfileDimensionsList-MCA
BillingProfileDimensionsListExpandAndTop-MCA
BillingProfileDimensionsListWithFilter-MCA
CustomerDimensionsList-MCA
CustomerDimensionsListExpandAndTop-MCA
CustomerDimensionsListWithFilter-MCA
DepartmentDimensionsList-Legacy
DepartmentDimensionsListExpandAndTop-Legacy
DepartmentDimensionsListWithFilter-Legacy
EnrollmentAccountDimensionsList-Legacy
EnrollmentAccountDimensionsListExpandAndTop-Legacy
EnrollmentAccountDimensionsListWithFilter-Legacy
InvoiceSectionDimensionsList-MCA
InvoiceSectionDimensionsListExpandAndTop-MCA
InvoiceSectionDimensionsListWithFilter-MCA
ManagementGroupDimensionsList-Legacy
ManagementGroupDimensionsListExpandAndTop-Legacy
ManagementGroupDimensionsListWithFilter-Legacy
ResourceGroupDimensionsList-Legacy
SubscriptionDimensionsList-Legacy

BillingAccountDimensionsList-Legacy

Sample request

GET https://management.azure.com/providers/Microsoft.Billing/billingAccounts/100/providers/Microsoft.CostManagement/dimensions?api-version=2024-08-01

Sample response

Status code:
200 
{
  "value": [
    {
      "id": "providers/Microsoft.Billing/billingAccounts/100/providers/microsoft.CostManagement/dimensions_ResourceGroup_2018-05-01_2018-05-31",
      "name": "dimensions_ResourceGroup_2018-05-01_2018-05-31",
      "type": "microsoft.CostManagement/dimensions",
      "properties": {
        "data": [
          "thoroetrg01",
          "default-notificationhubs-westus",
          "jedikeyvaultrg",
          "contosocodeflow8d4a",
          "noobaa"
        ],
        "total": 377,
        "category": "ResourceGroup",
        "usageStart": "2018-05-01T00:00:00-07:00",
        "usageEnd": "2018-05-31T00:00:00-07:00",
        "description": "Resource group",
        "filterEnabled": true,
        "groupingEnabled": true
      }
    },
    {
      "id": "providers/Microsoft.Billing/billingAccounts/100/providers/microsoft.CostManagement/dimensions_ResourceType_2018-05-01_2018-05-31",
      "name": "dimensions_ResourceType_2018-05-01_2018-05-31",
      "type": "microsoft.CostManagement/dimensions",
      "properties": {
        "data": [
          "thoroetrg01",
          "default-notificationhubs-westus",
          "jedikeyvaultrg",
          "contosocodeflow8d4a",
          "noobaa"
        ],
        "total": 37,
        "category": "ResourceType",
        "usageStart": "2018-05-01T00:00:00-07:00",
        "usageEnd": "2018-05-31T00:00:00-07:00",
        "description": "Resource type",
        "filterEnabled": true,
        "groupingEnabled": true
      }
    }
  ]
}
Status code:
204

BillingAccountDimensionsList-MCA

Sample request

GET https://management.azure.com/providers/Microsoft.Billing/billingAccounts/12345:6789/providers/Microsoft.CostManagement/dimensions?api-version=2024-08-01

Sample response

Status code:
200 
{
  "value": [
    {
      "id": "providers/Microsoft.Billing/billingAccounts/12345:6789/providers/microsoft.CostManagement/dimensions_ResourceGroup_2019-10-01_2019-10-31",
      "name": "dimensions_ResourceGroup_2019-10-01_2019-10-31",
      "type": "microsoft.CostManagement/dimensions",
      "properties": {
        "data": [],
        "total": 377,
        "category": "ResourceGroup",
        "usageStart": "2019-10-01T00:00:00-07:00",
        "usageEnd": "2019-10-31T00:00:00-07:00",
        "description": "Resource group",
        "filterEnabled": true,
        "groupingEnabled": true
      }
    },
    {
      "id": "providers/Microsoft.Billing/billingAccounts/12345:6789/providers/microsoft.CostManagement/dimensions_ResourceType_2019-10-01_2019-10-31",
      "name": "dimensions_ResourceType_2019-10-01_2019-10-31",
      "type": "microsoft.CostManagement/dimensions",
      "properties": {
        "data": [],
        "total": 37,
        "category": "ResourceType",
        "usageStart": "2019-10-01T00:00:00-07:00",
        "usageEnd": "2019-10-31T00:00:00-07:00",
        "description": "Resource type",
        "filterEnabled": true,
        "groupingEnabled": true
      }
    }
  ]
}
Status code:
204

BillingAccountDimensionsListExpandAndTop-Legacy

Sample request

GET https://management.azure.com/providers/Microsoft.Billing/billingAccounts/100/providers/Microsoft.CostManagement/dimensions?api-version=2024-08-01&$expand=properties/data&$top=5

Sample response

Status code:
200 
{
  "value": [
    {
      "id": "providers/Microsoft.Billing/billingAccounts/100/providers/microsoft.CostManagement/dimensions_ResourceGroup_2018-05-01_2018-05-31_5",
      "name": "dimensions_ResourceGroup_2018-05-01_2018-05-31_5",
      "type": "microsoft.CostManagement/dimensions",
      "properties": {
        "data": [
          "thoroetrg01",
          "default-notificationhubs-westus",
          "jedikeyvaultrg",
          "contosocodeflow8d4a",
          "noobaa"
        ],
        "total": 377,
        "category": "ResourceGroup",
        "usageStart": "2018-05-01T00:00:00-07:00",
        "usageEnd": "2018-05-31T00:00:00-07:00",
        "description": "Resource group",
        "filterEnabled": true,
        "groupingEnabled": true
      }
    },
    {
      "id": "providers/Microsoft.Billing/billingAccounts/100/providers/microsoft.CostManagement/dimensions_ResourceType_2018-05-01_2018-05-31_5",
      "name": "dimensions_ResourceType_2018-05-01_2018-05-31_5",
      "type": "microsoft.CostManagement/dimensions",
      "properties": {
        "data": [
          "microsoft.automation/automationaccounts",
          "microsoft.databricks/workspaces",
          "microsoft.dbformysql/servers",
          "microsoft.containerregistry/registries",
          "microsoft.search/searchservices"
        ],
        "total": 37,
        "category": "ResourceType",
        "usageStart": "2018-05-01T00:00:00-07:00",
        "usageEnd": "2018-05-31T00:00:00-07:00",
        "description": "Resource type",
        "filterEnabled": true,
        "groupingEnabled": true
      }
    }
  ]
}
Status code:
204

BillingAccountDimensionsListExpandAndTop-MCA

Sample request

GET https://management.azure.com/providers/Microsoft.Billing/billingAccounts/12345:6789/providers/Microsoft.CostManagement/dimensions?api-version=2024-08-01&$expand=properties/data&$top=5

Sample response

Status code:
200 
{
  "value": [
    {
      "id": "providers/Microsoft.Billing/billingAccounts/12345:6789/providers/microsoft.CostManagement/dimensions_ResourceGroup_2019-10-01_2019-10-31",
      "name": "dimensions_ResourceGroup_2019-10-01_2019-10-31",
      "type": "microsoft.CostManagement/dimensions",
      "properties": {
        "data": [
          "thoroetrg01",
          "default-notificationhubs-westus",
          "jedikeyvaultrg",
          "contosocodeflow8d4a",
          "noobaa"
        ],
        "total": 377,
        "category": "ResourceGroup",
        "usageStart": "2019-10-01T00:00:00-07:00",
        "usageEnd": "2019-10-31T00:00:00-07:00",
        "description": "Resource group",
        "filterEnabled": true,
        "groupingEnabled": true
      }
    },
    {
      "id": "providers/Microsoft.Billing/billingAccounts/12345:6789/providers/microsoft.CostManagement/dimensions_ResourceType_2019-10-01_2019-10-31",
      "name": "dimensions_ResourceType_2019-10-01_2019-10-31",
      "type": "microsoft.CostManagement/dimensions",
      "properties": {
        "data": [
          "microsoft.automation/automationaccounts",
          "microsoft.databricks/workspaces",
          "microsoft.dbformysql/servers",
          "microsoft.containerregistry/registries",
          "microsoft.search/searchservices"
        ],
        "total": 37,
        "category": "ResourceType",
        "usageStart": "2019-10-01T00:00:00-07:00",
        "usageEnd": "2019-10-31T00:00:00-07:00",
        "description": "Resource type",
        "filterEnabled": true,
        "groupingEnabled": true
      }
    }
  ]
}
Status code:
204

BillingAccountDimensionsListWithFilter-Legacy

Sample request

GET https://management.azure.com/providers/Microsoft.Billing/billingAccounts/100/providers/Microsoft.CostManagement/dimensions?api-version=2024-08-01&$filter=properties/category eq 'resourceId'&$expand=properties/data&$top=5

Sample response

Status code:
200 
{
  "value": [
    {
      "id": "providers/Microsoft.Billing/billingAccounts/100/providers/microsoft.CostManagement/dimensions_ResourceId_2018-05-01_2018-05-31_5",
      "name": "dimensions_ResourceId_2018-05-01_2018-05-31_5",
      "type": "microsoft.CostManagement/dimensions",
      "properties": {
        "data": [
          "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/system.orlando/providers/microsoft.storage/storageaccounts/urphealthaccount",
          "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/system.orlando/providers/microsoft.storage/storageaccounts/srphytenaccount",
          "/subscriptions/67e24f6b-1ec2-4c90-993a-dc2d25b00b6c/resourcegroups/defaultresourcegroup-eus/providers/microsoft.operationalinsights/workspaces/defaultworkspace-67e24f6b-1ec2-4c90-993a-dc2d25b00b6c-eus",
          "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/rg-sql-ha/providers/microsoft.compute/virtualmachines/sql-4qqp1",
          "/subscriptions/a98d6dc5-eb8f-46cf-8938-f1fb08f03706/resourcegroups/databricks-rg-testwsp-xijmsdubneexm/providers/microsoft.compute/disks/488cdb42bf74474a98075415be3f806c-containerrootvolume"
        ],
        "total": 1409,
        "category": "ResourceId",
        "usageStart": "2018-05-01T00:00:00-07:00",
        "usageEnd": "2018-05-31T00:00:00-07:00",
        "description": "Resource Id",
        "filterEnabled": true,
        "groupingEnabled": true,
        "nextLink": "http://management.azure.com/providers/Microsoft.Billing/billingAccounts/100/providers/Microsoft.CostManagement/Dimensions?$filter=properties/category eq 'resourceId'&$top=5&api-version=2019-10-01&$expand=properties/data&$skiptoken=AQAAAA%3D%3D"
      }
    }
  ]
}
Status code:
204

BillingAccountDimensionsListWithFilter-MCA

Sample request

GET https://management.azure.com/providers/Microsoft.Billing/billingAccounts/12345:6789/providers/Microsoft.CostManagement/dimensions?api-version=2024-08-01&$filter=properties/category eq 'resourceId'&$expand=properties/data&$top=5

Sample response

Status code:
200 
{
  "value": [
    {
      "id": "providers/Microsoft.Billing/billingAccounts/12345:6789/providers/microsoft.CostManagement/dimensions_ResourceId_2019-10-01_2019-10-31",
      "name": "dimensions_ResourceId_2019-10-01_2019-10-31",
      "type": "microsoft.CostManagement/dimensions",
      "properties": {
        "data": [
          "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/system.orlando/providers/microsoft.storage/storageaccounts/urphealthaccount",
          "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/system.orlando/providers/microsoft.storage/storageaccounts/srphytenaccount",
          "/subscriptions/67e24f6b-1ec2-4c90-993a-dc2d25b00b6c/resourcegroups/defaultresourcegroup-eus/providers/microsoft.operationalinsights/workspaces/defaultworkspace-67e24f6b-1ec2-4c90-993a-dc2d25b00b6c-eus",
          "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/rg-sql-ha/providers/microsoft.compute/virtualmachines/sql-4qqp1",
          "/subscriptions/a98d6dc5-eb8f-46cf-8938-f1fb08f03706/resourcegroups/databricks-rg-testwsp-xijmsdubneexm/providers/microsoft.compute/disks/488cdb42bf74474a98075415be3f806c-containerrootvolume"
        ],
        "total": 1409,
        "category": "ResourceId",
        "usageStart": "2019-10-01T00:00:00-07:00",
        "usageEnd": "2019-10-31T00:00:00-07:00",
        "description": "Resource Id",
        "filterEnabled": true,
        "groupingEnabled": true,
        "nextLink": "http://management.azure.com/providers/Microsoft.Billing/billingAccounts/12345:6789/providers/Microsoft.CostManagement/Dimensions?$filter=properties/category eq 'resourceId'&$top=5&api-version=2019-10-01&$expand=properties/data&$skiptoken=AQAAAA%3D%3D"
      }
    }
  ]
}
Status code:
204

BillingProfileDimensionsList-MCA

Sample request

GET https://management.azure.com/providers/Microsoft.Billing/billingAccounts/12345:6789/billingProfiles/13579/providers/Microsoft.CostManagement/dimensions?api-version=2024-08-01

Sample response

Status code:
200 
{
  "value": [
    {
      "id": "providers/Microsoft.Billing/billingAccounts/12345:6789/billingProfiles/13579/providers/microsoft.CostManagement/dimensions_ResourceGroup_2019-10-01_2019-10-31",
      "name": "dimensions_ResourceGroup_2019-10-01_2019-10-31",
      "type": "microsoft.CostManagement/dimensions",
      "properties": {
        "data": [],
        "total": 377,
        "category": "ResourceGroup",
        "usageStart": "2019-10-01T00:00:00-07:00",
        "usageEnd": "2019-10-31T00:00:00-07:00",
        "description": "Resource group",
        "filterEnabled": true,
        "groupingEnabled": true
      }
    },
    {
      "id": "providers/Microsoft.Billing/billingAccounts/12345:6789/billingProfiles/13579/providers/microsoft.CostManagement/dimensions_ResourceType_2019-10-01_2019-10-31",
      "name": "dimensions_ResourceType_2019-10-01_2019-10-31",
      "type": "microsoft.CostManagement/dimensions",
      "properties": {
        "data": [],
        "total": 37,
        "category": "ResourceType",
        "usageStart": "2019-10-01T00:00:00-07:00",
        "usageEnd": "2019-10-31T00:00:00-07:00",
        "description": "Resource type",
        "filterEnabled": true,
        "groupingEnabled": true
      }
    }
  ]
}
Status code:
204

BillingProfileDimensionsListExpandAndTop-MCA

Sample request

GET https://management.azure.com/providers/Microsoft.Billing/billingAccounts/12345:6789/billingProfiles/13579/providers/Microsoft.CostManagement/dimensions?api-version=2024-08-01&$expand=properties/data&$top=5

Sample response

Status code:
200 
{
  "value": [
    {
      "id": "providers/Microsoft.Billing/billingAccounts/12345:6789/billingProfiles/13579/providers/microsoft.CostManagement/dimensions_ResourceGroup_2019-10-01_2019-10-31",
      "name": "dimensions_ResourceGroup_2019-10-01_2019-10-31",
      "type": "microsoft.CostManagement/dimensions",
      "properties": {
        "data": [
          "thoroetrg01",
          "default-notificationhubs-westus",
          "jedikeyvaultrg",
          "contosocodeflow8d4a",
          "noobaa"
        ],
        "total": 377,
        "category": "ResourceGroup",
        "usageStart": "2019-10-01T00:00:00-07:00",
        "usageEnd": "2019-10-31T00:00:00-07:00",
        "description": "Resource group",
        "filterEnabled": true,
        "groupingEnabled": true
      }
    },
    {
      "id": "providers/Microsoft.Billing/billingAccounts/12345:6789/billingProfiles/13579/providers/microsoft.CostManagement/dimensions_ResourceType_2019-10-01_2019-10-31",
      "name": "dimensions_ResourceType_2019-10-01_2019-10-31",
      "type": "microsoft.CostManagement/dimensions",
      "properties": {
        "data": [
          "microsoft.automation/automationaccounts",
          "microsoft.databricks/workspaces",
          "microsoft.dbformysql/servers",
          "microsoft.containerregistry/registries",
          "microsoft.search/searchservices"
        ],
        "total": 37,
        "category": "ResourceType",
        "usageStart": "2019-10-01T00:00:00-07:00",
        "usageEnd": "2019-10-31T00:00:00-07:00",
        "description": "Resource type",
        "filterEnabled": true,
        "groupingEnabled": true
      }
    }
  ]
}
Status code:
204

BillingProfileDimensionsListWithFilter-MCA

Sample request

GET https://management.azure.com/providers/Microsoft.Billing/billingAccounts/12345:6789/billingProfiles/13579/providers/Microsoft.CostManagement/dimensions?api-version=2024-08-01&$filter=properties/category eq 'resourceId'&$expand=properties/data&$top=5

Sample response

Status code:
200 
{
  "value": [
    {
      "id": "providers/Microsoft.Billing/billingAccounts/12345:6789/billingProfiles/13579/providers/microsoft.CostManagement/dimensions_ResourceId_2019-10-01_2019-10-31",
      "name": "dimensions_ResourceId_2019-10-01_2019-10-31",
      "type": "microsoft.CostManagement/dimensions",
      "properties": {
        "data": [
          "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/system.orlando/providers/microsoft.storage/storageaccounts/urphealthaccount",
          "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/system.orlando/providers/microsoft.storage/storageaccounts/srphytenaccount",
          "/subscriptions/67e24f6b-1ec2-4c90-993a-dc2d25b00b6c/resourcegroups/defaultresourcegroup-eus/providers/microsoft.operationalinsights/workspaces/defaultworkspace-67e24f6b-1ec2-4c90-993a-dc2d25b00b6c-eus",
          "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/rg-sql-ha/providers/microsoft.compute/virtualmachines/sql-4qqp1",
          "/subscriptions/a98d6dc5-eb8f-46cf-8938-f1fb08f03706/resourcegroups/databricks-rg-testwsp-xijmsdubneexm/providers/microsoft.compute/disks/488cdb42bf74474a98075415be3f806c-containerrootvolume"
        ],
        "total": 1409,
        "category": "ResourceId",
        "usageStart": "2019-10-01T00:00:00-07:00",
        "usageEnd": "2019-10-31T00:00:00-07:00",
        "description": "Resource Id",
        "filterEnabled": true,
        "groupingEnabled": true,
        "nextLink": "http://management.azure.com/providers/Microsoft.Billing/billingAccounts/12345:6789/billingProfiles/13579/providers/Microsoft.CostManagement/Dimensions?$filter=properties/category eq 'resourceId'&$top=5&api-version=2019-10-01&$expand=properties/data&$skiptoken=AQAAAA%3D%3D"
      }
    }
  ]
}
Status code:
204

CustomerDimensionsList-MCA

Sample request

GET https://management.azure.com/providers/Microsoft.Billing/billingAccounts/12345:6789/customers/5678/providers/Microsoft.CostManagement/dimensions?api-version=2024-08-01

Sample response

Status code:
200 
{
  "value": [
    {
      "id": "providers/Microsoft.Billing/billingAccounts/12345:6789/customers/5678/providers/microsoft.CostManagement/dimensions_ResourceGroup_2019-10-01_2019-10-31",
      "name": "dimensions_ResourceGroup_2019-10-01_2019-10-31",
      "type": "microsoft.CostManagement/dimensions",
      "properties": {
        "data": [],
        "total": 377,
        "category": "ResourceGroup",
        "usageStart": "2019-10-01T00:00:00-07:00",
        "usageEnd": "2019-10-31T00:00:00-07:00",
        "description": "Resource group",
        "filterEnabled": true,
        "groupingEnabled": true
      }
    },
    {
      "id": "providers/Microsoft.Billing/billingAccounts/12345:6789/customers/5678/providers/microsoft.CostManagement/dimensions_ResourceType_2019-10-01_2019-10-31",
      "name": "dimensions_ResourceType_2019-10-01_2019-10-31",
      "type": "microsoft.CostManagement/dimensions",
      "properties": {
        "data": [],
        "total": 37,
        "category": "ResourceType",
        "usageStart": "2019-10-01T00:00:00-07:00",
        "usageEnd": "2019-10-31T00:00:00-07:00",
        "description": "Resource type",
        "filterEnabled": true,
        "groupingEnabled": true
      }
    }
  ]
}
Status code:
204

CustomerDimensionsListExpandAndTop-MCA

Sample request

GET https://management.azure.com/providers/Microsoft.Billing/billingAccounts/12345:6789/customers/5678/providers/Microsoft.CostManagement/dimensions?api-version=2024-08-01&$expand=properties/data&$top=5

Sample response

Status code:
200 
{
  "value": [
    {
      "id": "providers/Microsoft.Billing/billingAccounts/12345:6789/customers/5678/providers/microsoft.CostManagement/dimensions_ResourceGroup_2019-10-01_2019-10-31",
      "name": "dimensions_ResourceGroup_2019-10-01_2019-10-31",
      "type": "microsoft.CostManagement/dimensions",
      "properties": {
        "data": [
          "thoroetrg01",
          "default-notificationhubs-westus",
          "jedikeyvaultrg",
          "contosocodeflow8d4a",
          "noobaa"
        ],
        "total": 377,
        "category": "ResourceGroup",
        "usageStart": "2019-10-01T00:00:00-07:00",
        "usageEnd": "2019-10-31T00:00:00-07:00",
        "description": "Resource group",
        "filterEnabled": true,
        "groupingEnabled": true
      }
    },
    {
      "id": "providers/Microsoft.Billing/billingAccounts/12345:6789/customers/5678/providers/microsoft.CostManagement/dimensions_ResourceType_2019-10-01_2019-10-31",
      "name": "dimensions_ResourceType_2019-10-01_2019-10-31",
      "type": "microsoft.CostManagement/dimensions",
      "properties": {
        "data": [
          "microsoft.automation/automationaccounts",
          "microsoft.databricks/workspaces",
          "microsoft.dbformysql/servers",
          "microsoft.containerregistry/registries",
          "microsoft.search/searchservices"
        ],
        "total": 37,
        "category": "ResourceType",
        "usageStart": "2019-10-01T00:00:00-07:00",
        "usageEnd": "2019-10-31T00:00:00-07:00",
        "description": "Resource type",
        "filterEnabled": true,
        "groupingEnabled": true
      }
    }
  ]
}
Status code:
204

CustomerDimensionsListWithFilter-MCA

Sample request

GET https://management.azure.com/providers/Microsoft.Billing/billingAccounts/12345:6789/customers/5678/providers/Microsoft.CostManagement/dimensions?api-version=2024-08-01&$filter=properties/category eq 'resourceId'&$expand=properties/data&$top=5

Sample response

Status code:
200 
{
  "value": [
    {
      "id": "providers/Microsoft.Billing/billingAccounts/12345:6789/customers/5678/providers/microsoft.CostManagement/dimensions_ResourceId_2019-10-01_2019-10-31",
      "name": "dimensions_ResourceId_2019-10-01_2019-10-31",
      "type": "microsoft.CostManagement/dimensions",
      "properties": {
        "data": [
          "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/system.orlando/providers/microsoft.storage/storageaccounts/urphealthaccount",
          "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/system.orlando/providers/microsoft.storage/storageaccounts/srphytenaccount",
          "/subscriptions/67e24f6b-1ec2-4c90-993a-dc2d25b00b6c/resourcegroups/defaultresourcegroup-eus/providers/microsoft.operationalinsights/workspaces/defaultworkspace-67e24f6b-1ec2-4c90-993a-dc2d25b00b6c-eus",
          "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/rg-sql-ha/providers/microsoft.compute/virtualmachines/sql-4qqp1",
          "/subscriptions/a98d6dc5-eb8f-46cf-8938-f1fb08f03706/resourcegroups/databricks-rg-testwsp-xijmsdubneexm/providers/microsoft.compute/disks/488cdb42bf74474a98075415be3f806c-containerrootvolume"
        ],
        "total": 1409,
        "category": "ResourceId",
        "usageStart": "2019-10-01T00:00:00-07:00",
        "usageEnd": "2019-10-31T00:00:00-07:00",
        "description": "Resource Id",
        "filterEnabled": true,
        "groupingEnabled": true,
        "nextLink": "http://management.azure.com/providers/Microsoft.Billing/billingAccounts/12345:6789/customers/5678/providers/Microsoft.CostManagement/Dimensions?$filter=properties/category eq 'resourceId'&$top=5&api-version=2019-10-01&$expand=properties/data&$skiptoken=AQAAAA%3D%3D"
      }
    }
  ]
}
Status code:
204

DepartmentDimensionsList-Legacy

Sample request

GET https://management.azure.com/providers/Microsoft.Billing/billingAccounts/100/departments/123/providers/Microsoft.CostManagement/dimensions?api-version=2024-08-01

Sample response

Status code:
200 
{
  "value": [
    {
      "id": "providers/Microsoft.Billing/billingAccounts/100/departments/123/providers/microsoft.CostManagement/dimensions_ResourceGroup_2018-05-01_2018-05-31",
      "name": "dimensions_ResourceGroup_2018-05-01_2018-05-31",
      "type": "microsoft.CostManagement/dimensions",
      "properties": {
        "data": [
          "thoroetrg01",
          "default-notificationhubs-westus",
          "jedikeyvaultrg",
          "contosocodeflow8d4a",
          "noobaa"
        ],
        "total": 377,
        "category": "ResourceGroup",
        "usageStart": "2018-05-01T00:00:00-07:00",
        "usageEnd": "2018-05-31T00:00:00-07:00",
        "description": "Resource group",
        "filterEnabled": true,
        "groupingEnabled": true
      }
    },
    {
      "id": "providers/Microsoft.Billing/billingAccounts/100/departments/123/providers/microsoft.CostManagement/dimensions_ResourceType_2018-05-01_2018-05-31",
      "name": "dimensions_ResourceType_2018-05-01_2018-05-31",
      "type": "microsoft.CostManagement/dimensions",
      "properties": {
        "data": [
          "thoroetrg01",
          "default-notificationhubs-westus",
          "jedikeyvaultrg",
          "contosocodeflow8d4a",
          "noobaa"
        ],
        "total": 37,
        "category": "ResourceType",
        "usageStart": "2018-05-01T00:00:00-07:00",
        "usageEnd": "2018-05-31T00:00:00-07:00",
        "description": "Resource type",
        "filterEnabled": true,
        "groupingEnabled": true
      }
    }
  ]
}
Status code:
204

DepartmentDimensionsListExpandAndTop-Legacy

Sample request

GET https://management.azure.com/providers/Microsoft.Billing/billingAccounts/100/departments/123/providers/Microsoft.CostManagement/dimensions?api-version=2024-08-01&$expand=properties/data&$top=5

Sample response

Status code:
200 
{
  "value": [
    {
      "id": "providers/Microsoft.Billing/billingAccounts/100/departments/123/providers/microsoft.CostManagement/dimensions_ResourceGroup_2018-05-01_2018-05-31_5",
      "name": "dimensions_ResourceGroup_2018-05-01_2018-05-31_5",
      "type": "microsoft.CostManagement/dimensions",
      "properties": {
        "data": [
          "thoroetrg01",
          "default-notificationhubs-westus",
          "jedikeyvaultrg",
          "contosocodeflow8d4a",
          "noobaa"
        ],
        "total": 377,
        "category": "ResourceGroup",
        "usageStart": "2018-05-01T00:00:00-07:00",
        "usageEnd": "2018-05-31T00:00:00-07:00",
        "description": "Resource group",
        "filterEnabled": true,
        "groupingEnabled": true
      }
    },
    {
      "id": "providers/Microsoft.Billing/billingAccounts/100/departments/123/providers/microsoft.CostManagement/dimensions_ResourceType_2018-05-01_2018-05-31_5",
      "name": "dimensions_ResourceType_2018-05-01_2018-05-31_5",
      "type": "microsoft.CostManagement/dimensions",
      "properties": {
        "data": [
          "microsoft.automation/automationaccounts",
          "microsoft.databricks/workspaces",
          "microsoft.dbformysql/servers",
          "microsoft.containerregistry/registries",
          "microsoft.search/searchservices"
        ],
        "total": 37,
        "category": "ResourceType",
        "usageStart": "2018-05-01T00:00:00-07:00",
        "usageEnd": "2018-05-31T00:00:00-07:00",
        "description": "Resource type",
        "filterEnabled": true,
        "groupingEnabled": true
      }
    }
  ]
}
Status code:
204

DepartmentDimensionsListWithFilter-Legacy

Sample request

GET https://management.azure.com/providers/Microsoft.Billing/billingAccounts/100/departments/123/providers/Microsoft.CostManagement/dimensions?api-version=2024-08-01&$filter=properties/category eq 'resourceId'&$expand=properties/data&$top=5

Sample response

Status code:
200 
{
  "value": [
    {
      "id": "providers/Microsoft.Billing/billingAccounts/100/departments/123/providers/microsoft.CostManagement/dimensions_ResourceId_2018-05-01_2018-05-31_5",
      "name": "dimensions_ResourceId_2018-05-01_2018-05-31_5",
      "type": "microsoft.CostManagement/dimensions",
      "properties": {
        "data": [
          "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/system.orlando/providers/microsoft.storage/storageaccounts/urphealthaccount",
          "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/system.orlando/providers/microsoft.storage/storageaccounts/srphytenaccount",
          "/subscriptions/67e24f6b-1ec2-4c90-993a-dc2d25b00b6c/resourcegroups/defaultresourcegroup-eus/providers/microsoft.operationalinsights/workspaces/defaultworkspace-67e24f6b-1ec2-4c90-993a-dc2d25b00b6c-eus",
          "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/rg-sql-ha/providers/microsoft.compute/virtualmachines/sql-4qqp1",
          "/subscriptions/a98d6dc5-eb8f-46cf-8938-f1fb08f03706/resourcegroups/databricks-rg-testwsp-xijmsdubneexm/providers/microsoft.compute/disks/488cdb42bf74474a98075415be3f806c-containerrootvolume"
        ],
        "total": 1409,
        "category": "ResourceId",
        "usageStart": "2018-05-01T00:00:00-07:00",
        "usageEnd": "2018-05-31T00:00:00-07:00",
        "description": "Resource Id",
        "filterEnabled": true,
        "groupingEnabled": true,
        "nextLink": "https://management.azure.com/providers/Microsoft.Billing/billingAccounts/100/departments/123/providers/Microsoft.CostManagement/Dimensions?$filter=properties/category eq 'resourceId'&$top=5&api-version=2019-10-01&$expand=properties/data&$skiptoken=AQAAAA%3D%3D"
      }
    }
  ]
}
Status code:
204

EnrollmentAccountDimensionsList-Legacy

Sample request

GET https://management.azure.com/providers/Microsoft.Billing/billingAccounts/100/enrollmentAccounts/456/providers/Microsoft.CostManagement/dimensions?api-version=2024-08-01

Sample response

Status code:
200 
{
  "value": [
    {
      "id": "providers/Microsoft.Billing/billingAccounts/100/enrollmentAccounts/456/providers/microsoft.CostManagement/dimensions_ResourceGroup_2018-05-01_2018-05-31",
      "name": "dimensions_ResourceGroup_2018-05-01_2018-05-31",
      "type": "microsoft.CostManagement/dimensions",
      "properties": {
        "data": [],
        "total": 377,
        "category": "ResourceGroup",
        "usageStart": "2018-05-01T00:00:00-07:00",
        "usageEnd": "2018-05-31T00:00:00-07:00",
        "description": "Resource group",
        "filterEnabled": true,
        "groupingEnabled": true
      }
    },
    {
      "id": "providers/Microsoft.Billing/billingAccounts/100/enrollmentAccounts/456/providers/microsoft.CostManagement/dimensions_ResourceType_2018-05-01_2018-05-31",
      "name": "dimensions_ResourceType_2018-05-01_2018-05-31",
      "type": "microsoft.CostManagement/dimensions",
      "properties": {
        "data": [],
        "total": 37,
        "category": "ResourceType",
        "usageStart": "2018-05-01T00:00:00-07:00",
        "usageEnd": "2018-05-31T00:00:00-07:00",
        "description": "Resource type",
        "filterEnabled": true,
        "groupingEnabled": true
      }
    }
  ]
}
Status code:
204

EnrollmentAccountDimensionsListExpandAndTop-Legacy

Sample request

GET https://management.azure.com/providers/Microsoft.Billing/billingAccounts/100/enrollmentAccounts/456/providers/Microsoft.CostManagement/dimensions?api-version=2024-08-01&$expand=properties/data&$top=5

Sample response

Status code:
200 
{
  "value": [
    {
      "id": "providers/Microsoft.Billing/billingAccounts/100/enrollmentAccounts/456/providers/microsoft.CostManagement/dimensions_ResourceGroup_2018-05-01_2018-05-31_5",
      "name": "dimensions_ResourceGroup_2018-05-01_2018-05-31_5",
      "type": "microsoft.CostManagement/dimensions",
      "properties": {
        "data": [
          "thoroetrg01",
          "default-notificationhubs-westus",
          "jedikeyvaultrg",
          "contosocodeflow8d4a",
          "noobaa"
        ],
        "total": 377,
        "category": "ResourceGroup",
        "usageStart": "2018-05-01T00:00:00-07:00",
        "usageEnd": "2018-05-31T00:00:00-07:00",
        "description": "Resource group",
        "filterEnabled": true,
        "groupingEnabled": true
      }
    },
    {
      "id": "providers/Microsoft.Billing/billingAccounts/100/enrollmentAccounts/456/providers/microsoft.CostManagement/dimensions_ResourceType_2018-05-01_2018-05-31_5",
      "name": "dimensions_ResourceType_2018-05-01_2018-05-31_5",
      "type": "microsoft.CostManagement/dimensions",
      "properties": {
        "data": [
          "microsoft.automation/automationaccounts",
          "microsoft.databricks/workspaces",
          "microsoft.dbformysql/servers",
          "microsoft.containerregistry/registries",
          "microsoft.search/searchservices"
        ],
        "total": 37,
        "category": "ResourceType",
        "usageStart": "2018-05-01T00:00:00-07:00",
        "usageEnd": "2018-05-31T00:00:00-07:00",
        "description": "Resource type",
        "filterEnabled": true,
        "groupingEnabled": true
      }
    }
  ]
}
Status code:
204

EnrollmentAccountDimensionsListWithFilter-Legacy

Sample request

GET https://management.azure.com/providers/Microsoft.Billing/billingAccounts/100/enrollmentAccounts/456/providers/Microsoft.CostManagement/dimensions?api-version=2024-08-01&$filter=properties/category eq 'resourceId'&$expand=properties/data&$top=5

Sample response

Status code:
200 
{
  "value": [
    {
      "id": "providers/Microsoft.Billing/billingAccounts/100/enrollmentAccounts/456/providers/microsoft.CostManagement/dimensions_ResourceId_2018-05-01_2018-05-31_5",
      "name": "dimensions_ResourceId_2018-05-01_2018-05-31_5",
      "type": "microsoft.CostManagement/dimensions",
      "properties": {
        "data": [
          "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/system.orlando/providers/microsoft.storage/storageaccounts/urphealthaccount",
          "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/system.orlando/providers/microsoft.storage/storageaccounts/srphytenaccount",
          "/subscriptions/67e24f6b-1ec2-4c90-993a-dc2d25b00b6c/resourcegroups/defaultresourcegroup-eus/providers/microsoft.operationalinsights/workspaces/defaultworkspace-67e24f6b-1ec2-4c90-993a-dc2d25b00b6c-eus",
          "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/rg-sql-ha/providers/microsoft.compute/virtualmachines/sql-4qqp1",
          "/subscriptions/a98d6dc5-eb8f-46cf-8938-f1fb08f03706/resourcegroups/databricks-rg-testwsp-xijmsdubneexm/providers/microsoft.compute/disks/488cdb42bf74474a98075415be3f806c-containerrootvolume"
        ],
        "total": 1409,
        "category": "ResourceId",
        "usageStart": "2018-05-01T00:00:00-07:00",
        "usageEnd": "2018-05-31T00:00:00-07:00",
        "description": "Resource Id",
        "filterEnabled": true,
        "groupingEnabled": true,
        "nextLink": "https://management.azure.com/providers/Microsoft.Billing/billingAccounts/100/enrollmentAccounts/456/providers/Microsoft.CostManagement/Dimensions?$filter=properties/category eq 'resourceId'&$top=5&api-version=2019-10-01&$expand=properties/data&$skiptoken=AQAAAA%3D%3D"
      }
    }
  ]
}
Status code:
204

InvoiceSectionDimensionsList-MCA

Sample request

GET https://management.azure.com/providers/Microsoft.Billing/billingAccounts/12345:6789/billingProfiles/13579/invoiceSections/9876/providers/Microsoft.CostManagement/dimensions?api-version=2024-08-01

Sample response

Status code:
200 
{
  "value": [
    {
      "id": "providers/Microsoft.Billing/billingAccounts/12345:6789/billingProfiles/13579/invoiceSections/9876/providers/microsoft.CostManagement/dimensions_ResourceGroup_2019-10-01_2019-10-31",
      "name": "dimensions_ResourceGroup_2019-10-01_2019-10-31",
      "type": "microsoft.CostManagement/dimensions",
      "properties": {
        "data": [],
        "total": 377,
        "category": "ResourceGroup",
        "usageStart": "2019-10-01T00:00:00-07:00",
        "usageEnd": "2019-10-31T00:00:00-07:00",
        "description": "Resource group",
        "filterEnabled": true,
        "groupingEnabled": true
      }
    },
    {
      "id": "providers/Microsoft.Billing/billingAccounts/12345:6789/billingProfiles/13579/invoiceSections/9876/providers/microsoft.CostManagement/dimensions_ResourceType_2019-10-01_2019-10-31",
      "name": "dimensions_ResourceType_2019-10-01_2019-10-31",
      "type": "microsoft.CostManagement/dimensions",
      "properties": {
        "data": [],
        "total": 37,
        "category": "ResourceType",
        "usageStart": "2019-10-01T00:00:00-07:00",
        "usageEnd": "2019-10-31T00:00:00-07:00",
        "description": "Resource type",
        "filterEnabled": true,
        "groupingEnabled": true
      }
    }
  ]
}
Status code:
204

InvoiceSectionDimensionsListExpandAndTop-MCA

Sample request

GET https://management.azure.com/providers/Microsoft.Billing/billingAccounts/12345:6789/billingProfiles/13579/invoiceSections/9876/providers/Microsoft.CostManagement/dimensions?api-version=2024-08-01&$expand=properties/data&$top=5

Sample response

Status code:
200 
{
  "value": [
    {
      "id": "providers/Microsoft.Billing/billingAccounts/12345:6789/billingProfiles/13579/invoiceSections/9876/providers/microsoft.CostManagement/dimensions_ResourceGroup_2019-10-01_2019-10-31",
      "name": "dimensions_ResourceGroup_2019-10-01_2019-10-31",
      "type": "microsoft.CostManagement/dimensions",
      "properties": {
        "data": [
          "thoroetrg01",
          "default-notificationhubs-westus",
          "jedikeyvaultrg",
          "contosocodeflow8d4a",
          "noobaa"
        ],
        "total": 377,
        "category": "ResourceGroup",
        "usageStart": "2019-10-01T00:00:00-07:00",
        "usageEnd": "2019-10-31T00:00:00-07:00",
        "description": "Resource group",
        "filterEnabled": true,
        "groupingEnabled": true
      }
    },
    {
      "id": "providers/Microsoft.Billing/billingAccounts/12345:6789/billingProfiles/13579/invoiceSections/9876/providers/microsoft.CostManagement/dimensions_ResourceType_2019-10-01_2019-10-31",
      "name": "dimensions_ResourceType_2019-10-01_2019-10-31",
      "type": "microsoft.CostManagement/dimensions",
      "properties": {
        "data": [
          "microsoft.automation/automationaccounts",
          "microsoft.databricks/workspaces",
          "microsoft.dbformysql/servers",
          "microsoft.containerregistry/registries",
          "microsoft.search/searchservices"
        ],
        "total": 37,
        "category": "ResourceType",
        "usageStart": "2019-10-01T00:00:00-07:00",
        "usageEnd": "2019-10-31T00:00:00-07:00",
        "description": "Resource type",
        "filterEnabled": true,
        "groupingEnabled": true
      }
    }
  ]
}
Status code:
204

InvoiceSectionDimensionsListWithFilter-MCA

Sample request

GET https://management.azure.com/providers/Microsoft.Billing/billingAccounts/12345:6789/billingProfiles/13579/invoiceSections/9876/providers/Microsoft.CostManagement/dimensions?api-version=2024-08-01&$filter=properties/category eq 'resourceId'&$expand=properties/data&$top=5

Sample response

Status code:
200 
{
  "value": [
    {
      "id": "providers/Microsoft.Billing/billingAccounts/12345:6789/billingProfiles/13579/invoiceSections/9876/providers/microsoft.CostManagement/dimensions_ResourceId_2019-10-01_2019-10-31",
      "name": "dimensions_ResourceId_2019-10-01_2019-10-31",
      "type": "microsoft.CostManagement/dimensions",
      "properties": {
        "data": [
          "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/system.orlando/providers/microsoft.storage/storageaccounts/urphealthaccount",
          "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/system.orlando/providers/microsoft.storage/storageaccounts/srphytenaccount",
          "/subscriptions/67e24f6b-1ec2-4c90-993a-dc2d25b00b6c/resourcegroups/defaultresourcegroup-eus/providers/microsoft.operationalinsights/workspaces/defaultworkspace-67e24f6b-1ec2-4c90-993a-dc2d25b00b6c-eus",
          "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/rg-sql-ha/providers/microsoft.compute/virtualmachines/sql-4qqp1",
          "/subscriptions/a98d6dc5-eb8f-46cf-8938-f1fb08f03706/resourcegroups/databricks-rg-testwsp-xijmsdubneexm/providers/microsoft.compute/disks/488cdb42bf74474a98075415be3f806c-containerrootvolume"
        ],
        "total": 1409,
        "category": "ResourceId",
        "usageStart": "2019-10-01T00:00:00-07:00",
        "usageEnd": "2019-10-31T00:00:00-07:00",
        "description": "Resource Id",
        "filterEnabled": true,
        "groupingEnabled": true,
        "nextLink": "http://management.azure.com/providers/Microsoft.Billing/billingAccounts/12345:6789/billingProfiles/13579/invoiceSections/9876/providers/Microsoft.CostManagement/Dimensions?$filter=properties/category eq 'resourceId'&$top=5&api-version=2019-10-01&$expand=properties/data&$skiptoken=AQAAAA%3D%3D"
      }
    }
  ]
}
Status code:
204

ManagementGroupDimensionsList-Legacy

Sample request

GET https://management.azure.com/providers/Microsoft.Management/managementGroups/MyMgId/providers/Microsoft.CostManagement/dimensions?api-version=2024-08-01

Sample response

Status code:
200 
{
  "value": [
    {
      "id": "providers/Microsoft.Management/managementGroups/MyMgId/providers/microsoft.CostManagement/dimensions_ResourceGroup_2018-05-01_2018-05-31",
      "name": "dimensions_ResourceGroup_2018-05-01_2018-05-31",
      "type": "microsoft.CostManagement/dimensions",
      "properties": {
        "data": [],
        "total": 377,
        "category": "ResourceGroup",
        "usageStart": "2018-05-01T00:00:00-07:00",
        "usageEnd": "2018-05-31T00:00:00-07:00",
        "description": "Resource group",
        "filterEnabled": true,
        "groupingEnabled": true
      }
    },
    {
      "id": "providers/Microsoft.Management/managementGroups/MyMgId/providers/microsoft.CostManagement/dimensions_ResourceType_2018-05-01_2018-05-31",
      "name": "dimensions_ResourceType_2018-05-01_2018-05-31",
      "type": "microsoft.CostManagement/dimensions",
      "properties": {
        "data": [],
        "total": 37,
        "category": "ResourceType",
        "usageStart": "2018-05-01T00:00:00-07:00",
        "usageEnd": "2018-05-31T00:00:00-07:00",
        "description": "Resource type",
        "filterEnabled": true,
        "groupingEnabled": true
      }
    }
  ]
}
Status code:
204

ManagementGroupDimensionsListExpandAndTop-Legacy

Sample request

GET https://management.azure.com/providers/Microsoft.Management/managementGroups/MyMgId/providers/Microsoft.CostManagement/dimensions?api-version=2024-08-01&$expand=properties/data&$top=5

Sample response

Status code:
200 
{
  "value": [
    {
      "id": "providers/Microsoft.Management/managementGroups/MyMgId/providers/microsoft.CostManagement/dimensions_ResourceGroup_2018-05-01_2018-05-31_5",
      "name": "dimensions_ResourceGroup_2018-05-01_2018-05-31_5",
      "type": "microsoft.CostManagement/dimensions",
      "properties": {
        "data": [
          "thoroetrg01",
          "default-notificationhubs-westus",
          "jedikeyvaultrg",
          "contosocodeflow8d4a",
          "noobaa"
        ],
        "total": 377,
        "category": "ResourceGroup",
        "usageStart": "2018-05-01T00:00:00-07:00",
        "usageEnd": "2018-05-31T00:00:00-07:00",
        "description": "Resource group",
        "filterEnabled": true,
        "groupingEnabled": true
      }
    },
    {
      "id": "providers/Microsoft.Management/managementGroups/MyMgId/providers/microsoft.CostManagement/dimensions_ResourceType_2018-05-01_2018-05-31_5",
      "name": "dimensions_ResourceType_2018-05-01_2018-05-31_5",
      "type": "microsoft.CostManagement/dimensions",
      "properties": {
        "data": [
          "microsoft.automation/automationaccounts",
          "microsoft.databricks/workspaces",
          "microsoft.dbformysql/servers",
          "microsoft.containerregistry/registries",
          "microsoft.search/searchservices"
        ],
        "total": 37,
        "category": "ResourceType",
        "usageStart": "2018-05-01T00:00:00-07:00",
        "usageEnd": "2018-05-31T00:00:00-07:00",
        "description": "Resource type",
        "filterEnabled": true,
        "groupingEnabled": true
      }
    }
  ]
}
Status code:
204

ManagementGroupDimensionsListWithFilter-Legacy

Sample request

GET https://management.azure.com/providers/Microsoft.Management/managementGroups/MyMgId/providers/Microsoft.CostManagement/dimensions?api-version=2024-08-01&$filter=properties/category eq 'resourceId'&$expand=properties/data&$top=5

Sample response

Status code:
200 
{
  "value": [
    {
      "id": "providers/Microsoft.Management/managementGroups/MyMgId/providers/microsoft.CostManagement/dimensions_ResourceId_2018-05-01_2018-05-31_5",
      "name": "dimensions_ResourceId_2018-05-01_2018-05-31_5",
      "type": "microsoft.CostManagement/dimensions",
      "properties": {
        "data": [
          "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/system.orlando/providers/microsoft.storage/storageaccounts/urphealthaccount",
          "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/system.orlando/providers/microsoft.storage/storageaccounts/srphytenaccount",
          "/subscriptions/67e24f6b-1ec2-4c90-993a-dc2d25b00b6c/resourcegroups/defaultresourcegroup-eus/providers/microsoft.operationalinsights/workspaces/defaultworkspace-67e24f6b-1ec2-4c90-993a-dc2d25b00b6c-eus",
          "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/rg-sql-ha/providers/microsoft.compute/virtualmachines/sql-4qqp1",
          "/subscriptions/a98d6dc5-eb8f-46cf-8938-f1fb08f03706/resourcegroups/databricks-rg-testwsp-xijmsdubneexm/providers/microsoft.compute/disks/488cdb42bf74474a98075415be3f806c-containerrootvolume"
        ],
        "total": 1409,
        "category": "ResourceId",
        "usageStart": "2018-05-01T00:00:00-07:00",
        "usageEnd": "2018-05-31T00:00:00-07:00",
        "description": "Resource Id",
        "filterEnabled": true,
        "groupingEnabled": true,
        "nextLink": "http://management.azure.com/providers/Microsoft.Management/managementGroups/MyMgId/providers/Microsoft.CostManagement/Dimensions?$filter=properties/category eq 'resourceId'&$top=5&api-version=2019-10-01&$expand=properties/data&$skiptoken=AQAAAA%3D%3D"
      }
    }
  ]
}
Status code:
204

ResourceGroupDimensionsList-Legacy

Sample request

GET https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/system.orlando/providers/Microsoft.CostManagement/dimensions?api-version=2024-08-01&$expand=properties/data&$top=5

Sample response

Status code:
200 
{
  "value": [
    {
      "id": "subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/system.orlando/providers/microsoft.CostManagement/dimensions_ResourceType_2018-05-01_2018-05-31_5",
      "name": "dimensions_ResourceType_2018-05-01_2018-05-31_5",
      "type": "microsoft.CostManagement/dimensions",
      "properties": {
        "data": [
          "microsoft.storage/storageaccounts"
        ],
        "total": 1,
        "category": "ResourceType",
        "usageStart": "2018-05-01T00:00:00-07:00",
        "usageEnd": "2018-05-31T00:00:00-07:00",
        "description": "Resource type",
        "filterEnabled": true,
        "groupingEnabled": true
      }
    },
    {
      "id": "subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/system.orlando/providers/microsoft.CostManagement/dimensions_ResourceId_2018-05-01_2018-05-31_5",
      "name": "dimensions_ResourceId_2018-05-01_2018-05-31_5",
      "type": "microsoft.CostManagement/dimensions",
      "properties": {
        "data": [
          "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/system.orlando/providers/microsoft.storage/storageaccounts/authprod",
          "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/system.orlando/providers/microsoft.storage/storageaccounts/systemevents",
          "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/system.orlando/providers/microsoft.storage/storageaccounts/armadminprod",
          "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/system.orlando/providers/microsoft.storage/storageaccounts/srphytenaccount",
          "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/system.orlando/providers/microsoft.storage/storageaccounts/publicsystemportal"
        ],
        "total": 27,
        "category": "ResourceId",
        "usageStart": "2018-05-01T00:00:00-07:00",
        "usageEnd": "2018-05-31T00:00:00-07:00",
        "description": "Resource Id",
        "filterEnabled": true,
        "groupingEnabled": true
      }
    }
  ]
}
Status code:
204

SubscriptionDimensionsList-Legacy

Sample request

GET https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/providers/Microsoft.CostManagement/dimensions?api-version=2024-08-01&$expand=properties/data&$top=5

Sample response

Status code:
200 
{
  "value": [
    {
      "id": "subscriptions/00000000-0000-0000-0000-000000000000/providers/Microsoft.CostManagement/dimensions_ResourceGroup_2018-05-01_2018-05-31_5",
      "name": "dimensions_ResourceGroup_2018-05-01_2018-05-31_5",
      "type": "microsoft.CostManagement/dimensions",
      "properties": {
        "data": [
          "dcrg",
          "rg",
          "offlinegalleryrg",
          "system.orlando.adminkeyvault",
          "system.orlando.keyvault"
        ],
        "total": 68,
        "category": "ResourceGroup",
        "usageStart": "2018-05-01T00:00:00-07:00",
        "usageEnd": "2018-05-31T00:00:00-07:00",
        "description": "Resource group",
        "filterEnabled": true,
        "groupingEnabled": true
      }
    },
    {
      "id": "subscriptions/00000000-0000-0000-0000-000000000000/providers/Microsoft.CostManagement/dimensions_ResourceType_2018-05-01_2018-05-31_5",
      "name": "dimensions_ResourceType_2018-05-01_2018-05-31_5",
      "type": "microsoft.CostManagement/dimensions",
      "properties": {
        "data": [
          "microsoft.storage/storageaccounts",
          "microsoft.web.admin/role",
          "microsoft.sql/servers",
          "microsoft.compute/virtualmachines"
        ],
        "total": 4,
        "category": "ResourceType",
        "usageStart": "2018-05-01T00:00:00-07:00",
        "usageEnd": "2018-05-31T00:00:00-07:00",
        "description": "Resource type",
        "filterEnabled": true,
        "groupingEnabled": true
      }
    }
  ]
}
Status code:
204

Definitions

Name Description
Dimension

List of Dimension.
DimensionsListResult

Result of listing dimensions. It contains a list of available dimensions.
ErrorDetails

The details of the error.
ErrorResponse

Error response indicates that the service is not able to process the incoming request. The reason is provided in the error message.

Some Error responses:

  • 429 TooManyRequests - Request is throttled. Retry after waiting for the time specified in the "x-ms-ratelimit-microsoft.consumption-retry-after" header.

  • 503 ServiceUnavailable - Service is temporarily unavailable. Retry after waiting for the time specified in the "Retry-After" header.

Dimension

Object

List of Dimension.

Name Type Description
eTag

string

ETag of the resource.
id

string

Resource Id.
location

string

Location of the resource.
name

string

Resource name.
properties.category

string

Dimension category.
properties.data

string[]

Dimension data.
properties.description

string

Dimension description.
properties.filterEnabled

boolean

Filter enabled.
properties.groupingEnabled

boolean

Grouping enabled.
properties.nextLink

string

The link (url) to the next page of results.
properties.total

integer (int32)

Total number of data for the dimension.
properties.usageEnd

string (date-time)

Usage end.
properties.usageStart

string (date-time)

Usage start.
sku

string

SKU of the resource.
tags

object

Resource tags.
type

string

Resource type.

DimensionsListResult

Object

Result of listing dimensions. It contains a list of available dimensions.

Name Type Description
value

Dimension[]

The list of dimensions.

ErrorDetails

Object

The details of the error.

Name Type Description
code

string

Error code.
message

string

Error message indicating why the operation failed.

ErrorResponse

Object

Error response indicates that the service is not able to process the incoming request. The reason is provided in the error message.

Some Error responses:

  • 429 TooManyRequests - Request is throttled. Retry after waiting for the time specified in the "x-ms-ratelimit-microsoft.consumption-retry-after" header.

  • 503 ServiceUnavailable - Service is temporarily unavailable. Retry after waiting for the time specified in the "Retry-After" header.

Name Type Description
error

ErrorDetails

The details of the error.