Uwaga
Dostęp do tej strony wymaga autoryzacji. Może spróbować zalogować się lub zmienić katalogi.
Dostęp do tej strony wymaga autoryzacji. Możesz spróbować zmienić katalogi.
Klienci z umową EA, którzy wcześniej korzystali z Enterprise Reporting API poprzez punkt końcowy consumption.azure.com w celu uzyskania szczegółowych informacji o użyciu i opłatach na rynku, 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 powinieneś 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 wdrażaniu |
|---|---|---|---|
| Eksporty | Cykliczne zrzuty danych do magazynu zgodnie z harmonogramem | — najbardziej skalowalne rozwiązanie dla zadań roboczych. — Można skonfigurować do używania partycjonowania plików dla większych zestawów danych. — Doskonałe rozwiązanie do tworzenia i rozwijania zestawu danych kosztów, który można zintegrować z własnymi magazynami danych umożliwiającymi wykonywanie zapytań. —Wymaga dostępu do konta magazynowego, które może przechowywać dane. |
-
Konfigurowanie w witrynie Azure Portal Automatyzowanie tworzenia eksportu za pomocą interfejsu API - Eksportowanie dokumentacji interfejsu API |
| Szczegóły kosztów API | 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. |
-
Uzyskaj tanie zestawy danych na żądanie - API Szczegóły 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 Szczegóły kosztów wprowadzania danych. Jeśli potrzebujesz dodatkowych informacji, aby pomóc w podejmowaniu decyzji dotyczących obciążenia pracą, zobacz Wybierz rozwiązanie dotyczące szczegółów kosztów.
Przypisz uprawnienia SPN do wywoływania interfejsów API
Jeśli chcesz użyć programowo API Eksportów lub API Szczegółów Kosztów, musisz skonfigurować jednostkę usługi z odpowiednimi uprawnieniami. Aby uzyskać więcej informacji, zobacz Przypisywanie uprawnień do interfejsów API ACM.
Unikaj API Szczegółów Użycia Microsoftu
Interfejs API szczegółów użycia to kolejny punkt końcowy, który obecnie obsługuje klientów EA. Nie należy migrować do tego interfejsu API. Przeprowadź migrację do Eksportów lub interfejsu API Szczegółów Kosztów, jak opisano wcześniej w tym dokumencie. Interfejs API szczegółów użycia zostanie wycofany w przyszłości i jest dostępny pod 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ł się skalować wraz ze wzrostem twoich wydatków i rozmiarem zestawu danych kosztów miesięcznych. Jeśli obecnie używasz interfejsu API Szczegółów użycia, zalecamy jak najszybszą migrację do eksportu interfejsu API Szczegółów kosztów. Oficjalne ogłoszenie o wycofaniu zostanie opublikowane w przyszłości. Aby dowiedzieć się więcej na temat migrowania z interfejsu API Consumption Usage Details, zobacz Migrowanie z interfejsu API Consumption Usage Details.
Korzyści z migracji
Nasze nowe rozwiązania zapewniają wiele korzyści w porównaniu do interfejsów API dotyczących szczegółowych danych użycia w raportach 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 API używane do uwierzytelniania w raportowaniu API 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ą zaprojektowane do efektywnego skalowania w miarę jak rośnie użycie platformy Azure. 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ą rozbudowane ulepszenia infrastruktury, które zapewniają pomyślne pobrania dowolnego rozmiaru zestawu danych.
- Pojedynczy zestaw danych dla wszystkich danych szczegółowych dotyczących użycia — szczegóły użycia platformy Azure i witryny Azure Marketplace zostały scalone w jeden zestaw 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ć widok kosztów z amortyzacją 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 — klienci Umowy Enterprise i Umowy z Klientem Microsoft mogą korzystać z nowego rozwiązania, aby wyświetlać opłaty zgodnie z skonfigurowanymi regułami 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 dla przedsiębiorstw do wycofania
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 |
|---|---|---|
| Identyfikator konta | ||
| nazwaKonta | NazwaKonta | |
| email właściciela konta | IdentyfikatorWłaścicielaKonta | |
| dodatkoweInformacje | Dodatkowe informacje | |
| opłaty naliczane osobno | czyKwalifikująSięDoKredytówAzure | Właściwości są przeciwieństwami. Jeśli isAzureCreditEnabled jest prawdziwy, ChargesBilledSeparately byłoby fałszywe. |
| zużyta ilość | Ilość | |
| usługa konsumowana | ConsumedService | |
| idUsługiZużytej | ConsumedService |
consumedServiceId udostępnia tylko wartość liczbową.ConsumedService zawiera nazwę usługi. |
| koszt | Koszt w walucie rozliczeniowej | |
| costCenter | CostCenter | |
| data | Data | Format w starym polu był rrrr-mm-dd, natomiast nowe pole jest w formacie mm/dd/rrrr. |
| identyfikatorDziału | IdSekcjiFaktury | |
| nazwaDziału | Nazwa Sekcji Faktury | |
| rozszerzony koszt | Koszt w walucie rozliczeniowej | |
| instanceId | ResourceId | |
| czyJestOpłataCykliczna | W stosownych przypadkach należy użyć elementu Frequency i Term fields w przyszłości. |
|
| lokalizacja | ResourceLocationNormalized | |
| kategoria licznika | Kategoria Liczników | |
| meterId | MeterId | |
| nazwa licznika | Nazwa Licznika | |
| meterRegion | MeterRegion | |
| podkategoria licznika | PodkategoriaLiczników | |
| identyfikator oferty | Identyfikator oferty | |
| numer zamówienia | Niedostępne. | |
| numer części | Numer Części | |
| nazwa planu | PlanName | |
| produkt | ProductName | |
| nazwaWydawcy | Nazwa wydawcy | |
| resourceGroup | ResourceGroup | |
| identyfikator zasobu | MeterId | Wartości różnią się.
resourceGuid jest wartością identyfikatora GUID.
meterId to długa liczba. |
| lokalizacja zasobów | LokalizacjaZasobu | |
| identyfikator lokalizacji zasobów | Niedostępne. | |
| wskaźnik zasobów | EffectivePrice | |
| Informacje o usłudze 1 | ServiceInfo1 | |
| serviceInfo2 | ServiceInfo2 | |
| nazwa usługi | Kategoria Liczników | |
| poziom usługi | PodkategoriaLiczników | |
| IdentyfikatorUsługiSklepu | Niedostępne. | |
| subskrypcjaGuid | Identyfikator subskrypcji | |
| subscriptionId (identyfikator subskrypcji) | Identyfikator subskrypcji | |
| nazwa subskrypcji | Nazwa subskrypcji | |
| etykiety | Tagi | Nowe pole nie zawiera ujęć {} w pary klucz-wartość. |
| jednostka miary | JednostkaMiary |