Kurumsal Anlaşma'dan Microsoft Müşteri Sözleşmesi API'lerine geçiş

Bu makale, Kurumsal Anlaşma (EA) ile Microsoft Müşteri Sözleşmesi (MCA) hesapları arasındaki veri yapısı, API ve diğer sistem tümleştirmesi farklarını anlamanıza yardımcı olacaktır. Maliyet Yönetimi her iki hesap türü için de API'leri destekler. Devam etmeden önce Microsoft Müşteri Sözleşmesi için Ödeme hesabını ayarlama makalesini inceleyin.

Ea hesabı olan kuruluşlar, MCA hesabı ayarlarken bu makaleyi gözden geçirmelidir. Eskiden EA hesabının yenilenmesi için eski kaydı yeni bir kayda taşıma amacıyla çok az işlem gerekiyordu. Ancak, bir MCA hesabına geçiş için fazladan çaba gerekir. Ek çaba, maliyetle ilgili tüm API'leri ve hizmet tekliflerini etkileyen temel faturalama alt sistemindeki değişikliklerden dolayıdır.

MCA API'leri ve tümleştirme

MCA API'leri ve yeni tümleştirme sayesinde şunları gerçekleştirebilirsiniz:

• Yerel Azure API'leri aracılığıyla tam API kullanılabilirliği sağlama.
• Tek bir ödeme hesabında birden fazla fatura yapılandırma.
• Azure hizmeti kullanımını, üçüncü taraf Market kullanımını ve Market satın alma işlemlerini içeren birleştirilmiş bir API'ye erişme.
• Maliyet Yönetimi'ni kullanarak faturalama profillerindeki maliyetleri (kayıtlarla aynı şekilde) görüntüleyin.
• Maliyetleri göstermek, maliyetler önceden tanımlanmış eşikleri aştığında bildirim almak ve ham verileri otomatik olarak dışarı aktarmak için yeni API'lere erişme.

Geçiş denetim listesi

Aşağıdaki maddeler, MCA API'lerine geçiş yapmanıza yardımcı olacaktır.

• Yeni Microsoft Müşteri Sözleşmesi ödeme hesabı hakkında bilgi edinin.
• Kullanacağınız API'leri belirleyin ve aşağıdaki bölümde değiştirilenleri inceleyin.
• Azure Resource Manager REST API'leri hakkında bilgi edinin.
• Henüz Azure Resource Manager API'lerini kullanmıyorsanız istemci uygulamanızı Microsoft Entra Id ile kaydedin.
• Microsoft Entra uygulama kaydı sırasında oluşturulan uygulamaya Erişim denetimini (IAM) kullanarak ödeme hesabına okuma erişimi verin.
• Microsoft Entra kimlik doğrulamasını kullanmak için tüm programlama kodlarını güncelleştirin.
• Programlarınızın kodunu EA API çağrılarını MCA API çağrılarıyla değiştirecek şekilde güncelleştirin.
• Hata işleme süreçlerini yeni hata kodlarını kullanacak şekilde güncelleştirin.
• Diğer gerekli eylemler için Power BI gibi diğer tümleştirme tekliflerini gözden geçirin.

EA API'ler, MCA API'leriyle değiştirildi

EA API'leri, kimlik doğrulaması ve yetkilendirme için API anahtarı kullanır. MCA API'leri Microsoft Entra kimlik doğrulamayı kullanı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.

Purpose	EA API	MCA API
Bakiye ve krediler	/balancesummary	Microsoft.Billing/billingAccounts/billingProfiles/availableBalanceussae
Kullanım (JSON)	/usagedetails /usagedetailsbycustomdate	Maliyet ayrıntıları çözümü seçme
Kullanım (CSV)	/usagedetails/download /usagedetails/submit	Maliyet ayrıntıları çözümü seçme
Market Kullanımı (CSV)	/marketplacecharges /marketplacechargesbycustomdate	Maliyet ayrıntıları çözümü seçme
Faturalama dönemleri	/billingperiods	Microsoft.Billing/billingAccounts/billingProfiles/invoices
Fiyat listesi	/pricesheet	Microsoft.Billing/billingAccounts/billingProfiles/pricesheet/default/download format=json veya csv Microsoft.Billing/billingAccounts/.../billingProfiles/.../invoices/... /pricesheet/default/download format=json veya csv Microsoft.Billing/billingAccounts/.. /billingProfiles/.. /providers/Microsoft.Consumption/pricesheets/download
Rezervasyon satın almaları	/reservationcharges	Microsoft.Billing/billingAccounts/billingProfiles/transactions
Rezervasyon önerileri	/SharedReservation Öneriler /SingleReservationRecommendations	Microsoft.Consumption/reservationRecommendations
Rezervasyon kullanımı	/reservationdetails /reservationsummaries	Microsoft.Consumption/reservationDetails Microsoft.Consumption/reservationSummaries

¹ Azure hizmeti ve üçüncü taraf Market kullanımı, Kullanım Ayrıntıları API'siyle kullanılabilir.

Aşağıdaki API'ler MCA ödeme hesapları için kullanılabilir:

Purpose	Microsoft Müşteri Sözleşmesi (MCA) API'si
Ödeme hesapları²	Microsoft.Billing/billingAccounts
Faturalama profilleri²	Microsoft.Billing/billingAccounts/billingProfiles
Fatura bölümleri²	Microsoft.Billing/billingAccounts/invoiceSections
Faturalar	Microsoft.Billing/billingAccounts/billingProfiles/invoices
Faturalama abonelikleri	{scope}/billingSubscriptions

² API'leri, Azure portalında ve API'lerde Maliyet Yönetimi deneyimlerinin çalıştığı kapsamlar olan nesnelerin listesini döndürür. Maliyet Yönetimi kapsamları hakkında daha fazla bilgi için bkz. Kapsamları anlama ve birlikte çalışma.

Mevcut EA API'lerini kullanıyorsanız bunları MCA ödeme hesaplarını destekleyecek şekilde güncelleştirmeniz gerekir. Aşağıdaki tabloda tümleştirme konusundaki diğer değişiklikler gösterilmektedir:

Purpose	Eski teklif	Yeni teklif
Power BI	Microsoft Consumption Insights içerik paketi ve bağlayıcısı	Azure Consumption Insights bağlayıcısı

Bakiyeyi ve kredileri almak için API'ler

BakiyeYi Al Özeti, size aylık özetini vermek için kullanılmıştır:

• Bakiyeler
• Yeni satın almalar
• Azure Market hizmet ücretleri
• Düzeltmeler
• Hizmet fazla kullanım ücretleri

Tüm Tüketim API'leri, kimlik doğrulaması ve yetkilendirme için Microsoft Entra Id kullanan yerel Azure API'leri ile değiştirilir. Azure REST API'lerini çağırma hakkında daha fazla bilgi için bkz. REST'i kullanmaya başlama.

Bakiye Özetini Al API'si, Microsoft.Billing/billingAccounts/billingProfiles/availableBalance API'si ile değiştirilmiştir.

Kullanılabilir Bakiye API'si ile kullanılabilir bakiyeleri almak için:

Metot	İstek URI'si
GET	https://management.azure.com/providers/Microsoft.Billing/billingAccounts/{billingAccountId}/billingProfiles/{billingProfileId}/availableBalances?api-version=2018-11-01-preview

Maliyeti ve kullanımı almak için API'ler

Aşağıdaki API'leri kullanarak Azure hizmeti kullanımı, üçüncü taraf Market kullanımı ve diğer Market satın alma işlemlerine ait maliyetlerin günlük dökümünü alabilirsiniz. Aşağıdaki ayrı API'ler, Azure hizmetleri ve üçüncü taraf Market kullanımı için birleştirilmiştir. Eski API'lerin yerini Dışarı Aktarmalar veya Maliyet Ayrıntıları API'si alır. Size uygun çözümü seçmek için bkz . Maliyet ayrıntıları çözümü seçme. Her iki çözüm de aynı Maliyet Ayrıntıları dosyasını sağlar ve daha önce yalnızca bakiye özetinde bugüne kadar gösterilen verilerde market satın almaları vardır.

Tüm Maliyet Yönetimi API'lerinde olduğu gibi dışarı aktarmalar ve Maliyet Ayrıntıları API'sini birden çok kapsamda kullanabilirsiniz. Normalde kayıt düzeyinde aldığınız faturalandırılan maliyetler için faturalama profili kapsamını kullanın. Maliyet Yönetimi kapsamları hakkında daha fazla bilgi için bkz. Kapsamları anlama ve birlikte çalışma.

Tür	Kimlik biçimi
Fatura hesabı	/Microsoft.Billing/billingAccounts/{billingAccountId}
Faturalama profili	/Microsoft.Billing/billingAccounts/{billingAccountId}/billingProfiles/{billingProfileId}
Abonelik	/subscriptions/{subscriptionId}
Kaynak grubu	/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}

Dışarı Aktarmalar ve Maliyet Ayrıntıları API'sinde kullanılabilen yeni Maliyet Ayrıntıları veri kümesinde bazı özellik adları değişmiştir. Aşağıdaki tabloda karşılık gelen özellikler gösterilmektedir.

Eski özellik	Yeni özellik	Notlar
AccountId	Yok	Abonelik oluşturucu izlenmiyor. invoiceSectionId (departmentId ile aynı) kullanın.
AccountNameAccountOwnerId ve AccountOwnerEmail	Yok	Abonelik oluşturucu izlenmiyor. invoiceSectionName (departmentName ile aynı) kullanın.
AdditionalInfo	additionalInfo
ChargesBilledSeparately	isAzureCreditEligible	Özellikler tam tersidir. isAzureCreditEnabled true olduğunda ChargesBilledSeparately false olur.
ConsumedQuantity	quantity
ConsumedService	consumedService	Tam dize değerleri farklı olabilir.
ConsumedServiceId	Hiçbiri
CostCenter	costCenter
Date ve usageStartDate	tarih
Gün	Hiçbiri	Tarihteki günü ayrıştırır.
DepartmentId	invoiceSectionId	Tam değerler farklıdır.
DepartmentName	invoiceSectionName	Tam dize değerleri farklı olabilir. Gerekirse fatura bölümlerini departmanlarla eşleşecek şekilde yapılandırın.
ExtendedCost ve Cost	costInBillingCurrency
InstanceId	resourceId
Is Recurring Charge	Hiçbiri
Yer	konum
MeterCategory	meterCategory	Tam dize değerleri farklı olabilir.
MeterId	meterId	Tam dize değerleri farklıdır.
MeterName	meterName	Tam dize değerleri farklı olabilir.
MeterRegion	meterRegion	Tam dize değerleri farklı olabilir.
MeterSubCategory	meterSubCategory	Tam dize değerleri farklı olabilir.
Month	Hiçbiri	Tarihteki ayı ayrıştırır.
Teklif Adı	Hiçbiri	publisherName ve productOrderName kullanın.
OfferID	Hiçbiri
Sipariş Numarası	Hiçbiri
PartNumber	Hiçbiri	Fiyatları benzersiz şekilde tanımlamak için meterId ve productOrderName kullanın.
Plan Adı	productOrderName
Ürün	Ürün
Ürün Kimliği	productId	Tam dize değerleri farklıdır.
Yayımcı Adı	publisherName
ResourceGroup	resourceGroupName
ResourceGuid	meterId	Tam dize değerleri farklıdır.
ResourceLocation	resourceLocation
ResourceLocationId	Hiçbiri
ResourceRate	effectivePrice
HizmetYöneticisiKimliği	Yok
ServiceInfo1	serviceInfo1
ServiceInfo2	serviceInfo2
ServiceName	meterCategory	Tam dize değerleri farklı olabilir.
ServiceTier	meterSubCategory	Tam dize değerleri farklı olabilir.
StoreServiceIdentifier	Yok
SubscriptionGuid	subscriptionId
SubscriptionId	subscriptionId
SubscriptionName	subscriptionName
Etiketler	tags	Tags özelliği, iç içe özellikler özelliğine değil kök nesnesine uygulanır.
UnitOfMeasure	unitOfMeasure	Tam dize değerleri farklıdır.
usageEndDate	tarih
Yıl	Hiçbiri	Tarihteki yılı ayrıştırır.
(yeni)	billingCurrency	Ücret için kullanılan para birimi.
(yeni)	billingProfileId	Faturalama profili için benzersiz kimlik (kayıt ile aynı).
(yeni)	billingProfileName	Faturalama profilinin adı (kayıt ile aynı).
(yeni)	chargeType	Azure hizmeti kullanımı, Market kullanımı ve satın alma işlemleri arasında ayrım yapmak için.
(yeni)	invoiceId	Faturanın benzersiz kimliği. Geçerli, mevcut ay için boş bırakın.
(yeni)	publisherType	Satın alma işlemleri için yayımcı türü. Kullanım için boş.
(yeni)	serviceFamily	Satın alma türü. Kullanım için boş.
(yeni)	servicePeriodEndDate	Satın alınan hizmetin bitiş tarihi.
(yeni)	servicePeriodStartDate	Satın alınan hizmetin başlangıç tarihi.

Fatura Dönemleri API'si, Faturalar API'si ile değiştirilmiştir

MCA ödeme hesapları, faturalandırma dönemlerini kullanmaz. Bunun yerine maliyetler için belirli faturalama dönemlerini kapsam olarak belirleme amacıyla faturaları kullanır. Fatura Dönemleri API'si, Faturalar API'si ile değiştirilmiştir. Tüm Tüketim API'leri, kimlik doğrulaması ve yetkilendirme için Microsoft Entra Id kullanan yerel Azure API'leri ile değiştirilir. Azure REST API'lerini çağırma hakkında daha fazla bilgi için bkz. REST'i kullanmaya başlama.

Faturalar API'si ile faturaları almak için:

Metot	İstek URI'si
GET	https://management.azure.com/providers/Microsoft.Billing/billingAccounts/{billingAccountId}/billingProfiles/{billingProfileId}/invoices?api-version=2018-11-01-preview

Fiyat Listesi API'leri

Bu bölümde mevcut Fiyat Listesi API'leri anlatılmakta ve Microsoft Müşteri Sözleşmesi için Fiyat Listesi API'sine geçiş yapma önerileri sunulmaktadır. Ayrıca Microsoft Müşteri Sözleşmesi için Fiyat Listesi API'si anlatılmakta ve fiyat listelerindeki alanlar açıklanmaktadır. Kurumsal Fiyat listesini al ve Kurumsal Faturalama dönemlerini al API'leri, Microsoft Müşteri Sözleşmesi için Fiyat Listesi API'si (Microsoft.Billing/billingAccounts/billingProfiles/pricesheet) ile değiştirilmiştir. Yeni API, zaman uyumsuz REST biçimlerinde hem JSON hem de CSV biçimlerini desteklemektedir. Tüm Tüketim API'leri, kimlik doğrulaması ve yetkilendirme için Microsoft Entra Id kullanan yerel Azure API'leri ile değiştirilir. Azure REST API'lerini çağırma hakkında daha fazla bilgi için bkz. REST'i kullanmaya başlama.

Faturalama Kurumsal API'leri

Kurumsal kayıtlarda fiyat ve faturalama dönemi bilgilerini almak için Faturalama Kurumsal API'lerini kullanıyordunuz. Kimlik doğrulaması ve yetkilendirme, Microsoft Entra web belirteçlerini kullandı.

Fiyat Listesi ve Faturalama Dönemi API'leri ile belirtilen Kurumsal Kayıt için geçerli olan fiyatları almak için:

Metot	İstek URI'si
GET	https://consumption.azure.com/v2/enrollments/{enrollmentNumber}/pricesheet
GET	https://consumption.azure.com/v2/enrollments/{enrollmentNumber}/billingPeriods/{billingPeriod}/pricesheet

Microsoft Müşteri Sözleşmeleri için Fiyat Listesi API'si

Tüm Azure Tüketim ve Market tüketim hizmetlerine ait fiyatları görüntülemek isterseniz Microsoft Müşteri Sözleşmeleri için Fiyat Listesi API'sini kullanın. Faturalama profili için gösterilen fiyatlar, faturalama profiline ait olan tüm abonelikler için geçerlidir.

Tüm Azure Tüketim hizmetlerinin Fiyat Listesi verilerini CSV biçiminde görüntülemek için Fiyat Listesi API'sini kullanın:

Metot	İstek URI'si
POST	https://management.azure.com/providers/Microsoft.Billing/billingAccounts/{billingAccountId}/billingProfiles/{billingProfileId}/pricesheet/default/download?api-version=2018-11-01-preview&startDate=2019-01-01&endDate=2019-01-31&format=csv

Tüm Azure Tüketim hizmetlerinin Fiyat Listesi verilerini JSON biçiminde görüntülemek için Fiyat Listesi API'sini kullanın:

Metot	İstek URI'si
POST	https://management.azure.com/providers/Microsoft.Billing/billingAccounts/{billingAccountId}/billingProfiles/{billingProfileId}/pricesheet/default/download?api-version=2018-11-01-preview&startDate=2019-01-01&endDate=2019-01-31&format=json

API kullanıldığında hesabın tamamı için geçerli olan fiyat listesi döndürülür. Ancak isterseniz fiyat listesinin sıkıştırılmış sürümünü PDF biçiminde alabilirsiniz. Özette belirli bir faturaya dahil olan Azure Tüketim ve Market tüketim hizmetleri bulunur. Fatura, Fatura Özeti PDF dosyalarında gösterilen Fatura Numarası ile aynı olan {invoiceId} ile tanımlanır. Aşağıda bir örnek verilmiştir.

Fiyat Listesi API'si ile fatura bilgilerini CSV biçiminde görüntülemek için:

Metot	İstek URI'si
POST	https://management.azure.com/providers/Microsoft.Billing/billingAccounts/2909cffc-b0a2-5de1-bb7b-5d3383764184/billingProfiles/2dcffe0c-ee92-4265-8647-515b8fe7dc78/invoices/{invoiceId}/pricesheet/default/download?api-version=2018-11-01-preview&format=csv

Fiyat Listesi API'si ile fatura bilgilerini JSON biçiminde görüntülemek için:

Metot	İstek URI'si
POST	https://management.azure.com/providers/Microsoft.Billing/billingAccounts/2909cffc-b0a2-5de1-bb7b-5d3383764184/billingProfiles/2dcffe0c-ee92-4265-8647-515b8fe7dc78/invoices/{invoiceId}/pricesheet/default/download?api-version=2018-11-01-preview&format=json

İsterseniz geçerli açık faturalama dönemi veya hizmet dönemi içindeki Azure Tüketimi veya Market tüketimi hizmetine ait tahmini fiyatları da görüntüleyebilirsiniz.

Fiyat Listesi API'si ile tüketim hizmetlerine ait tahmini fiyatları CSV biçiminde görüntülemek için:

Metot	İstek URI'si
POST	https://management.azure.com/providers/Microsoft.Billing/billingAccounts/{billing AccountId}/billingProfiles/{billingProfileId}/pricesheet/default/download?api-version=2018-11-01-preview&format=csv

Fiyat Listesi API'si ile tüketim hizmetlerine ait tahmini fiyatları JSON biçiminde görüntülemek için:

Metot	İstek URI'si
POST	https://management.azure.com/providers/Microsoft.Billing/billingAccounts/{billing AccountId}/billingProfiles/{billingProfileId}/pricesheet/default/download?api-version=2018-11-01-preview&format=json

Microsoft Müşteri Sözleşmesi Fiyat Listesi API'leri, zaman uyumsuz REST API'leridir. API yanıtları, eski zaman uyumlu API'lere göre değiştirilmiştir. API yanıtının gövdesi de değiştirilmiştir.

Eski yanıt gövdesi

Zaman uyumlu REST API yanıtı örneği aşağıda verilmiştir:

[
        {
            "id": "enrollments/573549891/billingperiods/2016011/products/343/pricesheets",
            "billingPeriodId": "201704",
            "meterId": "dc210ecb-97e8-4522-8134-2385494233c0",
            "meterName": "A1 VM",
            "unitOfMeasure": "100 Hours",
            "includedQuantity": 0,
            "partNumber": "N7H-00015",
            "unitPrice": 0.00,
            "currencyCode": "USD"
        },
        {
    ]

Yeni yanıt gövdesi

API'ler, Azure REST zaman uyumsuz biçimini destekler. API'yi GET kullanarak çağırdığınızda şu yanıtı alırsınız:

No Response Body

HTTP Status 202 Accepted

Aşağıdaki üst bilgiler, çıkışın konumuyla birlikte gönderilir:

Location:https://management.azure.com/providers/Microsoft.Consumption/operationresults/{operationId}?sessiontoken=XZDFSnvdkbkdsb==

Azure-AsyncOperation:https://managment.azure.com/providers/Microsoft.Consumption/operationStatus/{operationId}?sessiontoken=XZDFSnvdkbkdsb==

Retry-After: 10

OData-EntityId: {operationId}

Konuma başka bir GET çağrısı yapın. GET çağrısına verilen yanıt, işlem tamamlanana veya hata verene kadar aynı olur. Tamamlandığında, GET çağrı konumuna verilen yanıt, indirme URL'sini işlem aynı anda yürütülüyormuş gibi döndürür. Bir örnek aşağıda verilmiştir:

HTTP Status 200

{
  "id": "providers/Microsoft.Consumption/operationresults/{operationId}",
  "name": {operationId},
  "type": “Microsoft.Consumption/operationResults",
  "properties" : {
    "downloadUrl": {urltoblob},
    "validTill": "Date"
  }
}

İstemci ayrıca Azure-AsyncOperation için bir GET çağrısı yapabilir. Uç nokta, işlemin durumunu döndürür.

Aşağıdaki tabloda eski Enterprise GET fiyat listesi API'sindeki alanlar gösterilmiştir. Microsoft Müşteri Sözleşmeleri için yeni fiyat listesinde bulunan şu alanları içermektedir:

Eski özellik	Yeni özellik	Notlar
billingPeriodId	Geçerli değildir	Uygulanamaz. Microsoft Müşteri Sözleşmeleri için billingPeriodId kavramının yerini fatura ve ilgili fiyat listesi almıştır.
meterId	meterId
unitOfMeasure	unitOfMeasure	Tam dize değerleri farklı olabilir.
includedQuantity	includedQuantity	Microsoft Müşteri Sözleşmeleri kapsamındaki hizmetler için geçerli değildir.
partNumber	Geçerli değildir	Bunun yerine productOrderName (offerID ile aynı) ve meterID kullanın.
unitPrice	unitPrice	Birim fiyatı, Microsoft Müşteri Sözleşmeleri kapsamındaki hizmetler için geçerli değildir.
currencyCode	pricingCurrency	Microsoft Müşteri Sözleşmeleri, fiyatlandırma para birimi ve faturalandırma para birimi için fiyat gösterimlerine sahiptir. currencyCode, Microsoft Müşteri Sözleşmelerindeki pricingCurrency özelliğine karşılık gelir.
offerID	productOrderName	OfferID yerine productOrderName kullanabilirsiniz ancak bu özellik OfferID ile aynı değildir. Ancak productOrderName ve ölçüm, Microsoft Müşteri Sözleşmelerinde eski kayıtlarda meterId ve OfferID ile belirtilen fiyatlandırmayı belirler.

Tüketim Fiyat Listesi API'si işlemleri

Kurumsal Anlaşmalarda subscriptionId veya faturalama dönemi ile kapsam belirleyerek işlemler için Tüketim Fiyat Listesi API'si Al ve Faturalama Dönemine Göre Al işlemlerini kullandınız. API, Azure Resource Management kimlik doğrulamasını kullanır.

Fiyat Listesi API'si ile belirli bir kapsama ait Fiyat Listesi bilgilerini almak için:

Metot	İstek URI'si
GET	https://management.azure.com/subscriptions/{subscriptionId}/providers/Microsoft.Consumption/pricesheets/default?api-version=2018-10-01

Fiyat Listesi API'si ile faturalama dönemine göre Fiyat Listesi bilgilerini almak için:

Metot	İstek URI'si
GET	https://management.azure.com/subscriptions/{subscriptionId}/providers/Microsoft.Billing/billingPeriods/{billingPeriodName}/providers/Microsoft.Consumption/pricesheets/default?api-version=2018-10-01

Microsoft Müşteri Sözleşmeleri için yukarıdaki API uç noktalarının yerine aşağıdakileri kullanın:

Microsoft Müşteri Sözleşmeleri için Fiyat Listesi API'si (zaman uyumsuz REST API'si)

Bu API Microsoft Müşteri Sözleşmesi içindir ve ek öznitelikler sağlar.

Ödeme Hesabındaki Faturalama Profili kapsamı için Fiyat Listesi

Bu API, mevcut API ile aynıdır. Bir ödeme hesabındaki faturalama profili için fiyat listesini sağlayacak şekilde güncelleştirilmiştir.

Kapsam için ödeme hesabına göre Fiyat Listesi

Kayıt kapsamındaki bir ödeme hesabında Fiyat Listesini aldığınızda Azure Resource Manager kimlik doğrulaması kullanılır.

Bir ödeme hesabındaki kayıt hesabında Fiyat Listesini almak için:

Metot	İstek URI'si
GET	/providers/Microsoft.Billing/billingAccounts/65085863/providers/Microsoft.Consumption/pricesheets/download?api-version=2019-01-01

Microsoft Müşteri Sözleşmesi için aşağıdaki bölümde yer alan bilgileri kullanın. Microsoft Müşteri Sözleşmeleri için kullanılan alan özellikleri sunulmuştur.

Ödeme hesabındaki faturalama profili kapsamı için Fiyat Listesi

Güncelleştirilen ödeme hesabına göre Fiyat Listesi API'si, Fiyat Listesini CSV biçiminde alır. Bir MCA için faturalama profili kapsamındaki Fiyat Listesini almak için:

Metot	İstek URI'si
GET	/providers/Microsoft.Billing/billingAccounts/28ae4b7f-41bb-581e-9fa4-8270c857aa5f/billingProfiles/ef37facb-cd6f-437a-9261-65df15b673f9/providers/Microsoft.Consumption/pricesheets/download?api-version=2019-01-01

EA'nın kayıt kapsamında API yanıtı ve özellikleri aynıdır. Özellikler aynı MCA özelliklerine karşılık gelir.

Azure Resource Manager Fiyat Listesi API'leri için kullanılan eski özellikler ve karşılık gelen yeni özellikler aşağıdaki tabloda belirtilmiştir.

Eski Azure Resource Manager Fiyat Listesi API'si Özelliği	Yeni Microsoft Müşteri Sözleşmesi Fiyat Listesi API'si Özelliği	Açıklama
Ölçüm Kimliği	meterId	Ölçümün benzersiz tanımlayıcısı. meterID ile aynıdır.
Ölçüm adı	meterName	Ölçümün adı. Ölçüm, dağıtılabilen Azure hizmeti kaynağını temsil eder.
Ölçüm kategorisi	service	Ölçüm için sınıflandırma kategorisinin adı. Microsoft Müşteri Sözleşmesi Fiyat Listesindeki hizmet ile aynıdır. Tam dize değerleri farklıdır.
Ölçüm alt kategorisi	meterSubCategory	Ölçüm alt sınıflandırma kategorisinin adı. Hizmetteki üst düzey özellik kümesi farkı sınıflandırmasını temel alır. Örneğin Temel SQL Veritabanı ve Standart SQL Veritabanı.
Ölçüm bölgesi	meterRegion
Unit	Geçerli değildir	unitOfMeasure değerinden ayrıştırılabilir.
Ölçü birimi	unitOfMeasure
Parça numarası	Geçerli değildir	Parça numarası yerine productOrderName ve MeterID kullanarak faturalama profiline ait fiyatı benzersiz bir şekilde tanımlayabilirsiniz. MCA faturasında parça numarası yerine alanlar listelenir.
Birim fiyatı	unitPrice	Microsoft Müşteri Sözleşmesi birim fiyatı.
Para birimi kodu	pricingCurrency	Microsoft Müşteri Sözleşmeleri, fiyatları fiyatlandırma para birimi ve faturalandırma para birimi ile gösterir. Para birimi kodu, Microsoft Müşteri Sözleşmelerindeki pricingCurrency ile aynıdır.
Dahil edilen miktar	includedQuantity	Microsoft Müşteri Sözleşmeleri kapsamındaki hizmetler için geçerli değildir. Sıfır değerleriyle gösterilir.
Teklif Kimliği	productOrderName	OfferID yerine productOrderName kullanın. OfferID ile aynı değildir ancak productOrderName ve ölçüm, Microsoft Müşteri Sözleşmelerindeki fiyatlandırmayı belirler. Eski kayıtlardaki meterId ve OfferID ile ilgilidir.

Microsoft Müşteri Sözleşmelerinin fiyatı, Kurumsal Anlaşmalardan farklı bir şekilde tanımlanır. Kurumsal kayıttaki hizmetlerin fiyatı ürün, parça numarası, ölçüm ve teklif için benzersizdir. Parça numarası, Microsoft Müşteri Sözleşmelerinde kullanılmaz.

Microsoft Müşteri Sözleşmesinin bir parçası olan Azure Tüketim hizmeti fiyatı, productOrderName ve meterID için benzersizdir. Bunlar hizmet ölçümünü ve ürün planını temsil eder.

Fiyat listesi ile Kullanım Ayrıntıları API'sindeki kullanımı mutabık kılmak için productOrderName ve meterID kullanabilirsiniz.

Faturalama profili için sahip, katkıda bulunan, okuyucu ve fatura yöneticisi haklarına sahip olan kullanıcılar fiyat listesini indirebilir.

Fiyat listesi, kullanıma göre fiyatlandırılan hizmetlerin listesini içerir. Hizmetler Azure tüketimini ve Market tüketimini kapsar. Her hizmet döneminin sonundaki en son fiyat kilitlenir ve tek bir hizmet dönemindeki kullanıma uygulanır. Azure tüketim hizmetlerinde hizmet süresi genellikle bir takvim ayıdır.

Kullanımdan Kaldırılan Fiyat Listesi API'si alanları

Aşağıdaki alanlar, Microsoft Müşteri Sözleşmesi Fiyat Listesi API'lerinde mevcut değildir veya değiştirilmemiştir.

Kullanımdan kaldırılan alan	Açıklama
billingPeriodId	Geçerli değil. MCA için InvoiceId alanına karşılık gelir.
offerID	Uygulanamaz. MCA için productOrderName alanına karşılık gelir.
meterCategory	Uygulanamaz. MCA için Service alanına karşılık gelir.
unit	Uygulanamaz. unitOfMeasure değerinden ayrıştırılabilir.
currencyCode	MCA içindeki pricingCurrency ile aynıdır.
meterLocation	MCA içindeki meterRegion ile aynıdır.
partNumber	MCA faturalarında parça numarası listelenmediğinden geçerli değildir. Fiyatları benzersiz bir şekilde tanımlamak için bölüm numarası yerine meterId ve productOrderName birleşimini kullanın.
totalIncludedQuantity	Uygulanamaz.
pretaxStandardRate	Uygulanamaz.

Ayrılmış Örnek Ücretlendirme API'si değiştirildi

Satın alınan rezervasyonlara ait faturalandırma işlemlerini Ayrılmış Örnek Ücretlendirme API'si ile alabilirsiniz. Yeni API, üçüncü taraf Market teklifleri dahil olmak üzere tüm satın alma işlemlerini kapsar. Tüm Tüketim API'leri, kimlik doğrulaması ve yetkilendirme için Microsoft Entra Id kullanan yerel Azure API'leri ile değiştirilir. Azure REST API'lerini çağırma hakkında daha fazla bilgi için bkz. REST'i kullanmaya başlama. Ayrılmış Örnek Ücretlendirme API'si, İşlemler API'si ile değiştirilmiştir.

İşlemler API'si ile rezervasyon satın alma işlemlerini almak için:

Metot	İstek URI'si
GET	https://management.azure.com/providers/Microsoft.Billing/billingAccounts/{billingAccountId}/billingProfiles/{billingProfileId}/transactions?api-version=2018-11-01-preview

Öneriler API'si değiştirildi

Ayrılmış Örnek Satın Alma Önerileri API'leri son 7, 30 veya 60 gün içindeki sanal makine kullanımını sunar. API'ler ayrıca rezervasyon satın alma önerileri de sunar. Bu ölçümler şunlardır:

• Paylaşılan Ayrılmış Örnek Öneri API'si
• Tek Ayrılmış Örnek Öneri API'si

Tüm Tüketim API'leri, kimlik doğrulaması ve yetkilendirme için Microsoft Entra Id kullanan yerel Azure API'leri ile değiştirilir. Azure REST API'lerini çağırma hakkında daha fazla bilgi için bkz. REST'i kullanmaya başlama. Önceden listelenen rezervasyon öneri API'leri Microsoft.Consumption/reservationRecommendations API'si ile değiştirilmiştir.

Rezervasyon Önerileri API'si ile rezervasyon önerileri almak için:

Metot	İstek URI'si
GET	https://management.azure.com/providers/Microsoft.Consumption/reservationRecommendations?api-version=2019-01-01

Rezervasyon Kullanımı API'leri değiştirildi

Ayrılmış Örnek Kullanımı API'si ile bir kayıt içindeki rezervasyon kullanımını alabilirsiniz. Kayıtta birden fazla rezervasyon örneği varsa bu API'yi kullanarak tüm rezervasyon örneği satın alma işlemlerinin kullanımını da alabilirsiniz.

Bu ölçümler şunlardır:

• Ayrılmış Örnek Kullanımı Ayrıntıları
• Ayrılmış Örnek Kullanımı Özeti

Tüm Tüketim API'leri, kimlik doğrulaması ve yetkilendirme için Microsoft Entra Id kullanan yerel Azure API'leri ile değiştirilir. Azure REST API'lerini çağırma hakkında daha fazla bilgi için bkz. REST'i kullanmaya başlama. Önceden listelenen rezervasyon öneri API'leri Microsoft.Consumption/reservationDetails ve Microsoft.Consumption/reservationSummaries API'leri ile değiştirilmiştir.

Rezervasyon Ayrıntıları API'si ile rezervasyon ayrıntılarını almak için:

Metot	İstek URI'si
GET	https://management.azure.com/providers/Microsoft.Consumption/reservationDetails?api-version=2019-01-01

Rezervasyon Özetleri API'si ile rezervasyon özetlerini almak için:

Metot	İstek URI'si
GET	https://management.azure.com/providers/Microsoft.Consumption/reservationSummaries?api-version=2019-01-01

Power BI tümleştirmesi

Maliyet raporlama için Power BI'ı da kullanabilirsiniz. Power BI Desktop için Maliyet Yönetimi bağlayıcısı, Azure harcamalarınızı daha iyi anlamanıza yardımcı olacak güçlü, özelleştirilmiş raporlar oluşturmak için kullanılabilir. Maliyet Yönetimi bağlayıcısı şu anda Microsoft Müşteri Sözleşmesi veya Kurumsal Anlaşma (EA) olan müşterileri desteklemektedir.

İlgili içerik

• Azure harcamalarınızı izleme ve denetleme hakkında bilgi edinmek için Maliyet Yönetimi belgelerini okuyun. Bu belgelerden Maliyet Yönetimi ile kaynak kullanımını iyileştirme yöntemlerini de öğrenebilirsiniz.