Migrowanie z interfejsów API szczegółów użycia umowy EA
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 | ||
| 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 | |
| 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 | |
| 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 |