Reservation Transactions - List By Billing Profile

Riferimento

Servizio:: Consumption

Versione API:: 2024-08-01

Elenco delle transazioni per le istanze riservate nell'ambito del profilo di fatturazione. Le transazioni di rimborso vengono registrate insieme alla relativa transazione di acquisto (ad esempio nel mese di fatturazione dell'acquisto). Ad esempio, il rimborso viene richiesto nel maggio 2021. Questa transazione di rimborso avrà data evento come maggio 2021, ma il mese di fatturazione di aprile 2020 quando è stato effettuato l'acquisto della prenotazione. Nota: ARM ha un limite di dimensioni del payload di 12 MB, quindi i chiamanti ottengono attualmente 400 quando le dimensioni della risposta superano il limite arm. In questi casi, la chiamata API deve essere eseguita con intervalli di date più piccoli.

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

Con parametri facoltativi:

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

Parametri dell'URI

Nome	In	Necessario	Tipo	Descrizione
billingAccountId	path	True	string	BillingAccount ID
billingProfileId	path	True	string	ID profilo di fatturazione di Azure.
api-version	query	True	string	Versione dell'API da usare con la richiesta client. La versione corrente è 2023-03-01.
$filter	query		string	Filtrare le transazioni di prenotazione in base all'intervallo di date. Proprietà/EventDate per data di inizio e data di fine. Il filtro supporta 'le' e 'ge'. Nota: l'API restituisce i dati per l'intero mese di fatturazione della data di inizio e della data di fine. Ad esempio, le proprietà di filtro/eventDate+ge+2020-01-01+AND+properties/eventDate+le+le+2020-12-29 includeranno i dati per l'intero mese di dicembre 2020 (ovvero conterrà record per le date 30 e 31 dicembre)

Risposte

Nome	Tipo	Descrizione
200 OK	ModernReservationTransactionsListResult	OK. La richiesta ha avuto esito positivo.
Other Status Codes	ErrorResponse	Risposta di errore che descrive il motivo per cui l'operazione non è riuscita.

Sicurezza

azure_auth

Flusso OAuth2 di Azure Active Directory.

Tipo: oauth2
Flow: implicit
URL di autorizzazione: https://login.microsoftonline.com/common/oauth2/authorize

Ambiti

Nome	Descrizione
user_impersonation	rappresentare l'account utente

Esempio

ReservationTransactionsByBillingProfileId

Esempio di richiesta

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

Risposta di esempio

Codice di stato:: 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"
      }
    }
  ]
}

Definizioni

Nome	Descrizione
ErrorDetails	Dettagli dell'errore.
ErrorResponse	La risposta di errore indica che il servizio non è in grado di elaborare la richiesta in ingresso. Il motivo viene fornito nel messaggio di errore. Alcune risposte di errore: 429 TooManyRequests - La richiesta è limitata. Riprovare dopo aver aspettato il tempo specificato nell'intestazione "x-ms-ratelimit-microsoft.consumption-retry-after". 503 ServiceUnavailable - Il servizio non è temporaneamente disponibile. Riprovare dopo aver aspettato il tempo specificato nell'intestazione "Retry-After". Timeout del gateway 504 - Timeout del servizio durante l'elaborazione della richiesta. Ridurre l'intervallo di date nella richiesta, se possibile.
ModernReservationTransaction	Risorsa transazione di prenotazione moderna.
ModernReservationTransactionsListResult	Risultato dell'elenco delle raccomandazioni per la prenotazione.

ErrorDetails

Object

Dettagli dell'errore.

Nome	Tipo	Descrizione
code	string	Codice di errore.
message	string	Messaggio di errore che indica il motivo per cui l'operazione non è riuscita.

ErrorResponse

Object

La risposta di errore indica che il servizio non è in grado di elaborare la richiesta in ingresso. Il motivo viene fornito nel messaggio di errore.

Alcune risposte di errore:

429 TooManyRequests - La richiesta è limitata. Riprovare dopo aver aspettato il tempo specificato nell'intestazione "x-ms-ratelimit-microsoft.consumption-retry-after".
503 ServiceUnavailable - Il servizio non è temporaneamente disponibile. Riprovare dopo aver aspettato il tempo specificato nell'intestazione "Retry-After".
Timeout del gateway 504 - Timeout del servizio durante l'elaborazione della richiesta. Ridurre l'intervallo di date nella richiesta, se possibile.

Nome	Tipo	Descrizione
error	ErrorDetails	Dettagli dell'errore.

ModernReservationTransaction

Object

Risorsa transazione di prenotazione moderna.

Nome	Tipo	Descrizione
id	string	ID risorsa.
name	string	Nome risorsa.
properties.amount	number (decimal)	Addebito della transazione.
properties.armSkuName	string	Questo è il nome dello SKU arm. Può essere usato per creare un join con il campo serviceType in informazioni aggiuntive nei record di utilizzo.
properties.billingFrequency	string	Frequenza di fatturazione, che può essere una tantum o ricorrente.
properties.billingProfileId	string	ID profilo di fatturazione.
properties.billingProfileName	string	Nome del profilo di fatturazione.
properties.currency	string	Valuta ISO in cui viene addebitata la transazione, ad esempio USD.
properties.description	string	Descrizione della transazione.
properties.eventDate	string (date-time)	Data della transazione
properties.eventType	string	Tipo di transazione (acquisto, annullamento o rimborso).
properties.invoice	string	Numero di fattura
properties.invoiceId	string	ID fattura come nella fattura in cui viene visualizzata la transazione specifica.
properties.invoiceSectionId	string	ID sezione fattura
properties.invoiceSectionName	string	Nome sezione fattura.
properties.purchasingSubscriptionGuid	string (uuid)	GUID della sottoscrizione che effettua la transazione.
properties.purchasingSubscriptionName	string	Nome della sottoscrizione che effettua la transazione.
properties.quantity	number (decimal)	Quantità della transazione.
properties.region	string	Area della transazione.
properties.reservationOrderId	string	L'ID dell'ordine di prenotazione è l'identificatore per un acquisto di prenotazione. Ogni ID ordine di prenotazione rappresenta una singola transazione di acquisto. Un ordine di prenotazione contiene prenotazioni. L'ordine di prenotazione specifica le dimensioni e l'area della macchina virtuale per le prenotazioni.
properties.reservationOrderName	string	Nome dell'ordine di prenotazione.
properties.term	string	Questo è il termine della transazione.
tags	string[]	Tag di risorsa.
type	string	Tipo di risorsa.

ModernReservationTransactionsListResult

Object

Risultato dell'elenco delle raccomandazioni per la prenotazione.

Nome	Tipo	Descrizione
nextLink	string	Collegamento (URL) alla pagina successiva dei risultati.
value	ModernReservationTransaction[]	Elenco di raccomandazioni per la prenotazione.

Condividi tramite

Reservation Transactions - List By Billing Profile

Parametri dell'URI

Risposte

Sicurezza

azure_auth

Ambiti

Esempio

ReservationTransactionsByBillingProfileId

Esempio di richiesta

Risposta di esempio

Definizioni

ErrorDetails

ErrorResponse

ModernReservationTransaction

ModernReservationTransactionsListResult

Risorse aggiuntive