Aracılığıyla paylaş

İsteğe bağlı olarak küçük maliyetli veri kümeleri alma

  • Makale

Azure faturanıza karşılık gelen ham, toplanmamış maliyet verilerini almak için Maliyet Ayrıntıları API'sini kullanın. Kuruluşunuz için programlı bir veri alma çözümüne ihtiyaç duyuyorsanız API’den faydalanabilirsiniz. 2 GB (2 milyon satır) veya daha küçük maliyet veri kümelerini analiz etmek istiyorsanız API'yi kullanmayı göz önünde bulundurun. Ancak, devam eden veri alımı iş yükleri ve daha büyük veri kümelerinin indirilmesi için Dışarı Aktarmalar'ı kullanmanız gerekir.

Düzenli olarak büyük miktarda dışarı aktarılan veri almak istiyorsanız bkz . Dışarı aktarmalarla büyük maliyetli veri kümelerini tekrar tekrar alma.

Maliyet ayrıntılarındaki veriler (eski adıyla kullanım ayrıntıları) hakkında daha fazla bilgi edinmek için bkz. Maliyet ayrıntıları verilerini alma.

Maliyet Ayrıntıları raporu yalnızca Kurumsal Anlaşma veya Microsoft Müşteri Sözleşmesi olan müşteriler tarafından kullanılabilir. MSDN, kullandıkça öde veya Visual Studio müşterisiyseniz bkz . Kullandıkça öde aboneliği için maliyet ayrıntılarını alma.

İzinler

Maliyet Ayrıntıları API'sini kullanmak için desteklenen özellikler ve kapsamlar için salt okunur izinlere sahip olmanız gerekir.

Not

Maliyet Ayrıntıları API'si EA veya MCA müşterileri için yönetim gruplarını desteklemez.

Daha fazla bilgi için bkz.

Maliyet Ayrıntıları API'sinde en iyi yöntemler

Microsoft, Maliyet Ayrıntıları API'sini kullanırken aşağıdaki en iyi yöntemleri önerir.

İstek zamanlaması

En son maliyet verilerini almak istiyorsanız, günde en fazla bir kez sorgulamanızı öneririz. Raporlar dört saatte bir yenilenir. Daha sık ararsanız, aynı verileri alırsınız. Geçmiş faturalar için maliyet verilerinizi indirdiğinizde, size açıkça bildirilmediği sürece ücretler değişmez. Aynı veriler için yinelenen çağrıları önlemek için maliyet verilerinizi sizin tarafınızdaki sorgulanabilir bir depoda önbelleğe almanızı öneririz.

İsteklerinizi öbekle

Ağ üzerinden indirebileceğiniz daha yönetilebilir dosyalar elde etmek için çağrılarınızı küçük tarih aralıklarına ayırın. Örneğin, büyük bir Azure maliyet dosyanız aydan aya büyükse güne veya haftaya göre öbeklemenizi öneririz. Büyük miktarda maliyet verisine sahip kapsamlarınız varsa (örneğin Faturalama Hesabı), indirebileceğiniz daha yönetilebilir dosyalar elde etmek için alt kapsamlara birden çok çağrı yapmayı göz önünde bulundurun. Maliyet Yönetimi kapsamları hakkında daha fazla bilgi için bkz. Kapsamları anlama ve birlikte çalışma. Verileri indirdikten sonra, filtreler ve özet tablolarla verileri daha ayrıntılı analiz etmek için Excel'i kullanın.

Veri kümeniz aylık 2 GB'tan (veya yaklaşık 2 milyon satırdan) fazlaysa, dışarı aktarmaları daha ölçeklenebilir bir çözüm olarak kullanmayı göz önünde bulundurun.

Gecikme süresi ve hız sınırları

API'ye yapılan isteğe bağlı çağrılar hız sınırına sahiptir. Maliyet ayrıntıları dosyanızı oluşturma süresi, dosyadaki veri miktarıyla doğrudan ilişkilendirilir. Dosyanızın indirilmeye hazır hale gelmesi için beklenen süreyi anlamak için API yanıtında üst bilgiyi kullanabilirsiniz retry-after .

Desteklenen veri kümesi zaman aralıkları

Maliyet Ayrıntıları API'si rapor başına bir aylık maksimum veri kümesi zaman aralığını destekler. Geçmiş veriler geçerli tarihten en fazla 13 ay önce alınabilir. 13 aylık geçmiş veri kümesini görmek istiyorsanız, son 13 ay için bir aylık veri kümelerine 13 çağrı yerleştirmenizi öneririz. 13 aydan eski geçmiş verileri almak için Dışarı Aktarmalar REST API'sini kullanın.

Örnek Maliyet Ayrıntıları API'si istekleri

Aşağıdaki örnek istekler, Microsoft müşterileri tarafından yaygın senaryoları ele almak için kullanılır. İstek tarafından döndürülen veriler, maliyetin faturalama sistemi tarafından alındığı tarihe karşılık gelir. Bu, birden çok faturadaki maliyetleri içerebilir. Bu, zaman uyumsuz bir API'dir. Bu nedenle, raporunuzu istemek için bir ilk çağrı yerleştirirsiniz ve yanıt üst bilgisinde bir yoklama bağlantısı alırsınız. Buradan, rapor sizin için kullanılabilir olana kadar sağlanan bağlantıyı yoklayabilirsiniz.

retry-after BIR sonraki API'nin ne zaman yok kullanılacağını dikte etmek için API yanıtında üst bilgiyi kullanın. Üst bilgi, raporunuzun oluşturulması için gereken tahmini minimum süreyi sağlar.

API sözleşmesi hakkında daha fazla bilgi edinmek için bkz . Maliyet Ayrıntıları API'si .

Gerçek maliyetle amorti edilmiş maliyet karşılaştırması

Gerçek bir maliyet mi yoksa amorti edilmiş maliyet raporu mu görmek istediğinizi denetlemek için, ilk istek gövdesindeki ölçüm alanı için kullanılan değeri değiştirin. Kullanılabilir ölçüm değerleri veya AmortizedCostşeklindedirActualCost.

Amorti edilmiş maliyet, rezervasyon satın almalarınızı günlük öbeklere böler ve bunları rezervasyon döneminin süresine yayar. Örneğin 1 Ocak tarihinde 365 ABD doları tutarında bir satın alma işlemi görmek yerine 1 Ocak ile 31 Aralık arasındaki her gün 1,00 ABD doları değerinde satın alma işlemi görürsünüz. Temel amortiye ek olarak, maliyetler de yeniden ayrılır ve rezervasyonu kullanan belirli kaynaklar kullanılarak ilişkilendirilir. Örneğin, günlük 1,00 ABD doları tutarındaki ücret iki sanal makine arasında bölünürse, gün için iki adet 0,50 ABD doları ücret görürsünüz. Rezervasyonun bir bölümünün aynı gün kullanılmaması halinde ilgili sanal makine ile ilişkilendirilmiş 0,50 ABD doları değerinde ücret ve UnusedReservation ücret türüne sahip ayrı bir 0,50 ABD doları harcama görürsünüz. Kullanılmayan rezervasyon maliyetleri yalnızca amorti edilmiş maliyet görüntülenirken görülür.

Maliyetlerin temsil şeklindeki değişiklik nedeniyle, gerçek maliyet ve amorti edilmiş maliyet görünümlerinin farklı toplam sayılar gösterdiğine dikkat etmek önemlidir. Genel olarak, amorti edilmiş maliyetler görüntülenirken rezervasyon satın alma işleminin zaman içindeki toplam ay maliyeti azalır. Rezervasyon satın alma artışından sonraki ayların maliyeti. Amorti yalnızca rezervasyon satın alma işlemlerinde kullanılabilir ve şu anda Azure Market satın alma işlemleri için geçerli değildir.

Rapor oluşturmak için ilk istek

POST https://management.azure.com/{scope}/providers/Microsoft.CostManagement/generateCostDetailsReport?api-version=2022-05-01

İstek gövdesi:

Aşağıda, belirtilen tarih aralığı için ActualCost veri kümesine yönelik örnek bir istek verilmiştir.

{
  "metric": "ActualCost",
  "timePeriod": {
    "start": "2020-03-01",
    "end": "2020-03-15"
  }
}

Uygun URI'yi oluşturmak için kullanılabilir {scope} seçenekleri, Kapsam için kaynak kimliğini belirleme bölümünde belgelenmiştir.

Rapor isteği gövdesinde sağlayabileceğiniz kullanılabilir alanlar aşağıdadır.

  • metric - İstenen rapor türü. ActualCost veya AmortizedCost olabilir. Gerekli değil. Alan belirtilmezse, API varsayılan olarak bir ActualCost raporuna ayarlanır.
  • timePeriod - Verileriniz için istenen tarih aralığı. Gerekli değil. Bu parametre invoiceId veya billingPeriod parametreleriyle birlikte kullanılamaz. İstek gövdesinde timePeriod, invoiceId veya billingPeriod parametresi sağlanmazsa API geçerli ayın maliyetini döndürür.
  • invoiceId - Verileriniz için istenen fatura. Bu parametre yalnızca Microsoft Müşteri Sözleşmesi müşteriler tarafından kullanılır. Ayrıca, yalnızca Faturalama Profili veya Müşteri kapsamında kullanılabilir. Bu parametre billingPeriod veya timePeriod parametreleriyle birlikte kullanılamaz. İstek gövdesinde timePeriod, invoiceId veya billingPeriod parametresi sağlanmazsa API geçerli ayın maliyetini döndürür.
  • billingPeriod - Verileriniz için istenen faturalama dönemi. Bu parametre yalnızca Kurumsal Anlaşma müşteriler tarafından kullanılır. YearMonth biçimini kullanın. Örneğin, 202008. Bu parametre invoiceId veya timePeriod parametreleriyle birlikte kullanılamaz. İstek gövdesinde timePeriod, invoiceId veya billingPeriod parametresi sağlanmazsa API geçerli ayın maliyetini döndürür.

API yanıtı:

Response Status: 202 – Accepted : İsteğin kabul edilmiş olduğunu gösterir. Location Durumu denetlemek için üst bilgiyi kullanın.

Yanıt üst bilgileri:

Adı Tip Biçimlendir Açıklama
Konum String Zaman uyumsuz işlemin sonucunu denetlemek için URL.
Sonra Yeniden Dene Tamsayı Int32 Raporunuzun oluşturulması beklenen zaman. Yeniden yoklamadan önce bu süreyi bekleyin.

Rapor yoklaması ve indirme

Maliyet Ayrıntıları raporu oluşturma isteğinde bulunduktan sonra API yanıtının üst bilgisinde location sağlanan uç noktayı kullanarak raporu yoklama. Aşağıda örnek bir yoklama isteği verilmiş.

Rapor yoklama isteği:

GET https://management.azure.com/{scope}/providers/Microsoft.CostManagement/costDetailsOperationStatus/{operationId}?api-version=2022-05-01

Response Status 200 – Succeeded: İsteğin başarılı olduğunu gösterir.

{
  "id": "subscriptions/00000000-0000-0000-0000-000000000000/providers/Microsoft.CostManagement/operationResults/00000000-0000-0000-0000-000000000000",
  "name": "00000000-0000-0000-0000-000000000000",
  "status": "Completed",
  "manifest": {
    "manifestVersion": "2022-05-01",
    "dataFormat": "Csv",
    "blobCount": 1,
    "byteCount": 160769,
    "compressData": false,
    "requestContext": {
      "requestScope": "subscriptions/00000000-0000-0000-0000-000000000000",
      "requestBody": {
        "metric": "ActualCost",
        "timePeriod": {
          "start": "2020-03-01",
          "end": "2020-03-15"
        }
      }
    },
    "blobs": [
      {
        "blobLink": "{downloadLink}",
        "byteCount": 32741
      }
    ]
  },
  "validTill": "2022-05-10T08:08:46.1973252Z"
}

API yanıtında anahtar alanlarının özeti aşağıda verilmişti:

  • manifestVersion - Yanıtta kullanılan bildirim sözleşmesinin sürümü. Şu anda bildirim sürümü, belirli bir API sürümü için aynı kalır.
  • dataFormat - CSV şu anda API tarafından sağlanan tek desteklenen dosya biçimidir.
  • blobCount - Rapor veri kümesinde bulunan tek tek veri bloblarının sayısını temsil eder. Bu API'nin yanıtta birden fazla dosyadan oluşan bölümlenmiş bir veri kümesi sağlayabileceğini unutmayın. Bölümlenmiş dosyaları uygun şekilde işleyebilmek için veri işlem hatlarınızı tasarlayın. Bölümleme, daha büyük veri kümelerini daha hızlı bir şekilde alabilmenizi sağlar.
  • byteCount - Tüm bölümlerde rapor veri kümesinin toplam bayt sayısı.
  • compressData - Sıkıştırma her zaman ilk sürüm için false olarak ayarlanır. Ancak API gelecekte sıkıştırmayı destekleyecektir.
  • requestContext - Rapor için istenen ilk yapılandırma.
  • bloblar - Birlikte raporun tamamını oluşturan n blob dosyasının listesi.
    • blobLink - Tek bir blob bölümünün indirme URL'si.
    • byteCount - Tek tek blob bölümünün bayt sayısı.
  • validTill - Raporun artık erişilebilir olmadığı tarih.

İlgili içerik