Microsoft.CostManagement (preview:2020-12-01)

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

Exports_List (new)
Description The operation to list all exports at the given scope.
Reference Link ¶

⚼ Request

GET:  /{scope}/providers/Microsoft.CostManagement/exports
{
scope: string ,
api-version: string ,
$expand: 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 The operation to get 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 ,
$expand: 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 an 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 The operation to get the execution history of an export for the defined scope and 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: string ,
error:
{
code: string ,
message: string ,
}
,
}
,
}
,
]
,
}

⚐ Response (default)

{
error:
{
code: string ,
message: string ,
}
,
}
GenerateDetailedCostReport_CreateOperation (new)
Description Generates the detailed cost report for provided date range, billing period(Only enterprise customers) or Invoice Id asynchronously at a certain scope. Call returns a 202 with header Azure-Consumption-AsyncOperation providing a link to the operation created. A call on the operation will provide the status and if the operation is completed the blob file where generated detailed cost report is being stored.
Reference Link ¶

⚼ Request

POST:  /{scope}/providers/Microsoft.CostManagement/generateDetailedCostReport
{
scope: string ,
api-version: string ,
parameters:
{
metric: enum ,
timePeriod:
{
start: string ,
end: string ,
}
,
billingPeriod: string ,
invoiceId: string ,
customerId: string ,
}
,
}

⚐ Response (200)

{
id: string ,
name: string ,
type: string ,
properties:
{
downloadUrl: string ,
validTill: string ,
}
,
}

⚐ Response (202)

{
location: string ,
azure-consumption-asyncoperation: string ,
azure-asyncoperation: string ,
retry-after: integer ,
}

⚐ Response (default)

{
error:
{
code: string ,
message: string ,
}
,
}
GenerateDetailedCostReportOperationResults_Get (new)
Description Get the result of the specified operation. This link is provided in the GenerateDetailedCostReport creation request response header.
Reference Link ¶

⚼ Request

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

⚐ Response (200)

{
id: string ,
name: string ,
type: string ,
properties:
{
downloadUrl: string ,
validTill: string ,
}
,
}

⚐ Response (202)

{}

⚐ Response (default)

{
error:
{
code: string ,
message: string ,
}
,
}
GenerateDetailedCostReportOperationStatus_Get (new)
Description Get the status of the specified operation. This link is provided in the GenerateDetailedCostReport creation request response header.
Reference Link ¶

⚼ Request

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

⚐ Response (200)

{
id: string ,
name: string ,
status:
{
status: enum ,
}
,
type: string ,
error:
{
code: string ,
message: string ,
}
,
properties:
{
downloadUrl: string ,
validTill: string ,
}
,
}

⚐ Response (default)

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

⚼ Request

GET:  /{scope}/providers/Microsoft.CostManagement/exports
{
scope: string ,
api-version: string ,
$expand: 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 The operation to get 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 ,
$expand: 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 an 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 The operation to get the execution history of an export for the defined scope and 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: string ,
error:
{
code: string ,
message: string ,
}
,
}
,
}
,
]
,
}

⚐ Response (default)

{
error:
{
code: string ,
message: string ,
}
,
}
GenerateDetailedCostReport_CreateOperation (removed)
Description Generates the detailed cost report for provided date range, billing period(Only enterprise customers) or Invoice Id asynchronously at a certain scope. Call returns a 202 with header Azure-Consumption-AsyncOperation providing a link to the operation created. A call on the operation will provide the status and if the operation is completed the blob file where generated detailed cost report is being stored.
Reference Link ¶

⚼ Request

POST:  /{scope}/providers/Microsoft.CostManagement/generateDetailedCostReport
{
scope: string ,
api-version: string ,
parameters:
{
metric: enum ,
timePeriod:
{
start: string ,
end: string ,
}
,
billingPeriod: string ,
invoiceId: string ,
customerId: string ,
}
,
}

⚐ Response (200)

{
id: string ,
name: string ,
type: string ,
properties:
{
downloadUrl: string ,
validTill: string ,
}
,
}

⚐ Response (202)

{
location: string ,
azure-consumption-asyncoperation: string ,
azure-asyncoperation: string ,
retry-after: integer ,
}

⚐ Response (default)

{
error:
{
code: string ,
message: string ,
}
,
}
GenerateDetailedCostReportOperationResults_Get (removed)
Description Get the result of the specified operation. This link is provided in the GenerateDetailedCostReport creation request response header.
Reference Link ¶

⚼ Request

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

⚐ Response (200)

{
id: string ,
name: string ,
type: string ,
properties:
{
downloadUrl: string ,
validTill: string ,
}
,
}

⚐ Response (202)

{}

⚐ Response (default)

{
error:
{
code: string ,
message: string ,
}
,
}
GenerateDetailedCostReportOperationStatus_Get (removed)
Description Get the status of the specified operation. This link is provided in the GenerateDetailedCostReport creation request response header.
Reference Link ¶

⚼ Request

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

⚐ Response (200)

{
id: string ,
name: string ,
status:
{
status: enum ,
}
,
type: string ,
error:
{
code: string ,
message: string ,
}
,
properties:
{
downloadUrl: string ,
validTill: string ,
}
,
}

⚐ Response (default)

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