New-AzCostManagementDetailReport
此 API 是先前所有發行使用量詳細資料 API 的取代專案。 要求針對提供日期範圍、計費期間(僅限企業客戶)或特定範圍異步的發票標識碼產生成本詳細數據報告。 要求報表的初始呼叫會傳回具有 『Location』 和 『Retry-After』 標頭的 202。 「位置」標頭會提供要輪詢的端點,以取得產生報表的結果。 「重試後」提供輪詢所產生報表之前要等候的持續時間。 輪詢報表作業的呼叫會提供 202 回應,如果作業仍在進行中,則會提供具有「位置」標頭的回應。 報表產生作業完成後,輪詢端點會提供 200 回應,以及可供下載之報表 Blob 的詳細數據。 可供下載之檔案的詳細數據將在輪詢回應本文中取得。
語法
New-AzCostManagementDetailReport
-Scope <String>
[-BillingPeriod <String>]
[-InvoiceId <String>]
[-Metric <CostDetailsMetricType>]
[-TimePeriodEnd <String>]
[-TimePeriodStart <String>]
[-DefaultProfile <PSObject>]
[-AsJob]
[-NoWait]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Description
此 API 是先前所有發行使用量詳細資料 API 的取代專案。 要求針對提供日期範圍、計費期間(僅限企業客戶)或特定範圍異步的發票標識碼產生成本詳細數據報告。 要求報表的初始呼叫會傳回具有 『Location』 和 『Retry-After』 標頭的 202。 「位置」標頭會提供要輪詢的端點,以取得產生報表的結果。 「重試後」提供輪詢所產生報表之前要等候的持續時間。 輪詢報表作業的呼叫會提供 202 回應,如果作業仍在進行中,則會提供具有「位置」標頭的回應。 報表產生作業完成後,輪詢端點會提供 200 回應,以及可供下載之報表 Blob 的詳細數據。 可供下載之檔案的詳細數據將在輪詢回應本文中取得。
範例
範例 1:要求針對特定範圍以異步方式產生所提供日期範圍、計費期間(僅限企業客戶)或發票標識符的成本詳細數據報告
New-AzCostManagementDetailReport -Scope "/subscriptions/9e223dbe-3399-4e19-88eb-0975f02ac87f" -Metric 'ActualCost' -TimePeriodStart "2022-10-01" -TimePeriodEnd "2022-10-20"
此命令會要求在特定範圍異步產生所提供日期範圍、計費期間(僅限企業客戶)或發票標識碼的成本詳細數據報告。
參數
-AsJob
以作業身分執行命令
類型: | SwitchParameter |
Position: | Named |
預設值: | None |
必要: | False |
接受管線輸入: | False |
接受萬用字元: | False |
-BillingPeriod
此參數只能供 Enterprise 合約客戶使用。 使用 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}' 、適用於 EnrollmentAccount 範圍的 '/providers/Microsoft.Billing/departments/{departmentId}' 、'/providers/Microsoft.Billing/enrollmentAccounts/{enrollmentAccountId}' 。 此外,新式商務帳戶範圍是 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 |