Udostępnij przez

Reservation Transactions - List

Usługa:
Consumption
Wersja interfejsu API:
2024-08-01

Lista transakcji dotyczących wystąpień zarezerwowanych dla zakresu 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 pieniędzy. Ta transakcja zwrotu będzie miała datę zdarzenia z maja 2021 r., ale miesiąc rozliczeniowy na kwiecień 2020 r., kiedy dokonano zakupu rezerwacji. Uwaga: usługa ARM ma limit rozmiaru ładunku o rozmiarze 12 MB, więc obecnie osoby wywołujące otrzymują 400, gdy rozmiar odpowiedzi przekracza limit usługi ARM. W takich przypadkach wywołanie interfejsu API powinno być wykonywane z mniejszymi zakresami dat.

GET https://management.azure.com/providers/Microsoft.Billing/billingAccounts/{billingAccountId}/providers/Microsoft.Consumption/reservationTransactions?api-version=2024-08-01
Z parametrami opcjonalnymi: 
GET https://management.azure.com/providers/Microsoft.Billing/billingAccounts/{billingAccountId}/providers/Microsoft.Consumption/reservationTransactions?api-version=2024-08-01&$filter={$filter}&useMarkupIfPartner={useMarkupIfPartner}&previewMarkupPercentage={previewMarkupPercentage}

Parametry identyfikatora URI

Nazwa W Wymagane Typ Opis
billingAccountId
 path True

string

Identyfikator konta rozliczeniowego
api-version
 query True

string

minLength: 1

Wersja interfejsu API do użycia dla tej operacji.
$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 wartości "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 z grudnia 2020 r. (tj. będą zawierać rekordy dat z 30 grudnia i 31)
previewMarkupPercentage
 query

number (decimal)

Procent narzutu w wersji zapoznawczej do zastosowania.
useMarkupIfPartner
 query

boolean

Stosuje znaczniki do transakcji, jeśli obiekt wywołujący jest partnerem.

Odpowiedzi

Nazwa Typ Opis
200 OK

ReservationTransactionsListResult

Żądanie zakończyło się pomyślnie.
Other Status Codes

ErrorResponse

Nieoczekiwana odpowiedź na błąd.

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

ReservationTransactionsByEnrollmentNumber

Przykładowe żądanie

GET https://management.azure.com/providers/Microsoft.Billing/billingAccounts/123456/providers/Microsoft.Consumption/reservationTransactions?api-version=2024-08-01&$filter=properties/eventDate+ge+2020-05-20+AND+properties/eventDate+le+2020-05-30&useMarkupIfPartner=True&previewMarkupPercentage=15.5

Przykładowa odpowiedź

Kod stanu:
200 
{
  "value": [
    {
      "name": "201909091919",
      "type": "Microsoft.Consumption/reservationTransactions",
      "id": "/billingAccounts/123456/providers/Microsoft.Consumption/reservationtransactions/201909091919",
      "properties": {
        "description": "Standard_DS1_v2 westus 1 Year",
        "accountName": "Microsoft Infrastructure",
        "accountOwnerEmail": "admin@microsoft.com",
        "amount": -21,
        "armSkuName": "Standard_DS1_v2",
        "billingFrequency": "recurring",
        "billingMonth": 20190901,
        "costCenter": "",
        "currency": "USD",
        "currentEnrollment": "123456",
        "departmentName": "Unassigned",
        "eventDate": "2019-09-09T19:19:04Z",
        "eventType": "Refund",
        "monetaryCommitment": 523123.9,
        "overage": 23234.49,
        "purchasingEnrollment": "123456",
        "purchasingSubscriptionGuid": "a838a8c3-a408-49e1-ac90-42cb95bff9b2",
        "purchasingSubscriptionName": "Infrastructure Subscription",
        "quantity": 1,
        "region": "westus",
        "reservationOrderId": "00000000-0000-0000-0000-000000000000",
        "reservationOrderName": "Transaction-DS1_v2",
        "term": "P1Y"
      },
      "tags": []
    },
    {
      "name": "201909091919",
      "type": "Microsoft.Consumption/reservationTransactions",
      "id": "/billingAccounts/123456/providers/Microsoft.Consumption/reservationtransactions/201909091919",
      "properties": {
        "description": "Standard_DS1_v2 westus 1 Year",
        "accountName": "Microsoft Infrastructure",
        "accountOwnerEmail": "admin@microsoft.com",
        "amount": 21,
        "armSkuName": "Standard_DS1_v2",
        "billingFrequency": "recurring",
        "billingMonth": 20190901,
        "costCenter": "",
        "currency": "USD",
        "currentEnrollment": "123456",
        "departmentName": "Unassigned",
        "eventDate": "2019-09-09T19:19:04Z",
        "eventType": "Purchase",
        "monetaryCommitment": 523123.9,
        "overage": 23234.49,
        "purchasingEnrollment": "123456",
        "purchasingSubscriptionGuid": "a838a8c3-a408-49e1-ac90-42cb95bff9b2",
        "purchasingSubscriptionName": "Infrastructure Subscription",
        "quantity": 1,
        "region": "westus",
        "reservationOrderId": "00000000-0000-0000-0000-000000000000",
        "reservationOrderName": "Transaction-DS1_v2",
        "term": "P1Y"
      },
      "tags": []
    }
  ]
}

Definicje

Nazwa Opis
createdByType

Typ tożsamości, która utworzyła zasób.
ErrorAdditionalInfo

Dodatkowe informacje o błędzie zarządzania zasobami.
ErrorDetail

Szczegóły błędu.
ErrorResponse

Odpowiedź na błąd
ReservationTransaction

Zasób transakcji rezerwacji.
ReservationTransactionsListResult

Wynik wyświetlania rekomendacji dotyczących rezerwacji.
systemData

Metadane dotyczące tworzenia i ostatniej modyfikacji zasobu.

createdByType

Wyliczanie

Typ tożsamości, która utworzyła zasób.

Wartość Opis
User
Application
ManagedIdentity
Key

ErrorAdditionalInfo

Objekt

Dodatkowe informacje o błędzie zarządzania zasobami.

Nazwa Typ Opis
info

object

Dodatkowe informacje.
type

string

Dodatkowy typ informacji.

ErrorDetail

Objekt

Szczegóły błędu.

Nazwa Typ Opis
additionalInfo

ErrorAdditionalInfo[]

Dodatkowe informacje o błędzie.
code

string

Kod błędu.
details

ErrorDetail[]

Szczegóły błędu.
message

string

Komunikat o błędzie.
target

string

Element docelowy błędu.

ErrorResponse

Objekt

Odpowiedź na błąd

Nazwa Typ Opis
error

ErrorDetail

Obiekt błędu.

ReservationTransaction

Objekt

Zasób transakcji rezerwacji.

Nazwa Typ Opis
id

string

W pełni kwalifikowany identyfikator zasobu dla zasobu. Przykład - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}
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 dokonuje transakcji.
properties.amount

number (decimal)

Opłata za transakcję.
properties.armSkuName

string

Jest to nazwa jednostki SKU usługi ARM. Może służyć do łączenia 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 (int32)

Miesiąc rozliczeniowy (yyyyMMdd), na którym zainicjowano zdarzenie.
properties.costCenter

string

Centrum kosztów tego działu, jeśli jest to dział i centrum kosztów jest zapewnione.
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 (date-time)

Data transakcji
properties.eventType

string

Typ transakcji (Zakup, Anulowanie lub Zwrot kosztów).
properties.monetaryCommitment

number (decimal)

Kwota zobowiązania pieniężnego w zakresie rejestracji.
properties.overage

number (decimal)

Kwota nadwyżki w zakresie rejestracji.
properties.purchasingEnrollment

string

Rejestracja zakupu.
properties.purchasingSubscriptionGuid

string (uuid)

Identyfikator GUID subskrypcji, który wykonuje transakcję.
properties.purchasingSubscriptionName

string

Nazwa subskrypcji, która powoduje transakcję.
properties.quantity

number (decimal)

Ilość transakcji.
properties.region

string

Region transakcji.
properties.reservationOrderId

string

Identyfikator zamówienia rezerwacji to identyfikator 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.
systemData

systemData

Metadane usługi Azure Resource Manager zawierające informacje „createdBy” i „modifiedBy”.
tags

string[]

Tagi zasobów.
type

string

Typ zasobu. Np. "Microsoft.Compute/virtualMachines" lub "Microsoft.Storage/storageAccounts"

ReservationTransactionsListResult

Objekt

Wynik wyświetlania rekomendacji dotyczących rezerwacji.

Nazwa Typ Opis
nextLink

string

Link (adres URL) do następnej strony wyników.
value

ReservationTransaction[]

Lista zaleceń dotyczących rezerwacji.

systemData

Objekt

Metadane dotyczące tworzenia i ostatniej modyfikacji zasobu.

Nazwa Typ Opis
createdAt

string (date-time)

Sygnatura czasowa tworzenia zasobu (UTC).
createdBy

string

Tożsamość, która utworzyła zasób.
createdByType

createdByType

Typ tożsamości, która utworzyła zasób.
lastModifiedAt

string (date-time)

Sygnatura czasowa ostatniej modyfikacji zasobu (UTC)
lastModifiedBy

string

Tożsamość, która jako ostatnia zmodyfikowała zasób.
lastModifiedByType

createdByType

Typ tożsamości, która jako ostatnia zmodyfikowała zasób.