Microsoft.CostManagement (stable:2019-01-01)

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

Dimensions_ListBySubscription (new)
Description Lists the dimensions by the defined scope.
Reference Link ¶

⚼ Request

GET:  /{scope}/providers/Microsoft.CostManagement/dimensions
{
scope: string ,
api-version: string ,
$filter: string ,
$expand: string ,
$skiptoken: string ,
$top: integer ,
}

⚐ Response (200)

{
value:
[
{
properties:
{
description: string ,
filterEnabled: boolean ,
groupingEnabled: boolean ,
data:
[
string ,
]
,
total: integer ,
category: string ,
usageStart: string ,
usageEnd: string ,
nextLink: string ,
}
,
}
,
]
,
}

⚐ Response (default)

{
error:
{
code: string ,
message: string ,
}
,
}
Query_UsageByScope (new)
Description Query the usage data for scope defined.
Reference Link ¶

⚼ Request

POST:  /{scope}/providers/Microsoft.CostManagement/query
{
scope: string ,
api-version: string ,
parameters:
{
type: enum ,
timeframe: enum ,
timePeriod:
{
from: string ,
to: string ,
}
,
dataset:
{
granularity: enum ,
configuration:
{
columns:
[
string ,
]
,
}
,
aggregation: object ,
grouping:
[
{
type: enum ,
name: string ,
}
,
]
,
sorting:
[
{
querySortingDirection: enum ,
name: string ,
}
,
]
,
filter:
{
and:
[
string ,
]
,
or:
[
string ,
]
,
not: string ,
dimension:
{
name: string ,
operator: enum ,
values:
[
string ,
]
,
}
,
tag:
{
name: string ,
operator: enum ,
values:
[
string ,
]
,
}
,
}
,
}
,
}
,
}

⚐ Response (200)

{
value:
[
{
properties:
{
nextLink: string ,
columns:
[
{
name: string ,
type: string ,
}
,
]
,
rows:
[
string ,
]
,
}
,
}
,
]
,
}

⚐ Response (default)

{
error:
{
code: string ,
message: string ,
}
,
}
Exports_List (new)
Description Lists all exports at the given scope.
Reference Link ¶

⚼ Request

GET:  /{scope}/providers/Microsoft.CostManagement/exports
{
scope: string ,
api-version: string ,
}

⚐ Response (200)

{
value:
[
{
properties:
{
schedule:
{
status: enum ,
recurrence: enum ,
recurrencePeriod:
{
from: string ,
to: string ,
}
,
}
,
}
,
}
,
]
,
}

⚐ Response (default)

{
error:
{
code: string ,
message: string ,
}
,
}
Exports_Get (new)
Description Gets the export for the defined scope by export name.
Reference Link ¶

⚼ Request

GET:  /{scope}/providers/Microsoft.CostManagement/exports/{exportName}
{
scope: string ,
api-version: string ,
exportName: string ,
}

⚐ Response (200)

{
properties:
{
schedule:
{
status: enum ,
recurrence: enum ,
recurrencePeriod:
{
from: string ,
to: string ,
}
,
}
,
}
,
}

⚐ Response (default)

{
error:
{
code: string ,
message: string ,
}
,
}
Exports_CreateOrUpdate (new)
Description The operation to create or update a export. 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/exports/{exportName}
{
scope: string ,
api-version: string ,
exportName: string ,
parameters:
{
properties:
{
schedule:
{
status: enum ,
recurrence: enum ,
recurrencePeriod:
{
from: string ,
to: string ,
}
,
}
,
}
,
}
,
}

⚐ Response (200)

{
properties:
{
schedule:
{
status: enum ,
recurrence: enum ,
recurrencePeriod:
{
from: string ,
to: string ,
}
,
}
,
}
,
}

⚐ Response (201)

{
properties:
{
schedule:
{
status: enum ,
recurrence: enum ,
recurrencePeriod:
{
from: string ,
to: string ,
}
,
}
,
}
,
}

⚐ Response (default)

{
error:
{
code: string ,
message: string ,
}
,
}
Exports_Delete (new)
Description The operation to delete a export.
Reference Link ¶

⚼ Request

DELETE:  /{scope}/providers/Microsoft.CostManagement/exports/{exportName}
{
scope: string ,
api-version: string ,
exportName: string ,
}

⚐ Response (200)

{}

⚐ Response (default)

{
error:
{
code: string ,
message: string ,
}
,
}
Exports_Execute (new)
Description The operation to execute a export.
Reference Link ¶

⚼ Request

POST:  /{scope}/providers/Microsoft.CostManagement/exports/{exportName}/run
{
scope: string ,
api-version: string ,
exportName: string ,
}

⚐ Response (200)

{}

⚐ Response (default)

{
error:
{
code: string ,
message: string ,
}
,
}
Exports_GetExecutionHistory (new)
Description Gets the execution history of a export for the defined scope by export name.
Reference Link ¶

⚼ Request

GET:  /{scope}/providers/Microsoft.CostManagement/exports/{exportName}/runHistory
{
scope: string ,
api-version: string ,
exportName: string ,
}

⚐ Response (200)

{
value:
[
{
properties:
{
executionType: enum ,
status: enum ,
submittedBy: string ,
submittedTime: string ,
processingStartTime: string ,
processingEndTime: string ,
fileName: string ,
runSettings:
{
format: enum ,
deliveryInfo:
{
destination:
{
resourceId: string ,
container: string ,
rootFolderPath: string ,
}
,
}
,
definition:
{
type: enum ,
timeframe: enum ,
timePeriod:
{
from: string ,
to: string ,
}
,
dataset:
{
granularity: enum ,
configuration:
{
columns:
[
string ,
]
,
}
,
aggregation: object ,
grouping:
[
{
type: enum ,
name: string ,
}
,
]
,
sorting:
[
{
querySortingDirection: enum ,
name: string ,
}
,
]
,
filter:
{
and:
[
string ,
]
,
or:
[
string ,
]
,
not: string ,
dimension:
{
name: string ,
operator: enum ,
values:
[
string ,
]
,
}
,
tag:
{
name: string ,
operator: enum ,
values:
[
string ,
]
,
}
,
}
,
}
,
}
,
}
,
}
,
}
,
]
,
}

⚐ Response (default)

{
error:
{
code: string ,
message: string ,
}
,
}
Operations_List (new)
Description Lists all of the available cost management REST API operations.
Reference Link ¶

⚼ Request

GET:  /providers/Microsoft.CostManagement/operations
{
api-version: string ,
}

⚐ Response (200)

{
value:
[
{
name: string ,
display:
{
provider: string ,
resource: string ,
operation: string ,
}
,
}
,
]
,
nextLink: string ,
}

⚐ Response (default)

{
error:
{
code: string ,
message: string ,
}
,
}
Dimensions_ListBySubscription (removed)
Description Lists the dimensions by the defined scope.
Reference Link ¶

⚼ Request

GET:  /{scope}/providers/Microsoft.CostManagement/dimensions
{
scope: string ,
api-version: string ,
$filter: string ,
$expand: string ,
$skiptoken: string ,
$top: integer ,
}

⚐ Response (200)

{
value:
[
{
properties:
{
description: string ,
filterEnabled: boolean ,
groupingEnabled: boolean ,
data:
[
string ,
]
,
total: integer ,
category: string ,
usageStart: string ,
usageEnd: string ,
nextLink: string ,
}
,
}
,
]
,
}

⚐ Response (default)

{
error:
{
code: string ,
message: string ,
}
,
}
Query_UsageByScope (removed)
Description Query the usage data for scope defined.
Reference Link ¶

⚼ Request

POST:  /{scope}/providers/Microsoft.CostManagement/query
{
scope: string ,
api-version: string ,
parameters:
{
type: enum ,
timeframe: enum ,
timePeriod:
{
from: string ,
to: string ,
}
,
dataset:
{
granularity: enum ,
configuration:
{
columns:
[
string ,
]
,
}
,
aggregation: object ,
grouping:
[
{
type: enum ,
name: string ,
}
,
]
,
sorting:
[
{
querySortingDirection: enum ,
name: string ,
}
,
]
,
filter:
{
and:
[
string ,
]
,
or:
[
string ,
]
,
not: string ,
dimension:
{
name: string ,
operator: enum ,
values:
[
string ,
]
,
}
,
tag:
{
name: string ,
operator: enum ,
values:
[
string ,
]
,
}
,
}
,
}
,
}
,
}

⚐ Response (200)

{
value:
[
{
properties:
{
nextLink: string ,
columns:
[
{
name: string ,
type: string ,
}
,
]
,
rows:
[
string ,
]
,
}
,
}
,
]
,
}

⚐ Response (default)

{
error:
{
code: string ,
message: string ,
}
,
}
Exports_List (removed)
Description Lists all exports at the given scope.
Reference Link ¶

⚼ Request

GET:  /{scope}/providers/Microsoft.CostManagement/exports
{
scope: string ,
api-version: string ,
}

⚐ Response (200)

{
value:
[
{
properties:
{
schedule:
{
status: enum ,
recurrence: enum ,
recurrencePeriod:
{
from: string ,
to: string ,
}
,
}
,
}
,
}
,
]
,
}

⚐ Response (default)

{
error:
{
code: string ,
message: string ,
}
,
}
Exports_Get (removed)
Description Gets the export for the defined scope by export name.
Reference Link ¶

⚼ Request

GET:  /{scope}/providers/Microsoft.CostManagement/exports/{exportName}
{
scope: string ,
api-version: string ,
exportName: string ,
}

⚐ Response (200)

{
properties:
{
schedule:
{
status: enum ,
recurrence: enum ,
recurrencePeriod:
{
from: string ,
to: string ,
}
,
}
,
}
,
}

⚐ Response (default)

{
error:
{
code: string ,
message: string ,
}
,
}
Exports_CreateOrUpdate (removed)
Description The operation to create or update a export. 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/exports/{exportName}
{
scope: string ,
api-version: string ,
exportName: string ,
parameters:
{
properties:
{
schedule:
{
status: enum ,
recurrence: enum ,
recurrencePeriod:
{
from: string ,
to: string ,
}
,
}
,
}
,
}
,
}

⚐ Response (200)

{
properties:
{
schedule:
{
status: enum ,
recurrence: enum ,
recurrencePeriod:
{
from: string ,
to: string ,
}
,
}
,
}
,
}

⚐ Response (201)

{
properties:
{
schedule:
{
status: enum ,
recurrence: enum ,
recurrencePeriod:
{
from: string ,
to: string ,
}
,
}
,
}
,
}

⚐ Response (default)

{
error:
{
code: string ,
message: string ,
}
,
}
Exports_Delete (removed)
Description The operation to delete a export.
Reference Link ¶

⚼ Request

DELETE:  /{scope}/providers/Microsoft.CostManagement/exports/{exportName}
{
scope: string ,
api-version: string ,
exportName: string ,
}

⚐ Response (200)

{}

⚐ Response (default)

{
error:
{
code: string ,
message: string ,
}
,
}
Exports_Execute (removed)
Description The operation to execute a export.
Reference Link ¶

⚼ Request

POST:  /{scope}/providers/Microsoft.CostManagement/exports/{exportName}/run
{
scope: string ,
api-version: string ,
exportName: string ,
}

⚐ Response (200)

{}

⚐ Response (default)

{
error:
{
code: string ,
message: string ,
}
,
}
Exports_GetExecutionHistory (removed)
Description Gets the execution history of a export for the defined scope by export name.
Reference Link ¶

⚼ Request

GET:  /{scope}/providers/Microsoft.CostManagement/exports/{exportName}/runHistory
{
scope: string ,
api-version: string ,
exportName: string ,
}

⚐ Response (200)

{
value:
[
{
properties:
{
executionType: enum ,
status: enum ,
submittedBy: string ,
submittedTime: string ,
processingStartTime: string ,
processingEndTime: string ,
fileName: string ,
runSettings:
{
format: enum ,
deliveryInfo:
{
destination:
{
resourceId: string ,
container: string ,
rootFolderPath: string ,
}
,
}
,
definition:
{
type: enum ,
timeframe: enum ,
timePeriod:
{
from: string ,
to: string ,
}
,
dataset:
{
granularity: enum ,
configuration:
{
columns:
[
string ,
]
,
}
,
aggregation: object ,
grouping:
[
{
type: enum ,
name: string ,
}
,
]
,
sorting:
[
{
querySortingDirection: enum ,
name: string ,
}
,
]
,
filter:
{
and:
[
string ,
]
,
or:
[
string ,
]
,
not: string ,
dimension:
{
name: string ,
operator: enum ,
values:
[
string ,
]
,
}
,
tag:
{
name: string ,
operator: enum ,
values:
[
string ,
]
,
}
,
}
,
}
,
}
,
}
,
}
,
}
,
]
,
}

⚐ Response (default)

{
error:
{
code: string ,
message: string ,
}
,
}
Operations_List (removed)
Description Lists all of the available cost management REST API operations.
Reference Link ¶

⚼ Request

GET:  /providers/Microsoft.CostManagement/operations
{
api-version: string ,
}

⚐ Response (200)

{
value:
[
{
name: string ,
display:
{
provider: string ,
resource: string ,
operation: string ,
}
,
}
,
]
,
nextLink: string ,
}

⚐ Response (default)

{
error:
{
code: string ,
message: string ,
}
,
}