Reservation Transactions - List
Liste des transactions pour les instances réservées dans l’étendue du compte de facturation. Remarque : Les transactions de remboursement sont publiées avec leur transaction d’achat (c’est-à-dire dans le mois de facturation de l’achat). Par exemple, le remboursement est demandé en mai 2021. Cette transaction de remboursement aura la date de l’événement de mai 2021, mais le mois de facturation sera avril 2020 lorsque l’achat de la réservation a été effectué. Remarque : ARM a une limite de taille de charge utile de 12 Mo. Par conséquent, les appelants obtiennent actuellement 400 lorsque la taille de réponse dépasse la limite ARM. Dans ce cas, l’appel d’API doit être effectué avec des plages de dates plus petites.
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}
Paramètres URI
Nom | Dans | Obligatoire | Type | Description |
---|---|---|---|---|
billing
|
path | True |
string |
BillingAccount ID |
api-version
|
query | True |
string |
Version de l’API à utiliser avec la demande du client. La version actuelle est 2023-03-01. |
$filter
|
query |
string |
Filtrez les transactions de réservation par plage de dates. Propriétés/EventDate pour la date de début et la date de fin. Le filtre prend en charge « le » et « ge ». Remarque : l’API retourne des données pour l’ensemble du mois de facturation de la date de début et de la date de fin. Par exemple, les propriétés de filtre/eventDate+ge+2020-01-01+AND+properties/eventDate+le+2020-12-29 incluront des données pour l’ensemble du mois de décembre 2020 (c’est-à-dire, contiendra des enregistrements pour les dates 30 et 31 décembre) |
|
preview
|
query |
number decimal |
Pourcentage de balisage d’aperçu à appliquer. |
|
use
|
query |
boolean |
Applique la marque jusqu’aux transactions si l’appelant est un partenaire. |
Réponses
Nom | Type | Description |
---|---|---|
200 OK |
OK. La demande a réussi. |
|
Other Status Codes |
Réponse d’erreur décrivant la raison de l’échec de l’opération. |
Sécurité
azure_auth
Flux OAuth2 Azure Active Directory.
Type:
oauth2
Flow:
implicit
Authorization URL:
https://login.microsoftonline.com/common/oauth2/authorize
Scopes
Nom | Description |
---|---|
user_impersonation | Emprunter l’identité de votre compte d’utilisateur |
Exemples
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
}
}
]
}
Définitions
Nom | Description |
---|---|
Error |
Détails de l’erreur. |
Error |
La réponse d’erreur indique que le service n’est pas en mesure de traiter la requête entrante. La raison est fournie dans le message d’erreur. Réponses d’erreur :
|
Reservation |
Ressource de transaction de réservation. |
Reservation |
Résultat de la liste des recommandations de réservation. |
ErrorDetails
Détails de l’erreur.
Nom | Type | Description |
---|---|---|
code |
string |
Code d’erreur. |
message |
string |
Message d’erreur indiquant la raison de l’échec de l’opération. |
ErrorResponse
La réponse d’erreur indique que le service n’est pas en mesure de traiter la requête entrante. La raison est fournie dans le message d’erreur.
Réponses d’erreur :
429 TooManyRequests : la demande est limitée. Réessayez après avoir attendu l’heure spécifiée dans l’en-tête « x-ms-ratelimit-microsoft.consumption-retry-after ».
503 ServiceUnavailable : le service est temporairement indisponible. Réessayez après avoir attendu le temps spécifié dans l’en-tête « Retry-After ».
Nom | Type | Description |
---|---|---|
error |
Détails de l’erreur. |
ReservationTransaction
Ressource de transaction de réservation.
Nom | Type | Description |
---|---|---|
id |
string |
ID de ressource. |
name |
string |
Nom de la ressource. |
properties.accountName |
string |
Nom du compte qui effectue la transaction. |
properties.accountOwnerEmail |
string |
E-mail du propriétaire du compte qui effectue la transaction. |
properties.amount |
number |
Frais de la transaction. |
properties.armSkuName |
string |
Il s’agit du nom de la référence SKU ARM. Il peut être utilisé pour joindre le champ serviceType dans des informations supplémentaires dans les enregistrements d’utilisation. |
properties.billingFrequency |
string |
Fréquence de facturation, qui peut être ponctuelle ou périodique. |
properties.billingMonth |
integer |
Mois de facturation (aaaaMMdd), sur lequel l’événement a démarré. |
properties.costCenter |
string |
Le centre de coûts de ce service s’il s’agit d’un service et d’un centre de coûts est fourni. |
properties.currency |
string |
Devise ISO dans laquelle la transaction est facturée, par exemple, USD. |
properties.currentEnrollment |
string |
Inscription actuelle. |
properties.departmentName |
string |
Nom du service. |
properties.description |
string |
Description de la transaction. |
properties.eventDate |
string |
Date de la transaction |
properties.eventType |
string |
Type de la transaction (Achat, Annulation ou Remboursement). |
properties.monetaryCommitment |
number |
Montant de l’engagement financier au niveau de l’étendue d’inscription. |
properties.overage |
number |
Montant de dépassement au niveau de l’étendue de l’inscription. |
properties.purchasingEnrollment |
string |
Inscription d’achat. |
properties.purchasingSubscriptionGuid |
string |
GUID d’abonnement qui effectue la transaction. |
properties.purchasingSubscriptionName |
string |
Nom de l’abonnement qui effectue la transaction. |
properties.quantity |
number |
Quantité de la transaction. |
properties.region |
string |
Région de la transaction. |
properties.reservationOrderId |
string |
L’ID de commande de réservation est l’identificateur d’un achat de réservation. Chaque ID de commande de réservation représente une transaction d’achat unique. Un ordre de réservation contient des réservations. L’ordre de réservation spécifie la taille et la région de la machine virtuelle pour les réservations. |
properties.reservationOrderName |
string |
Nom de l’ordre de réservation. |
properties.term |
string |
Il s’agit du terme de la transaction. |
tags |
string[] |
Balises de ressource. |
type |
string |
Type de ressource. |
ReservationTransactionsListResult
Résultat de la liste des recommandations de réservation.
Nom | Type | Description |
---|---|---|
nextLink |
string |
Lien (URL) vers la page de résultats suivante. |
value |
Liste des recommandations de réservation. |