New-AzCostManagementDetailReport
Toto rozhraní API je náhradou za všechna dříve vydaná rozhraní API s podrobnostmi o využití. Žádost o vygenerování sestavy podrobností o nákladech pro zadaný rozsah kalendářních dat, fakturační období (pouze podnikoví zákazníci) nebo ID faktury asynchronně v určitém rozsahu Počáteční volání požadavku na sestavu vrátí hodnotu 202 s hlavičkou Location (Umístění) a Retry-After (Opakovat po). Hlavička Location (Umístění) poskytne koncový bod, který se má dotazovat, aby získal výsledek generování sestavy. Retry-After poskytuje dobu čekání před dotazováním na vygenerovanou sestavu. Volání k dotazování operace sestavy poskytne odpověď 202 s hlavičkou Umístění, pokud operace stále probíhá. Po dokončení operace generování sestavy koncový bod dotazování poskytne odpověď 200 spolu s podrobnostmi o objektech blob sestavy, které jsou k dispozici ke stažení. Podrobnosti o souborech, které jsou k dispozici ke stažení, budou k dispozici v textu odpovědi na dotazování.
Syntaxe
New-AzCostManagementDetailReport
-Scope <String>
[-BillingPeriod <String>]
[-InvoiceId <String>]
[-Metric <CostDetailsMetricType>]
[-TimePeriodEnd <String>]
[-TimePeriodStart <String>]
[-DefaultProfile <PSObject>]
[-AsJob]
[-NoWait]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Description
Toto rozhraní API je náhradou za všechna dříve vydaná rozhraní API s podrobnostmi o využití. Žádost o vygenerování sestavy podrobností o nákladech pro zadaný rozsah kalendářních dat, fakturační období (pouze podnikoví zákazníci) nebo ID faktury asynchronně v určitém rozsahu Počáteční volání požadavku na sestavu vrátí hodnotu 202 s hlavičkou Location (Umístění) a Retry-After (Opakovat po). Hlavička Location (Umístění) poskytne koncový bod, který se má dotazovat, aby získal výsledek generování sestavy. Retry-After poskytuje dobu čekání před dotazováním na vygenerovanou sestavu. Volání k dotazování operace sestavy poskytne odpověď 202 s hlavičkou Umístění, pokud operace stále probíhá. Po dokončení operace generování sestavy koncový bod dotazování poskytne odpověď 200 spolu s podrobnostmi o objektech blob sestavy, které jsou k dispozici ke stažení. Podrobnosti o souborech, které jsou k dispozici ke stažení, budou k dispozici v textu odpovědi na dotazování.
Příklady
Příklad 1: Žádost o asynchronní generování sestavy podrobností o nákladech pro zadaný rozsah kalendářních dat, fakturační období (pouze podnikoví zákazníci) nebo ID faktury v určitém rozsahu
New-AzCostManagementDetailReport -Scope "/subscriptions/9e223dbe-3399-4e19-88eb-0975f02ac87f" -Metric 'ActualCost' -TimePeriodStart "2022-10-01" -TimePeriodEnd "2022-10-20"
Tento příkaz požádá o generování sestavy podrobností o nákladech pro zadaný rozsah kalendářních dat, fakturační období (pouze podnikové zákazníky) nebo ID faktury asynchronně v určitém rozsahu.
Parametry
-AsJob
Spuštění příkazu jako úlohy
Typ: | SwitchParameter |
Position: | Named |
Default value: | None |
Vyžadováno: | False |
Přijmout vstup kanálu: | False |
Přijmout zástupné znaky: | False |
-BillingPeriod
Tento parametr můžou používat jenom zákazníci se smlouvou Enterprise. Použijte formát YearMonth(např. 202008). Tento parametr nelze použít společně s parametry invoiceId nebo timePeriod. Pokud parametr timePeriod, invoiceId nebo billingPeriod není v textu požadavku zadaný, rozhraní API vrátí náklady na aktuální měsíc.
Typ: | String |
Position: | Named |
Default value: | None |
Vyžadováno: | False |
Přijmout vstup kanálu: | False |
Přijmout zástupné znaky: | False |
-Confirm
Před spuštěním rutiny vás vyzve k potvrzení.
Typ: | SwitchParameter |
Aliasy: | cf |
Position: | Named |
Default value: | None |
Vyžadováno: | False |
Přijmout vstup kanálu: | False |
Přijmout zástupné znaky: | False |
-DefaultProfile
Parametr DefaultProfile není funkční. Pokud je k dispozici spuštění rutiny pro jiné předplatné, použijte parametr SubscriptionId.
Typ: | PSObject |
Aliasy: | AzureRMContext, AzureCredential |
Position: | Named |
Default value: | None |
Vyžadováno: | False |
Přijmout vstup kanálu: | False |
Přijmout zástupné znaky: | False |
-InvoiceId
Tento parametr můžou používat jenom zákazníci se smlouvou se zákazníkem Microsoftu. Kromě toho ho můžete použít pouze v rozsahu fakturačního profilu nebo zákazníka. Tento parametr nelze použít společně s parametry billingPeriod nebo timePeriod. Pokud parametr timePeriod, invoiceId nebo billingPeriod není v textu požadavku zadaný, rozhraní API vrátí náklady na aktuální měsíc.
Typ: | String |
Position: | Named |
Default value: | None |
Vyžadováno: | False |
Přijmout vstup kanálu: | False |
Přijmout zástupné znaky: | False |
-Metric
Typ podrobné sestavy. Ve výchozím nastavení je k dispozici hodnota ActualCost.
Typ: | CostDetailsMetricType |
Position: | Named |
Default value: | None |
Vyžadováno: | False |
Přijmout vstup kanálu: | False |
Přijmout zástupné znaky: | False |
-NoWait
Asynchronní spuštění příkazu
Typ: | SwitchParameter |
Position: | Named |
Default value: | None |
Vyžadováno: | False |
Přijmout vstup kanálu: | False |
Přijmout zástupné znaky: | False |
-Scope
Obor přidružený k operacím s podrobnostmi o využití. To zahrnuje /subscriptions/{subscriptionId}/' pro rozsah předplatného, /providers/Microsoft.Billing/billingAccounts/{billingAccountId} pro rozsah fakturačního účtu, /providers/Microsoft.Billing/departments/{departmentId} pro obor oddělení, /providers/Microsoft.Billing/enrollmentAccounts/{enrollmentAccountId} pro obor EnrollmentAccount}. Obory moderního obchodního účtu jsou také /providers/Microsoft.Billing/billingAccounts/{billingAccountId} pro rozsah fakturačního účtu. '/providers/Microsoft.Billing/billingAccounts/{billingAccountId}/billingProfiles/{billingProfileId} pro rozsah billingProfile, providers/Microsoft.Billing/billingAccounts/{billingAccountId}/billingProfiles/{billingProfileId}/invoiceSections/{invoiceSectionId} pro rozsah invoiceSection a provider/Microsoft. Fakturace/billingAccounts/{billingAccountId}/customers/{customerId} specifická pro partnery.
Typ: | String |
Position: | Named |
Default value: | None |
Vyžadováno: | True |
Přijmout vstup kanálu: | False |
Přijmout zástupné znaky: | False |
-TimePeriodEnd
Koncové datum pro načtení dat. Příklad formátu 2020-03-15
Typ: | String |
Position: | Named |
Default value: | None |
Vyžadováno: | False |
Přijmout vstup kanálu: | False |
Přijmout zástupné znaky: | False |
-TimePeriodStart
Počáteční datum pro načtení dat. Příklad formátu 2020-03-15
Typ: | String |
Position: | Named |
Default value: | None |
Vyžadováno: | False |
Přijmout vstup kanálu: | False |
Přijmout zástupné znaky: | False |
-WhatIf
Ukazuje, co se stane, když se rutina spustí. Rutina se nespustí.
Typ: | SwitchParameter |
Aliasy: | wi |
Position: | Named |
Default value: | None |
Vyžadováno: | False |
Přijmout vstup kanálu: | False |
Přijmout zástupné znaky: | False |
Výstupy
Azure PowerShell