Price Sheet - Get

Dienst:

Consumption

API-Version:

2024-08-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=2024-08-01

Mit optionalen Parametern:

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

URI-Parameter

Name	In	Erforderlich	Typ	Beschreibung
subscriptionId	path	True	string	Azure-Abonnement-ID.
api-version	query	True	string	Version der API, die mit der Clientanforderung verwendet werden soll. Die aktuelle Version ist 2023-03-01.
$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	OKAY. Die Anforderung ist erfolgreich.
Other Status Codes	ErrorResponse	Fehlerantwort, die beschreibt, warum der Vorgang fehlgeschlagen ist.

Sicherheit

azure_auth

Azure Active Directory OAuth2-Fluss.

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

Bereiche

Name	Beschreibung
user_impersonation	Identitätswechsel ihres Benutzerkontos

Beispiele

PriceSheet

Beispielanforderung

HTTP

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

Beispiel für eine Antwort

Statuscode:

200

{
  "id": "/subscriptions/00000000-0000-0000-0000-000000000000/providers/Microsoft.Billing/billingPeriods/201702/providers/Microsoft.Consumption/pricesheets/default",
  "name": "default",
  "type": "Microsoft.Consumption/pricesheets",
  "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",
        "meterId": "00000000-0000-0000-0000-000000000000",
        "unitOfMeasure": "100 Hours",
        "includedQuantity": 100,
        "partNumber": "XX-11110",
        "unitPrice": 0.00328,
        "currencyCode": "EUR",
        "offerId": "OfferId 1",
        "savingsPlan": {
          "term": "P3Y",
          "effectivePrice": 0.002,
          "marketPrice": 0.00328
        }
      }
    ]
  }
}

Definitionen

Name	Beschreibung
ErrorAdditionalInfo	Der Ressourcenverwaltungsfehler zusätzliche Informationen.
ErrorDetail	Das Fehlerdetails.
ErrorResponse	Fehlerantwort
MeterDetails	Die Details zum Meter. Standardmäßig wird dies nicht ausgefüllt, es sei denn, sie wird in $expand angegeben.
PriceSheetProperties	Preisblatt
PriceSheetResult	Eine Preistabellenressource.
SavingsPlan	SavingsPlan Details

ErrorAdditionalInfo

Objekt

Der Ressourcenverwaltungsfehler zusätzliche Informationen.

Name	Typ	Beschreibung
info	object	Die zusätzlichen Informationen.
type	string	Der zusätzliche Informationstyp.

ErrorDetail

Objekt

Das Fehlerdetails.

Name	Typ	Beschreibung
additionalInfo	ErrorAdditionalInfo[]	Die zusätzlichen Informationen des Fehlers.
code	string	Der Fehlercode.
details	ErrorDetail[]	Die Fehlerdetails.
message	string	Die Fehlermeldung.
target	string	Das Fehlerziel.

ErrorResponse

Objekt

Fehlerantwort

Name	Typ	Beschreibung
error	ErrorDetail	Das Fehlerobjekt.

MeterDetails

Objekt

Die Details zum Meter. Standardmäßig wird dies nicht ausgefüllt, es sei denn, sie wird in $expand angegeben.

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 des Zählers innerhalb der angegebenen Meterkategorie
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

Preisblatt

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	SavingsPlan Details
unitOfMeasure	string	Maßeinheit
unitPrice	number (decimal)	Einheitenpreis

PriceSheetResult

Objekt

Eine Preistabellenressource.

Name	Typ	Beschreibung
etag	string	Das Etag für die Ressource.
id	string	Die vollständige qualifizierte ARM-ID eines Ereignisses.
name	string	Die ID, die ein Ereignis eindeutig identifiziert.
properties.download	MeterDetails	Downloaddetails für Preislisten.
properties.nextLink	string	Der Link (URL) zur nächsten Seite der Ergebnisse.
properties.pricesheets	PriceSheetProperties[]	Preisblatt
tags	object	Ressourcentags.
type	string	Ressourcentyp.

SavingsPlan

Objekt

SavingsPlan Details

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