Reservation Transactions - List
Lijst met transacties voor gereserveerde instanties in het bereik van de factureringsrekening. Opmerking: de restitutietransacties worden samen met de bijbehorende aankooptransactie geboekt (dat wil zeggen in de factureringsmaand van de aankoop). De restitutie wordt bijvoorbeeld aangevraagd in mei 2021. Deze restitutietransactie heeft de gebeurtenisdatum mei 2021, maar de factureringsmaand april 2020 waarop de reserveringsaankoop is gedaan. Opmerking: ARM heeft een maximale nettolading van 12 MB, zodat bellers momenteel 400 krijgen wanneer de antwoordgrootte de ARM-limiet overschrijdt. In dergelijke gevallen moet de API-aanroep worden uitgevoerd met kleinere datumbereiken.
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-parameters
Name | In | Vereist | Type | Description |
---|---|---|---|---|
billing
|
path | True |
string |
Factureringsaccount-id |
api-version
|
query | True |
string |
Versie van de API die moet worden gebruikt met de clientaanvraag. De huidige versie is 2023-03-01. |
$filter
|
query |
string |
Reserveringstransacties filteren op datumbereik. De eigenschappen/EventDate voor de begin- en einddatum. Het filter ondersteunt 'le' en 'ge'. Opmerking: API retourneert gegevens voor de volledige factureringsmaand van de begin- en einddatum. Filtereigenschappen/eventDate+ge+2020-01-01+AND+properties/eventDate+le+2020-12-29 bevatten bijvoorbeeld gegevens voor de hele december 2020-maand (d.w.w. records voor datums 30 en 31 december) |
|
preview
|
query |
number decimal |
Voorbeeld van markeringspercentage dat moet worden toegepast. |
|
use
|
query |
boolean |
Hiermee past u de prijsverhoging toe op de transacties als de beller een partner is. |
Antwoorden
Name | Type | Description |
---|---|---|
200 OK |
OK. De aanvraag is geslaagd. |
|
Other Status Codes |
Foutreactie waarin wordt beschreven waarom de bewerking is mislukt. |
Beveiliging
azure_auth
Azure Active Directory OAuth2-stroom.
Type:
oauth2
Flow:
implicit
Authorization URL:
https://login.microsoftonline.com/common/oauth2/authorize
Scopes
Name | Description |
---|---|
user_impersonation | Uw gebruikersaccount imiteren |
Voorbeelden
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
}
}
]
}
Definities
Name | Description |
---|---|
Error |
De details van de fout. |
Error |
Foutreactie geeft aan dat de service de binnenkomende aanvraag niet kan verwerken. De reden wordt opgegeven in het foutbericht. Enkele foutreacties:
|
Reservation |
Resource voor reserveringstransacties. |
Reservation |
Resultaat van het weergeven van reserveringsaanbevelingen. |
ErrorDetails
De details van de fout.
Name | Type | Description |
---|---|---|
code |
string |
Foutcode. |
message |
string |
Foutbericht dat aangeeft waarom de bewerking is mislukt. |
ErrorResponse
Foutreactie geeft aan dat de service de binnenkomende aanvraag niet kan verwerken. De reden wordt opgegeven in het foutbericht.
Enkele foutreacties:
429 TooManyRequests - Aanvraag wordt beperkt. Probeer het opnieuw nadat u hebt gewacht op de tijd die is opgegeven in de header 'x-ms-ratelimit-microsoft.consumption-retry-after'.
503 ServiceUnavailable - Service is tijdelijk niet beschikbaar. Probeer het opnieuw nadat u net zolang hebt gewacht zoals aangegeven in de header 'Retry-After'.
Name | Type | Description |
---|---|---|
error |
De details van de fout. |
ReservationTransaction
Resource voor reserveringstransacties.
Name | Type | Description |
---|---|---|
id |
string |
Resource-id. |
name |
string |
Resourcenaam. |
properties.accountName |
string |
De naam van het account dat de transactie uitvoert. |
properties.accountOwnerEmail |
string |
Het e-mailadres van de accounteigenaar die de transactie uitvoert. |
properties.amount |
number |
De kosten van de transactie. |
properties.armSkuName |
string |
Dit is de naam van de ARM-SKU. Het kan worden gebruikt om samen te voegen met het veld serviceType in aanvullende informatie in gebruiksrecords. |
properties.billingFrequency |
string |
De factureringsfrequentie, die eenmalig of terugkerend kan zijn. |
properties.billingMonth |
integer |
De factureringsmaand (jjjjMMdd), waarop de gebeurtenis is gestart. |
properties.costCenter |
string |
De kostenplaats van deze afdeling als het een afdeling en een kostenplaats is opgegeven. |
properties.currency |
string |
De ISO-valuta waarin de transactie in rekening wordt gebracht, bijvoorbeeld USD. |
properties.currentEnrollment |
string |
De huidige inschrijving. |
properties.departmentName |
string |
De naam van de afdeling. |
properties.description |
string |
De beschrijving van de transactie. |
properties.eventDate |
string |
De datum van de transactie |
properties.eventType |
string |
Het type transactie (Aankoop, Annuleren of Restitutie). |
properties.monetaryCommitment |
number |
Het bedrag van de financiële toezegging in het inschrijvingsbereik. |
properties.overage |
number |
Het overschrijdingsbedrag voor het inschrijvingsbereik. |
properties.purchasingEnrollment |
string |
De aankoopinschrijving. |
properties.purchasingSubscriptionGuid |
string |
De abonnements-GUID waarmee de transactie wordt uitgevoerd. |
properties.purchasingSubscriptionName |
string |
De naam van het abonnement waarmee de transactie wordt voltooid. |
properties.quantity |
number |
De hoeveelheid van de transactie. |
properties.region |
string |
De regio van de transactie. |
properties.reservationOrderId |
string |
De id van de reserveringsorder is de id voor een reserveringsaankoop. Elke reserveringsorder-id vertegenwoordigt één aankooptransactie. Een reserveringsorder bevat reserveringen. In de reserveringsorder worden de VM-grootte en -regio voor de reserveringen opgegeven. |
properties.reservationOrderName |
string |
De naam van de reserveringsorder. |
properties.term |
string |
Dit is de duur van de transactie. |
tags |
string[] |
Resourcetags. |
type |
string |
Resourcetype. |
ReservationTransactionsListResult
Resultaat van het weergeven van reserveringsaanbevelingen.
Name | Type | Description |
---|---|---|
nextLink |
string |
De koppeling (URL) naar de volgende pagina met resultaten. |
value |
De lijst met reserveringsaanbevelingen. |