Price Sheet - Get

Dienst:: Consumption

API-Version:: 2026-06-01

Ruft das Preisblatt für ein Abonnement ab. Das Preisblatt ist nur für den 1. Mai 2014 oder höher über diese API verfügbar.

GET https://management.azure.com/subscriptions/{subscriptionId}/providers/Microsoft.Consumption/pricesheets/default?api-version=2026-06-01

Mit optionalen Parametern:

GET https://management.azure.com/subscriptions/{subscriptionId}/providers/Microsoft.Consumption/pricesheets/default?api-version=2026-06-01&$expand={$expand}&$skiptoken={$skiptoken}&$top={$top}

URI-Parameter

Name	In	Erforderlich	Typ	Beschreibung
subscriptionId	path	True	string minLength: 1	Die ID des Zielabonnements.
api-version	query	True	string minLength: 1	Die API-Version, die für diesen Vorgang verwendet werden soll.
$expand	query		string	Kann verwendet werden, um die Eigenschaften/MeterDetails innerhalb eines Preisblatts zu erweitern. Standardmäßig sind diese Felder beim Zurückgeben des Preisblatts nicht enthalten.
$skiptoken	query		string	Skiptoken wird nur verwendet, wenn ein vorheriger Vorgang ein Teilergebnis zurückgegeben hat. Wenn eine vorherige Antwort ein nextLink-Element enthält, enthält der Wert des nextLink-Elements einen Skiptoken-Parameter, der einen Ausgangspunkt angibt, der für nachfolgende Aufrufe verwendet werden soll.
$top	query		integer (int32) minimum: 1 maximum: 1000	Kann verwendet werden, um die Anzahl der Ergebnisse auf die obersten N-Ergebnisse zu beschränken.

Antworten

Name	Typ	Beschreibung
200 OK	PriceSheetResult	Der Azure-Vorgang wurde erfolgreich abgeschlossen.
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

PriceSheet

Beispielanforderung

HTTP

GET https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/providers/Microsoft.Consumption/pricesheets/default?api-version=2026-06-01

Beispiel für eine Antwort

Statuscode:: 200

{
  "name": "default",
  "type": "Microsoft.Consumption/pricesheets",
  "id": "/subscriptions/00000000-0000-0000-0000-000000000000/providers/Microsoft.Billing/billingPeriods/201702/providers/Microsoft.Consumption/pricesheets/default",
  "properties": {
    "nextLink": "https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/providers/microsoft.consumption/pricesheets/default?api-version=2018-01-31&$skiptoken=AQAAAA%3D%3D",
    "pricesheets": [
      {
        "billingPeriodId": "/subscriptions/00000000-0000-0000-0000-000000000000/providers/Microsoft.Billing/billingPeriods/201702",
        "currencyCode": "EUR",
        "includedQuantity": 100,
        "meterId": "00000000-0000-0000-0000-000000000000",
        "offerId": "OfferId 1",
        "partNumber": "XX-11110",
        "savingsPlan": {
          "effectivePrice": 0.002,
          "marketPrice": 0.00328,
          "term": "P3Y"
        },
        "unitOfMeasure": "100 Hours",
        "unitPrice": 0.00328
      }
    ]
  }
}

Definitionen

Name	Beschreibung
createdByType	Der Identitätstyp, der die Ressource erstellt hat.
ErrorAdditionalInfo	Zusätzliche Informationen zum Fehler bei der Ressourcenverwaltung.
ErrorDetail	Die Fehlerdetails.
ErrorResponse	Fehlerantwort
MeterDetails	Die Eigenschaften des Meterdetails.
PriceSheetProperties	Die Eigenschaften des Preisblatts.
PriceSheetResult	Eine Preistabellenressource.
SavingsPlan	Die Eigenschaften des SavingsPlan.
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

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.

MeterDetails

Objekt

Die Eigenschaften des Meterdetails.

Name	Typ	Beschreibung
meterCategory	string	Die Kategorie des Zählers, z. B. "Clouddienste", "Netzwerk", usw.
meterLocation	string	Der Speicherort, an dem der Azure-Dienst verfügbar ist.
meterName	string	Der Name der Verbrauchseinheit innerhalb der angegebenen Verbrauchseinheitenkategorie
meterSubCategory	string	Die Unterkategorie des Zählers, z. B. "A6 Cloud Services", "ExpressRoute (IXP)" usw.
pretaxStandardRate	number (decimal)	Der Vortax-Eintragspreis.
serviceName	string	Der Name des Diensts.
serviceTier	string	Die Dienstebene.
totalIncludedQuantity	number (decimal)	Die gesamt enthaltene Menge, die dem Angebot zugeordnet ist.
unit	string	Die Einheit, in der der Meterverbrauch berechnet wird, z. B. "Stunden", "GB" usw.

PriceSheetProperties

Objekt

Die Eigenschaften des Preisblatts.

Name	Typ	Beschreibung
billingPeriodId	string	Die ID der Abrechnungszeitraumsressource, zu der die Verwendung gehört.
currencyCode	string	Währungscode
includedQuantity	number (decimal)	Inklusive Qualität für ein Angebot
meterDetails	MeterDetails	Die Details zum Meter. Standardmäßig wird dies nicht ausgefüllt, es sei denn, sie wird in $expand angegeben.
meterId	string (uuid)	Die Meter-ID (GUID)
offerId	string	Angebots-ID
partNumber	string	Teilenummer
savingsPlan	SavingsPlan	Details zum Sparplan
unitOfMeasure	string	Maßeinheit
unitPrice	number (decimal)	Einzelpreis

PriceSheetResult

Objekt

Eine Preistabellenressource.

Name	Typ	Beschreibung
etag	string	eTag der Ressource. Um das Szenario für gleichzeitige Updates zu behandeln, wird dieses Feld verwendet, um zu bestimmen, ob der Benutzer die neueste Version aktualisiert oder nicht.
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.download	MeterDetails	Downloaddetails für Preislisten.
properties.nextLink	string	Der Link (URL) zur nächsten Seite der Ergebnisse.
properties.pricesheets	PriceSheetProperties[]	Preisblatt
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"

SavingsPlan

Objekt

Die Eigenschaften des SavingsPlan.

Name	Typ	Beschreibung
effectivePrice	number (decimal)	Sparplan effektiver Preis
marketPrice	number (decimal)	Sparplan Marktpreis
term	string	Sparplan-Laufzeit

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.