Azure-használat
Az Azure használati API-k programozott hozzáférést biztosítanak az Azure-erőforrások költség- és használati adataihoz. Az API-k jelenleg csak a vállalati regisztrációkat, a Web Direct-előfizetéseket (néhány kivétellel) és a CSP Azure-csomag-előfizetéseket támogatják. Az API-k folyamatosan frissülnek, hogy más típusú Azure-előfizetéseket is támogassanak.
Az Azure használati API-k a következőkhöz biztosítanak hozzáférést:
- Csak vállalati ügyfelek számára
- Árlista
- Költségvetések
- Előrejelzések
- Egyenlegek
- Címkék
- Költségcímkék
- Vállalati és Web Direct-ügyfelek
- Foglalási adatok
- Foglalási összegzések
- A Marketplace díjai
- Használati adatok
- Foglalási javaslatok
A nem támogatott előfizetési típusok listája
- MS-AZR-0145P (CSP)
- MS-AZR-0146P (CSP)
- MS-AZR-159P (CSP)
- MS-AZR-0036P (szponzorált)
- MS-AZR-0143P (szponzorált)
- MS-AZR-0015P (belső)
- MS-AZR-0144P (DreamSpark)
Számlázási időszakok és dátumtartományok használata
A Használati adatok és a Marketplace díjtételei elfogadják a számlázási időszakot vagy a dátumtartományokat a használati adatok kezdő és záró dátumának meghatározásához.
Itt található az API viselkedése a kérelemben szereplő számlázási időszakok és dátumtartományok alapján.
| A kérelemben szereplő számlázási időszak | A kérelemben szereplő kezdési dátum | A kérelemben szereplő befejezési dátum | API-viselkedés |
|---|---|---|---|
| nem | nem | nem | Az aktuális számlázási időszakra vonatkozó adatok válaszként lesznek visszaadva |
| nem | igen | nem | Az aktuális számlázási időszakra vonatkozó adatok válaszként lesznek visszaadva |
| nem | nem | igen | Az aktuális számlázási időszakra vonatkozó adatok válaszként lesznek visszaadva |
| nem | igen | igen | A rendszer válaszként visszaadja a megadott kezdő és záró dátum adatait |
| igen | nem | nem | A megadott számlázási időszakra vonatkozó adatokat a rendszer válaszként adja vissza |
| igen | igen | nem | A megadott számlázási időszakra vonatkozó adatokat a rendszer válaszként adja vissza |
| igen | nem | igen | A megadott számlázási időszakra vonatkozó adatokat a rendszer válaszként adja vissza |
| igen | igen | igen | A rendszer válaszként visszaadja a megadott kezdő és záró dátum adatait, a megadott számlázási időszak figyelmen kívül lesz hagyva |
A maximálisan engedélyezett dátumtartomány egy kérelemben 12 hónap, az adatok pedig 2014. május 1-től vagy később érhetők el.
Számlázási időszakok listájának lekérése
Ha érvényes számlázási időszakot szeretne megadni a kérésben, az ügyfélnek először le kell kérnie az elérhető számlázási időszakok listáját előfizetés szerint, az alábbi API használatával
GET https://management.azure.com/subscriptions/{subscriptionId}/providers/Microsoft.Billing/billingPeriods?api-version=2017-04-24-preview
A lista használatával az ügyfél kiválaszthat egy adott számlázási időszakot a használati adatok lekéréséhez.
Későn érkező adatok
A használat jelentésében késéssel rendelkező, harmadik féltől származó szolgáltatások esetében a jelentett használati dátum a használati adatok elküldésének időpontjára van beállítva, szemben a tényleges használat időpontjával, azaz a használati idővel.
Ennek eredményeképpen a rendszer a használatot a jelentett időpontra minősíti és alkalmazza. A tényleges használati idő ábrázolásához a tulajdonságok. Az AdditionalProperties mező mostantól két további tulajdonságot is tartalmaz. A ConsumptionBeginTime és a ConsumptionEndTime az új mezők, amelyek a tényleges használati időkeretnek felelnek meg.
Ezek a módosítások néhány forgatókönyvet eredményeznek, amelyeket meg kell oldani a használati adatok API meghívásakor:
Hónap végi jelentéskészítés: Az egy hónap alatt történt, de a következő hónapban jelentett használat esetén az ügyfeleknek meg kell néznie az additionalProperties mezőt a használat megfelelő hónaphoz való hozzárendeléséhez.
Használati adatok lekérdezése: Amikor a használati adatok API-t dátumtartomány szerint kérdezi le, a lekérdezés csak a használati jelentés dátumára vonatkozik, az additionalProperties mező használati idejére nem. Azoknak az ügyfeleknek, akik a használati adatokat számlákra szeretnék leképezni, ez a frissítés nincs hatással a folyamatra, mivel a számla a használati jelentés dátuma alapján dolgozza fel a használatot. Az ügyfelek számára, ha a használati adatokat egy adott naptári dátumra/hónapra szeretné leképezni, ez a frissítés kompatibilitástörő változás, és ezekben az esetekben a használati jelentés dátuma nem használható, és a használat bekövetkezésének dátuma, a továbbiTulajdonságok szakaszban kell használni.
Mintafelhívás további részletekért:
GET https://management.azure.com/subscriptions/{subscriptionId}/providers/Microsoft.Consumption/usageDetails?api-version=2018-03-31&$expand=properties/additionalProperties
Mintaválasz-kódrészlet:
"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"
}
}
Lásd még
Az API nyelvspecifikus SDK-kban való használatával kapcsolatos további információkért látogasson el a következő oldalra: