Azure-Nutzung
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