Reservation Transactions - List
Lista transakcji dla wystąpień zarezerwowanych w zakresie konta rozliczeniowego. Uwaga: transakcje zwrotu są publikowane wraz z transakcją zakupu (tj. w miesiącu rozliczeniowym zakupu). Na przykład w maju 2021 r. zażądano zwrotu kosztów. Ta transakcja zwrotu pieniędzy będzie miała datę zdarzenia w maju 2021 r., ale miesiąc rozliczeniowy w kwietniu 2020 r., kiedy dokonano zakupu rezerwacji. Uwaga: usługa ARM ma limit rozmiaru ładunku 12 MB, więc obecnie wywołujący otrzymują 400, gdy rozmiar odpowiedzi przekracza limit usługi ARM. W takich przypadkach należy wykonać wywołanie interfejsu API z mniejszymi zakresami dat.
GET https://management.azure.com/providers/Microsoft.Billing/billingAccounts/{billingAccountId}/providers/Microsoft.Consumption/reservationTransactions?api-version=2023-05-01
GET https://management.azure.com/providers/Microsoft.Billing/billingAccounts/{billingAccountId}/providers/Microsoft.Consumption/reservationTransactions?$filter={$filter}&api-version=2023-05-01&useMarkupIfPartner={useMarkupIfPartner}&previewMarkupPercentage={previewMarkupPercentage}
Parametry identyfikatora URI
Nazwa | W | Wymagane | Typ | Opis |
---|---|---|---|---|
billing
|
path | True |
string |
Identyfikator konta rozliczeniowego |
api-version
|
query | True |
string |
Wersja interfejsu API do użycia z żądaniem klienta. Bieżąca wersja to 2023-03-01. |
$filter
|
query |
string |
Filtruj transakcje rezerwacji według zakresu dat. Właściwości/Data zdarzenia dla daty rozpoczęcia i daty zakończenia. Filtr obsługuje ciąg "le" i "ge". Uwaga: interfejs API zwraca dane dla całego miesiąca rozliczeniowego daty rozpoczęcia i daty zakończenia. Na przykład filtr properties/eventDate+ge+2020-01-01+AND+properties/eventDate+le+2020-12-29 będzie zawierać dane dla całego miesiąca grudnia 2020 r. (tj. będą zawierać rekordy dat 30 grudnia i 31) |
|
preview
|
query |
number decimal |
Procent znaczników w wersji zapoznawczej do zastosowania. |
|
use
|
query |
boolean |
Stosuje znaczniki do transakcji, jeśli obiekt wywołujący jest partnerem. |
Odpowiedzi
Nazwa | Typ | Opis |
---|---|---|
200 OK |
OK. Żądanie zakończyło się pomyślnie. |
|
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.
Type:
oauth2
Flow:
implicit
Authorization URL:
https://login.microsoftonline.com/common/oauth2/authorize
Scopes
Nazwa | Opis |
---|---|
user_impersonation | personifikacja konta użytkownika |
Przykłady
ReservationTransactionsByEnrollmentNumber
Sample Request
GET https://management.azure.com/providers/Microsoft.Billing/billingAccounts/123456/providers/Microsoft.Consumption/reservationTransactions?$filter=properties/eventDate+ge+2020-05-20+AND+properties/eventDate+le+2020-05-30&api-version=2023-05-01&useMarkupIfPartner=True&previewMarkupPercentage=15.5
Sample Response
{
"value": [
{
"id": "/billingAccounts/123456/providers/Microsoft.Consumption/reservationtransactions/201909091919",
"name": "201909091919",
"type": "Microsoft.Consumption/reservationTransactions",
"tags": [],
"properties": {
"eventDate": "2019-09-09T19:19:04Z",
"reservationOrderId": "00000000-0000-0000-0000-000000000000",
"description": "Standard_DS1_v2 westus 1 Year",
"eventType": "Refund",
"quantity": 1,
"amount": -21,
"currency": "USD",
"reservationOrderName": "Transaction-DS1_v2",
"purchasingEnrollment": "123456",
"armSkuName": "Standard_DS1_v2",
"term": "P1Y",
"region": "westus",
"purchasingSubscriptionGuid": "a838a8c3-a408-49e1-ac90-42cb95bff9b2",
"purchasingSubscriptionName": "Infrastructure Subscription",
"accountName": "Microsoft Infrastructure",
"accountOwnerEmail": "admin@microsoft.com",
"departmentName": "Unassigned",
"costCenter": "",
"currentEnrollment": "123456",
"billingFrequency": "recurring",
"billingMonth": 20190901,
"monetaryCommitment": 523123.9,
"overage": 23234.49
}
},
{
"id": "/billingAccounts/123456/providers/Microsoft.Consumption/reservationtransactions/201909091919",
"name": "201909091919",
"type": "Microsoft.Consumption/reservationTransactions",
"tags": [],
"properties": {
"eventDate": "2019-09-09T19:19:04Z",
"reservationOrderId": "00000000-0000-0000-0000-000000000000",
"description": "Standard_DS1_v2 westus 1 Year",
"eventType": "Purchase",
"quantity": 1,
"amount": 21,
"currency": "USD",
"reservationOrderName": "Transaction-DS1_v2",
"purchasingEnrollment": "123456",
"armSkuName": "Standard_DS1_v2",
"term": "P1Y",
"region": "westus",
"purchasingSubscriptionGuid": "a838a8c3-a408-49e1-ac90-42cb95bff9b2",
"purchasingSubscriptionName": "Infrastructure Subscription",
"accountName": "Microsoft Infrastructure",
"accountOwnerEmail": "admin@microsoft.com",
"departmentName": "Unassigned",
"costCenter": "",
"currentEnrollment": "123456",
"billingFrequency": "recurring",
"billingMonth": 20190901,
"monetaryCommitment": 523123.9,
"overage": 23234.49
}
}
]
}
Definicje
Nazwa | Opis |
---|---|
Error |
Szczegóły błędu. |
Error |
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:
|
Reservation |
Zasób transakcji rezerwacji. |
Reservation |
Wynik wyświetlania rekomendacji dotyczących rezerwacji. |
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 |
Szczegóły błędu. |
ReservationTransaction
Zasób transakcji rezerwacji.
Nazwa | Typ | Opis |
---|---|---|
id |
string |
Identyfikator zasobu. |
name |
string |
Nazwa zasobu. |
properties.accountName |
string |
Nazwa konta, które wykonuje transakcję. |
properties.accountOwnerEmail |
string |
Adres e-mail właściciela konta, który wykonuje transakcję. |
properties.amount |
number |
Opłata za transakcję. |
properties.armSkuName |
string |
Jest to nazwa jednostki SKU usługi ARM. Można go użyć do sprzężenia z polem serviceType w dodatkowych informacjach w rekordach użycia. |
properties.billingFrequency |
string |
Częstotliwość rozliczeń, która może być jednorazowa lub cykliczna. |
properties.billingMonth |
integer |
Miesiąc rozliczeniowy (yyyMMdd), na którym zainicjowano zdarzenie. |
properties.costCenter |
string |
Centrum kosztów tego działu, jeśli jest to dział i centrum kosztów jest udostępniane. |
properties.currency |
string |
Waluta ISO, w której jest naliczana opłata za transakcję, na przykład USD. |
properties.currentEnrollment |
string |
Bieżąca rejestracja. |
properties.departmentName |
string |
Nazwa działu. |
properties.description |
string |
Opis transakcji. |
properties.eventDate |
string |
Data transakcji |
properties.eventType |
string |
Typ transakcji (zakup, anulowanie lub zwrot kosztów). |
properties.monetaryCommitment |
number |
Kwota zobowiązania pieniężnego w zakresie rejestracji. |
properties.overage |
number |
Kwota nadwyżkowa w zakresie rejestracji. |
properties.purchasingEnrollment |
string |
Rejestracja zakupów. |
properties.purchasingSubscriptionGuid |
string |
Identyfikator GUID subskrypcji, który tworzy transakcję. |
properties.purchasingSubscriptionName |
string |
Nazwa subskrypcji, która tworzy transakcję. |
properties.quantity |
number |
Ilość transakcji. |
properties.region |
string |
Region transakcji. |
properties.reservationOrderId |
string |
Identyfikator zamówienia rezerwacji jest identyfikatorem zakupu rezerwacji. Każdy identyfikator zamówienia rezerwacji reprezentuje jedną transakcję zakupu. Zamówienie rezerwacji zawiera rezerwacje. Zamówienie rezerwacji określa rozmiar maszyny wirtualnej i region rezerwacji. |
properties.reservationOrderName |
string |
Nazwa zamówienia rezerwacji. |
properties.term |
string |
Jest to termin transakcji. |
tags |
string[] |
Tagi zasobów. |
type |
string |
Typ zasobu. |
ReservationTransactionsListResult
Wynik wyświetlania rekomendacji dotyczących rezerwacji.
Nazwa | Typ | Opis |
---|---|---|
nextLink |
string |
Link (adres URL) do następnej strony wyników. |
value |
Lista zaleceń dotyczących rezerwacji. |