Delen via


New-AzCostManagementDetailReport

Deze API is de vervanging voor alle eerder uitgebrachte API's voor gebruiksgegevens. Aanvraag voor het genereren van een rapport met kostendetails voor het opgegeven datumbereik, de factureringsperiode (alleen zakelijke klanten) of factuur-id asynchroon op een bepaald bereik. De eerste aanroep om een rapport aan te vragen retourneert een 202 met de header 'Locatie' en 'Opnieuw proberen na'. De header Locatie geeft het eindpunt op om het resultaat van het genereren van het rapport op te halen. De opdracht 'Opnieuw proberen na' geeft de duur aan die moet worden gewacht voordat het gegenereerde rapport wordt gecontroleerd. Een aanroep om de rapportbewerking te peilen, geeft een 202-antwoord met een 'Locatie'-header als de bewerking nog bezig is. Zodra de bewerking voor het genereren van het rapport is voltooid, biedt het polling-eindpunt een 200-antwoord, samen met details over de rapportblob(s) die beschikbaar zijn om te downloaden. De details over de bestanden die u kunt downloaden, zijn beschikbaar in de hoofdtekst van het polling-antwoord.

Syntaxis

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

Description

Deze API is de vervanging voor alle eerder uitgebrachte API's voor gebruiksgegevens. Aanvraag voor het genereren van een rapport met kostendetails voor het opgegeven datumbereik, de factureringsperiode (alleen zakelijke klanten) of factuur-id asynchroon op een bepaald bereik. De eerste aanroep om een rapport aan te vragen retourneert een 202 met de header 'Locatie' en 'Opnieuw proberen na'. De header Locatie geeft het eindpunt op om het resultaat van het genereren van het rapport op te halen. De opdracht 'Opnieuw proberen na' geeft de duur aan die moet worden gewacht voordat het gegenereerde rapport wordt gecontroleerd. Een aanroep om de rapportbewerking te peilen, geeft een 202-antwoord met een 'Locatie'-header als de bewerking nog bezig is. Zodra de bewerking voor het genereren van het rapport is voltooid, biedt het polling-eindpunt een 200-antwoord, samen met details over de rapportblob(s) die beschikbaar zijn om te downloaden. De details over de bestanden die u kunt downloaden, zijn beschikbaar in de hoofdtekst van het polling-antwoord.

Voorbeelden

Voorbeeld 1: Aanvragen om een rapport met kostendetails te genereren voor het opgegeven datumbereik, factureringsperiode (alleen zakelijke klanten) of factuur-id asynchroon op een bepaald bereik

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

Met deze opdracht wordt een rapport met kostendetails gegenereerd voor het opgegeven datumbereik, de factureringsperiode (alleen zakelijke klanten) of de factuur-id asynchroon op een bepaald bereik.

Parameters

-AsJob

De opdracht uitvoeren als een taak

Type:SwitchParameter
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-BillingPeriod

Deze parameter kan alleen worden gebruikt door Enterprise Agreement-klanten. Gebruik de indeling YearMonth(bijvoorbeeld 202008). Deze parameter kan niet worden gebruikt naast de parameters invoiceId of timePeriod. Als een timePeriod-, invoiceId- of billingPeriod-parameter niet is opgegeven in de aanvraagbody, retourneert de API de kosten van de huidige maand.

Type:String
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-Confirm

U wordt gevraagd om bevestiging voordat u de cmdlet uitvoert.

Type:SwitchParameter
Aliassen:cf
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-DefaultProfile

De parameter DefaultProfile is niet functioneel. Gebruik de parameter SubscriptionId indien beschikbaar als u de cmdlet uitvoert voor een ander abonnement.

Type:PSObject
Aliassen:AzureRMContext, AzureCredential
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-InvoiceId

Deze parameter kan alleen worden gebruikt door klanten met een Microsoft-klantovereenkomst. Bovendien kan deze alleen worden gebruikt op het bereik factureringsprofiel of klant. Deze parameter kan niet worden gebruikt naast de parameters billingPeriod of timePeriod. Als een timePeriod-, invoiceId- of billingPeriod-parameter niet is opgegeven in de aanvraagbody, retourneert de API de kosten van de huidige maand.

Type:String
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-Metric

Het type van het gedetailleerde rapport. ActualCost is standaard opgegeven

Type:CostDetailsMetricType
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-NoWait

De opdracht asynchroon uitvoeren

Type:SwitchParameter
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-Scope

Het bereik dat is gekoppeld aan bewerkingen voor gebruiksgegevens. Dit omvat '/subscriptions/{subscriptionId}/' voor abonnementsbereik, '/providers/Microsoft.Billing/billingAccounts/{billingAccountId}' voor het factureringsaccountbereik, '/providers/Microsoft.Billing/afdelingen/{departmentId}' voor afdelingsbereik, '/providers/Microsoft.Billing/enrollmentAccounts/{enrollmentAccountId}' voor het bereik EnrollmentAccount. Modern Commerce-accountbereiken zijn ook '/providers/Microsoft.Billing/billingAccounts/{billingAccountId}' voor het factureringsaccountbereik, '/providers/Microsoft.Billing/billingAccounts/{billingAccountId}/billingProfiles/{billingProfileId}' voor het bereik billingProfile, providers/Microsoft.Billing/billingAccounts/{billingAccountId}/billingProfiles/{billingProfileId}/invoiceSections/{invoiceSectionId} voor het bereik van invoiceSection en providers/Microsoft. Billing/billingAccounts/{billingAccountId}/customers/{customerId}' specifiek voor partners.

Type:String
Position:Named
Default value:None
Vereist:True
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-TimePeriodEnd

De einddatum voor het ophalen van gegevens naar. voorbeeldindeling 2020-03-15

Type:String
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-TimePeriodStart

De begindatum waaruit gegevens moeten worden opgehaald. voorbeeldindeling 2020-03-15

Type:String
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-WhatIf

Toont wat er zou gebeuren als de cmdlet wordt uitgevoerd. De cmdlet wordt niet uitgevoerd.

Type:SwitchParameter
Aliassen:wi
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

Uitvoerwaarden