Reservations Summaries - List

Dienst:: Consumption

API-Version:: 2026-06-01

Listet die Reservierungszusammenfassungen für den definierten Bereich täglich oder monatlich an. Hinweis: ARM hat eine Nutzlastgröße von 12 MB, sodass derzeit Anrufer 400 erhalten, wenn die Antwortgröße den ARM-Grenzwert überschreitet. In solchen Fällen sollte der API-Aufruf mit kleineren Datumsbereichen erfolgen.

GET https://management.azure.com/{resourceScope}/providers/Microsoft.Consumption/reservationSummaries?api-version=2026-06-01&grain={grain}

Mit optionalen Parametern:

GET https://management.azure.com/{resourceScope}/providers/Microsoft.Consumption/reservationSummaries?api-version=2026-06-01&grain={grain}&startDate={startDate}&endDate={endDate}&$filter={$filter}&reservationId={reservationId}&reservationOrderId={reservationOrderId}

URI-Parameter

Name	In	Erforderlich	Typ	Beschreibung
resourceScope	path	True	string	Die vollständig qualifizierte Azure Resource Manager-Kennung der Ressource.
api-version	query	True	string minLength: 1	Die API-Version, die für diesen Vorgang verwendet werden soll.
grain	query	True	Datagrain	Kann täglich oder monatlich sein
$filter	query		string	Nur für tägliches Getreide erforderlich. Die Eigenschaften/UsageDate für Startdatum und Enddatum. Der Filter unterstützt "le" und "ge". Nicht anwendbar bei Abfragen mit Abrechnungsprofil
endDate	query		string	Enddatum. Gilt nur beim Abfragen mit dem Abrechnungsprofil
reservationId	query		string	GUID der Reservierungs-ID. Nur gültig, wenn "reservationOrderId" ebenfalls angegeben wird. Filtern nach einer bestimmten Reservierung
reservationOrderId	query		string	GUID der Reservierungsauftrags-ID. Erforderlich, wenn reservierungs-ID angegeben wird. Filtern nach einer bestimmten Reservierungsbestellung
startDate	query		string	Startdatum. Gilt nur beim Abfragen mit dem Abrechnungsprofil

Antworten

Name	Typ	Beschreibung
200 OK	ReservationSummariesListResult	Die Anforderung war erfolgreich.
Other Status Codes	ErrorResponse	Unerwartete Fehlerantwort.

Sicherheit

azure_auth

Azure Active Directory OAuth2 Flow.

Typ: oauth2
Ablauf: implicit
Autorisierungs-URL: https://login.microsoftonline.com/common/oauth2/authorize

Bereiche

Name	Beschreibung
user_impersonation	Sich als Ihr Benutzerkonto ausgeben

Beispiele

ReservationSummariesDailyWithBillingAccountId

ReservationSummariesDailyWithBillingProfileId

ReservationSummariesMonthlyWithBillingAccountId

ReservationSummariesMonthlyWithBillingProfileId

ReservationSummariesMonthlyWithBillingProfileIdReservationId

ReservationSummariesDailyWithBillingAccountId

Beispielanforderung

HTTP

GET https://management.azure.com/providers/Microsoft.Billing/billingAccounts/12345/providers/Microsoft.Consumption/reservationSummaries?api-version=2026-06-01&grain=daily&$filter=properties/usageDate ge 2017-10-01 AND properties/usageDate le 2017-11-20

Beispiel für eine Antwort

Statuscode:: 200

{
  "value": [
    {
      "name": "reservationSummaries_Id1",
      "type": "Microsoft.Consumption/reservationSummaries",
      "id": "/providers/Microsoft.Billing/billingAccounts/12345/providers/Microsoft.Consumption/reservationSummaries/reservationSummaries_Id1",
      "properties": {
        "avgUtilizationPercentage": 0,
        "maxUtilizationPercentage": 0,
        "minUtilizationPercentage": 0,
        "reservationId": "00000000-0000-0000-0000-000000000000",
        "reservationOrderId": "00000000-0000-0000-0000-000000000000",
        "reservedHours": 720,
        "skuName": "Standard_B1s",
        "usageDate": "2018-09-01T00:00:00-07:00",
        "usedHours": 0
      },
      "tags": null
    }
  ]
}

ReservationSummariesDailyWithBillingProfileId

Beispielanforderung

HTTP

GET https://management.azure.com/providers/Microsoft.Billing/billingAccounts/12345:2468/billingProfiles/13579/providers/Microsoft.Consumption/reservationSummaries?api-version=2026-06-01&grain=daily&startDate=2017-10-01&endDate=2017-11-20

Beispiel für eine Antwort

Statuscode:: 200

{
  "value": [
    {
      "name": "reservationSummaries_Id1",
      "type": "Microsoft.Consumption/reservationSummaries",
      "id": "/providers/Microsoft.Billing/billingAccounts/12345:2468/billingProfiles/13579/providers/Microsoft.Consumption/reservationSummaries/reservationSummaries_Id1",
      "properties": {
        "avgUtilizationPercentage": 0,
        "maxUtilizationPercentage": 0,
        "minUtilizationPercentage": 0,
        "reservationId": "00000000-0000-0000-0000-000000000000",
        "reservationOrderId": "00000000-0000-0000-0000-000000000000",
        "reservedHours": 720,
        "skuName": "Standard_B1s",
        "usageDate": "2018-09-01T00:00:00-07:00",
        "usedHours": 0
      },
      "tags": null
    }
  ]
}

ReservationSummariesMonthlyWithBillingAccountId

Beispielanforderung

HTTP

GET https://management.azure.com/providers/Microsoft.Billing/billingAccounts/12345/providers/Microsoft.Consumption/reservationSummaries?api-version=2026-06-01&grain=monthly

Beispiel für eine Antwort

Statuscode:: 200

{
  "value": [
    {
      "name": "reservationSummaries_Id1",
      "type": "Microsoft.Consumption/reservationSummaries",
      "id": "/providers/Microsoft.Billing/billingAccounts/12345/providers/Microsoft.Consumption/reservationSummaries/reservationSummaries_Id1",
      "properties": {
        "avgUtilizationPercentage": 0,
        "maxUtilizationPercentage": 0,
        "minUtilizationPercentage": 0,
        "reservationId": "00000000-0000-0000-0000-000000000000",
        "reservationOrderId": "00000000-0000-0000-0000-000000000000",
        "reservedHours": 720,
        "skuName": "Standard_B1s",
        "usageDate": "2018-09-01T00:00:00-07:00",
        "usedHours": 0
      },
      "tags": null
    }
  ]
}

ReservationSummariesMonthlyWithBillingProfileId

Beispielanforderung

HTTP

GET https://management.azure.com/providers/Microsoft.Billing/billingAccounts/12345:2468/billingProfiles/13579/providers/Microsoft.Consumption/reservationSummaries?api-version=2026-06-01&grain=monthly

Beispiel für eine Antwort

Statuscode:: 200

{
  "value": [
    {
      "name": "reservationSummaries_Id1",
      "type": "Microsoft.Consumption/reservationSummaries",
      "id": "/providers/Microsoft.Billing/billingAccounts/12345:2468/billingProfiles/13579/providers/Microsoft.Consumption/reservationSummaries/reservationSummaries_Id1",
      "properties": {
        "avgUtilizationPercentage": 0,
        "maxUtilizationPercentage": 0,
        "minUtilizationPercentage": 0,
        "reservationId": "00000000-0000-0000-0000-000000000000",
        "reservationOrderId": "00000000-0000-0000-0000-000000000000",
        "reservedHours": 720,
        "skuName": "Standard_B1s",
        "usageDate": "2018-09-01T00:00:00-07:00",
        "usedHours": 0
      },
      "tags": null
    }
  ]
}

ReservationSummariesMonthlyWithBillingProfileIdReservationId

Beispielanforderung

HTTP

GET https://management.azure.com/providers/Microsoft.Billing/billingAccounts/12345:2468/billingProfiles/13579/providers/Microsoft.Consumption/reservationSummaries?api-version=2026-06-01&grain=monthly&reservationId=1c6b6358-709f-484c-85f1-72e862a0cf3b&reservationOrderId=9f39ba10-794f-4dcb-8f4b-8d0cb47c27dc

Beispiel für eine Antwort

Statuscode:: 200

{
  "value": [
    {
      "name": "reservationSummaries_Id1",
      "type": "Microsoft.Consumption/reservationSummaries",
      "id": "/providers/Microsoft.Billing/billingAccounts/12345:2468/billingProfiles/13579/providers/Microsoft.Consumption/reservationSummaries/reservationSummaries_Id1",
      "properties": {
        "avgUtilizationPercentage": 0,
        "maxUtilizationPercentage": 0,
        "minUtilizationPercentage": 0,
        "reservationId": "1c6b6358-709f-484c-85f1-72e862a0cf3b",
        "reservationOrderId": "9f39ba10-794f-4dcb-8f4b-8d0cb47c27dc",
        "reservedHours": 720,
        "skuName": "Standard_B1s",
        "usageDate": "2018-09-01T00:00:00-07:00",
        "usedHours": 0
      },
      "tags": null
    }
  ]
}

Definitionen

Name	Beschreibung
createdByType	Der Identitätstyp, der die Ressource erstellt hat.
Datagrain
ErrorAdditionalInfo	Zusätzliche Informationen zum Fehler bei der Ressourcenverwaltung.
ErrorDetail	Die Fehlerdetails.
ErrorResponse	Fehlerantwort
ReservationSummariesListResult	Ergebnis der Auflistung von Reservierungszusammenfassungen.
ReservationSummary	Reservierungszusammenfassungsressource.
systemData	Metadaten zur Erstellung und letzten Änderung der Ressource.

createdByType

Enumeration

Der Identitätstyp, der die Ressource erstellt hat.

Wert	Beschreibung
User
Application
ManagedIdentity
Key

Datagrain

Enumeration

Wert	Beschreibung
daily	Tägliches Datenkorn
monthly	Monatliches Datenkorn

ErrorAdditionalInfo

Objekt

Zusätzliche Informationen zum Fehler bei der Ressourcenverwaltung.

Name	Typ	Beschreibung
info	object	Zusätzliche Informationen.
type	string	Typ der Zusatzinformationen.

ErrorDetail

Objekt

Die Fehlerdetails.

Name	Typ	Beschreibung
additionalInfo	ErrorAdditionalInfo[]	Die Zusatzinformationen zum Fehler.
code	string	Der Fehlercode.
details	ErrorDetail[]	Die Fehlerdetails.
message	string	Die Fehlermeldung.
target	string	Der Fehlerzielwert.

ErrorResponse

Objekt

Fehlerantwort

Name	Typ	Beschreibung
error	ErrorDetail	Das Fehlerobjekt.

ReservationSummariesListResult

Objekt

Ergebnis der Auflistung von Reservierungszusammenfassungen.

Name	Typ	Beschreibung
nextLink	string	Der Link (URL) zur nächsten Seite der Ergebnisse.
value	ReservationSummary[]	Die Liste der Reservierungszusammenfassungen.

ReservationSummary

Objekt

Reservierungszusammenfassungsressource.

Name	Typ	Beschreibung
etag	string	Das Etag für die Ressource.
id	string	Vollqualifizierte Ressourcen-ID für die Ressource. Beispiel: /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}
name	string	Der Name der Ressource
properties.avgUtilizationPercentage	number (decimal)	Dies ist die durchschnittliche Auslastung für den gesamten Zeitraum. (Tag oder Monat je nach Getreide)
properties.kind	string	Die Reservierungsart.
properties.maxUtilizationPercentage	number (decimal)	Dies ist die maximale Stundenauslastung in der Nutzungszeit (Tag oder Monat). Wenn z. B. der Verwendungseintrag 12.10.2017 entspricht und für die Stunde 4 und 5, betrug die Auslastung 100%, gibt dieses Feld 100% für diesen Tag zurück.
properties.minUtilizationPercentage	number (decimal)	Dies ist die minimale Stundenauslastung in der Nutzungszeit (Tag oder Monat). Wenn der Verwendungsdatensatz z. B. dem 12.10.2017 entspricht und für die Stunde 4 und 5, betrug die Auslastung 10%, gibt dieses Feld 10% für diesen Tag zurück.
properties.purchasedQuantity	number (decimal)	Dies ist die erworbene Menge für die reservierungs-ID.
properties.remainingQuantity	number (decimal)	Dies ist die verbleibende Menge für die reservierungs-ID.
properties.reservationId	string	Die Reservierungs-ID ist der Bezeichner einer Reservierung innerhalb eines Reservierungsauftrags. Jede Reservierung ist die Gruppierung für die Anwendung des Leistungsumfangs und gibt auch die Anzahl der Instanzen an, auf die der Reservierungsvorteil angewendet werden kann.
properties.reservationOrderId	string	Die Reservierungsauftrags-ID ist der Bezeichner für einen Reservierungskauf. Jede Reservierungsauftrags-ID stellt eine einzelne Kauftransaktion dar. Eine Reservierungsbestellung enthält Reservierungen. Die Reservierungsreihenfolge gibt die Größe und Region des virtuellen Computers für die Reservierungen an.
properties.reservedHours	number (decimal)	Dies ist die Gesamtzahl der reservierten Stunden. Wenn z. B. eine Reservierung für 1 Instanz am 1:00 Uhr erfolgt ist, beträgt dies 11 Stunden für diesen Tag und 24 Stunden ab nachfolgenden Tagen
properties.skuName	string	Dies ist der ARM-Sku-Name. Sie kann verwendet werden, um mit dem ServiceType-Feld in zusätzlichen Informationen in Verwendungsdatensätzen zu verbinden.
properties.totalReservedQuantity	number (decimal)	Dies ist die Gesamtanzahl der Instanzen, die für die reservationId reserviert sind.
properties.usageDate	string (date-time)	Daten, die dem Auslastungsdatensatz entsprechen. Wenn das Datenkorn monatlich ist, wird es der erste Tag des Monats sein.
properties.usedHours	number (decimal)	Gesamtzahl der von der Reservierung verwendeten Stunden
properties.usedQuantity	number (decimal)	Dies ist die verwendete Menge für die reservierungs-ID.
properties.utilizedPercentage	number (decimal)	Dies ist der verwendete Prozentsatz für die Reservierungs-ID.
systemData	systemData	Azure Resource Manager-Metadaten, die createdBy- und modifiedBy-Informationen enthalten.
tags	object	Ressourcenkennzeichnungen.
type	string	Der Typ der Ressource. Z. B. "Microsoft.Compute/virtualMachines" oder "Microsoft.Storage/storageAccounts"

systemData

Objekt

Metadaten zur Erstellung und letzten Änderung der Ressource.

Name	Typ	Beschreibung
createdAt	string (date-time)	Der Zeitstempel der Ressourcenerstellung (UTC).
createdBy	string	Die Identität, die die Ressource erstellt hat.
createdByType	createdByType	Der Identitätstyp, der die Ressource erstellt hat.
lastModifiedAt	string (date-time)	Der Zeitstempel der letzten Änderung der Ressource (UTC)
lastModifiedBy	string	Die Identität, die die Ressource zuletzt geändert hat.
lastModifiedByType	createdByType	Der Identitätstyp, der die Ressource zuletzt geändert hat.