Migrowanie z interfejsu API szczegółów użycia użycia

W tym artykule omówiono migrację z dala od interfejsu API szczegółów użycia użycia. Interfejs API szczegółów użycia użycia jest przestarzały. Data wyłączenia interfejsu API jest nadal określana. Zalecamy jak najszybszą migrację z interfejsu API.

Miejsca docelowe migracji

Zapoznaj się z artykułem Wybieranie rozwiązania szczegółów kosztów przed wybraniem odpowiedniego rozwiązania dla obciążenia. Ogólnie rzecz biorąc, zalecamy eksporty, jeśli masz bieżące potrzeby dotyczące pozyskiwania danych i zestaw danych z dużymi miesięcznymi szczegółami użycia. Aby uzyskać więcej informacji, zobacz Pozyskiwanie danych szczegółów użycia.

Jeśli masz mniejszy zestaw danych szczegółów użycia lub scenariusz, który nie jest spełniony przez eksporty, rozważ użycie raportu Szczegóły kosztów. Aby uzyskać więcej informacji, zobacz Pobieranie zestawów danych o małych kosztach na żądanie.

Uwaga

Raport Szczegóły kosztów jest dostępny tylko dla klientów z Umowa Enterprise lub Umowa z Klientem Microsoft. Jeśli masz subskrypcję MSDN, płatności zgodnie z rzeczywistym użyciem lub programu Visual Studio, możesz przeprowadzić migrację do obszaru Eksporty lub kontynuować korzystanie z interfejsu API szczegółów użycia użycia.

Korzyści z migracji

Nowe rozwiązania zapewniają wiele korzyści w interfejsie API szczegółów użycia użycia. Oto podsumowanie:

• Pojedynczy zestaw danych dla wszystkich szczegółów użycia — szczegóły użycia platformy Azure i witryny Azure Marketplace zostały scalone z jednym zestawem danych. Zmniejsza liczbę interfejsów API, które należy wywołać, aby wyświetlić wszystkie opłaty.
• Skalowalność — interfejs API witryny Marketplaces jest przestarzały, ponieważ promuje wzorzec wywołań, który nie może być skalowany w miarę wzrostu użycia platformy Azure. Zestaw danych szczegółów użycia może być bardzo duży, ponieważ wdrażasz więcej zasobów w chmurze. Interfejs API marketplaces to synchroniczny interfejs API podzielony na strony, więc nie jest zoptymalizowany pod kątem efektywnego przesyłania dużych ilości danych za pośrednictwem sieci z wysoką wydajnością i niezawodnością. Eksporty i interfejs API szczegółów kosztów są asynchroniczne. Udostępniają one plik CSV, który można pobrać bezpośrednio za pośrednictwem sieci.
• Ulepszenia interfejsu API — eksporty i interfejs API szczegółów kosztów to rozwiązania, które pomoc techniczna platformy Azure w przyszłości. Wszystkie nowe funkcje są w nich zintegrowane.
• Spójność schematu — raport Szczegóły kosztów i eksporty udostępniają pliki pasującym polami, które można przenieść z jednego rozwiązania do drugiego na podstawie scenariusza.
• Integracja alokacji kosztów — Umowa Enterprise i Umowa z Klientem Microsoft klienci korzystający z funkcji Eksporty lub interfejs API szczegółów kosztów mogą wyświetlać opłaty w odniesieniu do skonfigurowanych reguł alokacji kosztów. Aby uzyskać więcej informacji na temat alokacji kosztów, zobacz Przydzielanie kosztów.

Różnice pól

W poniższej tabeli podsumowano różnice pól między interfejsem API Szczegółów użycia użycia a interfejsem API Eksporty/Szczegóły kosztów. Eksporty i interfejs API szczegółów kosztów udostępniają plik CSV do pobrania zamiast odpowiedzi JSON podzielonej na strony, która jest dostarczana przez interfejs API użycia.

mapowanie pól Umowa Enterprise

Umowa Enterprise klienci korzystający z interfejsu API Szczegółów użycia użycia mają rekordy szczegółów użycia tego typulegacy. Poniżej przedstawiono starszy rekord szczegółów użycia. Wszyscy klienci Umowa Enterprise mają rekordy tego rodzaju ze względu na bazowy system rozliczeniowy, który jest dla nich używany.

{  

  "value": [  

      {  

          "id": "{id}", 

          "name": "{name}",  

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

          "kind": "legacy",  

          "tags": {  

               "env": "newcrp",  

               "dev": "tools"  

          },  

          "properties": {  

…... 

      } 

} 

Pełny przykład starszego rekordu Szczegóły użycia jest wyświetlany w sekcji Szczegóły użycia — lista — interfejs API REST (Użycie platformy Azure)

Poniższa tabela zawiera mapowanie między starymi i nowymi polami. Nowe właściwości są dostępne w plikach CSV utworzonych przez eksporty i interfejs API szczegółów kosztów. Aby dowiedzieć się więcej o polach, zobacz Omówienie pól szczegółów użycia.

Nazwy właściwości pogrubionych są niezmienione.

Stara właściwość	Nowa właściwość
accountName	AccountName
AccountOwnerId	AccountOwnerId
additionalInfo	AdditionalInfo
Strefa dostępności	AvailabilityZone
billingAccountId	BillingAccountId
billingAccountName	BillingAccountName
billingCurrency	BillingCurrencyCode
billingPeriodEndDate	BillingPeriodEndDate
billingPeriodStartDate	BillingPeriodStartDate
billingProfileId	BillingProfileId
billingProfileName	BillingProfileName
chargeType	ChargeType
consumedService	ConsumedService
cost	CostInBillingCurrency
costCenter	CostCenter
data	Data
effectivePrice	EffectivePrice
frequency	Częstotliwość
invoiceSection	InvoiceSectionName
InvoiceSectionId	InvoiceSectionId
isAzureCreditEligible	IsAzureCreditEligible
meterCategory	MeterCategory
meterId	MeterId
meterName	MeterName
MeterRegion	MeterRegion
meterSubCategory	MeterSubCategory
offerId	Identyfikator oferty
partNumber	PartNumber
PayGPrice	PayGPrice
Nazwa planu	PlanName
Model cenowy	PricingModel
product	ProductName
ProductOrderId	ProductOrderId
ProductOrderName	ProductOrderName
Publishername	PublisherName
Publishertype	PublisherType
ilość	Ilość
Identyfikator rezerwacji	ReservationId
Nazwa rezerwacji	ReservationName
resourceGroup	ResourceGroup
resourceId	ResourceId
resourceLocation	ResourceLocation
resourceName	ResourceName
serviceFamily	ServiceFamily
ServiceInfo1	ServiceInfo1
ServiceInfo2	ServiceInfo2
subscriptionId	SubscriptionId
subscriptionName	SubscriptionName
Tagi	Tagi
Termin	Termin
unitOfMeasure	UnitOfMeasure
unitPrice	UnitPrice
CostAllocationRuleName	CostAllocationRuleName

mapowanie pól Umowa z Klientem Microsoft

Umowa z Klientem Microsoft klienci korzystający z interfejsu API Szczegółów użycia użycia mają rekordy szczegółów użycia tego typumodern. Poniżej przedstawiono nowoczesny rekord szczegółów użycia. Wszystkie Umowa z Klientem Microsoft klienci mają rekordy tego rodzaju ze względu na bazowy system rozliczeniowy, który jest dla nich używany.

{  

  "value": [  

      {  

          "id": "{id}", 

          "name": "{name}",  

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

          "kind": "modern",  

          "tags": {  

               "env": "newcrp",  

               "dev": "tools"  

          },  

          "properties": {  

…... 

      } 

} 

Pełny przykład starszego rekordu Szczegóły użycia jest wyświetlany w sekcji Szczegóły użycia — lista — interfejs API REST (Użycie platformy Azure)

W poniższej tabeli przedstawiono mapowanie między starymi i nowymi polami. Nowe właściwości są dostępne w plikach CSV utworzonych przez eksporty i interfejs API szczegółów kosztów. Pola, które wymagają mapowania ze względu na różnice w rozwiązaniach, są wyświetlane w tekście pogrubionym.

Aby uzyskać więcej informacji, zobacz Omówienie pól szczegółów użycia.

Stara właściwość	Nowa właściwość
invoiceId	invoiceId
previousInvoiceId	previousInvoiceId
billingAccountId	billingAccountId
billingAccountName	billingAccountName
billingProfileId	billingProfileId
billingProfileName	billingProfileName
invoiceSectionId	invoiceSectionId
invoiceSectionName	invoiceSectionName
partnerTenantId	partnerTenantId
partnerName	partnerName
resellerName	resellerName
resellerMpnId	resellerMpnId
customerTenantId	customerTenantId
Customername	Customername
costCenter	costCenter
billingPeriodEndDate	billingPeriodEndDate
billingPeriodStartDate	billingPeriodStartDate
servicePeriodEndDate	servicePeriodEndDate
servicePeriodStartDate	servicePeriodStartDate
data	data
serviceFamily	serviceFamily
productOrderId	productOrderId
productOrderName	productOrderName
consumedService	consumedService
meterId	meterId
meterName	meterName
meterCategory	meterCategory
meterSubCategory	meterSubCategory
meterRegion	meterRegion
productIdentifier	Productid
Produktu	Productname
subscriptionGuid	Subscriptionid
subscriptionName	subscriptionName
publisherType	publisherType
publisherId	publisherId
publisherName	publisherName
resourceGroup	resourceGroupName
Instancename	ResourceId
resourceLocationNormalized	location
resourceLocation	location
effectivePrice	effectivePrice
ilość	ilość
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
tags	tags
partnerEarnedCreditRate	partnerEarnedCreditRate
partnerEarnedCreditApplied	partnerEarnedCreditApplied
marketPrice	PayGPrice
frequency	frequency
Termin	Termin
reservationId	reservationId
reservationName	reservationName
pricingModel	pricingModel
unitPrice	unitPrice
exchangeRatePricingToBilling	exchangeRatePricingToBilling

Powiązana zawartość

• Dowiedz się więcej na temat automatyzacji zarządzania kosztami i rozliczeń w sekcji Omówienie automatyzacji zarządzania kosztami.