Price Sheet - Download By Billing Account

Dienst:

Cost Management

API-Version:

2024-08-01

Generiert das Preisblatt für den bereitgestellten Abrechnungszeitraum asynchron basierend auf der Registrierungs-ID. Dies gilt für Enterprise Agreement-Kunden.

Zu Version 2024-08-01 migrieren

Sie können die API-Version 2024-08-01 mit dem neuen URI verwenden:

'/providers/Microsoft.Billing/billingAccounts/{billingAccountId}/billingPeriods/{billingPeriodName}/providers/Microsoft.CostManagement/pricesheets/default/download'

Im folgenden neuen Schema enthält die neue Version des Preisblatts zusätzliche Informationen und enthält Preise für Azure Reserved Instances (RI) für den aktuellen Abrechnungszeitraum. Es wird empfohlen, ein Azure-Preisblatt für die Eingabe eines neuen Abrechnungszeitraums herunterzuladen, wenn Sie einen fortlaufenden Datensatz der bisherigen Preise für Azure Reserved Instance (RI) beibehalten würden.

Das EA Azure-Preisblatt ist für Abrechnungszeiträume in den letzten 13 Monaten verfügbar. Wenn Sie ein Preisblatt für einen Abrechnungszeitraum anfordern möchten, der älter als 13 Monate ist, wenden Sie sich bitte an den Support.

Die Downloaderfahrung des Azure-Preisblatts wurde von einer einzelnen .csv Datei auf eine ZIP-Datei aktualisiert, die mehrere .csv Dateien enthält, die jeweils eine maximale Größe von 75 MB aufweisen. Die Version 2023-11-01 wurde aktualisiert, um die HTTP POST-Methode zu verwenden; Details finden Sie unten.

Alle Versionen des Azure-Preisblatts "Microsoft.Consumption" – Nach Abrechnungskonto herunterladen (einschließlich 2022-06-01, 2021-10-01, 2020-01-01-Preview, 2019-10-01, 2019-05-01) werden am 01. Juni 2026 eingestellt und werden nach diesem Datum nicht mehr unterstützt.

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

URI-Parameter

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	Die API-Version, die für diesen Vorgang verwendet werden soll.

Antworten

Name	Typ	Beschreibung
200 OK	OperationStatus	OKAY. Die Anforderung ist erfolgreich.
202 Accepted		Angenommen. Header Location: string Retry-After: string
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

EAPriceSheetForBillingPeriod

Beispielanforderung

HTTP

POST https://management.azure.com/providers/Microsoft.Billing/billingAccounts/0000000/billingPeriods/202311/providers/Microsoft.CostManagement/pricesheets/default/download?api-version=2024-08-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. Eigenschaften, die mit Version 2024-08-01 unterstützt werden, sind wie unten dargestellt.
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.
OperationStatus	Der Status des vorgangs mit langer Ausführung.
OperationStatusType	Der Status des vorgangs mit langer Ausführung.

EAPriceSheetProperties

Die Eigenschaften des EA-Preisblatts. Eigenschaften, die mit Version 2024-08-01 unterstützt werden, sind wie unten dargestellt.

Name	Typ	Beschreibung
basePrice	string	Der Einzelpreis zum Zeitpunkt der Anmeldung des Kunden oder des Einzelpreises zum Zeitpunkt des Ga-Starts der Serviceanzeige, wenn er nach der Anmeldung erfolgt. Dies gilt für Benutzer von Enterprise Agreement
currencyCode	string	Währung, in der das Enterprise Agreement unterzeichnet wurde
effectiveEndDate	string	Effektives Enddatum des Abrechnungszeitraums der Preisliste
effectiveStartDate	string	Effektives Startdatum des Abrechnungszeitraums für das Preisblatt
enrollmentNumber	string	Eindeutiger Bezeichner für das EA-Abrechnungskonto.
includedQuantity	string	Mengen eines bestimmten Dienstes, für den ein EA-Kunde ohne inkrementelle Gebühren in Anspruch nehmen kann.
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. Bei PriceType Consumption spiegelt sich der Marktpreis als kostenpflichtiger Preis wider. Bei PriceType Savings Plan spiegelt der Marktpreis den Sparplanvorteil über den Kostenpflichtig-as-you-go-Preis für den entsprechenden Verpflichtungstermin wider. Bei PriceType ReservedInstance entspricht der Marktpreis dem Gesamtpreis der Verpflichtung von 1 oder 3 Jahren. Hinweis: Bei EA-Kunden ohne Verhandlungen kann der Marktpreis auf eine andere Dezimalpräzision gerundet werden als der Einzelpreis.
meterCategory	string	Name der Klassifizierungskategorie für den Zähler. Beispielsweise Clouddienste, Netzwerk usw.
meterId	string	Eindeutiger Bezeichner des Zählers
meterName	string	Name des Zählers. Der Meter stellt die bereitstellungsfähige Ressource eines Azure-Diensts dar.
meterRegion	string	Name der Azure-Region, in der der Zähler für den Dienst verfügbar ist.
meterSubCategory	string	Name der Kategorie "Meterunterklassifizierung".
meterType	string	Name des Metertyps
offerId	string	Bestimmt das Azure-Angebot, das diesem Meter zugeordnet ist. [Weitere Informationen zu Azure-Angeboten] (https://azure.microsoft.com/en-us/support/legal/offer-details/)
partNumber	string	Teilnummer, die dem Zähler zugeordnet ist
priceType	string	Preisart für ein Produkt. Beispielsweise eine Azure-Ressource mit einem pay-as-you-go-Tarif mit "priceType as Consumption". Weitere Preistypen sind ReservedInstance und Sparplan.
product	string	Name des Produkts, das die Gebühren anfällt.
productId	string	Eindeutiger Bezeichner für das Produkt, dessen Meter verbraucht wird.
serviceFamily	number	Typ des Azure-Diensts. Beispiel: Compute, Analytics und Security.
skuId	string	Eindeutiger Bezeichner der SKU
term	string	Laufzeitdauer für Azure Savings Plan oder Reservierung – ein Jahr oder drei Jahre (P1Y oder P3Y)
unitOfMeasure	string	Wie die Nutzung für den Dienst gemessen wird. Hinweis: Das Feld "Unit" wurde mit Version 2023-11-01 als Duplikat von "UnitofMeasure" entfernt, verwenden Sie bitte das Feld "UnitOfMeasure".
unitPrice	string	Der Preis pro Einheit zum Zeitpunkt der Abrechnung für ein bestimmtes Produkt oder eine bestimmte Dienstleistung, einschließlich aller ausgehandelten Rabatte über den Marktpreis. Bei PriceType ReservedInstance entspricht der Einzelpreis den Gesamtkosten der Verpflichtung von 1 oder 3 Jahren einschließlich Rabatten. Hinweis: Der Einzelpreis ist nicht identisch mit dem effektiven Preis in Nutzungsdetails Downloads, wenn Dienste unterschiedliche Preise in verschiedenen Ebenen haben. Wenn Dienste über mehrstufige Preise verfügen, ist der effektive Preis ein gemischter Preis über die Stufen hinweg und zeigt keinen tierspezifischen Einzelpreis an. Der gemischte Preis oder der effektive Preis ist der Nettopreis für die verbrauchte Menge, die sich über mehrere Ebenen erstreckt (wobei jede Stufe einen bestimmten Einzelpreis hat).

ErrorDetails

Die Details des Fehlers.

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

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.

Name	Typ	Beschreibung
error	ErrorDetails	Die Details des Fehlers.

OperationStatus

Der Status des vorgangs mit langer Ausführung.

Name	Typ	Beschreibung
properties.downloadFileProperties	EAPriceSheetProperties	Die Eigenschaften in heruntergeladener Datei
properties.downloadUrl	string	Der Link (URL), um das Preisblatt herunterzuladen.
properties.validTill	string	Gültigkeit des Downloadlinks.
status	OperationStatusType	Der Status des vorgangs mit langer Ausführung.

OperationStatusType

Der Status des vorgangs mit langer Ausführung.

Name	Typ	Beschreibung
Completed	string
Failed	string
Running	string