Price Sheet - Get By Billing Period

Referenz

Dienst:: Consumption

API-Version:: 2024-08-01

Rufen Sie das Preisblatt für einen Bereich nach subscriptionId und Abrechnungszeitraum 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.Billing/billingPeriods/{billingPeriodName}/providers/Microsoft.Consumption/pricesheets/default?api-version=2024-08-01

Mit optionalen Parametern:

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

URI-Parameter

Name	In	Erforderlich	Typ	Beschreibung
billingPeriodName	path	True	string	Name des Abrechnungszeitraums.
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

PriceSheetExpand

PriceSheetForBillingPeriod

PriceSheetExpand

Beispielanforderung

HTTP

GET https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/providers/Microsoft.Billing/billingPeriods/201801/providers/Microsoft.Consumption/pricesheets/default?$expand=meterDetails&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&$expand=properties/pricesheets/meterDetails",
    "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",
        "meterDetails": {
          "meterName": "Data Transfer Out (GB)",
          "meterCategory": "Networking",
          "unit": "GB",
          "meterLocation": "Zone 2",
          "totalIncludedQuantity": 0,
          "pretaxStandardRate": 0.138
        }
      }
    ]
  }
}

PriceSheetForBillingPeriod

Beispielanforderung

HTTP

GET https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/providers/Microsoft.Billing/billingPeriods/201801/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.Billing/billingPeriods/201702/providers/microsoft.consumption/pricesheets/default?api-version=2018-01-31",
    "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"
      }
    ]
  }
}

Definitionen

Name	Beschreibung
ErrorDetails	Die Details des Fehlers.
ErrorResponse	Fehlerantwort gibt an, dass der Dienst die eingehende Anforderung nicht verarbeiten kann. Der Grund wird in der Fehlermeldung angegeben. Einige Fehlerantworten: 429 TooManyRequests – Anforderung wird gedrosselt. Wiederholen Sie den Vorgang nach dem Warten auf die im Header "x-ms-ratelimit-microsoft.consumption-retry-after" angegebene Zeit. 503 ServiceUnavailable – Dienst ist vorübergehend nicht verfügbar. Wiederholen Sie den Vorgang nach dem Warten auf die im Header "Retry-After" angegebene Zeit. 504 Gatewaytimeout – Diensttimeout beim Verarbeiten der Anforderung. Verringern Sie den Datumsbereich in der Anforderung, falls möglich.
MeterDetails	Die Eigenschaften des Meterdetails.
PriceSheetProperties	Die Eigenschaften des Preisblatts.
PriceSheetResult	Eine Preistabellenressource.
SavingsPlan	Die Eigenschaften des SavingsPlan.

ErrorDetails

Objekt

Die Details des Fehlers.

Name	Typ	Beschreibung
code	string	Fehlercode.
message	string	Fehlermeldung, die angibt, warum der Vorgang fehlgeschlagen ist.

ErrorResponse

Objekt

Fehlerantwort gibt an, dass der Dienst die eingehende Anforderung nicht verarbeiten kann. Der Grund wird in der Fehlermeldung angegeben.

Einige Fehlerantworten:

429 TooManyRequests – Anforderung wird gedrosselt. Wiederholen Sie den Vorgang nach dem Warten auf die im Header "x-ms-ratelimit-microsoft.consumption-retry-after" angegebene Zeit.
503 ServiceUnavailable – Dienst ist vorübergehend nicht verfügbar. Wiederholen Sie den Vorgang nach dem Warten auf die im Header "Retry-After" angegebene Zeit.
504 Gatewaytimeout – Diensttimeout beim Verarbeiten der Anforderung. Verringern Sie den Datumsbereich in der Anforderung, falls möglich.

Name	Typ	Beschreibung
error	ErrorDetails	Die Details des Fehlers.

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 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

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	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

Die Eigenschaften des SavingsPlan.

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

Freigeben über

Price Sheet - Get By Billing Period

URI-Parameter

Antworten

Sicherheit

azure_auth

Bereiche

Beispiele

PriceSheetExpand

Beispielanforderung

Beispiel für eine Antwort

PriceSheetForBillingPeriod

Beispielanforderung

Beispiel für eine Antwort

Definitionen

ErrorDetails

ErrorResponse

MeterDetails

PriceSheetProperties

PriceSheetResult

SavingsPlan

Zusätzliche Ressourcen