Reservation Transactions - List
Lista över transaktioner för reserverade instanser i faktureringskontoomfånget. Obs! Återbetalningstransaktionerna bokförs tillsammans med inköpstransaktionen (dvs. under inköpsfaktureringsmånaden). Till exempel begärs återbetalningen i maj 2021. Den här återbetalningstransaktionen har händelsedatum som maj 2021, men faktureringsmånaden som april 2020 när reservationsköpet gjordes. Obs! ARM har en storleksgräns på 12 MB för nyttolasten, så för närvarande får anroparna 400 när svarsstorleken överskrider ARM-gränsen. I sådana fall bör API-anrop göras med mindre datumintervall.
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}
URI-parametrar
Name | I | Obligatorisk | Typ | Description |
---|---|---|---|---|
billing
|
path | True |
string |
FaktureringKonto-ID |
api-version
|
query | True |
string |
Version av API:et som ska användas med klientbegäran. Den aktuella versionen är 2023-03-01. |
$filter
|
query |
string |
Filtrera reservationstransaktioner efter datumintervall. Egenskaper/EventDate för startdatum och slutdatum. Filtret stöder "le" och "ge". Obs! API:et returnerar data för hela startdatumets och slutdatumets faktureringsmånad. Till exempel kommer filteregenskaper/eventDate+ge+2020-01-01+AND+properties/eventDate+le+2020-12-29 att innehålla data för hela december 2020-månaden (d.v.s. innehåller poster för datum 30 december och 31 december) |
|
preview
|
query |
number decimal |
Markeringsprocent för förhandsversion som ska tillämpas. |
|
use
|
query |
boolean |
Tillämpar pålägg för transaktionerna om anroparen är en partner. |
Svar
Name | Typ | Description |
---|---|---|
200 OK |
OK. Begäran har slutförts. |
|
Other Status Codes |
Felsvar som beskriver varför åtgärden misslyckades. |
Säkerhet
azure_auth
Azure Active Directory OAuth2 Flow.
Type:
oauth2
Flow:
implicit
Authorization URL:
https://login.microsoftonline.com/common/oauth2/authorize
Scopes
Name | Description |
---|---|
user_impersonation | personifiera ditt användarkonto |
Exempel
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
}
}
]
}
Definitioner
Name | Description |
---|---|
Error |
Information om felet. |
Error |
Felsvaret anger att tjänsten inte kan bearbeta den inkommande begäran. Orsaken anges i felmeddelandet. Några felsvar:
|
Reservation |
Reservationstransaktionsresurs. |
Reservation |
Resultat av att lista reservationsrekommendationer. |
ErrorDetails
Information om felet.
Name | Typ | Description |
---|---|---|
code |
string |
Felkod. |
message |
string |
Felmeddelande som anger varför åtgärden misslyckades. |
ErrorResponse
Felsvaret anger att tjänsten inte kan bearbeta den inkommande begäran. Orsaken anges i felmeddelandet.
Några felsvar:
429 TooManyRequests – Begäran begränsas. Försök igen efter att ha väntat på den tid som anges i rubriken "x-ms-ratelimit-microsoft.consumption-retry-after".
503 ServiceUnavailable – Tjänsten är inte tillgänglig för tillfället. Vänta så lång tid som anges i rubriken ”Retry-After” och försök igen.
Name | Typ | Description |
---|---|---|
error |
Information om felet. |
ReservationTransaction
Reservationstransaktionsresurs.
Name | Typ | Description |
---|---|---|
id |
string |
Resurs-ID. |
name |
string |
Resursnamn. |
properties.accountName |
string |
Namnet på det konto som gör transaktionen. |
properties.accountOwnerEmail |
string |
E-postmeddelandet till kontoägaren som gör transaktionen. |
properties.amount |
number |
Kostnaden för transaktionen. |
properties.armSkuName |
string |
Det här är ARM SKU-namnet. Den kan användas för att ansluta till fältet serviceType i ytterligare information i användningsposter. |
properties.billingFrequency |
string |
Faktureringsfrekvensen, som kan vara antingen engångs- eller återkommande. |
properties.billingMonth |
integer |
Faktureringsmånaden (åååååMdd) som händelsen initierade. |
properties.costCenter |
string |
Kostnadsställe för den här avdelningen om det är en avdelning och ett kostnadsställe tillhandahålls. |
properties.currency |
string |
ISO-valutan där transaktionen debiteras, till exempel USD. |
properties.currentEnrollment |
string |
Den aktuella registreringen. |
properties.departmentName |
string |
Avdelningsnamnet. |
properties.description |
string |
En beskrivning av transaktionen. |
properties.eventDate |
string |
Transaktionsdatumet |
properties.eventType |
string |
Typen av transaktion (Köp, Avbryt eller Återbetalning). |
properties.monetaryCommitment |
number |
Det ekonomiska åtagandebeloppet i registreringsomfånget. |
properties.overage |
number |
Överförbrukningsbeloppet i registreringsomfånget. |
properties.purchasingEnrollment |
string |
Inköpsregistreringen. |
properties.purchasingSubscriptionGuid |
string |
Prenumerations-GUID:et som gör transaktionen. |
properties.purchasingSubscriptionName |
string |
Prenumerationsnamnet som gör transaktionen. |
properties.quantity |
number |
Transaktionens kvantitet. |
properties.region |
string |
Regionen för transaktionen. |
properties.reservationOrderId |
string |
Reservationsbeställnings-ID:t är identifieraren för ett reservationsköp. Varje reservationsbeställnings-ID representerar en enda inköpstransaktion. En reservationsbeställning innehåller reservationer. Reservationsbeställningen anger vm-storleken och regionen för reservationerna. |
properties.reservationOrderName |
string |
Namnet på reservationsbeställningen. |
properties.term |
string |
Det här är transaktionens term. |
tags |
string[] |
Resurstaggar. |
type |
string |
Resurstyp. |
ReservationTransactionsListResult
Resultat av att lista reservationsrekommendationer.
Name | Typ | Description |
---|---|---|
nextLink |
string |
Länken (url) till nästa sida med resultat. |
value |
Listan över reservationsrekommendationer. |