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.

Íme az API viselkedése a számlázási időszakok és a kérés időpontjai alapján:

Számlázási időszak kért	Kezdeti dátum kérésben	A kérés lezárási dátuma	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 biztosítson egy kérésben, az ügyfélnek először a következő API segítségével kell megszereznie az előfizetéses elérhető számlázási időszakok listáját

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

A lista segítségével az ügyfél kiválaszthat egy adott számlázási időszakot, hogy megkapja a fogyasztási adatokat.

Későn érkező adatok

A harmadik féltől származó szolgáltatások számára, amelyek késleltetéssel számolnak a használat jelentésében, a jelentett használati dátumot arra az időpontra állítják be, amikor az adat elküldődött, nem pedig a tényleges használat időpontja, vagyis a fogyasztási idő.

Ennek eredményeként a használatot a jelentett időre értékelik és alkalmazzák. A tényleges fogyasztási idő ábrázolásához a tulajdonságok. Az AdditionalProperties mező most két másik tulajdonságot is tartalmazni fog. A ConsumptionBeginTime és a ConsumptionEndTime azok az új mezők, amelyek megfelelnek a tényleges felhasználási időablaknak.

Ezek a változások néhány olyan helyzetet eredményeznek, amelyeket kezelni kell a használati adatok API hívásakor:

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

2. Lekérdezési használat részletei: Ha a használati adatok API-ját egy dátumtartomány szerint kérdezzük, a lekérdezés csak a használati jelentés dátumára vonatkozik, nem az additionalProperties mező fogyasztási idejére. Azoknak az ügyfeleknek, akik a használati adatokat számlákhoz akarják rendelni, ez a frissítés nem érinti a folyamatot, mivel a számla a használati jelentés dátuma alapján dolgozza fel a használatot. Azoknak az ügyfeleknek, akik a használati adatokat egy adott naptári dátum/hónaphoz akarják rendelni, ez a frissítés egy törőképes változás, és ezekben a helyzetekben a használati jelentés dátuma nem használható, illetve az addalProperties szekcióban a használat bekövetkezett dátumát kell használni.

Példahí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