Price Sheet - Download By Billing Profile

Odwołanie

Usługa:: Cost Management

Wersja interfejsu API:: 2023-11-01

Pobiera adres URL umożliwiający pobranie arkusza cen bieżącego miesiąca dla profilu rozliczeniowego. Operacja jest obsługiwana w przypadku kont rozliczeniowych z typem umowy Microsoft Partner Agreement lub Umowa z Klientem Microsoft.

Możesz użyć nowej wersji interfejsu API 2023-09-01 dla okresów rozliczeniowych styczeń 2023 r. Cennik wystąpienia zarezerwowanego platformy Azure jest dostępny tylko za pośrednictwem nowej wersji interfejsu API.

Ze względu na wzrost produktu platformy Azure środowisko pobierania arkusza cen platformy Azure w tej wersji zapoznawczej zostanie zaktualizowane z jednego pliku csv/json do pliku Zip zawierającego wiele plików csv/json, z których każdy ma maksymalny rozmiar 75 MB.

POST https://management.azure.com/providers/Microsoft.Billing/billingAccounts/{billingAccountName}/billingProfiles/{billingProfileName}/providers/Microsoft.CostManagement/pricesheets/default/download?api-version=2023-11-01

Parametry identyfikatora URI

Nazwa W Wymagane Typ Opis

billingAccountName

path

True

string

Identyfikator, który jednoznacznie identyfikuje konto rozliczeniowe.

Wzorzec wyrażenia regularnego: ([A-Za-z0-9]+(-[A-Za-z0-9]+)+):([A-Za-z0-9]+(-[A-Za-z0-9]+)+)_[0-9]{4}-[0-9]{2}-[0-9]{2}

billingProfileName

path

True

string

Identyfikator, który jednoznacznie identyfikuje profil rozliczeniowy.

Wzorzec wyrażenia regularnego: ([A-Za-z0-9]+(-[A-Za-z0-9]+)+)

api-version

query

True

string

Wersja interfejsu API do użycia dla tej operacji.

Odpowiedzi

Nazwa

Typ

Opis

200 OK

PricesheetDownloadProperties

OK. Żądanie zakończyło się pomyślnie.

202 Accepted

Akceptowane.

Nagłówki

Location: string
Retry-After: string
OData-EntityId: string

Other Status Codes

Odpowiedź na błąd opisująca, dlaczego operacja nie powiodła się.

Zabezpieczenia

azure_auth

Przepływ OAuth2 usługi Azure Active Directory.

Typ: oauth2
Flow: implicit
Adres URL autoryzacji: https://login.microsoftonline.com/common/oauth2/authorize

Zakresy

Nazwa	Opis
user_impersonation	personifikacja konta użytkownika

Przykłady

PricesheetDownloadByBillingProfile

Przykładowe żądanie

HTTP

POST https://management.azure.com/providers/Microsoft.Billing/billingAccounts/7c05a543-80ff-571e-9f98-1063b3b53cf2:99ad03ad-2d1b-4889-a452-090ad407d25f_2019-05-31/billingProfiles/2USN-TPCD-BG7-TGB/providers/Microsoft.CostManagement/pricesheets/default/download?api-version=2023-11-01

Przykładowa odpowiedź

Kod stanu:: 202

Location: https://management.azure.com:443/providers/Microsoft.Billing/billingAccounts/7c05a543-80ff-571e-9f98-1063b3b53cf2:99ad03ad-2d1b-4889-a452-090ad407d25f_2019-05-31/billingProfiles/2USN-TPCD-BG7-TGB/providers/Microsoft.CostManagement/operationResults/45000000-0000-0000-0000-000000000000?sessiontoken=0:000000&api-version=2023-11-01&OperationType=PriceSheet
Retry-After: 60
OData-EntityId: 45000000-0000-0000-0000-000000000000

Kod stanu:: 200

{
  "downloadUrl": "https://myaccount.blob.core.windows.net/?restype=service&comp=properties&sv=2015-04-05&ss=bf&srt=s&st=2015-04-29T22%3A18%3A26Z&se=2015-04-30T02%3A23%3A26Z&sr=b&sp=rw&spr=https&sig=G%2TEST%4B",
  "expiryTime": "2018-07-21T17:32:28Z"
}

Definicje

Nazwa	Opis
ErrorDetails	Szczegóły błędu.
ErrorResponse	Odpowiedź na błąd wskazuje, że usługa nie może przetworzyć żądania przychodzącego. Przyczyna jest podana w komunikacie o błędzie. Niektóre odpowiedzi na błędy: 429 TooManyRequests — żądanie jest ograniczane. Ponów próbę po upływie czasu określonego w nagłówku "x-ms-ratelimit-microsoft.consumption-retry-after". 503 ServiceUnavailable — usługa jest tymczasowo niedostępna. Poczekaj przez czas określony w nagłówku „Retry-After” i spróbuj ponownie.
MCAPriceSheetProperties	Właściwości arkusza cen.
PricesheetDownloadProperties	Adres URL umożliwiający pobranie wygenerowanego raportu.

ErrorDetails

Szczegóły błędu.

Nazwa	Typ	Opis
code	string	Kod błędu.
message	string	Komunikat o błędzie wskazujący, dlaczego operacja nie powiodła się.

ErrorResponse

Odpowiedź na błąd wskazuje, że usługa nie może przetworzyć żądania przychodzącego. Przyczyna jest podana w komunikacie o błędzie.

Niektóre odpowiedzi na błędy:

429 TooManyRequests — żądanie jest ograniczane. Ponów próbę po upływie czasu określonego w nagłówku "x-ms-ratelimit-microsoft.consumption-retry-after".
503 ServiceUnavailable — usługa jest tymczasowo niedostępna. Poczekaj przez czas określony w nagłówku „Retry-After” i spróbuj ponownie.

Nazwa	Typ	Opis
error	ErrorDetails	Szczegóły błędu.

MCAPriceSheetProperties

Właściwości arkusza cen.

Nazwa	Typ	Opis
basePrice	string	Cena jednostkowa w momencie logowania się klienta lub cena jednostkowa w momencie uruchomienia miernika dostępności usługi, jeśli jest po zalogowaniu. Dotyczy to użytkowników Enterprise Agreement
billingAccountID	string	Unikatowy identyfikator konta rozliczeniowego.
billingAccountName	string	Nazwa profilu rozliczeniowego skonfigurowanego do otrzymywania faktur. Ceny w arkuszu cen są skojarzone z tym profilem rozliczeniowym.
billingCurrency	string	Waluta, w której są publikowane opłaty.
billingProfileId	string	Unikatowy identyfikator profilu rozliczeniowego.
billingProfileName	string	Nazwa profilu rozliczeniowego skonfigurowanego do otrzymywania faktur. Ceny w arkuszu cen są skojarzone z tym profilem rozliczeniowym.
currency	string	Waluta, w której są określane wszystkie ceny.
effectiveEndDate	string	Data zakończenia okresu rozliczeniowego arkusza cen
effectiveStartDate	string	Data rozpoczęcia okresu rozliczeniowego arkusza cen
marketPrice	string	Bieżąca cena cennika dla danego produktu lub usługi. Ta cena jest bez żadnych negocjacji i jest oparta na typie umowy firmy Microsoft. W obszarze PriceType Consumption cena rynkowa jest odzwierciedlana jako cena płatności zgodnie z rzeczywistym użyciem. W przypadku planu oszczędności PriceType cena rynkowa odzwierciedla korzyść planu oszczędności na podstawie ceny płatności zgodnie z rzeczywistym użyciem dla odpowiedniego okresu zobowiązania. W przypadku klasy PriceType ReservedInstance cena rynkowa odzwierciedla łączną cenę zobowiązania 1 lub 3-letniego.
meterCategory	string	Nazwa kategorii klasyfikacji dla miernika. Na przykład Usługi w chmurze, Sieć itp.
meterName	string	Nazwa miernika. Miernik reprezentuje możliwy do wdrożenia zasób usługi platformy Azure.
meterRegion	string	Nazwa regionu świadczenia usługi platformy Azure, w którym jest dostępny miernik usługi.
meterSubCategory	string	Nazwa kategorii klasyfikacji podrzędnej miernika.
meterType	string	Nazwa typu miernika
priceType	string	Typ ceny produktu. Na przykład zasób platformy Azure z stawką płatności zgodnie z rzeczywistym użyciem z parametrem priceType jako Użycie. Inne typy cen obejmują ReservedInstance i Plan oszczędnościowy.
product	string	Nazwa produktu naliczającego opłaty.
productId	string	Unikatowy identyfikator produktu, którego miernik jest wykorzystywany.
serviceFamily	number	Typ usługi platformy Azure. Na przykład obliczenia, analiza i zabezpieczenia.
skuId	string	Unikatowy identyfikator jednostki SKU
term	string	Długość okresu dla planu oszczędnościowego platformy Azure lub okresu rezerwacji — rok lub trzy lata (P1Y lub P3Y)
tierMinimumUnits	string	Definiuje dolną granicę zakresu warstwy, dla którego są zdefiniowane ceny. Na przykład jeśli zakres wynosi od 0 do 100, pole tierMinimumUnits będzie mieć wartość 0.
unitOfMeasure	string	Jak użycie jest mierzone dla usługi
unitPrice	string	Cena jednostkowa w momencie rozliczeń dla danego produktu lub usługi, włącznie z wszelkimi wynegocjowanych rabatów na podstawie ceny rynkowej. W przypadku klasy PriceType ReservedInstance cena jednostkowa odzwierciedla całkowity koszt zobowiązania 1 lub 3-letniego, w tym rabatów. Uwaga: cena jednostkowa nie jest taka sama jak efektywna cena w szczegółach użycia pobierana, gdy usługi mają różnicowe ceny w różnych warstwach. Jeśli usługi mają wielowarstwowe ceny, efektywna cena jest stawką mieszaną między warstwami i nie pokazuje ceny jednostkowej specyficznej dla warstwy. Cena uśredniona lub cena obowiązująca to cena netto wykorzystanej ilości dla wielu warstw (gdzie każda warstwa ma konkretną cenę jednostkową).

PricesheetDownloadProperties

Adres URL umożliwiający pobranie wygenerowanego raportu.

Nazwa	Typ	Opis
downloadFileProperties	MCAPriceSheetProperties	Właściwości pobranego pliku
downloadUrl	string	Adres URL umożliwiający pobranie wygenerowanego raportu.
expiryTime	string	Czas, w którym adres URL raportu staje się nieprawidłowy/wygasa w utc, np. 2020-12-08T05:55:59.4394737Z.