Tüketim Kullanımı Ayrıntıları API'sinden geçiş

Bu makalede kullanımdan kaldırılması planlanan Tüketim Kullanımı Ayrıntıları API'sinden uzağa geçiş açıklanır. Tam kullanımdan kaldırma tarihi hala belirleniyor. Bu API'yi kullanarak raporlama işlem hatlarınızı oluşturmamanızı ve mümkün olan en kısa sürede buradan geçiş yapmanızı öneririz.

Kimlik doğrulaması için API anahtarı kullanan ve consumption.azure.com URI uç noktası üzerinden erişilen Kurumsal Anlaşma (EA) raporlama API'leri kullanımdan kaldırılır. Bu API'leri kullanan EA müşterileri Maliyet Yönetimi Maliyet Ayrıntıları API'sine geçmelidir. Bu eski EA raporlama API'leri yalnızca Kurumsal Anlaşma olan müşteriler tarafından kullanılabilir.

Tüketim Kullanımı Ayrıntıları API'sini kullanmanız önerilir, ancak Maliyet Yönetimi Maliyet Ayrıntıları API'sine geçiş yapmanızı gerektirmez.

Tüketim ve Maliyet Yönetimi API'leri hem EA Microsoft Müşteri Sözleşmesi (MCA) müşterileri için kullanılabilir. Bu nedenle, EA kapsamında kalan Azure Kamu müşteriler olumsuz etkilenmez.

EA'dan MCA'ya geçiş yaptığınızda EA raporlama Kullanım Ayrıntıları API'sinden Maliyet Yönetimi Maliyet Ayrıntıları API'sine geçmenizi ve Dışarı Aktarmalar'ı kullanmanızı öneririz.

Geçiş hedefleri

İş yükünüz için uygun çözümü seçmeden önce Maliyet ayrıntıları çözümü seçme makalesini okuyun. Genel olarak, devam eden veri alımı gereksinimleriniz ve büyük bir aylık kullanım ayrıntıları veri kümeniz varsa Dışarı Aktarmalar'ı öneririz. Daha fazla bilgi için bkz . Kullanım ayrıntıları verilerini alma.

Daha küçük bir kullanım ayrıntıları veri kümeniz veya Dışarı Aktarmalar tarafından karşılanmayan bir senaryonuz varsa bunun yerine Maliyet Ayrıntıları raporunu kullanmayı göz önünde bulundurun. Daha fazla bilgi için bkz . İsteğe bağlı olarak küçük maliyetli veri kümeleri alma.

Geçiş avantajları

Yeni çözümler, Tüketim Kullanımı Ayrıntıları API'sine göre birçok avantaj sağlar. Özet aşağıdadır:

• Tüm kullanım ayrıntıları için tek veri kümesi - Azure ve Azure Market kullanım ayrıntıları tek bir veri kümesinde birleştirildi. Tüm ücretlerinizi görmek için aramanız gereken API sayısını azaltır.
• Ölçeklenebilirlik - Marketler API'si, Azure kullanımınız arttıkça ölçeklendirilemeyecek bir çağrı desenini yükselttiklerinden kullanım dışıdır. Buluta daha fazla kaynak dağıttıkça kullanım ayrıntıları veri kümesi genişleyebilir. Marketler API'si sayfalandırılmış bir zaman uyumlu API olduğundan, yüksek verimlilik ve güvenilirlikle büyük hacimli verileri ağ üzerinden etkili bir şekilde aktarmak için iyileştirilmemiştir. Dışarı aktarmalar ve Maliyet Ayrıntıları API'si zaman uyumsuz. Ağ üzerinden doğrudan indirilebilen bir CSV dosyası sağlar.
• API geliştirmeleri - Dışarı aktarmalar ve Maliyet Ayrıntıları API'Azure desteği devam eden çözümlerdir. Tüm yeni özellikler bunlarla tümleştiriliyor.
• Şema tutarlılığı - Maliyet Ayrıntıları raporu ve Dışarı Aktarmalar , senaryonuza göre bir çözümden diğerine taşıyabileceğiniz eşleşen alanlara sahip dosyalar sağlar.
• Maliyet Ayırma tümleştirmesi - dışarı aktarmaları veya Maliyet Ayrıntıları API'sini kullanan müşteriler Kurumsal Anlaşma ve Microsoft Müşteri Sözleşmesi, yapılandırdıkları maliyet ayırma kurallarına göre ücretleri görüntüleyebilir. Maliyet ayırma hakkında daha fazla bilgi için bkz . Maliyetleri ayırma.

Alan Farkları

Aşağıdaki tabloda, Tüketim Kullanımı Ayrıntıları API'si ile Dışarı Aktarmalar/Maliyet Ayrıntıları API'si arasındaki alan farkları özetlemektedir. Dışarı aktarmalar ve Maliyet Ayrıntıları API'si, Tüketim API'sinin sağladığı sayfalandırılmış JSON yanıtı yerine bir CSV dosyası indirmesi sağlar.

alan eşlemesini Kurumsal Anlaşma

Tüketim Kullanımı Ayrıntıları API'sini kullanan müşteriler Kurumsal Anlaşma türündeki legacykullanım ayrıntıları kayıtlarına sahiptir. Tüm Kurumsal Anlaşma müşterileri, kendileri için kullanılan temel faturalama sisteminden dolayı bu tür kayıtlara sahiptir. Aşağıda örnek bir eski kullanım ayrıntıları kaydı verilmiştir:

{  

  "value": [  

      {  

          "id": "{id}", 

          "name": "{name}",  

          "type": "Microsoft.Consumption/usageDetails",  

          "kind": "legacy",  

          "tags": {  

               "env": "newcrp",  

               "dev": "tools"  

          },  

          "properties": {  

…... 

      } 

} 

Kullanım Ayrıntıları - Liste - REST API (Azure Tüketimi) bölümünde tam örnek bir eski Kullanım Ayrıntıları kaydı gösterilir

Aşağıdaki tablo, eski ve yeni alanlar arasında bir eşleme sağlar. Yeni özellikler, Dışarı Aktarmalar ve Maliyet Ayrıntıları API'sinin ürettiği CSV dosyalarında kullanılabilir. Alanlar hakkında daha fazla bilgi edinmek için bkz . Kullanım ayrıntıları alanlarını anlama.

Kalın özellik adları değişmez.

alan eşlemesini Microsoft Müşteri Sözleşmesi

Tüketim Kullanımı Ayrıntıları API'sini kullanan müşteriler Microsoft Müşteri Sözleşmesi türündeki modernkullanım ayrıntıları kayıtlarına sahiptir. Tüm Microsoft Müşteri Sözleşmesi müşterileri için kullanılan temel faturalama sistemi nedeniyle bu tür kayıtlara sahiptir. Aşağıda örnek bir MCA kullanım ayrıntıları kaydı verilmiştir:

{  

  "value": [  

      {  

          "id": "{id}", 

          "name": "{name}",  

          "type": "Microsoft.Consumption/usageDetails",  

          "kind": "modern",  

          "tags": {  

               "env": "newcrp",  

               "dev": "tools"  

          },  

          "properties": {  

…... 

      } 

} 

Kullanım Ayrıntıları - Liste - REST API (Azure Tüketimi) bölümünde tam örnek bir eski Kullanım Ayrıntıları kaydı gösterilir

Aşağıdaki tabloda eski ve yeni alanlar arasında bir eşleme gösterilmektedir. Yeni özellikler, Dışarı Aktarmalar ve Maliyet Ayrıntıları API'sinin ürettiği CSV dosyalarında kullanılabilir. Çözümler arasındaki farklar nedeniyle eşleme gerektiren alanlar kalın metin olarak gösterilir.

Daha fazla bilgi için bkz . Kullanım ayrıntıları alanlarını anlama.

İlgili içerik

• Maliyet Yönetimi + Faturalama otomasyonu hakkında daha fazla bilgi için bkz . Maliyet Yönetimi otomasyonuna genel bakış.