你当前正在访问 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 |