Price Sheet - Download By Billing Profile

Referenz

Dienst:: Cost Management

API-Version:: 2024-08-01

Ruft eine URL zum Herunterladen der Preistabelle des aktuellen Monats für ein Abrechnungsprofil ab. Der Vorgang wird für Abrechnungskonten mit dem Vertragstyp Microsoft Partner Agreement oder Microsoft Customer Agreement unterstützt.

Sie können die neue API-Version 2023-09-01 für Abrechnungszeiträume ab Januar 2023 verwenden. Die Preise für Azure Reserved Instance (RI) sind nur über die neue Version der API verfügbar.

Aufgrund des Azure-Produktwachstums wird die Downloaderfahrung des Azure-Preisblatts in dieser Vorschauversion von einer einzelnen CSV/JSON-Datei auf eine ZIP-Datei aktualisiert, die mehrere CSV/JSON-Dateien enthält, jeweils mit einer maximalen Größe von 75 MB.

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

URI-Parameter

Name In Erforderlich Typ Beschreibung

billingAccountName

path

True

string

Die ID, die ein Abrechnungskonto eindeutig identifiziert.

RegEx-Muster: ([A-Za-z0-9]+(-[A-Za-z0-9]+)+):([A-Za-z0-9]+(-[A-Za-z0-9]+)+)_[0-9]{4}-[0-9]{2}-[0-9]{2}

billingProfileName

path

True

string

Die ID, die ein Abrechnungsprofil eindeutig identifiziert.

RegEx-Muster: ([A-Za-z0-9]+(-[A-Za-z0-9]+)+)

api-version

query

True

string

Die API-Version, die für diesen Vorgang verwendet werden soll.

Antworten

Name

Typ

Beschreibung

200 OK

PricesheetDownloadProperties

OKAY. Die Anforderung ist erfolgreich.

202 Accepted

Angenommen.

Header

Location: string
Retry-After: string
OData-EntityId: string

Other Status Codes

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

PricesheetDownloadByBillingProfile

Beispielanforderung

HTTP

POST https://management.azure.com/providers/Microsoft.Billing/billingAccounts/7c05a543-80ff-571e-9f98-1063b3b53cf2:99ad03ad-2d1b-4889-a452-090ad407d25f_2019-05-31/billingProfiles/2USN-TPCD-BG7-TGB/providers/Microsoft.CostManagement/pricesheets/default/download?api-version=2024-08-01

Beispiel für eine Antwort

Statuscode:: 202

Location: https://management.azure.com:443/providers/Microsoft.Billing/billingAccounts/7c05a543-80ff-571e-9f98-1063b3b53cf2:99ad03ad-2d1b-4889-a452-090ad407d25f_2019-05-31/billingProfiles/2USN-TPCD-BG7-TGB/providers/Microsoft.CostManagement/operationResults/45000000-0000-0000-0000-000000000000?sessiontoken=0:000000&api-version=2024-08-01&OperationType=PriceSheet
Retry-After: 60
OData-EntityId: 45000000-0000-0000-0000-000000000000

Statuscode:: 200

{
  "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",
  "expiryTime": "2018-07-21T17:32:28Z"
}

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.
MCAPriceSheetProperties	Die Eigenschaften des Preisblatts.
PricesheetDownloadProperties	Die URL zum Herunterladen des generierten Berichts.

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.

MCAPriceSheetProperties

Die Eigenschaften des Preisblatts.

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
billingAccountID	string	Eindeutiger Bezeichner für das Abrechnungskonto.
billingAccountName	string	Name des Abrechnungsprofils, das für den Empfang von Rechnungen eingerichtet ist. Die Preise im Preisblatt sind diesem Abrechnungsprofil zugeordnet.
billingCurrency	string	Währung, in der Gebühren gebucht werden.
billingProfileId	string	Eindeutiger Bezeichner für das Abrechnungsprofil.
billingProfileName	string	Name des Abrechnungsprofils, das für den Empfang von Rechnungen eingerichtet ist. Die Preise im Preisblatt sind diesem Abrechnungsprofil zugeordnet.
currency	string	Währung, in der alle Preise widerspiegelt werden.
effectiveEndDate	string	Effektives Enddatum des Abrechnungszeitraums der Preisliste
effectiveStartDate	string	Effektives Startdatum des Abrechnungszeitraums für das Preisblatt
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.
meterCategory	string	Name der Klassifizierungskategorie für den Zähler. Beispielsweise Clouddienste, Netzwerk usw.
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
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.
productOrderName	string	Name des gekauften Produktplans. Gibt an, ob diese Preise standardmäßige Azure Plan-Preise, Dev/Test-Preise usw. sind. Derzeit nicht für Azure 3-Drittanbieter- und ReservedInstance-Meter verfügbar.
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)
tierMinimumUnits	string	Definiert die untere Grenze des Tierbereichs, für den Die Preise definiert sind. Wenn der Bereich beispielsweise 0 bis 100 ist, wäre tierMinimumUnits 0.
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 ü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).

PricesheetDownloadProperties

Die URL zum Herunterladen des generierten Berichts.

Name	Typ	Beschreibung
downloadFileProperties	MCAPriceSheetProperties	Die Eigenschaften in heruntergeladener Datei
downloadUrl	string	Die URL zum Herunterladen des generierten Berichts.
expiryTime	string	Die Uhrzeit, zu der die Berichts-URL in UTC ungültig/abläuft, z. B. 2020-12-08T05:55:59.4394737Z.