Migrowanie z umowy Enterprise Agreement do interfejsów API umowy klienta firmy Microsoft
Ten artykuł ułatwia zapoznanie się z różnicami w strukturze danych i interfejsach API oraz innymi różnicami w zakresie integracji systemu między kontem z umową Enterprise Agreement (EA) a kontem z umową klienta firmy Microsoft (MCA). Usługa Cost Management obsługuje interfejsy API dla obu typów kont. Przed wykonaniem kolejnych czynności zapoznaj się z artykułem Konfigurowanie konta rozliczeniowego dla umowy klienta firmy Microsoft.
Organizacje z istniejącym kontem EA powinny zapoznać się z tym artykułem podczas konfigurowania konta umowy MCA. Wcześniej odnowienie konta EA wymagało minimalnego nakładu pracy związanej z przejściem ze starej rejestracji do nowej. Jednak migracja do konta MCA wymaga dodatkowego nakładu pracy. Dodatkowe wysiłki są spowodowane zmianami w podstawowym podsystemie rozliczeń, które mają wpływ na wszystkie interfejsy API i oferty usług związane z kosztami.
Integracja oraz interfejsy API MCA
Interfejsy API MCA i nowe możliwości integracji umożliwiają wykonywanie następujących działań:
- Korzystanie z pełnej dostępności interfejsów API za pośrednictwem natywnych interfejsów API platformy Azure.
- Konfigurowanie wielu faktur na jednym koncie rozliczeniowym.
- Uzyskiwanie dostępu do połączonego interfejsu API z użyciem usług platformy Azure, użyciem usług innych firm w witrynie Marketplace oraz zakupami w witrynie Marketplace.
- Wyświetlanie kosztów w profilach rozliczeniowych (takich samych jak rejestracje) przy użyciu usługi Cost Management.
- Uzyskiwanie dostępu do nowych interfejsów API umożliwiających wyświetlanie kosztów, otrzymywanie powiadomień o przekroczeniu wstępnie zdefiniowanych progów kosztów i automatyczne eksportowanie danych pierwotnych.
Lista kontrolna migracji
Poniższa lista ułatwia przejście na interfejsy API MCA.
- Zapoznaj się z nowym kontem rozliczeniowym umowy klienta firmy Microsoft.
- Ustal, których interfejsów API używasz. W następnej sekcji sprawdź, które interfejsy API zostały zastąpione.
- Zapoznaj się z interfejsami API REST usługi Azure Resource Manager.
- Jeśli nie używasz jeszcze interfejsów API usługi Azure Resource Manager, zarejestruj aplikację kliencją przy użyciu identyfikatora Entra firmy Microsoft.
- Udziel aplikacji utworzonej podczas rejestracji aplikacji Microsoft Entra dostęp do odczytu do konta rozliczeniowego przy użyciu kontroli dostępu (IAM).
- Zaktualizuj dowolny kod programowania, aby używał uwierzytelniania firmy Microsoft Entra.
- Zaktualizuj kod, zastępując wywołania interfejsu API EA wywołaniami interfejsu API MCA.
- Zaktualizuj obsługę błędów, wprowadzając nowe kody błędów.
- Przejrzyj inne oferty integracji, takie jak Usługa Power BI, aby uzyskać inne potrzebne działania.
Interfejsy API EA zastąpione przez interfejsy API MCA
Interfejsy API EA używają klucza interfejsu API do uwierzytelniania i autoryzacji. Interfejsy API MCA używają uwierzytelniania firmy Microsoft Entra.
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.
| Purpose | Interfejs API EA | Interfejs API MCA |
|---|---|---|
| Saldo i środki | /balancesummary | Microsoft.Billing/billingAccounts/billingProfiles/availableBalanceussae |
| Użycie (JSON) | /usagedetails /usagedetailsbycustomdate |
Wybieranie rozwiązania szczegółów kosztów |
| Użycie (CSV) | /usagedetails/download /usagedetails/submit |
Wybieranie rozwiązania szczegółów kosztów |
| Użycie w witrynie Marketplace (CSV) | /marketplacecharges /marketplacechargesbycustomdate |
Wybieranie rozwiązania szczegółów kosztów |
| Okresy rozliczeniowe | /billingperiods | Microsoft.Billing/billingAccounts/billingProfiles/invoices |
| Arkusz cen | /pricesheet | Microsoft.Billing/billingAccounts/billingProfiles/pricesheet/default/download format=json lub csv Microsoft.Billing/billingAccounts/.../billingProfiles/.../invoices/... /pricesheet/default/download format=json lub csv Microsoft.Billing/billingAccounts/.. /billingProfiles/.. /providers/Microsoft.Consumption/pricesheets/download |
| Zakupy rezerwacji | /reservationcharges | Microsoft.Billing/billingAccounts/billingProfiles/transactions |
| Rekomendacje dotyczące rezerwacji | /SharedReservationRecommendations /SingleReservationRecommendations |
Microsoft.Consumption/reservationRecommendations |
| Użycie rezerwacji | /reservationdetails /reservationsummaries |
Microsoft.Consumption/reservationDetails Microsoft.Consumption/reservationSummaries |
Usługa platformy Azure i użycie witryny Marketplace innych firm są dostępne za pomocą interfejsu API szczegółów użycia.
Następujące interfejsy API są dostępne na kontach rozliczeniowych MCA:
| Purpose | Interfejs API umowy klienta firmy Microsoft (MCA) |
|---|---|
| Konta rozliczeniowe² | Microsoft.Billing/billingAccounts |
| Profile rozliczeniowe² | Microsoft.Billing/billingAccounts/billingProfiles |
| Sekcje faktur² | Microsoft.Billing/billingAccounts/invoiceSections |
| Faktury | Microsoft.Billing/billingAccounts/billingProfiles/invoices |
| Subskrypcje rozliczeniowe | {zakres}/billingSubscriptions |
Interfejsy API ² zwracają listy obiektów, które są zakresami, w których działają środowiska usługi Cost Management w witrynie Azure Portal i interfejsach API. Aby uzyskać więcej informacji na temat zakresów usługi Cost Management, zobacz Omówienie zakresów i praca z nimi.
W przypadku używania interfejsów API EA należy je zaktualizować pod kątem obsługi kont rozliczeniowych MCA. W poniższej tabeli przedstawiono inne zmiany dotyczące integracji:
| Purpose | Stara oferta | Nowa oferta |
|---|---|---|
| Power BI | Pakiet zawartości i łącznik Microsoft Consumption Insights | Łącznik Azure Consumption Insights |
Interfejsy API do uzyskiwania informacji o saldzie i środkach
Podsumowanie get balance (Pobieranie salda) zostało użyte w celu uzyskania miesięcznego podsumowania:
- Salda
- Nowe zakupy
- Opłaty za usługę Azure Marketplace
- Korekty
- Opłaty za nadwyżkowe użycie usług
Wszystkie interfejsy API użycia są zastępowane przez natywne interfejsy API platformy Azure, które używają identyfikatora Entra firmy Microsoft do uwierzytelniania i autoryzacji. Aby uzyskać więcej informacji na temat wywoływania interfejsów API REST platformy Azure, zobacz Wprowadzenie do interfejsu REST.
Interfejs API pobierania podsumowania salda został zastąpiony przez interfejs API Microsoft.Billing/billingAccounts/billingProfiles/availableBalance.
Aby uzyskać informacje o dostępnych saldach za pomocą interfejsu API dostępnego salda:
| Method | Identyfikator URI żądania |
|---|---|
| GET | https://management.azure.com/providers/Microsoft.Billing/billingAccounts/{billingAccountId}/billingProfiles/{billingProfileId}/availableBalances?api-version=2018-11-01-preview |
Interfejsy API do uzyskiwania informacji o kosztach i użyciu
Następujące interfejsy API umożliwiają uzyskanie dziennego podziału kosztów użycia usług platformy Azure, użycia usług innych firm w witrynie Marketplace oraz pozostałych zakupów w witrynie Marketplace. Następujące odrębne interfejsy API zostały scalone na potrzeby obsługi użycia usług platformy Azure i usług innych firm w witrynie Marketplace. Stare interfejsy API są zastępowane eksportami lub interfejsem API szczegółów kosztów. Aby wybrać odpowiednie rozwiązanie, zobacz Wybieranie rozwiązania ze szczegółami kosztów. Oba rozwiązania udostępniają ten sam plik Szczegóły kosztów i mają zakupy w witrynie Marketplace w danych, które były wcześniej widoczne tylko w podsumowaniu salda do tej pory.
Eksporty i interfejs API szczegółów kosztów, podobnie jak wszystkie interfejsy API usługi Cost Management, są dostępne w wielu zakresach. Aby uzyskać informacje o zafakturowanych kosztach, tradycyjnie otrzymywane na poziomie rejestracji, użyj zakresu profilu rozliczeniowego. Aby uzyskać więcej informacji na temat zakresów usługi Cost Management, zobacz Omówienie zakresów i praca z nimi.
| Type | Format identyfikatora |
|---|---|
| Konto rozliczeniowe | /Microsoft.Billing/billingAccounts/{billingAccountId} |
| Profil rozliczeniowy | /Microsoft.Billing/billingAccounts/{billingAccountId}/billingProfiles/{billingProfileId} |
| Subskrypcja | /subscriptions/{subscriptionId} |
| Grupa zasobów | /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName} |
Niektóre nazwy właściwości zostały zmienione w nowym zestawie danych szczegóły kosztów dostępnym za pośrednictwem interfejsu API Eksporty i Szczegóły kosztów. W poniższej tabeli przedstawiono odpowiadające właściwości.
| Stara właściwość | Nowa właściwość | Uwagi |
|---|---|---|
| AccountId | Nie dotyczy | Twórca subskrypcji nie jest śledzony. Użyj właściwości invoiceSectionId (takiej samej jak departmentId). |
| AccountNameAccountOwnerId i AccountOwnerEmail | Nie dotyczy | Twórca subskrypcji nie jest śledzony. Użyj właściwości invoiceSectionName (takiej samej jak departmentName). |
| AdditionalInfo | additionalInfo | |
| ChargesBilledSeparately | isAzureCreditEligible | Właściwości są przeciwieństwami. Jeśli isAzureCreditEnabled ma wartość true, ChargesBilledSeparately ma wartość false. |
| ConsumedQuantity | ilość | |
| ConsumedService | consumedService | Dokładne wartości ciągów mogą się różnić. |
| ConsumedServiceId | Brak | |
| CostCenter | costCenter | |
| Date i usageStartDate | data | |
| Dzień | Brak | Analizuje informacje o dniu na podstawie daty. |
| DepartmentId | invoiceSectionId | Dokładne wartości są różne. |
| DepartmentName | invoiceSectionName | Dokładne wartości ciągów mogą się różnić. W razie potrzeby należy dopasować sekcje faktury do działów. |
| ExtendedCost i Cost | costInBillingCurrency | |
| InstanceId | resourceId | |
| Is Recurring Charge | Brak | |
| Lokalizacja | lokalizacja | |
| MeterCategory | meterCategory | Dokładne wartości ciągów mogą się różnić. |
| MeterId | meterId | Dokładne wartości ciągów są różne. |
| MeterName | meterName | Dokładne wartości ciągów mogą się różnić. |
| MeterRegion | meterRegion | Dokładne wartości ciągów mogą się różnić. |
| MeterSubCategory | meterSubCategory | Dokładne wartości ciągów mogą się różnić. |
| Month | Brak | Analizuje informacje o miesiącu na podstawie daty. |
| Offer Name | Brak | Należy użyć właściwości publisherName i productOrderName. |
| OfferID | Brak | |
| Numer zamówienia | Brak | |
| PartNumber | Brak | Należy użyć właściwości meterId i productOrderName do unikatowego identyfikowania cen. |
| Nazwa planu | productOrderName | |
| Rezultat | Rezultat | |
| Identyfikator produktu | productId | Dokładne wartości ciągów są różne. |
| Publisher Name | publisherName | |
| ResourceGroup | resourceGroupName | |
| ResourceGuid | meterId | Dokładne wartości ciągów są różne. |
| ResourceLocation | resourceLocation | |
| ResourceLocationId | Brak | |
| ResourceName | Brak | |
| ResourceRate | effectivePrice | |
| ServiceAdministratorId | Nie dotyczy | |
| ServiceInfo1 | serviceInfo1 | |
| ServiceInfo2 | serviceInfo2 | |
| ServiceName | meterCategory | Dokładne wartości ciągów mogą się różnić. |
| ServiceTier | meterSubCategory | Dokładne wartości ciągów mogą się różnić. |
| StoreServiceIdentifier | Nie dotyczy | |
| SubscriptionGuid | subscriptionId | |
| SubscriptionId | subscriptionId | |
| SubscriptionName | subscriptionName | |
| Tagi | tags | Właściwość tags ma zastosowanie do obiektu głównego, a nie do właściwości zagnieżdżonych. |
| UnitOfMeasure | unitOfMeasure | Dokładne wartości ciągów są różne. |
| usageEndDate | data | |
| Year (Rok) | Brak | Analizuje informacje o roku na podstawie daty. |
| (nowa) | billingCurrency | Waluta używana do naliczania opłat. |
| (nowa) | billingProfileId | Unikatowy identyfikator profilu rozliczeniowego (taki sam jak rejestracja). |
| (nowa) | billingProfileName | Nazwa profilu rozliczeniowego (taka sama jak rejestracja). |
| (nowa) | chargeType | Umożliwia identyfikację użycia usług platformy Azure, użycia usług z witryny Marketplace i zakupów. |
| (nowa) | invoiceId | Unikatowy identyfikator faktury. W przypadku bieżącego, otwartego miesiąca jest pusta. |
| (nowa) | publisherType | Typ wydawcy dotyczący zakupów. Wartość pusta. |
| (nowa) | serviceFamily | Typ zakupu. Wartość pusta. |
| (nowa) | servicePeriodEndDate | Data końcowa zakupionej usługi. |
| (nowa) | servicePeriodStartDate | Data początkowa zakupionej usługi. |
Interfejs API okresów rozliczeniowych został zastąpiony przez interfejs API faktur
Okresy rozliczeniowe nie są używane na kontach rozliczeniowych MCA. Do określania zakresu kosztów we wskazanych okresach rozliczeniowych służą faktury. Interfejs API okresów rozliczeniowych został zastąpiony przez interfejs API faktur. Wszystkie interfejsy API użycia są zastępowane przez natywne interfejsy API platformy Azure, które używają identyfikatora Entra firmy Microsoft do uwierzytelniania i autoryzacji. Aby uzyskać więcej informacji na temat wywoływania interfejsów API REST platformy Azure, zobacz Wprowadzenie do interfejsu REST.
Aby uzyskać faktury za pomocą interfejsu API faktur:
| Method | Identyfikator URI żądania |
|---|---|
| GET | https://management.azure.com/providers/Microsoft.Billing/billingAccounts/{billingAccountId}/billingProfiles/{billingProfileId}/invoices?api-version=2018-11-01-preview |
Interfejs API arkusza cen
W tej sekcji omówiono istniejące interfejsy API arkusza cen oraz zamieszczono zalecenia dotyczące przejścia na interfejs API arkusza cen dla umów klienta firmy Microsoft. Omówiono w niej również interfejs API arkusza cen dla umów klienta firmy Microsoft oraz objaśniono przeznaczenie pól w arkuszach cen. Interfejsy API pobierania arkusza cen dla przedsiębiorstw i pobierania okresów rozliczeniowych dla przedsiębiorstw zostały zastąpione przez interfejs API arkusza cen dla umów klienta firmy Microsoft (Microsoft.Billing/billingAccounts/billingProfiles/pricesheet). Nowy interfejs API obsługuje zarówno format JSON, jak i CSV w formatach asynchronicznych REST. Wszystkie interfejsy API użycia są zastępowane przez natywne interfejsy API platformy Azure, które używają identyfikatora Entra firmy Microsoft do uwierzytelniania i autoryzacji. Aby uzyskać więcej informacji na temat wywoływania interfejsów API REST platformy Azure, zobacz Wprowadzenie do interfejsu REST.
Interfejsy API rozliczeń dla przedsiębiorstw
Interfejsy API rozliczeń dla przedsiębiorstw były używane razem z rejestracjami Enterprise do uzyskiwania informacji o cenach i okresach rozliczeniowych. Uwierzytelnianie i autoryzacja używane tokeny internetowe firmy Microsoft Entra.
Aby uzyskać odpowiednie ceny dla określonej rejestracji Enterprise przy użyciu interfejsów API arkusza cen i okresu rozliczeniowego:
| Method | Identyfikator URI żądania |
|---|---|
| GET | https://consumption.azure.com/v2/enrollments/{enrollmentNumber}/pricesheet |
| GET | https://consumption.azure.com/v2/enrollments/{enrollmentNumber}/billingPeriods/{billingPeriod}/pricesheet |
Interfejs API arkusza cen dla umów klienta firmy Microsoft
Interfejs API arkusza cen dla umów klienta firmy Microsoft umożliwia wyświetlanie cen za użycie wszystkich usług platformy Azure i witryny Marketplace. Ceny widoczne w profilu rozliczeniowym mają zastosowanie do wszystkich subskrypcji należących do tego profilu.
Interfejs API arkusza cen umożliwia wyświetlenie danych użycia wszystkich usług platformy Azure w formacie CSV:
| Method | Identyfikator URI żądania |
|---|---|
| POST | https://management.azure.com/providers/Microsoft.Billing/billingAccounts/{billingAccountId}/billingProfiles/{billingProfileId}/pricesheet/default/download?api-version=2018-11-01-preview&startDate=2019-01-01&endDate=2019-01-31&format=csv |
Interfejs API arkusza cen umożliwia wyświetlenie danych użycia wszystkich usług platformy Azure w formacie JSON:
| Method | Identyfikator URI żądania |
|---|---|
| POST | https://management.azure.com/providers/Microsoft.Billing/billingAccounts/{billingAccountId}/billingProfiles/{billingProfileId}/pricesheet/default/download?api-version=2018-11-01-preview&startDate=2019-01-01&endDate=2019-01-31&format=json |
Użycie interfejsu API powoduje zwrócenie arkusza cen dla całego konta. Można jednak uzyskać skróconą wersję arkusza cen w formacie PDF. Podsumowanie obejmuje użycie usług platformy Azure i usług witryny Marketplace, które są rozliczane na określonej fakturze. Faktura jest identyfikowana przez właściwość {invoiceId}, która jest taka sama jak numer faktury widoczny w plikach PDF z podsumowaniem faktury. Oto przykład.
Aby wyświetlić informacje o fakturze w formacie CSV przy użyciu interfejsu API arkusza cen:
| Method | Identyfikator URI żądania |
|---|---|
| POST | https://management.azure.com/providers/Microsoft.Billing/billingAccounts/{billingAccountId}/billingProfiles/{billingProfileId}/invoices/{invoiceId}/pricesheet/default/download?api-version=2018-11-01-preview&format=csv |
Aby wyświetlić informacje o fakturze w formacie JSON przy użyciu interfejsu API arkusza cen:
| Method | Identyfikator URI żądania |
|---|---|
| POST | https://management.azure.com/providers/Microsoft.Billing/billingAccounts/{billingAccountId}/billingProfiles/{billingProfileId}/invoices/{invoiceId}/pricesheet/default/download?api-version=2018-11-01-preview&format=json |
Można również sprawdzić szacowane ceny za użycie dowolnej usługi platformy Azure lub witryny Marketplace w bieżącym otwartym cyklu rozliczeniowym albo okresie korzystania z usługi.
Aby wyświetlić szacowane ceny za użycie usług w formacie CSV przy użyciu interfejsu API arkusza cen:
| Method | Identyfikator URI żądania |
|---|---|
| POST | https://management.azure.com/providers/Microsoft.Billing/billingAccounts/{billing AccountId}/billingProfiles/{billingProfileId}/pricesheet/default/download?api-version=2018-11-01-preview&format=csv |
Aby wyświetlić szacowane ceny za użycie usług w formacie JSON przy użyciu interfejsu API arkusza cen:
| Method | Identyfikator URI żądania |
|---|---|
| POST | https://management.azure.com/providers/Microsoft.Billing/billingAccounts/{billing AccountId}/billingProfiles/{billingProfileId}/pricesheet/default/download?api-version=2018-11-01-preview&format=json |
Interfejsy API arkusza cen umowy klienta firmy Microsoft to asynchroniczne interfejsy API REST. Odpowiedzi interfejsów API różnią się od odpowiedzi starszych, synchronicznych interfejsów API. Treść odpowiedzi interfejsu API również uległa zmianie.
Stara treść odpowiedzi
Oto przykładowa synchroniczna odpowiedź interfejsu API REST:
[
{
"id": "enrollments/573549891/billingperiods/2016011/products/343/pricesheets",
"billingPeriodId": "201704",
"meterId": "dc210ecb-97e8-4522-8134-2385494233c0",
"meterName": "A1 VM",
"unitOfMeasure": "100 Hours",
"includedQuantity": 0,
"partNumber": "N7H-00015",
"unitPrice": 0.00,
"currencyCode": "USD"
},
{
]
Nowa treść odpowiedzi
Interfejsy API obsługują asynchroniczny format REST platformy Azure. Po wywołaniu interfejsu API za pomocą metody GET otrzymujemy następującą odpowiedź:
No Response Body
HTTP Status 202 Accepted
Następujące nagłówki zawierają lokalizację danych wyjściowych:
Location:https://management.azure.com/providers/Microsoft.Consumption/operationresults/{operationId}?sessiontoken=XZDFSnvdkbkdsb==
Azure-AsyncOperation:https://managment.azure.com/providers/Microsoft.Consumption/operationStatus/{operationId}?sessiontoken=XZDFSnvdkbkdsb==
Retry-After: 10
OData-EntityId: {operationId}
Wykonaj kolejne wywołanie metody GET do lokalizacji. Odpowiedź na wywołanie metody GET pozostaje taka sama, aż operacja osiągnie stan ukończenia lub niepowodzenia. Po zakończeniu odpowiedź na lokalizację wywołania GET zwraca adres URL pobierania tak, jakby operacja została wykonana w tym samym czasie. Oto przykład:
HTTP Status 200
{
"id": "providers/Microsoft.Consumption/operationresults/{operationId}",
"name": {operationId},
"type": “Microsoft.Consumption/operationResults",
"properties" : {
"downloadUrl": {urltoblob},
"validTill": "Date"
}
}
Klient może również wykonać wywołanie metody GET dla nagłówka Azure-AsyncOperation. Punkt końcowy zwraca stan operacji.
W poniższej tabeli przedstawiono pola w starszym interfejsie API pobierania arkusza cen dla przedsiębiorstw. Tabela zawiera odpowiadające pola w nowym arkuszu cen dla umów klienta firmy Microsoft:
| Stara właściwość | Nowa właściwość | Uwagi |
|---|---|---|
| billingPeriodId | Nie dotyczy | Nie dotyczy. W przypadku umów klienta firmy Microsoft właściwość billingPeriodId została zastąpiona przez fakturę i skojarzony arkusz cen. |
| meterId | meterId | |
| unitOfMeasure | unitOfMeasure | Dokładne wartości ciągów mogą się różnić. |
| includedQuantity | includedQuantity | Nie dotyczy usług w umowach klienta firmy Microsoft. |
| partNumber | Nie dotyczy | Zamiast tego należy użyć kombinacji właściwości productOrderName (takiej samej jak offerID) i meterID. |
| unitPrice | unitPrice | Cena jednostkowa ma zastosowanie do usług używanych w umowach klienta firmy Microsoft. |
| currencyCode | pricingCurrency | Reprezentacja cen w umowach klienta firmy Microsoft obejmuje walutę cennika i walutę rozliczeniową. Właściwość currencyCode odpowiada właściwości pricingCurrency w umowach klienta firmy Microsoft. |
| offerID | productOrderName | Zamiast właściwości OfferID można użyć właściwości productOrderName, ale nie jest ona taka sama jak OfferID. Jednak właściwość productOrderName i miernik określają cenę w umowach klienta firmy Microsoft. Elementy te są powiązane z właściwościami meterId i OfferID w starszych rejestracjach. |
Operacje interfejsu API arkusza cen za użycie
W umowach Enterprise Agreement były używane operacje interfejsu API pobierania i pobierania według okresu rozliczeniowego arkusza cen za użycie. Zakresy tych operacji były ustalane za pomocą właściwości subscriptionId lub okresu rozliczeniowego. Interfejs API używa uwierzytelniania usługi Azure Resource Management.
Aby uzyskać informacje o arkuszu cen w określonym zakresie przy użyciu interfejsu API arkusza cen:
| Method | Identyfikator URI żądania |
|---|---|
| GET | https://management.azure.com/subscriptions/{subscriptionId}/providers/Microsoft.Consumption/pricesheets/default?api-version=2018-10-01 |
Aby uzyskać informacje o arkuszu cen według okresu rozliczeniowego przy użyciu interfejsu API arkusza cen:
| Method | Identyfikator URI żądania |
|---|---|
| GET | https://management.azure.com/subscriptions/{subscriptionId}/providers/Microsoft.Billing/billingPeriods/{billingPeriodName}/providers/Microsoft.Consumption/pricesheets/default?api-version=2018-10-01 |
Zamiast powyższych punktów końcowych interfejsu API w przypadku umów klienta firmy Microsoft należy używać następujących punktów końcowych:
Interfejs API arkusza cen dla umów klienta firmy Microsoft (asynchroniczny interfejs API REST)
Ten interfejs API jest przeznaczony dla Umowa z Klientem Microsoft i udostępnia dodatkowe atrybuty.
Arkusz cen dla zakresu profilu rozliczeniowego na koncie rozliczeniowym
Jest to istniejący interfejs API. Został on zaktualizowany — dostarcza arkusza cen dla profilu rozliczeniowego na koncie rozliczeniowym.
Arkusz cen w określonym zakresie według konta rozliczeniowego
W przypadku uzyskiwania arkusza cen w zakresie rejestracji na koncie rozliczeniowym jest używane uwierzytelnianie usługi Azure Resource Manager.
Aby uzyskać arkusz cen na koncie rejestracji na koncie rozliczeniowym:
| Method | Identyfikator URI żądania |
|---|---|
| GET | /providers/Microsoft.Billing/billingAccounts/65085863/providers/Microsoft.Consumption/pricesheets/download?api-version=2019-01-01 |
W przypadku umowy klienta firmy Microsoft należy skorzystać z informacji podanych w poniższej sekcji. Zawiera ona właściwości pól używane w umowach klienta firmy Microsoft.
Arkusz cen dla zakresu profilu rozliczeniowego na koncie rozliczeniowym
Zaktualizowany interfejs API arkusza cen według konta rozliczeniowego umożliwia pobieranie arkusza cen w formacie CSV. Aby uzyskać arkusz cen w zakresie profilu rozliczeniowego dla umowy MCA:
| Method | Identyfikator URI żądania |
|---|---|
| GET | /providers/Microsoft.Billing/billingAccounts/{billing AccountId}/billingProfiles/{billingProfileId}/providers/Microsoft.Consumption/pricesheets/download?api-version=2019-01-01 |
W zakresie rejestracji umowy EA odpowiedź interfejsu API i właściwości są identyczne. Właściwości są zgodne z właściwościami umowy MCA.
Poniższa tabela przedstawia starsze właściwości interfejsów API arkusza cen usługi Azure Resource Manager oraz nowe właściwości, które są takie same.
| Stara właściwość interfejsu API arkusza cen usługi Azure Resource Manager | Nowa właściwość interfejsu API arkusza cen umowy klienta firmy Microsoft | opis |
|---|---|---|
| Identyfikator miernika | meterId | Unikatowy identyfikator miernika. Taki sam jak właściwość meterID. |
| Nazwa miernika | meterName | Nazwa miernika. Miernik reprezentuje możliwy do wdrożenia zasób usługi platformy Azure. |
| Kategoria miernika | service | Nazwa kategorii klasyfikacji dla miernika. Jest ona taka sama jak usługa w arkuszu cen umowy klienta firmy Microsoft. Dokładne wartości ciągów są różne. |
| Podkategoria miernika | meterSubCategory | Nazwa kategorii klasyfikacji podrzędnej miernika. Jest ona oparta na klasyfikacji rozróżniania zestawu funkcji wysokiego poziomu w usłudze. Przykładowa nazwa to podstawowa baza danych SQL lub standardowa baza danych SQL. |
| Region miernika | meterRegion | |
| Jednostka | Nie dotyczy | Można ją wyodrębnić z właściwości unitOfMeasure. |
| Jednostka miary | unitOfMeasure | |
| Numer części | Nie dotyczy | Zamiast numeru części należy użyć właściwości productOrderName i MeterID w celu jednoznacznego zidentyfikowania ceny dla profilu rozliczeniowego. Faktura MCA zawiera listę pól zamiast numeru części. |
| Cena jednostkowa | unitPrice | Cena jednostkowa w umowie klienta firmy Microsoft. |
| Kod waluty | pricingCurrency | Reprezentacja cen w umowach klienta firmy Microsoft obejmuje walutę cennika i walutę rozliczeniową. Kod waluty jest taki sam jak właściwość pricingCurrency w umowach klienta firmy Microsoft. |
| Uwzględniona ilość | includedQuantity | Nie dotyczy usług w umowach klienta firmy Microsoft. Wyświetlana z wartościami równymi zero. |
| Identyfikator oferty | productOrderName | Zamiast właściwości OfferID należy użyć właściwości productOrderName. Nie jest ona taka sama jak właściwość OfferID, ale właściwość productOrderName i miernik określają ceny w umowach klienta firmy Microsoft. Są one powiązane z właściwościami meterId i OfferID w starszych rejestracjach. |
Cena w umowach klienta firmy Microsoft jest definiowana inaczej niż w umowach Enterprise Agreement. Ceny usług w rejestracji Enterprise są unikatowe dla produktu, numeru części, miernika i oferty. Numer części nie jest używany w umowach klienta firmy Microsoft.
Cena za użycie usługi platformy Azure, która jest częścią umowy klienta firmy Microsoft, jest unikatowa dla właściwości productOrderName i meterID. Reprezentują one miernik usługi i plan produktu.
Aby uzgodnić arkusz cen i użycie w interfejsie API szczegółów użycia, można użyć właściwości productOrderName i meterID.
Arkusz cen mogą pobierać użytkownicy, którzy mają uprawnienia właściciela profilu rozliczeniowego, współautora, czytelnika lub menedżera faktury.
Arkusz cen zawiera ceny usług, które są rozliczane na podstawie użycia. Usługi obejmują użycie platformy Azure i witryny Marketplace. Ostatnia cena w każdym okresie korzystania z usługi jest blokowana i stosowana w pojedynczym okresie korzystania z usługi. W przypadku użycia usług platformy Azure okres korzystania z usługi zwykle odpowiada miesiącowi kalendarzowemu.
Wycofane pola interfejsu API arkusza cen
Następujące pola nie są dostępne w interfejsach API arkusza cen umowy klienta firmy Microsoft lub są one takie same.
| Wycofane pole | opis |
|---|---|
| billingPeriodId | Nie dotyczy. Odpowiada właściwości InvoiceId w umowie MCA. |
| offerID | Nie dotyczy. Odpowiada właściwości productOrderName w umowie MCA. |
| meterCategory | Nie dotyczy. Odpowiada usłudze w umowie MCA. |
| unit | Nie dotyczy. Można ją wyodrębnić z właściwości unitOfMeasure. |
| currencyCode | Taka sama jak właściwość pricingCurrency w umowie MCA. |
| meterLocation | Taka sama jak właściwość meterRegion w umowie MCA. |
| partNumber | Nie mają zastosowania, ponieważ numer części nie pojawia się na fakturach MCA. Zamiast numeru części należy użyć właściwości meterId i productOrderName do unikatowego identyfikowania cen. |
| totalIncludedQuantity | Nie dotyczy. |
| pretaxStandardRate | Nie dotyczy. |
Interfejs API opłat za wystąpienia zarezerwowane został zamieniony
Transakcje rozliczeniowe za zakupy rezerwacji można uzyskać przy użyciu interfejsu API opłat za wystąpienia zarezerwowane. Nowy interfejs API obejmuje wszystkie zakupy, w tym oferty innych firm w witrynie Marketplace. Wszystkie interfejsy API użycia są zastępowane przez natywne interfejsy API platformy Azure, które używają identyfikatora Entra firmy Microsoft do uwierzytelniania i autoryzacji. Aby uzyskać więcej informacji na temat wywoływania interfejsów API REST platformy Azure, zobacz Wprowadzenie do interfejsu REST. Interfejs API opłat za wystąpienia zarezerwowane został zastąpiony przez interfejs API transakcji.
Aby uzyskać informacje o transakcjach związanych z zakupami rezerwacji przy użyciu interfejsu API transakcji:
| Method | Identyfikator URI żądania |
|---|---|
| GET | https://management.azure.com/providers/Microsoft.Billing/billingAccounts/{billingAccountId}/billingProfiles/{billingProfileId}/transactions?api-version=2018-11-01-preview |
Interfejsy API zaleceń zostały zamienione
Interfejsy API zaleceń dotyczących zakupów wystąpień zarezerwowanych udostępniają informacje o użyciu maszyn wirtualnych z ostatnich 7, 30 lub 60 dni. Interfejsy API udostępniają również zalecenia dotyczące zakupów rezerwacji. To na przykład:
- Interfejs API zaleceń dotyczących współdzielonych wystąpień zarezerwowanych
- Interfejs API zaleceń dotyczących pojedynczego wystąpienia zarezerwowanego
Wszystkie interfejsy API użycia są zastępowane przez natywne interfejsy API platformy Azure, które używają identyfikatora Entra firmy Microsoft do uwierzytelniania i autoryzacji. Aby uzyskać więcej informacji na temat wywoływania interfejsów API REST platformy Azure, zobacz Wprowadzenie do interfejsu REST. Wymienione wcześniej interfejsy API zaleceń dotyczących rezerwacji zostały zastąpione przez interfejs API Microsoft.Consumption/reservationRecommendations.
Aby uzyskać zalecenia dotyczące rezerwacji przy użyciu interfejsu API zaleceń dotyczących rezerwacji:
| Method | Identyfikator URI żądania |
|---|---|
| GET | https://management.azure.com/providers/Microsoft.Consumption/reservationRecommendations?api-version=2019-01-01 |
Interfejsy API użycia rezerwacji zostały zamienione
Informacje o użyciu rezerwacji w ramach rejestracji można uzyskać przy użyciu interfejsu API użycia wystąpień zarezerwowanych. Jeśli rejestracja zawiera więcej niż jedno wystąpienie zarezerwowane, ten interfejs API umożliwia również uzyskanie informacji o użyciu wszystkich zakupionych wystąpień zarezerwowanych.
To na przykład:
- Szczegóły użycia wystąpień zarezerwowanych
- Podsumowanie użycia wystąpień zarezerwowanych
Wszystkie interfejsy API użycia są zastępowane przez natywne interfejsy API platformy Azure, które używają identyfikatora Entra firmy Microsoft do uwierzytelniania i autoryzacji. Aby uzyskać więcej informacji na temat wywoływania interfejsów API REST platformy Azure, zobacz Wprowadzenie do interfejsu REST. Wymienione wcześniej interfejsy API zaleceń dotyczących rezerwacji zostały zastąpione przez interfejsy API Microsoft.Consumption/reservationDetails i Microsoft.Consumption/reservationSummaries.
Aby uzyskać szczegółowe informacje dotyczące rezerwacji przy użyciu interfejsu API szczegółów rezerwacji:
| Method | Identyfikator URI żądania |
|---|---|
| GET | https://management.azure.com/providers/Microsoft.Consumption/reservationDetails?api-version=2019-01-01 |
Aby uzyskać podsumowania rezerwacji przy użyciu interfejsu API podsumowań rezerwacji:
| Method | Identyfikator URI żądania |
|---|---|
| GET | https://management.azure.com/providers/Microsoft.Consumption/reservationSummaries?api-version=2019-01-01 |
Integracja usługi Power BI
Usługa Power BI również umożliwia raportowanie kosztów. Łącznik Cost Management dla programu Power BI Desktop może służyć do tworzenia zaawansowanych, dostosowanych raportów, które pomagają lepiej zrozumieć wydatki na platformę Azure. Łącznik usługi Cost Management obsługuje obecnie klientów z Umowa z Klientem Microsoft lub Umowa Enterprise (EA).
Powiązana zawartość
- Aby dowiedzieć się, jak monitorować i kontrolować wydatki na platformę Azure, zapoznaj się z dokumentacją usługi Cost Management. Usługa Cost Management umożliwia również optymalizowanie użycia zasobów.