New-AzCostManagementDetailReport

Referenz

Modul:: Az.CostManagement

Diese API ist der Ersatz für alle zuvor veröffentlichten Nutzungsdetails-APIs. Fordern Sie an, einen Kostendetailsbericht für den angegebenen Zeitraum, den Abrechnungszeitraum (nur Unternehmenskunden) oder die Rechnungs-ID asynchron in einem bestimmten Bereich zu generieren. Der anfängliche Aufruf, um einen Bericht anzufordern, gibt einen 202-Wert mit dem Header "Location" und "Retry-After" zurück. Der Header "Location" stellt den Endpunkt zum Abrufen des Ergebnisses der Berichtsgenerierung bereit. Der Vorgang "Wiederholen nach" stellt die Dauer für die Wartezeit vor dem Abrufen des generierten Berichts bereit. Ein Aufruf zum Abrufen des Berichtsvorgangs stellt eine 202-Antwort mit einem Header "Ort" bereit, wenn der Vorgang noch ausgeführt wird. Sobald der Vorgang zur Berichtgenerierung abgeschlossen ist, stellt der Abrufendpunkt eine 200-Antwort zusammen mit Details zu den Berichts-BLOBs bereit, die zum Download verfügbar sind. Die Details zu den zum Download verfügbaren Dateien sind im Antworttext des Abrufs verfügbar.

Syntax

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

Beschreibung

Beispiele

Beispiel 1: Anfordern einer Kostendetailseite für den angegebenen Zeitraum, abrechnungszeitraum (nur Unternehmenskunden) oder Rechnungs-ID asynchron zu einem bestimmten Bereich

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

Dieser Befehl fordert an, einen Kostendetailsbericht für den angegebenen Zeitraum, den Abrechnungszeitraum (nur Unternehmenskunden) oder die Rechnungs-ID asynchron in einem bestimmten Bereich zu generieren.

Parameter

-AsJob

Ausführen des Befehls als Auftrag

Typ:	SwitchParameter
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-BillingPeriod

Dieser Parameter kann nur von Enterprise Agreement-Kunden verwendet werden. Verwenden Sie das YearMonth(z. B. 202008)-Format. Dieser Parameter kann nicht zusammen mit den parametern "invoiceId" oder "timePeriod" verwendet werden. Wenn ein timePeriod-, invoiceId- oder billingPeriod-Parameter nicht im Anforderungstext angegeben wird, gibt die API die Kosten des aktuellen Monats zurück.

Typ:	String
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-Confirm

Fordert Sie vor dem Ausführen des Cmdlets zur Bestätigung auf.

Typ:	SwitchParameter
Aliase:	cf
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-DefaultProfile

Der Parameter DefaultProfile ist nicht funktionsfähig. Verwenden Sie den Parameter "SubscriptionId", wenn sie verfügbar ist, wenn Sie das Cmdlet für ein anderes Abonnement ausführen.

Typ:	PSObject
Aliase:	AzureRMContext, AzureCredential
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-InvoiceId

Dieser Parameter kann nur von Kunden des Microsoft-Kundenvertrags verwendet werden. Darüber hinaus kann sie nur im Bereich "Abrechnungsprofil" oder "Kunde" verwendet werden. Dieser Parameter kann nicht zusammen mit den parametern billingPeriod oder timePeriod verwendet werden. Wenn ein timePeriod-, invoiceId- oder billingPeriod-Parameter nicht im Anforderungstext angegeben wird, gibt die API die Kosten des aktuellen Monats zurück.

Typ:	String
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-Metric

Der Typ des detaillierten Berichts. ActualCost wird standardmäßig bereitgestellt.

Typ:	CostDetailsMetricType
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-NoWait

Asynchrones Ausführen des Befehls

Typ:	SwitchParameter
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-Scope

Der Bereich, der Den Verwendungsdetails-Vorgängen zugeordnet ist. Dies umfasst '/subscriptions/{subscriptionId}/' für den Abonnementbereich, '/providers/Microsoft.Billing/billingAccounts/{billingAccountId}' für den Abrechnungskontobereich, '/providers/Microsoft.Billing/departments/{departmentId}' für abteilungsbereich, '/providers/Microsoft.Billing/enrollmentAccounts/{enrollmentAccountId}' für den Bereich "EnrollmentAccount". Außerdem sind moderne Commerce-Kontobereiche "/providers/Microsoft.Billing/billingAccounts/{billingAccountId}" für den Bereich "billingAccount", '/providers/Microsoft.Billing/billingAccounts/{billingAccountId}/billingProfiles/{billingProfileId}' für billingProfile scope, 'providers/Microsoft.Billing/billingAccounts/{billingAccountId}/billingProfiles/{billingProfileId}/invoiceSections/{invoiceSectionId}' für invoiceSection scope, and 'providers/Microsoft. Billing/billingAccounts/{billingAccountId}/customers/{customerId}' speziell für Partner.

Typ:	String
Position:	Named
Standardwert:	None
Erforderlich:	True
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-TimePeriodEnd

Das Enddatum, in das Daten abgerufen werden sollen. Beispielformat 2020-03-15

Typ:	String
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-TimePeriodStart

Das Startdatum, aus dem Daten abgerufen werden sollen. Beispielformat 2020-03-15

Typ:	String
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-WhatIf

Zeigt, was passiert, wenn das Cmdlet ausgeführt wird. Das Cmdlet wird nicht ausgeführt.

Typ:	SwitchParameter
Aliase:	wi
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

Ausgaben

ICostDetailsOperationResults

Freigeben über