Udostępnij za pośrednictwem

Migrowanie z interfejsów API szczegółów użycia umowy EA

  • Artykuł

Klienci z umową EA, którzy wcześniej używali interfejsów API raportowania przedsiębiorstwa za punktem końcowym consumption.azure.com w celu uzyskania szczegółów użycia i opłat za korzystanie z platformy Handlowej, muszą przeprowadzić migrację do nowych i ulepszonych rozwiązań. Instrukcje przedstawiono poniżej wraz z różnicami kontraktów między starym interfejsem API a nowymi rozwiązaniami.

Zestaw danych jest określany jako szczegóły kosztów zamiast szczegółów użycia.

Uwaga

Wszystkie interfejsy API raportowania przedsiębiorstwa platformy Azure są wycofane. Jak najszybciej należy przeprowadzić migrację do interfejsów API usługi Microsoft Cost Management.

Nowe rozwiązania są ogólnie dostępne

Poniższa tabela zawiera podsumowanie miejsc docelowych migracji, które są dostępne wraz z podsumowaniem tego, co należy wziąć pod uwagę podczas wybierania najlepszego rozwiązania.

Rozwiązanie opis Zagadnienia do rozważenia Informacje o dołączaniu
Eksporty Cykliczne zrzuty danych do magazynu zgodnie z harmonogramem — najbardziej skalowalne rozwiązanie dla obciążeń.
— Można skonfigurować do używania partycjonowania plików dla większych zestawów danych.
— Doskonałe rozwiązanie do tworzenia i zwiększania kosztów zestawu danych, który można zintegrować z własnymi magazynami danych z możliwością wykonywania zapytań.
—Wymaga dostępu do konta magazynu, które może przechowywać dane.		 - Konfigurowanie w witrynie Azure Portal
Automatyzowanie tworzenia eksportu za pomocą interfejsu API
- Eksportowanie dokumentacji interfejsu API
Interfejs API szczegółów kosztów Pobieranie na żądanie — Przydatne w przypadku zestawów danych o małych kosztach.
— Przydatne w scenariuszach, w których eksporty do usługi Azure Storage nie są możliwe ze względu na problemy z zabezpieczeniami lub możliwościami zarządzania.		 - Uzyskiwanie niewielkich kosztów zestawów danych na żądanie
- Interfejs API szczegółów kosztów

Ogólnie rzecz biorąc zalecamy używanie funkcji Eksporty , jeśli masz bieżące potrzeby dotyczące pozyskiwania danych i/lub duży zestaw danych szczegółów kosztów miesięcznych. Aby uzyskać więcej informacji, zobacz Pozyskiwanie danych szczegółów kosztów. Jeśli potrzebujesz dodatkowych informacji, aby ułatwić podjęcie decyzji o obciążeniu, zobacz Wybieranie rozwiązania szczegółów kosztów.

Przypisywanie uprawnień do głównej nazwy usługi w celu wywoływania interfejsów API

Jeśli chcesz programowo wywołać interfejsy API Eksporty lub Szczegóły kosztów, musisz skonfigurować jednostkę usługi z poprawnym uprawnieniem. Aby uzyskać więcej informacji, zobacz Przypisywanie uprawnień do interfejsów API usługi ACM.

Unikaj interfejsu API szczegółów użycia użycia firmy Microsoft

Interfejs API szczegółów użycia użycia to kolejny punkt końcowy, który obecnie obsługuje klientów z umową EA. Nie należy migrować do tego interfejsu API. Przeprowadź migrację do eksportu lub interfejsu API szczegółów kosztów, jak opisano wcześniej w tym dokumencie. Interfejs API szczegółów użycia użycia będzie przestarzały w przyszłości i znajduje się za następującym punktem końcowym.

GET https://management.azure.com/{scope}/providers/Microsoft.Consumption/usageDetails?api-version=2021-10-01

Ten interfejs API jest synchronicznym punktem końcowym i nie będzie mógł skalować zarówno w miarę wzrostu wydatków, jak i rozmiaru miesiąca w zestawie danych kosztów w miesiącu. Jeśli obecnie używasz interfejsu API Szczegółów użycia użycia, zalecamy jak najszybsze migrację z niego do dowolnego eksportu interfejsu API szczegółów kosztów. Oficjalne ogłoszenie o wycofaniu zostanie ogłoszone w przyszłości. Aby dowiedzieć się więcej na temat migrowania z dala od szczegółów użycia użycia, zobacz Migrowanie z interfejsu API szczegółów użycia użycia.

Korzyści z migracji

Nasze nowe rozwiązania zapewniają wiele korzyści w zakresie interfejsów API szczegółów użycia raportowania UMOWY EA. Oto podsumowanie:

  • Bezpieczeństwo i stabilność — nowe rozwiązania wymagają tokenów jednostki usługi i/lub użytkownika w celu uzyskania dostępu do danych. Są one bezpieczniejsze niż klucze interfejsu API używane do uwierzytelniania w interfejsach API raportowania EA. Klucze w tych starszych interfejsach API są ważne przez sześć miesięcy i mogą uwidaczniać poufne dane finansowe w przypadku wycieku. Ponadto, jeśli klucze nie zostaną odnowione i zintegrowane z obciążeniami przed upływem sześciu miesięcy, dostęp do danych zostanie odwołany. Spowoduje to przerwanie obciążeń klientów.
  • Skalowalność — interfejsy API raportowania EA nie są kompilowane do skalowania, a użycie platformy Azure zwiększa się. Zestaw danych szczegółów użycia może być bardzo duży, ponieważ wdrażasz więcej zasobów w chmurze. Nowe rozwiązania są asynchroniczne i mają za sobą rozbudowane ulepszenia infrastruktury w celu zapewnienia pomyślnych pobrań dla dowolnego zestawu danych o rozmiarze.
  • 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 w nowych rozwiązaniach. Pojedynczy zestaw danych zmniejsza liczbę interfejsów API, które należy wywołać, aby wyświetlić wszystkie opłaty.
  • Amortyzacja zakupów — klienci, którzy kupują rezerwacje, mogą zobaczyć zamortyzowany widok kosztów przy użyciu nowych rozwiązań.
  • Spójność schematu — każde dostępne rozwiązanie zapewnia pliki z pasującymi polami. Umożliwia łatwe przechodzenie między rozwiązaniami w zależności od scenariusza.
  • Integracja alokacji kosztów — Umowa Enterprise i Umowa z Klientem Microsoft klienci mogą używać nowego rozwiązania do wyświetlania opłat w odniesieniu do skonfigurowanych przez nich reguł alokacji kosztów. Aby uzyskać więcej informacji na temat alokacji kosztów, zobacz Przydzielanie kosztów.
  • Ulepszenia w przyszłości — nowe rozwiązania są aktywnie opracowywane w przyszłości. W miarę ich wydawania rozwiązania otrzymują wszystkie nowe funkcje.

Interfejsy API użycia przedsiębiorstwa do migracji

W poniższej tabeli podsumowano różne interfejsy API, których możesz używać dzisiaj do pozyskiwania danych szczegółów kosztów. Jeśli używasz jednego z następujących interfejsów API, musisz przeprowadzić migrację do jednego z nowych rozwiązań opisanych wcześniej. Wszystkie interfejsy API znajdują się za https://consumption.azure.com punktem końcowym.

Punkt końcowy Komentarze interfejsu API
/v3/enrollments/{enrollmentNumber}/usagedetails/download?billingPeriod={billingPeriod} - Metoda interfejsu API: GET
- Synchroniczne (bez sondowania)
- Format danych: CSV
/v3/enrollments/{enrollmentNumber}/usagedetails/download?startTime=2017-01-01&endTime=2017-01-10 - Metoda interfejsu API: GET
- Synchroniczne (bez sondowania)
- Format danych: CSV
/v3/enrollments/{enrollmentNumber}/usagedetails - Metoda interfejsu API: GET
- Synchroniczne (bez sondowania)
- Format danych: JSON
/v3/enrollments/{enrollmentNumber}/billingPeriods/{billingPeriod}/usagedetails - Metoda interfejsu API: GET
- Synchroniczne (bez sondowania)
- Format danych: JSON
/v3/enrollments/{enrollmentNumber}/usagedetailsbycustomdate?startTime=2017-01-01&endTime=2017-01-10 - Metoda interfejsu API: GET
- Synchroniczne (bez sondowania)
- Format danych: JSON
/v3/enrollments/{enrollmentNumber}/usagedetails/submit?billingPeriod={billingPeriod} - Metoda interfejsu API: POST
- Asynchroniczne (oparte na sondowaniu)
- Format danych: CSV
/v3/enrollments/{enrollmentNumber}/usagedetails/submit?startTime=2017-04-01&endTime=2017-04-10 - Metoda interfejsu API: POST
- Asynchroniczne (oparte na sondowaniu)
- Format danych: CSV

Mapowanie pól danych

Poniższa tabela zawiera podsumowanie starych pól dostępnych w aktualnie używanych rozwiązaniach wraz z polem do użycia w nowych rozwiązaniach.

Stare pole Nowe pole Komentarze
accountId Niedostępne — użyj nazwy konta, aby uzyskać informacje o koncie.
accountName AccountName
accountOwnerEmail AccountOwnerId
additionalInfo AdditionalInfo
chargesBilledSeparately isAzureCreditEligible Właściwości są przeciwieństwami. Jeśli isAzureCreditEnabled wartość ma wartość true, ChargesBilledSeparately będzie to fałsz.
consumedQuantity Ilość
consumedService ConsumedService
consumedServiceId ConsumedService consumedServiceId udostępnia tylko wartość liczbową.
ConsumedService zawiera nazwę usługi.
cost CostInBillingCurrency
costCenter CostCenter
data Data Format w starym polu był rrrr-mm-dd, podczas gdy nowe pole jest w formacie mm/dd/rrrr.
Departmentid InvoiceSectionId Pole jest obecnie puste. Użyj DepartmentName polecenia , aby uzyskać informacje o dziale.
departmentName InvoiceSectionName
extendedCost CostInBillingCurrency
instanceId ResourceId
isRecurringCharge W stosownych przypadkach należy użyć elementu Frequency i Term fields w przyszłości.
lokalizacja ResourceLocationNormalized ResourceLocationNormalized Jest obecny w raporcie Szczegóły kosztów, ale nie jest jeszcze w eksportach.
meterCategory MeterCategory
meterId MeterId
meterName MeterName
meterRegion MeterRegion
meterSubCategory MeterSubCategory
offerId Identyfikator oferty
Ordernumber Niedostępne.
partNumber PartNumber
planName PlanName
product ProductName
publisherName PublisherName
resourceGroup ResourceGroup
resourceGuid MeterId Wartości różnią się. resourceGuid jest wartością identyfikatora GUID. meterId to długa liczba.
resourceLocation ResourceLocation
resourceLocationId Niedostępne.
resourceRate EffectivePrice
serviceInfo1 ServiceInfo1
serviceInfo2 ServiceInfo2
Servicename MeterCategory
serviceTier MeterSubCategory
storeServiceIdentifier Niedostępne.
subscriptionGuid SubscriptionId
subscriptionId SubscriptionId
subscriptionName SubscriptionName
tags Tagi Nowe pole nie zawiera ujęć {} w pary klucz-wartość.
unitOfMeasure UnitOfMeasure

Powiązana zawartość