EA Kullanım Ayrıntıları API'lerinden geçiş

Kullanım ayrıntılarını ve market ücretlerini almak için daha önce consumption.azure.com uç noktasının arkasındaki Kurumsal Raporlama API'lerini kullanan EA müşterilerinin yeni ve geliştirilmiş çözümlere geçmeleri gerekir. Yönergeler, eski API ile yeni çözümler arasındaki sözleşme farklılıklarıyla birlikte aşağıda özetlenmiştir.

Veri kümesi, kullanım ayrıntıları yerine maliyet ayrıntıları olarak adlandırılır.

Not

Tüm Azure Kurumsal Raporlama API'leri kullanımdan kaldırıldı. En kısa zamanda Microsoft Maliyet Yönetimi API'lerine geçmeniz gerekir.

Genel kullanıma sunulan yeni çözümler

Aşağıdaki tabloda, hangi çözümün sizin için en uygun olduğunu seçerken dikkate alınacak noktaların bir özetiyle birlikte kullanılabilen geçiş hedeflerinin bir özeti sağlanır.

Çözüm	Açıklama	Dikkat edilmesi gerekenler	Ekleme bilgileri
Dışarı aktarmalar	Bir zamanlamaya göre depolamaya yinelenen veri dökümleri	- İş yükleriniz için en ölçeklenebilir çözüm. - Daha büyük veri kümeleri için dosya bölümleme kullanacak şekilde yapılandırılabilir. - Kendi sorgulanabilir veri depolarınızla tümleştirilebilen bir maliyet veri kümesi oluşturmak ve büyütmek için harikadır. -Verileri tutabilen bir depolama hesabına erişim gerektirir.	- Azure portalında yapılandırma API ile Dışarı Aktarma oluşturmayı otomatikleştirme - API Başvurusunu Dışarı Aktarma
Maliyet Ayrıntıları API'si	İsteğe bağlı indirme	- Küçük maliyetli veri kümeleri için kullanışlıdır. - Güvenlik veya yönetilebilirlik endişeleri nedeniyle Azure depolamaya dışarı aktarmaların uygun olmadığında senaryolar için kullanışlıdır.	- İsteğe bağlı olarak küçük maliyetli veri kümeleri alma - Maliyet Ayrıntıları API'si

Genellikle devam eden veri alımı gereksinimleriniz ve/veya büyük bir aylık maliyet ayrıntıları veri kümeniz varsa Dışarı Aktarmalar'ı kullanmanızı öneririz. Daha fazla bilgi için bkz . Maliyet ayrıntıları verilerini alma. İş yükünüz için karar vermenize yardımcı olacak ek bilgilere ihtiyacınız varsa bkz . Maliyet ayrıntıları çözümü seçme.

API'leri çağırmak için SPN'ye izin atama

Dışarı Aktarmalar veya Maliyet Ayrıntıları API'lerini program aracılığıyla çağırmak istiyorsanız, doğru izne sahip bir Hizmet Sorumlusu yapılandırmanız gerekir. Daha fazla bilgi için bkz . ACM API'lerine izin atama.

Microsoft Tüketim Kullanımı Ayrıntıları API'sini kullanma

Tüketim Kullanımı Ayrıntıları API'si şu anda EA müşterilerini destekleyen başka bir uç noktadır. Bu API'ye geçiş yapmayın. Bu belgenin önceki bölümlerinde açıklandığı gibi Dışarı Aktarmalar'a veya Maliyet Ayrıntıları API'sine geçiş yapın. Tüketim Kullanımı Ayrıntıları API'si gelecekte kullanımdan kaldırılacak ve aşağıdaki uç noktanın arkasında yer alacaktır.

GET https://management.azure.com/{scope}/providers/Microsoft.Consumption/usageDetails?api-version=2021-10-01

Bu API zaman uyumlu bir uç noktadır ve hem harcamalarınız hem de aylık maliyet veri kümesindeki ayınızın boyutu arttıkça ölçeklendirilemez. Şu anda Tüketim Kullanımı Ayrıntıları API'sini kullanıyorsanız, bunu en kısa sürede Maliyet Ayrıntıları API'sinin Dışarı Aktarmaları'na geçirmenizi öneririz. Gelecek bir tarihte resmi kullanımdan kaldırma duyurusu yapılacaktır. Tüketim Kullanımı Ayrıntıları'ndan geçiş hakkında daha fazla bilgi edinmek için bkz . Tüketim Kullanımı Ayrıntıları API'sinden geçiş.

Geçiş avantajları

Yeni çözümlerimiz EA Raporlama Kullanım Ayrıntıları API'lerine göre birçok avantaj sağlar. Özet aşağıdadır:

• Güvenlik ve kararlılık - Yeni çözümler, verilere erişmek için Hizmet Sorumlusu ve/veya kullanıcı belirteçleri gerektirir. EA Raporlama API'lerinde kimlik doğrulaması için kullanılan API anahtarlarından daha güvenlidir. Bu eski API'lerdeki anahtarlar altı ay geçerlidir ve sızdırılırsa hassas finansal verileri kullanıma açabilir. Ayrıca anahtarlar altı aylık süre dolmadan önce yenilenmez ve iş yükleriyle tümleştirilmemişse veri erişimi iptal edilir. Bu, müşteri iş yüklerini bozar.
• Ölçeklenebilirlik - EA Raporlama API'leri, Azure kullanımınız arttıkça ölçeklendirilecek şekilde derlenmez. Buluta daha fazla kaynak dağıttıkça kullanım ayrıntıları veri kümesi fazlasıyla büyük olabilir. Yeni çözümler zaman uyumsuz ve her boyuttaki veri kümesi için başarılı indirmeler sağlamak için arkalarında kapsamlı altyapı geliştirmeleri var.
• Tüm kullanım ayrıntıları için tek veri kümesi - Azure ve Azure Market kullanım ayrıntıları yeni çözümlerde tek bir veri kümesinde birleştirildi. Tek veri kümesi, tüm ücretlerinizi görmek için çağırmanız gereken API sayısını azaltır.
• Satın alma amortisi - Rezervasyon satın alan müşteriler, yeni çözümleri kullanarak maliyetlerinin Amorti edilmiş bir görünümünü görebilir.
• Şema tutarlılığı - Kullanılabilen her çözüm, eşleşen alanlara sahip dosyalar sağlar. Senaryonuza göre çözümler arasında kolayca geçiş yapmanızı sağlar.
• Maliyet Ayırma tümleştirmesi - Kurumsal Anlaşma ve Microsoft Müşteri Sözleşmesi müşterileri, yapılandırdıkları maliyet ayırma kurallarına göre ücretleri görüntülemek için yeni çözümü kullanabilir. Maliyet ayırma hakkında daha fazla bilgi için bkz . Maliyetleri ayırma.
• İleriye dönük geliştirmeler - Yeni çözümler ileriye doğru etkin bir şekilde geliştiriliyor. Çözümler, yayımlandıklarında tüm yeni özellikleri alır.

Geçiş için Kurumsal Kullanım API'leri

Aşağıdaki tabloda, maliyet ayrıntıları verilerini almak için bugün kullanıyor olabileceğiniz farklı API'ler özetlemektedir. Aşağıdaki API'lerden birini kullanıyorsanız, daha önce özetlenen yeni çözümlerden birine geçmeniz gerekir. Tüm API'ler uç noktanın https://consumption.azure.com arkasındadır.

Uç nokta	API Açıklamaları
/v3/enrollments/{enrollmentNumber}/usagedetails/download?billingPeriod={billingPeriod}	- API yöntemi: GET - Zaman uyumlu (yoklama olmayan) - Veri biçimi: CSV
/v3/enrollments/{enrollmentNumber}/usagedetails/download?startTime=2017-01-01&endTime=2017-01-10	- API yöntemi: GET - Zaman uyumlu (yoklama olmayan) - Veri biçimi: CSV
/v3/enrollments/{enrollmentNumber}/usagedetails	- API yöntemi: GET - Zaman uyumlu (yoklama olmayan) - Veri biçimi: JSON
/v3/enrollments/{enrollmentNumber}/billingPeriods/{billingPeriod}/usagedetails	- API yöntemi: GET - Zaman uyumlu (yoklama olmayan) - Veri biçimi: JSON
/v3/enrollments/{enrollmentNumber}/usagedetailsbycustomdate?startTime=2017-01-01&endTime=2017-01-10	- API yöntemi: GET - Zaman uyumlu (yoklama olmayan) - Veri biçimi: JSON
/v3/enrollments/{enrollmentNumber}/usagedetails/submit?billingPeriod={billingPeriod}	- API yöntemi: POST - Zaman uyumsuz (yoklama tabanlı) - Veri biçimi: CSV
/v3/enrollments/{enrollmentNumber}/usagedetails/submit?startTime=2017-04-01&endTime=2017-04-10	- API yöntemi: POST - Zaman uyumsuz (yoklama tabanlı) - Veri biçimi: CSV

Veri alanı eşleme

Aşağıdaki tabloda, şu anda kullanmakta olduğunuz çözümlerde bulunan eski alanların bir özeti ve yeni çözümlerde kullanılacak alan yer alır.

Eski alan	Yeni alan	Açıklamalar
accountId		Kullanılamaz - Hesap bilgilerini almak için AccountName kullanın.
accountName	AccountName
accountOwnerEmail	AccountOwnerId
additionalInfo	AdditionalInfo
chargesBilledSeparately	isAzureCreditEligible	Özellikler tam tersidir. True isAzureCreditEnabled ise false ChargesBilledSeparately olur.
consumedQuantity	Miktar
consumedService	ConsumedService
consumedServiceId	ConsumedService	consumedServiceId yalnızca bir sayı değeri sağlar. ConsumedService hizmetin adını sağlar.
maliyet	CostInBillingCurrency
costCenter	CostCenter
tarih	Tarih	Eski alandaki biçim yyyy-aa-gg, yeni alan ise aa/gg/yyyy biçimindedir.
departmentId	InvoiceSectionId	Alan şu anda boş. Bölüm bilgilerini almak için kullanın DepartmentName .
departmentName	InvoiceSectionName
extendedCost	CostInBillingCurrency
instanceId	ResourceId
isRecurringCharge		Uygun olduğunda ve Term fields ileriye doğru kullanınFrequency.
konum	ResourceLocationNormalized	ResourceLocationNormalized Maliyet Ayrıntıları raporunda bulunur, ancak henüz dışarı aktarmalarda yoktur.
meterCategory	MeterCategory
meterId	MeterId
meterName	MeterName
meterRegion	MeterRegion
meterSubCategory	MeterSubCategory
offerId	OfferId
Ordernumber		Kullanılamaz.
partNumber	PartNumber
planName	PlanName
ürün	ProductName
publisherName	PublisherName
resourceGroup	ResourceGroup
resourceGuid	MeterId	Değerler farklılık gösterir. resourceGuid bir GUID değeridir. meterId uzun bir sayıdır.
resourceLocation	ResourceLocation
resourceLocationId		Kullanılamaz.
resourceRate	EffectivePrice
serviceInfo1	ServiceInfo1
serviceInfo2	ServiceInfo2
Hizmetadı	MeterCategory
serviceTier	MeterSubCategory
storeServiceIdentifier		Kullanılamaz.
subscriptionGuid	SubscriptionId
subscriptionId	SubscriptionId
subscriptionName	SubscriptionName
tags	Etiketler	Yeni alanda anahtar-değer çiftlerinin çevresini kapsayan {} bir alan yoktur.
unitOfMeasure	UnitOfMeasure

İlgili içerik

• EA Raporlama'dan Azure Resource Manager API'lerine geçişe genel bakış makalesini okuyun.