Reservation Transactions - List By Billing Profile

Referentie

Service:: Consumption

API-versie:: 2024-08-01

Lijst met transacties voor gereserveerde instanties voor het bereik van het factureringsprofiel. De restitutietransacties worden samen met de aankooptransactie geboekt (bijvoorbeeld in de factureringsmaand van de aankoop). De restitutie wordt bijvoorbeeld aangevraagd in mei 2021. Deze restitutietransactie heeft een gebeurtenisdatum als mei 2021, maar de factureringsmaand als april 2020 toen de reserveringsaankoop werd gedaan. Opmerking: ARM heeft een maximale nettoladinggrootte van 12 MB, dus op dit moment krijgen bellers 400 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}/billingProfiles/{billingProfileId}/providers/Microsoft.Consumption/reservationTransactions?api-version=2024-08-01

Met optionele parameters:

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

URI-parameters

Name	In	Vereist	Type	Description
billingAccountId	path	True	string	Factureringsaccount-id
billingProfileId	path	True	string	Azure Billing Profile 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	Filter reserveringstransacties op datumbereik. De eigenschappen/EventDate voor de begin- en einddatum. Het filter ondersteunt 'le' en 'ge'. Opmerking: DE API retourneert gegevens voor de factureringsmaand van de hele begindatum en de einddatum. Filtereigenschappen/eventDate+ge+2020-01-01+AND+properties/eventDate+le+2020-12-29 bevatten bijvoorbeeld gegevens voor de hele december 2020-maand (dat wil bijvoorbeeld records bevatten voor datums van 30 en 31 december)

Antwoorden

Name	Type	Description
200 OK	ModernReservationTransactionsListResult	OK. De aanvraag is voltooid.
Other Status Codes	ErrorResponse	Foutreactie waarin wordt beschreven waarom de bewerking is mislukt.

Beveiliging

azure_auth

Azure Active Directory OAuth2 Flow.

Type: oauth2
Stroom: implicit
Autorisatie-URL: https://login.microsoftonline.com/common/oauth2/authorize

Bereiken

Name	Description
user_impersonation	Uw gebruikersaccount imiteren

Voorbeelden

ReservationTransactionsByBillingProfileId

Voorbeeldaanvraag

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

Voorbeeldrespons

Statuscode:: 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"
      }
    }
  ]
}

Definities

Name	Description
ErrorDetails	De details van de fout.
ErrorResponse	Foutreactie geeft aan dat de service de binnenkomende aanvraag niet kan verwerken. De reden is opgegeven in het foutbericht. Enkele foutberichten: 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 hebt gewacht op de tijd die is opgegeven in de header 'Opnieuw proberen-na'. Time-out van 504 gateway: er is een time-out opgetreden voor de service tijdens het verwerken van de aanvraag. Verminder indien mogelijk het datumbereik in de aanvraag.
ModernReservationTransaction	Moderne resource voor reserveringstransacties.
ModernReservationTransactionsListResult	Resultaat van het weergeven van reserveringsaankopen.

ErrorDetails

Object

De details van de fout.

Name	Type	Description
code	string	Foutcode.
message	string	Foutbericht dat aangeeft waarom de bewerking is mislukt.

ErrorResponse

Object

Foutreactie geeft aan dat de service de binnenkomende aanvraag niet kan verwerken. De reden is opgegeven in het foutbericht.

Enkele foutberichten:

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 hebt gewacht op de tijd die is opgegeven in de header 'Opnieuw proberen-na'.
Time-out van 504 gateway: er is een time-out opgetreden voor de service tijdens het verwerken van de aanvraag. Verminder indien mogelijk het datumbereik in de aanvraag.

Name	Type	Description
error	ErrorDetails	De details van de fout.

ModernReservationTransaction

Object

Moderne resource voor reserveringstransacties.

Name	Type	Description
id	string	Resource-id.
name	string	Resourcenaam.
properties.amount	number (decimal)	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 serviceType-veld in aanvullende informatie in gebruiksrecords.
properties.billingFrequency	string	De factureringsfrequentie, die eenmalig of terugkerend kan zijn.
properties.billingProfileId	string	Factureringsprofiel-id.
properties.billingProfileName	string	Naam van factureringsprofiel.
properties.currency	string	De ISO-valuta waarin de transactie wordt in rekening gebracht, bijvoorbeeld USD.
properties.description	string	De beschrijving van de transactie.
properties.eventDate	string (date-time)	De datum van de transactie
properties.eventType	string	Het type transactie (Aankoop, Annuleren of Restitutie).
properties.invoice	string	Factuurnummer
properties.invoiceId	string	Factuur-id zoals op de factuur waar de specifieke transactie wordt weergegeven.
properties.invoiceSectionId	string	Factuursectie-id
properties.invoiceSectionName	string	Factuursectienaam.
properties.purchasingSubscriptionGuid	string (uuid)	De abonnements-GUID die de transactie maakt.
properties.purchasingSubscriptionName	string	De abonnementsnaam die de transactie maakt.
properties.quantity	number (decimal)	De hoeveelheid van de transactie.
properties.region	string	De regio van de transactie.
properties.reservationOrderId	string	De reserveringsorder-id is de id voor een reserveringsaankoop. Elke reserveringsorder-id vertegenwoordigt één aankooptransactie. Een reserveringsorder bevat reserveringen. De reserveringsorder geeft de VM-grootte en -regio voor de reserveringen op.
properties.reservationOrderName	string	De naam van de reserveringsorder.
properties.term	string	Dit is de term van de transactie.
tags	string[]	Resourcetags.
type	string	Resourcetype.

ModernReservationTransactionsListResult

Object

Resultaat van het weergeven van reserveringsaankopen.

Name	Type	Description
nextLink	string	De koppeling (URL) naar de volgende pagina met resultaten.
value	ModernReservationTransaction[]	De lijst met aanbevelingen voor reserveringen.

Delen via

Reservation Transactions - List By Billing Profile

URI-parameters

Antwoorden

Beveiliging

azure_auth

Bereiken

Voorbeelden

ReservationTransactionsByBillingProfileId

Voorbeeldaanvraag

Voorbeeldrespons

Definities

ErrorDetails

ErrorResponse

ModernReservationTransaction

ModernReservationTransactionsListResult

Aanvullende resources