Azure Consumption

  • Artikel

Med Azure Consumption-API:erna får du programmatisk åtkomst till kostnads- och användningsdata för dina Azure-resurser. API:erna stöder för närvarande endast Enterprise-registreringar, Web Direct-prenumerationer (med några få undantag) och CSP Azure-prenumerationer. 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)

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.

Faktureringsperiod som finns i begäran Startdatum som finns i begäran Slutdatum som finns i begäran API-beteende
nej nej nej Data för aktuell faktureringsperiod returneras som svar
nej ja nej Data för aktuell faktureringsperiod returneras som svar
nej nej ja Data för aktuell faktureringsperiod returneras som svar
nej ja ja Data för angivet start- och slutdatum returneras som svar
ja nej nej Data för den angivna faktureringsperioden returneras som svar
ja ja nej Data för den angivna faktureringsperioden returneras som svar
ja nej ja Data för den angivna faktureringsperioden returneras som svar
ja ja ja Data för angivet start- och slutdatum returneras som svar, angiven faktureringsperiod ignoreras

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

Hämta en lista över faktureringsperioder

För att tillhandahålla en giltig faktureringsperiod i begäran bör klienten först få en lista över tillgängliga faktureringsperioder per 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.

För sent ankommande data

För att hantera tjänster från tredje part, som har fördröjningar i rapporteringsanvändningen, anges det rapporterade användningsdatumet till den tidpunkt då användningsdata skickades, till skillnad från när den faktiska användningen ägde rum, dvs. förbrukningstid.

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

Dessa ändringar resulterar i några scenarier som måste åtgärdas när api:et för användningsinformation anropas:

  1. Månadsslutrapportering: För användning som inträffat under en månad, men som rapporteras under nästa månad, måste kunderna titta på fältet ytterligare Egenskaper 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ändningsrapportdatum 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 visst kalenderdatum/en viss månad är den här uppdateringen en icke-bakåtkompatibel ändring och för dessa scenarier kan inte användningsrapportdatumet användas och det datum då användningen inträffade, i avsnittet ytterligare Egenskaper måste användas.

Exempelanrop 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 någon av de språkspecifika SDK:erna finns i följande

Python SDK för Azure Consumption

CLI för Azure Consumption

NodeJS SDK för Azure Consumption

Ruby SDK för Azure Consumption