Price Sheet - Download By Billing Profile

Odwołanie

Usługa:: Cost Management

Wersja interfejsu API:: 2024-08-01

Pobiera adres URL pobierania cennika bieżącego miesiąca dla profilu rozliczeniowego. Ta operacja jest obsługiwana w przypadku kont rozliczeniowych z typem umowy Microsoft Partner Agreement lub Umową z Klientem Microsoft.

Możesz użyć nowej wersji interfejsu API 2023-09-01 w okresach 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=2024-08-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 protokołu 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=2024-08-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=2024-08-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ć przychodzącego żądania. 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. Ponów próbę po upływie czasu określonego w nagłówku "Ponów próbę po".
MCAPriceSheetProperties	Właściwości arkusza cen.
PricesheetDownloadProperties	Adres URL do pobrania 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ć przychodzącego żądania. 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. Ponów próbę po upływie czasu określonego w nagłówku "Ponów próbę po".

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 klienta lub cena jednostkowa w momencie uruchomienia ga miernika usług, jeśli jest po zalogowaniu. Dotyczy to użytkowników umowy Enterprise Agreement
billingAccountID	string	Unikatowy identyfikator konta rozliczeniowego.
billingAccountName	string	Nazwa profilu rozliczeniowego skonfigurowanego do odbierania 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 odbierania faktur. Ceny w arkuszu cen są skojarzone z tym profilem rozliczeniowym.
currency	string	Waluta, w której odzwierciedlone są wszystkie ceny.
effectiveEndDate	string	Data zakończenia obowiązującego okresu rozliczeniowego arkusza cen
effectiveStartDate	string	Data rozpoczęcia obowiązywania okresu rozliczeniowego arkusza cen
marketPrice	string	Bieżąca cena katalogowa 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ści z 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 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 platformy Azure, w którym dostępny jest miernik usługi.
meterSubCategory	string	Nazwa kategorii podklasyfikacji 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 Zużycie. Inne typy cen obejmują ReservedInstance i Plan oszczędności.
product	string	Nazwa produktu naliczającego opłaty.
productId	string	Unikatowy identyfikator produktu, którego miernik jest używany.
productOrderName	string	Nazwa zakupionego planu produktu. Wskazuje, czy ta cena jest standardowym cennikiem planu platformy Azure, cenami tworzenia i testowania itp. Obecnie niedostępne dla mierników innych firm i wystąpień zarezerwowanych platformy Azure.
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ści platformy Azure lub okresu rezerwacji — jeden rok lub trzy lata (P1Y lub P3Y)
tierMinimumUnits	string	Definiuje dolną granicę zakresu warstw, dla którego są zdefiniowane ceny. Jeśli na przykład zakres wynosi od 0 do 100, wartość tierMinimumUnits będzie wynosić 0.
unitOfMeasure	string	Jak jest mierzone użycie usługi
unitPrice	string	Cena jednostkowa w momencie naliczania opłat za dany produkt lub usługę, włącznie z wszelkimi wynegocjowanych rabatami 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 obowiązująca cena w pobieranych szczegółach użycia, gdy usługi mają różnicowe ceny w różnych warstwach. Jeśli usługi mają ceny wielowarstwowe, efektywna cena jest stawką mieszaną w różnych warstwach i nie pokazuje ceny jednostkowej specyficznej dla warstwy. Cena mieszana lub efektywna cena to cena netto dla zużytej ilości obejmującej wiele warstw (gdzie każda warstwa ma określoną cenę jednostkową).

PricesheetDownloadProperties

Adres URL do pobrania wygenerowanego raportu.

Nazwa	Typ	Opis
downloadFileProperties	MCAPriceSheetProperties	Właściwości pobranego pliku
downloadUrl	string	Adres URL do pobrania 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.