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
Azure PowerShell