Freigeben über

Migrieren von der EA-Preisblatt-API

  • Artikel

EA-Kunden, die bisher die API für Unternehmensberichte von consumption.azure.com verwendet haben, um ihr Preisblatt abzurufen, müssen auf eine gleichwertige Azure Resource Manager-API umsteigen. Die folgenden Anweisungen helfen Ihnen bei der Migration und beschreiben auch alle Vertragsunterschiede zwischen der alten API und der neuen API.

Hinweis

Alle Azure Enterprise-Berichterstellungs-APIs werden eingestellt. Sie sollten so bald wie möglich zu Microsoft Cost Management-APIs migrieren.

Zuweisen von Berechtigungen zu einem Dienstprinzipal zum Aufrufen der API

Bevor Sie die API aufrufen, müssen Sie einen Dienstprinzipal (SPN) mit der richtigen Berechtigung konfigurieren. Sie verwenden den Dienstprinzipal, um die API aufzurufen. Weitere Informationen finden Sie unter Zuweisen von Berechtigungen zu Cost Management-APIs.

Aufrufen der Preisblatt-API

Die Preisblatt-API generiert das Preisblatt asynchron und erzeugt eine Datei, die Sie herunterladen.

Verwenden Sie die folgenden Anforderungs-URIs beim Aufrufen der neuen Preisblatt-API:

Unterstützte Anforderungen

Sie können die API mit dem folgenden Bereich aufrufen:

Registrierung: providers/Microsoft.Billing/billingAccounts/{billingAccountId}

Nach Abrechnungskonto für den angegebenen Abrechnungszeitraum herunterladen

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

Die POST-Anforderung gibt einen Ort zurück, an dem der Status der Berichtsgenerierung abgefragt wird, wie in der folgenden Antwort beschrieben:

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

Beispielanforderung zum Abfragen des Status der Berichterstellung

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

Änderungen des Antworttexts

[
        {
              "id": "enrollments/57354989/billingperiods/201601/products/343/pricesheets",
              "billingPeriodId": "201704",
            "meterId": "dc210ecb-97e8-4522-8134-2385494233c0",
              "meterName": "A1 VM",
              "unitOfMeasure": "100 Hours",
              "includedQuantity": 0,
              "partNumber": "N7H-00015",
              "unitPrice": 0.00,
              "currencyCode": "USD"
        },
        {
              "id": "enrollments/57354989/billingperiods/201601/products/2884/pricesheets",
              "billingPeriodId": "201404",
            "meterId": "dc210ecb-97e8-4522-8134-5385494233c0",
              "meterName": "Locally Redundant Storage Premium Storage - Snapshots - AU East",
              "unitOfMeasure": "100 GB",
              "includedQuantity": 0,
              "partNumber": "N9H-00402",
              "unitPrice": 0.00,
              "currencyCode": "USD"
        },
        ...
]

Neue Änderungen an Antworten

Folgende Preisblatt-Eigenschaften stehen zur Verfügung:

Name Art Beschreibung
basePrice Zeichenfolge Der Einheitspreis zum Zeitpunkt der Kundenanmeldung oder der Einheitspreis zum Zeitpunkt der allgemeinen Verfügbarkeit der Dienstverbrauchseinheit, wenn dieser nach der Anmeldung liegt.

Das gilt für Enterprise Agreement-Benutzer
currencyCode Zeichenfolge Währung, in der das Enterprise Agreement unterzeichnet wurde
effectiveEndDate Zeichenfolge Effektives Enddatum des Abrechnungszeitraums der Preisliste
effectiveStartDate Zeichenfolge Effektives Startdatum des Abrechnungszeitraums der Preisliste
enrollmentNumber Zeichenfolge Eindeutiger Bezeichner für das EA-Abrechnungskonto.
includedQuantity Zeichenfolge Mengen eines bestimmten Diensts, auf die ein EA-Kunde Anspruch hat, ohne dass inkrementelle Gebühren anfallen.
marketPrice Zeichenfolge Der aktuelle Listenpreis für ein bestimmtes Produkt oder eine bestimmte Dienstleistung. Dieser Preis ist nicht verhandelbar und basiert auf Ihrem Microsoft-Vertragstyp.

Beim PriceType Verbrauch spiegelt sich der Marktpreis als nutzungsbasierter Preis wider.

Beim PriceType Sparplan spiegelt der Marktpreis den Sparplanvorteil zusätzlich zum nutzungsbasierten Preis für den entsprechenden Verpflichtungszeitraum wider.

Beim PriceType ReservedInstance spiegelt der Marktpreis den Gesamtpreis des ein- oder dreijährigen Prepaidtarifs wider.

Hinweis: Bei EA-Kunden ohne Verhandlungen kann der Marktpreis auf eine andere Dezimalgenauigkeit gerundet sein als der Einheitspreis.
meterCategory Zeichenfolge Name der Klassifizierungskategorie der Verbrauchseinheit. Beispiele: Clouddienste, Netzwerk usw.
meterId Zeichenfolge Eindeutiger Bezeichner der Verbrauchseinheit
meterName Zeichenfolge Name der Verbrauchseinheit. Die Verbrauchseinheit stellt die bereitstellbare Ressource eines Azure-Diensts dar.
meterRegion Zeichenfolge Der Name der Azure-Region, in der die Verbrauchseinheit für den Dienst verfügbar ist.
meterSubCategory Zeichenfolge Name der Unterklassifizierungskategorie der Verbrauchseinheit.
meterType Zeichenfolge Name des Verbrauchseinheitstyps
partNumber Zeichenfolge Teilenummer, die der Verbrauchseinheit zugeordnet ist
priceType Zeichenfolge Preistyp für ein Produkt. Beispielsweise verfügt eine Azure-Ressource über einen nutzungsbasierten Tarif mit dem priceType Verbrauch. Weitere Preistypen sind ReservedInstance und Sparplan.
product Zeichenfolge Der Name des Produkts, für das die Gebühren anfallen.
productId Zeichenfolge Eindeutiger Bezeichner für das Produkt, dessen Verbrauchseinheit genutzt wird.
serviceFamily Zahl Der Typ des Azure-Diensts. Beispiel: Compute, Analytics und Sicherheit.
skuId Zeichenfolge Eindeutiger Bezeichner der SKU
term Zeichenfolge Laufzeitdauer für Azure-Sparplan oder Reservierung – ein Jahr oder drei Jahre (P1Y oder P3Y)
unitOfMeasure Zeichenfolge Wie die Nutzung für den Dienst gemessen wird
unitPrice Zeichenfolge Der Preis pro Einheit zum Zeitpunkt der Abrechnung für ein bestimmtes Produkt oder einen bestimmten Dienst einschließlich vereinbarter Rabatte zusätzlich zum nutzungsabhängigen Preis.

Beim PriceType ReservedInstance spiegelt der Einheitspreis die Gesamtkosten des ein- oder dreijährigen Prepaidtarifs 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).

Zugehöriger Inhalt