Dela via


New-AzCostManagementDetailReport

Det här API:et ersätter alla API:er för användningsinformation för tidigare versioner. Begäran om att generera en kostnadsinformationsrapport för det angivna datumintervallet, faktureringsperioden (endast företagskunder) eller faktura-ID asynkront i ett visst omfång. Det första anropet för att begära en rapport returnerar ett 202-meddelande med rubriken "Plats" och "Försök efter igen". "Plats"-huvudet ger slutpunkten som ska avsökas för att få resultatet av rapportgenereringen. "Återförsök efter" ger varaktigheten att vänta innan avsökningen för den genererade rapporten. Ett anrop för att avsöka rapportåtgärden ger ett 202-svar med rubriken "Plats" om åtgärden fortfarande pågår. När rapportgenereringen har slutförts ger avsökningsslutpunkten ett 200-svar tillsammans med information om de rapportblobar som är tillgängliga för nedladdning. Informationen om de filer som är tillgängliga för nedladdning kommer att vara tillgänglig i avsökningssvarstexten.

Syntax

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

Description

Det här API:et ersätter alla API:er för användningsinformation för tidigare versioner. Begäran om att generera en kostnadsinformationsrapport för det angivna datumintervallet, faktureringsperioden (endast företagskunder) eller faktura-ID asynkront i ett visst omfång. Det första anropet för att begära en rapport returnerar ett 202-meddelande med rubriken "Plats" och "Försök efter igen". "Plats"-huvudet ger slutpunkten som ska avsökas för att få resultatet av rapportgenereringen. "Återförsök efter" ger varaktigheten att vänta innan avsökningen för den genererade rapporten. Ett anrop för att avsöka rapportåtgärden ger ett 202-svar med rubriken "Plats" om åtgärden fortfarande pågår. När rapportgenereringen har slutförts ger avsökningsslutpunkten ett 200-svar tillsammans med information om de rapportblobar som är tillgängliga för nedladdning. Informationen om de filer som är tillgängliga för nedladdning kommer att vara tillgänglig i avsökningssvarstexten.

Exempel

Exempel 1: Begäran om att generera en kostnadsinformationsrapport för det angivna datumintervallet, faktureringsperioden (endast företagskunder) eller faktura-ID asynkront i ett visst omfång

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

Det här kommandot begär att generera en kostnadsinformationsrapport för det angivna datumintervallet, faktureringsperioden (endast företagskunder) eller faktura-ID asynkront i ett visst omfång.

Parametrar

-AsJob

Kör kommandot som ett jobb

Typ:SwitchParameter
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-BillingPeriod

Den här parametern kan endast användas av Enterprise-avtalskunder. Använd formatet YearMonth(t.ex. 202008). Den här parametern kan inte användas tillsammans med parametrarna invoiceId eller timePeriod. Om parametern timePeriod, invoiceId eller billingPeriod inte anges i begärandetexten returnerar API:et den aktuella månadens kostnad.

Typ:String
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-Confirm

Uppmanar dig att bekräfta innan du kör cmdleten.

Typ:SwitchParameter
Alias:cf
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-DefaultProfile

Parametern DefaultProfile fungerar inte. Använd parametern SubscriptionId när den är tillgänglig om du kör cmdleten mot en annan prenumeration.

Typ:PSObject
Alias:AzureRMContext, AzureCredential
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-InvoiceId

Den här parametern kan endast användas av Kunder med Microsoft-kundavtal. Dessutom kan den endast användas i faktureringsprofilen eller kundomfånget. Den här parametern kan inte användas tillsammans med parametrarna billingPeriod eller timePeriod. Om parametern timePeriod, invoiceId eller billingPeriod inte anges i begärandetexten returnerar API:et den aktuella månadens kostnad.

Typ:String
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-Metric

Typen av detaljerad rapport. Som standard tillhandahålls ActualCost

Typ:CostDetailsMetricType
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-NoWait

Kör kommandot asynkront

Typ:SwitchParameter
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-Scope

Omfånget som är associerat med användningsinformationsåtgärder. Detta inkluderar "/subscriptions/{subscriptionId}/" för prenumerationsomfånget ,/providers/Microsoft.Billing/billingAccounts/{billingAccountId}' för faktureringskontoomfånget, '/providers/Microsoft.Billing/departments/{departmentId}' för avdelningsomfång, '/providers/Microsoft.Billing/enrollmentAccounts/{enrollmentAccountId}' för EnrollmentAccount-omfång. Omfång för moderna handelskonton är dessutom "/providers/Microsoft.Billing/billingAccounts/{billingAccountId}" för billingAccount-omfång, '/providers/Microsoft.Billing/billingAccounts/{billingAccountId}/billingProfiles/{billingProfileId}' för billingProfile scope, 'providers/Microsoft.Billing/billingAccounts/{billingAccountId}/billingProfiles/{billingProfileId}/invoiceSections/{invoiceSectionId}' för invoiceSection-omfång och "providers/Microsoft. Fakturering/faktureringKonton/{billingAccountId}/customers/{customerId} specifika för partner.

Typ:String
Position:Named
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-TimePeriodEnd

Slutdatumet för att hämta data till. exempelformat 2020-03-15

Typ:String
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-TimePeriodStart

Startdatumet för att hämta data från. exempelformat 2020-03-15

Typ:String
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-WhatIf

Visar vad som skulle hända om cmdleten körs. Cmdleten körs inte.

Typ:SwitchParameter
Alias:wi
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

Utdata

ICostDetailsOperationResults