Price Sheet - Download By Billing Account

Odwołanie

Usługa:: Cost Management

Wersja interfejsu API:: 2024-08-01

Generuje arkusz cen dla podanego okresu rozliczeniowego asynchronicznie na podstawie identyfikatora rejestracji. Dotyczy to klientów z umową Enterprise Agreement.

Migrate do wersji 2024-08-01

Możesz użyć interfejsu API 2024-08-01 z nowym identyfikatorem URI:

"/providers/Microsoft.Billing/billingAccounts/{billingAccountId}/billingPeriods/{billingPeriodName}/providers/Microsoft.CostManagement/pricesheets/default/download"

W przypadku nowego schematu opisanego poniżej nowa wersja arkusza cen zawiera dodatkowe informacje i zawiera ceny wystąpień zarezerwowanych platformy Azure dla bieżącego okresu rozliczeniowego. Zalecamy pobranie arkusza cen platformy Azure dla wprowadzenia nowego okresu rozliczeniowego, jeśli zachowasz bieżący rekord wcześniejszych cen wystąpienia zarezerwowanego platformy Azure.

Arkusz cen platformy Azure umowy EA jest dostępny dla okresów rozliczeniowych w ciągu ostatnich 13 miesięcy. Aby poprosić o arkusz cen dla okresu rozliczeniowego starszego niż 13 miesięcy, skontaktuj się z pomocą techniczną.

Środowisko pobierania arkusza cen platformy Azure zostało zaktualizowane z pojedynczego pliku .csv do pliku zip zawierającego wiele plików .csv, z których każdy ma maksymalny rozmiar 75 MB. Wersja 2023-11-01 została uaktualniona do korzystania z metody HTTP POST; szczegóły można znaleźć poniżej.

Wszystkie wersje arkusza cen platformy Azure Microsoft.Consumption — pobierz według konta rozliczeniowego (w tym 2022-06-01, 2021-10-01, 2020-01-01-preview, 2019-10-01, 2019-05-01) mają zostać wycofane 01 czerwca 2026 r. i nie będą już obsługiwane po tej dacie.

POST https://management.azure.com/providers/Microsoft.Billing/billingAccounts/{billingAccountId}/billingPeriods/{billingPeriodName}/providers/Microsoft.CostManagement/pricesheets/default/download?api-version=2024-08-01

Parametry identyfikatora URI

Nazwa W Wymagane Typ Opis

Nazwa	W	Wymagane	Typ	Opis
billingAccountId	path	True	string	Identyfikator konta rozliczeniowego
billingPeriodName	path	True	string	Nazwa okresu rozliczeniowego. Wzorzec wyrażenia regularnego: `^[0-9]*$`
api-version	query	True	string	Wersja interfejsu API do użycia dla tej operacji.

billingAccountId

path

True

string

Identyfikator konta rozliczeniowego

billingPeriodName

path

True

string

Nazwa okresu rozliczeniowego.

Wzorzec wyrażenia regularnego: ^[0-9]*$

api-version

query

True

string

Wersja interfejsu API do użycia dla tej operacji.

Odpowiedzi

Nazwa	Typ	Opis
200 OK	OperationStatus	OK. Żądanie zakończyło się pomyślnie.
202 Accepted		Akceptowane. Nagłówki Location: string Retry-After: string
Other Status Codes	ErrorResponse	Odpowiedź na błąd opisująca, dlaczego operacja nie powiodła się.

Nazwa

Typ

Opis

200 OK

OperationStatus

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

202 Accepted

Akceptowane.

Nagłówki

Location: string
Retry-After: string

Other Status Codes

ErrorResponse

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

EAPriceSheetForBillingPeriod

Przykładowe żądanie

HTTP

POST https://management.azure.com/providers/Microsoft.Billing/billingAccounts/0000000/billingPeriods/202311/providers/Microsoft.CostManagement/pricesheets/default/download?api-version=2024-08-01

Przykładowa odpowiedź

Kod stanu:: 202

Location: https://management.azure.com/providers/Microsoft.Billing/billingAccounts/0000000/providers/Microsoft.CostManagement/operationResults/00000000-0000-0000-0000-000000000000?api-version=2023-09-01
Retry-After: 60

Kod stanu:: 200

{
  "status": "Completed",
  "properties": {
    "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",
    "validTill": "2023-09-30T17:32:28Z"
  }
}

Definicje

Nazwa	Opis
EAPriceSheetProperties	Właściwości arkusza cen umowy EA. Właściwości obsługiwane w wersji 2024-08-01 są następujące
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".
OperationStatus	Stan długotrwałej operacji.
OperationStatusType	Stan długotrwałej operacji.

EAPriceSheetProperties

Właściwości arkusza cen umowy EA. Właściwości obsługiwane w wersji 2024-08-01 są następujące

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
currencyCode	string	Waluta, w której podpisano umowę Enterprise Agreement
effectiveEndDate	string	Data zakończenia obowiązującego okresu rozliczeniowego arkusza cen
effectiveStartDate	string	Data rozpoczęcia obowiązywania okresu rozliczeniowego arkusza cen
enrollmentNumber	string	Unikatowy identyfikator konta rozliczeniowego umowy EA.
includedQuantity	string	Ilości określonej usługi, do której klient z umową EA ma prawo korzystać bez naliczania opłat przyrostowych.
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. Uwaga: W przypadku klientów z umową EA bez negocjacji cena rynkowa może wydawać się zaokrąglona do innej dokładności dziesiętnej niż cena jednostkowa.
meterCategory	string	Nazwa kategorii klasyfikacji miernika. Na przykład usługi w chmurze, sieć itp.
meterId	string	Unikatowy identyfikator miernika
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
offerId	string	Określa ofertę platformy Azure skojarzona z tym miernikiem. [Dowiedz się więcej o ofertach platformy Azure] (https://azure.microsoft.com/en-us/support/legal/offer-details/)
partNumber	string	Numer części skojarzony z miernikiem
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.
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)
unitOfMeasure	string	Sposób pomiaru użycia usługi. Uwaga: pole "Unit" zostało usunięte z wersją 2023-11-01 jako duplikat "UnitofMeasure", użyj pola "UnitOfMeasure".
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ą).

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.

OperationStatus

Stan długotrwałej operacji.

Nazwa	Typ	Opis
properties.downloadFileProperties	EAPriceSheetProperties	Właściwości pobranego pliku
properties.downloadUrl	string	Link (adres URL) umożliwiający pobranie arkusza cen.
properties.validTill	string	Pobierz ważność łącza.
status	OperationStatusType	Stan długotrwałej operacji.

OperationStatusType

Stan długotrwałej operacji.

Nazwa	Typ	Opis
Completed	string
Failed	string
Running	string

Udostępnij za pośrednictwem

Price Sheet - Download By Billing Account

Parametry identyfikatora URI

Odpowiedzi

Zabezpieczenia

azure_auth

Zakresy

Przykłady

EAPriceSheetForBillingPeriod

Przykładowe żądanie

Przykładowa odpowiedź

Definicje

EAPriceSheetProperties

ErrorDetails

ErrorResponse

OperationStatus

OperationStatusType

Dodatkowe zasoby