Reservation Transactions - List By Billing Profile

Referens

Tjänst:: Consumption

API-version:: 2024-08-01

Lista över transaktioner för reserverade instanser i faktureringsprofilomfånget. Återbetalningstransaktionerna bokförs tillsammans med inköpstransaktionen (dvs. under inköpsfaktureringsmånaden). Återbetalningen begärs till exempel 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, så för närvarande får anropare 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}/billingProfiles/{billingProfileId}/providers/Microsoft.Consumption/reservationTransactions?api-version=2024-08-01

Med valfria parametrar:

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

URI-parametrar

Name	I	Obligatorisk	Typ	Description
billingAccountId	path	True	string	FaktureringKonto-ID
billingProfileId	path	True	string	Azure-faktureringsprofil-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 returnerar data för hela startdatumets och slutdatumets faktureringsmånad. Till exempel innehåller filteregenskaper/eventDate+ge+2020-01-01+AND+properties/eventDate+le+2020-12-29 data för hela december 2020-månaden (dvs. innehåller poster för datum 30 och 31 december)

Svar

Name	Typ	Description
200 OK	ModernReservationTransactionsListResult	OKEJ. Begäran har slutförts.
Other Status Codes	ErrorResponse	Felsvar som beskriver varför åtgärden misslyckades.

Säkerhet

azure_auth

Azure Active Directory OAuth2 Flow.

Typ: oauth2
Flow: implicit
Auktoriseringswebbadress: https://login.microsoftonline.com/common/oauth2/authorize

Omfattningar

Name	Description
user_impersonation	personifiera ditt användarkonto

Exempel

ReservationTransactionsByBillingProfileId

Exempelbegäran

HTTP

GET https://management.azure.com/providers/Microsoft.Billing/billingAccounts/fcebaabc-fced-4284-a83d-79f83dee183c:45796ba8-988f-45ad-bea9-7b71fc6c7513_2018-09-30/billingProfiles/Z76D-SGAF-BG7-TGB/providers/Microsoft.Consumption/reservationTransactions?$filter=properties/eventDate+ge+2020-05-20+AND+properties/eventDate+le+2020-05-30&api-version=2024-08-01

Exempelsvar

Statuskod:: 200

{
  "value": [
    {
      "id": "/providers/Microsoft.Billing/billingAccounts/fcebaabc-fced-4284-a83d-79f83dee183c:45796ba8-988f-45ad-bea9-7b71fc6c7513_2018-09-30/billingProfiles/Z76D-SGAF-BG7-TGB/providers/Microsoft.Consumption/reservationTransactions",
      "name": "a838a8c3-a408-49e1-ac90-42cb95bff9b2",
      "type": "Microsoft.Consumption/reservationTransactions",
      "properties": {
        "eventDate": "2020-04-25T21:21:38Z",
        "reservationOrderId": "a838a8c3-a408-49e1-ac90-42cb95bff9b2",
        "description": "Reserved VM Instance, Standard_B1ls, US East, 3 Years",
        "eventType": "Purchase",
        "quantity": 1,
        "amount": 1.44,
        "currency": "USD",
        "reservationOrderName": "VM_RI_03-25-2020_14-18",
        "armSkuName": "Standard_B1ls",
        "billingFrequency": "Recurring",
        "billingProfileId": "/providers/Microsoft.Billing/billingAccounts/fcebaabc-fced-4284-a83d-79f83dee183c:45796ba8-988f-45ad-bea9-7b71fc6c7513_2018-09-30/billingProfiles/Z76D-SGAF-BG7-TGB",
        "billingProfileName": "IT Department*",
        "invoice": "T000456437",
        "invoiceId": "/providers/Microsoft.Billing/billingAccounts/fcebaabc-fced-4284-a83d-79f83dee183c:45796ba8-988f-45ad-bea9-7b71fc6c7513_2018-09-30/billingProfiles/Z76D-SGAF-BG7-TGB/invoices/T000456437",
        "invoiceSectionId": "/providers/Microsoft.Billing/billingAccounts/fcebaabc-fced-4284-a83d-79f83dee183c:45796ba8-988f-45ad-bea9-7b71fc6c7513_2018-09-30/invoiceSections/QBTB-EYAK-PJA-TGB",
        "invoiceSectionName": "IT Department",
        "purchasingSubscriptionGuid": "d924ad15-4a3d-4047-971d-c8b1b300a97b",
        "purchasingSubscriptionName": "contoso",
        "region": "eastus",
        "term": "P3Y"
      }
    }
  ]
}

Definitioner

Name	Description
ErrorDetails	Information om felet.
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. Försök igen efter att ha väntat på den tid som anges i rubriken "Försök igen". 504 Gateway Timeout – Tidsgränsen för tjänsten uppnåddes när begäran bearbetades. Minska datumintervallet i begäran, om möjligt.
ModernReservationTransaction	Modern reservationstransaktionsresurs.
ModernReservationTransactionsListResult	Resultat av att lista reservationsrekommendationer.

ErrorDetails

Objekt

Information om felet.

Name	Typ	Description
code	string	Felkod.
message	string	Felmeddelande som anger varför åtgärden misslyckades.

ErrorResponse

Objekt

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. Försök igen efter att ha väntat på den tid som anges i rubriken "Försök igen".
504 Gateway Timeout – Tidsgränsen för tjänsten uppnåddes när begäran bearbetades. Minska datumintervallet i begäran, om möjligt.

Name	Typ	Description
error	ErrorDetails	Information om felet.

ModernReservationTransaction

Objekt

Modern reservationstransaktionsresurs.

Name	Typ	Description
id	string	Resurs-ID.
name	string	Resursnamn.
properties.amount	number (decimal)	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.billingProfileId	string	Faktureringsprofil-ID.
properties.billingProfileName	string	Namn på faktureringsprofil.
properties.currency	string	DEN ISO-valuta där transaktionen debiteras, till exempel USD.
properties.description	string	Beskrivningen av transaktionen.
properties.eventDate	string (date-time)	Datumet för transaktionen
properties.eventType	string	Typen av transaktion (Köp, Avbryt eller Återbetalning).
properties.invoice	string	Fakturanummer
properties.invoiceId	string	Faktura-ID som på fakturan där den specifika transaktionen visas.
properties.invoiceSectionId	string	Fakturaavsnitts-ID
properties.invoiceSectionName	string	Namn på fakturaavsnitt.
properties.purchasingSubscriptionGuid	string (uuid)	Prenumerations-GUID:et som gör transaktionen.
properties.purchasingSubscriptionName	string	Prenumerationsnamnet som gör transaktionen.
properties.quantity	number (decimal)	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 storleken och regionen för den virtuella datorn 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.

ModernReservationTransactionsListResult

Objekt

Resultat av att lista reservationsrekommendationer.

Name	Typ	Description
nextLink	string	Länken (url) till nästa resultatsida.
value	ModernReservationTransaction[]	Listan över reservationsrekommendationer.

Dela via

Reservation Transactions - List By Billing Profile

URI-parametrar

Svar

Säkerhet

azure_auth

Omfattningar

Exempel

ReservationTransactionsByBillingProfileId

Exempelbegäran

Exempelsvar

Definitioner

ErrorDetails

ErrorResponse

ModernReservationTransaction

ModernReservationTransactionsListResult

Ytterligare resurser