Fenntartott példányok használatának lekérdezése vállalati ügyfeleknek

Cikk
02/28/2024

Megjegyzés

2024. május 1-jén kivezetjük az Azure Enterprise Reporting API-kat. A fennmaradó Vállalati jelentéskészítési API-k nem válaszolnak a kérésekre. Az ügyfeleknek előbb át kell váltaniuk a Microsoft Cost Management API-k használatára. További tudnivalókért lásd: Migrálás az Azure Nagyvállalati jelentéskészítőből a Microsoft Cost Management API-kra – áttekintés.

A Reserved Instance Usage API a fenntartott példányok vásárlásának használati adatait adja vissza egy adott regisztráción belül. Ha a regisztrációban több fenntartott példány is van, ezzel az API-val az összes fenntartottpéldány-vásárlással kapcsolatos használatot lekérheti.

Fenntartott példány használati adatainak lekérése

A szükséges gyakori fejléctulajdonságokról a Nagyvállalati ügyfelek számára készült Jelentéskészítési API-k áttekintése című cikkben olvashat.

Metódus	Kérés URI-ja
GET	`https://consumption.azure.com/v2/enrollments/{enrollmentNumber}/reservationdetails?startDate={yyyy-mm-dd}&endDate={yyyy-mm-dd}`

Használati adatokra adott válasz

[{
    "reservationOrderId": "00000000-0000-0000-0000-000000000000",
    "reservationId": "00000000-0000-0000-0000-000000000000",
    "usageDate": "2018-02-01T00:00:00",
    "skuName": "Standard_F2s",
    "instanceId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/resourvegroup1/providers/microsoft.compute/virtualmachines/VM1",
    "totalReservedQuantity": 18.000000000000000,
    "reservedHours": 432.000000000000000,
    "usedHours": 400.000000000000000
}

Választulajdonság-definíciók

Tulajdonság neve	Típus	Description
reservationOrderId	sztring	A foglalási rendelés azonosítója a foglalás vásárlásának azonosítója. Minden foglalási rendelés azonosítója egyetlen vásárlási tranzakciót jelöl. A foglalási rendelés foglalásokat tartalmaz. A foglalási sorrend határozza meg a foglalások virtuális gépének méretét és régióját.
reservationId	sztring	A foglalásazonosító egy foglalás azonosítója egy foglalási rendelésen belül. Minden foglalás a juttatási hatókör alkalmazásának csoportosítása, és meghatározza azoknak a példányoknak a számát is, amelyekre a foglalási előny alkalmazható.
usageDate	sztring	A fogyasztás bekövetkezésének dátuma.
skuName	sztring	Ez az Azure Resource Manager termékváltozat neve. Használható a servicetype mezőhöz való csatlakozáshoz a használati rekordok továbbiInfo elemében.
instanceId	sztring	Ez az azonosító az erőforrás neve vagy a teljes erőforrás-azonosító.
totalReservedQuantity	sztring	Ez a foglalásazonosítóhoz lefoglalt példányok teljes száma.
reservedHours	tizedes tört	Ez az adott napra lefoglalt teljes óraszám. Ha például az 1 példány foglalása 13:00-kor történt, a fenntartott órák az első nap 11 órára, a következő napokra pedig 24 órára lesznek fenntartva.
usedHours	tizedes tört	Ez a példány által használt teljes óraszám.

Fenntartott példányok használati adatainak összegzése iránti kérelem

A szükséges gyakori fejléctulajdonságokról a Nagyvállalati ügyfelek számára készült Jelentéskészítési API-k áttekintése című cikkben olvashat. Az API támogatja a foglalások napi és havi kihasználtságát. A havi adatokhoz nincs szükség startdate és EndDate paraméterekre.

Metódus	Kérés URI-ja
GET	`https://consumption.azure.com/v2/enrollments/{enrollmentNumber}/reservationsummaries?grain=daily&startdate={yyyy-mm-dd}&enddate={yyyy-mm-dd}`

Használati összefoglaló válasz

[
     {
        "reservationOrderId": "00000000-0000-0000-0000-000000000000",
        "reservationId": "00000000-0000-0000-0000-000000000000",
        "skuName": "Standard_F1s",
        "reservedHours": 24,
        "usageDate": "2018-05-01T00:00:00",
        "usedHours": 23,
        "minUtilizationPercentage": 0,
        "avgUtilizationPercentage": 95.83,
        "maxUtilizationPercentage": 100
    }
]