Azure Consumption

Článek
02/03/2024

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í jenom 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:

Jenom pro podnikové zákazníky
- Ceník
- Rozpočty
- Prognózy
- Zůstatky
- Značky
- Cenové značky
Podnikoví a weboví přímí zákazníci
- Podrobnosti rezervace
- Přehledy rezervace
- Poplatky za marketplace
- Podrobnosti využití
- Doporučení pro rezervace

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 rozsahy dat

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 pro data o využití.

Tady je chování rozhraní API na základě fakturačních období a rozsahů dat v požadavku.

Fakturační období, které je přítomné v žádosti	Počáteční datum, které je k dispozici v žádosti	Koncové datum v žádosti	Chování rozhraní API
ne	ne	ne	V odpovědi se vrátí data pro aktuální fakturační období.
ne	ano	ne	V odpovědi se vrátí data pro aktuální fakturační období.
ne	ne	ano	V odpovědi se vrátí data pro aktuální fakturační období.
ne	ano	ano	V odpovědi se vrátí data pro zadané počáteční a koncové datum.
ano	ne	ne	V odpovědi se vrátí data za zadané fakturační období.
ano	ano	ne	V odpovědi se vrátí data za zadané fakturační období.
ano	ne	ano	V odpovědi se vrátí data za zadané fakturační období.
ano	ano	ano	V odpovědi se vrátí data pro zadané počáteční a koncové datum, zadané fakturační období se ignoruje.

Maximální povolený rozsah dat je 12 měsíců v jedné žádosti a data jsou k dispozici od 1. května 2014 nebo později.

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

Pro poskytnutí platného fakturačního období na žádost by klient měl nejprve získat seznam dostupných fakturačních období podle předplatného pomocí následujícího rozhraní API.

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

Pomocí tohoto seznamu může klient vybrat konkrétní fakturační období, aby získal údaje o spotřebě.

Data s pozdním příchodem

Pro služby třetích stran, které mají zpoždění při vykazování využití, je datum nahlášeného využití nastaveno na čas, kdy byly údaje o využití odeslány, na rozdíl od okamžiku, kdy k skutečnému využití došlo, tj. čas spotřeby.

V důsledku toho se využití ohodnotí a použije na vykazovaný čas. Aby bylo možné znázorňovat skutečnou dobu spotřeby, vlastnosti. Pole AdditionalProperties teď bude obsahovat dvě další vlastnosti. ConsumptionBeginTime a ConsumptionEndTime jsou nová pole, která odpovídají časovému intervalu skutečné spotřeby.

Výsledkem těchto změn bude několik scénářů, které bude potřeba vyřešit při volání rozhraní API pro podrobnosti o využití:

Generování sestav konce měsíce: V případě využití, ke kterému došlo během měsíce, ale bylo hlášeno během následujícího měsíce, se zákazníci budou muset podívat do pole additionalVlastnosti a přiřadit využití příslušnému měsíci.
Podrobnosti o využití dotazů: Při dotazování rozhraní API s podrobnostmi o využití podle rozsahu kalendářních dat se dotaz vztahuje pouze na datum sestavy využití, a ne na dobu spotřeby v poli additionalVlastnosti . Pro zákazníky, kteří chtějí mapovat podrobnosti o využití na faktury, tato aktualizace nemá vliv na proces, protože faktura zpracuje využití na základě data sestavy využití. Pro zákazníky, kteří chtějí mapovat podrobnosti o využití na konkrétní kalendářní datum/měsíc, je tato aktualizace zásadní změnou a pro tyto scénáře nelze použít datum sestavy využití a datum, kdy k využití došlo, je nutné použít v části additionalVlastnosti .

Ukázkové volání pro další podrobnosti:

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

Ukázkový fragment kódu 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 některé ze sad SDK pro konkrétní jazyk najdete v následujících článcích.

Azure Consumption Python SDK

Rozhraní příkazového řádku služby Azure Consumption

Azure Consumption NodeJS SDK

Azure Consumption Ruby SDK

Sdílet prostřednictvím