Migrowanie z interfejsu API szczegółów użycia użycia
Artykuł
W tym artykule omówiono migrację z dala od interfejsu API szczegółów użycia użycia, który jest planowany do wycofania. Dokładna data wycofania jest nadal określana. Zalecamy, aby potoki raportowania nie tworzyć przy użyciu tego interfejsu API i migrować z niego tak szybko, jak to możliwe.
Interfejsy API raportowania Umowa Enterprise (EA), które używają klucza interfejsu API do uwierzytelniania i są dostępne za pośrednictwem punktu końcowego identyfikatora URI consumption.azure.com, są wycofywane. Klienci z umowami EA korzystający z tych interfejsów API powinni przeprowadzić migrację do interfejsu API Cost Details usługi Cost Management. Te starsze interfejsy API raportowania umowy EA są dostępne tylko dla klientów z Umowa Enterprise.
Interfejsy API użycia i usługi Cost Management są dostępne zarówno dla klientów z umową EA Umowa z Klientem Microsoft (MCA). W związku z tym klienci platformy Azure Government, którzy pozostają w ramach umowy EA, nie mają negatywnego wpływu.
Podczas migracji z umowy EA do umowy MCA zalecamy przejście z interfejsu API szczegółów użycia raportowania umowy EA do interfejsu API szczegółów kosztów usługi Cost Management i użycie funkcji Eksporty.
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.
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ć 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 przez nich 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. Wszyscy klienci Umowa Enterprise mają rekordy tego rodzaju ze względu na bazowy system rozliczeniowy, który jest dla nich używany. Oto przykładowy starszy rekord szczegółów użycia:
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
Nazwa wydawcy
PublisherName
Typ wydawcy
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
Term
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. Wszystkie Umowa z Klientem Microsoft klienci mają rekordy tego rodzaju ze względu na bazowy system rozliczeniowy, który jest dla nich używany. Oto przykładowy rekord szczegółów użycia umowy MCA:
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
produkt
ProductName
subscriptionGuid
Identyfikator subskrypcji
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.