Поделиться через

Миграция с API прейскуранта EA

  • Статья

Клиенты EA, которые ранее использовали API-интерфейсы для корпоративной отчетности consumption.azure.com для получения прейскуранта, должны перейти на использование API-интерфейса Resource Manager Azure. Приведенные ниже инструкции помогут вам выполнить миграцию, и они также описывают различия между старым API и новым API.

Примечание.

Все API-интерфейсы отчетов Azure Enterprise не удаляются. Как можно скорее следует перейти в API управления затратами Майкрософт.

Назначение разрешений субъекту-службе для вызова API

Перед вызовом API необходимо настроить субъект-службу (SPN) с правильным разрешением. Субъект-служба используется для вызова API. Дополнительные сведения см. в разделе "Назначение разрешений для API управления затратами".

Вызов API прейскуранта

API ценовых листов асинхронно создает ценовую таблицу и создает скачанный файл.

Используйте следующие URI запроса при вызове нового API прайс-листа:

Поддерживаемые запросы

Вы можете вызвать API с помощью следующей область:

Регистрация: providers/Microsoft.Billing/billingAccounts/{billingAccountId}

Скачивание по учетной записи выставления счетов за указанный период выставления счетов

POST https://management.azure.com/providers/Microsoft.Billing/billingAccounts/{billingAccountId}/billingPeriods/{billingPeriodName}/providers/Microsoft.CostManagement/pricesheets/default/download?api-version=2023-11-01

Запрос POST возвращает расположение для опроса состояния создания отчета, как описано в следующем ответе:

Пример ответа

Код состояния: 202.

Location: https://management.azure.com/providers/Microsoft.Billing/billingAccounts/0000000/providers/Microsoft.CostManagement/operationResults/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e?api-version=2023-09-01
Retry-After: 60

Код состояния: 200.

{
  "status": "Completed",
  "properties": {
    "downloadUrl": "https://myaccount.blob.core.windows.net/?restype=service&comp=properties&sv=2015-04-05&ss=bf&srt=s&st=2015-04-29T22%3A18%3A26Z&se=2015-04-30T02%3A23%3A26Z&sr=b&sp=rw&spr=https&sig=G%2TEST%4B",
    "validTill": "2023-09-30T17:32:28Z"
  }
}

Пример запроса для опроса состояния создания отчета

GET https://management.azure.com/providers/Microsoft.Billing/billingAccounts/0000000/providers/Microsoft.CostManagement/operationResults/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e?api-version=2023-09-01

Изменения текста ответа

[
        {
              "id": "enrollments/57354989/billingperiods/201601/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"
        },
        {
              "id": "enrollments/57354989/billingperiods/201601/products/2884/pricesheets",
              "billingPeriodId": "201404",
            "meterId": "dc210ecb-97e8-4522-8134-5385494233c0",
              "meterName": "Locally Redundant Storage Premium Storage - Snapshots - AU East",
              "unitOfMeasure": "100 GB",
              "includedQuantity": 0,
              "partNumber": "N9H-00402",
              "unitPrice": 0.00,
              "currencyCode": "USD"
        },
        ...
]

Новые изменения ответа

Свойства ценовой таблицы приведены следующим образом:

Имя Тип Description
basePrice строка Цена за единицу в то время, когда клиент входит в систему или цена единицы в момент запуска счетчика обслуживания, если он находится после входа.

Применимо к Соглашение Enterprise пользователям
currencyCode строка Валюта, в которой подписан Соглашение Enterprise
effectiveEndDate строка Дата окончания периода выставления счетов ценовой таблицы
effectiveStartDate строка Дата начала периода выставления счетов в прайс-листе
enrollmentNumber строка Уникальный идентификатор учетной записи выставления счетов EA.
includedQuantity строка Количество конкретной службы, к которой клиент EA имеет право потреблять без добавочных расходов.
marketPrice строка Текущая цена на список для определенного продукта или услуги. Эта цена без каких-либо переговоров и основана на типе соглашения Майкрософт.

Для потребления PriceType цена рынка отражается как цена по мере использования.

Для плана экономии PriceType цена на рынок отражает преимущество плана экономии поверх оплаты по мере использования цены на соответствующий срок обязательств.

Для PriceType ReservedInstance цена рынка отражает общую цену одного или трехлетнего обязательства.

Примечание. Для клиентов EA без переговоров цена на рынок может быть округлена до десятичной точности, чем цена за единицу.
meterCategory строка Имя категории классификации для единицы измерения. Например, Облачные службы, Сетьи т. д.
meterId строка Уникальный идентификатор счетчика
meterName строка Имя индикатора. Единица измерения представляет собой развертываемый ресурс службы Azure.
meterRegion строка Имя региона Azure, где доступен счетчик для службы.
meterSubCategory строка Имя категории подклассификации единицы измерения.
meterType строка Имя типа счетчика
partNumber строка Номер части, связанный с счетчиком
priceType строка Тип цены для продукта. Например, ресурс Azure с оплатой по мере использования с помощью priceType в качестве потребления. К другим типам цен относятся ЗарезервированнаяInstance и план экономии.
продукт строка Имя продукта, начисляющего расходы.
productId строка Уникальный идентификатор продукта, используемый средством измерения.
serviceFamily number Тип службы Azure. Например, вычисления, аналитика и безопасность.
skuId строка Уникальный идентификатор номера SKU
term строка Срок действия плана экономии Azure или срока резервирования — один год или три года (P1Y или P3Y)
unitOfMeasure строка Как измеряется использование для службы
unitPrice строка Цена за единицу в момент выставления счетов для данного продукта или услуги, включаемая любые согласованные скидки поверх рыночной цены.

Для PriceType ReservedInstance цена за единицу отражает общую стоимость одного или трехлетнего обязательства, включая скидки.

Примечание. Цена за единицу не совпадает с эффективной ценой в сведениях об использовании, когда службы имеют разностные цены на разных уровнях.

Если услуги имеют многоуровневую цену, то эффективная цена — это смешанная ставка по уровням и не отображает цену на единицу с определенным уровнем. Смешанная цена или эффективная цена — это чистая цена за потребленное количество, охватывающая несколько уровней (где каждый уровень имеет свою цену единицы продукции).

Связанный контент