Sdílet prostřednictvím


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ůže používat jenom smlouva Enterprise zákazníky. 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 zobrazí výzvu 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ůže používat jenom Smlouva se zákazníkem Microsoftu zákazníci. 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

Zobrazuje, co by se stalo při spuštění rutiny. Rutina není spuštěna.

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

ICostDetailsOperationResults