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 nagyvá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 nagyvállalati ügyfelek számára
  • Árlista
  • Költségvetések
  • Előrejelzések
  • Balances
  • Címkék
  • Költségcédulák
• Nagyvállalati és Web Direct ügyfelek
  • Foglalási adatok
  • Foglalási összegzések
  • A Marketplace díjai
  • Használati adatok
  • Foglalási ajánlások

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íjak a számlázási időszakot vagy a dátumtartományokat fogadják el a használati adatok kezdő és záró dátumának meghatározásához.

Az API viselkedése a számlázási időszakok és a kérelemben szereplő dátumtartományok alapján látható.

Számlázási időszak a kérésben	Kérés kezdő dátuma	A kérelemben szereplő befejezési dátum	API-viselkedés
Nem	Nem	Nem	Az aktuális számlázási időszak adatait válaszul adja vissza
Nem	igen	Nem	Az aktuális számlázási időszak adatait válaszul adja vissza
Nem	Nem	igen	Az aktuális számlázási időszak adatait válaszul adja vissza
Nem	igen	igen	A megadott kezdő és záró dátum adatait a rendszer válaszként adja vissza
igen	Nem	Nem	A megadott számlázási időszak adatait válaszul adja vissza
igen	igen	Nem	A megadott számlázási időszak adatait válaszul adja vissza
igen	Nem	igen	A megadott számlázási időszak adatait válaszul adja vissza
igen	igen	igen	A megadott kezdő és záró dátum adatait válaszul adja vissza, a megadott számlázási időszakot figyelmen kívül hagyja

A maximálisan engedélyezett dátumtartomány 12 hónap egy kérelemben, és az adatok 2014. május 1-jétől vagy később érhetők el.

Számlázási időszakok listájának lekérése

Ahhoz, hogy érvényes számlázási időszakot adjon meg a kérelemben, az ügyfélnek először le kell kérnie az előfizetésenként elérhető számlázási időszakok listáját a következő API használatával

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

Ezzel a listával az ügyfél kiválaszthat egy adott számlázási időszakot a fogyasztási adatok lekéréséhez.

Későn érkező adatok

A használat jelentésében késleltetett harmadik féltől származó szolgáltatások befogadása érdekében a jelentett használati dátum a használati adatok elküldésének időpontjára van beállítva, nem pedig a tényleges használat időpontjára, azaz a használati időre.

Ennek eredményeképpen a rendszer a bejelentett időre értékeli és alkalmazza a használatot. A tényleges fogyasztási idő ábrázolása érdekében a tulajdonságok. Az AdditionalProperties mező mostantól két további tulajdonságot fog tartalmazni. A ConsumptionBeginTime és a ConsumptionEndTime azok az új mezők, amelyek megfelelnek a tényleges felhasználási időablaknak.

Ezek a módosítások néhány forgatókönyvet eredményeznek, amelyeket a használati részletek API hívásakor kell kezelni:

1. Hónap végi jelentés: Az egy hónapban bekövetkezett, de a következő hónapban jelentett használat esetén az ügyfeleknek meg kell nézniük az additionalProperties mezőt, hogy hozzárendeljék a használatot a megfelelő hónaphoz.

2. Lekérdezés használati adatai: Ha a használati adatok API-t dátumtartomány alapján kérdezi le, a lekérdezés csak a használati jelentés dátumára vonatkozik, a további tulajdonságok mezőben lévő felhasználási időre nem. Azon ügyfelek számára, akik a használati adatokat a számlákhoz szeretnék hozzárendelni, ez a frissítés nem befolyásolja a folyamatot, mivel a számla a használati jelentés dátuma alapján dolgozza fel a használatot. Azon ügyfelek számára, akik egy adott naptári dátumra/hónapra szeretnék leképezni a használati adatokat, ez a frissítés kompatibilitástörő változás, és ezeknél a forgatókönyveknél a használati jelentés dátuma nem használható, és a használat dátumát kell használni az additionalProperties szakaszban.

Mintahí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

Minta válaszkó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 az alábbi oldalakra

Azure Consumption Python SDK

Azure-használat parancssori felülete

Azure Consumption NodeJS SDK

Azure Consumption Ruby SDK