Azure spotřeba

Rozhraní API služby Azure Consumption poskytuje programový přístup k informacím o nákladech a využití pro vaše prostředky Azure. Rozhraní API v současné době podporují pouze podnikové registrace, předplatná Web Direct (s několika výjimkami) a předplatná plánů Azure CSP. Rozhraní API se průběžně aktualizují, aby podporovala i jiné typy předplatných Azure.

Rozhraní API služby Azure Consumption poskytuje přístup pro:

• Pouze pro podnikové zákazníky
  • Ceník
  • Rozpočty
  • Prognózy
  • Balances
  • Štítky
  • Cenové štítky
• Podnikoví a weboví přímí zákazníci
  • Podrobnosti rezervace
  • Přehledy rezervace
  • Poplatky za marketplace
  • Podrobnosti využití
  • Doporučení k rezervaci

Seznam nepodporovaných typů předplatného

• MS-AZR-0145P (CSP)
• MS-AZR-0146P (CSP)
• MS-AZR-159P (CSP)
• MS-AZR-0036P (sponzorováno)
• MS-AZR-0143P (sponzorováno)
• MS-AZR-0015P (interní)
• MS-AZR-0144P (DreamSpark)

Práce s fakturačními obdobími a časovými obdobími

Podrobnosti o využití a poplatky za Marketplace přijímají fakturační období nebo rozsahy dat pro definování počátečního a koncového data dat o využití.

Zde je chování API založené na fakturačních obdobích a datových rozmezích požadovaných požadavků:

Požadované fakturační období	Datum začátku žádosti	Datum ukončení žádosti	Chování rozhraní API
Ne	Ne	Ne	V odpovědi jsou vráceny údaje za aktuální fakturační období
Ne	Ano	Ne	V odpovědi jsou vráceny údaje za aktuální fakturační období
Ne	Ne	Ano	V odpovědi jsou vráceny údaje za aktuální fakturační období
Ne	Ano	Ano	V odpovědi jsou vrácena data pro zadané datum zahájení a ukončení
Ano	Ne	Ne	V odpovědi jsou vráceny údaje za zadané zúčtovací období
Ano	Ano	Ne	V odpovědi jsou vráceny údaje za zadané zúčtovací období
Ano	Ne	Ano	V odpovědi jsou vráceny údaje za zadané zúčtovací období
Ano	Ano	Ano	V odpovědi jsou vráceny údaje pro zadané Datum zahájení a Ukončení, zadané fakturační období je ignorováno

Maximální povolené časové období je 12 měsíců v jednom požadavku a data jsou k dispozici od 1. května 2014 nebo později.

Získání seznamu fakturačních období

Pro zajištění platného fakturačního období v požadavku by klient měl nejprve získat seznam dostupných fakturačních období prostřednictvím předplatného pomocí následujícího API

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

Pomocí seznamu si klient může vybrat konkrétní fakturační období pro získání dat o spotřebě.

Pozdě příchozí data

Aby bylo možné vyhovět službám třetích stran, které mají zpoždění v hlášení spotřeby, je hlášené datum využití nastaveno na čas, kdy byla data o spotřebě odeslána, na rozdíl od doby, kdy k použití skutečně došlo, tedy k času spotřeby.

Výsledkem je, že spotřeba je hodnocena a aplikována na vykazovaný čas. Pro reprezentaci skutečné doby spotřeby vlastnosti Pole AdditionalProperties nyní bude obsahovat další dvě vlastnosti. ConsumptionBeginTime a ConsumptionEndTime jsou nová pole, která odpovídají skutečnému časovému intervalu spotřeby.

Tyto změny vedou k několika situacím, které je třeba řešit při volání API pro detaily použití:

1. Měsíční reportování: Pro spotřebu, která proběhla během měsíce, ale byla hlášena během následujícího měsíce, musí zákazníci zvážit pole additionalProperties , aby přiřadili použití příslušnému měsíci.

2. Dotaz na detaily využití: Když dotazujete API pro detaily využití podle datového rozmezí, dotaz se vztahuje pouze na datum hlášení využití a ne na dobu spotřeby v poli dodatečných vlastností . Pro zákazníky, kteří chtějí namapovat detaily využití na faktury, tato aktualizace proces neovlivňuje, protože faktura zpracovává spotřebu na základě data hlášení o spotřebě. Pro zákazníky, kteří chtějí namapovat detaily využití na konkrétní kalendářní datum/měsíc, je tato aktualizace zásadní změnou a v těchto případech nelze použít datum zprávy o využití a v sekci dodatečné vlastnosti musí být použito datum hlášení o využití a datum provedení použití.

Ukázkový hovor pro více informací:

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

Ukázkový fragment odpovědi:

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

Viz také

Další informace o použití tohoto rozhraní API v jedné ze sad SDK specifických pro daný jazyk naleznete v následujících článcích

Sada SDK Python pro využití Azure

Rozhraní příkazového řádku Azure Consumption

Sada SDK NodeJS pro využití Azure

Azure Consumption Ruby SDK