Azure tüketimi

Azure Tüketim API'leri, Azure kaynaklarınızla ilgili maliyet ve kullanım verilerinize program aracılığıyla erişmenizi sağlar. bu apı 'ler şu anda yalnızca Enterprise kayıtları ve Web doğrudan aboneliklerini destekler (birkaç özel durum ile). 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 Doğrudan Web 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 (DreamSpark)

REST İşlem Grupları

İşlem Grubu Açıklama
Budgets Bir abonelikte veya kaynak grubu kapsamında bütçeleri ayarlama, güncelleştirme ve silmeye yönelik işlemler sağlar. Maliyet ve kullanım bütçelerini destekler.
Fiyat listesi Enterprise abonelikleri ve faturalandırma hesapları için fiyat listesi almak üzere işlemler sağlar.
Market Ücretleri abonelik veya Enterprise faturalandırma hesaplarında market kaynakları için kullanım bilgilerini almaya yönelik işlemler sağlar.
Kullanım Ayrıntıları abonelik veya Enterprise faturalandırma hesaplarında kullanım bilgilerini almak için işlemler sağlar.
Rezervasyon Ayrıntıları , kullandıkça öde ve abonelikler Enterprise için rezervasyonun ayrıntılı kullanımını almak için işlemler sağlar.
Rezervasyon Ayrıntıları raporu , kullandıkça öde için ayrıntılı kullanım kullanımı ve büyük veri boyutları için en iyi duruma getirilmiş bir rapor formatında abonelikler Enterprise almak için işlem sağlar.
Rezervasyon Özetleri , kullandıkça öde ve abonelikler Enterprise için rezervasyon özeti kullanımını almak için işlem sağlar.
Rezervasyon Önerileri kullandıkça öde ve abonelikler Enterprise rezervasyon önerilerini almak için işlemler sağlar.
Tahminler Enterprise abonelikler için kullanım tahminleri almaya yönelik işlemler sağlar.
Bakiyeler Enterprise faturalandırma hesaplarına ait bakiyeleri ve özetleri almak için işlemler sağlar.
Lerimi Enterprise abonelikler için etiket bilgileri almak üzere işlemler sağlar.

Faturalandırma dönemleriyle ve tarih aralıklarıyla çalışma

Kullanım ayrıntıları ve Market ücretleri , kullanım verilerinin başlangıç ve bitiş tarihlerini tanımlamaya yönelik fatura dönemini veya tarih aralıklarını kabul eder.

İşte, ödeme dönemleri ve istekteki tarih aralıklarına dayalı API davranışı.

Ödeme dönemi istekte var İstekteki başlangıç tarihi İstekteki bitiş tarihi API davranışı
hayır hayır hayır Geçerli fatura döneminin verileri yanıt olarak döndürüldü
hayır evet hayır Geçerli fatura döneminin verileri yanıt olarak döndürüldü
hayır hayır evet Geçerli fatura döneminin verileri yanıt olarak döndürüldü
hayır evet evet Belirtilen başlangıç ve bitiş tarihi için veriler yanıt olarak döndürüldü
evet hayır hayır Belirtilen fatura döneminin verileri yanıt olarak döndürüldü
evet evet hayır Belirtilen fatura döneminin verileri yanıt olarak döndürüldü
evet hayır evet Belirtilen fatura döneminin verileri yanıt olarak döndürüldü
evet evet evet Belirtilen başlangıç ve bitiş tarihi için veriler yanıt olarak döndürüldü, sağlanan fatura dönemi yoksayıldı

İzin verilen en fazla tarih aralığı tek bir istekte 12 ay ve veriler 1 Mayıs 2014 veya sonraki bir sürümde kullanılabilir.

Fatura dönemlerinin listesini alma

İstekte geçerli bir fatura dönemi sağlamak için, istemci ilk olarak, aşağıdaki API 'yi kullanarak, abonelik ile kullanılabilir faturalandırma dönemleriyle ilgili bir liste almalıdır

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

Bu listeyi kullanarak, istemci, tüketim verileri almak için belirli bir fatura dönemi seçebilir.

Geç ulaşan veriler

Raporlama kullanımında gecikme süresi olan üçüncü taraf hizmetlerine uyum sağlamak için, bildirilen kullanım tarihi, gerçek kullanımın gönderildiği zamana, tüketim süresine göre değil, kullanım verilerinin gönderildiği zamana ayarlanır.

Sonuç olarak, kullanım için derecelendirilir ve raporlanan zamana uygulanır. Gerçek tüketim süresini göstermek için özellikleri. AdditionalProperties alanı artık iki ek özellik içerir. ConsumptionBeginTime ve ConsumptionEndTime, gerçek tüketim zamanı penceresine karşılık gelen yeni alanlardır.

Bu değişiklikler, kullanım ayrıntıları API'si çağrılırken ele alınması gereken birkaç senaryoya neden olur:

  1. Month End Reporting: Bir ay boyunca meydana gelen ancak sonraki ay içinde bildirilen kullanım için, müşterilerin kullanımı uygun aya atamak için additionalProperties alanına bakmaları gerekir.

  2. Sorgu Kullanımı ayrıntıları: Kullanım ayrıntıları API'sini bir tarih aralığına göre sorgularken, sorgu additionalProperties alanında tüketim zamanı için değil yalnızca kullanım raporu tarihi için geçerlidir. Kullanım ayrıntılarını faturalara eşlemek arayan müşteriler için bu güncelleştirme işlemi etkilemez çünkü fatura kullanım raporu tarihine göre kullanımı işlemektedir. Kullanım ayrıntılarını belirli bir takvim tarihi/ayı ile eşlemek arayan müşteriler için bu güncelleştirme son dakika değişikliğidir ve bu senaryolar için kullanım raporu tarihi kullanılamaz ve kullanım tarihi ekÖzerties bölümünde kullanılmalıdır.

Ek Ayrıntılar için Örnek Çağrı:

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

Örnek Yanıt kod parçacığı:

    "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 bkz.

Dile özgü BIR API'de bu API'yi kullanma hakkında daha fazla bilgi için aşağıdakini ziyaret edin

Azure Tüketim Python SDK'sı

Azure Tüketim CLI'si

Azure Tüketim .NET SDK'sı

Azure Tüketim NodeJS SDK'sı

Azure Tüketim Ruby SDK'sı