Öğretici: Dışarı Aktarmalar API'siyle geçmiş maliyet veri kümesi oluşturma

Makale
11/17/2023

Büyük kuruluşların genellikle bir yıl veya daha fazla geçmişe dönük geçmiş maliyetlerini analiz etmeleri gerekir. Hedeflenen tek seferlik sorgular için veya zaman içindeki maliyet eğilimlerini görselleştirmek için raporlama panoları ayarlamak için veri kümesini oluşturmak gerekebilir. Her iki durumda da, verileri sorgulayabileceğiniz bir veri deposuna yükleyebilmek için güvenilir bir şekilde almanız gerekir. Geçmiş maliyet veri kümeniz dağıtıldıktan sonra, raporlamanızın güncel tutulması için yeni maliyetler geldikçe veri deponuz güncelleştirilebilir. Geçmiş maliyetler nadiren değişir ve değişirse size bildirilir. Bu nedenle, geçmiş maliyetlerinizi ayda en fazla bir kez yenilemenizi öneririz.

Bu öğreticide şunların nasıl yapıldığını öğreneceksiniz:

Hizmet sorumlunuz için taşıyıcı belirteç alma
İsteği biçimlendirme
İstekleri bir aylık öbekler halinde yürütme

Önkoşullar

Dışarı Aktarmalar API'sini başarıyla çağırmak için uygun izinlere sahip olmanız gerekir. Otomasyon senaryolarında Hizmet Sorumlusu kullanmanızı öneririz.

Daha fazla bilgi edinmek için bkz. Maliyet Yönetimi API'lerine izin atama.
Dışarı Aktarmalar API'sinde gereken belirli izinler hakkında daha fazla bilgi edinmek için bkz. Kapsamları anlama ve bunlarla çalışma.

Ayrıca, API'yi doğrudan sorgulamak için bir yönteme ihtiyacınız olacaktır. Bu öğretici için PostMan kullanmanızı öneririz.

Hizmet sorumlunuz için taşıyıcı belirteç alma

Hizmet sorumlusuyla taşıyıcı belirteci almayı öğrenmek için bkz. Erişim belirteci alma.

İsteği biçimlendirme

Aşağıdaki örnek isteğe bakın ve kendi tek seferlik verilerinizi Dışarı Aktar'ı oluşturun. Aşağıdaki örnek istek, belirtilen Azure depolama hesabında bir aylık Gerçek Maliyet veri kümesi oluşturur. Rapor başına en fazla bir aylık veri istemenizi öneririz. Her ay büyük bir veri kümeniz varsa, tek seferlik dışarı aktarma işleminizi birden çok dosyaya bölmek üzere ayarlamanızı partitionData = true öneririz. Daha fazla bilgi için bkz. Büyük veri kümeleri için dosya bölümleme.

PUT https://management.azure.com/providers/Microsoft.Billing/billingAccounts/{enrollmentId}/providers/Microsoft.CostManagement/exports/{ExportName}?api-version=2021-10-01

İstek Üst Bilgileri

Authorization: <YOUR BEARER TOKEN>
Accept: /*/
Content-Type: application/json

İstek Gövdesi

{
  "properties": {
    "definition": {
      "dataset": {
        "granularity": "Daily",
        "grouping": []
      },
      "timePeriod": {
        "from": "2021-09-01T00:00:00.000Z",
        "to": "2021-09-30T00:00:00.000Z"
      },
      "timeframe": "Custom",
      "type": "ActualCost"
    },
    "deliveryInfo": {
      "destination": {
        "container": "{containerName}",
        "rootFolderPath": "{folderName}",
        "resourceId": "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Storage/storageAccounts/{storageAccountName}"
      }
    },
    "format": "Csv",
    "partitionData": false
  }
}

Bir aylık öbekler halinde Dışarı Aktarmalar oluşturma

Bir aylık öbekler halinde tek seferlik veri dışarı aktarmaları oluşturmanızı öneririz. Bir yıllık geçmiş veri kümesini görmek istiyorsanız, her ay için bir tane olmak üzere 12 Dışarı Aktarma API'si isteği yürütmeniz gerekir. Geçmiş veri kümenizi oluşturduktan sonra, zaman içinde ücretleriniz tahakkuk ettikçe maliyet verilerinizi Azure depolama alanına doldurmaya devam etmek için zamanlanmış bir dışarı aktarma oluşturabilirsiniz.

Her Dışarı Aktarmayı Çalıştır

Her ay için Dışarı Aktar'ı oluşturduğunuza göre, Yürütme API'sini çağırarak her birini el ile çalıştırmanız gerekir. API'ye yönelik örnek bir istek aşağıda verilmiştir.

POST https://management.azure.com/{scope}/providers/Microsoft.CostManagement/exports/{exportName}/run?api-version=2021-10-01

Sonraki adımlar

Bu öğreticide, şunların nasıl yapıldığını öğrendiniz:

Hizmet sorumlunuz için taşıyıcı belirteç alma
İsteği biçimlendirme
İstekleri bir aylık öbekler halinde yürütme

Maliyet ayrıntıları hakkında daha fazla bilgi edinmek için bkz. Maliyet ayrıntıları verilerini alma.

Maliyet ayrıntıları veri kümesinde hangi verilerin kullanılabilir olduğu hakkında daha fazla bilgi edinmek için bkz. Maliyet ayrıntıları veri alanlarını anlama.

Aracılığıyla paylaş