Azure Consumption

Med Azure Consumption-API:erna får du programmatisk åtkomst till kostnads- och användningsdata för dina Azure-resurser. Dessa API:er stöder för närvarande endast Enterprise-registreringar och Web Direct-prenumerationer (med några få undantag). API:erna uppdateras kontinuerligt med stöd för andra typer av Azure-prenumerationer.

Azure Consumption-API:er ger åtkomst till:

• Endast Enterprise-kunder
  • Prisdokument
  • Budgetar
  • Prognoser
  • Saldon
  • Taggar
  • Kostnadstaggar
• Enterprise- och Web Direct-kunder
  • Information om reservation
  • Reservationssammanfattningar
  • Marketplace-debiteringar
  • Användningsinformation
  • Reservationsrekommendationer

Lista över prenumerationstyper som inte stöds

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

REST-åtgärdsgrupper

Arbeta med faktureringsperioder och datumintervall

Användningsinformation och Marketplace-avgifter accepterar faktureringsperiod eller datumintervall för att definiera start- och slutdatum för användningsdata.

Här är API-beteendet baserat på faktureringsperioder och datumintervall i begäran.

Det högsta tillåtna datumintervallet är 12 månader i en begäran och data är tillgängliga från den 1 maj 2014 eller senare.

Hämta lista över faktureringsperioder

För att tillhandahålla en giltig faktureringsperiod i begäran bör klienten först hämta en lista över tillgängliga faktureringsperioder efter prenumeration med hjälp av följande API

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

Med den här listan kan klienten välja en specifik faktureringsperiod för att hämta förbrukningsdata.

Data som kommer sent

För att hantera tjänster från tredje part, som har fördröjningar i rapporteringen av användning, anges det rapporterade användningsdatumet till den tid då användningsdata skickades, till skillnad från när den faktiska användningen ägde rum, det vill säga förbrukningstid.

Därför kommer användningen att klassificeras för och tillämpas på den rapporterade tiden. Egenskaperna för att representera den faktiska förbrukningstiden. Fältet AdditionalProperties innehåller nu ytterligare två egenskaper. ConsumptionBeginTime och ConsumptionEndTime är de nya fält som motsvarar det faktiska förbrukningstidsfönstret.

De här ändringarna resulterar i några scenarier som måste åtgärdas när API:et för användningsinformation anropas:

1. Rapportering vid månadsslut: För användning som inträffade under en månad, men som rapporterades under nästa månad, måste kunderna titta på fältet additionalProperties för att tilldela användningen till lämplig månad.

2. Information om frågeanvändning: När du frågar API:et för användningsinformation efter ett datumintervall gäller frågan endast användningsrapportdatumet och inte förbrukningstiden i fältet additionalProperties. För kunder som vill mappa användningsinformation till fakturor påverkar den här uppdateringen inte processen eftersom fakturan bearbetar användningen baserat på användningsrapportdatumet. För kunder som vill mappa användningsinformation till ett specifikt kalenderdatum/månad är den här uppdateringen en icke-specifik ändring. I dessa scenarier kan inte användningsrapportdatumet användas och det datum då användningen inträffade i avsnittet additionalProperties måste användas.

Exempel på anrop för ytterligare information:

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

Exempel på svarsfragment:

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

Se även

Mer information om hur du använder det här API:et i en av de språkspecifika API:erna finns i följande

Python SDK för Azure Consumption

CLI för Azure Consumption

.NET SDK för Azure Consumption

NodeJS SDK för Azure Consumption

Ruby SDK för Azure Consumption