Azure-Nutzung

Artikel
02/07/2024

Die Azure-Nutzungs-APIs ermöglichen Ihnen einen programmgesteuerten Zugriff auf Kosten- und Nutzungsdaten zu Ihren Azure-Ressourcen. Die APIs unterstützen derzeit nur Enterprise-Registrierungen, Web Direct-Abonnements (mit wenigen Ausnahmen) und CSP-Azure-Planabonnements. Die APIs werden ständig aktualisiert, um andere Typen von Azure-Abonnements zu unterstützen.

Azure-Nutzungs-APIs bieten Zugriff auf Folgendes:

Nur für Enterprise Agreement-Kunden
- Preisblatt
- Budgets
- Vorhersagen
- Bilanzen
- Tags
- Kostentags
Enterprise Agreement- und Web Direct-Kunden
- Reservierungsdetails
- Reservierungszusammenfassungen
- Marketplace-Gebühren
- Nutzungsdetails
- Reservierungsempfehlungen

Liste der nicht unterstützten Abonnementtypen

MS-AZR-0145P (CSP)
MS-AZR-0146P (CSP)
MS-AZR-159P (CSP)
MS-AZR-0036P (Sponsoren)
MS-AZR-0143P (Sponsoren)
MS-AZR-0015P (intern)
MS-AZR-0144P (DreamSpark)

Arbeiten mit Abrechnungszeiträumen und Datumsbereichen

Nutzungsdetails und Marketplace-Gebühren akzeptieren Abrechnungszeitraum oder Datumsbereiche zum Definieren des Start- und Enddatums für die Nutzungsdaten.

Hier sehen Sie das API-Verhalten, das auf Abrechnungszeiträumen und Datumsbereichen in der Anforderung basiert.

In der Anforderung vorhandener Abrechnungszeitraum	Startdatum, das in der Anforderung vorhanden ist	Enddatum, das in der Anforderung vorhanden ist	API-Verhalten
nein	nein	nein	Daten für den aktuellen Abrechnungszeitraum werden als Antwort zurückgegeben.
nein	ja	nein	Daten für den aktuellen Abrechnungszeitraum werden als Antwort zurückgegeben.
nein	nein	ja	Daten für den aktuellen Abrechnungszeitraum werden als Antwort zurückgegeben.
nein	ja	ja	Daten für das angegebene Start- und Enddatum werden als Antwort zurückgegeben.
ja	nein	nein	Daten für den angegebenen Abrechnungszeitraum werden als Antwort zurückgegeben.
ja	ja	nein	Daten für den angegebenen Abrechnungszeitraum werden als Antwort zurückgegeben.
ja	nein	ja	Daten für den angegebenen Abrechnungszeitraum werden als Antwort zurückgegeben.
ja	ja	ja	Daten für das angegebene Start- und Enddatum werden als Antwort zurückgegeben, der angegebene Abrechnungszeitraum wird ignoriert.

Der maximal zulässige Datumsbereich beträgt in einer Anforderung 12 Monate, und die Daten sind ab dem 1. Mai 2014 oder höher verfügbar.

Abrufen einer Liste der Abrechnungszeiträume

Für die Angabe eines gültigen Abrechnungszeitraums in der Anforderung sollte der Client zunächst eine Liste der verfügbaren Abrechnungszeiträume nach Abonnement abrufen, wobei die folgende API verwendet wird.

GET https://management.azure.com/subscriptions/{subscriptionId}/providers/Microsoft.Billing/billingPeriods?api-version=2017-04-24-preview

Mithilfe dieser Liste kann der Client einen bestimmten Abrechnungszeitraum auswählen, um Verbrauchsdaten abzurufen.

Spät eintreffende Daten

Um Drittanbieterdienste zu berücksichtigen, die Verzögerungen bei der Berichterstellung der Nutzung aufweisen, wird das gemeldete Nutzungsdatum auf den Zeitpunkt festgelegt, zu dem die Nutzungsdaten gesendet wurden, und nicht auf den Zeitpunkt der tatsächlichen Nutzung, d. h. auf die Nutzungszeit.

Daher wird die Nutzung für bewertet und auf die gemeldete Zeit angewendet. Um die tatsächliche Verbrauchszeit darzustellen, die Eigenschaften. Das Feld AdditionalProperties enthält nun zwei zusätzliche Eigenschaften. ConsumptionBeginTime und ConsumptionEndTime sind die neuen Felder, die dem Zeitfenster für den tatsächlichen Verbrauch entsprechen.

Diese Änderungen führen zu einigen Szenarien, die beim Aufrufen der Nutzungsdetails-API berücksichtigt werden müssen:

Berichterstellung am Monatsende: Für Nutzungen, die während eines Monats, aber im nächsten Monat gemeldet wurden, müssen Kunden das Feld additionalProperties überprüfen, um die Nutzung dem entsprechenden Monat zuzuweisen.
Abfragenutzungsdetails: Beim Abfragen der Nutzungsdetails-API nach einem Datumsbereich gilt die Abfrage nur für das Datum des Nutzungsberichts und nicht für die Nutzungszeit im Feld additionalProperties . Für Kunden, die Nutzungsdetails zu Rechnungen zuordnen möchten, wirkt sich dieses Update nicht auf den Prozess aus, da die Rechnung die Nutzung basierend auf dem Nutzungsberichtsdatum verarbeitet. Für Kunden, die Nutzungsdetails einem bestimmten Kalenderdatum/Monat zuordnen möchten, stellt dieses Update eine Breaking Change dar, und für diese Szenarien kann das Datum des Nutzungsberichts nicht verwendet werden, und das Datum, an dem die Nutzung aufgetreten ist, im Abschnitt additionalProperties müssen verwendet werden.

Beispielaufruf für zusätzliche Details:

GET https://management.azure.com/subscriptions/{subscriptionId}/providers/Microsoft.Consumption/usageDetails?api-version=2018-03-31&$expand=properties/additionalProperties

Beispiel-Antwortausschnitt:

  "properties": {
    "billingPeriodId":"/subscriptions/{subscriptionid}/providers/Microsoft.Billing/billingPeriods/20180501",
    "usageStart":"2018-05-01T00:00:00.0000000Z",
    "usageEnd":"2018-05-01T23:59:59.0000000Z",
    "instanceId":"/subscriptions/{subscriptionid}/resourceGroups/{resourcegroup}/providers/Microsoft.Cdn/profiles/{profile}",
    "instanceName":"{id}",
    "instanceLocation":"SouthCentralUS",
    "meterId":"6b88ada0-cbc0-4874-be0e-23004f8b4de7",
    "usageQuantity":0.002065,
    "pretaxCost":0,
    "currency":"USD",
    "additionalProperties": {
      "Provider": "1",
      "ConsumptionBeginTime": "2018-05-01T19:00:00",
      "ConsumptionEndTime": "2018-05-01T20:00:00"
    }
  }

Weitere Informationen

Weitere Informationen zur Verwendung dieser API in einem der sprachspezifischen SDKs finden Sie unter:

Bibliotheken zur Azure-Nutzung für Python

Azure-Verbrauchs-API

Node.js SDK zum Azure-Verbrauch

Ruby SDK zum Azure-Verbrauch

Freigeben über