你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站,请访问 https://docs.azure.cn

New-AzCostManagementDetailReport

此 API 是以前发布的所有使用情况详细信息 API 的替代项。 请求在特定范围内异步生成提供日期范围、计费周期(仅限企业客户)或发票 ID 的成本详细信息报告。 请求报表的初始调用将返回一个包含“Location”和“Retry-After”标头的 202。 “位置”标头将提供要轮询的终结点,以获取报表生成的结果。 “Retry-After”提供在轮询生成的报表之前等待的持续时间。 如果操作仍在进行中,则轮询报告操作的调用将提供 202 响应,其中包含“位置”标头。 报告生成操作完成后,轮询终结点将提供 200 响应以及可供下载的报表 Blob 的详细信息。 可在轮询响应正文中获取可供下载的文件的详细信息。

语法

New-AzCostManagementDetailReport
   -Scope <String>
   [-BillingPeriod <String>]
   [-InvoiceId <String>]
   [-Metric <CostDetailsMetricType>]
   [-TimePeriodEnd <String>]
   [-TimePeriodStart <String>]
   [-DefaultProfile <PSObject>]
   [-AsJob]
   [-NoWait]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

说明

此 API 是以前发布的所有使用情况详细信息 API 的替代项。 请求在特定范围内异步生成提供日期范围、计费周期(仅限企业客户)或发票 ID 的成本详细信息报告。 请求报表的初始调用将返回一个包含“Location”和“Retry-After”标头的 202。 “位置”标头将提供要轮询的终结点,以获取报表生成的结果。 “Retry-After”提供在轮询生成的报表之前等待的持续时间。 如果操作仍在进行中,则轮询报告操作的调用将提供 202 响应,其中包含“位置”标头。 报告生成操作完成后,轮询终结点将提供 200 响应以及可供下载的报表 Blob 的详细信息。 可在轮询响应正文中获取可供下载的文件的详细信息。

示例

示例 1:请求在特定范围内异步生成提供日期范围、计费周期(仅限企业客户)或发票 ID 的成本详细信息报告

New-AzCostManagementDetailReport -Scope "/subscriptions/9e223dbe-3399-4e19-88eb-0975f02ac87f" -Metric 'ActualCost' -TimePeriodStart "2022-10-01" -TimePeriodEnd "2022-10-20"

此命令请求在特定范围内异步生成提供日期范围、计费周期(仅限企业客户)或发票 ID 的成本详细信息报告。

参数

-AsJob

以作业身份运行命令

类型:SwitchParameter
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-BillingPeriod

此参数只能由企业协议客户使用。 使用 YearMonth(例如202008)格式。 此参数不能与 invoiceId 或 timePeriod 参数一起使用。 如果未在请求正文中提供 timePeriod、invoiceId 或 billingPeriod 参数,API 将返回本月的成本。

类型:String
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-Confirm

提示你在运行 cmdlet 之前进行确认。

类型:SwitchParameter
别名:cf
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-DefaultProfile

DefaultProfile 参数不起作用。 如果对其他订阅执行 cmdlet,请使用 SubscriptionId 参数。

类型:PSObject
别名:AzureRMContext, AzureCredential
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-InvoiceId

此参数只能由 Microsoft 客户协议客户使用。 此外,它只能在计费配置文件或客户范围内使用。 此参数不能与 billingPeriod 或 timePeriod 参数一起使用。 如果未在请求正文中提供 timePeriod、invoiceId 或 billingPeriod 参数,API 将返回本月的成本。

类型:String
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-Metric

详细报表的类型。 默认情况下提供 ActualCost

类型:CostDetailsMetricType
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-NoWait

异步运行命令

类型:SwitchParameter
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-Scope

与使用情况详细信息操作关联的范围。 这包括订阅范围的“/subscriptions/{subscriptionId}/”、计费帐户范围的“/providers/Microsoft.Billing/billingAccounts/{billingAccountId}”、“/providers/Microsoft.Billing/departments/{departmentId}”,“/providers/Microsoft.Billing/enrollmentAccounts/{enrollmentAccountId}”用于 EnrollmentAccount 范围。 此外,对于 billingAccount 范围,新式商务帐户范围为“/providers/Microsoft.Billing/billingAccounts/{billingAccountId}” billingProfile 范围的“/providers/Microsoft.Billing/billingAccounts/{billingAccountId}/billingProfiles/{billingProfileId}”、“providers/Microsoft.Billing/billingAccounts/{billingAccountId}/billingProfiles/{billingProfileId}/invoiceSections/{invoiceSectionId}”和“providers/Microsoft”。Billing/billingAccounts/{billingAccountId}/customers/{customerId}特定于合作伙伴。

类型:String
Position:Named
默认值:None
必需:True
接受管道输入:False
接受通配符:False

-TimePeriodEnd

要将数据拉取到的结束日期。示例格式 2020-03-15

类型:String
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-TimePeriodStart

要从中提取数据的开始日期。 示例格式 2020-03-15

类型:String
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-WhatIf

显示运行该 cmdlet 时会发生什么情况。 cmdlet 未运行。

类型:SwitchParameter
别名:wi
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

输出

ICostDetailsOperationResults