Azure Consumption
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.