New-AzCostManagementDetailReport
Ten interfejs API zastępuje wszystkie interfejsy API szczegółów użycia poprzednich wersji. Żądanie wygenerowania raportu szczegółów kosztów dla podanego zakresu dat, okresu rozliczeniowego (tylko klienci korporacyjni) lub identyfikatora faktury asynchronicznie w określonym zakresie. Początkowe wywołanie żądania raportu zwróci 202 z nagłówkiem "Location" i "Retry-After". Nagłówek "Lokalizacja" udostępni punkt końcowy do sondowania, aby uzyskać wynik generowania raportu. Polecenie "Ponów próbę po" zapewnia czas oczekiwania przed sondowaniem wygenerowanego raportu. Wywołanie sondowania operacji raportu zapewni odpowiedź 202 z nagłówkiem "Lokalizacja", jeśli operacja jest nadal w toku. Po zakończeniu operacji generowania raportu punkt końcowy sondowania udostępni odpowiedź 200 wraz ze szczegółami dotyczącymi obiektów blob raportu, które są dostępne do pobrania. Szczegółowe informacje o plikach dostępnych do pobrania będą dostępne w treści odpowiedzi sondowania.
Składnia
New-AzCostManagementDetailReport
-Scope <String>
[-BillingPeriod <String>]
[-InvoiceId <String>]
[-Metric <CostDetailsMetricType>]
[-TimePeriodEnd <String>]
[-TimePeriodStart <String>]
[-DefaultProfile <PSObject>]
[-AsJob]
[-NoWait]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Opis
Ten interfejs API zastępuje wszystkie interfejsy API szczegółów użycia poprzednich wersji. Żądanie wygenerowania raportu szczegółów kosztów dla podanego zakresu dat, okresu rozliczeniowego (tylko klienci korporacyjni) lub identyfikatora faktury asynchronicznie w określonym zakresie. Początkowe wywołanie żądania raportu zwróci 202 z nagłówkiem "Location" i "Retry-After". Nagłówek "Lokalizacja" udostępni punkt końcowy do sondowania, aby uzyskać wynik generowania raportu. Polecenie "Ponów próbę po" zapewnia czas oczekiwania przed sondowaniem wygenerowanego raportu. Wywołanie sondowania operacji raportu zapewni odpowiedź 202 z nagłówkiem "Lokalizacja", jeśli operacja jest nadal w toku. Po zakończeniu operacji generowania raportu punkt końcowy sondowania udostępni odpowiedź 200 wraz ze szczegółami dotyczącymi obiektów blob raportu, które są dostępne do pobrania. Szczegółowe informacje o plikach dostępnych do pobrania będą dostępne w treści odpowiedzi sondowania.
Przykłady
Przykład 1: Żądanie wygenerowania raportu szczegółów kosztów dla podanego zakresu dat, okresu rozliczeniowego (tylko klienci korporacyjni) lub identyfikatora faktury asynchronicznie w określonym zakresie
New-AzCostManagementDetailReport -Scope "/subscriptions/9e223dbe-3399-4e19-88eb-0975f02ac87f" -Metric 'ActualCost' -TimePeriodStart "2022-10-01" -TimePeriodEnd "2022-10-20"
To polecenie żąda wygenerowania raportu szczegółów kosztów dla podanego zakresu dat, okresu rozliczeniowego (tylko klienci korporacyjni) lub identyfikatora faktury asynchronicznie w określonym zakresie.
Parametry
-AsJob
Uruchamianie polecenia jako zadania
Typ: | SwitchParameter |
Position: | Named |
Domyślna wartość: | None |
Wymagane: | False |
Akceptowanie danych wejściowych potoku: | False |
Akceptowanie symboli wieloznacznych: | False |
-BillingPeriod
Ten parametr może być używany tylko przez klientów z umową Enterprise Agreement. Użyj formatu YearMonth (np. 202008). Tego parametru nie można używać razem z parametrami invoiceId lub timePeriod. Jeśli parametr timePeriod, invoiceId lub billingPeriod nie jest podany w treści żądania interfejs API zwróci koszt bieżącego miesiąca.
Typ: | String |
Position: | Named |
Domyślna wartość: | None |
Wymagane: | False |
Akceptowanie danych wejściowych potoku: | False |
Akceptowanie symboli wieloznacznych: | False |
-Confirm
Monituje o potwierdzenie przed uruchomieniem polecenia cmdlet.
Typ: | SwitchParameter |
Aliasy: | cf |
Position: | Named |
Domyślna wartość: | None |
Wymagane: | False |
Akceptowanie danych wejściowych potoku: | False |
Akceptowanie symboli wieloznacznych: | False |
-DefaultProfile
Parametr DefaultProfile nie działa. Użyj parametru SubscriptionId, jeśli jest dostępny, jeśli wykonuje polecenie cmdlet dla innej subskrypcji.
Typ: | PSObject |
Aliasy: | AzureRMContext, AzureCredential |
Position: | Named |
Domyślna wartość: | None |
Wymagane: | False |
Akceptowanie danych wejściowych potoku: | False |
Akceptowanie symboli wieloznacznych: | False |
-InvoiceId
Ten parametr może być używany tylko przez klientów z Umową z Klientem Microsoft. Ponadto można go używać tylko w obszarze Profil rozliczeniowy lub Zakres klienta. Tego parametru nie można używać razem z parametrami billingPeriod lub timePeriod. Jeśli parametr timePeriod, invoiceId lub billingPeriod nie jest podany w treści żądania interfejs API zwróci koszt bieżącego miesiąca.
Typ: | String |
Position: | Named |
Domyślna wartość: | None |
Wymagane: | False |
Akceptowanie danych wejściowych potoku: | False |
Akceptowanie symboli wieloznacznych: | False |
-Metric
Typ szczegółowego raportu. Domyślnie jest udostępniany koszt rzeczywisty
Typ: | CostDetailsMetricType |
Position: | Named |
Domyślna wartość: | None |
Wymagane: | False |
Akceptowanie danych wejściowych potoku: | False |
Akceptowanie symboli wieloznacznych: | False |
-NoWait
Uruchom polecenie asynchronicznie
Typ: | SwitchParameter |
Position: | Named |
Domyślna wartość: | None |
Wymagane: | False |
Akceptowanie danych wejściowych potoku: | False |
Akceptowanie symboli wieloznacznych: | False |
-Scope
Zakres skojarzony z operacjami szczegółów użycia. Obejmuje to ciąg "/subscriptions/{subscriptionId}/" dla zakresu subskrypcji, "/providers/Microsoft.Billing/billingAccounts/{billingAccountId}" dla zakresu konta rozliczeniowego, "/providers/Microsoft.Billing/departments/{departmentId}" dla zakresu działu, "/providers/Microsoft.Billing/enrollmentAccounts/{enrollmentAccountId}" dla zakresu EnrollmentAccount.. Ponadto zakresy nowoczesnego konta handlowego to "/providers/Microsoft.Billing/billingAccounts/{billingAccountId}" dla zakresu billingAccount, "/providers/Microsoft.Billing/billingAccounts/{billingAccountId}/billingProfiles/{billingProfileId}" dla zakresu billingProfile, "providers/Microsoft.Billing/billingAccounts/{billingAccountId}/billingProfiles/{billingProfileId}/invoiceSections/{invoiceSectionId}" dla zakresu invoiceSectionId} i "providers/Microsoft". Rozliczenia/rozliczeniaKonta/{billingAccountId}/customers/{customerId}' specyficzne dla partnerów.
Typ: | String |
Position: | Named |
Domyślna wartość: | None |
Wymagane: | True |
Akceptowanie danych wejściowych potoku: | False |
Akceptowanie symboli wieloznacznych: | False |
-TimePeriodEnd
Data zakończenia do ściągnięcia danych. przykładowy format 2020-03-15
Typ: | String |
Position: | Named |
Domyślna wartość: | None |
Wymagane: | False |
Akceptowanie danych wejściowych potoku: | False |
Akceptowanie symboli wieloznacznych: | False |
-TimePeriodStart
Data rozpoczęcia ściągania danych. przykładowy format 2020-03-15
Typ: | String |
Position: | Named |
Domyślna wartość: | None |
Wymagane: | False |
Akceptowanie danych wejściowych potoku: | False |
Akceptowanie symboli wieloznacznych: | False |
-WhatIf
Pokazuje, co się stanie, jeśli polecenie cmdlet zostanie uruchomione. Polecenie cmdlet nie jest uruchamiane.
Typ: | SwitchParameter |
Aliasy: | wi |
Position: | Named |
Domyślna wartość: | None |
Wymagane: | False |
Akceptowanie danych wejściowych potoku: | False |
Akceptowanie symboli wieloznacznych: | False |