Price Sheet - Download By Billing Account

Odwołanie

Usługa:: Cost Management

Wersja interfejsu API:: 2023-11-01

Generuje arkusz cen dla podanego okresu rozliczeniowego asynchronicznie na podstawie identyfikatora rejestracji. Jest to przeznaczone dla klientów Enterprise Agreement. Możesz użyć nowej wersji interfejsu API 2023-09-01 w lokalizacji "/providers/Microsoft.Billing/billingAccounts/{billingAccountId}/billingPeriods/{billingPeriodName}/providers/Microsoft.CostManagement/pricesheets/default/download" dla okresów rozliczeniowych styczeń 2023 r. Nowy schemat opisany poniżej zawiera więcej informacji i zawiera ceny wystąpień zarezerwowanych platformy Azure dla bieżącego okresu rozliczeniowego.

Zalecamy pobranie arkusza cen platformy Azure podczas wprowadzania nowego okresu rozliczeniowego, jeśli zachowasz rekord wcześniejszych cen wystąpienia zarezerwowanego platformy Azure. Ze względu na wzrost produktu platformy Azure środowisko pobierania arkusza cen platformy Azure w tej wersji zapoznawczej zostanie zaktualizowane z jednego pliku .csv do pliku zip zawierającego wiele plików CSV, z których każdy ma maksymalny rozmiar 75 MB.

POST https://management.azure.com/providers/Microsoft.Billing/billingAccounts/{billingAccountId}/billingPeriods/{billingPeriodName}/providers/Microsoft.CostManagement/pricesheets/default/download?api-version=2023-11-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 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=2023-11-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.
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.
OperationStatus	Stan długotrwałej operacji.
OperationStatusType	Stan długotrwałej operacji.

EAPriceSheetProperties

Właściwości arkusza cen umowy EA.

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
currencyCode	string	Waluta, w której podpisano Enterprise Agreement
effectiveEndDate	string	Data zakończenia okresu rozliczeniowego arkusza cen
effectiveStartDate	string	Data rozpoczęcia 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 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. Uwaga: w przypadku klientów z umową EA bez negocjacji cena rynkowa może być zaokrąglona do innej dokładności dziesiętnej niż cena jednostkowa.
meterCategory	string	Nazwa kategorii klasyfikacji dla 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 ś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
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 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)
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ą).

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.

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