Udostępnij za pośrednictwem


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

Dane wyjściowe