Migrálás a Consumption Usage Details API-ból

Ez a cikk a Használati adatok API-ból való migrálást ismerteti. A Consumption Usage Details API elavult. Az API kikapcsolásának dátuma még mindig meg van határozva. Javasoljuk, hogy mihamarabb migráljon az API-ból.

Migrálási célhelyek

Mielőtt eldöntené, hogy melyik megoldás megfelelő a számítási feladathoz, olvassa el a Költség részleteinek kiválasztása című cikket . Általában az Exportálást javasoljuk, ha folyamatban van az adatbetöltési igény, vagy ha nagy havi használati adatokra van szüksége. További információ: Betöltési használati adatok.

Ha kisebb használatiadat-adatkészlete van, vagy olyan forgatókönyve van, amely nem felel meg az Exportnak, fontolja meg inkább a Költségadatok jelentés használatát. További információ: Kis költségű adathalmazok igény szerinti lekérése.

Feljegyzés

A Költség részletei jelentés csak Nagyvállalati Szerződés vagy Microsoft Ügyfélszerződés rendelkező ügyfelek számára érhető el. Ha MSDN-, használatalapú fizetéses vagy Visual Studio-előfizetéssel rendelkezik, migrálhat az Exportálásra, vagy folytathatja a Használat használati adatai API használatát.

A migrálás előnyei

Az új megoldások számos előnnyel járnak a Consumption Usage Details API-val szemben. Íme egy összegzés:

• Egyetlen adatkészlet minden használati adathoz – Az Azure és az Azure Marketplace használati adatait egyetlen adatkészletbe egyesítették. Csökkenti az összes díj megtekintéséhez meghívandó API-k számát.
• Méretezhetőség – A Marketplaces API elavult, mert előléptet egy hívásmintát, amely nem képes skálázni az Azure-használat növekedésével. A használati adatok adathalmaza rendkívül nagy méretű lehet, amikor több erőforrást helyez üzembe a felhőben. A Marketplaces API egy többoldalas szinkron API, így nem úgy van optimalizálva, hogy nagy mennyiségű adatot hatékonyan továbbítson egy nagy hatékonyságú és megbízhatóságú hálózaton. Az exportálás és a Cost Details API aszinkron. Egy CSV-fájlt biztosítanak, amely közvetlenül a hálózaton keresztül tölthető le.
• API-fejlesztések – Az export és a Cost Details API a Azure-támogatás előremutató megoldások. Minden új funkció integrálva van bennük.
• Sémakonzisztencia – A Költség részletei jelentés és az Exportálás olyan fájlokat biztosít, amelyeken egyező mezők találhatók, és a forgatókönyv alapján az egyik megoldásból a másikba léphet.
• Költségfelosztási integráció – Nagyvállalati Szerződés és Microsoft Ügyfélszerződés az Export vagy a Cost Details API-t használó ügyfelek megtekinthetik az általuk konfigurált költségfelosztási szabályokkal kapcsolatos díjakat. A költségfelosztásról további információt a Költségek lefoglalása című témakörben talál.

Mezőkülönbségek

Az alábbi táblázat összefoglalja a Használati adatok API és az Export/Cost Details API közötti mezőkülönbségeket. Az Export és a Cost Details API a Használat API által biztosított lapszámozott JSON-válasz helyett CSV-fájlletöltést biztosít.

Nagyvállalati Szerződés mezőleképezés

Nagyvállalati Szerződés Használat részletei API-t használó ügyfeleknek ilyen típusú használati adatokkal kell rendelkezniüklegacy. A korábbi használati adatok rekordja alább látható. Minden Nagyvállalati Szerződés ügyfél rendelkezik ilyen típusú rekordokkal a hozzájuk használt mögöttes számlázási rendszer miatt.

{  

  "value": [  

      {  

          "id": "{id}", 

          "name": "{name}",  

          "type": "Microsoft.Consumption/usageDetails",  

          "kind": "legacy",  

          "tags": {  

               "env": "newcrp",  

               "dev": "tools"  

          },  

          "properties": {  

…... 

      } 

} 

Az örökölt Használati adatok rekord teljes példája a Használati adatok – Lista – REST API (Azure-használat)

Az alábbi táblázat a régi és az új mezők közötti leképezést tartalmazza. Az export által létrehozott CSV-fájlokban és a Cost Details API-ban új tulajdonságok érhetők el. A mezőkkel kapcsolatos további információkért tekintse meg a használati adatok mezőit.

A félkövér tulajdonságnevek nem változnak.

Régi tulajdonság	Új tulajdonság
accountName	AccountName
AccountOwnerId	AccountOwnerId
additionalInfo	További információk (Info)
Rendelkezésre állási zóna	Rendelkezésre állási zóna
billingAccountId	BillingAccountId
billingAccountName	BillingAccountName
billingCurrency	BillingCurrencyCode
billingPeriodEndDate	BillingPeriodEndDate
billingPeriodStartDate	BillingPeriodStartDate
billingProfileId	BillingProfileId
billingProfileName	BillingProfileName
chargeType	ChargeType
consumedService	ConsumedService
cost	CostInBillingCurrency
costCenter	CostCenter
dátum:	Dátum
effectivePrice	EffectivePrice
frequency	Gyakoriság
invoiceSection	InvoiceSectionName
InvoiceSectionId	InvoiceSectionId
isAzureCreditEligible	IsAzureCreditEligible
meterCategory	MeterCategory
meterId	MeterId
meterName	MeterName
MeterRegion	MeterRegion
meterSubCategory	MeterSubCategory
offerId	OfferId
partNumber	Cikkszám
PayGPrice	PayGPrice
PlanName	PlanName
PricingModel	PricingModel
product	ProductName
ProductOrderId	ProductOrderId
ProductOrderName	ProductOrderName
PublisherName	Közzétevő neve
PublisherType	PublisherType
mennyiség	Mennyiség
ReservationId	Foglalásazonosító
ReservationName	ReservationName
resourceGroup	ResourceGroup
resourceId	ResourceId
resourceLocation	ResourceLocation
resourceName	ResourceName nevű erőforrásáról
serviceFamily	ServiceFamily
ServiceInfo1	ServiceInfo1
ServiceInfo2	ServiceInfo2
subscriptionId	SubscriptionId
subscriptionName	SubscriptionName
Címkék	Címkék
Időszak	Időszak
unitOfMeasure	UnitOfMeasure
unitPrice	Egységár
CostAllocationRuleName	CostAllocationRuleName

Microsoft Ügyfélszerződés mezőleképezés

Microsoft Ügyfélszerződés Használat részletei API-t használó ügyfeleknek ilyen típusú modernhasználatiadat-rekordokkal kell rendelkezniük. Az alábbiakban egy modern használati adatokat tartalmazó rekord látható. Minden Microsoft Ügyfélszerződés ügyfél rendelkezik ilyen típusú rekordokkal a hozzájuk használt mögöttes számlázási rendszer miatt.

{  

  "value": [  

      {  

          "id": "{id}", 

          "name": "{name}",  

          "type": "Microsoft.Consumption/usageDetails",  

          "kind": "modern",  

          "tags": {  

               "env": "newcrp",  

               "dev": "tools"  

          },  

          "properties": {  

…... 

      } 

} 

Az örökölt Használati adatok rekord teljes példája a Használati adatok – Lista – REST API (Azure-használat)

A régi és az új mezők közötti megfeleltetés az alábbi táblázatban látható. Az export által létrehozott CSV-fájlokban és a Cost Details API-ban új tulajdonságok érhetők el. A megoldások közötti különbségek miatt leképezésre szoruló mezők félkövér szövegben jelennek meg.

További információ: Használati adatok mezőinek ismertetése.

Régi tulajdonság	Új tulajdonság
invoiceId	invoiceId
previousInvoiceId	previousInvoiceId
billingAccountId	billingAccountId
billingAccountName	billingAccountName
billingProfileId	billingProfileId
billingProfileName	billingProfileName
invoiceSectionId	invoiceSectionId
invoiceSectionName	invoiceSectionName
partnerTenantId	partnerTenantId
partnerNév	partnerNév
resellerName	resellerName
resellerMpnId	resellerMpnId
customerTenantId	customerTenantId
customerName	customerName
costCenter	costCenter
billingPeriodEndDate	billingPeriodEndDate
billingPeriodStartDate	billingPeriodStartDate
servicePeriodEndDate	servicePeriodEndDate
servicePeriodStartDate	servicePeriodStartDate
dátum:	dátum:
serviceFamily	serviceFamily
productOrderId	productOrderId
productOrderName	productOrderName
consumedService	consumedService
meterId	meterId
meterName	meterName
meterCategory	meterCategory
meterSubCategory	meterSubCategory
meterRegion	meterRegion
productIdentifier	Termelés
Termék	Productname
subscriptionGuid	SubscriptionId
subscriptionName	subscriptionName
publisherType	publisherType
publisherId	publisherId
publisherName	publisherName
resourceGroup	resourceGroupName
instanceName	ResourceId
resourceLocationNormalized	hely
resourceLocation	hely
effectivePrice	effectivePrice
mennyiség	mennyiség
unitOfMeasure	unitOfMeasure
chargeType	chargeType
billingCurrencyCode	billingCurrency
pricingCurrencyCode	pricingCurrency
costInBillingCurrency	costInBillingCurrency
costInPricingCurrency	costInPricingCurrency
costInUsd	costInUsd
paygCostInBillingCurrency	paygCostInBillingCurrency
paygCostInUSD	paygCostInUsd
exchangeRatePricingToBilling	exchangeRatePricingToBilling
exchangeRateDate	exchangeRateDate
isAzureCreditEligible	isAzureCreditEligible
serviceInfo1	serviceInfo1
serviceInfo2	serviceInfo2
additionalInfo	additionalInfo
címkét	címkét
partnerEarnedCreditRate	partnerEarnedCreditRate
partnerEarnedCreditApplied	partnerEarnedCreditApplied
marketPrice	PayGPrice
frequency	frequency
Kifejezés	Kifejezés
reservationId	reservationId
reservationName	reservationName
pricingModel	pricingModel
unitPrice	unitPrice
exchangeRatePricingToBilling	exchangeRatePricingToBilling

Kapcsolódó tartalom

• További információ a Cost Management + Számlázás automatizálásáról a Cost Management automatizálási áttekintésében.