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:
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.
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