Price Sheet - Download By Billing Account

Referenz

Dienst:: Cost Management

API-Version:: 2023-11-01

Generiert das Preisblatt für den angegebenen Abrechnungszeitraum asynchron basierend auf der Registrierungs-ID. Dies gilt für Enterprise Agreement Kunden. Sie können die neue API-Version 2023-09-01 unter "/providers/Microsoft.Billing/billingAccounts/{billingAccountId}/billingPeriods/{billingPeriodName}/providers/Microsoft.CostManagement/pricesheets/default/download" für Abrechnungszeiträume ab Januar 2023 verwenden. Mit einem neuen Schema, das unten beschrieben wird, bietet das neue Preisblatt weitere Informationen und enthält Preise für Reservierte Azure-Instanzen (Ri) für den aktuellen Abrechnungszeitraum.

Es wird empfohlen, ein Azure-Preisblatt für herunterzuladen, wenn Sie einen neuen Abrechnungszeitraum eingeben, wenn Sie einen Datensatz über frühere Preise für reservierte Azure-Instanzen (Azure Reserved Instance, RI) führen würden. Aufgrund des Azure-Produktwachstums wird die Downloaderfahrung für Azure-Preistabellen in dieser Vorschauversion von einer einzelnen .csv-Datei in eine ZIP-Datei aktualisiert, die mehrere CSV-Dateien mit einer maximalen Größe von jeweils 75 MB enthält.

POST https://management.azure.com/providers/Microsoft.Billing/billingAccounts/{billingAccountId}/billingPeriods/{billingPeriodName}/providers/Microsoft.CostManagement/pricesheets/default/download?api-version=2023-11-01

URI-Parameter

Name In Erforderlich Typ Beschreibung

Name	In	Erforderlich	Typ	Beschreibung
billingAccountId	path	True	string	BillingAccount-ID
billingPeriodName	path	True	string	Name des Abrechnungszeitraums. RegEx-Muster: `^[0-9]*$`
api-version	query	True	string	Hierbei handelt es sich um die für diesen Vorgang zu verwendende API-Version.

billingAccountId

path

True

string

BillingAccount-ID

billingPeriodName

path

True

string

Name des Abrechnungszeitraums.

RegEx-Muster: ^[0-9]*$

api-version

query

True

string

Hierbei handelt es sich um die für diesen Vorgang zu verwendende API-Version.

Antworten

Name	Typ	Beschreibung
200 OK	OperationStatus	OK. Die Anforderung war erfolgreich.
202 Accepted		Akzeptiert: Header Location: string Retry-After: string
Other Status Codes	ErrorResponse	Fehlerantwort mit Beschreibung des Grunds für den Fehler.

Name

Typ

Beschreibung

200 OK

OperationStatus

OK. Die Anforderung war erfolgreich.

202 Accepted

Akzeptiert:

Header

Location: string
Retry-After: string

Other Status Codes

ErrorResponse

Fehlerantwort mit Beschreibung des Grunds für den Fehler.

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	Identitätswechsel Ihres Benutzerkontos

Beispiele

EAPriceSheetForBillingPeriod

Beispielanforderung

HTTP

POST https://management.azure.com/providers/Microsoft.Billing/billingAccounts/0000000/billingPeriods/202311/providers/Microsoft.CostManagement/pricesheets/default/download?api-version=2023-11-01

Beispiel für eine Antwort

Statuscode:: 202

Location: https://management.azure.com/providers/Microsoft.Billing/billingAccounts/0000000/providers/Microsoft.CostManagement/operationResults/00000000-0000-0000-0000-000000000000?api-version=2023-09-01
Retry-After: 60

Statuscode:: 200

{
  "status": "Completed",
  "properties": {
    "downloadUrl": "https://myaccount.blob.core.windows.net/?restype=service&comp=properties&sv=2015-04-05&ss=bf&srt=s&st=2015-04-29T22%3A18%3A26Z&se=2015-04-30T02%3A23%3A26Z&sr=b&sp=rw&spr=https&sig=G%2TEST%4B",
    "validTill": "2023-09-30T17:32:28Z"
  }
}

Definitionen

Name	Beschreibung
EAPriceSheetProperties	Die Eigenschaften des EA-Preisblatts.
ErrorDetails	Die Details des Fehlers.
ErrorResponse	Die Fehlerantwort gibt an, dass der Dienst die eingehende Anforderung nicht verarbeiten kann. Der Grund wird in der Fehlermeldung angegeben. Einige Fehlerantworten: 429 TooManyRequests: Die Anforderung wird gedrosselt. Wiederholen Sie den Vorgang, nachdem Sie auf die im Header "x-ms-ratelimit-microsoft.consumption-retry-after" angegebene Zeit gewartet haben. 503 ServiceUnavailable: Der Dienst ist vorübergehend nicht verfügbar. Wiederholen Sie den Vorgang, nachdem Sie die im Header „Retry-After“ angegebene Zeit abgewartet haben.
OperationStatus	Die status des zeitintensiven Vorgangs.
OperationStatusType	Die status des zeitintensiven Vorgangs.

EAPriceSheetProperties

Die Eigenschaften des EA-Preisblatts.

Name	Typ	Beschreibung
basePrice	string	Der Einzelpreis zum Zeitpunkt der Anmeldung des Kunden oder der Einzelpreis zum Zeitpunkt des Ga-Starts der Service-Verbrauchseinheit, wenn er nach der Anmeldung erfolgt. Dies gilt für Enterprise Agreement Benutzer
currencyCode	string	Währung, in der die Enterprise Agreement signiert wurde
effectiveEndDate	string	Effektives Enddatum des Abrechnungszeitraums des Preisblatts
effectiveStartDate	string	Effektives Startdatum des Abrechnungszeitraums "Price Sheet"
enrollmentNumber	string	Eindeutiger Bezeichner für das EA-Abrechnungskonto.
includedQuantity	string	Mengen eines bestimmten Diensts, für den ein EA-Kunde berechtigt ist, ohne inkrementelle Gebühren zu nutzen.
marketPrice	string	Der aktuelle Listenpreis für ein bestimmtes Produkt oder eine bestimmte Dienstleistung. Dieser Preis ist ohne Verhandlungen und basiert auf Ihrem Microsoft-Vertragstyp. Für PriceType Consumption wird der Marktpreis als preisbasierte Bezahlung widergespiegelt. Für PriceType Sparplan spiegelt der Marktpreis den Vorteil des Sparplans neben dem Preis für die nutzungsbasierte Bezahlung für die entsprechende Laufzeit wider. Für PriceType ReservedInstance spiegelt der Marktpreis den Gesamtpreis der 1- oder 3-Jahres-Verpflichtung wider. Hinweis: Bei EA-Kunden ohne Verhandlungen wird der Marktpreis möglicherweise auf eine andere Dezimalgenauigkeit gerundet als der Einzelpreis.
meterCategory	string	Name der Klassifizierungskategorie der Verbrauchseinheit. Beispiele: Clouddienste, Netzwerk usw.
meterId	string	Eindeutiger Bezeichner der Verbrauchseinheit
meterName	string	Name der Verbrauchseinheit. Die Verbrauchseinheit stellt die bereitstellbare Ressource eines Azure-Diensts dar.
meterRegion	string	Name der Azure-Region, in der die Verbrauchseinheit für den Dienst verfügbar ist.
meterSubCategory	string	Name der Unterklassifizierungskategorie der Verbrauchseinheit.
meterType	string	Name des Verbrauchseinheitstyps
partNumber	string	Der Verbrauchseinheit zugeordnete Teilenummer
priceType	string	Preistyp für ein Produkt. Beispiel: eine Azure-Ressource mit einem Tarif mit nutzungsbasierter Bezahlung mit priceType als Consumption. Weitere Preistypen sind ReservedInstance und Sparplan.
product	string	Der Name des Produkts, für das die Gebühren anfallen.
productId	string	Eindeutiger Bezeichner für das Produkt, dessen Verbrauchseinheit genutzt wird.
serviceFamily	number	Der Typ des Azure-Diensts. Beispiel: Compute, Analytics und Sicherheit.
skuId	string	Eindeutiger Bezeichner der SKU
term	string	Laufzeitdauer für Azure-Sparplan oder Reservierungslaufzeit – ein Jahr oder drei Jahre (P1Y oder P3Y)
unitOfMeasure	string	Wie die Nutzung für den Dienst gemessen wird
unitPrice	string	Der Preis pro Einheit zum Zeitpunkt der Abrechnung für ein bestimmtes Produkt oder eine bestimmte Dienstleistung, einschließlich aller ausgehandelten Rabatte auf dem Marktpreis. Für PriceType ReservedInstance spiegelt der Einzelpreis die Gesamtkosten der 1- oder 3-Jahres-Verpflichtung einschließlich Rabatten wider. Hinweis: Der Preis pro Einheit ist nicht mit dem effektiven Preis in den Downloads der Nutzungsdetails identisch, wenn es sich um Dienste mit unterschiedlichen Preisen für die verschiedenen Stufen handelt. Bei Diensten mit mehrstufiger Preisgestaltung ist der effektive Preis eine stufenübergreifende Mischrate, und es wird dafür kein stufenspezifischer Einzelpreis angezeigt. Der Mischpreis oder der gültige Preis ist der Nettopreis für die verbrauchte Menge über mehrere Stufen hinweg (wobei für jede Stufe ein bestimmter Einzelpreis gilt).

ErrorDetails

Die Details des Fehlers.

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

ErrorResponse

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

Einige Fehlerantworten:

429 TooManyRequests: Die Anforderung wird gedrosselt. Wiederholen Sie den Vorgang, nachdem Sie auf die im Header "x-ms-ratelimit-microsoft.consumption-retry-after" angegebene Zeit gewartet haben.
503 ServiceUnavailable: Der Dienst ist vorübergehend nicht verfügbar. Wiederholen Sie den Vorgang, nachdem Sie die im Header „Retry-After“ angegebene Zeit abgewartet haben.

Name	Typ	Beschreibung
error	ErrorDetails	Die Details des Fehlers.

OperationStatus

Die status des zeitintensiven Vorgangs.

Name	Typ	Beschreibung
properties.downloadFileProperties	EAPriceSheetProperties	Die Eigenschaften in der heruntergeladenen Datei
properties.downloadUrl	string	Der Link (URL) zum Herunterladen des Preisblatts.
properties.validTill	string	Gültigkeit des Downloadlinks.
status	OperationStatusType	Die status des zeitintensiven Vorgangs.

OperationStatusType

Die status des zeitintensiven Vorgangs.

Name	Typ	Beschreibung
Completed	string
Failed	string
Running	string

Freigeben über

Price Sheet - Download By Billing Account

URI-Parameter

Antworten

Sicherheit

azure_auth

Bereiche

Beispiele

EAPriceSheetForBillingPeriod

Beispielanforderung

Beispiel für eine Antwort

Definitionen

EAPriceSheetProperties

ErrorDetails

ErrorResponse

OperationStatus

OperationStatusType

Zusätzliche Ressourcen