Reservation Transactions - List By Billing Profile

Reference

Služba:: Consumption

Verze rozhraní API:: 2024-08-01

Seznam transakcí pro rezervované instance v rozsahu fakturačního profilu Transakce refundace se publikují spolu s nákupní transakcí (tj. v nákupním fakturačním měsíci). Například refundace se požaduje v květnu 2021. Tato transakce refundace bude mít datum události jako květen 2021, ale fakturační měsíc jako duben 2020 při nákupu rezervace. Poznámka: ARM má limit velikosti datové části 12 MB, takže v současné době volající dostanou 400, když velikost odpovědi překročí limit ARM. V takových případech by se mělo volat rozhraní API s menšími rozsahy kalendářních dat.

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

S volitelnými parametry:

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

Parametry identifikátoru URI

Name	V	Vyžadováno	Typ	Description
billingAccountId	path	True	string	ID fakturačního účtu
billingProfileId	path	True	string	ID fakturačního profilu Azure.
api-version	query	True	string	Verze rozhraní API, která se má použít s požadavkem klienta. Aktuální verze je 2023-03-01.
$filter	query		string	Filtrovat transakce rezervací podle rozsahu kalendářních dat Vlastnosti/Datum události pro počáteční a koncové datum. Filtr podporuje "le" a "ge". Poznámka: Rozhraní API vrací data pro celé počáteční a koncové datum fakturačního měsíce. Například filtrování vlastností/eventDate+ge+2020-01-01+AND+properties/eventDate+le+2020-12-29 bude obsahovat data pro celý měsíc z prosince 2020 (tj. budou obsahovat záznamy pro data 30. prosince a 31).

Odpovědi

Name	Typ	Description
200 OK	ModernReservationTransactionsListResult	OK. Požadavek byl úspěšný.
Other Status Codes	ErrorResponse	Chybová odpověď popisující, proč operace selhala.

Zabezpečení

azure_auth

Tok OAuth2 v Azure Active Directory

Typ: oauth2
Tok: implicit
URL autorizace: https://login.microsoftonline.com/common/oauth2/authorize

Rozsahy

Name	Description
user_impersonation	zosobnění uživatelského účtu

Příklady

ReservationTransactionsByBillingProfileId

Ukázkový požadavek

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

Ukázková odpověď

Stavový kód:: 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"
      }
    }
  ]
}

Definice

Name	Description
ErrorDetails	Podrobnosti o chybě.
ErrorResponse	Chybová odpověď značí, že služba nemůže zpracovat příchozí požadavek. Důvod je uvedený v chybové zprávě. Některé chybové odpovědi: 429 TooManyRequests – Požadavek je omezený. Opakujte akci po čekání na dobu uvedenou v hlavičce x-ms-ratelimit-microsoft.consumption-retry-after. 503 ServiceUnavailable – Služba je dočasně nedostupná. Opakujte akci po čekání na dobu uvedenou v hlavičce Opakovat až po spuštění. 504 Vypršení časového limitu brány – Při zpracování požadavku vypršel časový limit služby. Pokud je to možné, snižte rozsah dat v požadavku.
ModernReservationTransaction	Prostředek transakce moderní rezervace.
ModernReservationTransactionsListResult	Výsledek výpisu doporučení pro rezervace

ErrorDetails

Objekt

Podrobnosti o chybě.

Name	Typ	Description
code	string	Kód chyby
message	string	Chybová zpráva označující, proč operace selhala.

ErrorResponse

Objekt

Chybová odpověď značí, že služba nemůže zpracovat příchozí požadavek. Důvod je uvedený v chybové zprávě.

Některé chybové odpovědi:

429 TooManyRequests – Požadavek je omezený. Opakujte akci po čekání na dobu uvedenou v hlavičce x-ms-ratelimit-microsoft.consumption-retry-after.
503 ServiceUnavailable – Služba je dočasně nedostupná. Opakujte akci po čekání na dobu uvedenou v hlavičce Opakovat až po spuštění.
504 Vypršení časového limitu brány – Při zpracování požadavku vypršel časový limit služby. Pokud je to možné, snižte rozsah dat v požadavku.

Name	Typ	Description
error	ErrorDetails	Podrobnosti o chybě.

ModernReservationTransaction

Objekt

Prostředek transakce moderní rezervace.

Name	Typ	Description
id	string	ID prostředku.
name	string	Název prostředku
properties.amount	number (decimal)	Poplatek za transakci.
properties.armSkuName	string	Toto je název skladové položky ARM. Dá se použít ke spojení s polem serviceType v dalších informacích v záznamech o využití.
properties.billingFrequency	string	Četnost fakturace, která může být jednorázová nebo opakovaná.
properties.billingProfileId	string	ID fakturačního profilu.
properties.billingProfileName	string	Název fakturačního profilu.
properties.currency	string	Měna ISO, ve které se transakce účtuje, například USD.
properties.description	string	Popis transakce.
properties.eventDate	string (date-time)	Datum transakce
properties.eventType	string	Typ transakce (nákup, zrušení nebo refundace)
properties.invoice	string	Číslo faktury
properties.invoiceId	string	ID faktury jako na faktuře, kde se konkrétní transakce zobrazuje.
properties.invoiceSectionId	string	ID oddílu faktury
properties.invoiceSectionName	string	Název oddílu faktury
properties.purchasingSubscriptionGuid	string (uuid)	Identifikátor GUID předplatného, který transakci provede.
properties.purchasingSubscriptionName	string	Název předplatného, který provádí transakci.
properties.quantity	number (decimal)	Množství transakce.
properties.region	string	Oblast transakce.
properties.reservationOrderId	string	ID objednávky rezervace je identifikátor nákupu rezervace. Každé ID objednávky rezervace představuje jednu nákupní transakci. Objednávka rezervace obsahuje rezervace. Objednávka rezervace určuje velikost a oblast virtuálního počítače pro rezervace.
properties.reservationOrderName	string	Název objednávky rezervace.
properties.term	string	Toto je termín transakce.
tags	string[]	Značky prostředků
type	string	Typ zdroje.

ModernReservationTransactionsListResult

Objekt

Výsledek výpisu doporučení pro rezervace

Name	Typ	Description
nextLink	string	Odkaz (url) na další stránku výsledků.
value	ModernReservationTransaction[]	Seznam doporučení pro rezervace.

Sdílet prostřednictvím

Reservation Transactions - List By Billing Profile

Parametry identifikátoru URI

Odpovědi

Zabezpečení

azure_auth

Rozsahy

Příklady

ReservationTransactionsByBillingProfileId

Ukázkový požadavek

Ukázková odpověď

Definice

ErrorDetails

ErrorResponse

ModernReservationTransaction

ModernReservationTransactionsListResult

Další materiály