Azure Tüketim

Azure Tüketim API'leri, Azure kaynaklarınızla ilgili maliyet ve kullanım verilerinize program aracılığıyla erişmenizi sağlar. API'ler şu anda yalnızca Kurumsal Kayıtlar, Web Direct abonelikleri (birkaç özel durum dışında) ve CSP Azure planı aboneliklerini desteklemektedir. API'ler diğer Azure abonelik türlerini desteklemek için sürekli güncelleştirilir.

Azure Tüketim API'leri şu verilere erişim sunar:

• Yalnızca Kurumsal Müşteriler
  • Fiyat listesi
  • Bütçeler
  • Tahminler
  • Bakiyeler
  • Etiketler
  • Maliyet Etiketleri
• Kurumsal ve Web Direct Müşterileri
  • Rezervasyon Ayrıntıları
  • Rezervasyon Özetleri
  • Market Ücretleri
  • Kullanım Ayrıntıları
  • Rezervasyon Önerileri

Desteklenmeyen Abonelik Türlerinin Listesi

• MS-AZR-0145P (CSP)
• MS-AZR-0146P (CSP)
• MS-AZR-159P (CSP)
• MS-AZR-0036P (sponsorlu)
• MS-AZR-0143P (sponsorlu)
• MS-AZR-0015P (iç)
• MS-AZR-0144P (Rüya Kıvılcımı)

Fatura dönemleri ve tarih aralıkları ile çalışma

Kullanım Ayrıntıları ve Market Ücretleri , kullanım verilerinin başlangıç ve bitiş tarihlerini tanımlamak için faturalama dönemini veya tarih aralıklarını kabul eder.

İşte talep tarihleri ve faturalama dönemlerine dayalı API davranışı:

Talep edilen faturalama dönemi	Başlangıç tarihi talep ediliyor	Talebin bitiş tarihi	API davranışı
Hayır	Hayır	Hayır	Geçerli faturalama dönemine ait veriler yanıt olarak döndürülür
Hayır	evet	Hayır	Geçerli faturalama dönemine ait veriler yanıt olarak döndürülür
Hayır	Hayır	evet	Geçerli faturalama dönemine ait veriler yanıt olarak döndürülür
Hayır	evet	evet	Belirtilen Başlangıç ve Bitiş Tarihi için veriler yanıt olarak döndürülür
evet	Hayır	Hayır	Belirtilen fatura dönemine ait veriler yanıt olarak döndürülür
evet	evet	Hayır	Belirtilen fatura dönemine ait veriler yanıt olarak döndürülür
evet	Hayır	evet	Belirtilen fatura dönemine ait veriler yanıt olarak döndürülür
evet	evet	evet	Belirtilen Başlangıç ve Bitiş Tarihi için veriler yanıt olarak döndürülür, sağlanan fatura dönemi yok sayılır

Bir istekte izin verilen maksimum tarih aralığı 12 aydır ve veriler 1 Mayıs 2014 veya sonrasında kullanılabilir.

Fatura dönemlerinin listesini alma

Bir istekte geçerli bir faturalama dönemi sağlamak için, istemci önce aşağıdaki API kullanarak abonelikle mevcut faturalama dönemlerinin listesini almalıdır

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

Listeyi kullanarak, müşteri belirli bir faturalama dönemi seçerek tüketim verisini elde edebilir.

Geç Gelen Veri

Kullanım raporlamasında gecikme yaşayan üçüncü taraf hizmetleri karşılamak için, bildirilen kullanım tarihi, gerçek kullanımın gerçekleştiği zaman değil, kullanım verisinin gönderildiği zamana ayarlanır.

Sonuç olarak, kullanım raporlanan zamana göre değerlendirilir ve uygulanır. Gerçek tüketim süresini temsil etmek için, özellikler. AdditionalProperties alanı artık iki başka özellik daha içerecek. ConsumptionBeginTime ve ConsumptionEndTime , gerçek tüketim zaman penceresine karşılık gelen yeni alanlardır.

Bu değişiklikler, kullanım detayları API'si çağrılırken ele alınması gereken birkaç senaryoya yol açar:

1. Ay Sonu Raporlama: Bir ay içinde gerçekleşen ancak sonraki ay raporlanan kullanım için, müşterilerin uygun aya kullanımını atamak için additionalProperties alanına bakmaları gerekir.

2. Sorgu Kullanım Detayları: Kullanım detayları API'sini bir tarih aralığına göre sorguladığınızda, sorgu yalnızca kullanım raporu tarihine uygulanır, additionalProperties alanındaki tüketim süresine uygulanmaz. Kullanım detaylarını faturalara eşlemek isteyen müşteriler için, bu güncelleme süreci etkilemez çünkü fatura kullanım raporu tarihine göre kullanımı işliyor. Kullanım detaylarını belirli bir takvim tarihi/ayına eşlemek isteyen müşteriler için, bu güncelleme bir kırılma değişikliğidir ve bu senaryolarda kullanım raporu tarihi kullanılamaz ve kullanımın gerçekleştiği tarih, ekÖzellikler bölümünde kullanılmalıdır.

Daha fazla detay için örnek görüşme:

GET https://management.azure.com/subscriptions/{subscriptionId}/providers/Microsoft.Consumption/usageDetails?api-version=2018-03-31&$expand=properties/additionalProperties

Örnek Yanıt snippet'i:

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

Ayrıca bakınız

Bu API'yi dile özgü SDK'lardan birinde kullanma hakkında daha fazla bilgi için aşağıdakileri ziyaret edin

Azure Consumption Python SDK

Azure Tüketim CLI

Azure Tüketim NodeJS SDK'sı

Azure Tüketim Ruby SDK'sı