Využití Azure

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. Tato rozhraní API aktuálně podporují pouze Enterprise registrace a předplatná Web Direct (s několika výjimkami). 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)

Skupiny operací REST

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 kalendářních 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 žádosti.

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

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

Pokud chcete v žádosti poskytnout platné fakturační období, měl by klient 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í a získat data o spotřebě.

Data o pozdním příchozím datu

Aby bylo možné pojmout služby třetích stran, u kterých dochází ke zpoždění při vytváření sestav, je hlášené datum využití nastaveno na čas odeslání dat o využití, a ne na dobu skutečného využití.

V důsledku toho se využití vymeše a použije na hlášený čas. Vlastnosti představují skutečnou dobu spotřeby. Pole AdditionalProperties teď bude obsahovat dvě další vlastnosti. ConsumptionBeginTime a ConsumptionEndTime jsou nová pole, která odpovídají skutečnému časovému období spotřeby.

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

1. Generování sestav na konci měsíce: pro použití, ke kterému došlo během měsíce, ale v průběhu příštího měsíce nahlásili zákazníci, se musí podívat na pole additionalProperties a přiřadit ho k příslušnému měsíci.

2. Podrobnosti použití dotazů: při dotazování rozhraní API podrobností o využití podle rozsahu kalendářních dat se dotaz vztahuje pouze na datum sestavy využití a ne na čas spotřeby v poli additionalProperties . Aby zákazníci, kteří chtějí mapovat podrobnosti o využití na faktury, tato aktualizace neovlivnila tento 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í k určitému kalendářnímu datu/měsíci, je tato aktualizace zásadní změnou a v těchto scénářích se musí použít datum sestavy využití a datum, kdy se použití objevilo v části additionalProperties .

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ázka fragmentu odpovědí:

    "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é z sad SDK pro konkrétní jazyk najdete na následujících stránkách:

Azure Consumption Python SDK

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

Azure Consumption .NET SDK

Azure Consumption NodeJS SDK

Azure Consumption Ruby SDK