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, 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.
Jeśli używasz interfejsu API Szczegółów użycia użycia, zalecamy, ale nie musisz migrować do interfejsu API szczegółów kosztów usługi Cost Management.
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.
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ć 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:
{
"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 |
| 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 | 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. 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:
{
"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 |
| 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.