Переход с API EA на API Клиентского соглашения Майкрософт
Эта статья поможет разобраться в структуре данных, API и других различиях системной интеграции между учетными записями Enterprise Agreement (EA) и учетными записями Клиентского соглашения Майкрософт (MCA). Служба управления затратами поддерживает API для обоих типов учетных записей. Прежде чем продолжить, ознакомьтесь со статьей Настройка учетных записей выставления счетов для Клиентского соглашения Майкрософт
Организации с существующей учетной записью EA должны ознакомиться с этой статьей при настройке учетной записи MCA. Ранее для обновления учетной записи EA и перехода от старой регистрации к новой требовалось минимум шагов. Однако миграция на учетную запись MCA требует дополнительных усилий. Дополнительные усилия обусловлены изменениями в базовой подсистеме выставления счетов, которые влияют на все API-интерфейсы и предложения служб, связанные с затратами.
API Клиентского соглашения Майкрософт и интеграция
API Клиентского соглашения Майкрософт и новая интеграция позволяют:
- обеспечить полную доступность API через собственные API Azure;
- настроить несколько счетов в одной учетной записи выставления счетов;
- обеспечить доступ к комбинированному API с данными об использовании служб Azure, решений сторонних разработчиков и покупок на Marketplace;
- просматривать затраты в профилях выставления счетов (так же, как и при регистрации) с помощью Управления затратами.
- Получить доступ к новым API для отображения затрат, получения уведомлений о превышении заранее определенных пороговых значений и автоматического экспорта необработанных данных.
Контрольный список действий по миграции
Следующие шаги помогут при переходе на API Клиентского соглашения Майкрософт.
- Ознакомьтесь с новой учетной записью выставления счетов по Клиентскому соглашению Майкрософт.
- Определите, какие API вы используете, и посмотрите, какие из них заменяются в следующем разделе.
- Ознакомьтесь с API Azure Resource Manager.
- Если вы еще не используете API Azure Resource Manager, зарегистрируйте клиентское приложение с помощью идентификатора Microsoft Entra.
- Предоставьте приложению, созданному во время регистрации приложения Microsoft Entra, доступ на чтение к учетной записи выставления счетов с помощью управления доступом (IAM).
- Обновите любой код программирования, чтобы использовать проверку подлинности Microsoft Entra.
- В программном коде замените вызовы API EA на вызовы API Клиентского соглашения Майкрософт.
- Обновите механизм обработки ошибок так, чтобы он использовал новые коды ошибок.
- Ознакомьтесь с другими предложениями интеграции, такими как Power BI, для выполнения других необходимых действий.
API EA, замененные на API Клиентского соглашения Майкрософт
Для проверки подлинности и авторизации API EA используют ключ API. API MCA используют проверку подлинности Microsoft Entra.
Примечание.
Все API-интерфейсы отчетов Azure Enterprise не удаляются. Как можно скорее следует перейти в API управления затратами Майкрософт.
| Характер использования | API EA | API Клиентского соглашения Майкрософт |
|---|---|---|
| Остаток на счете и кредиты. | /balancesummary | Microsoft.Billing/billingAccounts/billingProfiles/availableBalanceussae |
| Использование (JSON) | /usagedetails /usagedetailsbycustomdate |
Выбор решения сведений о затратах |
| Использование (CSV) | /usagedetails/download /usagedetails/submit |
Выбор решения сведений о затратах |
| Использование Marketplace (CSV) | /marketplacecharges /marketplacechargesbycustomdate |
Выбор решения сведений о затратах |
| Расчетный период | /billingperiods | Microsoft.Billing/billingAccounts/billingProfiles/invoices |
| прейскурант; | /pricesheet | Microsoft.Billing/billingAccounts/billingProfiles/pricesheet/default/download format=json или csv Microsoft.Billing/billingAccounts/.../billingProfiles/.../invoices/... /pricesheet/default/download format=json или csv Microsoft.Billing/billingAccounts/.. /billingProfiles/.. /providers/Microsoft.Consumption/pricesheets/download |
| Покупки резервирований | /reservationcharges | Microsoft.Billing/billingAccounts/billingProfiles/transactions |
| API рекомендаций по резервированию; | /SharedReservationRecommendations /SingleReservationRecommendations |
Microsoft.Consumption/reservationRecommendations |
| Использование резервирования | /reservationdetails /reservationsummaries |
Microsoft.Consumption/reservationDetails Microsoft.Consumption/reservationSummaries |
¹ Использование службы Azure и стороннего Marketplace доступно с помощью API сведений об использовании.
Для выставления счетов в рамках Клиентского соглашения Майкрософт доступны следующие API:
| Характер использования | API Клиентского соглашения Майкрософт |
|---|---|
| Учетные записи выставления счетов² | Microsoft.Billing/billingAccounts |
| Профили выставления счетов² | Microsoft.Billing/billingAccounts/billingProfiles |
| Разделы счетов² | Microsoft.Billing/billingAccounts/invoiceSections |
| Счета | Microsoft.Billing/billingAccounts/billingProfiles/invoices |
| Подписки для выставления счетов | {scope}/billingSubscriptions |
² API-интерфейсы возвращают списки объектов, которые являются областями, в которых работают возможности управления затратами на портале Azure и API-интерфейсы. Дополнительные сведения см. в статье Understand and work with scopes (Основные сведения об областях и работе с ними).
При использовании существующих API EA их необходимо обновить, чтобы обеспечить поддержку учетных записей выставления счетов Клиентского соглашения Майкрософт. В следующей таблице показаны другие изменения интеграции.
| Характер использования | Старое предложение | Новое предложение |
|---|---|---|
| Power BI | Пакет содержимого и соединитель для аналитики потребления Майкрософт | Соединитель для аналитики потребления Майкрософт |
API для получения сведений об остатке на счете и кредитах
Сводка по балансу получения использовалась для предоставления ежемесячной сводки:
- сведения о балансе.
- покупки;
- плата за обслуживание Azure Marketplace;
- Корректировки
- расходы в связи с избыточным обслуживанием.
Все API потребления заменяются собственными API Azure, которые используют идентификатор Microsoft Entra для проверки подлинности и авторизации. Дополнительные сведения о вызове REST API Azure см. в статье Getting started with REST (Начало работы с REST).
API получения сводной информации об остатке на счете заменяется Microsoft.Billing/billingAccounts/billingProfiles/availableBalance API.
Чтобы получить сведения о доступных остатках с помощью соответствующего API, используйте код ниже:
| Способ | URI запроса |
|---|---|
| GET | https://management.azure.com/providers/Microsoft.Billing/billingAccounts/{billingAccountId}/billingProfiles/{billingProfileId}/availableBalances?api-version=2018-11-01-preview |
API для получения затрат и использования
Ежедневную разбивку затрат на использование служб Azure, сторонних приложений Marketplace и других покупок на Marketplace можно получить с помощью следующих API. Отдельные API объединены для использования служб Azure и сторонних приложений на Marketplace. Старые API заменяются экспортом или API сведений о затратах. Чтобы выбрать решение, подходящее для вас, см. раздел "Выбор решения сведений о затратах". Оба решения предоставляют один и тот же файл сведений о затратах и имеют покупки marketplace в данных, которые ранее отображались только в сводке баланса на сегодняшний день.
Экспорт и API сведений о затратах, как и во всех API управления затратами, доступны в нескольких областях. Для выставленных счетов, которые вы традиционно получаете на уровне регистрации, используйте область профиля выставления счетов. Дополнительные сведения см. в статье Understand and work with scopes (Основные сведения об областях и работе с ними).
| Тип | Формат идентификатора |
|---|---|
| Организация выставления счетов | /Microsoft.Billing/billingAccounts/{billingAccountId} |
| Профиль выставления счетов | /Microsoft.Billing/billingAccounts/{billingAccountId}/billingProfiles/{billingProfileId} |
| Отток подписок | /subscriptions/{subscriptionId} |
| Группа ресурсов | /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName} |
Некоторые имена свойств изменились в новом наборе данных "Сведения о затратах", доступном через API экспорта и сведений о затратах. В таблице ниже приведены соответствующие свойства.
| Старое свойство | Новое свойство | Примечания. |
|---|---|---|
| accountId | Н/П | Создатель подписки не отслеживается. Используйте свойство invoiceSectionId (аналогично departmentId). |
| AccountNameAccountOwnerId и AccountOwnerEmail | Н/П | Создатель подписки не отслеживается. Используйте свойство invoiceSectionName (аналогично departmentName). |
| AdditionalInfo | additionalInfo | |
| ChargesBilledSeparately | isAzureCreditEligible | Свойства являются противоположными. Если у свойства isAzureCreditEnabled значение true, у ChargesBilledSeparately будет false. |
| ConsumedQuantity | quantity | |
| ConsumedService | consumedService | Точные строковые значения могут отличаться. |
| consumedServiceId | нет | |
| CostCenter | costCenter | |
| Date и usageStartDate | Дата | |
| день | нет | Анализирует день в дате. |
| DepartmentId | invoiceSectionId | Точные значения отличаются. |
| DepartmentName | invoiceSectionName | Точные строковые значения могут отличаться. При необходимости настройте соответствие подразделениям в разделах счета. |
| ExtendedCost затраты и Cost | costInBillingCurrency | |
| InstanceId | resourceId | |
| IsRecurringCharge | нет | |
| Расположение | расположение | |
| MeterCategory | meterCategory | Точные строковые значения могут отличаться. |
| MeterId | meterId | Точные строковые значения отличаются. |
| MeterName | meterName | Точные строковые значения могут отличаться. |
| MeterRegion | meterRegion | Точные строковые значения могут отличаться. |
| MeterSubCategory | meterSubCategory | Точные строковые значения могут отличаться. |
| месяц | нет | Анализирует месяц в дате. |
| Название предложения | нет | Используйте publisherName и productOrderName. |
| offerID | нет | |
| Номер заказа | нет | |
| partNumber | нет | Для уникальной идентификации цен используйте meterId и productOrderName. |
| Название плана | productOrderName | |
| Продукт | Продукт | |
| ИД продукта | productId | Точные строковые значения отличаются. |
| Имя издателя | publisherName | |
| ResourceGroup | resourceGroupName | |
| ResourceGuid | meterId | Точные строковые значения отличаются. |
| Расположение ресурса | resourceLocation | |
| resourceLocationId | нет | |
| ResourceName | нет | |
| ResourceRate | effectivePrice | |
| ServiceAdministratorId | Н/П | |
| ServiceInfo1 | serviceInfo1 | |
| ServiceInfo2 | serviceInfo2 | |
| ServiceName | meterCategory | Точные строковые значения могут отличаться. |
| serviceTier | meterSubCategory | Точные строковые значения могут отличаться. |
| StoreServiceIdentifier | Н/П | |
| SubscriptionGuid | subscriptionId | |
| SubscriptionId | subscriptionId | |
| SubscriptionName | subscriptionName | |
| Теги | tags | Свойство тегов применяется к корневому объекту, а не к вложенным свойствам. |
| UnitOfMeasure | unitOfMeasure | Точные строковые значения отличаются. |
| usageEndDate | Дата | |
| Год | нет | Анализирует год в дате. |
| (новое) | billingCurrency | Валюта, используемая для оплаты. |
| (новое) | billingProfileId | Уникальный идентификатор для профиля выставления счетов (аналогичный идентификатору регистрации). |
| (новое) | billingProfileName | Имя профиля выставления счетов (аналогично имени регистрации). |
| (новое) | ChargeType | Используйте, чтобы различать использования службы Azure, Marketplace и покупок. |
| (новое) | invoiceId | Уникальный идентификатор счета. Пуст для текущего открытого месяца. |
| (новое) | publisherType | Тип издателя для покупок. Пуст для использования. |
| (новое) | serviceFamily | Тип покупки. Пуст для использования. |
| (новое) | servicePeriodEndDate | Конечная дата для приобретенной службы. |
| (новое) | servicePeriodStartDate | Начальная дата для приобретенной службы. |
API периодов выставления счетов заменен API счетов
При выставлении счетов в рамках Клиентского соглашения Майкрософт не используются периоды выставления счетов. Вместо этого используются счета, чтобы ограничить расходы в определенные периоды выставления счетов. API периодов выставления счетов заменен API счетов. Все API потребления заменяются собственными API Azure, которые используют идентификатор Microsoft Entra для проверки подлинности и авторизации. Дополнительные сведения о вызове REST API Azure см. в статье Getting started with REST (Начало работы с REST).
Чтобы получить счета с помощью API счетов:
| Способ | URI запроса |
|---|---|
| GET | https://management.azure.com/providers/Microsoft.Billing/billingAccounts/{billingAccountId}/billingProfiles/{billingProfileId}/invoices?api-version=2018-11-01-preview |
API прейскурантов
В этом разделе описаны существующие API прейскурантов и предоставляются рекомендации по переходу на API прейскурантов для Клиентских соглашений Майкрософт. Здесь также описывается API прейскурантов для Клиентских соглашений Майкрософт и поля прейскурантов. API получения прейскурантов Enterprise и получения периодов выставления счетов Enterprise заменены API прейскурантов для Клиентских соглашений Майкрософт (Microsoft.Billing/billingAccounts/billingProfiles/pricesheet). Новый API поддерживает форматы JSON и CSV в форматах асинхронных запросов REST. Все API потребления заменяются собственными API Azure, которые используют идентификатор Microsoft Entra для проверки подлинности и авторизации. Дополнительные сведения о вызове REST API Azure см. в статье Getting started with REST (Начало работы с REST).
API для выставления счетов Enterprise
Вы использовали API для выставления счетов с регистрацией Enterprise, чтобы получать сведения о ценах и периодах выставления счетов. Проверка подлинности и авторизация использовали веб-токены Microsoft Entra.
Чтобы получить применимые цены для указанного Соглашения о регистрации Enterprise с помощью API прейскурантов и периодов выставления счетов, выполните следующее:
| Способ | URI запроса |
|---|---|
| GET | https://consumption.azure.com/v2/enrollments/{enrollmentNumber}/pricesheet |
| GET | https://consumption.azure.com/v2/enrollments/{enrollmentNumber}/billingPeriods/{billingPeriod}/pricesheet |
API прейскурантов для Клиентских соглашений Майкрософт
Используйте API прейскурантов для Клиентских соглашений Майкрософт, чтобы просматривать цены для всех используемых служб Azure и Marketplace. Цены, указанные для профиля выставления счетов, применяются ко всем подпискам, принадлежащим к профилю.
Используйте API прейскурантов для просмотра всех данных прейскурантов используемых служб Azure в формате CSV:
| Способ | URI запроса |
|---|---|
| POST | https://management.azure.com/providers/Microsoft.Billing/billingAccounts/{billingAccountId}/billingProfiles/{billingProfileId}/providers/Microsoft.CostManagement/pricesheet/default/download?api-version=2018-11-01-preview&startDate=2019-01-01&endDate=2019-01-31&format=csv |
Используйте API прейскурантов для просмотра всех данных прейскурантов для используемых служб Azure в формате JSON:
| Способ | URI запроса |
|---|---|
| POST | https://management.azure.com/providers/Microsoft.Billing/billingAccounts/{billingAccountId}/billingProfiles/{billingProfileId}/providers/Microsoft.CostManagement/pricesheet/default/download?api-version=2018-11-01-preview&startDate=2019-01-01&endDate=2019-01-31&format=json |
Использование API возвращает прейскурант для всей учетной записи. Можно также получить сокращенную версию прейскуранта в формате PDF. Сводка включает в себя расходы на использование служб Azure и Marketplace, которые вносятся для конкретного счета. Счет определяется с помощью идентификатора {invoiceId}, который совпадает с номером счета в PDF-файлах сводки по счетам. Рассмотрим пример.
Чтобы просмотреть информацию в формате CSV по счету с помощью API прейскурантов, выполните следующее:
| Способ | URI запроса |
|---|---|
| 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 |
Чтобы просмотреть информацию в формате JSON по счету с помощью API прейскурантов, выполните следующее:
| Способ | URI запроса |
|---|---|
| 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 |
Вы также можете просмотреть расчетные цены для любой службы потребления Azure или службы потребления Marketplace в текущем открытом периоде выставления счетов или периоде обслуживания.
Чтобы просмотреть расчетные цены на используемые службы в формате CSV с помощью API прейскурантов, выполните следующее:
| Способ | URI запроса |
|---|---|
| POST | https://management.azure.com/providers/Microsoft.Billing/billingAccounts/{billing AccountId}/billingProfiles/{billingProfileId}/pricesheet/default/download?api-version=2018-11-01-preview&format=csv |
Чтобы просмотреть расчетные цены на используемые службы в формате JSON с помощью API прейскурантов, выполните следующее:
| Способ | URI запроса |
|---|---|
| POST | https://management.azure.com/providers/Microsoft.Billing/billingAccounts/{billing AccountId}/billingProfiles/{billingProfileId}/pricesheet/default/download?api-version=2018-11-01-preview&format=json |
API прейскурантов Клиентского соглашение Майкрософт — это асинхронные REST API. Ответы для API изменились по сравнению с ответами для старых синхронных API. Текст ответа API также изменился.
Старый текст ответа
Ниже приведен пример ответа синхронного REST API.
[
{
"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"
},
{
]
Новый текст ответа
API поддерживают формат асинхронного REST API Azure. При вызове API с помощью GET вы получите следующий ответ:
No Response Body
HTTP Status 202 Accepted
Отправляются следующие заголовки с расположением выходных данных:
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}
Выполните еще один вызов GET в расположение. Ответ на вызов GET остается тем же, пока операция не будет выполнена или не завершится сбоем. После завершения ответ на расположение вызова GET возвращает URL-адрес скачивания, как если бы операция выполнялась одновременно. Приведем пример:
HTTP Status 200
{
"id": "providers/Microsoft.Consumption/operationresults/{operationId}",
"name": {operationId},
"type": “Microsoft.Consumption/operationResults",
"properties" : {
"downloadUrl": {urltoblob},
"validTill": "Date"
}
}
Клиент также может выполнить вызов GET для Azure-AsyncOperation. Конечная точка возвращает состояние операции.
В следующей таблице показаны поля в API получения прейскурантов Enterprise. Они включают в себя соответствующие поля в новом прейскуранте для Клиентских соглашений Майкрософт:
| Старое свойство | Новое свойство | Примечания. |
|---|---|---|
| billingPeriodId | Не применимо | Неприменимо. Для Клиентских соглашений Майкрософт счет и связанный с ним прейскурант заменены billingPeriodId. |
| meterId | meterId | |
| unitOfMeasure | unitOfMeasure | Точные строковые значения могут отличаться. |
| includedQuantity | includedQuantity | Неприменимо для служб в рамках Клиентских соглашений Майкрософт. |
| partNumber | Не применимо | Вместо этого используйте сочетание свойств productOrderName (аналогично offerID) и meterID. |
| unitPrice | unitPrice | Цена за единицу применима для служб, потребляемых в рамках Клиентских соглашений Майкрософт. |
| currencyCode | pricingCurrency | В рамках Клиентских соглашениях Майкрософт цены представлены в валюте ценообразования и валюте выставления счетов. currencyCode соответствует свойству pricingCurrency в Клиентских соглашениях Майкрософт. |
| offerID | productOrderName | Вместо offerID можно использовать свойство productOrderName, но оно отличается от offerID. productOrderName и единицы измерения стоимости в Клиентских соглашениях Майкрософт связаны с meterId и offerID в устаревших регистрациях. |
Операции API прейскурантов потребления
Для Соглашений Enterprise вы использовали операции API прейскурантов потребления Get и получения периода выставления счетов для области по subscriptionId или расчетному периоду. API использует проверку подлинности управления ресурсами Azure.
Чтобы получить сведения о прейскуранте для области с помощью API прейскурантов, выполните следующее:
| Способ | URI запроса |
|---|---|
| GET | https://management.azure.com/subscriptions/{subscriptionId}/providers/Microsoft.Consumption/pricesheets/default?api-version=2018-10-01 |
Чтобы получить сведения о прейскуранте по периоду выставления счетов с помощью API прейскурантов, выполните следующее:
| Способ | URI запроса |
|---|---|
| GET | https://management.azure.com/subscriptions/{subscriptionId}/providers/Microsoft.Billing/billingPeriods/{billingPeriodName}/providers/Microsoft.Consumption/pricesheets/default?api-version=2018-10-01 |
Вместо указанных выше конечных точек API используйте следующее для Клиентских соглашений Майкрософт:
API прейскурантов для Клиентских соглашений Майкрософт (асинхронные REST API).
Этот API предназначен для Клиентское соглашение Майкрософт и предоставляет дополнительные атрибуты.
Прейскурант для области профиля выставления счетов в учетной записи выставления счетов
Этот API является существующим. Он обновлен и предоставляет прейскуранты для профиля выставления счетов в учетной записи выставления счетов.
Прейскурант для области по учетной записи выставления счетов
Проверка подлинности Azure Resource Manager используется при получении прейскуранта в области регистрации в учетной записи выставления счетов.
Чтобы получить прейскурант для учетной записи регистрации в учетной записи выставления счетов, выполните следующие действия:
| Способ | URI запроса |
|---|---|
| GET | /providers/Microsoft.Billing/billingAccounts/65085863/providers/Microsoft.Consumption/pricesheets/download?api-version=2019-01-01 |
Для Клиентского соглашения Майкрософт используйте сведения, приведенные в следующем разделе. Здесь указываются свойства полей, используемые для Клиентских соглашений Майкрософт.
Прейскурант для области профиля выставления счетов в учетной записи выставления счетов
Обновленный API прейскурантов учетной записи выставления счетов получает прейскурант в формате CSV. Чтобы получить прейскурант в области профиля выставления счетов для Клиентского соглашения Майкрософт, сделайте следующее:
| Способ | URI запроса |
|---|---|
| GET | /providers/Microsoft.Billing/billingAccounts/{billing AccountId}/billingProfiles/{billingProfileId}/providers/Microsoft.Consumption/pricesheets/download?api-version=2019-01-01 |
В области регистрации EA ответ и свойства API идентичны. Свойства соответствуют аналогичным свойствам Клиентского соглашения Майкрософт.
Более старые свойства для API прейскурантов Azure Resource Manager и новые свойства приведены в следующей таблице.
| Старое свойство API прейскурантов Azure Resource Manager | Новое свойство API прейскурантов для Клиентского соглашения Майкрософт | Description |
|---|---|---|
| Идентификатор измерения | meterId | Уникальный идентификатор для средства измерения. Аналогично свойству meterID. |
| Название единицы измерения | meterName | Имя индикатора. Единица измерения представляет собой развертываемый ресурс службы Azure. |
| Категория единицы измерения | service | Имя категории классификации для единицы измерения. Аналогично службе в прейскуранте Клиентского соглашения Майкрософт Точные строковые значения отличаются. |
| Подкатегория единицы измерения | meterSubCategory | Имя категории подклассификации единицы измерения. Основано на классификации дифференциации набора признаков высокого уровня в службе. Например, базы данных SQL ценовых категорий "Базовый" и "Стандартный". |
| Регион единицы измерения | meterRegion | |
| Единица измерения | Не применимо | Можно проанализировать из свойства unitOfMeasure. |
| Единица измерения | unitOfMeasure | |
| Артикул | Не применимо | Вместо артикула используйте productOrderName и meterID для уникальной идентификации цен в профиле выставления счетов. Поля перечислены в счете Клиентского соглашения Майкрософт вместо артикула. |
| Цена за единицу | unitPrice | Цена за единицу Клиентского соглашения Майкрософт. |
| Код валюты | pricingCurrency | В Клиентских соглашениях Майкрософт цены представлены в валюте ценообразования и валюте выставления счетов. Код валюты соответствует свойству pricingCurrency в Клиентских соглашениях Майкрософт. |
| Включенное количество | includedQuantity | Неприменимо для служб Клиентских соглашений Майкрософт. Отображаются нулевые значения. |
| Идентификатор предложения | productOrderName | Вместо offerID используйте свойство productOrderName. Тем не менее productOrderName (отличное от свойства OfferID) и единица измерения определяют цены в Клиентских соглашениях Майкрософт. Относится к meterId и offerID в устаревших регистрациях. |
Цена для Клиентских соглашений Майкрософт определяется не так, как в соглашениях Enterprise. Цена за использование служб в рамках регистрации Enterprise уникальна для продукта, артикула, единицы измерения и предложения. Артикул не используется в Клиентских соглашениях Майкрософт.
Цена за использование службы потребления ресурсов Azure, которая является частью Клиентского соглашения Microsoft, уникальна для свойств productOrderName и meterID. Они представляют собой единицы измерения службы и план продукта.
Чтобы согласовать прейскурант и использование в API сведений об использовании, можно использовать свойства productOrderName и meterID.
Пользователи с правами владельца профиля выставления счетов, участника, читателя и менеджера счетов могут скачать прейскурант.
Прейскурант содержит цены на службы, стоимость которых основана на использовании. Эти службы включают в себя потребление ресурсов Azure и Marketplace. Последняя цена в конце каждого периода обслуживания блокируется и применяется к использованию в течение одного периода обслуживания. Для служб потребления ресурсов Azure период обслуживания обычно является календарным месяцем.
Устаревшие поля API прейскурантов
Следующие поля недоступны в API прейскурантов Клиентского соглашения Майкрософт или совпадают.
| Устаревшее поле | Description |
|---|---|
| billingPeriodId | Не применимо. Соответствует InvoiceId для MCA. Соответствует invoiceId для Клиентского соглашения Майкрософт. |
| offerID | Неприменимо. Соответствует productOrderName для Клиентских соглашений Майкрософт. |
| meterCategory | Неприменимо. Соответствует Service для Клиентских соглашений Майкрософт. |
| unit | Неприменимо. Можно проанализировать из свойства unitOfMeasure. |
| currencyCode | Аналогично свойству pricingCurrency для Клиентских соглашений Майкрософт. |
| meterLocation | Аналогично свойству meterRegion для Клиентских соглашений Майкрософт. |
| partNumber | Не применяется, так как артикул не указан в счетах для Клиентских соглашений Майкрософт. Вместо артикула используйте сочетание meterId и productOrderName для уникальной идентификации цен. |
| totalIncludedQuantity | Неприменимо. |
| pretaxStandardRate | Неприменимо. |
Заменен API стоимости резервирования экземпляра
Вы можете получить транзакции выставления счетов на покупку резервирования с помощью API стоимости резервирования экземпляра. Новый API включает в себя все покупки, в том числе сторонних предложений Marketplace. Все API потребления заменяются собственными API Azure, которые используют идентификатор Microsoft Entra для проверки подлинности и авторизации. Дополнительные сведения о вызове REST API Azure см. в статье Getting started with REST (Начало работы с REST). API стоимости резервирования экземпляра заменяется API транзакций.
Чтобы получить транзакции покупки зарезервированных экземпляров с помощью API транзакций, выполните следующее:
| Способ | URI запроса |
|---|---|
| GET | https://management.azure.com/providers/Microsoft.Billing/billingAccounts/{billingAccountId}/billingProfiles/{billingProfileId}/transactions?api-version=2018-11-01-preview |
Заменены API рекомендаций
API рекомендаций по покупке зарезервированных экземпляров предоставляет сведения об использовании виртуальных машин за последние 7, 30 или 60 дней. API также предоставляют рекомендации по приобретению зарезервированных экземпляров. К ним относятся:
- API рекомендаций по резервированию общих экземпляров.
- API рекомендаций по резервированию отдельных экземпляров.
Все API потребления заменяются собственными API Azure, которые используют идентификатор Microsoft Entra для проверки подлинности и авторизации. Дополнительные сведения о вызове REST API Azure см. в статье Getting started with REST (Начало работы с REST). Ранее указанные API рекомендаций по резервированию заменены API Microsoft.Consumption/reservationRecommendation.
Чтобы получить рекомендации по резервированию с помощью API рекомендаций, выполните следующее:
| Способ | URI запроса |
|---|---|
| GET | https://management.azure.com/providers/Microsoft.Consumption/reservationRecommendations?api-version=2019-01-01 |
Заменены API использования резервирования
Вы можете получить сведения об использовании резервирования в регистрации с помощью API использования зарезервированных экземпляров. Если в регистрации есть несколько зарезервированных экземпляров, можно также получить сведения об использовании всех купленных зарезервированных экземпляров с помощью этого API.
К ним относятся:
- Данные об использовании зарезервированного экземпляра
- Сводка об использовании зарезервированного экземпляра
Все API потребления заменяются собственными API Azure, которые используют идентификатор Microsoft Entra для проверки подлинности и авторизации. Дополнительные сведения о вызове REST API Azure см. в статье Getting started with REST (Начало работы с REST). Ранее указанные API рекомендаций по резервированию заменяются API Microsoft.Consumption/reservationDetails и Microsoft.Consumption/reservationSummaries.
Чтобы получить сведения о резервировании с помощью API сведений о резервировании, выполните следующее:
| Способ | URI запроса |
|---|---|
| GET | https://management.azure.com/providers/Microsoft.Consumption/reservationDetails?api-version=2019-01-01 |
Чтобы получить сведения о резервировании с помощью API сводок о резервировании, выполните следующее:
| Способ | URI запроса |
|---|---|
| GET | https://management.azure.com/providers/Microsoft.Consumption/reservationSummaries?api-version=2019-01-01 |
Интеграция с Power BI
Для отчетов о затратах также можно использовать Power BI. Соединитель Управления затратами Azure для Power BI Desktop можно использовать для создания эффективных настраиваемых отчетов, которые помогут вам лучше управлять своими расходами в Azure. Соединитель Управления затратами Azure сейчас поддерживается для Клиентских соглашений Майкрософт или Соглашений Enterprise.
Связанный контент
- Ознакомьтесь с документацией по управлению затратами, чтобы узнать, как отслеживать расходы в Azure и управлять ими. С помощью Управления затратами также можно оптимизировать использование ресурсов.