Kurumsal müşteriler için ayrılmış sanal makine örneği kullanımını alma

Makale
03/05/2024

Not

1 Mayıs 2024'te Azure Enterprise Reporting API'leri kullanımdan kaldırılacaktır. Kalan Tüm Enterprise Reporting API'leri isteklere yanıt vermeyi durdurur. Müşterilerin bu tarihten önce Microsoft Maliyet Yönetimi API'lerini kullanmaya geçmeleri gerekir. Daha fazla bilgi edinmek için bkz. Azure Kurumsal Raporlama'dan Microsoft Maliyet Yönetimi API'lerine geçişe genel bakış.

Ayrılmış Örnek Kullanımı API’si, bir kayıt içindeki Ayrılmış Örnek satın alımlarının kullanım bilgilerini döndürür. Kayıtta birden fazla Ayrılmış Sanal Makine Örneği varsa bu API’yi kullanarak tüm ayrılmış sanal makine örneği satın alma işlemlerinin kullanımını da alabilirsiniz.

Ayrılmış sanal makine örneği kullanım ayrıntıları isteği

Gerekli ortak üst bilgi özellikleri hakkında bilgi edinmek için Kurumsal müşteriler için Raporlama API'lerine Genel Bakış makalesine bakın.

Yöntem	İstek URI'si
GET	`https://consumption.azure.com/v2/enrollments/{enrollmentNumber}/reservationdetails?startDate={yyyy-mm-dd}&endDate={yyyy-mm-dd}`

Kullanım ayrıntıları yanıtı

[{
    "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
}

Yanıt özelliği tanımları

Özellik Adı	Tür	Description
reservationOrderId	string	Rezervasyon sipariş kimliği, rezervasyon satın alma işleminin tanımlayıcısıdır. Her rezervasyon sipariş kimliği tek bir satın alma işlemini temsil eder. Rezervasyon siparişi rezervasyonlar içerir. Rezervasyon sırası, rezervasyonlar için VM boyutunu ve bölgesini belirtir.
reservationId	string	Rezervasyon kimliği, rezervasyon siparişi içindeki rezervasyonun tanımlayıcısıdır. Her rezervasyon, avantaj kapsamını uygulamaya yönelik gruplandırmadır ve ayrıca rezervasyon avantajının uygulanabileceği örnek sayısını belirtir.
usageDate	string	Tüketimin gerçekleştiği tarih.
skuName	string	Bu, Azure Resource Manager Sku adıdır. Kullanım kayıtlarında additionalInfo'daki servicetype alanıyla birleştirmek için kullanılabilir.
instanceId	string	Bu tanımlayıcı, kaynağın adı veya tam Kaynak Kimliği'dir.
totalReservedQuantity	string	Bu, rezervasyon kimliği için ayrılmış örneklerin toplam sayısıdır.
reservedHours	decimal	Bu, gün için ayrılmış toplam saat sayısıdır. Örneğin, 1 örnek için rezervasyon 13:00'te yapıldıysa, ayrılmış saatler ilk gün için 11 saat ve sonraki günler için 24 saat olacaktır.
usedHours	decimal	Bu, örnek tarafından kullanılan toplam saat sayısıdır.

Ayrılmış Örnek kullanım özeti isteği

Gerekli ortak üst bilgi özellikleri hakkında bilgi edinmek için Kurumsal müşteriler için Raporlama API'lerine Genel Bakış makalesine bakın. API, günlük ve aylık dilim için rezervasyon kullanımını destekler. Aylık veriler için Startdate ve EndDate parametreleri gerekli değildir.

Yöntem	İstek URI'si
GET	`https://consumption.azure.com/v2/enrollments/{enrollmentNumber}/reservationsummaries?grain=daily&startdate={yyyy-mm-dd}&enddate={yyyy-mm-dd}`

Kullanım özeti yanıtı

[
     {
        "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
    }
]